groupe-meditation/README.md

# Application de service pour groupes AA

Application PWA mobile-first pour soutenir la vie d'un ou plusieurs groupes AA: rencontres, assemblées, gouvernance, trésorerie, postes, membres, inventaires, rapports et historique.

## Démarrage rapide

```bash
cd frontend
npm install
npm run build
```

```bash
cd backend
python -m venv venv
venv/bin/pip install -r requirements.txt
venv/bin/uvicorn app.main:app --reload
```

La voie de déploiement supportée est Ansible:

```bash
ansible-playbook ansible/site.yml
ansible-playbook ansible/verify.yml
```

## Documentation

Le point d'entrée documentaire est [docs/00_INDEX.md](docs/00_INDEX.md).

Documents principaux:

- [Manuel utilisateur](docs/10_MANUEL_UTILISATEUR.md)
- [Processus applicatifs](docs/20_PROCESSUS.md)
- [Règles métier](docs/30_REGLES_METIER.md)
- [Architecture technique](docs/60_ARCHITECTURE.md)
- [Modèle de données](docs/50_MODELE_DONNEES.md)
- [API applicative](docs/70_API.md)
- [Déploiement Ansible](docs/91_DEPLOIEMENT_ANSIBLE.md)
- [Runbook](docs/90_EXPLOITATION.md)

## Stack

- Frontend: React, Vite, Tailwind, Zustand, PWA.
- Backend: FastAPI async, SQLAlchemy async, PostgreSQL.
- Rapports: WeasyPrint.
- Déploiement: systemd, NGINX, Ansible.

## Principe directeur

L'application est un outil de service. Elle garde la mémoire, facilite la continuité et rend les processus visibles, sans remplacer la conscience de groupe.