# Socodam App - Système de Facturation Logistique

Application de gestion de facturation professionnelle conçue spécifiquement pour le secteur du transit et de la logistique. Ce projet remplace les processus manuels (Excel) par une solution web centralisée et sécurisée développée avec Django.

## 🚀 Fonctionnalités Clés

*   **Gestion de Dossiers** : Création et suivi des dossiers de transit (Import/Export/Aérien/Maritime).
*   **Workflow de Validation** :
    *   Saisie des éléments de facturation (Frais et Débours).
    *   Génération de **Proforma** pour validation client.
    *   Conversion automatique en **Facture Définitive** (Verrouillage des données).
*   **Génération PDF** : Export instantané des documents commerciaux au format PDF normalisé.
*   **Tableau de Bord** : Vue synthétique des activités récentes et indicateurs financiers.
*   **Interface Dédiée** : UI moderne et responsive (Thème Kanakku).

## 🛠 Stack Technique

*   **Backend** : Python 3.12, Django 6.0.1
*   **Base de données** : SQLite (Dev) / PostgreSQL (Prod - compatible)
*   **Frontend** : Django Templates (MTV), Bootstrap 5, jQuery
*   **Outils PDF** : xhtml2pdf

## 📦 Installation et Démarrage

1.  **Cloner le projet**
    ```bash
    git clone <url-du-repository>
    cd Socodam
    ```

2.  **Configurer l'environnement virtuel**
    ```bash
    python3 -m venv .venvagil
    source .venvagil/bin/activate
    ```

3.  **Installer les dépendances**
    ```bash
    pip install -r requirements.txt
    ```

4.  **Initialiser la base de données**
    ```bash
    python manage.py migrate
    ```

5.  **Créer un super-utilisateur (Admin)**
    ```bash
    python manage.py createsuperuser
    ```

6.  **Lancer le serveur de développement**
    ```bash
    python manage.py runserver
    ```

## 📄 Structure du Projet

*   `billing/` : Cœur de l'application (Modèles, Vues, Logique métier).
    *   `services.py` : Logique de validation et génération de PDF.
*   `frontsite/` : Gestion des templates globaux et assets statiques.
*   `templates/` : Gabarits HTML de base.

## 🛡 Workflow

1.  Un agent crée un **Dossier**.
2.  Il ajoute des lignes de services (Frais ou Débours).
3.  Il génère une **Proforma** (brouillon modifiable).
4.  Une fois validée, la Proforma est convertie en **Facture** (document officiel immuable).