# JB — Compta Micro-Entreprise

Application **Django** de gestion comptable pour micro-entreprise(s) française(s),
au-dessus de **PostgreSQL**. Complète Indy (qui garde devis + factures + suivi bancaire)
en gérant ce que sa version gratuite ne fait pas : saisie des ventes/dépenses,
calculs **TVA / URSSAF / impôt**, statistiques et **exports CSV**.

Conçue pour évoluer : aucun taux n'est codé en dur (table `Bareme` par activité/année),
multi-entreprises, et logique fiscale en Python que tu contrôles.

## Ce que ça fait

- Saisie des **ventes** (factures) et **dépenses** via l'admin Django (formulaires auto).
- **CA HT encaissé**, suivi des plafonds micro et du seuil de franchise TVA.
- **Cotisations URSSAF**, **versement libératoire** et **TVA à reverser** calculés sur la base HT.
- **Tableau de bord** avec graphique mensuel + montants à provisionner.
- **Exports CSV** (ventes, TVA, URSSAF) pour tes déclarations.

## Déploiement avec Portainer (recommandé)

La base PostgreSQL est **externe** (la tienne) ; le conteneur ne contient que l'app (sans état).

1. Dans Portainer → **Stacks** → **Add stack** → colle le contenu de `docker-compose.yml`
   (ou pointe sur ce dépôt Git).
2. Renseigne les variables d'environnement (voir `.env.example`) : `DB_HOST`, `DB_NAME`,
   `DB_USER`, `DB_PASSWORD`, `DJANGO_SECRET_KEY`, `DJANGO_ALLOWED_HOSTS`,
   `DJANGO_CSRF_TRUSTED_ORIGINS`, et le compte admin `DJANGO_SUPERUSER_*`.
3. Mets `SEED_DEMO=1` au premier lancement pour charger les barèmes 2026 + données d'exemple
   (repasse-le à `0` ensuite).
4. Déploie. Au démarrage le conteneur applique les migrations, crée l'admin, puis sert l'app.
5. Accède à `http://IP_DU_SERVEUR:8001` → `/admin/` pour saisir, `/dashboard/` pour les stats.

> Prérequis côté PostgreSQL : crée la base (ex. `compta`) et un utilisateur ayant les droits dessus.
> Les **tables sont créées automatiquement** par les migrations Django (rien à exécuter à la main).

## Lancer en local (développement)

```bash
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env            # renseigne DB_* (ou laisse vide pour SQLite de test)
python manage.py migrate
python manage.py seed_demo      # barèmes 2026 + données d'exemple (optionnel)
python manage.py createsuperuser
python manage.py runserver
# http://127.0.0.1:8000/
```

## Structure

```
JB - compta/
├── manage.py
├── requirements.txt
├── Dockerfile / entrypoint.sh / docker-compose.yml   # packaging Portainer
├── .env.example
├── config/                 # projet Django (settings, urls, wsgi)
├── compta/                 # application métier
│   ├── models.py           # Entreprise, Client, Facture, Ligne, Depense, Bareme
│   ├── admin.py            # formulaires de saisie
│   ├── services.py         # calculs TVA / URSSAF / versement libératoire (base HT)
│   ├── views.py            # dashboard + exports CSV
│   └── templates/compta/dashboard.html
└── docs/
    ├── regles-fiscales-2026.md   # seuils & taux sourcés
    ├── modele-donnees.md         # description du schéma
    └── deploiement.md            # détails Portainer / mise à jour
```

## Avertissement

Les taux et seuils sont ceux connus pour 2026 (voir `docs/regles-fiscales-2026.md`,
sourcé). Cet outil aide au suivi mais ne remplace pas un expert-comptable.
Vérifie toujours les chiffres officiels sur urssaf.fr et impots.gouv.fr.