منصوبے کے بارے میں

فری پاس ERP v4 کم کریڈٹ، بغیر جانچ کے نچ رینٹر کار بروکراج (brokerage) کاموں کے لیے ایک ERP ہے، جس نے v3 (وانلا SPA) کے ہاتھ سے بنے روٹر اور صفحات کی ٹکڑے ٹکڑے ہونے کو ختم کر کے jpkerp6 میں آزمودہ ایٹمک آرکيٹیکچر کو فری پاس ڈومین کے مطابق دوبارہ بنايا ہے۔ v3 لائیو (Vercel) پر بغیر رکاوٹ جاری رہے گا، اور v4 لوکل پہلا بنانے کے بعد مستحکم ہو کر ریموٹ/مائگریشن کی حکمت عملی اپنائے گا۔ چلانا npm install کے بعد npm run dev سے http://localhost:4004 پر دیکھا جا سکتا ہے۔ اگر Firebase سیٹ اپ نہ ہو تو lib/store.ts خود بخود LocalAdapter (localStorage) پر 폴بیک ہو کر فوری کام کرتا ہے، اور پہلی بار چلانے پر lib/seed.ts کے نمونے کے معاہدے داخل ہوتے ہیں۔ آرکيٹیکچر 5 درجہ کی ایٹمک ہے جس سے صفحات پر JSX یا حساب کی منطق براہ راست نہیں لکھی جاتی۔ ① انٹیٹی SSOT (lib/intake/entities.ts) ENTITIES کو ایک ہی جگہ سے براہ راست داخل، ایکسل، OCR 3 طریقے کے فارم ایک ساتھ بناتا ہے جس میں ocrFrom/manual/idFrom شامل ہیں۔ ② محفوظ کرنے کا ایٹم (lib/store.ts) واحد StoreAdapter (Local/Firestore/Dispatch) سے قدرتی کلید dedup، سافٹ ڈیلیٹ، کمپنی علیحدگی (companyId) کو سنبھالتا ہے۔ ③ UI ایٹم (components/ui/index.tsx) ObjCard (فہرست کا واحد ایٹم 56px)، Sec، Cards، Metric، Badge، DataTable (موبائل = کارڈ)، Modal، FormGrid فراہم کرتا ہے۔ ④ سیکشن (کاکپٹ، app/page.tsx) حالت کے سوالات کی بنیاد پر درجہ بندی کر کے جانچ انتظار، بھیجنے کا انتظار، چلتی ہوئی، واپسی حصے، قرضے کو سنبھالتا ہے۔ ⑤ ڈومین انجن (lib/domain/*) خالص فنکشن سے marginFee (سپلائر فیس - سیلز فیس) اور clawbackWatch (بغیر ضمانت 3، 6 ماہ واپسی) کا حساب لگاتا ہے۔ jpkerp (مستقیم) سے الگ محور پر، گاڑیوں کی خرید/قدر کمی/فروخت کے بجائے سپلائر، سپلائر قیمت، مارجن پر توجہ ہے اور معاہدے وصول کے بجائے مصنوعات کی قسم، جانچ، سیلز پرسون، کمیشن، واپسی پر مرکوز ہیں۔ partner (سیلز پرسون) اور supplier (سپلائر) مستقیماً میں نہ ہونے والے 2-sided انٹیٹی ہیں۔ ڈیزائن کے اصولی قواعد: ایٹم اور کارڈ سے ہی بناو (نیا فہرست/تفصیل ObjCard+Sec دوبارہ استعمال، ہاتھ کے کارڈ/ان لائن ممنوع)، ویب، موبائل یکساں (ایٹم useIsMobile سے ریسپانسیو اندر، ایک طرفہ مخصوص صریح اتفاق پر)، خرابی کی ساخت سے روک (راؤٹ فائل named export ممنوع، dev/build علیحدگی، سٹرنگ تاریخ موازنہ سے پرہیز، خاموش ترنشنیشن پر باقی دکھانا)۔ موجودہ ڈھانچہ، انفراسٹرکچر، انٹیٹی SSOT، ہوم کاکپٹ (معاہدے کا ٹکڑا) مکمل ہیں، معاہدے کی تفصیل (Drawer)، جانچ/بھیجنے/دستخط ایکشن، کمیشن تسویه، واپسی ٹریکنگ، گاڑی (موجودہ)، سیلز پرسون، سپلائر ٹکڑے، OCR intake (معاہدہ، لائسنس، رجسٹری کارڈ)، ایکسل امپورٹ، v3→v4 مائگریشن اڈاپٹر، فری پاس مخصوص Firebase ربط (ریموٹ) ادھورے ہیں۔ تمام AI/کام کرنے والے AGENTS.md کے کردار تقسیم (Claude=ڈیزائن، گیٹ / Cursor=مزدوری / Codex=پوری جانچ) اور ناقابل تغیر قواعد، گیٹس کو کام شروع کرنے سے پہلے ضرور چیک کریں۔