freepasserp4

Free Pass ERP v4は、低信用・審査なしニッチレンタカー仲介(brokerage)業務向けERPであり、v3(バニラSPA)の手動ルーターとページ断片化を撤去し、jpkerp6で検証済みのアトミックアーキテクチャをFree Passドメイン向けに再構築したバージョンである。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の3方式フォームを同時に生成し、ocrFrom/manual/idFromを含む。②ストレージアトム(lib/store.ts)は単一のStoreAdapter(Local/Firestore/Dispatch)で自然キーdedup、soft-delete、会社分離(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を再利用、手動カード/インライン禁止)、Web・モバイル統一(アトムがuseIsMobileでレスポンシブ内蔵、片側専用は明示合意時のみ)、エラーの構造的防止(ルートファイルのnamed export禁止、dev/build分離、文字列日付比較の回避、silent truncation時の残量表示)を設ける。 現在、骨格・インフラ・エンティティSSOT・ホームコックピット(契約スライス)は完了し、契約詳細(Drawer)・審査/発送/署名アクション・コミッション精算・回収トラッキング、車両(物件)・営業・供給社スライス、OCR intake(契約書・免許・登録証)・Excelインポート、v3→v4マイグレーションアダプター、Free Pass専用Firebase接続(リモート)は未完了状態である。すべてのAI・作業者は作業開始前にAGENTS.mdの役割分担(Claude=設計・ゲート / Cursor=作業 / Codex=全数検証)と不変ルール・ゲートを確認しなければならない。