Module Produits
===============

Le module **Produits** est le cœur du catalogue bancaire du système THL Core Banking. Il gère la création, la configuration et l'administration de tous les produits bancaires proposés aux clients.

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

Le module Produits permet de :

- **Créer et gérer les produits bancaires** : Définition des caractéristiques et conditions
- **Configurer les catégories de produits** : Organisation hiérarchique des produits
- **Définir les paramètres financiers** : Limites, frais, conditions de retrait
- **Gérer les comptes associés** : Suivi des comptes utilisant chaque produit
- **Contrôler la disponibilité** : Activation/désactivation des produits
- **Exporter et importer** : Gestion en masse des produits bancaires

1. Création et gestion des produits bancaires
=============================================

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

Procédure de création d'un produit
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Connectez-vous au logiciel avec les droits appropriés.
2. Accédez au module **Produits**.
3. Cliquez sur **Nouveau produit**.

   a. **Informations de base**
      - Saisissez le code unique du produit
      - Entrez le nom du produit
      - Sélectionnez la catégorie de produit
      - Rédigez la description détaillée

   b. **Paramètres financiers**
      - Définissez le dépôt minimum (minDeposit)
      - Définissez le dépôt maximum (maxDeposit)
      - Configurez le retrait minimum (minWithdrawal)
      - Configurez le retrait maximum (maxWithdrawal)
      - Définissez les frais de gestion (managementFees)
      - Configurez les frais d'ouverture (openingFees)
      - Définissez le retrait mensuel autorisé (monthlyWithdrawal)

   c. **Conditions spéciales**
      - Configurez la condition de retrait (withdrawCondition) - max 100%
      - Activez/désactivez l'autorisation de découvert (overdraftAllowed)
      - Activez/désactivez le relevé de compte (accountStatement)

   d. **Validation et enregistrement**
      - Vérification de l'unicité du code et du nom
      - Validation des paramètres financiers
      - Enregistrement dans la base de données
      - Journalisation de l'action

4. Le produit est créé avec le statut **ACTIVATED** par défaut.

Gestion des informations de produit
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. **Consultation des détails**
   - Affichage des informations complètes du produit
   - Visualisation des paramètres financiers
   - Consultation des comptes associés
   - Affichage des statistiques d'utilisation

2. **Modification des informations**
   - Mise à jour des paramètres financiers
   - Modification des conditions spéciales
   - Changement de catégorie
   - Mise à jour de la description

3. **Gestion des statuts**
   - Activation/désactivation du produit
   - Suppression logique (soft delete)
   - Suppression définitive (hard delete)
   - Restauration de produits supprimés

2. Gestion des catégories de produits
=====================================

Cette fonctionnalité permet d'organiser les produits en catégories logiques.

Création de catégories
~~~~~~~~~~~~~~~~~~~~~~

1. **Informations de catégorie**
   - Code unique de la catégorie
   - Nom de la catégorie
   - Description détaillée
   - Configuration des frais par table (feeFromTable)

2. **Types de catégories supportées**
   - **Comptes d'épargne** : Épargne classique, épargne logement
   - **Comptes courants** : Comptes de transaction
   - **Comptes professionnels** : Comptes pour entreprises
   - **Comptes spécialisés** : Comptes avec conditions particulières

3. **Gestion des frais par catégorie**
   - Configuration des frais standardisés
   - Table de frais par catégorie
   - Application automatique des frais

3. Configuration des paramètres financiers
==========================================

Cette section détaille la configuration des aspects financiers des produits.

Limites de dépôt et retrait
~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. **Dépôts**
   - **Dépôt minimum** : Montant minimum pour ouvrir un compte
   - **Dépôt maximum** : Limite supérieure des dépôts
   - **Contrôles automatiques** : Vérification lors des opérations
   - **Alertes de dépassement** : Notifications pour les limites

2. **Retraits**
   - **Retrait minimum** : Montant minimum par retrait
   - **Retrait maximum** : Limite supérieure des retraits
   - **Retrait mensuel** : Limite mensuelle de retrait
   - **Condition de retrait** : Pourcentage maximum (max 100%)

Frais et commissions
~~~~~~~~~~~~~~~~~~~~

1. **Frais de gestion**
   - Frais mensuels de gestion du compte
   - Calcul automatique et déduction
   - Configuration par produit

2. **Frais d'ouverture**
   - Frais uniques à l'ouverture du compte
   - Déduction lors de la création
   - Possibilité de remise

3. **Frais par catégorie**
   - Frais standardisés par type de produit
   - Application automatique
   - Personnalisation possible

4. Gestion des comptes associés
===============================

Cette fonctionnalité permet de suivre tous les comptes utilisant un produit spécifique.

Consultation des comptes
~~~~~~~~~~~~~~~~~~~~~~~~

1. **Liste des comptes**
   - Tous les comptes utilisant le produit
   - Filtrage par statut (ACTIVATED, SUSPENDED, CLOSED, DELETED)
   - Tri par date de création, solde, client
   - Recherche par numéro de compte ou nom du client

2. **Statistiques détaillées**
   - Nombre total de comptes
   - Nombre de comptes activés
   - Nombre de comptes désactivés
   - Nombre de comptes supprimés

3. **Analyse des performances**
   - Volume des transactions par produit
   - Évolution du nombre de comptes
   - Taux d'utilisation du produit
   - Rentabilité par produit

5. Contrôle de la disponibilité
===============================

Cette section couvre la gestion de la disponibilité des produits.

Gestion des statuts
~~~~~~~~~~~~~~~~~~~

1. **Activation de produits**
   - Mise en service d'un nouveau produit
   - Disponibilité pour les nouveaux comptes
   - Notification aux utilisateurs

2. **Désactivation de produits**
   - Suspension temporaire des nouveaux comptes
   - Maintien des comptes existants
   - Communication aux clients

3. **Suppression de produits**
   - Suppression logique (soft delete)
   - Suppression définitive (hard delete)
   - Vérification des comptes associés

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

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

Import de produits
~~~~~~~~~~~~~~~~~~

1. **Import en masse**
   - Import de produits 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 produits
~~~~~~~~~~~~~~~~~~

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

2. **Rapports de produits**
   - Rapport de performance des produits
   - Statistiques d'utilisation
   - Analyse des revenus par produit
   - Métriques de rentabilité

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

Le module Produits s'intègre étroitement avec plusieurs modules du système.

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

1. **Module Comptes**
   - Association des comptes aux produits
   - Application des paramètres de produit
   - Contrôles automatiques des limites

2. **Module Comptabilité**
   - Écritures comptables pour les frais
   - Calcul des revenus par produit
   - Intégration avec le grand livre

3. **Module Clients**
   - Sélection de produits lors de l'ouverture
   - Historique des produits utilisés
   - Recommandations personnalisées

4. **Module Transactions**
   - Application des limites de transaction
   - Calcul des frais automatiques
   - Contrôles de cohérence

8. Rapports et analytics
========================

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

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

1. **Rapport de performance des produits**
   - Nombre de comptes par produit
   - Volume des transactions
   - Revenus générés
   - Taux d'utilisation

2. **Rapport des catégories**
   - Performance par catégorie
   - Comparaison des produits
   - Tendances du marché
   - Recommandations stratégiques

3. **Rapport financier**
   - Revenus par produit
   - Coûts de gestion
   - Rentabilité détaillée
   - Projections futures

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 produits populaires
   - Prévision des besoins clients
   - Optimisation de l'offre
   - Recommandations stratégiques

3. **Comparaisons et benchmarking**
   - Performance relative des produits
   - Analyse concurrentielle
   - Identification des opportunités
   - Optimisation des paramètres

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

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

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 de consultation des produits
   - Droits de modification des paramètres
   - Droits d'administration des catégories
   - 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 financières
   - Masquage des informations confidentielles
   - Contrôle d'accès aux paramètres critiques

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

10. Cas d'usage et exemples
===========================

Cette section présente des cas d'usage concrets pour illustrer l'utilisation du module.

Exemples de produits bancaires
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. **Compte d'épargne classique**
   - Dépôt minimum : 5 000 FCFA
   - Dépôt maximum : 10 000 000 FCFA
   - Retrait minimum : 1 000 FCFA
   - Retrait maximum : 500 000 FCFA
   - Frais de gestion : 500 FCFA/mois
   - Condition de retrait : 100%

2. **Compte professionnel**
   - Dépôt minimum : 50 000 FCFA
   - Dépôt maximum : 100 000 000 FCFA
   - Retrait minimum : 5 000 FCFA
   - Retrait maximum : 5 000 000 FCFA
   - Frais de gestion : 2 000 FCFA/mois
   - Découvert autorisé : Oui

3. **Compte d'épargne logement**
   - Dépôt minimum : 10 000 FCFA
   - Dépôt maximum : 50 000 000 FCFA
   - Retrait minimum : 2 000 FCFA
   - Retrait maximum : 2 000 000 FCFA
   - Frais de gestion : 1 000 FCFA/mois
   - Condition de retrait : 80%

Scénarios d'utilisation
~~~~~~~~~~~~~~~~~~~~~~~

1. **Création d'un nouveau produit**
   - Analyse des besoins clients
   - Définition des paramètres
   - Test et validation
   - Mise en production

2. **Modification d'un produit existant**
   - Analyse de l'impact
   - Communication aux clients
   - Mise à jour des paramètres
   - Suivi des effets

3. **Désactivation d'un produit**
   - Analyse des comptes actifs
   - Communication préalable
   - Désactivation progressive
   - Migration des clients

.. toctree::
   :maxdepth: 2

   all_features
   new_features