# PROJECT_MAP.md — IPSM Escargot PWA Model V1

[TECH_STACK]
- HTML5/CSS3/JavaScript natif.
- PWA: manifest.json + sw.js.
- Aucun CDN, aucune API externe, aucun export PDF automatique.
- Rapport: fiche projet HTML imprimable via action volontaire utilisateur.
- Stockage: localStorage pour scénarios et hypothèses.
- Date d'exécution système: 2026-05-18 12:03.

[SYSTEM_FLOW]
1. L'utilisateur ouvre IPSM Escargot sur smartphone ou PC.
2. Il édite son profil et son scénario.
3. Il renseigne les paramètres de production et économiques.
4. Le dashboard supérieur calcule production, coût/kg, marge/kg et score.
5. Il peut ouvrir le module infrastructure avancé, masqué par défaut.
6. Il consulte/édite les formules par phase avec ingrédients visibles.
7. Il ouvre les contraintes nutritionnelles seulement à la demande.
8. Il consulte le guide utilisateur ou la bibliothèque technique.
9. Il génère une fiche projet prévisionnelle imprimable.
10. Il sauvegarde le scénario localement.

[ARCHITECTURE]
- IPSM_Escargot_PWA_V1.html : application autonome.
- manifest.json : configuration PWA.
- sw.js : cache local minimal.
- inoiatech_logo_embedded.svg : logo vectoriel local.
- Composants internes:
  - i18n FR/AR/EN.
  - dashboard KPI.
  - module simulation.
  - module formulation par ingrédients.
  - module infrastructure avancé.
  - module apprentissage.
  - module fiche projet.
  - stockage local scénario.

[DATA_MODEL]
- profile: scénario, porteur, pays, région, profil, objectif, expérience, budget.
- production: surface, parcs, densité, survie, poids, cycle, TCA.
- economy: prix naissain, prix vente, autres charges, main-d'œuvre, eau/énergie, pertes aliment.
- recipes: phases naissain, croissance, engraissement, reproduction.
- infrastructure: équipements, coûts indicatifs, subvention, amortissement, location.
- report: synthèse calculée à partir du scénario courant.

[I18N]
- Langues: français, arabe, anglais.
- Support RTL: arabe.
- Traductions intégrées localement.

[REPORT_MODEL]
- Fiche projet prévisionnelle.
- Résumé exécutif.
- Profil utilisateur.
- Hypothèses techniques et économiques.
- Formulation par phase.
- Infrastructure si activée.
- Risques et conditions de réussite.
- Signature officielle.

[VERIFIABLE_GOALS]
- VG1: Dashboard en haut avec marge/kg.
- VG2: Formulation affiche ingrédients, prix, kg/tonne, coût, rôle, disponibilité.
- VG3: Contraintes nutritionnelles masquées par défaut.
- VG4: Infrastructure masquée par défaut et éditable.
- VG5: Scénario sauvegarde profil + production + formule + infrastructure.
- VG6: Fiche projet inclut infrastructure seulement si activée.
- VG7: Aucun CDN et aucun doc.save.
- VG8: PWA installable et utilisable localement après cache.
- VG9: FR/AR/EN + RTL arabe.
- VG10: Bibliothèque technique étoffée.

[ORPHANS & PENDING]
- Les coûts Algérie restent indicatifs et doivent être validés par référentiel terrain Inoiatech.
- Les formules alimentaires sont des hypothèses de départ et doivent être adaptées aux espèces/régions.
- Les versions AR/EN de la bibliothèque sont solides mais pourront être enrichies au même niveau que la version FR.