🛡️ SignalGabon

Plateforme officielle de signalement de la corruption au Gabon
Commission Nationale de Lutte Contre la Corruption et les Infractions Économiques (CNLCEI)

---

Architecture

signal-gabon/
├── backend/          → API REST Laravel 11 + SQLite + Sanctum
├── citizen-app/      → Application citoyenne React (mobile-first + desktop)
├── admin-app/        → Interface agents CNLCEI React (desktop)
└── README.md

---

Prérequis

• PHP >= 8.2 + Composer
• Node.js >= 18 + npm
• Git

---

Installation

1. Backend Laravel

cd backend
cp .env.example .env          # Configurer DB_DATABASE avec le chemin absolu vers database.sqlite
touch database/database.sqlite
composer install
php artisan key:generate
php artisan migrate --seed
php artisan serve              # http://localhost:8000

2. Application citoyenne

cd citizen-app
npm install
npm run dev                   # http://localhost:5173

3. Interface admin

cd admin-app
npm install
npm run dev                   # http://localhost:5174

---

Comptes de démonstration

Rôle	Email	Mot de passe
Superviseur	[email protected]	Admin1234!
Agent	[email protected]	Agent1234!
Agent	[email protected]	Agent1234!
Agent	[email protected]	Agent1234!
Agent	[email protected]	Agent1234!
Agent	[email protected]	Agent1234!

---

Endpoints API principaux

Public (sans authentification)

Méthode	Endpoint	Description
POST	/api/signalements	Soumettre un signalement
GET	/api/signalements/{code}/statut	Consulter le statut d'un dossier
POST	/api/signalements/{code}/preuves	Ajouter des preuves
GET	/api/stats/publiques	Statistiques publiques

Auth

Méthode	Endpoint	Description
POST	/api/auth/login	Connexion agent
POST	/api/auth/logout	Déconnexion
GET	/api/auth/me	Profil agent connecté

Admin (auth:sanctum requis)

Méthode	Endpoint	Description
GET	/api/admin/signalements	Liste paginée (filtres: statut, province, agent_id)
GET	/api/admin/signalements/{id}	Détail d'un signalement
PATCH	/api/admin/signalements/{id}	Modifier statut / agent / message
GET	/api/admin/stats	Statistiques complètes
GET	/api/admin/agents	Liste agents actifs

---

Fonctionnalités

Application citoyenne

• Formulaire de signalement anonyme en 4 étapes
• Upload de preuves (images, PDF, audio)
• Suivi de dossier par code unique (SG-XXXX-XXXX)
• Timeline visuelle des statuts
• Statistiques publiques
• Interface mobile-first + desktop responsive

Interface admin (CNLCEI)

• Tableau de bord avec KPIs et graphiques (Recharts)
• Gestion des signalements avec filtres
• Attribution des dossiers aux agents
• Messagerie citoyenne (visible publiquement)
• Statistiques avancées par agent (superviseur)
• Authentification sécurisée (Sanctum, token 8h)

---

Statuts des dossiers

Statut	Description
recu	Signalement reçu, en attente d'examen
en_examen	En cours d'examen par la CNLCEI
attribue	Attribué à un agent
en_instruction	En cours d'instruction
traite	Traité, mesures prises
classe	Classé sans suite

---

Hébergement au Gabon

Les données de signalement ne doivent pas quitter le territoire : voir docs/hebergement-cahier-des-charges.md (document à remettre à l'hébergeur) et docs/exploitation.md (installation et administration pas à pas).

Le nécessaire de déploiement est dans deploy/ : pile Docker (nginx + php-fpm + MariaDB + certbot), sauvegarde chiffrée et restauration. Dans cette configuration, l'API, la base et les preuves sont sur le serveur gabonais ; seules les pages React restent sur Vercel.

Comptes de démonstration et production. Les comptes listés plus haut sont créés par php artisan db:seed, réservé au développement. Sur un serveur de production, le premier compte se crée avec php artisan cnlcei:creer-superviseur, qui demande un mot de passe fort.

---

Déploiement (Vercel)

Le dépôt se déploie en un seul projet Vercel pointant sur la racine. Le build (npm run build → scripts/build-site.mjs) assemble un site unifié :

URL	Contenu
/	Page d'accueil : choix entre l'espace citoyen et l'espace agent
/citoyen/	Application citoyenne (citizen-app)
/admin/	Interface agents CNLCEI (admin-app)

Réglages du projet Vercel :

• Root Directory : la racine du dépôt (laisser vide)
• Framework Preset : Other — tout est déjà décrit dans vercel.json
• Variables d'environnement : VITE_API_URL=https://<api>/api (sans elle, les deux apps appellent http://localhost:8000/api)

Le backend Laravel se déploie séparément (voir backend/render.yaml, backend/railway.json ou backend/vercel.json).

Comment ça marche

Chaque app est construite avec la variable APP_BASE (/citoyen/, /admin/), reprise par Vite (base) et par React Router (basename={import.meta.env.BASE_URL}). Les réécritures SPA de vercel.json renvoient toute URL d'un sous-chemin vers l'index.html de l'app correspondante — sans elles, un rechargement sur /citoyen/suivi renverrait un 404.

Chaque app garde son propre vercel.json : elle peut toujours être déployée seule (Root Directory = citizen-app ou admin-app), et elle est alors servie à la racine de son domaine.

Build en local

npm run build      # depuis la racine
npx serve dist     # ou tout serveur statique

Points de contrôle en cas de 404

1. Le Root Directory du projet Vercel est bien la racine du dépôt.
2. Le dernier déploiement est marqué Ready (et non Error) et promu en production.
3. VITE_API_URL est défini sur le projet.

---

Licence

MIT — République Gabonaise / CNLCEI — 2024