Documentation COOP-CA AMIFOND

Tout ce que vous devez savoir pour déployer et utiliser le système de gestion de la coopérative d'épargne et de crédit.

Premiers pas

Nouveau sur le système AMIFOND ou sur les environnements de production ? C'est ici qu'il faut commencer.

• De zéro : Aperçu de l'architecture | Variables d'environnement | Installation locale
• Tutoriels : 1. Configuration PostgreSQL | 2. Custom User & Auth JWT | 3. Plan Comptable PC-EMF | 4. Gestion des branches (agences) | 5. Déploiement Docker | 6. Conformité COBAC
• Guides avancés : Implémenter le RBAC | Moteur comptable (15 règles PC-EMF) | Provisions et classification des créances

Architecture du projet

Le système suit une structure Django modulaire avec séparation claire des responsabilités :

coop-ca-amifond/
├── authentication/     # Custom User, JWT, RBAC, rôles coopérative
├── apps/
│   ├── enterprise/     # Agrégat racine (Entreprise, Branches, Exercices)
│   ├── accounts/       # Plan comptable PC-EMF (~1532 comptes)
│   ├── tiers/          # Tiers Classe 4 (personnes physiques/morales)
│   ├── customers/      # Clientèle (KYC, IBAN, comptes, épargne)
│   ├── accounting/     # Comptabilité générale (journaux, écritures)
│   ├── treasury/       # Trésorerie (sessions de caisse, opérations)
│   ├── loans/          # Crédits (CTA/MLT, amortissement, provisions)
│   ├── shares/         # Parts sociales (souscription, libération, retrait)
│   ├── events/         # Moteur de règles comptables (15 règles PC-EMF)
│   ├── client/         # Portail client self-service (lecture seule)
│   ├── manager/        # Portail gestionnaire back-office (CRUD)
│   └── common/         # Utilitaires partagés (Country, City)
├── core/               # Utilitaires transverses (Document, MediaFile, Notification)
├── config/             # Settings, URLs, WSGI, Swagger
└── pages/              # Interface HTML + Design System

Obtenir de l'aide

• Consultez la FAQ — réponses aux questions de déploiement fréquentes.
• Besoin d'un module précis ? Consultez l'index des Modules.
• Explorez les endpoints via Swagger UI ou ReDoc.
• Signalez les bugs sur le Ticket Tracker (GitHub).

Organisation de la documentation

• Tutoriels étape par étape — du git clone jusqu'au premier déploiement réussi.
• Guides de conception — pourquoi JWT cookie-only, pourquoi drf-spectacular, comment fonctionne l'isolation par agence (BranchScopedModel).
• Référence API — documentation complète de tous les endpoints via OpenAPI 3.0.
• Changelog — historique des versions et mises à jour.