# Plan du projet — Compta micro-entreprise (Appsmith)

## Contexte

- Statut actuel : **micro-entreprise**, option **versement forfaitaire libératoire**.
- **Assujetti à la TVA** : déclaration et paiement **mensuels** (donc hors franchise en base).
- Trois flux payés chaque mois : **cotisations URSSAF**, **versement libératoire (impôt)**, **TVA**.
- Outil existant : **Indy** (devis + factures + suivi bancaire) — conservé.
- Limites d'Indy gratuit : pas de gestion comptable, **pas d'export CSV** des données.

## Objectif

Construire dans **Appsmith + PostgreSQL** une couche de gestion financière qui complète Indy :
saisie des ventes/dépenses, calculs TVA/URSSAF/impôt, statistiques et exports CSV.
Système **paramétrable** car le statut pourra évoluer.

## Périmètre

| Reste sur Indy | Géré dans Appsmith |
|----------------|--------------------|
| Devis | Saisie des ventes encaissées |
| Factures (format Indy apprécié) | Saisie des dépenses |
| Suivi bancaire | TVA collectée / déductible / à reverser |
| | Cotisations URSSAF |
| | Versement libératoire (impôt) |
| | Statistiques + suivi des seuils |
| | Exports CSV |

## Décisions actées

- **Indy conservé** pour devis et factures (complément, pas remplacement).
- **Saisie manuelle** via formulaires (Indy n'exporte pas).
- **Interface = Python / Django** (admin auto pour la saisie, logique fiscale en Python,
  multi-utilisateurs gratuit) — au lieu d'Appsmith.
- **Déploiement = Docker + Portainer**, base PostgreSQL externe (conteneur sans état).
- **TVA réelle**, suivi mensuel ; base de calcul URSSAF/impôt = **CA hors taxes (HT)**.
- **Modèle paramétrable** : taux et seuils dans le modèle `Bareme` par activité/année ;
  aucun taux codé en dur.

## Modules

1. **Ventes** — formulaire (date émission, client, montant HT, taux TVA, date encaissement, statut). CA compté à l'encaissement.
2. **Dépenses** — formulaire (date, catégorie, montant TTC, TVA déductible).
3. **TVA** — vue mensuelle : collectée − déductible = à reverser ; export.
4. **URSSAF** — CA encaissé × taux social (selon activité).
5. **Impôt (versement libératoire)** — CA × taux (1 % / 1,7 % / 2,2 %).
6. **Tableau de bord** — CA mensuel/annuel, % des plafonds, alertes seuils, top clients, trésorerie.

## Architecture technique

```
PostgreSQL externe (données)  ──  App Django/Gunicorn (admin + dashboard + exports)  ──  Image Docker déployée via Portainer
```

Cœur durable = le modèle de données + la logique fiscale en Python ; l'interface est remplaçable.

## Évolutivité du statut

Tout est rattaché à une table `entreprise` portant ses propres paramètres (activité, régime TVA, option fiscale).
Un changement de statut (EI au réel, société) réutilise les tables ventes/dépenses/clients et n'ajoute que de nouvelles règles de calcul. Multi-entreprises prévu pour gérer d'autres personnes plus tard.

## Phasage

- **v1 — Cœur compta** : Ventes + Dépenses + calculs TVA/URSSAF/impôt + exports CSV.
- **v2 — Pilotage** : tableau de bord, statistiques, alertes de seuils.
- **v3 — Extension** : multi-entreprises et adaptation à un éventuel nouveau statut.

## Points à confirmer plus tard

- Régime de TVA précis (réel normal mensuel ou réel simplifié).
- Activité fiscale exacte (BIC vente / BIC service / BNC) → fixe les bons taux.
- Direction probable d'évolution du statut.

## Prochaine étape technique

Adapter le jeu de données d'exemple à la TVA réelle, puis construire les formulaires Ventes et Dépenses dans Appsmith (v1).