turf_saas/DOCUMENTATION.md

💸 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

# 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