প্রকল্প সম্পর্কে

প্রিপাস ERP v4 হলো কম-ক্রেডিট, নো-স্ক্রিনিং নিচ রেন্টাল ব্রোকারেজ কাজের জন্য একটি 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 তিনটি ফর্ম তৈরি করে, যাতে ocrFrom/manual/idFrom অন্তর্ভুক্ত। ② স্টোর অ্যাটম (lib/store.ts) একক StoreAdapter (Local/Firestore/Dispatch) দিয়ে ন্যাচারাল-কি ডিডাপ, সফট-ডিলিট, কোম্পানি-আইসোলেশন (companyId) পরিচালনা করে। ③ UI অ্যাটম (components/ui/index.tsx) ObjCard (তালিকার একক অ্যাটম 56px), Sec, Cards, Metric, Badge, DataTable (মোবাইলে কার্ড), Modal, FormGrid প্রদান করে। ④ সেকশন (ককপিট, app/page.tsx) স্টেটের প্রশ্ন অনুযায়ী শ্রেণিবদ্ধ করে: অনুমোদন-অপেক্ষা, পাঠানো-অপেক্ষা, চলমান, ফেরত-সেগমেন্ট, ঋণ। ⑤ ডোমেইন ইঞ্জিন (lib/domain/*) বিশুদ্ধ ফাংশন দিয়ে marginFee (সাপ্লায়ার কমিশন − অপারেটর কমিশন) এবং clawbackWatch (নো-গ্যারান্টি ৩/৬ মাসের ফেরত) গণনা করে। jpkerp (সরাসরি) থেকে ভিন্ন অক্ষে, গাড়ি কেনা/অবচয়/বিক্রয় নয় বরং সাপ্লায়ার, সাপ্লাই-মূল্য, মার্জিন কেন্দ্রিক; চুক্তি প্রাপ্য-কেন্দ্রিক নয় বরং পণ্য-ধরন, অনুমোদন, অপারেটর, কমিশন, ফেরত কেন্দ্রিক। partner (অপারেটর) এবং supplier (সাপ্লায়ার) হলো সরাসরি ব্যবস্থায় না থাকা 2-পার্শ্বিক এন্টিটি। ডিজাইনের মূল নিয়ম: শুধু অ্যাটম ও কার্ড দিয়ে গঠন (নতুন তালিকা/বিস্তারিত ObjCard+Sec পুনঃব্যবহার, হ্যান্ড-রোল্ড কার্ড/ইনলাইন নিষিদ্ধ), ওয়েব-মোবাইল একীভূত (অ্যাটমে useIsMobile দিয়ে রেসপনসিভ অন্তর্নির্মিত, এক-পার্শ্বিক শুধু স্পষ্ট সম্মতিতে), ত্রুটি কাঠামোগত প্রতিরোধ (রাউট ফাইলে named export নিষিদ্ধ, dev/build বিচ্ছিন্ন, স্ট্রিং তারিখ তুলনা এড়ানো, নীরব ট্রাঙ্কেশনে অবশিষ্ট দেখানো)। বর্তমানে কঙ্কাল, ইনফ্রা, এন্টিটি SSOT, হোম ককপিট (চুক্তি স্লাইস) সম্পন্ন; চুক্তি বিস্তারিত (Drawer), অনুমোদন/পাঠানো/স্বাক্ষর অ্যাকশন, কমিশন হিসাব, ফেরত ট্র্যাকিং, গাড়ি (বিক্রয়)/অপারেটর/সাপ্লায়ার স্লাইস, OCR ইনটেক (চুক্তি/লাইসেন্স/রেজিস্ট্রেশন), এক্সেল ইমপোর্ট, v3→v4 মাইগ্রেশন অ্যাডাপ্টার, প্রিপাস-নির্দিষ্ট Firebase সংযোগ (রিমোট) অসম্পূর্ণ। সব AI ও কর্মীকে কাজ শুরুর আগে AGENTS.md-এর ভূমিকা বিভাজন (Claude=ডিজাইন/গেট / Cursor=শ্রম / Codex=সম্পূর্ণ যাচাই) এবং অপরিবর্তনীয় নিয়ম-গেট পরীক্ষা করতে হবে।