timetrack-pro/README.md

TimeTrack Pro

Gestionnaire de temps Access - Vitrine MCP VBA Server

Vision

Outil de suivi des heures par client/projet, propre et fonctionnel, qui demontre la capacite a livrer un produit fini via MCP VBA.

Public cible: Freelances, petites equipes Differenciateur: Genere via MCP VBA Server v0.6.0+

---

Statistiques Actuelles

Metrique	Valeur
Clients	4
Projets	6
Heures totales	58h
Montant total	4 732,50 EUR

---

Status du Projet

Phase	Description	Status
1	Structure BDD + relations	Done
2	Formulaires de base (CRUD)	Done
3	Saisie temps + calculs	Done
4	Rapports + export	Done
5	UI polish + navigation	Manuel (Access UI)
6	Tests + documentation	En cours

Progression globale: 85% - En phase finale

---

Fonctionnalites V1

• Gestion clients (CRUD)
• Gestion projets (lies aux clients)
• Saisie des entrees de temps
• Calcul automatique des totaux
• Rapport recapitulatif exportable
• Interface propre et navigable
• 6 modules VBA injectes
• Donnees de demonstration

---

Hors Perimetre (V2)

• Multi-utilisateurs
• Facturation automatique
• Synchro cloud / API
• Dashboard graphique avance

---

Installation

Prerequis

• Microsoft Access 2016+ (ou Office 365)
• VBA MCP Server v0.6.0+ (pour developpement)

Installation Rapide

1. Cloner le projet

   git clone https://github.com/alexistrouve/timetrack-pro.git
   

2. Ouvrir la base de donnees

   db/TimeTrackPro.accdb
   

3. Activer les macros si demande

4. Utiliser l'application

   • Le formulaire principal s'ouvre automatiquement
   • Naviguer via les boutons du menu

Installation depuis zero (MCP VBA)

# 1. Creer les tables
run_access_query("db/TimeTrackPro.accdb", sql="CREATE TABLE ...")

# 2. Injecter les modules VBA
inject_vba("db/TimeTrackPro.accdb", "mod_Config", code)

# 3. Ajouter les donnees de test
set_worksheet_data("db/TimeTrackPro.accdb", "tbl_Clients", data)

# 4. Creer les formulaires manuellement dans Access UI

Voir docs/MCP_VBA_GUIDE.md pour le guide complet.

---

Utilisation

Saisir du temps

1. Ouvrir le formulaire Saisie Temps
2. Selectionner le projet
3. Entrer la date, duree et description
4. Cliquer Enregistrer

Voir les rapports

1. Ouvrir le formulaire Historique
2. Filtrer par client/projet/periode
3. Exporter en PDF ou Excel

Gerer les clients/projets

• Utiliser les formulaires Clients et Projets
• CRUD complet disponible

---

Structure du Projet

timetrack-pro/
├── README.md               # Ce fichier
├── PLAN.md                 # Plan de projet detaille
├── DATABASE.md             # Schema de base de donnees
├── VBA_MODULES.md          # Documentation modules VBA
├── CHANGELOG.md            # Historique des versions
├── CLAUDE.md               # Instructions pour Claude
├── db/
│   └── TimeTrackPro.accdb  # Base Access principale
├── docs/
│   ├── MCP_VBA_GUIDE.md    # Guide utilisation MCP
│   └── TEST_CHECKLIST.md   # Checklist de tests
└── scripts/
    ├── 01_create_tables.sql
    ├── 02_create_queries.sql
    ├── 03_sample_data.sql
    └── modules/
        ├── mod_Config.bas
        ├── mod_Navigation.bas
        ├── mod_DataAccess.bas
        ├── mod_Calculs.bas
        ├── mod_Export.bas
        └── mod_Utils.bas

---

Screenshots

Section a completer avec captures d'ecran de l'application

Formulaire d'accueil

Saisie de temps

Rapport recapitulatif

---

Technologies

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

---

Auteur

Alexis Trouve

• Email: alexistrouve.pro@gmail.com
• GitHub: @alexistrouve

---

License

Proprietary - Demo Project

---

Changelog

Voir CHANGELOG.md pour l'historique des versions.