Add premium project README and RGAA roadmap

README.md

@@ -1,34 +1,174 @@
-# Portail Associations CCDS
+# Portail Associations des Savanes 973
 
-Depot central du projet `portail-associations`, avec application, documentation, services locaux et references techniques.
+Plateforme numerique territoriale dediee aux associations des Savanes de Guyane.
 
-## Ce que ce depot contient
+## Vision
+
+Le **Portail Associations des Savanes 973** est une plateforme en ligne concue pour simplifier, centraliser et professionnaliser les demarches des associations du territoire.
+
+Il permet aux structures associatives de :
+
+- creer leur espace ;
+- deposer et mettre a jour leurs documents administratifs ;
+- suivre leurs demandes ;
+- solliciter des subventions ;
+- reserver des espaces de la **Maison de la Jeunesse des Savanes (MJS)** ;
+- interagir plus simplement avec l'administration.
+
+Le portail vise un objectif concret : proposer un outil plus lisible, plus fiable et plus adapte aux usages de terrain des associations, des agents et des administrateurs.
+
+## Fonctionnalites
+
+### Espace association
+
+- creation et gestion du compte association ;
+- fiche structure et informations administratives ;
+- depot documentaire ;
+- consultation de l'annuaire ;
+- suivi des demandes et des decisions.
+
+### Demarches metier
+
+- demandes de subventions ;
+- demande de reservation de salle ;
+- demande de materiel evenementiel ;
+- transmission de pieces justificatives ;
+- suivi du cycle de traitement.
+
+### Reservation d'espaces MJS
+
+Les associations peuvent reserver differents espaces de la Maison de la Jeunesse des Savanes selon leurs besoins de reunion, de formation ou d'evenement :
+
+- salles ;
+- bureau ;
+- dojo ;
+- parvis ;
+- autres espaces selon l'organisation metier retenue.
+
+### Administration et pilotage
+
+- gestion des associations ;
+- suivi des demandes ;
+- bordereau et referentiel ;
+- logistique et materiel ;
+- conformite, audit, apparence et supervision.
+
+### Cartographie
+
+- carte publique ;
+- carte metier admin ;
+- styles cartographiques auto-heberges ;
+- logique public / admin dense.
+
+## Architecture du projet
+
+Le depot centralise le coeur technique, documentaire et operationnel du portail.
+
+### Application
+
+- `client/` : interface web React / Vite
+- `server/` : API, logique metier, securite et generation documentaire
+- `shared/` : contrats, schemas et configuration partagee
+
+### Documentation et gouvernance
+
+- `docs/` : documentation produit, exploitation, conformite et trajectoires
+- `docs/compliance/` : RGPD, ISO 27001, sauvegardes, incidents, retention
+- `docs/ux/` : roadmaps UX, harmonisation et optimisation portail
+- `docs/forgejo/` : structuration Forgejo et fusion douce CCDS
+
+### Exploitation et services
 
-- `client/` : interface web
-- `server/` : API et logique serveur
-- `shared/` : contrats et configuration partages
-- `docs/` : documentation vivante du portail
 - `deployments/` : publication preprod / prod
 - `local-services/` : services locaux d'appui, dont Forgejo
+- `scripts/` : automatisations de maintenance, exploitation et support
 
-## Fusion douce CCDS
+### Convergence CCDS
 
-Les anciens depots CCDS sont progressivement integres ici pour garder :
-
-- un seul point d'entree principal
-- un historique preservé
-- une lecture plus simple pour l'equipe
-
-Ils sont reunis sous `convergence/` :
+Les anciens depots CCDS sont progressivement reintegres ici afin d'avoir une seule porte d'entree projet, sans perdre l'historique :
 
 - `convergence/ccds-docs/`
 - `convergence/ccds-infra/`
 - `convergence/ccds-cartographie/`
 
-Le but est de centraliser sans perdre la memoire des travaux deja menes.
+## Installation locale
 
-## References rapides
+### Pre-requis
+
+- Node.js
+- pnpm ou npm selon l'environnement courant
+- Docker Desktop pour les services annexes si necessaire
+- acces au depot et aux variables d'environnement locales
+
+### Demarrage applicatif
+
+Exemple de demarrage classique :
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Selon la configuration locale, l'application est generalement accessible sur :
+
+- [http://localhost:3001](http://localhost:3001)
+
+### Services complementaires
+
+Selon les besoins du chantier, on peut aussi utiliser :
+
+- Forgejo local pour la gouvernance projet ;
+- bases Docker locales ;
+- services cartographiques ou themes Forgejo ;
+- stacks preprod / prod cote VPS.
+
+## Forgejo et wiki CCDS
+
+Le projet est pense pour etre lisible dans Forgejo, avec :
+
+- un depot central principal : `ccds/portail-associations`
+- un wiki de reference pour la lecture transverse
+- une organisation CCDS clarifiee avec depots actifs et depots archives
+
+References rapides :
 
 - [Guide de fusion douce CCDS](./docs/forgejo/fusion-douce-ccds.md)
 - [Theme Forgejo CCDS](./local-services/forgejo/README.md)
+- [Roadmap RGAA du portail](./docs/compliance/RGAA-001-roadmap-portail.md)
 
+## Environnements
+
+Le projet vit sur plusieurs contextes :
+
+- local ;
+- preproduction ;
+- production.
+
+## Accessibilite, conformite et qualite
+
+Le portail fait l'objet d'un travail continu sur :
+
+- l'experience utilisateur ;
+- la lisibilite mobile et desktop ;
+- la conformite RGPD ;
+- la trajectoire ISO 27001 ;
+- l'accessibilite numerique (RGAA) ;
+- l'exploitation et la gouvernance.
+
+## Statut
+
+Projet en evolution active.
+
+Le produit est deja exploitable, mais continue d'etre ameliore sur :
+
+- l'ergonomie ;
+- la cartographie ;
+- l'accessibilite ;
+- l'exploitation ;
+- la documentation ;
+- la coherence visuelle et fonctionnelle.
+
+---
+
+**Portail Associations des Savanes 973**  
+Plateforme territoriale des demarches associatives