portail-associations/README.md

174 lines
4.7 KiB
Markdown

# Portail Associations des Savanes 973
Plateforme numerique territoriale dediee aux associations des Savanes de Guyane.
## 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
- `deployments/` : publication preprod / prod
- `local-services/` : services locaux d'appui, dont Forgejo
- `scripts/` : automatisations de maintenance, exploitation et support
### Convergence CCDS
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/`
## Installation locale
### 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