# 🌾 Infographie Fonctionnelle & Architecture — Kit CAPBE-AGRO

> **Système Intégré de Pilotage Agronomique, d'Aide à la Décision Prédictive et de Gestion Parcellaire PostGIS**  
> *Portail : `https://agro.capbe.ovh` · API : Port `8001` (`agro-api` sur `capbe-pgis`) · Base : `agro_api` (PostgreSQL 18 + PostGIS 3)*

---

## 🖼️ Infographie Officielle Haute Définition

![Infographie Fonctionnelle CAPBE-AGRO](../jpg/infographie_capbe_agro.jpg)

---

## 📊 Chiffres Clés & Métriques d'Impact

| Métrique | Valeur | Description & Impact Opérationnel |
|:---|:---:|:---|
| **Précision Parcellaire** | **Submétrique** | Cartographie polygonale PostGIS sans chevauchement, réconciliant surfaces déclarées et mesurées |
| **Modules Spécialisés** | **6 Modules** | Simulateur, Dossier bancaire, Registre parcellaire, Calendrier cultural, Semences, Intrants |
| **Interactions Écosystème** | **9 Kits & ERP** | Synchronisation temps réel avec GEOM, MECA, IRRG, STOK, VENT, CIRC, NOTI, ACCES et ERPNext |
| **Anticipation Financière** | **12 à 36 Mois** | Échéancier de trésorerie mensuel et plan d'amortissement certifié pour les banques agricoles |
| **Traçabilité & Audit** | **SHA-256** | Journal d'audit append-only chaîné cryptographiquement sur toutes les écritures |
| **Sécurité Multi-Tenant** | **RBAC 3 Niveaux** | Isolation stricte par groupe, contrôle au niveau de l'écran et du champ piloté par ACCES |

---

## 🧩 Les 6 Modules Fonctionnels de CAPBE-AGRO

Chaque module répond à un besoin métier précis de l'exploitant agricole, sans redondance d'information :

### 1. 🎯 Simulateur Décisionnel & Orientation Agro-Climatique
* **Rôle** : Modélisation prédictive de la faisabilité technico-économique avant tout engagement financier.
* **Fonctionnalités** :
  - Croisement des coordonnées GPS, des historiques météorologiques locaux, du profil pédologique et de la disponibilité en eau.
  - Scoring d'adéquation variétale (maïs, manioc, igname, banane, maraîchage, palmier à huile, etc.).
  - Simulation des rendements prévisionnels et identification précoce des contraintes agro-écologiques.

### 2. 📑 Dossier de Financement & Trésorerie Prévisionnelle
* **Rôle** : Structuration bancaire et sécurisation du modèle économique de l'exploitation.
* **Fonctionnalités** :
  - Établissement automatique du compte d'exploitation prévisionnel à l'hectare et par campagne.
  - Échéancier mensuel des flux de trésorerie (achats d'intrants, carburant, main-d'œuvre, encaissements récoltes).
  - Génération de dossiers de financement conformes aux exigences des banques et bailleurs (FIRCA, PRODAC, banques agricoles).

### 3. 🗺️ Registre Parcellaire & Surfaces (Réconciliation PostGIS)
* **Rôle** : Cadastre agricole numérique et délimitation spatiale incontestable.
* **Fonctionnalités** :
  - Géométrie spatiale stricte par polygone GPS stocké dans PostGIS, garantissant l'absence totale de chevauchement.
  - Gestion unifiée de la surface déclarée par le producteur et de la surface mesurée au centimètre par RTK via CAPBE-GEOM.
  - Organisation hiérarchique en blocs culturaux et parcelles d'exploitation avec historique cadastral.

### 4. 📅 Calendrier Cultural & Jalons Phénologiques
* **Rôle** : Planification temporelle et synchronisation des chantiers avec les cycles naturels.
* **Fonctionnalités** :
  - Découpage de la campagne en stades phénologiques : labour, semis, sarclages, fertilisations, floraison et récolte.
  - Alignement sur les régimes pluviométriques et les fenêtres climatiques optimales.
  - Détection proactive des retards de chantier et reprogrammation assistée.

### 5. 🌱 Fiches Agronomiques & Catalogue de Semences Certifiées
* **Rôle** : Référentiel technique et normalisation des itinéraires culturaux (ITK).
* **Fonctionnalités** :
  - Répertoire des fournisseurs agréés et semences certifiées adaptées aux agro-écosystèmes tropicaux.
  - Fiches biométriques complètes : fourchettes de rendement (t/ha), doses de semis (kg/ha), densités de peuplement (plants/ha) et écartements recommandés.
  - Fiches techniques de culture guidant l'exploitant à chaque étape du cycle végétal.

### 6. 🧪 Gestion des Intrants & Besoins par Parcelle
* **Rôle** : Traçabilité chimique, optimisation nutritionnelle et pilotage des épandages.
* **Fonctionnalités** :
  - Calcul rigoureux des volumes d'engrais (NPK, urée, amendements calcaires) et phytosanitaires requis par parcelle.
  - Enregistrement des applications au champ (date, dose réelle, parcelle ciblée, applicateur qualifié).
  - Émission de réservations et de demandes de prélèvement directes auprès des entrepôts de stockage.

---

## 🔄 Interactions avec l'Écosystème CAPBE

Le schéma suivant formalise les flux de données et de travail sans aucune répétition de message :

```mermaid
flowchart TB
    subgraph COEUR["🌾 CAPBE-AGRO — Cœur Agronomique"]
        SIMU["1. Simulateur Décisionnel"]
        FINANCE["2. Dossier de Financement"]
        PARCELLES["3. Registre Parcellaire"]
        CALENDRIER["4. Calendrier Cultural"]
        SEMENCES["5. Fiches Agronomiques"]
        INTRANTS["6. Gestion des Intrants"]
    end

    subgraph TERRAIN["🚜 Terrain, Espace & Équipements"]
        GEOM["🌐 CAPBE-GEOM<br/>Mesures RTK, surfaces certifiées & Sentinel-2"]
        MECA["🚜 CAPBE-MECA<br/>Exécution mécanisée & traces GPS de travail"]
        IRRG["💧 CAPBE-IRRG<br/>Bilan hydrique FAO-56 & tensiométrie"]
    end

    subgraph FLUX["📦 Logistique, Vente & Économie Circulaire"]
        STOK["🏢 CAPBE-STOK<br/>Réservation engrais & pesée des récoltes"]
        VENT["🛒 CAPBE-VENT<br/>Boutique, caisse POS & commercialisation"]
        CIRC["♻️ CAPBE-CIRC<br/>Recyclage des pailles & compostage bio"]
    end

    subgraph SOCLE["🛡️ Gouvernance, Pilotage & Communication"]
        ACCES["🛡️ CAPBE-ACCES<br/>SSO central, matrice RBAC & audit SHA-256"]
        NOTI["📢 CAPBE-NOTI<br/>Alertes WhatsApp, SMS & e-mails parcelles"]
        ERP["💼 ERPNext Frappe<br/>CRM Clients, factures OHADA & comptabilité"]
    end

    %% Relations directes et univoques
    GEOM -->|Surfaces mesurées & NDVI| PARCELLES
    PARCELLES -->|Commandes de chantiers| MECA
    CALENDRIER -->|Consignes d'arrosage| IRRG
    INTRANTS -->|Besoins & réservations| STOK
    CALENDRIER -->|Mise à disposition récoltes| VENT
    PARCELLES -->|Résidus végétaux à valoriser| CIRC

    %% Services transversaux
    ACCES -->|Session SSO & jeton sécurisé| COEUR
    COEUR -->|Événements & alertes critiques| NOTI
    FINANCE -->|Clients & prévisions financières| ERP
```

---

## 📑 Répertoire et Fichiers Associés

* **Infographie Haute Définition** : [`infographie_capbe_agro.jpg`](../jpg/infographie_capbe_agro.jpg)
* **Fiche Interactive Web & Visualiseur** : [`index.html`](../html/index-agro.html)
* **Spécifications Techniques** : [`README.md`](./README-agro.md)