158 lines
3.8 KiB
Markdown
158 lines
3.8 KiB
Markdown
# 💸 Dépenses Trello - Application de Gestion des Dépenses
|
||
|
||
## 📝 Description
|
||
|
||
**Dépenses Trello** est une application web de gestion des dépenses personnelles avec synchronisation automatique vers Trello. Créée pour simplifier le suivi des dépenses au quotidien.
|
||
|
||
---
|
||
|
||
## ✨ Fonctionnalités
|
||
|
||
### Gestion des Dépenses
|
||
- ➕ **Ajout rapide** de dépenses (prénom, date, libellé, montant, catégorie)
|
||
- ✏️ **Modification** des dépenses existantes
|
||
- 🗑️ **Suppression** de dépenses
|
||
- 📤 **Export CSV** pour Excel/comptabilité
|
||
- 📥 **Import CSV** pour récupérer des données
|
||
- 📄 **Export PDF** pour les relevés
|
||
|
||
### Catégories Automatiques
|
||
- 🚗 **Transport** (essence, gazole, parking)
|
||
- 🛒 **Courses** (Carrefour, Lidl, Auchan)
|
||
- 🎰 **Loisirs** (loto, bar, café, cinéma)
|
||
- 🏠 **Maison** (lumière, loyer, brico)
|
||
- ❤️ **Santé** (pharmacie, contrôle technique)
|
||
- 📦 **Autre** (divers)
|
||
|
||
### Graphiques & Statistiques
|
||
- 📊 **Bar chart** - visualisation classique
|
||
- 🥧 **Camembert** - répartition par catégorie
|
||
- 👤 **Par personne** - suivi par membre du foyer
|
||
- 📅 **Par mois** - évolution dans le temps
|
||
|
||
### Budget
|
||
- 💰 **Budget mensuel** configurable
|
||
- ⚠️ **Alerte** automatique quand le budget est dépassé
|
||
|
||
### Dépenses Récurrentes
|
||
- 🔄 **Loyer**, EDF, téléphone - automatiquement listés
|
||
|
||
### Synchronisation Trello
|
||
- 🟦 **Envoi automatique** des dépenses vers une liste Trello
|
||
- ✅ **Suivi du statut** (En attente / Envoyé)
|
||
|
||
---
|
||
|
||
## 🛠️ Stack Technique
|
||
|
||
| Composant | Technologie |
|
||
|-----------|--------------|
|
||
| **Backend** | Python Flask |
|
||
| **Base de données** | SQLite |
|
||
| **Frontend** | HTML5, Vanilla JavaScript |
|
||
| **Graphiques** | Chart.js |
|
||
| **PDF** | jsPDF |
|
||
| **Hébergement** | VPS (Linux) |
|
||
|
||
---
|
||
|
||
## 📋 Spécifications
|
||
|
||
- **Port**: 8769
|
||
- **URL**: http://178.18.250.53:8769/
|
||
- **API REST**: /api/depenses, /api/config, /api/budget, /api/recurring
|
||
- **Données**: 21+ dépenses en base (extensible)
|
||
- **Utilisateurs**: Multi-utilisateurs (via prénom)
|
||
|
||
---
|
||
|
||
## 🚀 Installation
|
||
|
||
```bash
|
||
# Cloner le projet
|
||
git clone http://178.18.250.53:3000/admin/Perso.git
|
||
|
||
# Installer les dépendances
|
||
pip install flask requests
|
||
|
||
# Lancer l'application
|
||
python app.py
|
||
```
|
||
|
||
---
|
||
|
||
## 💼 Potentiel Commercial
|
||
|
||
### Cible
|
||
- 👨👩👧 **Particuliers** gestion budget familial
|
||
- 💼 **Auto-entrepreneurs** frais professionnels
|
||
- 🏢 **Petites entreprises** suivi dépenses
|
||
|
||
### Arguments de Vente
|
||
1. ✅ **Simple** - interface épurée, pas de formation
|
||
2. ✅ **Complet** - catégories, graphiques, budget, PDF
|
||
3. ✅ **Automatisé** - synchronisation Trello
|
||
4. ✅ **Pas d'abonnement** - hébergement propre
|
||
5. ✅ **Open Source** - customisable
|
||
|
||
### Prix Recommandés
|
||
| Offre | Prix |
|
||
|-------|------|
|
||
| Usage personnel | 19€ |
|
||
| Usage pro | 49€ |
|
||
| Installation + config | 29€ |
|
||
| Support mensuel | 9€/mois |
|
||
|
||
---
|
||
|
||
## 📱 Captures d'Écran
|
||
|
||
### Page Saisie
|
||
- Formulaire rapide avec catégories auto
|
||
- Liste des dernières dépenses
|
||
- Boutons Envoyer tout / Export
|
||
|
||
### Page Dashboard
|
||
- Graphiques Bar / Camembert
|
||
- Filtres Mois / Personne / Catégorie
|
||
- Total en temps réel
|
||
|
||
### Page Config
|
||
- Gestion des prénoms
|
||
- Personnalisation des catégories
|
||
- Configuration Trello (API Key, Token, List ID)
|
||
- Budget mensuel
|
||
|
||
---
|
||
|
||
## 🔧 Configuration Trello
|
||
|
||
1. Créer un Power-Up sur https://trello.com/power-ups/admin
|
||
2. Générer une API Key
|
||
3. Générer un Token (avec permissions write)
|
||
4. Copier le List ID cible
|
||
5. Coller dans Config
|
||
|
||
---
|
||
|
||
## 📝 Roadmap Future
|
||
|
||
- [ ] Application mobile (PWA)
|
||
- [ ] Mode hors-ligne
|
||
- [ ] Catégories personnalisées illimitées
|
||
- [ ] Rapports mensuels par email
|
||
- [ ] Intégration Slack/Discord
|
||
- [ ] Multi-devises
|
||
|
||
---
|
||
|
||
## 📞 Contact
|
||
|
||
**Développé par**: H3R7Tech
|
||
**Date**: Mars 2026
|
||
**Version**: 1.6
|
||
|
||
---
|
||
|
||
*Document généré automatiquement - Dépenses Trello*
|