À propos du projet

L'ERP FreePass v4 est conçu pour le courtage de location de voitures de niche sans crédit ni examen. Il élimine le routage complexe et la fragmentation des pages de la v3 (Vanilla SPA) et reconstruit l'architecture atomisée validée dans jpkerp6 pour l'adapter au domaine FreePass. La v3 est maintenue en direct (Vercel), tandis que la v4 adopte une stratégie axée sur le local, avec une migration distante prévue après stabilisation. L'exécution se fait via npm install puis npm run dev sur http://localhost:4004. Si Firebase n'est pas configuré, lib/store.ts bascule automatiquement sur LocalAdapter (localStorage). Lors de la première exécution, des contrats d'exemple sont injectés via lib/seed.ts. L'architecture repose sur 5 couches atomisées : 1) Entités SSOT (lib/intake/entities.ts) pour générer des formulaires (saisie directe, Excel, OCR) ; 2) Atomes de stockage (lib/store.ts) gérant la déduplication, la suppression logique et l'isolation par entreprise ; 3) Atomes UI (components/ui/index.tsx) fournissant des composants réutilisables (ObjCard, DataTable, etc.) ; 4) Sections (Cockpit, app/page.tsx) classant les contrats par statut (attente d'examen, en cours, recouvrement, etc.) ; 5) Moteur de domaine (lib/domain/*) calculant les commissions et le suivi des remboursements (clawback). Contrairement à jpkerp (gestion directe), ce système se concentre sur les fournisseurs, les marges, les types de produits, les commissions et le recouvrement. Les entités 'partenaire' (commercial) et 'fournisseur' sont des entités bidirectionnelles spécifiques. Principes de conception : composition exclusive par atomes/cartes, interface unifiée web/mobile (via useIsMobile), et prévention structurelle des erreurs (interdiction des exportations nommées dans les fichiers de route, isolation dev/build, évitement des comparaisons de dates sous forme de chaînes). L'infrastructure, le SSOT des entités et le cockpit d'accueil sont terminés. Le développement se poursuit sur les détails des contrats (Drawer), les actions de signature, le règlement des commissions, le suivi des remboursements, l'intégration OCR/Excel, l'adaptateur de migration v3 vers v4 et la connexion Firebase. Tous les agents doivent se référer à AGENTS.md pour la répartition des rôles (Claude=conception, Cursor=implémentation, Codex=vérification) et les règles immuables.