⚡ التوثيق الفني المعماري لمنظومة TidyFactor¶
منظومة معمارية الويب ومهارات وكلاء البرمجة بالذكاء الاصطناعي ثنائية الطبقات¶
🎯 المشكلة الأساسية والحل المعماري¶
المعضلة: يولد وكلاء الذكاء الاصطناعي كوداً برمجياً بسرعة فائقة، لكن غياب الحدود المعمارية الصارمة يؤدي إلى تضخم الملفات، استعلامات قواعد بيانات مسربة، واجهات هشة، وتراكم الديون التقنية الصامتة.
الحل في TidyFactor: تقديم قواعد معمارية مقفلة، أدوات نظام حتمية تلف الـ compilers، حدود أمان على مستوى قواعد البيانات (Postgres RLS)، ومهارات تشغيلية رشيقة (~350 توكن) تبقي المطور البشري والوكيل البرمجي في توافق تام وصفر هلوسة.
🏛️ الهيكل المعماري للمنظومة (45+ مهارة إنتاجية)¶
منظومة TidyFactor
├── 🌐 [01] مهارات المجتمع الأساسية (Skills-LAB — 12 مهارة، مفتوحة المصدر)
│ ├── الحوكمة والمعايير: tidyfactor-skill-architect
│ ├── عمليات منصة GitHub: tidyfactor-github
│ ├── الواجهات والتجربة: tidyfactor-cinematic, tidyfactor-design, tidyfactor-styler
│ ├── الهندسة المعمارية: tidyfactor-next, tidyfactor-php, tidyfactor-htmx, tidyfactor-js, tidyfactor-html
│ └── التوثيق والنمو: tidyfactor-doc, tidyfactor-marketing
│
├── ⚙️ [02] باقة إدارة الخوادم والسحابيات (DevOps Pro — 13 مهارة)
│ ├── الخوادم والويب: ops-cpanel, ops-lamp, ops-wp, ops-node, ops-local-dev
│ ├── الحماية والأتمتة: ops-security (CSF/cPHulk), ops-cicd, ops-docker, ops-testing
│ └── الشبكات والبيانات: ops-mail (Exim/SRS), ops-db (MariaDB/Index), ops-dns, ops-dr
│
├── 🏢 [03] باقة أتمتة الأعمال والوكالات (PocketOffice Pro — 11 مهارة)
│ ├── المبيعات والمالية: pocket-crm, pocket-invoicing, pocket-finance, pocket-calendar
│ ├── التسويق والمعرفة: pocket-proposals, pocket-marketing, pocket-kb-manager, pocket-memory
│ └── الهندسة والتوزيع: pocket-module-builder, pocket-release, pocketoffice-module-builder
│
├── 🛠️ [04] باقة هندسة الأنظمة والنمو المتقدم (Engineering & Growth — 9 مهارات)
│ ├── الأنوية المتقدمة: tidyfactor-php-kernel, tidyfactor-pwa, clean-code-refactor
│ ├── الحزم الرشيقة: tidyfactor-php-micro, tidyfactor-php-mono, tidyfactor-js-micro
│ └── التحويل والسيو: tidyfactor-seo, website-copywriting-mena, mena-proposal-writer
│
└── 🚀 [05] أداة سطر الأوامر TidyFactor CLI ومنصة Go
├── نظام التشغيل: TidyFactor Go CMS (قواعد SQLite 3 WAL وتخزين JSON)
└── محرك التثبيت: npx @tidyfactor/cli وسكربتات التثبيت المستقلة
📚 الفهرس الفني الشامل للتوثيق¶
🏛️ 1. المعمارية، النظرة العامة ومصفوفة المهارات¶
- 🌐 دليل معمارية المنظومة | Architecture Overview (EN) — الأطروحة المعمارية، دورات حياة المهام، ونموذج التعاون بين المطور والوكيل.
- ⚡ دليل سطر الأوامر ومحركات التثبيت المستقلة | CLI Reference (EN) — معالج الإعداد التفاعلي، بنية التثبيت المزدوجة، وباقات مسارات العمل.
- 📦 مصفوفة المهارات الشاملة (45+ مهارة) | Skills Matrix (EN) — الكتالوج الكامل لجميع المهارات الـ 45 عبر الفئات المجتمعية والاحترافية.
- 🔮 خارطة الطريق والرؤية المستقبلية | Roadmap 2026+ (EN) — الرؤية الإستراتيجية والمنصات القادمة.
👑 2. باقات الإنتاج والترخيص التجاري (33+ مهارة)¶
- ⚙️ دليل باقة إدارة الخوادم والسحابيات DevOps Pro | DevOps Pro Guide (EN) — تشخيص الخوادم، ضبط أحواض PHP-FPM، دروع حظر البوتات CSF، ترحيل البريد بـ SRS، وخطط التعافي.
- 🏢 دليل باقة أتمتة الأعمال PocketOffice Pro | PocketOffice Pro Guide (EN) — مسارات المبيعات، الفوترة الرقمية، التوقعات المالية، وصياغة العروض.
- 🛠️ دليل باقة هندسة الأنظمة والنمو المتقدم | Engineering & Growth Pro Guide (EN) — نواة المونوليث PHP Kernel، تطبيقات PWA، وتطهير الكود وفق SOLID.
🌐 3. مهارات المجتمع الأساسية (12 مهارة — Apache-2.0)¶
- 🏛️ TidyFactor Skill Architect — محرك الحوكمة والمعايير الهندسية وفرض قوائم التحقق الحتمية.
- 🐙 TidyFactor GitHub — محرك تشغيل، حوكمة، أمن سلاسل التوريد، تجربة README وهندسة منصة GitHub.
- 🎬 Cinematic Landing Kit — صفحات هبوط سينمائية فاخرة بدقة 60 FPS على Canvas بأسلوب آبل.
- 🎨 TidyFactor Design — دورة حياة تصميم الواجهات بالكود الأصيل (7 مراحل) وبديل فيجما.
- 💅 TidyFactor Styler — التنسيق الجراحي للأطر القائمة وضبط الواجهات العربية بـ Logical CSS.
- 📚 TidyFactor Doc — استقراء السورس كود بالـ AST، بناء مراجع API وتوليد مواقع Docsify تفاعلية.
- ⚡ TidyFactor Next.js — منصة SaaS متعددة المستأجرين مع عزل Postgres RLS ومحرك قياس الأداء.
- 📈 TidyFactor Marketing — أركان النمو السبعة، التسويق المباشر، واستراتيجيات السيو العنقودي.
- 📄 TidyFactor HTML — مواقع ثابتة 100% بدون خوادم مع سيو دلالي فائق السرعة.
- ⚡ TidyFactor HTMX — التفاعلية الموجهة بالخادم مع دمج محلي لـ Morphdom وحماية CSRF.
- 🍦 TidyFactor Vanilla JS — تطبيقات SPA تفاعلية بجافاسكربت الصرفة (< 10KB).
- 🐘 TidyFactor PHP Monolith — مونوليث PHP 8.x معياري حديث وسريع (Flight + Medoo + Plates).
🚀 4. منصة TidyFactor Go (نظام تشغيل مواقع الأعمال)¶
- 🏗️ معمارية منصة TidyFactor Go | Platform Architecture (EN) — قواعد بيانات SQLite 3 بنمط WAL وتخزين JSON فوري.
- ⚡ دليل البدء السريع — تشغيل المنصة محلياً ونشرها في 5 دقائق.
- 👑 دليل لوحة التحكم للمدير — إدارة المحتوى والوسائط والمستخدمين.
- 📝 دليل تحرير المحتوى — إدارة الصفحة الرئيسية، الخدمات، والأقسام الديناميكية.
- 🗄️ معمارية قواعد البيانات والتخزين — جداول SQLite 3 وإجراءات المعالجة الذاتية.
- 🔒 الأمان وحصانة النظام — التشفير بـ Bcrypt، تحديد معدل الطلبات، وحظر البوتات.
- 📰 محرك المحتوى وواجهات REST API | مراجع الـ API — 15 واجهة برمجية للتحكم الشامل.
👨💻 معلومات التواصل والمؤسسة¶
- 🌐 الموقع الرسمي: https://tidyfactor.com/
- 📚 بوابة التوثيق الفني: https://tidyfactor.com/documentation
- 🤝 الشريك الإستراتيجي: وكالة الوكالة الرقمية Alwkala
- 🐙 منظمة GitHub: github.com/TidyFactor
- 📧 التواصل والاستفسارات: hello@tidyfactor.com
📜 الترخيص¶
مرخص تحت رخصة Apache License 2.0. جميع الحقوق محفوظة © 2026 TidyFactor و Alwkala Digital Agency.