65 lines
3.5 KiB
Markdown
65 lines
3.5 KiB
Markdown
# 🦙 PachaFamily - Dashboard Familial Sur-Mesure
|
|
|
|
PachaFamily est une application web privée de gestion familiale. Développée sans framework lourd (Vanilla JS / PHP Natif), elle garantit des performances optimales, une maintenance simplifiée et une personnalisation totale.
|
|
|
|
## 🌟 Modules & Fonctionnalités
|
|
|
|
### 💰 1. Module Budget (`/modules/budget/`)
|
|
|
|
Gestion asynchrone (SPA-like) des finances de la famille.
|
|
|
|
- **Suivi Mensuel** : Saisie rapide des dépenses avec répartition automatique (Alex/Laia/Commun).
|
|
- **Budget Prévisionnel** : Configuration des salaires, charges fixes, et calcul des restes à vivre. Mode "Calculatrice" flottant intégré.
|
|
- **Épargne** : Suivi des cagnottes par personne et par catégorie (Vacances, Nens, Perso).
|
|
- **Récapitulatif** : Bilan annuel (À venir).
|
|
|
|
### 📅 2. Module Calendrier (`/modules/family-calendar/`)
|
|
|
|
Agenda partagé pour toute la famille.
|
|
|
|
- Affichage des événements et vacances scolaires.
|
|
- Gestion des jours de congés avec compteurs annuels par personne.
|
|
|
|
### 🌴 3. Module Voyages (`/modules/holidays/`)
|
|
|
|
Planificateur de roadtrips et vacances.
|
|
|
|
- **Cartographie** : Intégration de Leaflet.js.
|
|
- **Itinéraires** : Calcul des trajets via OSRM et géocodage via Nominatim.
|
|
- Checkpoints, notes et liaisons directes avec le budget d'épargne.
|
|
|
|
### 🎁 4. Module Cadeaux (`/modules/gift-list/`)
|
|
|
|
Listes de souhaits pour les événements (Noël, Anniversaires, Rois Mages...).
|
|
|
|
---
|
|
|
|
## 🚀 Plan d'Optimisation & Debugging (Roadmap)
|
|
|
|
Cette section trace les étapes pour épurer la dette technique et optimiser l'application.
|
|
|
|
### 🟢 Phase 1 : Quick Wins (Gains rapides)
|
|
|
|
- [x] **Refonte Asynchrone Budget** : Remplacement des formulaires classiques par des appels `fetch()` silencieux sur `suivi.php`, `budget_prev.php` et `epargne.php`.
|
|
- [ ] **Nettoyage des Vues** : Extraire le JavaScript et le CSS encore présents dans les fichiers `.php` vers leurs fichiers `.js` et `.css` dédiés.
|
|
- [ ] **Corrections des liens GET** : Remplacer les `<a href="?action=delete">` par des `<button onclick="deleteItem()">` asynchrones partout.
|
|
|
|
### 🟡 Phase 2 : Robustesse & UX (Effort moyen)
|
|
|
|
- [ ] **Déploiement des Tests E2E** : Étendre `test-engine.js` pour couvrir le Calendrier et les Voyages.
|
|
- [ ] **Uniformisation Mobile** : Vérifier tous les `hover` et `z-index` pour garantir que les actions (édition/suppression) soient cliquables sur écrans tactiles.
|
|
- [ ] **Gestion des Erreurs JSON** : Appliquer systématiquement le `.text()` avant `JSON.parse()` dans les fetchs pour capturer les erreurs PHP (Warnings).
|
|
|
|
### 🔴 Phase 3 : Architecture & Performances (Heavy lifting)
|
|
|
|
- [ ] **Optimisation SQL (N+1)** : Réviser les requêtes du module Calendrier pour réduire le nombre d'appels à la base de données.
|
|
- [ ] **Mise en cache API Map** : Implémenter un système de cache local pour les requêtes OSRM/Nominatim afin d'éviter les limites de requêtes (Rate Limits) sur le module Voyages.
|
|
- [ ] **Routeur PHP Global** : Remplacer la navigation par `?tab=` par un routeur natif centralisé (Front Controller).
|
|
|
|
---
|
|
|
|
## 🏷️ Patch / Versions
|
|
|
|
- **v1.1.0 - Le Grand Bond Asynchrone** (Mai 2026) : Transformation des vues Budget (Prévisionnel & Épargne) en interfaces asynchrones (Fetch API). Création d'un moteur de tests E2E maison (`test-engine.js`). Résolution des conflits de `z-index` sur mobile. Sécurisation des JSON face aux Warnings PHP.
|
|
- **v1.0.0 - MVP Initial** : Mise en place de la structure de base, base de données MariaDB, modules Budget (Suivi), Calendrier, Cadeaux et Voyages (Leaflet).
|