خطة معالجة الثغرات: التخطيط + ملكية الخامات المختلطة والأمانة

تحليل الوضع الحالي + الحل المقترح للمعضلات الثلاث التي رفعها المالك

1. المعضلات الثلاث (كما طُرحت)

المعضلة A — التخطيط: عايز دور/مرحلة تخطيط واضحة (مين يخطّط، إيه مخرجاته، فين بين طلب العميل وأمر الإنتاج).
المعضلة B — ملكية مختلطة + انقسام صنف: في أمر الأمانة، جزء من الخامة من عندي وجزء من العميل — بل نفس الصنف الواحد ممكن ينقسم (جزء مني + جزء العميل).
المعضلة C — الاستلاف والتسوية: ممكن آخد جزء من بضاعة العميل لأمر إنتاج بتاعي، وأرجّعه أو أشتريه بعدين (أبقى أنا أول مشتري). مفيش آلية لده.

2. الوضع الحالي (تشخيص صريح)

القدرة	الحالة	التفصيل
ملكية على مستوى الأمر (own/customer)	موجود	`production_orders.material_ownership` + `isToll()`
ملكية على مستوى سطر الصرف	موجود	`mfg_material_issue_lines.ownership` — البنية التحتية موجودة فعلاً
الترحيل المحاسبي «أمان الأمانة»	موجود	`ownTotalCost()` يستبعد سطور العميل من WIP — سطر بسطر
إعلان ملكية لكل مكوّن في المعادلة (BOM)	ناقص	`BomComponent` مافيهوش حقل ملكية — المعادلة كلها أمانة أو كلها ملكي
انقسام صنف واحد (جزء مني + جزء العميل)	ناقص	السطور بتتختم كلها من علم الأمر — مفيش منطق يقسّم مكوّن لسطرين
دفتر مخزون أمانة العميل عندك	ناقص	مفيش جدول لرصيد خامة العميل عند المصنع
الاستلاف + التسوية (ترجيع/شراء)	ناقص	مفيش آلية «المصنع استلف من العميل ومدين له / هيشتري»
دفعة مقدّمة للعميل (Advance)	موجود	`down_payment_total` → حساب «أمانات العملاء»
مرحلة التخطيط (MRP/MPS)	رفيعة	MRP يولّد أوامر مخططة للمبيعات، لكن أوامر الأمانة بتتخطّى التخطيط خالص

الخبر الجيد

أصعب جزء محاسبيًا (الملكية على مستوى السطر + استبعاد تكلفة العميل من WIP) موجود وشغّال. الناقص بمعظمه إضافي (additive) فوق الأساس ده — مش إعادة بناء.

3. الحل — المعضلة B: ملكية مختلطة + انقسام الصنف Phase A — سريع

نستغل بنية «السطر» الموجودة، ونضيف إعلان ملكية لكل مكوّن + منطق تقسيم عند بناء مواد الأمر.

نموذج البيانات (إضافات)

الجدول	الإضافة	المعنى
`bom_components`	`supply_source` enum {factory, customer, split} `customer_qty_per_unit` decimal (للـsplit)	المعادلة بتعلن: المكوّن ده يجيبه العميل، ولا المصنع، ولا مقسوم — وكام من العميل لكل وحدة منتج
`mfg_toll_contract_lines`	(اختياري) override للمكوّنات الي العميل بيوفّرها	تعديل لكل عقد فوق افتراض الـBOM
`mfg_material_issue_lines`	لا تغيير — `ownership` موجود	المكوّن المقسوم = سطرين: سطر own + سطر customer

المنطق (Build-Components)

عند بناء مواد الأمر: لكل مكوّن، الاحتياج الكلي = الكمية × المنتج. لو supply_source = split: customer_qty = customer_qty_per_unit × الكمية، والباقي own.
المكوّن المقسوم يولّد سطرين (own + customer). الترحيل المحاسبي الموجود يستبعد سطر العميل تلقائيًا من WIP — صفر تعديل محاسبي.
المخطِّط يقدر يعدّل الملكية/الانقسام لكل مكوّن من تبويب المواد قبل الإطلاق.

التكلفة التقديرية

منخفضة — حقول على BomComponent + منطق تقسيم في build-components + UI. يستفيد كليًا من البنية الموجودة.

4. الحل — المعضلة A: مرحلة تخطيط واضحة Phase B — متوسط

نضيف مرحلة «تخطيط وجاهزية المواد» صريحة بين الطلب (عقد أمانة / أمر بيع) وأمر الإنتاج — ونمرّر أوامر الأمانة من خلالها (بدل ما تتخطّاها).

المرحلة الجديدة (Production Plan / Material Readiness)

الطلبعقد أمانة / أمر بيع

التخطيطتفجير BOM + جاهزية المواد

قرار الموادملكي/أمانة/شراء لكل مكوّن

إطلاق أمر الإنتاججاهز ماديًا

لكل أمر مخطّط، المخطِّط يشوف: تفجير المكوّنات + التوفّر (مخزوني / أمانة العميل / لازم يتشرى) + الملكية لكل مكوّن + النواقص.
لوحة تخطيط يومية بحالة جاهزية كل أمر (جاهز / ناقص / في انتظار خامة العميل). /factory/planning
النواقص الملكية تولّد طلبات شراء تلقائيًا؛ نواقص العميل تتعلّم كـ«في انتظار توريد العميل».
دور production_planner موجود — نكمّله بصلاحية/شاشة المرحلة دي.

قرار مطلوب

هل المرحلة دي إلزامية لكل أمر (يمنع الإطلاق قبل الجاهزية) ولا اختيارية (تحذير فقط)؟

5. الحل — المعضلة C: مخزون أمانة العميل + الاستلاف والتسوية Phase C — الأثقل

الجزء الأكبر — لأنه مفقود تمامًا. نضيف دفتر مخزون أمانة لخامة العميل عند المصنع + آليات الاستلاف والتسوية.

نموذج البيانات (جديد)

الجدول الجديد	الغرض
`mfg_consignment_receipts`	استلام خامة من العميل (يدخل كمخزون مملوك للعميل عند المصنع، بدون قيمة في مخزونك)
`mfg_consignment_ledger`	رصيد لكل (عميل، خامة): مستلَم − مصروف لأوامر العميل − مُستلَف لأوامرك − مُسوّى
`mfg_consignment_settlements`	تسوية الاستلاف: ترجيع (نفس الخامة) أو شراء (تبقى أنت المشتري → فاتورة شراء من العميل-كمورّد)

السيناريوهات

صرف خامة العميل لأمر أمانة: يخصم من رصيد الأمانة، بدون قيمة في WIP (زي الحالي). ✅
استلاف خامة العميل لأمر ملكي بتاعك: الخامة المستهلكة تدخل WIP بقيمتها، ويتولّد التزام «مواد مستحقة للعميل» (دفتر الاستلاف).
التسوية — ترجيع: ترجّع نفس الخامة → يقفل الالتزام بدون نقد.
التسوية — شراء («أرجع أول مشتري»): تشتري الخامة من العميل → فاتورة شراء (العميل = مورّد) تقفل الالتزام وتنقل القيمة لمخزونك/تكلفتك رسميًا.
الاتجاه العكسي: لو المصنع وفّر خامة لأمر أمانة بدل العميل، يتولّد مستحَق على العميل يُضاف لفاتورة أجر التصنيع.

قرارات مطلوبة

سعر الاستلاف/الشراء: تكلفة العميل المعلنة، ولا سعر السوق، ولا متفق عليه في العقد؟
التسوية الافتراضية: ترجيع أم شراء؟
هل نتتبّع خامة العميل بدفعات/صلاحية (دوائي) ولا كميات فقط؟

6. خطة التنفيذ المقترحة (مراحل)

المرحلة	تحلّ	الحجم	المخرجات
A	المعضلة B (ملكية لكل مكوّن + انقسام)	سريع / إضافي	حقول BOM + منطق تقسيم + UI المواد + اختبارات + تقرير «ملكية مواد الأمر»
B	المعضلة A (مرحلة التخطيط)	متوسط	لوحة تخطيط/جاهزية + تمرير الأمانة عبر التخطيط + توليد طلبات شراء للنواقص الملكية
C	المعضلة C (الأمانة والاستلاف)	الأثقل	دفتر مخزون الأمانة + استلام/صرف/استلاف + تسوية (ترجيع/شراء) + التكامل المحاسبي

التوصية

نبدأ Phase A (أعلى قيمة لأقل مجهود — يستغل الأساس الموجود ويحلّ الملكية المختلطة والانقسام)، وبعدها B (التخطيط)، وأخيرًا C (الأمانة والاستلاف — الأثقل، بعد تثبيت القرارات أعلاه). كل مرحلة بنفس دورة الأوتوبايلوت: سبيك → أيجنتس متوازية → جِيت → مراجعة → نشر → بوش.

7. القرارات المطلوبة منك قبل البدء

الترتيب: أبدأ بـ Phase A (الملكية المختلطة/الانقسام)؟ ولا ترتيب تاني؟
التخطيط (B): مرحلة إلزامية تمنع الإطلاق قبل الجاهزية، ولا تحذير فقط؟
الاستلاف (C): سعر الاستلاف (تكلفة العميل/سوق/عقد)؟ التسوية الافتراضية (ترجيع/شراء)؟ تتبّع بدفعات وصلاحية ولا كميات؟