# 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