Documentation v1.0 - Pour vente

DOCUMENTATION.md

@@ -0,0 +1,157 @@
+# 💸 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*