StillHammer
8634badd51
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
209 lines
4.6 KiB
Markdown
209 lines
4.6 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 | Donnees de test | Done |
|
|
| 3 | Modules VBA (6 modules, 715 lignes) | Done |
|
|
| 4 | Requetes SQL | Done |
|
|
| 5 | Formulaires (5 forms via script) | Done |
|
|
| 6 | Tests + documentation | Done |
|
|
|
|
**Progression globale:** 100% - Complet
|
|
|
|
---
|
|
|
|
## 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://git.etheryale.com/StillHammer/timetrack-pro.git
|
|
```
|
|
|
|
2. **Ouvrir la base de donnees**
|
|
```
|
|
db/TimeTrackPro.accdb
|
|
```
|
|
|
|
3. **Activer les macros** si demande
|
|
|
|
4. **Generer les formulaires** (premiere utilisation)
|
|
- Ouvrir l'editeur VBA: `Alt + F11`
|
|
- Importer: Fichier > Importer > `scripts/modules/mod_FormBuilder.bas`
|
|
- Executer: `Ctrl + G`, taper `BuildAllForms`, Entree
|
|
- Voir `docs/IMPORT_FORMS.md` pour details
|
|
|
|
5. **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
|
|
├── db/
|
|
│ └── TimeTrackPro.accdb # Base Access principale
|
|
├── src/ # Code source (lisible sur GitHub)
|
|
│ ├── mod_Config.bas
|
|
│ ├── mod_Navigation.bas
|
|
│ ├── mod_DataAccess.bas
|
|
│ ├── mod_Calculs.bas
|
|
│ ├── mod_Export.bas
|
|
│ ├── mod_Utils.bas
|
|
│ ├── mod_FormBuilder.bas
|
|
│ └── forms/
|
|
│ └── frm_Accueil.txt
|
|
├── docs/
|
|
│ ├── MCP_VBA_GUIDE.md # Guide utilisation MCP
|
|
│ └── IMPORT_FORMS.md # Guide import formulaires
|
|
└── scripts/
|
|
├── 01_create_tables.sql
|
|
├── 02_create_queries.sql
|
|
└── 03_sample_data.sql
|
|
```
|
|
|
|
---
|
|
|
|
## 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
|
|
|
|
MIT License - See [LICENSE](LICENSE)
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
Voir [CHANGELOG.md](CHANGELOG.md) pour l'historique des versions.
|