diff --git a/README.md b/README.md index b401642..8aa682d 100644 --- a/README.md +++ b/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 diff --git a/docs/compliance/RGAA-001-roadmap-portail.md b/docs/compliance/RGAA-001-roadmap-portail.md new file mode 100644 index 0000000..55bbf36 --- /dev/null +++ b/docs/compliance/RGAA-001-roadmap-portail.md @@ -0,0 +1,247 @@ +# RGAA - Audit initial et roadmap de mise en conformite + +## Contexte + +Ce document formalise une **premiere passe RGAA** sur le portail `portail-association973.com`, croisee avec le code local et la structure actuelle de l'application. + +Ce n'est **pas** une certification RGAA complete ni un audit legal exhaustif. +En revanche, c'est une base serieuse pour prioriser les corrections les plus utiles et structurer la trajectoire d'accessibilite. + +Date de reference : **15 aout 2026** + +## Perimetre observe + +- page d'accueil publique ; +- structure applicative React / Vite ; +- dashboard association ; +- composants de navigation laterale ; +- composants de formulaire et de dialogue ; +- theme et comportements visuels generaux. + +## Lecture generale + +Le portail dispose deja d'un socle utile : + +- `lang="fr"` defini dans [client/index.html](/Users/selecta/Documents/portail-associations/client/index.html) +- composants UI avec nombreuses gestions `focus-visible` +- labels caches (`sr-only`) presents sur plusieurs composants +- structure de boutons et controles deja assez riche +- plusieurs zones admin et dashboard deja pensees en navigation clavier + +Mais il reste plusieurs chantiers importants pour atteindre un niveau RGAA plus solide et plus defendable. + +## Constats principaux + +### 1. Absence apparente de lien d'evitement + +Je n'ai pas trouve de lien de type : + +- `Aller au contenu` +- `Aller a la navigation` + +Ce point est prioritaire pour l'accessibilite clavier et lecteur d'ecran. + +Zones concernees : + +- [client/src/App.tsx](/Users/selecta/Documents/portail-associations/client/src/App.tsx) +- [client/src/pages/Home.tsx](/Users/selecta/Documents/portail-associations/client/src/pages/Home.tsx) +- [client/src/pages/Dashboard.tsx](/Users/selecta/Documents/portail-associations/client/src/pages/Dashboard.tsx) + +### 2. Landmarks et structure semantique encore incomplets + +Le socle React route bien les pages, mais il reste a verifier et renforcer : + +- presence systematique de `
` +- structure des `
`, `