# 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

- [x] Gestion clients (CRUD)
- [x] Gestion projets (lies aux clients)
- [x] Saisie des entrees de temps
- [x] Calcul automatique des totaux
- [x] Rapport recapitulatif exportable
- [x] Interface propre et navigable
- [x] 6 modules VBA injectes
- [x] 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**
   ```bash
   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)

```python
# 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
![Accueil](docs/screenshots/accueil.png)

### Saisie de temps
![Saisie](docs/screenshots/saisie.png)

### Rapport recapitulatif
![Rapport](docs/screenshots/rapport.png)

---

## 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](https://github.com/alexistrouve)

---

## License

Proprietary - Demo Project

---

## Changelog

Voir [CHANGELOG.md](CHANGELOG.md) pour l'historique des versions.