خريطة شاملة للموديول كله — الباك (Laravel) والفرونت (Angular) ومشروع محاسبة التكاليف بمراحله — مجمّعة من فحص الكود الفعلي + خطط الـ KB، تمهيدًا للنقاش عليه.
نظام تصنيع كامل (discrete + process) مبني جوّه Modules/Production — قرار صريح: نوسّع في مكانه، مش نعمل موديول جديد. وهو "عميل" لـ٩ موديولات تانية (مخازن، مشتريات، مبيعات، محاسبة/Core، HR، جودة، صيانة...) مش جزيرة منعزلة.
بيغطّي المصنع من أوله لآخره:
Laravel 12 module (nwidart) في Modules/Production.
/api/production/*Angular 21 standalone، شاشات المصنع تحت /factory/*.
permissionGuardالموديول "عميل" لباقي الموديولات.
/core/production/* (6 routes) — والحديثة standalone /factory/* (44+ route، شاشة كاملة) وهي الأساسية. الـ factory-layout فيه sidebar قابل للطي (localStorage) ومجموعات تنفتح تلقائيًا حسب المسار النشط.الهدف: رفع تغطية محاسبة التكاليف من ~38% لتغطية كاملة عبر 8 مراحل (0–7) + مسار منفصل A/B/C للـ consignment. كل مرحلة بنفس "الأوتوبايلوت": spec → وكلاء متوازيين → دمج → اختبارات Pest → ديبلوي → مراجعة عدائية → اعتماد المالك → push.
| المرحلة | المحتوى | الحالة |
|---|---|---|
| 0 — التثبيت | تصحيح سلامة الأرقام: idempotency على القيود، re-check للحالة تحت قفل داخل الـ transaction، عكس قيد إلغاء صرف الخامة، إصلاح netting في MRP. | ✅ مُسلّمة |
| 1 — دورة التول | عقود التول (التقاط تعاقد العميل قبل الـ BOM)، أمر بمواد العميل، دفعة مقدمة، مخزن "تحت التشغيل" + backflush، بوابة QC "الروتينة" بتمنع استلام المنتج قبل الإفراج، CoA، سجلات تشغيلات. | ✅ مُسلّمة |
| 2 — مكاسب سريعة | تكاليف المخزون (carrying/EOQ/safety/ROP/obsolescence) + تقارير إنتاج (هامش/سكراب/ربحية مركز تكلفة/طاقة) + 6 أدوار حوكمة. | ✅ مُسلّمة |
| 3 — تحليلات وتقارير | CVP/نقطة تعادل + ربحية عميل + ABC + KPI dashboard + تقارير (WIP-aging، ربحية أمر، std-vs-actual، تسوية تول) + انحرافات الموازنة + 9 تنبيهات ذكية. | ✅ مُسلّمة |
| 4 — تسعير ومشتريات | محرك تسعير (cost-plus/margin → قائمة أسعار) + بطاقة أداء مورّد + تكلفة الجودة (PAF) + landed cost بإعادة تقييم طبقات + GL. (المراجعة أصلحت 2 CRITICAL). | ✅ مُسلّمة |
| 5 — توزيع تكاليف عبر الموديولات | HR→إنتاج (قسم↔مركز تكلفة، labor variance)، محرك توزيع أوفرهيد/مرافق (ساعات آلة/عمالة، largest-remainder، GL متوازن)، TCO + Make-or-Buy + جسر CMMS، scrap عند رفض QC، تقرير GL integrity. | ✅ مُسلّمة |
| 6 — التزام وحوكمة و R&D | قفل فترة + تدقيق (حالة Locked نهائية، قفل تلقائي عند إقفال السنة)، سحب تشغيلات الأدوية (recall) بـ genealogy مزدوج + تتبع عميل + حجر تسلسلي، التقاط تكاليف R&D + إطفاء → std_rnd_cost. (المراجعة أصلحت 8 issues منها 2 CRITICAL). | ✅ مُسلّمة |
| 7 — مزايا الـ AI (6) | 6 مزايا تكلفة بالذكاء الاصطناعي (تفاصيل تحت §7). القاعدة الذهبية: الـ AI ما يحسبش رقم أبدًا. | ✅ في الكود ⚠️ راجع §11 |
| — مسار A/B/C المنفصل (ملكية المواد + consignment) — | ||
| A — ملكية المواد | ملكية على مستوى السطر (own_qty / customer_qty)، صرف يستهلك الاتنين بس GL للجزء المملوك بس. صفر تغيير محاسبي (إضافي). | ✅ مُسلّمة |
| B — تخطيط وجاهزية | مرحلة Planning & Material-Readiness + لوحة /factory/planning. | ↩︎ اترجعت (مكررة) |
| C — الاستعارة الصريحة | consignment باستعارة صريحة: المصنع يستهلك خامة العميل لأمره هو → تدخل WIP بقيمتها + التزام "مواد مستحقة للعميل" → تتسوّى بـ إرجاع أو شراء. جداول mfg_consignment_*. | ✅ مُسلّمة + مدموجة في main |
released = حجز خامات + تجميد BOM · أول صرف خامة يقلب لـ in_process · closed = تسوية WIP لـ GL · الإلغاء من planned/released بس.
تسلسل صارم: العملية N+1 تستنى N تخلص · on_hold للتوقف (downtime) وترجع in_progress · شاشة المشرف بتعرض [ready, in_progress, on_hold].
draft → active → inactive (الأوامر القديمة بتجمّد snapshot).draft → confirmed → in_production → completed/cancelled.open → acknowledged → investigating → closed (خطّي، بدون إعادة فتح).draft → released/rejected (released شرط لـ BMR).| الرِجل | الحساب |
|---|---|
| ① خامات | تفجير BOM تكراري: الوحدة = component.qty/batch_qty × (1+waste%)، تكلفة الورقة من std أو purchase_price. |
| ② عمالة | Σ(hours_per_unit × labor_cost_rate) — الساعات = run_time/60. (وقت الإعداد مش مُوزّع في v1). |
| ③ أوفرهيد | Σ(hours × machine_cost_rate + labor_hours × overhead_rate). تكلفة الآلة = أوفرهيد مش عمالة مباشرة. |
| ④ R&D (إضافية) | std_rnd_cost — محفوظة بواسطة RndAmortizationService، الـ roll-up ما بيصفّرهاش. |
عند إقفال الأمر بيتفكّك الانحراف لـ: MPV سعر خامةMUV استخدام خامةLRV معدل عمالةLEV كفاءة عمالةVOSV إنفاق أوفرهيد متغيرVOEV كفاءة أوفرهيد متغيرFOVV حجم أوفرهيد ثابت — يتصنّف بنِسب، و owner_role يوجّه التحقيق بإشعار.
| الحدث | القيد |
|---|---|
| صرف خامة (MaterialIssued) | مدين WIP / دائن المخزون (بطريقة التكلفة) |
| تأكيد عملية (ConfirmationPosted) | مدين WIP / دائن عمالة مُحمّلة + أوفرهيد مُحمّل |
| استلام منتج تام (GoodsReceiptPosted) | مدين منتج تام / دائن WIP (بالتكلفة المعيارية) |
| إقفال (تسوية الانحراف) | مدين COGS / دائن WIP |
| تول (مواد العميل) | بدون GL عند الصرف · الرسوم تتسوّى عند الاستلام (Toll Clearing) |
| مرافق · سكراب | مدين أوفرهيد/المركز · مدين سكراب / دائن WIP |
CostAiServicevalidateNumbers() بيعلّم أي رقم اخترعه الـ AI (flagged_numbers). Provider-agnostic على Claude (sonnet-4-6 + opus)، والنتائج محفوظة في cost_ai_insights.كشف شذوذ/قفزات التكلفة (مبني على التنبيهات + دلتا فعلي-مخطط).
شرح سبب الانحراف للأمر (مبني على سجلات الانحراف المفكّكة).
اقتراح تسعير/مرونة طلب للمنتج (PricingService + CVP).
توقّع احتمال السكراب (تاريخ السكراب + CoQ).
تصنيف مخاطر المورّد (SupplierScorecard).
توصيات مزيج المنتجات/الهامش (ربحية العميل + CVP).
في الفرونت: hub /factory/cost-ai — كل لوحة: جدول grounding + سرد + درجة خطورة + توصيات + badge للأرقام المُعلّمة. الصلاحيات: production.cost_ai.view (عرض) وproduction.cost_ai.run (تشغيل).
/factory| المجموعة | الشاشات |
|---|---|
| نظرة عامة وبيانات أساسية | Dashboard · Work Centers · BOMs · Routing · Tools · Calendars · Standard Costs · Batches · CoA |
| تخطيط وجدولة | MRP Cockpit · MPS · CRP Board · Capacity Board |
| أوامر الإنتاج | Orders list · Order Cockpit (stepper + 6 تابات: جاهزية مواد، عمليات، تكلفة، أثر GL، تشغيلات، pegging) |
| أرض المصنع (Shop Floor) | Confirmations · Staging · Terminal (لمس للعامل) · Supervisor Board (live، تحديث 30 ثانية، عرض حائط) |
| تول / consignment | Toll Contracts · Toll Settlement · Consignment Ledger |
| جودة والتزام | Recall (سحب) · Cost of Quality |
| تكاليف وتحليلات (~19) | هامش · سكراب · ربحية مركز تكلفة · تكاليف مخزون · std-vs-actual · WIP aging · ربحية أمر · CVP · ربحية عميل · انحراف موازنة · انحراف عمالة · مرافق · TCO أصول · make-or-buy · GL integrity · تسعير |
| ذكاء (Intelligence) | KPI Dashboard · Smart Alerts (9 تنبيهات) · Cost-AI Hub (6 لوحات) |
الداش بورد: 10 بطاقات KPI (yield, scrap, OTD, capacity, OEE, WIP value, throughput, cycle time...) + شريط "اليوم" (6 خلايا) + 4 رسوم + load board لكل مركز عمل + تنبيهات + أوامر متأخرة + أعلى منتجات.
mfg_order_cases يحمل المراحل التجارية (عرض، تجريبي، انتظار دفعة...) عشان ما يلمسش الـ state machine الرسمي للأمر.ProductionOrder kind=trial + sales_order_id ينفّذه R&D، يورث كل بنية التكلفة ويفضل مربوط بأمر العميل.ApprovalWorkflow.php, ApprovalLog.php) بس الـ enum بتاعه بيغطّي المبيعات والمشتريات بس — مفيش أنواع مستندات إنتاج. التوصيل = إضافة ApprovalModule::Production + أنواع (bom, production_order, trial_batch) لإعادة استخدام المحرك بدل بناء منطق اعتماد خاص. (حاليًا الانحرافات بتستخدم إشعارات بالأدوار بس، مفيش بوابة اعتماد رسمية).material_ownership بيتفقد عند الحفظ في الـ UI فمينفعش تعمل أمر تول من الشاشة. محتاج تأكيد على الكود الحالي (ممكن يكون اتصلح — راجع §11).شريط جودة CoA · ترند variance_monthly · معرّفات الأوامر المتأخرة الحقيقية. + تأكيد إن إضافات DB للتصنيع موجودة على test/elmadina (نسخ قديمة كانت ناقصة — راجع seeder gap في moonstack-update).
Modules/Production في مكانه — مفيش موديول جديد (أول وأهم قرار).mfg_order_cases للمراحل التجارية عشان نسيب الـ state machine الأساسي زي ما هو.production.md).CostAiService + الخدمات + CostAiInsight + الـ UI) وPhase C consignment (الجداول + Actions: RecordBorrow/SettleBorrow) وPhase A (ملكية المواد) كلها موجودة فعلًا في الريبو — وده مطابق لموضوع production.md الأحدث (18 يونيو): «Phases 0–7 + A done & pushed؛ Phase B reverted؛ Phase C shipped + merged to main».
المصادر: Modules/Production (BE — 47 model/26 action/25 service) features/production (FE — 49 شاشة) knowledge-base/topics/production.md mfg-cost-accounting-plan.html (خطة المراحل) mfg-mto-flow-plan.html mfg-ownership-planning-gaps-plan.html mfg-pharma-toll-fitgap.html manufacturing-erp-analysis-report.html