WP Manifestindependent plugin directory
manifest / utilities / workpress

WorkPress

Native Organizational Memory & Work Management Engine for WordPress.

by WorkPress Team · github.com/wittybrandcode/workpress · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/wittybrandcode/workpress/archive/refs/heads/main.zip
Readme github.com/wittybrandcode/workpress ↗


WorkPress Brand Logo
محرك السيادة التشغيلية والذاكرة المؤسسية الأصيل لمنظومة ووردبريس
The Native Organizational Memory & Work Management Engine for WordPress

Release Multilingual 4 Languages WordPress PHP License Zero Table No Build SPA Tri-Partite Auth Sharp Geometry

🇬🇧 English Documentation • 🇸🇦 التوثيق باللغة العربية

🇬🇧 English

🧭 Vision & "just work." Philosophy

«WorkPress — just work.»
You focus on executing tasks and submitting verifiable evidence; WorkPress autonomously handles lifecycle governance, cascading completion, permanent knowledge preservation, and stakeholder sign-offs.

WorkPress is an enterprise-grade sovereign engine that transforms WordPress from a Content Management System (CMS) into a robust organizational operating system, project & task delivery platform, client collaboration suite, and immutable knowledge repository.

🏛️ 6 Core Architectural Pillars

                     ┌────────────────────────────────────────────────────────┐
                     │         Organizational Memory & Sovereign Engine       │
                     └──────────────────────────┬─────────────────────────────┘
                                                │
       ┌─────────────────┬──────────────────────┼──────────────────────┬─────────────────┐
       ▼                 ▼                      ▼                      ▼                 ▼
 ┌───────────┐     ┌───────────┐          ┌───────────┐          ┌───────────┐     ┌───────────┐
 │ 1. Native │     │ 2. Truth  │          │ 3. Cascade│          │ 4. Portal │     │ 5. RBAC   │
 │ Zero-Table│     │ -Driven   │          │ Completion│          │ 0% CSS    │     │ Tri-Part  │
 │ WP Schema │     │ Evidence  │          │ & Extract │          │ Bleed     │     │ Auth      │
 └───────────┘     └───────────┘          └───────────┘          └───────────┘     └───────────┘
  1. 🏛️ Native Zero-Table Architecture: Zero custom SQL tables. Projects map to Taxonomy, Tasks to Custom Post Types (work_item), and Contributions to Comments (wp_contribution), ensuring eternal compatibility with core WordPress backup, caching, and export utilities.
  2. 🛡️ Truth-Driven State: No synthetic statuses or manual checkboxes. Verifiable contributions and evidence are the sole drivers of progress, logged forever in an immutable audit timeline.
  3. ⚡ Cascading Completion & Knowledge Extraction: Accepting a solution contribution completes the task, updates project metrics, closes finished milestones, and indexes the solution into a permanent Knowledge Base.
  4. 🏢 Standalone Portal & 4-Tier Citizenship: An isolated Zero CSS Bleed portal at /portal/ completely separate from /wp-admin/, preventing client access to sensitive internal technical discussions.
  5. 🔒 Tri-Partite Authorization Formula: Strict operational security: $\text{CanPerform} = \text{GlobalCap} \land \text{ProjectVisibility} \land \text{ResourceRelationship}$ governed by 8 atomic capability packages (34 granular capabilities).
  6. 📡 Cryptographic Webhooks Pipeline: Real-time event dispatching signed with HMAC-SHA256 keys, supporting Discord, Slack, Microsoft Teams, and custom ERP webhooks.

👥 4-Tier Citizenship & Tri-Space Separation

1. The 4-Tier Citizenship Hierarchy

Tier Role / Identity Dedicated Interface Security Scope & Context
👑 1 Administrator (administrator) CoWorkPress Admin SPA (/wp-admin/) Full governance, capability matrix management, lead assignments, and audit control
🛠️ 2 Technical Staff (editor, author, contributor) Kanban, Gantt, and Time Tracker Editor: Project lead & solution acceptor. Author: Self-directed producer. Contributor: Assigned task executor
💼 3 Client Stakeholder (workpress_client) Standalone Client Portal (/portal/) Isolated from /wp-admin/; submits project intake requests, reviews deliverables, and performs digital sign-offs
👁️ 4 Subscriber / Community (subscriber) WordPress Frontend Public user context; protected with zero access to internal technical workspaces

2. Tri-Space Separation Architecture

┌──────────────────────────────────┐   ┌──────────────────────────────────┐   ┌──────────────────────────────────┐
│   Space 1: WP Public Frontend    │   │  Space 2: Standalone Portal      │   │ Space 3: CoWorkPress Workspace   │
│       (example.com/)             │   │    (example.com/portal/)         │   │  (/wp-admin/admin.php?page=wp)   │
├──────────────────────────────────┤   ├──────────────────────────────────┤   ├──────────────────────────────────┤
│ • General site visitors & readers│   │ • Clients and project owners     │   │ • Technical staff & management   │
│ • Zero access to internal tasks  │   │ • 100% Zero Theme CSS Bleed      │   │ • Kanban, Gantt, Knowledge Base  │
│ • Zero WorkPress bundle loaded   │   │ • Request intake & sign-offs     │   │ • Tri-Partite Security Formula   │
└──────────────────────────────────┘   └──────────────────────────────────┘   └──────────────────────────────────┘

🛡️ 8 Atomic Capability Packages (34 Capabilities)

1. Project Management      ➔ read_workpress_projects, create_workpress_projects, edit_workpress_projects, delete_workpress_projects, manage_project_members
2. Task Execution          ➔ read_workpress_tasks, create_workpress_tasks, edit_assigned_tasks, edit_others_workpress_tasks, change_task_status, assign_tasks, delete_workpress_tasks
3. Contribution Flow       ➔ read_contributions, add_contributions, edit_contributions, delete_contributions, accept_solutions, revoke_solutions
4. Requests Management     ➔ submit_work_requests, view_incoming_requests, triage_requests, approve_requests, reject_requests
5. Knowledge Governance    ➔ read_knowledge_base, generate_executive_reports, export_knowledge_book
6. System Administration   ➔ access_workpress_admin, manage_workpress_settings, manage_intake_forms, manage_webhooks
7. Client Portal           ➔ access_workpress_portal, view_own_deliverables, submit_client_feedback, signoff_project_deliverables

🚀 High-Density Productive Engines

  1. Ultra-Dense Kanban Studio: 220px cover cards, distinct project badge row, compact footer with priority chips, time badges, dynamic loaded/total lane ratio (20 / 114 -> 114 / 114), and end-of-lane stop indicators.
  2. Master Gantt Suite: 4 time scales (24h live day, full days, weeks, months), a pulsating Live Current Time Needle, and one-click [ Expand All ] & [ Collapse All ] tree controls.
  3. Live Horizon Broadcasts & Operational Alerts: Real-time event ticker with bounded vertical emergence, solid color priority badges, executive 30px navigation controls, and dedicated management directives hub (BroadcastsPage.js).
  4. Universal 4-Language Localization Engine: 100% parity across Arabic, English, French, and Spanish with instant reactive DOM flipping (LanguageQuickMenu.js) and 2,269 synchronized canonical gettext keys.
  5. Knowledge Base & Book Generator: Automatic indexing of accepted solutions, full-text search, and one-click export to comprehensive Markdown (.md) knowledge books and A4 PDF handover certificates.
  6. Project Cold Storage (Hibernation Engine): Automatic freezing (status: frozen) when a client is demoted, and instant thawing upon reactivation to protect proprietary assets.
  7. Precision Time Tracker: Session tracker with quick increment chips [ +15m ] [ +30m ] [ +1h ] [ +2h ] [ +4h ] and a sticky action header for long task views.
  8. Web Audio Sound Suite: Pure sine, acoustic grand piano, and tactile ASMR mechanical feedback with a granular event matrix and undoable action toasts.

⚙️ 18 Backend Core Services

Service Class Responsibility
WorkPress_Project_Service Project lifecycle, progress calculations, prefix indexing, and lead assignment
WorkPress_Task_Service Task state transitions, checklist verification, and priority governance
WorkPress_Contribution_Service Evidence recording, pending deletion requests, and solution acceptance
WorkPress_Knowledge_Service Extraction of accepted solutions, markdown book generation, and search indexing
WorkPress_Portal_Service Client portal workspace, deliverable feedback, and digital sign-offs
WorkPress_Broadcast_Service Live horizon event streams, management directives, automated operational alerts, and ticker sync
WorkPress_Webhook_Service HMAC-SHA256 signature generation and Discord/Slack/Teams dispatchers
WorkPress_Hibernation_Service Automatic freezing and thawing of client projects upon role changes
WorkPress_Membership_Service Project membership verification, lead checks, and client email matching
WorkPress_Intake_Service Dynamic intake form schema processing and request triaging
WorkPress_Activity_Service Immutable audit trail generation for all state transitions
WorkPress_Metrics_Service Aggregation of executive metrics, velocity indicators, and completion stats
WorkPress_Capabilities_Registry Registration and enforcement of all 27 atomic capability permissions
WorkPress_Roles_Service Dynamic custom role creation, archetype cloning, and role aliases
WorkPress_Settings_Service System preferences, time localization, and sound event mappings
WorkPress_Notification_Service Internal notifications and automated email dispatchers
WorkPress_Time_Service Work log sessions, estimate accuracy tracking, and budget burn rates
WorkPress_Export_Service Full system JSON backups and printable handover report generation

🗄️ Native Zero-Table Data Model

┌─────────────────────────┬───────────────────────────────┬─────────────────────────────────┬──────────────────────────────────────────┐
│ Entity                  │ WordPress Core Construct      │ Core Database Table             │ Metadata Storage                         │
├─────────────────────────┼───────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ Project                 │ Custom Taxonomy (workpress_project) │ wp_terms & wp_term_taxonomy │ wp_termmeta (Lead, Status, Client, Prefix)│
│ Task                    │ Custom Post Type (work_item)  │ wp_posts                        │ wp_postmeta (Priority, Estimate, Assign) │
│ Contribution            │ Custom Comment (wp_contribution) │ wp_comments                  │ wp_commentmeta (Type, Is_Solution, Trash)│
│ Knowledge Base          │ Read Model of Accepted Solutions │ wp_comments (is_solution = 1)│ Direct query model (Zero data redundancy)│
│ Audit Trail             │ Audit Comments (wp_audit)     │ wp_comments                     │ Immutable historical logs                │
│ Webhooks                │ Option Key with HMAC Secret   │ wp_options                      │ Encrypted SHA256 webhook configurations  │
└─────────────────────────┴───────────────────────────────┴─────────────────────────────────┴──────────────────────────────────────────┘

🇸🇦 العربية

🧭 الرؤية وفلسفة العمل السيادية (Vision & Philosophy)

«WorkPress — just work.»
أنت تركز على العمل الفعلي وتوثيق الأدلة، وWorkPress يتولى الحوكمة، الإكمال المتتالي، أرشفة الذاكرة، وإشعار أصحاب المصلحة آلياً.

WorkPress (وركـبـرس) هو محرك سيادي مؤسسي (Enterprise Work & Knowledge Engine) يحول ووردبريس من مجرد نظام لإدارة المحتوى (CMS) إلى بيئة تشغيل مؤسسية متقدمة، ومنصة لإدارة المشاريع والمهام، ومصادقة مخرجات العملاء، وتوليد بنك معرفة دائم غير قابل للمحو.

🏛️ الركائز الهندسية الست لمنظومة WorkPress

  1. 🏛️ الأنطولوجيا الأصلية بدون جداول مخصصة (Native Zero-Table Ontology): صفر جداول SQL ملوثة؛ كافة كيانات النظام مبنية أصلياً فوق معمارية ووردبريس (Terms, Posts, Comments, Meta) لضمان استدامة وتوافق البيانات للأبد.
  2. 🛡️ الحقيقة تقود الحالة (Truth-Driven State): لا توجد حالات وهمية أو تعديلات عشوائية؛ المساهمة الفنية المعتمدة والدليل المرفق هما البرهان الوحيد على تقدم العمل، مع حفظ أثر تاريخي غير قابل للمحو.
  3. ⚡ الإكمال المتتالي وسلسلة الاستخلاص المعرفي (Cascading Lifecycle & Knowledge): اعتماد الحل $\rightarrow$ إكمال المهمة $\rightarrow$ اختتام المشروع $\rightarrow$ استخلاص الحل كأصل معرفي دائم في بنك المعرفة.
  4. 🏢 البوابة المستقلة وهرم المواطنة (Standalone Portal & 4-Tier Citizenship): عزل تام 100% بنظام Zero CSS Bleed لبوابة المستفيدين /portal/، مع فصل كامل بين الإدارة الفنية والعملاء.
  5. 🔒 مصفوفة التفويض الثلاثي والقدرات الذرية (Tri-Partite Authorization): فرض معادلة الأمان: $\text{CanPerform} = \text{GlobalCapability} \land \text{ProjectVisibility} \land \text{ResourceRelationship}$ عبر 8 حزم صلاحيات ذرية.
  6. 📡 خطافات الويب والتكامل الخارجي المشفر (Cryptographic Webhooks): بث فوري لأحداث المنظومة بتوقيع رقمي مشفر HMAC-SHA256 مع قوالب جاهزة لـ Discord و Slack و Teams و ERPs.

👥 هرم المواطنة وعزل المساحات الثلاث (Citizenship & Tri-Space Sovereignty)

1. هرم المواطنة الرباعي (4-Tier Citizenship Hierarchy)

المستوى الرتبة والدور الواجهة المخصصة السلوك الأمني وسياق العمل
👑 1 المدير العام (administrator) غرفة عمليات CoWorkPress (/wp-admin/) الحوكمة الشاملة، تعديل مصفوفة الصلاحيات، تعيين القادة، وإدارة غرف العمليات
🛠️ 2 الكوادر الفنية وفرق التنفيذ (editor, author, contributor) غرفة العمليات والكانبان ومخطط جانت المحرر: قيادة المشاريع واعتماد الحلول. الكاتب: إنتاج مستقل. المساهم: مهام مسندة
💼 3 المستفيدون وأصحاب الطلبات (workpress_client) بوابة المستفيدين المعزولة (/portal/) معزول تماماً عن لوحة الإدارة؛ تقديم الطلبات، المراجعة التفاعلية، والتوقيع الرقمي للمخرجات
👁️ 4 المشتركون والمجتمع (subscriber) واجهة الموقع العام (Frontend) حساب المتابعة العامة المحمي، مع توجيه ذكي وآمن عند تسجيل الدخول

2. الفصل المعماري والسيادي للمساحات الثلاث (The Tri-Space Separation)

┌──────────────────────────────────┐   ┌──────────────────────────────────┐   ┌──────────────────────────────────┐
│   المساحة 1: موقع WP العام       │   │  المساحة 2: بوابة المستفيدين     │   │ المساحة 3: غرفة عمليات CoWorkPress│
│    (Public Web Front-end)        │   │    (Standalone Portal /portal/)  │   │     (Admin SPA Workspace)        │
├──────────────────────────────────┤   ├──────────────────────────────────┤   ├──────────────────────────────────┤
│ • الزوار، القراء، والعموم        │   │ • المستفيدون وأصحاب المشاريع     │   │ • الكوادر الفنية وفرق التنفيذ    │
│ • صفر وصول للعمليات الداخلية     │   │ • عزل تام 100% Zero CSS Bleed   │   │ • الكانبان، جانت، بنك المعرفة   │
│ • صفر استهلاك لأصول وركبرس       │   │ • تقديم الطلبات والتوقيع الرقمي  │   │ • حماية بمعادلة التفويض الثلاثي  │
└──────────────────────────────────┘   └──────────────────────────────────┘   └──────────────────────────────────┘

🛡️ مصفوفة الصلاحيات والحزم الذرية (34 Atomic Capabilities)

توفر المنظومة 34 صلاحية ذرية سيادية مجمعة في حزم مبرمجة، قابلة للتعديل والتخصيص الفوري لكل دور ومستخدم:

1. إدارة المشاريع       ➔ read_workpress_projects, create_workpress_projects, edit_workpress_projects, delete_workpress_projects, manage_project_members
2. تنفيذ المهام         ➔ read_workpress_tasks, create_workpress_tasks, edit_assigned_tasks, edit_others_workpress_tasks, change_task_status, assign_tasks, delete_workpress_tasks
3. تدفق المساهمات       ➔ read_contributions, add_contributions, edit_contributions, delete_contributions, accept_solutions, revoke_solutions
4. وارد واستقبال الطلبات ➔ submit_work_requests, view_incoming_requests, triage_requests, approve_requests, reject_requests
5. حوكمة وبنك المعرفة   ➔ read_knowledge_base, generate_executive_reports, export_knowledge_book
6. إدارة وتكوين النظام  ➔ access_workpress_admin, manage_workpress_settings, manage_intake_forms, manage_webhooks
7. بوابة المستفيدين     ➔ access_workpress_portal, view_own_deliverables, submit_client_feedback, signoff_project_deliverables

🚀 منظومة المحركات الإنتاجية المدمجة (High-Density Productive Engines)

1. لوحة الكانبان فائقة الكثافة ومؤشر التحميل (Kanban Studio & Ratio)

  • بطاقات مهام غنية بأغلفة بارزة بارتفاع 220px وزوايا حادة 0px.
  • سطر مستقل للمشروع المنتمي مع أيقونة المحفظة، وشريط أدوات سفلي متراص يضم شارات الأولوية والحالة وعدادات الوقت وتكليفات الأعضاء.
  • مؤشر نسبة المهام المحملة ومصد التوقف: شارة ديناميكية لعدد المهام المعروضة مقابل الإجمالي (20 / 114 ➔ 114 / 114) مع علامة الإنجاز الزمردية (✓) ومصد القاع لمنع التكرار العبثي للطلبات.

2. محرك النشريات والتنبيهات التشغيلية الحية (Live Horizon Broadcasts)

  • شريط التنبيهات المدمج (BroadcastTicker): حركة بزوغ عمودية مقيدة، شارات أولوية ملونة مصمتة (Solid Fill)، وأزرار تنقل متناسقة بمقاس 30px مطابقة تماماً لزر الإضافة السريع.
  • مركز النشريات المتكامل (BroadcastsPage): أفق تشغيلي حي، كشف للمهام الحرجة، توجيهات الإدارة، ومودال تفاصيل تفاعلي.

3. محرك التدويل وتعدد اللغات الفوري (Universal 4-Language i18n Engine)

  • تطابق كامل 100% بين 4 لغات معتمدة (العربية، الإنجليزية، الفرنسية، الإسبانية) بـ 2,269 مفتاحاً معيارياً.
  • مبدل لغات فوري (LanguageQuickMenu) مع دعم التبديل الآني للاتجاه (RTL/LTR) والخطوط عبر المتصفح مباشرة.

4. مخطط جانت والجدولة الزمنية المؤسسية (Master Gantt Suite)

  • 4 مقاييس زمنية متكاملة: (24 ساعة لليوم الحالي، أيام كاملة بأسماء عربية، أسابيع، وشهور).
  • مؤشر الوقت الحي (Live Current Time Needle): خط رأسي أحمر نابض يوضح الساعة والدقيقة الفعلية لليوم.
  • أزرار التحكم الجماعي في شجرة المشاريع: أزرار [ توسيع الكل ] و [ طي الكل ] لإدارة مئات المهام المتفرعة بنقرة واحدة.
  • بطاقات معاينة عائمة ذكية عريضة 350px بنظام التصاق يمنع حجب البارات.

5. بنك المعرفة والأرشفة الحية (Knowledge Base Engine)

  • استخلاص تلقائي فوري لكافة الحلول والمساهمات المعتمدة وتحويلها إلى بنك معرفي قابل للبحث والاسترجاع.
  • مولد كتيب المعرفة الشامل (.md): تصدير كامل المعرفة الهندسية المعتمدة بصيغة Markdown بضغطة زر.
  • وثائق استلام واعتماد مجهزة للتصدير والطباعة الرسمية بجودة A4 Corporate PDF.

6. ثلاجة المشاريع السيادية (Project Cold Storage & Hibernation)

  • محرك تجميد وإذابة آلي للمشاريع (status: frozen) عند تغيير أو خفض رتبة العملاء لحماية سرية وأمان المنشأة.

7. متتبع الوقت وشرائح الإضافة السريعة (Task Time Tracker)

  • تتبع الساعات المقدرة والفعلية مع شرائح الإضافة السريعة [ +15د ] [ +30د ] [ +1س ] [ +2س ] [ +4س ].
  • ترويسة إجرائية مثبتة (Sticky Action Bar) في صفحة تفاصيل المهمة لتسهيل الحفظ والتعديل أثناء التمرير.

8. المؤثرات الصوتية والتوست التفاعلي الشامل (Audio & Notification Suite)

  • حزمة نغمات إلكترونية وميكانيكية وبيانو مدمجة بمحرك Web Audio API لتأكيد العمليات (الاعتماد، الحذف، التنبيهات).
  • نظام توست إشعارات ملون وشامل يتيح التراجع الفوري عن القرارات الخاطئة.

9. الدستور البصري الموحد وهندسة الحواف الحادة 0px (Universal Visual System)

  • دستور الأزرار الثلاثي الموحد (Universal Tri-State Button Law): توحيد أزرار المنظومة على 3 حالات: الافتراضي أبيض نقي بإطار رمادي دقيق وزوايا حادة 0px، التحويم برمادي داكن أردوازي (#334155) مع خط وأيقونة بيضاء ناصعة، والنشط بأخضر الشعار (#10b981). حظر كامل لقوس قزح الأزرار الملونة.
  • دستور الأيقونات المونوكرومي الموحد (Universal Monochrome Icon Law): أسود فحمي #0f172a حصرياً لكافة الأيقونات في الوضع الافتراضي، مع الانقلاب للأبيض الناصع عند التفاعل.
  • زر الإضافة السريع الموحد (+) مع القائمة المنسدلة الذكية (QuickAddMenu): جمع عمليات الإضافة في زر واحد بالـ Breadcrumb مع نافذة تقديم الطلبات السريعة (RequestModal).
  • أشرطة الأدوات الموحدة بالهيدر (UnifiedToolbar via Portal): تعميم شريط الأدوات الموحد في كافة الصفحات الرئيسية ليركب أسفل الـ Breadcrumb.

⚡ متطلبات التشغيل والتثبيت (Installation)

المتطلبات الأساسية (Prerequisites):

  • WordPress: 6.0 أو أحدث.
  • PHP: 8.0 أو 8.1 أو 8.2 أو 8.3+.
  • Web Server: Apache / Nginx / LiteSpeed مع تمكين الروابط الدائمة (Pretty Permalinks).

خطوات التثبيت:

  1. انسخ مجلد WorkPress داخل مسار إضافات ووردبريس:
    wp-content/plugins/WorkPress/
  2. فعّل الإضافة من لوحة تحكم ووردبريس: إضافات ➔ إضافات منصّبة ➔ تفعيل WorkPress.
  3. استمتع بغرف العمليات والبوابات عبر الروابط المباشرة:
    • غرفة عمليات CoWorkPress: https://your-domain.com/wp-admin/admin.php?page=workpress
    • بوابة المستفيدين المستقلة: https://your-domain.com/portal/
    • بوابة تسجيل الدخول الذكية: https://your-domain.com/workpress-login/

📚 مركز التوثيق ومراجع المطورين (Documentation Hub)

للحصول على التوثيق المعماري والبرمجي الكامل:

📜 الترخيص والحقوق (License)

مشروع WorkPress مرخص بالكامل تحت رخصة GNU General Public License v2.0 (GPLv2).
راجع ملف LICENSE للاطلاع على نص الرخصة كاملاً.

صُنع بأعلى معايير الهندسة المعمارية والسيادة الرقمية لخدمة المنشآت وفرق العمل الاحترافية.
WorkPress Core Engineering Team • 2026