Files
jb-compta/PLAN.md
T

3.5 KiB
Raw Blame History

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).