# 💸 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*
