timetrack-pro/CLAUDE.md

TimeTrack Pro - Instructions pour Claude

Projet

TimeTrack Pro - Gestionnaire de temps Access, vitrine du VBA MCP Server.

Status: En attente de developpement

MCP VBA Server

Ce projet utilise VBA MCP Server v0.6.0+ pour l'automatisation.

Outils Disponibles pour Access

Outil	Description	Usage
run_access_query	Execute SQL (SELECT, INSERT, UPDATE, DELETE, CREATE)	Creation tables, requetes
list_access_tables	Liste tables avec schema	Verification structure
list_access_queries	Liste requetes sauvegardees	Voir QueryDefs
get_worksheet_data	Lit donnees d'une table	Lecture avec filtres
set_worksheet_data	Ecrit donnees dans table	Insert mode append/replace
inject_vba	Injecte module VBA	Ajouter les 6 modules
validate_vba	Valide syntaxe VBA	Verifier avant injection
create_backup	Cree backup du fichier	Avant modifications
restore_backup	Restaure depuis backup	En cas d'erreur
list_backups	Liste les backups	Voir historique

Chemin du fichier

C:\Users\alexi\Documents\projects\timetrack-pro\db\TimeTrackPro.accdb

---

Structure du Projet

timetrack-pro/
├── README.md               # Documentation principale
├── PLAN.md                 # Plan projet (6 phases, 12h)
├── DATABASE.md             # Schema BDD complet
├── VBA_MODULES.md          # 6 modules VBA documentes
├── CLAUDE.md               # CE FICHIER
├── db/
│   └── TimeTrackPro.accdb  # Base Access
├── docs/
│   └── MCP_VBA_GUIDE.md    # Guide utilisation MCP
└── scripts/
    ├── 01_create_tables.sql
    ├── 02_create_queries.sql
    ├── 03_sample_data.sql
    └── modules/

---

Workflow de Developpement

Phase 1: Structure BDD (MCP VBA)

# 1. Creer backup si fichier existe
create_backup("db/TimeTrackPro.accdb")

# 2. Creer les tables
run_access_query("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()
    )
""")

run_access_query("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()
    )
""")

run_access_query("db/TimeTrackPro.accdb", sql="""
    CREATE TABLE tbl_Temps (
        TempsID AUTOINCREMENT PRIMARY KEY,
        ProjetID LONG NOT NULL,
        Date DATETIME NOT NULL,
        Duree DOUBLE NOT NULL,
        Description MEMO,
        DateCreation DATETIME DEFAULT Now()
    )
""")

# 3. Verifier
list_access_tables("db/TimeTrackPro.accdb")

Phase 2: Donnees de Test (MCP VBA)

# Inserer clients
run_access_query("db/TimeTrackPro.accdb", sql="""
    INSERT INTO tbl_Clients (Nom, Email, Telephone, Notes)
    VALUES ('Acme Corporation', 'contact@acme.com', '01 23 45 67 89', 'Client principal')
""")

# Ou en batch avec set_worksheet_data
data = [
    ["Acme Corporation", "contact@acme.com", "0123456789", "Client 1"],
    ["Tech Solutions", "info@techsol.fr", "0198765432", "Client 2"],
]
set_worksheet_data("db/TimeTrackPro.accdb", "tbl_Clients", data,
    columns=["Nom", "Email", "Telephone", "Notes"], mode="append")

Phase 3: Modules VBA (MCP VBA)

# Valider puis injecter chaque module
# Le code complet est dans VBA_MODULES.md

validate_vba(code_mod_config, file_type="access")
inject_vba("db/TimeTrackPro.accdb", "mod_Config", code_mod_config)

validate_vba(code_mod_utils, file_type="access")
inject_vba("db/TimeTrackPro.accdb", "mod_Utils", code_mod_utils)

# ... pour chaque module

Phase 4-6: Formulaires et UI (Manuel dans Access)

Les formulaires doivent etre crees dans Access UI:

• frm_Accueil
• frm_Clients
• frm_Projets
• frm_SaisieTemps
• frm_Historique

---

Commandes Rapides

Lire donnees

get_worksheet_data("db/TimeTrackPro.accdb", "tbl_Clients")
get_worksheet_data("db/TimeTrackPro.accdb", "tbl_Temps", where_clause="Date > #2025-01-01#")

Executer requete

run_access_query("db/TimeTrackPro.accdb", sql="SELECT * FROM tbl_Projets WHERE Actif = True")
run_access_query("db/TimeTrackPro.accdb", query_name="qry_TempsByClient")

Ajouter entree temps

run_access_query("db/TimeTrackPro.accdb", sql="""
    INSERT INTO tbl_Temps (ProjetID, Date, Duree, Description)
    VALUES (1, #2025-01-15#, 3.5, 'Travail effectue')
""")

Modifier donnees

run_access_query("db/TimeTrackPro.accdb", sql="""
    UPDATE tbl_Projets SET TauxHoraire = 80 WHERE ProjetID = 1
""")

Supprimer donnees

run_access_query("db/TimeTrackPro.accdb", sql="""
    DELETE FROM tbl_Temps WHERE TempsID = 5
""")

---

Limitations MCP VBA

Ce qui marche	Ce qui ne marche pas
CREATE/ALTER TABLE	Creer formulaires
INSERT/UPDATE/DELETE	Creer rapports
Injection VBA modules	Creer macros Access (UI)
Lecture/ecriture donnees	Design visuel
Requetes SQL	Slicers/filtres visuels

---

Fichiers Cles

Fichier	Quand l'utiliser
scripts/01_create_tables.sql	Creer la structure
scripts/03_sample_data.sql	Peupler avec donnees test
VBA_MODULES.md	Code VBA a injecter
DATABASE.md	Reference schema
docs/MCP_VBA_GUIDE.md	Guide etape par etape

---

Contact

Alexis Trouve - alexistrouve.pro@gmail.com