freepasserp4

PrePass ERP v4是面向低信用·免审查利基租车中介(brokerage)业务的ERP，移除了v3(vanilla SPA)的手写路由器和页面碎片化，将jpkerp6中验证过的原子化架构重建为适配PrePass领域的版本。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一个入口同时生成直接输入·Excel·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(无担保3·6个月回收)。 与jpkerp(直营)不同维度，车辆以供应商·供应价·利润为中心而非采购/折旧/出售，合同以商品类型·审核·营业员·佣金·回收为中心而非应收。partner(营业员)和supplier(供应商)是直营中没有的双边实体。 设计铁律包括：仅由原子·卡片构成(新列表/详情复用ObjCard+Sec，禁止手写卡片/内联)、网页·移动端统一(原子通过useIsMobile内置响应式，仅明确约定时允许单端专用)、错误结构性预防(禁止路由文件命名导出、dev/build隔离、避免字符串日期比较、静默截断时标注剩余)。 当前骨架·基础设施·实体SSOT·首页驾驶舱(合同切片)已完成，合同详情(Drawer)·审核/发送/签名操作·佣金结算·回收追踪、车辆(车源)·营业员·供应商切片、OCR intake(合同书·许可证·登记证)·Excel导入、v3→v4迁移适配器、PrePass专用Firebase连接(远程)均未完成。所有AI·工作人员在开始工作前必须查看AGENTS.md中的角色分工(Claude=设计·门禁 / Cursor=苦力 / Codex=全面验证)及不变规则·门禁。