67 lines
2.6 KiB
Markdown
67 lines
2.6 KiB
Markdown
# Documentation de l'application
|
|
|
|
Statut: documentation de référence
|
|
Public: membres, exécutifs, sysadmin, mainteneurs
|
|
Dernière révision: 2026-06-01
|
|
|
|
Cette documentation décrit ce que l'application permet de faire, comment elle est exploitée et quels invariants doivent rester vrais. Elle doit être tenue à jour avec le code: une fonctionnalité livrée sans documentation est considérée incomplète.
|
|
|
|
## Parcours de lecture
|
|
|
|
Pour comprendre l'application comme membre:
|
|
|
|
- [Manuel utilisateur](10_MANUEL_UTILISATEUR.md)
|
|
- [Processus applicatifs](20_PROCESSUS.md)
|
|
- [Liens de causalité](40_LIENS_CAUSALITE.md)
|
|
- [Garde-fous sociaux](94_GARDE_FOUS_SOCIAUX.md)
|
|
- [Présentation aux membres](95_PRESENTATION_MEMBRES.md)
|
|
|
|
Pour administrer ou exploiter l'application:
|
|
|
|
- [Administration et exploitation](90_EXPLOITATION.md)
|
|
- [Déploiement Ansible](91_DEPLOIEMENT_ANSIBLE.md)
|
|
- [Déploiement](92_DEPLOIEMENT.md)
|
|
- [Sécurité et confidentialité](80_SECURITE.md)
|
|
- [Multi-groupe](93_MULTI_GROUPE.md)
|
|
- [Plan de validation fonctionnelle](96_PLAN_VALIDATION.md)
|
|
- [Validation automatisée](97_VALIDATION_AUTOMATISEE.md)
|
|
|
|
Pour maintenir ou faire évoluer le code:
|
|
|
|
- [Architecture technique](60_ARCHITECTURE.md)
|
|
- [Modèle de données](50_MODELE_DONNEES.md)
|
|
- [API applicative](70_API.md)
|
|
- [Règles métier](30_REGLES_METIER.md)
|
|
- [Liens de causalité](40_LIENS_CAUSALITE.md)
|
|
- [Plan de validation fonctionnelle](96_PLAN_VALIDATION.md)
|
|
- [Validation automatisée](97_VALIDATION_AUTOMATISEE.md)
|
|
|
|
## Organisation fonctionnelle
|
|
|
|
L'application est une PWA mobile-first pour soutenir la vie d'un ou plusieurs groupes AA isolés les uns des autres.
|
|
|
|
Elle couvre:
|
|
|
|
- sélection du groupe, connexion, inscription et profil;
|
|
- rencontres hebdomadaires;
|
|
- assemblées d'affaires;
|
|
- gouvernance, propositions, décisions, nominations et contributions;
|
|
- trésorerie, dépenses, collectes, ventes, réserves et rapports;
|
|
- membres, postes, mandats, candidatures et permissions;
|
|
- littérature, jetons, événements et anniversaires;
|
|
- rapports PDF et mode papier;
|
|
- journalisation, historique de modifications et notifications;
|
|
- gestion sysadmin des groupes et données de démonstration;
|
|
- liens de causalité entre les actions et leurs effets métier.
|
|
|
|
## Conventions
|
|
|
|
Les modules sont parfois identifiés par codes internes:
|
|
|
|
- `C`: consultation;
|
|
- `S`: saisie ou activité hebdomadaire;
|
|
- `M`: activité mensuelle ou d'assemblée;
|
|
- `G`: gestion;
|
|
- `G14`: gestion sysadmin des groupes.
|
|
|
|
Le mot `exécutif` désigne un membre ayant une affectation active à un poste de catégorie `executif`. Le compte `Sysadmin` est un compte technique qui satisfait toutes les vérifications d'accès.
|