Module Agence
=============

Le module **Agence** est le cœur organisationnel du système THL Core Banking. Il gère la création, la configuration et l'administration des agences bancaires, ainsi que toutes les entités qui leur sont associées (employés, clients, comptes, prêts, transactions).

Vue d'ensemble
--------------

Le module Agence permet de :

- **Créer et gérer les agences** : Enregistrement de nouvelles agences avec codes uniques
- **Gérer les employés** : Affectation et administration du personnel par agence
- **Superviser les clients** : Suivi des clients rattachés à chaque agence
- **Contrôler les comptes** : Gestion des comptes clients et internes par agence
- **Administrer les prêts** : Supervision des prêts accordés par agence
- **Suivre les transactions** : Monitoring des opérations bancaires par agence
- **Gérer les comptes internes** : Administration des comptes internes de l'agence
- **Exporter et importer** : Fonctionnalités d'import/export des données d'agence

1. Création et gestion des agences
==================================

Cette section couvre la création, la configuration et la gestion des agences bancaires.

Procédure de création d'une agence
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Connectez-vous au logiciel avec les droits **SUPER_ADMIN**.
2. Accédez au module **Agence**.
3. Cliquez sur **Nouvelle agence**.

   a. **Informations de base**
      - Saisissez le nom de l'agence
      - Entrez le numéro de téléphone
      - Saisissez l'adresse email
      - Sélectionnez le quartier/zone

   b. **Génération automatique du code**
      - Le système génère automatiquement un code unique (format : 00001, 00002, etc.)
      - Vérification de l'unicité du code
      - Attribution séquentielle basée sur le nombre d'agences activées

   c. **Validation et enregistrement**
      - Vérification de l'unicité du nom
      - Validation des données saisies
      - Enregistrement dans la base de données
      - Journalisation de l'action

4. L'agence est créée avec le statut **ACTIVATED** par défaut.

Gestion des informations d'agence
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. **Consultation des détails**
   - Affichage des informations complètes de l'agence
   - Visualisation de l'adresse (pays, ville, quartier)
   - Consultation des coordonnées (téléphone, email)
   - Affichage du code unique de l'agence

2. **Modification des informations**
   - Mise à jour des données de contact
   - Modification de l'adresse
   - Changement du nom (avec vérification d'unicité)
   - Mise à jour du code d'agence (SUPER_ADMIN uniquement)

3. **Gestion des statuts**
   - Activation/désactivation de l'agence
   - Suppression logique (soft delete)
   - Suppression définitive (hard delete)
   - Restauration d'agences supprimées

2. Gestion des employés par agence
==================================

Cette fonctionnalité permet d'administrer le personnel affecté à chaque agence.

Affectation des employés
~~~~~~~~~~~~~~~~~~~~~~~~~~

1. **Consultation des employés**
   - Liste des employés de l'agence
   - Filtrage par statut (ACTIVATED, SUSPENDED, etc.)
   - Recherche par nom, poste ou département
   - Affichage des informations de contact

2. **Gestion des affectations**
   - Affectation d'employés à l'agence
   - Changement d'affectation entre agences
   - Désaffectation temporaire ou définitive
   - Historique des affectations

3. **Contrôle d'accès**
   - Vérification des droits d'accès par agence
   - Gestion des rôles et permissions
   - Contrôle des accès aux données de l'agence

3. Supervision des clients
==========================

Le module permet de superviser tous les clients rattachés à une agence.

Consultation des clients
~~~~~~~~~~~~~~~~~~~~~~~~~~

1. **Liste des clients de l'agence**
   - Affichage de tous les clients de l'agence
   - Filtrage par statut de compte
   - Recherche par nom, numéro de client ou document d'identité
   - Tri par date d'inscription, solde, etc.

2. **Détails des clients**
   - Informations personnelles complètes
   - Documents d'identité et pièces justificatives
   - Historique des interactions
   - Statut KYC (Know Your Customer)

3. **Gestion des comptes clients**
   - Vue d'ensemble des comptes par client
   - Statut des comptes (ACTIVATED, SUSPENDED, CLOSED)
   - Soldes et mouvements récents
   - Historique des transactions

4. Gestion des comptes par agence
==================================

Cette section couvre la gestion des comptes clients et internes par agence.

Comptes clients
~~~~~~~~~~~~~~~~

1. **Vue d'ensemble des comptes**
   - Liste de tous les comptes de l'agence
   - Filtrage par type de compte
   - Tri par solde, date de création, statut
   - Recherche par numéro de compte ou nom du client

2. **Gestion des comptes**
   - Ouverture de nouveaux comptes
   - Fermeture de comptes existants
   - Suspension/réactivation de comptes
   - Modification des informations de compte

3. **Opérations sur les comptes**
   - Dépôts et retraits
   - Transferts entre comptes
   - Gestion des frais mensuels
   - Remboursements de prêts

Comptes internes
~~~~~~~~~~~~~~~~~~

1. **Comptes internes de l'agence**
   - Gestion des comptes de trésorerie
   - Comptes de provisions
   - Comptes de frais et commissions
   - Comptes de réserves

2. **Alimentation des comptes**
   - Approvisionnement des comptes internes
   - Transferts entre comptes internes
   - Gestion des liquidités
   - Suivi des mouvements

5. Administration des prêts
===========================

Le module permet de superviser tous les prêts accordés par l'agence.

Consultation des prêts
~~~~~~~~~~~~~~~~~~~~~~~~

1. **Liste des prêts de l'agence**
   - Tous les prêts accordés par l'agence
   - Filtrage par statut (APPROVED, PENDING, REJECTED)
   - Tri par montant, date d'octroi, échéance
   - Recherche par client ou numéro de prêt

2. **Détails des prêts**
   - Informations complètes du prêt
   - Plan de remboursement
   - Historique des paiements
   - Garanties et collatéraux

3. **Suivi des remboursements**
   - Échéances à venir
   - Retards de paiement
   - Remboursements anticipés
   - Reports et rééchelonnements

6. Suivi des transactions
=========================

Cette fonctionnalité permet de monitorer toutes les transactions effectuées dans l'agence.

Consultation des transactions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. **Transactions de l'agence**
   - Toutes les transactions effectuées dans l'agence
   - Filtrage par type de transaction
   - Tri par date, montant, statut
   - Recherche par numéro de transaction ou client

2. **Types de transactions supportées**
   - Dépôts et retraits
   - Transferts entre comptes
   - Virements inter-agences
   - Paiements de prêts
   - Collectes et encaissements
   - Frais et commissions

3. **Monitoring en temps réel**
   - Transactions en cours
   - Alertes de sécurité
   - Détection d'anomalies
   - Suivi des performances

7. Import et export de données
==============================

Le module offre des fonctionnalités d'import et d'export pour faciliter la gestion des données d'agence.

Import de données
~~~~~~~~~~~~~~~~~~~~

1. **Import en masse**
   - Import de nouvelles agences via fichier Excel/CSV
   - Validation des données avant import
   - Gestion des erreurs et rejets
   - Rapport d'import détaillé

2. **Format de fichier supporté**
   - Fichiers Excel (.xlsx, .xls)
   - Fichiers CSV
   - Structure prédéfinie avec colonnes obligatoires
   - Validation des formats de données

Export de données
~~~~~~~~~~~~~~~~~~~~

1. **Export des agences**
   - Export de la liste des agences
   - Filtrage par statut ou critères
   - Formats Excel et CSV
   - Données complètes ou sélectionnées

2. **Rapports d'agence**
   - Rapport de performance de l'agence
   - Statistiques des clients et comptes
   - Analyse des transactions
   - Métriques de rentabilité

8. Sécurité et contrôles
========================

Le module intègre des mécanismes de sécurité avancés pour protéger les données d'agence.

Contrôles d'accès
~~~~~~~~~~~~~~~~~~~~

1. **Authentification obligatoire**
   - Connexion requise pour toutes les opérations
   - Journalisation des accès
   - Gestion des sessions utilisateur

2. **Autorisations granulaires**
   - Droits SUPER_ADMIN pour la gestion des agences
   - Contrôle d'accès par fonctionnalité
   - Vérification des permissions avant chaque action

3. **Audit et traçabilité**
   - Journalisation complète des actions
   - Traçabilité des modifications
   - Historique des accès et opérations

Sécurité des données
~~~~~~~~~~~~~~~~~~~~~~~~

1. **Protection des informations sensibles**
   - Chiffrement des données sensibles
   - Masquage des informations confidentielles
   - Contrôle d'accès aux données par agence

2. **Validation des données**
   - Vérification de l'intégrité des données
   - Validation des formats et types
   - Contrôles de cohérence métier

9. Intégration avec les autres modules
======================================

Le module Agence s'intègre étroitement avec tous les autres modules du système.

Modules intégrés
~~~~~~~~~~~~~~~~~~~~

1. **Module Clients**
   - Rattachement des clients à une agence
   - Gestion des comptes par agence
   - Suivi des prêts par agence

2. **Module Transactions**
   - Toutes les transactions liées à une agence
   - Monitoring des opérations
   - Contrôle des flux financiers

3. **Module Comptabilité**
   - Écritures comptables par agence
   - Grand livre par agence
   - Rapports financiers par agence

4. **Module Administration**
   - Gestion des employés par agence
   - Contrôle des accès
   - Configuration des paramètres

10. Rapports et analytics
=========================

Le module fournit des rapports détaillés et des analyses pour la gestion des agences.

Rapports standard
~~~~~~~~~~~~~~~~~~~~

1. **Rapport de performance de l'agence**
   - Nombre de clients actifs
   - Volume des transactions
   - Montant des prêts accordés
   - Rentabilité de l'agence

2. **Rapport des comptes**
   - Évolution des soldes
   - Nouveaux comptes ouverts
   - Comptes fermés ou suspendus
   - Analyse des mouvements

3. **Rapport des prêts**
   - Prêts accordés par période
   - Taux de remboursement
   - Prêts en défaut
   - Analyse de la qualité du portefeuille

Analytics avancés
~~~~~~~~~~~~~~~~~~~~

1. **Tableaux de bord interactifs**
   - Métriques en temps réel
   - Graphiques et visualisations
   - Indicateurs de performance clés (KPI)
   - Alertes automatiques

2. **Analyse prédictive**
   - Tendances des dépôts et retraits
   - Prévision des besoins en liquidité
   - Analyse des risques
   - Recommandations stratégiques

3. **Comparaisons inter-agences**
   - Performance relative des agences
   - Benchmarking des métriques
   - Identification des meilleures pratiques
   - Analyse des écarts de performance

.. toctree::
   :maxdepth: 2

   all_features
   new_features