52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
# 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.
|
|
|