StillHammer
317ca0904a
Documentation: - CHANGELOG.md: v0.1.0 Initial Release - README.md: Stats, installation, utilisation mise a jour - PLAN.md: Status phases actualise (85% complete) - docs/TEST_CHECKLIST.md: 61 tests manuels Guide Formulaires: - docs/FORMS_GUIDE.md: Guide complet creation formulaires Access - 5 formulaires principaux (Accueil, Clients, Projets, SaisieTemps, Historique) - 2 formulaires popup (ProjetDetail, TempsDetail) - Code VBA complet pour chaque formulaire - 800+ lignes de documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
201 lines
4.3 KiB
Markdown
201 lines
4.3 KiB
Markdown
# 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
|
|
|
|
|
|
### 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](https://github.com/alexistrouve)
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
Proprietary - Demo Project
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
Voir [CHANGELOG.md](CHANGELOG.md) pour l'historique des versions.
|