timetrack-pro/PLAN.md
StillHammer a485651273 Phase 5: Form generator script + import guide
- Add mod_FormBuilder.bas to generate 5 forms programmatically
- Add IMPORT_FORMS.md with step-by-step instructions
- Update PLAN.md and README.md with new progress
- Created 5 empty forms via MCP (to be populated by script)

Run BuildAllForms() in Access VBA to create form controls.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 16:51:25 +07:00

172 lines
4.4 KiB
Markdown

# TimeTrack Pro - Plan de Projet
## 1. Vision
**Objectif:** Outil de suivi des heures par client/projet, propre et fonctionnel, qui demontre la capacite a livrer un produit fini.
**Public cible:** Freelances, petites equipes, usage personnel.
**Differenciateur:** Genere via MCP VBA Server = double vitrine (outil + technologie).
---
## 2. Perimetre V1
### Inclus
| Fonctionnalite | Description |
|----------------|-------------|
| Gestion clients | CRUD complet (Creer, Lire, Modifier, Supprimer) |
| Gestion projets | Lies aux clients, avec taux horaire |
| Saisie temps | Entrees rapides avec date, duree, notes |
| Calculs auto | Totaux par projet, client, periode |
| Rapports | Recapitulatif exportable PDF/Excel |
| Navigation | Interface propre et intuitive |
### Hors Perimetre (V2 eventuelle)
- Multi-utilisateurs
- Facturation automatique
- Synchro cloud / API externe
- Dashboard graphique avance
---
## 3. Modele de Donnees
### Tables
| Table | Champs |
|-------|--------|
| tbl_Clients | ClientID (PK), Nom, Email, Telephone, Notes, DateCreation |
| tbl_Projets | ProjetID (PK), ClientID (FK), Nom, Description, TauxHoraire, Actif, DateCreation |
| tbl_Temps | TempsID (PK), ProjetID (FK), Date, Duree, Description, DateCreation |
### Relations
```
tbl_Clients (1) ──── (N) tbl_Projets
tbl_Projets (1) ──── (N) tbl_Temps
```
---
## 4. Interfaces (Formulaires)
| Formulaire | Fonction |
|------------|----------|
| frm_Accueil | Navigation principale, stats rapides |
| frm_Clients | Liste + ajout/edition clients |
| frm_Projets | Liste + ajout/edition projets (filtrable par client) |
| frm_SaisieTemps | Saisie rapide : date, projet, duree, note |
| frm_Historique | Liste des entrees avec filtres (date, client, projet) |
---
## 5. Rapports
| Rapport | Contenu |
|---------|---------|
| rpt_RecapPeriode | Total heures par projet/client sur une periode choisie |
| rpt_DetailClient | Detail des heures pour un client specifique |
**Export:** PDF ou Excel
---
## 6. Architecture VBA
### Modules
| Module | Responsabilite |
|--------|----------------|
| mod_Config | Constantes, parametres globaux |
| mod_Navigation | Ouverture/fermeture formulaires |
| mod_DataAccess | Fonctions CRUD generiques |
| mod_Calculs | Totaux, moyennes, agregations |
| mod_Export | Generation PDF/Excel |
| mod_Utils | Helpers (dates, validation, formatage) |
### Principes
1. **Pas de code dans les formulaires** (ou minimal)
2. **Nommage explicite:** `GetTotalHeuresByProjet()`, `OpenFormClient()`
3. **Commentaires en-tete** de chaque fonction
4. **Gestion d'erreurs** coherente
---
## 7. Phases de Developpement
| Phase | Contenu | Methode | Duree | Status |
|-------|---------|---------|-------|--------|
| 1 | Structure BDD + relations | MCP VBA | 1h | Done |
| 2 | Donnees de test | MCP VBA | 30min | Done |
| 3 | Modules VBA (6 modules) | MCP VBA | 1h | Done |
| 4 | Requetes SQL | MCP VBA | 30min | Done |
| 5 | Formulaires (5 forms) | Script VBA | 1h | Pret* |
| 6 | Tests + documentation | Manuel | 2h | Done |
*Phase 5: Formulaires prets via mod_FormBuilder.bas - voir docs/IMPORT_FORMS.md
**Total estime:** ~6h
**Progression:** 95% complete
---
## 8. Livrables Finaux
- [x] Fichier `.accdb` fonctionnel
- [x] README avec screenshots (placeholders)
- [x] Code source commente (via MCP VBA)
- [ ] (Bonus) GIF de demo
---
## 9. Criteres de Succes
- [x] L'outil fonctionne sans bugs visibles
- [x] Le code est lisible et structure
- [ ] Un utilisateur peut saisir du temps en < 30 secondes (a valider avec formulaires)
- [ ] Le rapport est exportable et presentable (a valider avec formulaires)
- [ ] Utilisation personnelle (dogfooding)
---
## 10. Stack Technique
| Composant | Technologie |
|-----------|-------------|
| Base de donnees | Microsoft Access (.accdb) |
| Langage | VBA (Visual Basic for Applications) |
| Automatisation | VBA MCP Server v0.6.0 |
| Export | PDF via Access, Excel via VBA |
---
## 11. Approche MCP VBA
### Ce qui sera automatise (MCP)
```
run_access_query → Creation tables, relations, requetes
inject_vba → Tous les modules VBA
get/set_data → Tests et population de donnees
```
### Ce qui sera manuel (Access UI)
```
Formulaires → Design visuel des interfaces
Rapports → Mise en page des rapports
Controles → Positionnement, formatage
```
---
**Auteur:** Alexis Trouve
**Date:** 2025-12-30
**Version:** 1.0