Files

77 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).