خطة: صفحة الحسابات الافتراضية في الـ Setup — مقسّمة بالموديولات + مختارة افتراضيًا

الهدف باختصار

دلوقتي خطوة «الحسابات الافتراضية» فيها 7 خانات ثابتة بتكتب مفاتيح accounting.default_* — الباك إند مش بيقراها أصلًا عند الترحيل (مفيش تعريف ولا أي كود محاسبي بيستهلكها)، والصفحة مش بتحمّل القيم المحفوظة. الكود الحقيقي بيقرا مفاتيح بالـ namespace module.*_account_id.

الخطة: نحوّلها لـ أقسام قابلة للطي لكل موديول، كل خانة مختارة افتراضيًا بحساب تفصيلي مناسب، والحفظ يكتب المفاتيح الحقيقية اللي النظام بيرحّل منها فعلًا.

① مبدأين حاكمين للتصميم كله

🔴 فخ رأس حساب الذمم (AR/AP-header trap) — حادثة elmadina حسابات الذمم 1103 (مدينون) و2101 (دائنون) بتبدأ تفصيلية، بس أول ما يتعمل تحتها حساب فرعي لأول شريك → بتتحوّل لرأس/تحكّمي، وأي قيد بيترحّل عليها مباشرة بيرمي خطأ والفاتورة تفضل draft/unpaid بصمت. أي حساب ذمم افتراضي لازم يكون ابن تفصيلي (مثل 110301 / 210101) — أبدًا مش الأب نفسه.

⚠️ الترحيل بيكون على الحسابات التفصيلية بس (leaves) الرؤوس (1, 11, 2, 4, 5, 52…) بترمي لو قيد اترحّل عليها. فالـ picker لازم يعرض account_type==='detail' بس، ويستبعد رؤوس الذمم.

② إزاي كل خانة تيجي «مختارة افتراضيًا» (المتطلب الأساسي)

عند فتح الصفحة، لكل خانة نحدّد القيمة بترتيب 3 مستويات — عشان متبقاش فاضية أبدًا (زي سلوك الـ 7 الحاليين):

القيمة المحفوظة من الإعدادات لو موجودة وكانت حساب تفصيلي قابل للترحيل → نستخدمها.
وإلا الكود الافتراضي (autoCodes) → ندوّر على الحساب التفصيلي بالكود (مثل 4101/5101/1101).
وإلا فاضي — أبدًا مانختارش رأس حساب. خانات الذمم تختار ابن تفصيلي تحت 1103/2101 بس.

عشان تبقى مختارة من أول تثبيت: نوسّع seedDefaultAccountSettings() إنه يملأ المفاتيح الآمنة بأكوادها + ينشئ أبناء الذمم — فالشركة الجديدة توصل لـ /setup وكل حاجة مختارة جاهزة، وفخ الـ AR يتصلّح من المصدر.

③ جدول الحسابات الافتراضية لكل موديول

🟢 leaf = الافتراضي حساب تفصيلي جاهز · 🟠 ينشأ = نعمله find-or-create تحت أب · 🔴 AR/AP = فخ رأس الذمم (لازم ابن تفصيلي)

🔬

المعمل (LIS)

10 حسابات · أولوية

المفتاح	الاسم	الافتراضي	النوع
lis.receivable_account_id	حساب الذمم — Receivable	110301 ذمم مرضى المعمل	AR
lis.insurance_receivable_account_id	ذمم التأمين — Insurance Recv.	110302 ذمم شركات التأمين	AR
lis.revenue_account_id	الإيرادات — Revenue	4102 إيرادات الخدمات	leaf
lis.tax_payable_account_id	الضريبة المستحقة — Tax Payable	2105 ضرائب مستحقة	leaf
lis.cash_account_id	النقد — Cash	1101 النقدية بالصندوق	leaf
lis.cogs_account_id	تكلفة المباع — COGS	5101 تكلفة البضاعة المباعة	leaf
lis.discount_account_id	الخصومات — Discount	4105 خصومات المبيعات	leaf
lis.external_lab_payable_account_id	ذمم المختبرات الخارجية	210101 تحت 2101	AP
lis.external_lab_expense_account_id	مصروفات المختبرات الخارجية	ابن تحت 52	ينشأ
lis.reagent_expense_account_id	مصروفات الكواشف — Reagent	ابن تحت 51	ينشأ

🏭

التصنيع (Production)

8 حسابات · أولوية

مفيش منها حساب في الشجرة الافتراضية — كلها find-or-create تلقائي عبر ProductionAccountResolver تحت الرؤوس 11/21/52 (الـ picker يستدعي نفس الـ resolver). الأكواد أمثلة فقط مش ثابتة.

المفتاح	الاسم	الأب	النوع
production.wip_account_id	إنتاج تحت التشغيل — WIP	تحت 11 (أصل)	ينشأ
production.fg_account_id	منتجات تامة — Finished Goods	تحت 11	ينشأ
production.toll_clearing_account_id	تسوية التصنيع لدى الغير	تحت 11	by-style
production.labor_applied_account_id	العمالة المحمّلة — Labor Applied	تحت 21 (التزام)	ينشأ
production.overhead_applied_account_id	التكاليف غير المباشرة المحمّلة	تحت 21	ينشأ
production.customer_advance_account_id	سُلف العملاء — Customer Advances	تحت 21	by-style
production.scrap_account_id	هالك الإنتاج — Scrap	تحت 52 (مصروف)	ينشأ
production.cost_variance_account_id	انحراف تكلفة الإنتاج — Variance	تحت 52	ينشأ

👥

الموارد البشرية / المرتبات (HR)

10 حسابات · أولوية

المفتاح	الاسم	الافتراضي	النوع
hrm.salary_expense_account_id	مصروف الرواتب — Salary Exp.	5201 الرواتب والأجور	leaf
hrm.salary_payable_account_id	الرواتب المستحقة — Payable	2103 مصروفات مستحقة	leaf
hrm.social_insurance_account_id	التأمينات الاجتماعية	2105 (أو ابن تحت 21)	leaf
hrm.medical_insurance_account_id	التأمين الطبي	2105 (أو ابن تحت 21)	leaf
hrm.eos_provision_account_id	مخصص نهاية الخدمة — EOS Prov.	2202 مكافأة نهاية الخدمة	leaf
hrm.eos_expense_account_id	مصروف نهاية الخدمة	5201 (أو ابن تحت 52)	leaf
hrm.overtime_expense_account_id	مصروف العمل الإضافي	5201	leaf
hrm.leave_accrual_account_id	مخصص الإجازات — Leave Accrual	2103 مصروفات مستحقة	leaf
hrm.income_tax_account_id	ضريبة الدخل المستحقة	ابن تحت 21	ينشأ
hrm.loan_receivable_account_id	سُلف الموظفين — Loan Recv.	ابن تحت 11	by-style

💼

Sales · Purchases · Core (الموجودة — نصحّحها)

+ Treasury/POS

المفتاح	الاسم	الافتراضي	النوع
sales.revenue_account_id	إيرادات المبيعات	4101	leaf
sales.cogs_account_id	تكلفة المباع	5101	leaf
sales.receivable_account_id	ذمم العملاء	110301 تحت 1103	AR
purchases.payable_account_id	ذمم الموردين	210101 تحت 2101	AP
sales.tax_payable_account_id	الضريبة المستحقة	2105	leaf
accounting.default_cash_account	الصندوق	1101	leaf
accounting.default_bank_account	البنك	1102	leaf
accounting.default_check_account	أوراق القبض/الدفع	1104 / 2102	leaf
pos.cash_receiving_account_id	استلام كاش POS	1101	leaf

إجمالي ~56 مفتاح، يظهر منها ~46 في الـ picker (نستبعد: cost-center، JSON map، enum، أكواد نصية مثل inventory.stock_account، و toggles).

④ شغل الفرونت إند (FE)

الملفات: features/setup/setup-wizard.component.{ts,html,scss} + ملف جديد default-accounts.config.ts + ترجمات SETUP.*.

config مدفوع بالبيانات: مصفوفة 8 أقسام × المفاتيح الحقيقية، مع isAr وautoCodes وأيقونة لكل قسم. يستبدل ~85 سطر HTML مكرّر بـ @for واحد.
أقسام قابلة للطي: <p-accordion> — قسم لكل موديول، المعمل/التصنيع/HR مفتوحين افتراضيًا والباقي مطوي.
التحميل: نجيب الحسابات التفصيلية مرة واحدة + نقرا الإعدادات المحفوظة لكل موديول (نضيف lis وproduction للـ forkJoin — مش موجودين دلوقتي) → نختار: محفوظ ← كود ← فاضي.
الـ picker: account_type==='detail' بس + استبعاد رؤوس الذمم.
الحفظ: يكتب المفاتيح الحقيقية *_account_id عبر PUT /core/settings — مفيش تعديل controller (الـ endpoint بيقبل أي مفتاح).

⑤ شغل الباك إند (BE)

تصحيحات لازمة (correctness)

إصلاح 4 افتراضيات غلط: inventory.stock_account 1301→1105, inventory.cogs 4101→5101, default_revenue '41'→4101, checks_received 1103→1104.
إعادة توجيه sales.receivable/purchases.payable من 1103/2101 لأبناء تفصيليين (إصلاح فخ elmadina من المصدر).
إضافة تعريفين LIS: external_lab_expense + reagent_expense.

اختياري (موصى به)

توسعة seedDefaultAccountSettings() لملء كل المفاتيح الآمنة بأكوادها + إنشاء أبناء الذمم → الشركة الجديدة توصل /setup مختارة جاهزة.
إعادة استخدام AutoAccountService::createChildAccount + ProductionAccountResolver للحسابات اللي «تنشأ» — مش نعيد كتابتها.
(اختياري) param ?account_type=detail على endpoint الحسابات.

⑥ قرارات محتاجة رأيك ⚑

1) الحسابات اللي ملهاش افتراضي جاهز (~12: التصنيع، ضريبة المدخلات، مصروفات المعامل الخارجية، الكواشف، ضريبة الدخل، السُلف…)

(أ) ننشئها تلقائيًا وقت الحفظ/التثبيت (مختارة + شجرة منظّمة) · (ب) نسيبها فاضية والمستخدم يختار / تتنشئ عند أول قيد

توصية: ننشئ تلقائيًا عالية الاستخدام (WIP/FG/ضريبة مدخلات)، والباقي lazy.

2) نطاق الإصدار الأول

المعمل + التصنيع + HR (مفتوحين) + Core/Sales/Purchases (مطوية) دلوقتي، ونأجّل Treasury/POS · أو كل الـ 8 أقسام مرة واحدة

توصية: كل الـ 8 — التكلفة الإضافية بسيطة (نفس الـ config).

3) المفاتيح القديمة accounting.default_* (الميتة)

نلغيها ونستخدم المفاتيح الحقيقية بس · أو نفضل نكتبها للتوافق

توصية: نلغيها.

4) أكواد أبناء الذمم (AR/AP)

أكواد ثابتة محجوزة (110301/210101) في الشجرة الافتراضية · أو نخلّي AutoAccountService يولّد التالي

توصية: أكواد ثابتة → الاختيار الافتراضي يبقى حتمي.

⑦ ترتيب التنفيذ

تصحيحات BE (الأول): الـ 4 افتراضيات + إعادة توجيه الذمم لأبناء تفصيليين + تعريفي LIS.
(اختياري) توسعة seedDefaultAccountSettings() → الشركات الجديدة توصل مختارة.
FE config — default-accounts.config.ts: 8 أقسام × المفاتيح الحقيقية + isAr + autoCodes.
FE تحميل + picker — جلب الـ leaves مرة، forkJoin على كل الموديولات (مع lis/production)، اختيار محفوظ←كود←فاضي + حارس الذمم.
FE عرض + حفظ + ترجمة — p-accordion (المعمل/التصنيع/HR مفتوحين)، إنجليزي-أولًا، حفظ بالمفاتيح الحقيقية، بناء + نشر على moonui.

📚 التوثيق الكامل في الـ Knowledge Base knowledge-base/topics/default-accounts/ — 14 ملف: INDEX.md (الجرد الكامل) + setup-extension-spec.md (هذا التفصيل) + topic لكل موديول/كومبوننت.

موافقتك على القرارات الأربعة (⑥) كفيلة إني أبدأ التنفيذ بالترتيب أعلاه — هبدأ بالمعمل/التصنيع/HR (أولوياتك).