# SIGPRO — Système intégré de gestion des projets (DFE Djibouti)

Plateforme nationale de pilotage des projets de développement : une identité projet unique, trois modules
(Suivi-évaluation, Passation des marchés, Administration/RH/Finances), un circuit de validation et une
consolidation nationale pour la Direction du Financement Extérieur.

Version 0.1 — socle fonctionnel issu du cahier des charges v2.0 (novembre 2026). **Toutes les données chargées
par défaut sont fictives.**

## Démarrer

```powershell
npm install
npm run dev          # http://localhost:3000
```

Sans configuration, l'application utilise un PostgreSQL embarqué (PGlite) stocké dans `data/`.
La page de connexion liste les comptes de démonstration (un clic préremplit le formulaire). Leur mot de passe
commun est défini dans `server/seed.js` (`DEMO_PASSWORD`, surchargeable par `SGP_DEMO_PASSWORD`).

| Commande | Effet |
|---|---|
| `npm run dev` | Serveur de développement (API + interface) |
| `npm run build` puis `npm start` | Version de production (sert `dist/`) |
| `npm run test:recette` | Joue les scénarios de recette du §24 sur l'API (serveur démarré, base de démo) |
| `npm run reset` | Efface la base locale et les fichiers déposés |

## Variables d'environnement

À renseigner dans un fichier `.env` à la racine (modèle : `.env.example`), lu automatiquement au démarrage.
`npm run test:mail -- destinataire@exemple.com` vérifie la connexion SMTP et envoie un email de test.

| Variable | Rôle |
|---|---|
| `DATABASE_URL` | Chaîne PostgreSQL. Si définie, remplace la base embarquée. |
| `JWT_SECRET` | Secret de session (sinon généré dans `data/.jwt-secret`). |
| `SGP_DEMO=0` | Ne charge pas les données de démonstration et masque les comptes de démo. **À mettre en production.** |
| `SGP_HTTPS=1` | Cookie de session marqué `Secure` (derrière HTTPS). |
| `PORT` | Port d'écoute (3000 par défaut). |
| `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS` | Serveur d'envoi des emails (port 587 par défaut ; `SMTP_SECURE=1` pour forcer TLS implicite). **Sans `SMTP_HOST`, aucun email n'est envoyé** : chaque message est seulement signalé dans la console. |
| `MAIL_NOTIFICATION` | Expéditeur des notifications du circuit de validation (`notification@sigprodj.com` par défaut). |
| `MAIL_NO_REPLY` | Expéditeur des messages de compte (`do-not-reply@sigprodj.com` par défaut). |
| `MAIL_CONTACT` | Adresse de contact affichée sur la page de connexion et dans les emails (`contact@sigprodj.com` par défaut). |
| `APP_URL` | Adresse publique de la plateforme, utilisée dans les liens des emails. |

### Emails envoyés

- Soumission d'une donnée → Coordonnateur(s) de l'UGP du projet.
- Validation ou retour pour correction → auteur de la donnée, avec l'observation.
- Création de compte et réinitialisation de mot de passe → l'utilisateur concerné. Le mot de passe provisoire n'est
  jamais envoyé par email : il reste affiché à la DFE, qui le remet séparément.
- Les comptes de démonstration (`@demo.sgp.dj`) ne reçoivent aucun email.

## Architecture

- `server/entities.js` — dictionnaire des données : chaque entité métier appartient à **un** module ; c'est ce
  rattachement qui porte le cloisonnement.
- `server/core.js` — session, habilitations, journal d'audit. `server/routes.js` — API REST.
- `server/stats.js` — agrégations et alertes ; seules les lignes `official = true` (validées) comptent.
- `src/` — interface React (Vite, Tailwind, Recharts).

### Règles appliquées côté serveur

- Matrice d'accès du §21.2 vérifiée dans chaque route (données, exports, listes de référence, documents,
  téléchargements) ; tout refus renvoie 403 et est journalisé.
- États : Brouillon → En attente de validation → Validé / À corriger. Une donnée soumise n'est plus modifiable
  par son auteur ; le retour pour correction exige une observation.
- Corriger une donnée validée ouvre une **révision** : la valeur validée reste la valeur officielle jusqu'à la
  nouvelle validation, qui crée la version suivante (historique conservé).
- Code projet unique et immuable ; tutelle, montant et durée modifiables par la DFE avec justification historisée.
- Un lien entre modules (marché ↔ activité, dépense ↔ marché) ne peut être posé que par un profil habilité aux
  deux modules (Coordonnateur, DFE).

## Limites connues de cette version

- Carte : tracé **schématique non vérifié** (`server/geo/regions.geo.json`). À remplacer par le référentiel SIG officiel.
- Pas encore : authentification multifacteur, récupération de mot de passe par email, antivirus sur les dépôts,
  import CSV/Excel de migration, profil « ministère », consultation publique, multi-devises avec taux de change,
  génération de rapports PDF, PostGIS.
- Les habilitations s'appliquent par UGP (tous les projets de l'UGP), pas encore projet par projet.
- Les ventilations régionales comptent un projet multirégional dans chacune de ses régions.
