JB Compta v1.1 - multi-activité

2026-06-29 23:56:40 +02:00
commit 1716cebfbd
34 changed files with 1568 additions and 0 deletions
@@ -0,0 +1,76 @@
+# 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).