timetrack-pro/plans/implemPlan.md

# TimeTrack Pro - Plan d'Implementation pour Agent

## Informations Critiques

**Fichier cible:** `C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb`

**Prerequis humain:** Le fichier `.accdb` doit exister (base Access vide creee manuellement).

**Outils MCP utilises:**
- `run_access_query` - Execution SQL
- `list_access_tables` - Verification tables
- `get_worksheet_data` - Lecture donnees
- `set_worksheet_data` - Ecriture donnees
- `inject_vba` - Injection modules VBA
- `validate_vba_code` - Validation syntaxe VBA
- `backup_vba` - Sauvegarde fichier

---

## Phase 0 : Verification Prerequis

### Step 0.1 - Verifier existence fichier
```
Action: list_access_tables
Params: file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
```
- **Si erreur "fichier introuvable":** STOP - Demander a l'utilisateur de creer la base Access vide
- **Si succes (meme vide):** Continuer

### Step 0.2 - Creer backup
```
Action: backup_vba
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  action = "create"
```
- Noter le backup_id pour restauration eventuelle

---

## Phase 1 : Creation Structure BDD

### Step 1.1 - Creer table tbl_Clients
```
Action: run_access_query
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sql = "CREATE TABLE tbl_Clients (ClientID AUTOINCREMENT PRIMARY KEY, Nom TEXT(100) NOT NULL, Email TEXT(100), Telephone TEXT(20), Notes MEMO, DateCreation DATETIME DEFAULT Now())"
```
- **Si erreur "table existe deja":** Ignorer et continuer
- **Si autre erreur:** STOP et reporter

### Step 1.2 - Creer table tbl_Projets
```
Action: run_access_query
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sql = "CREATE TABLE tbl_Projets (ProjetID AUTOINCREMENT PRIMARY KEY, ClientID LONG NOT NULL, Nom TEXT(100) NOT NULL, Description MEMO, TauxHoraire CURRENCY DEFAULT 0, Actif YESNO DEFAULT True, DateCreation DATETIME DEFAULT Now())"
```

### Step 1.3 - Creer table tbl_Temps
```
Action: run_access_query
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sql = "CREATE TABLE tbl_Temps (TempsID AUTOINCREMENT PRIMARY KEY, ProjetID LONG NOT NULL, DateEntree DATETIME NOT NULL, Duree DOUBLE NOT NULL, Description MEMO, DateCreation DATETIME DEFAULT Now())"
```
**Note:** Utiliser `DateEntree` au lieu de `Date` (mot reserve SQL)

### Step 1.4 - Verification Checkpoint 1
```
Action: list_access_tables
Params: file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
```
- **Attendu:** 3 tables (tbl_Clients, tbl_Projets, tbl_Temps)
- **Si manquant:** Reprendre les steps 1.1-1.3 pour les tables manquantes

### Step 1.5 - Creer index (optionnel mais recommande)
```
Action: run_access_query (x4)
sql_1 = "CREATE INDEX idx_Projets_ClientID ON tbl_Projets (ClientID)"
sql_2 = "CREATE INDEX idx_Temps_ProjetID ON tbl_Temps (ProjetID)"
sql_3 = "CREATE INDEX idx_Temps_Date ON tbl_Temps (DateEntree)"
sql_4 = "CREATE INDEX idx_Projets_Actif ON tbl_Projets (Actif)"
```
- Ignorer erreurs "index existe deja"

---

## Phase 2 : Insertion Donnees de Test

### Step 2.1 - Inserer Clients
```
Action: set_worksheet_data
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sheet_name = "tbl_Clients"
  columns = ["Nom", "Email", "Telephone", "Notes"]
  mode = "append"
  data = [
    ["Acme Corporation", "contact@acme.com", "01 23 45 67 89", "Client principal"],
    ["Tech Solutions", "info@techsol.fr", "01 98 76 54 32", "Startup tech"],
    ["Freelance Direct", "hello@freelance.io", "", "Plateforme freelance"],
    ["Marketing Pro", "contact@marketingpro.fr", "06 11 22 33 44", "Agence marketing"]
  ]
```

### Step 2.2 - Verifier Clients inseres
```
Action: get_worksheet_data
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sheet_name = "tbl_Clients"
```
- **Attendu:** 4 enregistrements avec ClientID 1-4
- Noter les ClientID pour la suite

### Step 2.3 - Inserer Projets
```
Action: set_worksheet_data
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sheet_name = "tbl_Projets"
  columns = ["ClientID", "Nom", "Description", "TauxHoraire", "Actif"]
  mode = "append"
  data = [
    [1, "Site Web Corporate", "Refonte du site web principal", 75, true],
    [1, "Maintenance Mensuelle", "Support et maintenance", 60, true],
    [2, "API Backend", "Developpement API REST", 85, true],
    [2, "App Mobile", "Application iOS/Android", 90, true],
    [3, "Consulting Tech", "Conseil et accompagnement", 100, true],
    [4, "Campagne SEO", "Optimisation referencement", 70, true]
  ]
```

### Step 2.4 - Verifier Projets inseres
```
Action: get_worksheet_data
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sheet_name = "tbl_Projets"
```
- **Attendu:** 6 enregistrements avec ProjetID 1-6

### Step 2.5 - Inserer Temps
```
Action: set_worksheet_data
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sheet_name = "tbl_Temps"
  columns = ["ProjetID", "DateEntree", "Duree", "Description"]
  mode = "append"
  data = [
    [1, "2025-01-02", 3.5, "Maquettes et wireframes"],
    [1, "2025-01-03", 4.0, "Integration HTML/CSS"],
    [1, "2025-01-06", 5.5, "Developpement pages dynamiques"],
    [2, "2025-01-07", 1.5, "Mise a jour plugins"],
    [2, "2025-01-08", 2.0, "Correction bugs mineurs"],
    [3, "2025-01-02", 6.0, "Architecture et endpoints"],
    [3, "2025-01-03", 7.0, "Implementation CRUD"],
    [3, "2025-01-06", 4.5, "Tests unitaires"],
    [4, "2025-01-07", 5.0, "Setup projet React Native"],
    [4, "2025-01-08", 6.5, "Ecrans principaux"],
    [5, "2025-01-03", 2.0, "Reunion strategie technique"],
    [5, "2025-01-09", 3.0, "Audit architecture existante"],
    [6, "2025-01-06", 4.0, "Analyse mots-cles"],
    [6, "2025-01-08", 3.5, "Optimisation on-page"]
  ]
```

### Step 2.6 - Verification Checkpoint 2
```
Action: get_worksheet_data
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sheet_name = "tbl_Temps"
```
- **Attendu:** 14 enregistrements

### Step 2.7 - Test requete agregation
```
Action: run_access_query
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sql = "SELECT COUNT(*) AS NbTemps, SUM(Duree) AS TotalHeures FROM tbl_Temps"
```
- **Attendu:** NbTemps = 14, TotalHeures = 58.0

---

## Phase 3 : Injection Modules VBA

**Important:** Lire le code de chaque module dans `VBA_MODULES.md` avant injection.

### Step 3.1 - Valider mod_Config
```
Action: validate_vba_code
Params:
  code = "<contenu de mod_Config depuis VBA_MODULES.md>"
  file_type = "excel"
```
- **Si erreurs syntaxe:** Corriger et revalider
- **Si succes:** Continuer

### Step 3.2 - Injecter mod_Config
```
Action: inject_vba
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  module_name = "mod_Config"
  code = "<contenu valide>"
```

### Step 3.3 - Valider et Injecter mod_Utils
```
Action: validate_vba_code puis inject_vba
module_name = "mod_Utils"
```

### Step 3.4 - Valider et Injecter mod_DataAccess
```
Action: validate_vba_code puis inject_vba
module_name = "mod_DataAccess"
```

### Step 3.5 - Valider et Injecter mod_Calculs
```
Action: validate_vba_code puis inject_vba
module_name = "mod_Calculs"
```

### Step 3.6 - Valider et Injecter mod_Navigation
```
Action: validate_vba_code puis inject_vba
module_name = "mod_Navigation"
```

### Step 3.7 - Valider et Injecter mod_Export
```
Action: validate_vba_code puis inject_vba
module_name = "mod_Export"
```

### Step 3.8 - Verification Checkpoint 3
```
Action: list_modules (via extract_vba ou list_macros)
Params: file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
```
- **Attendu:** 6 modules (mod_Config, mod_Utils, mod_DataAccess, mod_Calculs, mod_Navigation, mod_Export)

---

## Phase 4 : Verification Finale

### Step 4.1 - Test requete TempsByClient
```
Action: run_access_query
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sql = "SELECT c.Nom AS Client, SUM(t.Duree) AS TotalHeures FROM (tbl_Clients c INNER JOIN tbl_Projets p ON c.ClientID = p.ClientID) INNER JOIN tbl_Temps t ON p.ProjetID = t.ProjetID GROUP BY c.Nom ORDER BY c.Nom"
```
- **Attendu:** 4 clients avec leurs totaux heures

### Step 4.2 - Test requete ProjetsActifs
```
Action: run_access_query
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sql = "SELECT p.Nom AS Projet, c.Nom AS Client, p.TauxHoraire FROM tbl_Clients c INNER JOIN tbl_Projets p ON c.ClientID = p.ClientID WHERE p.Actif = True"
```
- **Attendu:** 6 projets actifs

### Step 4.3 - Test calcul montant
```
Action: run_access_query
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  sql = "SELECT SUM(t.Duree * p.TauxHoraire) AS MontantTotal FROM tbl_Temps t INNER JOIN tbl_Projets p ON t.ProjetID = p.ProjetID"
```
- **Attendu:** Montant > 0 (calcul taux * heures)

---

## Phase 5 : Post-Implementation (Manuel)

Ces etapes ne sont PAS automatisables par MCP VBA et doivent etre faites dans Access UI :

### 5.1 - Creer Formulaires
- [ ] frm_Accueil - Navigation + stats
- [ ] frm_Clients - CRUD clients
- [ ] frm_Projets - CRUD projets (filtre par client)
- [ ] frm_SaisieTemps - Saisie rapide
- [ ] frm_Historique - Liste filtrable

### 5.2 - Creer Rapports
- [ ] rpt_RecapPeriode - Recap par periode
- [ ] rpt_DetailClient - Detail par client

### 5.3 - Configurer Navigation
- [ ] Formulaire de demarrage
- [ ] Menu principal
- [ ] Boutons de navigation

---

## Resume Checkpoints

| Checkpoint | Verification | Critere Succes |
|------------|--------------|----------------|
| CP0 | Fichier existe | list_access_tables sans erreur |
| CP1 | Tables creees | 3 tables visibles |
| CP2 | Donnees inserees | 4 clients, 6 projets, 14 temps |
| CP3 | Modules VBA | 6 modules injectes |
| CP4 | Requetes OK | Agregations retournent donnees |

---

## Gestion des Erreurs

| Erreur | Action |
|--------|--------|
| "fichier introuvable" | Demander creation manuelle base Access |
| "table existe deja" | Ignorer et continuer |
| "index existe deja" | Ignorer et continuer |
| "erreur syntaxe VBA" | Revoir code, corriger, revalider |
| "Trust access to VBA" | Activer dans Access > Options > Trust Center |
| Autre erreur | STOP, backup_vba restore, reporter |

---

## Commande de Restauration (si besoin)

```
Action: backup_vba
Params:
  file_path = "C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb"
  action = "restore"
  backup_id = "<id du backup cree en Step 0.2>"
```

---

**Auteur:** Claude
**Date:** 2025-12-30
**Version:** 1.0