App pour ma gang
| ansible | ||
| backend | ||
| data/import | ||
| deploy | ||
| docs | ||
| frontend | ||
| scripts | ||
| .gitignore | ||
| AGENTS.md | ||
| ansible.cfg | ||
| 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
cd frontend
npm install
npm run build
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:
ansible-playbook ansible/site.yml
ansible-playbook ansible/verify.yml
Documentation
Le point d'entrée documentaire est docs/00_INDEX.md.
Documents principaux:
- Manuel utilisateur
- Processus applicatifs
- Règles métier
- Architecture technique
- Modèle de données
- API applicative
- Déploiement Ansible
- Runbook
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.