Supprimer README.md
This commit is contained in:
@@ -1,74 +0,0 @@
|
|||||||
# 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.
|
|
||||||
Reference in New Issue
Block a user