عن المشروع

يعد فريباس ERP v4 نظام ERP مخصصًا لأعمال وساطة (brokerage) تأجير السيارات المتخصصة لذوي الائتمان المنخفض وبدون فحص. أزيلت منه في v3 (Vanilla SPA) مشكلة الموجّه المكتوب يدويًا وتجزئة الصفحات، وأعيد بناء البنية الذرية التي تم التحقق منها في jpkerp6 بما يناسب نطاق فريباس. تظل v3 تعمل دون انقطاع على البيئة الحية (Vercel)، بينما تُبنى v4 محليًا أولًا، ثم تُنقل/تُهاجر إلى البيئة البعيدة بعد الاستقرار. للتشغيل، بعد npm install نفّذ npm run dev وتحقق من النظام على http://localhost:4004. إذا لم تتم تهيئة Firebase، يتراجع lib/store.ts تلقائيًا إلى LocalAdapter(localStorage) ويعمل فورًا، وعند التشغيل الأول تُحقَن عقود نموذجية من lib/seed.ts. تتكون البنية من خمس طبقات ذرية، ولا تُكتب JSX أو منطق حسابات مباشرة داخل الصفحات. ① كيان المصدر الوحيد للحقيقة SSOT (lib/intake/entities.ts): يولّد ENTITIES واحد نماذج الإدخال المباشر وExcel وOCR الثلاثة معًا، ويشمل ocrFrom/manual/idFrom. ② ذرة التخزين (lib/store.ts): تعالج إزالة التكرار بالمفتاح الطبيعي، والحذف الناعم، وعزل الشركة (companyId) عبر StoreAdapter واحد (Local/Firestore/Dispatch). ③ ذرات واجهة المستخدم (components/ui/index.tsx): توفر ObjCard (ذرة مفردة للقائمة بارتفاع 56px)، وSec، وCards، وMetric، وBadge، وDataTable (الهاتف=بطاقات)، وModal، وFormGrid. ④ القسم (قمرة القيادة، app/page.tsx): يصنّف according للأسئلة التي تطرحها الحالة، ويتعامل مع انتظار الفحص، وانتظار الإرسال، وقيد التشغيل، وفترة الاسترداد، والذمم. ⑤ محرك النطاق (lib/domain/*): يحسب بدوال نقية marginFee (عمولة المورّد − عمولة مندوب المبيعات) وclawbackWatch (استرداد بدون ضمان بعد 3 و6 أشهر). بمحور مختلف عن jpkerp (التشغيل المباشر)، لا تركز السيارة على الشراء/الإهلاك/البيع، بل على المورّد وسعر التوريد والهامش. ولا يركز العقد على المبالغ غير المحصلة، بل على نوع المنتج، والفحص، ومندوب المبيعات، والعمولة، والاسترداد. يعد partner (مندوب المبيعات) وsupplier (المورّد) كيانين ثنائيي الجانب لا يوجدان في التشغيل المباشر. من القواعد التصميمية الثابتة: التكوين من الذرات والبطاقات فقط (إعادة استخدام ObjCard+Sec لأي قائمة/تفاصيل جديدة، ومنع البطاقات المكتوبة يدويًا أو التضمين العشوائي)، وتوحيد الويب والهاتف (الذرات تتضمن سلوكًا متجاوبًا مدمجًا عبر useIsMobile، ولا يُخصص أحد الجانبين إلا باتفاق صريح)، ومنع الأخطاء بنيويًا (منع named export في ملفات المسارات، وعزل dev/build، وتجنب مقارنة التواريخ النصية، وبيان الجزء المتبقي عند القطع الصامت silent truncation). حاليًا، اكتمل الهيكل الأساسي، والبنية التحتية، وSSOT للكيانات، وقمرة القيادة الرئيسية (شريحة العقود). ولم تكتمل بعد: تفاصيل العقد (Drawer)، وإجراءات الفحص/الإرسال/التوقيع، وتسوية العمولات، وتتبع الاسترداد، وشرائح السيارة (المعروضات) ومندوب المبيعات والمورّد، واستيعاب OCR (العقد/الرخصة/شهادة التسجيل)، واستيراد Excel، ومحول الهجرة من v3 إلى v4، واتصال Firebase المخصص لفريباس (عن بُعد). يجب على جميع وكلاء/عمال الذكاء الاصطناعي قبل بدء العمل مراجعة تقسيم الأدوار في AGENTS.md (Claude=التصميم والبوابة / Cursor=العمل اليدوي المضني / Codex=التحقق الشامل) والقواعد الثابتة والبوابات.