Sujet 5 - AgriConseil - EPF Africa M1 GL
# AgriConseil — Sujet 5 (EPF Africa, M1 GL)
Projet intégrateur full-stack : Java / Spring Boot • Angular • Spring AI (Ollama).
Conseils et alertes aux producteurs agricoles.
## Contenu de l'archive
```
AgriConseil_Cahier_des_charges.docx Séance 1 : cahier des charges, UML, découpage, planning
AgriConseil_Contrat_API.xlsx Séance 1 : contrat d'API détaillé (figé)
backend/ Séance 2-5 : API Spring Boot (Clean Architecture)
frontend/ Séance 2-5 : SPA Angular 20 (standalone components)
```
## Ordre de démarrage recommandé
### 1. Backend
```bash
cd backend
mvn spring-boot:run -Dspring-boot.run.profiles=dev # H2 en mémoire, démarrage immédiat
```
Voir `backend/README.md` pour le profil MySQL (docker-compose), les comptes de test,
et la configuration d'Ollama pour l'assistant.
### 2. Frontend
```bash
cd frontend
npm install
npm start
```
Application sur `
localhost`.
## Ce qui est livré, par séance
| Séance | Contenu | Où le trouver |
|---|---|---|
| S1 | Cahier des charges, UML, contrat d'API | `AgriConseil_Cahier_des_charges.docx`, `AgriConseil_Contrat_API.xlsx` |
| S2 | Starter kit Clean Architecture + auth JWT bout en bout | `backend/.../infrastructure/security/`, `frontend/.../core/` |
| S3 | Module 1 — Fiches conseils | `backend/.../FicheController` + service, `frontend/.../features/fiches/` |
| S4 | Module 2 — Alertes ciblées | `backend/.../AlerteController` + service + `EmailService`, `frontend/.../features/alertes/` |
| S5 | Module 3 — Assistant Ollama + dashboard | `backend/.../AssistantController`/`StatsController`, `frontend/.../features/assistant/`, `features/dashboard/` |
## ⚠️ Important — build & vérification
Ce code a été généré et vérifié pour sa **cohérence structurelle** (arborescence Clean
Architecture, contrat d'API respecté, accolades/imports croisés) dans un environnement
sandbox sans accès à Maven Central ni au registre npm complet. **Il n'a donc pas pu être …