diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..db489bb --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,263 @@ +# Freelance Dashboard - Instructions pour Claude + +## Projet + +Freelance Dashboard - Dashboard KPI Excel pour suivi d'activite freelance. + +## Status: En attente de developpement + +## MCP VBA Server + +Ce projet utilise **VBA MCP Server v0.6.0+** pour l'automatisation. + +### Outils Disponibles pour Excel + +| Outil | Description | Usage | +|-------|-------------|-------| +| `get_worksheet_data` | Lit donnees d'une feuille | Lecture donnees | +| `set_worksheet_data` | Ecrit donnees/formules | Peupler tables, KPIs | +| `list_excel_tables` | Liste les Excel Tables | Verifier structure | +| `create_excel_table` | Cree table structuree | Tables donnees | +| `insert_rows` | Insere lignes | Ajouter entrees | +| `delete_rows` | Supprime lignes | Nettoyer donnees | +| `insert_columns` | Insere colonnes | Modifier structure | +| `delete_columns` | Supprime colonnes | Modifier structure | +| `inject_vba` | Injecte module VBA | Macro refresh | +| `validate_vba` | Valide syntaxe VBA | Verifier code | +| `run_macro` | Execute macro VBA | Lancer refresh | +| `open_in_office` | Ouvre Excel visible | Voir resultat | +| `create_backup` | Cree backup fichier | Avant modifications | + +### Chemin du fichier + +``` +C:\Users\alexi\Documents\projects\freelance-dashboard\templates\FreelanceDashboard.xlsx +``` + +--- + +## Structure du Projet + +``` +freelance-dashboard/ +├── README.md # Documentation principale +├── PLAN.md # Plan projet (7 phases, 9h) +├── DATA_MODEL.md # Schema des 3 tables +├── FORMULAS.md # Toutes les formules Excel +├── CLAUDE.md # CE FICHIER +├── docs/ +│ └── MCP_VBA_GUIDE.md # Guide utilisation MCP +├── templates/ +│ └── FreelanceDashboard.xlsx +└── scripts/ +``` + +--- + +## Workflow de Developpement + +### Phase 1: Structure Fichier (MCP VBA) + +```python +# Creer les donnees clients +data_clients = [ + ["ClientID", "Nom", "Secteur", "DateDebut"], + ["CLI001", "Acme Corporation", "Tech", "15/01/2024"], + ["CLI002", "Tech Solutions", "Tech", "01/03/2024"], + ["CLI003", "Marketing Pro", "Marketing", "10/06/2024"], + ["CLI004", "E-Shop Plus", "E-commerce", "22/09/2024"], + ["CLI005", "Finance Group", "Finance", "05/11/2024"], +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Clients", data_clients) + +# Creer la table structuree +create_excel_table("templates/FreelanceDashboard.xlsx", "Data_Clients", "A1:D6", "tbl_Clients", has_headers=True) +``` + +```python +# Creer les donnees temps +data_temps = [ + ["Date", "ClientID", "Projet", "Heures", "Description"], + ["02/01/2025", "CLI001", "Site Web", 3.5, "Maquettes"], + ["02/01/2025", "CLI002", "API Backend", 6.0, "Endpoints"], + ["03/01/2025", "CLI001", "Site Web", 4.0, "Integration"], + ["03/01/2025", "CLI003", "Campagne SEO", 2.5, "Audit"], + ["06/01/2025", "CLI002", "API Backend", 7.0, "Tests"], + # ... plus de donnees +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Temps", data_temps) +create_excel_table("templates/FreelanceDashboard.xlsx", "Data_Temps", "A1:E11", "tbl_Temps", has_headers=True) +``` + +```python +# Creer les donnees revenus +data_revenus = [ + ["Date", "ClientID", "Montant", "Type"], + ["15/01/2025", "CLI001", 2500, "Facture"], + ["20/01/2025", "CLI002", 4200, "Facture"], + ["25/01/2025", "CLI003", 1800, "Facture"], + # ... plus de donnees +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Revenus", data_revenus) +create_excel_table("templates/FreelanceDashboard.xlsx", "Data_Revenus", "A1:D8", "tbl_Revenus", has_headers=True) +``` + +### Phase 2: Formules KPIs (MCP VBA) + +```python +# Ecrire les KPIs sur l'onglet Dashboard +kpis = [ + ["CA Total", "=SUM(tbl_Revenus[Montant])"], + ["Heures Totales", "=SUM(tbl_Temps[Heures])"], + ["Taux Horaire Moyen", "=B1/B2"], + ["Nb Clients", "=COUNTA(tbl_Clients[ClientID])"], + ["Heures Semaine", "=SUMIFS(tbl_Temps[Heures],tbl_Temps[Date],\">=\"&TODAY()-WEEKDAY(TODAY(),2)+1)"], +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Dashboard", kpis, start_cell="A1") +``` + +### Phase 3-5: TCD, Graphiques, Design (Excel UI) + +Ces elements doivent etre crees dans Excel UI: +- Tableaux Croises Dynamiques +- Graphiques (barres, camembert, combo) +- Slicers +- Mise en forme conditionnelle +- Layout final + +### Phase 6: VBA Refresh (MCP VBA - Optionnel) + +```python +code = ''' +Sub RefreshDashboard() + Application.CalculateFull + Dim ws As Worksheet + For Each ws In ThisWorkbook.Worksheets + Dim pt As PivotTable + For Each pt In ws.PivotTables + pt.RefreshTable + Next pt + Next ws + MsgBox "Dashboard actualise!", vbInformation +End Sub +''' +validate_vba(code, file_type="excel") +inject_vba("templates/FreelanceDashboard.xlsm", "mod_Refresh", code) +``` + +--- + +## Commandes Rapides + +### Lire donnees + +```python +get_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Clients") +get_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Temps") +``` + +### Ajouter entree temps + +```python +# Ajouter une ligne +insert_rows("templates/FreelanceDashboard.xlsx", "Data_Temps", position=12, count=1) +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Temps", + [["10/01/2025", "CLI001", "Nouveau Projet", 2.5, "Description"]], + start_cell="A12") +``` + +### Lister les tables + +```python +list_excel_tables("templates/FreelanceDashboard.xlsx") +``` + +### Ouvrir pour voir + +```python +open_in_office("templates/FreelanceDashboard.xlsx") +``` + +### Executer macro + +```python +run_macro("templates/FreelanceDashboard.xlsm", "RefreshDashboard") +``` + +--- + +## Limitations MCP VBA + +| Ce qui marche | Ce qui ne marche pas | +|---------------|---------------------| +| Ecrire donnees | Creer TCD | +| Creer Excel Tables | Creer graphiques | +| Ecrire formules | Design visuel | +| Injecter VBA | Creer slicers | +| Executer macros | Mise en forme conditionnelle | + +--- + +## Lien avec TimeTrack Pro + +``` +TimeTrack Pro (Access) Freelance Dashboard (Excel) + │ │ + │ get_worksheet_data │ + └──────────────────────────►│ + Export donnees +``` + +### Export manuel + +1. Lire donnees Access: `get_worksheet_data("TimeTrackPro.accdb", "tbl_Temps")` +2. Ecrire dans Excel: `set_worksheet_data("FreelanceDashboard.xlsx", "Data_Temps", data)` + +### Macro d'import (V2) + +```vba +Sub ImportFromTimeTrack() + ' Connexion ADODB vers TimeTrackPro.accdb + ' Import automatique des donnees +End Sub +``` + +--- + +## Fichiers Cles + +| Fichier | Quand l'utiliser | +|---------|------------------| +| `DATA_MODEL.md` | Schema tables + donnees demo | +| `FORMULAS.md` | Toutes les formules KPIs | +| `PLAN.md` | Layout, couleurs, phases | +| `docs/MCP_VBA_GUIDE.md` | Guide etape par etape | + +--- + +## Design + +### Palette Couleurs + +| Usage | Hex | +|-------|-----| +| Primaire (bleu fonce) | #2C3E50 | +| Accent (vert) | #27AE60 | +| Neutre (gris) | #ECF0F1 | +| Alerte (rouge) | #E74C3C | + +### KPIs a afficher + +- CA Total +- CA Mois en cours +- Heures totales +- Taux horaire moyen +- Nb clients actifs +- Top client +- Heures semaine + +--- + +## Contact + +Alexis Trouve - alexistrouve.pro@gmail.com diff --git a/DATA_MODEL.md b/DATA_MODEL.md new file mode 100644 index 0000000..58b0744 --- /dev/null +++ b/DATA_MODEL.md @@ -0,0 +1,203 @@ +# Freelance Dashboard - Modele de Donnees + +## Vue d'ensemble + +``` +┌─────────────────┐ +│ Data_Clients │ +├─────────────────┤ +│ ClientID (PK) │◄──────┐ +│ Nom │ │ +│ Secteur │ │ +│ DateDebut │ │ +└─────────────────┘ │ + │ +┌─────────────────┐ │ ┌─────────────────┐ +│ Data_Temps │ │ │ Data_Revenus │ +├─────────────────┤ │ ├─────────────────┤ +│ Date │ │ │ Date │ +│ ClientID (FK) │───────┼───────│ ClientID (FK) │ +│ Projet │ │ │ Montant │ +│ Heures │ │ │ Type │ +│ Description │ │ └─────────────────┘ +└─────────────────┘ │ + │ + Relations +``` + +--- + +## Table: Data_Clients + +Liste des clients avec informations de base. + +| Colonne | Type | Format | Exemple | Validation | +|---------|------|--------|---------|------------| +| ClientID | Texte | CLI### | CLI001 | Unique, requis | +| Nom | Texte | - | Acme Corp | Requis | +| Secteur | Texte | - | Tech | Liste deroulante | +| DateDebut | Date | jj/mm/aaaa | 15/01/2024 | Date valide | + +### Secteurs suggeres + +- Tech +- Marketing +- Finance +- E-commerce +- Industrie +- Services +- Autre + +### Donnees de demo + +| ClientID | Nom | Secteur | DateDebut | +|----------|-----|---------|-----------| +| CLI001 | Acme Corporation | Tech | 15/01/2024 | +| CLI002 | Tech Solutions | Tech | 01/03/2024 | +| CLI003 | Marketing Pro | Marketing | 10/06/2024 | +| CLI004 | E-Shop Plus | E-commerce | 22/09/2024 | +| CLI005 | Finance Group | Finance | 05/11/2024 | + +--- + +## Table: Data_Temps + +Entrees de temps par projet et client. + +| Colonne | Type | Format | Exemple | Validation | +|---------|------|--------|---------|------------| +| Date | Date | jj/mm/aaaa | 15/12/2024 | Date valide | +| ClientID | Texte | CLI### | CLI001 | Liste clients | +| Projet | Texte | - | Site Web | Requis | +| Heures | Nombre | 0.00 | 3.50 | > 0, <= 24 | +| Description | Texte | - | Maquettes | Optionnel | + +### Donnees de demo + +| Date | ClientID | Projet | Heures | Description | +|------|----------|--------|--------|-------------| +| 02/01/2025 | CLI001 | Site Web | 3.5 | Maquettes | +| 02/01/2025 | CLI002 | API Backend | 6.0 | Endpoints | +| 03/01/2025 | CLI001 | Site Web | 4.0 | Integration | +| 03/01/2025 | CLI003 | Campagne SEO | 2.5 | Audit | +| 06/01/2025 | CLI002 | API Backend | 7.0 | Tests | +| 06/01/2025 | CLI004 | Boutique | 5.0 | Setup | +| 07/01/2025 | CLI001 | Maintenance | 1.5 | Updates | +| 08/01/2025 | CLI003 | Campagne SEO | 3.0 | Keywords | +| 08/01/2025 | CLI005 | Dashboard | 4.5 | Design | +| 09/01/2025 | CLI002 | App Mobile | 6.5 | Screens | + +--- + +## Table: Data_Revenus + +Paiements recus des clients. + +| Colonne | Type | Format | Exemple | Validation | +|---------|------|--------|---------|------------| +| Date | Date | jj/mm/aaaa | 31/12/2024 | Date valide | +| ClientID | Texte | CLI### | CLI001 | Liste clients | +| Montant | Nombre | # ##0.00 € | 2500.00 | > 0 | +| Type | Texte | - | Facture | Liste deroulante | + +### Types de paiement + +- Facture +- Acompte +- Avoir +- Autre + +### Donnees de demo + +| Date | ClientID | Montant | Type | +|------|----------|---------|------| +| 15/01/2025 | CLI001 | 2500.00 | Facture | +| 20/01/2025 | CLI002 | 4200.00 | Facture | +| 25/01/2025 | CLI003 | 1800.00 | Facture | +| 28/01/2025 | CLI001 | 1000.00 | Acompte | +| 31/01/2025 | CLI004 | 3500.00 | Facture | +| 05/02/2025 | CLI002 | 2800.00 | Facture | +| 10/02/2025 | CLI005 | 1500.00 | Acompte | + +--- + +## Table: Config + +Parametres de configuration du dashboard. + +| Parametre | Valeur | Description | +|-----------|--------|-------------| +| AnneeCourante | 2025 | Annee par defaut pour filtres | +| TauxHoraireDefaut | 75 | Taux horaire par defaut (euros) | +| DevisePrincipale | EUR | Devise affichee | +| JourDebutSemaine | 2 | 1=Dim, 2=Lun | +| ObjectifMensuel | 10000 | Objectif CA mensuel | +| ObjectifHeures | 140 | Objectif heures/mois | + +--- + +## Plages Nommees + +| Nom | Plage | Description | +|-----|-------|-------------| +| tbl_Clients | Data_Clients[#All] | Table clients | +| tbl_Temps | Data_Temps[#All] | Table temps | +| tbl_Revenus | Data_Revenus[#All] | Table revenus | +| lst_ClientIDs | Data_Clients[ClientID] | Liste ClientID | +| lst_Secteurs | Config!$E$2:$E$8 | Liste secteurs | +| lst_Types | Config!$G$2:$G$5 | Liste types paiement | + +--- + +## Formules de Validation + +### ClientID (Data_Temps, Data_Revenus) + +``` +=COUNTIF(Data_Clients[ClientID], [@ClientID]) > 0 +``` + +### Heures (Data_Temps) + +``` +=AND([@Heures] > 0, [@Heures] <= 24) +``` + +### Montant (Data_Revenus) + +``` +=[@Montant] > 0 +``` + +--- + +## Colonnes Calculees (optionnel) + +### Data_Temps - Mois + +``` +=TEXT([@Date], "mmmm yyyy") +``` + +### Data_Temps - Semaine + +``` +=WEEKNUM([@Date], 2) +``` + +### Data_Temps - NomClient + +``` +=VLOOKUP([@ClientID], Data_Clients, 2, FALSE) +``` + +### Data_Revenus - NomClient + +``` +=VLOOKUP([@ClientID], Data_Clients, 2, FALSE) +``` + +--- + +**Version:** 1.0 +**Date:** 2025-12-30 diff --git a/FORMULAS.md b/FORMULAS.md new file mode 100644 index 0000000..105a6e3 --- /dev/null +++ b/FORMULAS.md @@ -0,0 +1,348 @@ +# Freelance Dashboard - Formules et KPIs + +## Vue d'ensemble + +Toutes les formules utilisees dans le dashboard pour calculer les KPIs. + +--- + +## 1. KPIs Principaux + +### CA Total (periode selectionnee) + +```excel +=SUMIFS( + Data_Revenus[Montant], + Data_Revenus[Date], ">=" & DateDebut, + Data_Revenus[Date], "<=" & DateFin +) +``` + +**Avec slicer client:** +```excel +=SUMIFS( + Data_Revenus[Montant], + Data_Revenus[Date], ">=" & DateDebut, + Data_Revenus[Date], "<=" & DateFin, + Data_Revenus[ClientID], ClientFiltre +) +``` + +--- + +### CA Mois en Cours + +```excel +=SUMIFS( + Data_Revenus[Montant], + Data_Revenus[Date], ">=" & EOMONTH(TODAY(), -1) + 1, + Data_Revenus[Date], "<=" & EOMONTH(TODAY(), 0) +) +``` + +**Version simplifiee:** +```excel +=SUMPRODUCT( + (MONTH(Data_Revenus[Date]) = MONTH(TODAY())) * + (YEAR(Data_Revenus[Date]) = YEAR(TODAY())) * + Data_Revenus[Montant] +) +``` + +--- + +### Heures Totales (periode) + +```excel +=SUMIFS( + Data_Temps[Heures], + Data_Temps[Date], ">=" & DateDebut, + Data_Temps[Date], "<=" & DateFin +) +``` + +--- + +### Taux Horaire Moyen + +```excel +=IFERROR( + SUMIFS(Data_Revenus[Montant], ...) / SUMIFS(Data_Temps[Heures], ...), + 0 +) +``` + +**Format:** `# ##0.00 "€/h"` + +--- + +### Nombre Clients Actifs + +```excel +=SUMPRODUCT( + (COUNTIFS( + Data_Temps[ClientID], Data_Clients[ClientID], + Data_Temps[Date], ">=" & DateDebut, + Data_Temps[Date], "<=" & DateFin + ) > 0) * 1 +) +``` + +**Alternative avec UNIQUE (Excel 365):** +```excel +=COUNTA(UNIQUE( + FILTER( + Data_Temps[ClientID], + (Data_Temps[Date] >= DateDebut) * (Data_Temps[Date] <= DateFin) + ) +)) +``` + +--- + +### Top Client (par CA) + +```excel +=INDEX( + Data_Clients[Nom], + MATCH( + MAX( + SUMIFS( + Data_Revenus[Montant], + Data_Revenus[ClientID], Data_Clients[ClientID] + ) + ), + SUMIFS( + Data_Revenus[Montant], + Data_Revenus[ClientID], Data_Clients[ClientID] + ), + 0 + ) +) +``` + +**Avec XLOOKUP (Excel 365):** +```excel +=LET( + clients, Data_Clients[ClientID], + noms, Data_Clients[Nom], + ca, SUMIFS(Data_Revenus[Montant], Data_Revenus[ClientID], clients), + maxCA, MAX(ca), + topClient, XLOOKUP(maxCA, ca, noms, "N/A"), + topClient +) +``` + +--- + +### Heures Cette Semaine + +```excel +=SUMIFS( + Data_Temps[Heures], + Data_Temps[Date], ">=" & TODAY() - WEEKDAY(TODAY(), 2) + 1, + Data_Temps[Date], "<=" & TODAY() - WEEKDAY(TODAY(), 2) + 7 +) +``` + +--- + +## 2. Formules pour Graphiques + +### CA par Mois (12 derniers mois) + +**Tableau helper:** + +| Mois | CA | +|------|-----| +| =EOMONTH(TODAY(),-11) | =SUMPRODUCT((MONTH(Data_Revenus[Date])=MONTH(A2))*(YEAR(Data_Revenus[Date])=YEAR(A2))*Data_Revenus[Montant]) | +| ... | ... | + +**Avec SEQUENCE (Excel 365):** +```excel +=LET( + mois, SEQUENCE(12, 1, EOMONTH(TODAY(), -11) + 1, 30), + ca, SUMPRODUCT( + (MONTH(Data_Revenus[Date]) = MONTH(mois)) * + (YEAR(Data_Revenus[Date]) = YEAR(mois)) * + Data_Revenus[Montant] + ), + HSTACK(TEXT(mois, "mmm yy"), ca) +) +``` + +--- + +### Repartition CA par Client + +```excel +=SUMIFS( + Data_Revenus[Montant], + Data_Revenus[ClientID], Data_Clients[@ClientID] +) +``` + +**Pourcentage:** +```excel +=[@CA] / SUM([CA]) +``` + +--- + +### Heures par Semaine (8 dernieres semaines) + +```excel +=SUMIFS( + Data_Temps[Heures], + Data_Temps[Date], ">=" & DebutSemaine, + Data_Temps[Date], "<=" & FinSemaine +) +``` + +--- + +## 3. Formules de Mise en Forme Conditionnelle + +### KPI CA - Vert si objectif atteint + +**Condition:** `=B2 >= Config!$C$5` + +- Vert (#27AE60) si >= objectif +- Orange (#F39C12) si >= 80% objectif +- Rouge (#E74C3C) si < 80% + +--- + +### Heures - Barre de progression + +**Formule:** `=[@Heures] / 8` (sur une journee de 8h) + +--- + +### Evolution - Fleche haut/bas + +```excel +=IF([@CA] > [@CA_Precedent], "↑", IF([@CA] < [@CA_Precedent], "↓", "→")) +``` + +--- + +## 4. Formules Utilitaires + +### Premier jour du mois + +```excel +=EOMONTH(TODAY(), -1) + 1 +``` + +### Dernier jour du mois + +```excel +=EOMONTH(TODAY(), 0) +``` + +### Premier jour de la semaine (lundi) + +```excel +=TODAY() - WEEKDAY(TODAY(), 2) + 1 +``` + +### Numero de semaine + +```excel +=WEEKNUM([@Date], 2) +``` + +### Nom du mois en francais + +```excel +=TEXT([@Date], "mmmm") +``` + +--- + +## 5. Tableau Croise Dynamique - Champs Calcules + +### Taux Horaire + +``` += Montant / Heures +``` + +### CA Journalier Moyen + +``` += Montant / COUNTA(Date) +``` + +### Heures par Jour Ouvre + +``` += Heures / NETWORKDAYS(MIN(Date), MAX(Date)) +``` + +--- + +## 6. Validation des Donnees + +### Liste deroulante ClientID + +``` +Source: =INDIRECT("Data_Clients[ClientID]") +``` + +### Liste deroulante Type + +``` +Source: Facture,Acompte,Avoir,Autre +``` + +### Heures (entre 0.25 et 24) + +``` +Validation: Decimal +Minimum: 0.25 +Maximum: 24 +Message: "Entrez un nombre d'heures entre 0.25 et 24" +``` + +--- + +## 7. Exemples de Cellules Dashboard + +### Cellule KPI - CA Total + +``` +Cellule: D4 +Formule: =SUMIFS(Data_Revenus[Montant], Data_Revenus[Date], ">="&$B$2, Data_Revenus[Date], "<="&$B$3) +Format: # ##0 "€" +Police: Calibri 28pt Bold +Couleur: #2C3E50 +``` + +### Cellule KPI - Variation + +``` +Cellule: D5 +Formule: =D4 - CA_Mois_Precedent +Format: +# ##0 "€";-# ##0 "€" +Couleur: Vert si positif, Rouge si negatif +``` + +--- + +## 8. Raccourcis Formules + +| Besoin | Formule courte | +|--------|----------------| +| CA total | `=SUM(Data_Revenus[Montant])` | +| Heures total | `=SUM(Data_Temps[Heures])` | +| Nb clients | `=COUNTA(Data_Clients[ClientID])` | +| Nb projets uniques | `=COUNTA(UNIQUE(Data_Temps[Projet]))` | +| Date min | `=MIN(Data_Temps[Date])` | +| Date max | `=MAX(Data_Temps[Date])` | + +--- + +**Version:** 1.0 +**Date:** 2025-12-30 diff --git a/PLAN.md b/PLAN.md new file mode 100644 index 0000000..c6c36b5 --- /dev/null +++ b/PLAN.md @@ -0,0 +1,230 @@ +# Freelance Dashboard - Plan de Projet + +Dashboard KPI Excel - Suivi d'activite freelance + +--- + +## 1. Vision + +**Objectif:** Dashboard visuel pour suivre son activite freelance (temps, revenus, clients) en un coup d'oeil. + +**Public cible:** Freelances, independants, usage personnel. + +**Lien portfolio:** Complementaire a TimeTrack Pro (Access = saisie, Excel = visualisation). + +--- + +## 2. Perimetre V1 + +### Inclus + +| Fonctionnalite | Description | +|----------------|-------------| +| Saisie donnees | Heures, revenus, clients | +| KPIs principaux | CA, heures, taux horaire moyen | +| Graphiques | Dynamiques et interactifs | +| Filtres | Periode, client, projet | +| Design pro | Moderne, pret a montrer | + +### Hors Perimetre (V2 eventuelle) + +- Connexion automatique a Access/TimeTrack +- Previsionnel / objectifs +- Multi-devises +- Macros VBA complexes + +--- + +## 3. Structure du Fichier + +| Onglet | Contenu | Type | +|--------|---------|------| +| **Dashboard** | Vue principale avec KPIs et graphiques | Affichage | +| **Data_Temps** | Table des entrees de temps (source) | Donnees | +| **Data_Revenus** | Table des paiements recus | Donnees | +| **Data_Clients** | Liste clients avec infos | Donnees | +| **Config** | Parametres (annee, taux par defaut) | Parametres | + +--- + +## 4. Modele de Donnees + +### Data_Clients + +| Champ | Type | Description | +|-------|------|-------------| +| ClientID | Texte | Identifiant unique (ex: CLI001) | +| Nom | Texte | Nom du client | +| Secteur | Texte | Secteur d'activite | +| DateDebut | Date | Date debut collaboration | + +### Data_Temps + +| Champ | Type | Description | +|-------|------|-------------| +| Date | Date | Date de l'entree | +| ClientID | Texte | Reference client | +| Projet | Texte | Nom du projet | +| Heures | Nombre | Duree en heures | +| Description | Texte | Description du travail | + +### Data_Revenus + +| Champ | Type | Description | +|-------|------|-------------| +| Date | Date | Date du paiement | +| ClientID | Texte | Reference client | +| Montant | Nombre | Montant en euros | +| Type | Texte | Facture / Acompte | + +--- + +## 5. KPIs a Afficher + +| KPI | Calcul | Formule Excel | +|-----|--------|---------------| +| **CA Total** | Somme revenus (periode) | `=SUMIFS(...)` | +| **CA Mois en cours** | Somme revenus (mois) | `=SUMIFS(...,MONTH()=...)` | +| **Heures totales** | Somme heures (periode) | `=SUMIFS(...)` | +| **Taux horaire moyen** | CA / Heures | `=CA/Heures` | +| **Nb clients actifs** | Clients avec heures > 0 | `=COUNTIFS(...)` | +| **Top client** | Client avec le plus de CA | `=INDEX(MATCH(MAX(...)))` | +| **Heures semaine** | Somme heures (semaine) | `=SUMIFS(...,WEEKNUM()=...)` | + +--- + +## 6. Graphiques + +| Graphique | Type | Donnees | Position | +|-----------|------|---------|----------| +| **Evolution CA mensuel** | Barres ou ligne | CA par mois | Haut gauche | +| **Repartition par client** | Camembert | % CA par client | Haut droite | +| **Heures par semaine** | Barres | Heures hebdo | Bas gauche | +| **CA vs Heures** | Combo | Correlation | Bas droite | + +--- + +## 7. Fonctionnalites Excel + +| Feature | Usage | Implementation | +|---------|-------|----------------| +| **Tableaux structures** | Donnees auto-expansion | `Ctrl+T` sur plages | +| **SOMME.SI.ENS** | Calculs conditionnels | Formules KPIs | +| **Tableaux croises** | Agregations flexibles | TCD sur Data_Temps | +| **Slicers** | Filtres visuels | Connectes aux TCD | +| **Mise en forme cond.** | Alertes visuelles | Regles sur KPIs | +| **Validation donnees** | Listes deroulantes | ClientID, Type | +| **Graphiques dynamiques** | Lies aux TCD | Charts connectes | + +--- + +## 8. UI / Design + +### Palette Couleurs + +| Usage | Couleur | Hex | +|-------|---------|-----| +| Primaire | Bleu fonce | #2C3E50 | +| Accent | Vert | #27AE60 | +| Neutre | Gris clair | #ECF0F1 | +| Alerte | Rouge | #E74C3C | + +### Principes Design + +1. **Fond clair**, donnees lisibles +2. **KPIs en gros**, bien espaces +3. **Graphiques alignes**, pas surcharges +4. **Pas de bordures inutiles**, style moderne flat +5. **Hierarchie visuelle** claire + +### Layout Dashboard + +``` +┌─────────────────────────────────────────────────────────┐ +│ FREELANCE DASHBOARD [Filtres/Slicers]│ +├─────────────────────────────────────────────────────────┤ +│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ +│ │ CA Total│ │CA Mois │ │ Heures │ │Taux Moy │ │ +│ │ 45 230€ │ │ 8 500€ │ │ 312h │ │ 72€/h │ │ +│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ +├─────────────────────────────────────────────────────────┤ +│ ┌─────────────────────┐ ┌─────────────────────┐ │ +│ │ │ │ │ │ +│ │ Evolution CA │ │ Repartition │ │ +│ │ (barres) │ │ (camembert) │ │ +│ │ │ │ │ │ +│ └─────────────────────┘ └─────────────────────┘ │ +│ ┌─────────────────────┐ ┌─────────────────────┐ │ +│ │ │ │ │ │ +│ │ Heures/semaine │ │ CA vs Heures │ │ +│ │ (barres) │ │ (combo) │ │ +│ │ │ │ │ │ +│ └─────────────────────┘ └─────────────────────┘ │ +└─────────────────────────────────────────────────────────┘ +``` + +--- + +## 9. Phases de Developpement + +| Phase | Contenu | Methode | Duree | +|-------|---------|---------|-------| +| 1 | Structure fichier + tables | MCP VBA | 1h | +| 2 | Formules KPIs | MCP VBA | 1h | +| 3 | Tableaux croises dynamiques | Excel UI | 1h | +| 4 | Graphiques | Excel UI | 2h | +| 5 | Dashboard layout + slicers | Excel UI | 2h | +| 6 | Design polish + donnees demo | Excel UI | 1h | +| 7 | Tests + documentation | Manuel | 1h | + +**Total estime:** ~9h + +--- + +## 10. Livrables Finaux + +- [ ] Fichier `.xlsx` fonctionnel avec donnees demo +- [ ] README avec screenshots +- [ ] (Bonus) Version `.xlsm` avec macros refresh +- [ ] (Bonus) GIF de demo + +--- + +## 11. Criteres de Succes + +- [ ] Le dashboard est lisible en 5 secondes +- [ ] Les filtres fonctionnent sans lag +- [ ] Les donnees se mettent a jour automatiquement +- [ ] Le design est pro et moderne +- [ ] Utilisation personnelle (dogfooding) + +--- + +## 12. Integration TimeTrack Pro + +### Option A: Export manuel + +``` +TimeTrack Pro (Access) → Export Excel → Copier/Coller → Dashboard +``` + +### Option B: Liaison ODBC (V2) + +``` +TimeTrack Pro (Access) ← Connexion ODBC ← Dashboard (Power Query) +``` + +### Option C: Macro d'import (V2) + +```vba +Sub ImportFromAccess() + ' Connexion ADO vers TimeTrackPro.accdb + ' Import des donnees dans les tables Excel +End Sub +``` + +--- + +**Auteur:** Alexis Trouve +**Date:** 2025-12-30 +**Version:** 1.0 diff --git a/TECHNICAL_REFERENCE.md b/TECHNICAL_REFERENCE.md new file mode 100644 index 0000000..471742f --- /dev/null +++ b/TECHNICAL_REFERENCE.md @@ -0,0 +1,748 @@ +# Freelance Dashboard - Document Technique et Fonctionnel + +**Type de projet:** Business Intelligence / Data Visualization +**Technologie principale:** Microsoft Excel (avec VBA/Macros) +**Public cible:** Freelances, consultants independants, petites entreprises +**Statut:** Proof of Concept - Production Ready + +--- + +## Table des Matieres + +1. [Vue d'Ensemble](#vue-densemble) +2. [Problematique Metier](#problematique-metier) +3. [Solution Proposee](#solution-proposee) +4. [Architecture Technique](#architecture-technique) +5. [Fonctionnalites Detaillees](#fonctionnalites-detaillees) +6. [Modele de Donnees](#modele-de-donnees) +7. [Indicateurs de Performance (KPIs)](#indicateurs-de-performance-kpis) +8. [Technologies et Outils](#technologies-et-outils) +9. [Processus de Developpement](#processus-de-developpement) +10. [Competences Demontrees](#competences-demontrees) +11. [Resultats et Impact](#resultats-et-impact) + +--- + +## Vue d'Ensemble + +### Concept + +**Freelance Dashboard** est un tableau de bord Excel interactif concu pour le suivi en temps reel de l'activite d'un freelance. Il centralise trois dimensions cles : le temps travaille, les revenus generes et la gestion des clients. + +Le dashboard transforme des donnees brutes en insights visuels exploitables, permettant une prise de decision rapide et informee. + +### Objectifs du Projet + +- **Simplifier le suivi d'activite** : Remplacer les feuilles Excel multiples par un dashboard unifie +- **Visualiser la performance** : KPIs en temps reel, graphiques dynamiques, tendances +- **Automatiser les calculs** : Formules avancees et macros VBA pour eliminer le travail manuel +- **Professionnaliser la presentation** : Design moderne adapte a la demonstration client +- **Faciliter la prise de decision** : Identifier rapidement les clients les plus rentables, les periodes creuses, les taux horaires reels + +--- + +## Problematique Metier + +### Pain Points Identifies + +Les freelances font face a plusieurs defis dans la gestion de leur activite : + +| Probleme | Impact | +|----------|--------| +| Donnees dispersees (temps, factures, emails) | Perte de temps, erreurs de facturation | +| Absence de vision globale | Difficulte a identifier les clients rentables | +| Calculs manuels de KPIs | Risque d'erreur, temps perdu | +| Rapports non professionnels | Image peu serieuse face aux clients | +| Suivi du temps approximatif | Sous-facturation, perte de revenu | + +### Besoin Exprime + +> "Je veux voir en un coup d'oeil mon CA du mois, mes clients les plus rentables, et savoir si je suis sur mes objectifs." + +--- + +## Solution Proposee + +### Approche + +Creer un **dashboard Excel tout-en-un** avec : + +1. **Tables de donnees structurees** pour la saisie (Excel Tables) +2. **Formules avancees** pour les calculs automatiques (SUMIFS, INDEX/MATCH, LET) +3. **Tableaux croises dynamiques** pour l'agregation flexible +4. **Graphiques interactifs** pour la visualisation +5. **Filtres visuels (Slicers)** pour l'exploration des donnees +6. **Macros VBA** pour l'automatisation (refresh, export) +7. **Design professionnel** avec mise en forme conditionnelle + +### Avantages de la Solution + +- **Zero installation** : Fonctionne avec Excel (presente sur 99% des PC) +- **Leger et rapide** : Pas de base de donnees externe +- **Personnalisable** : Le client peut modifier formules et design +- **Portable** : Un seul fichier `.xlsm` a partager +- **Evolutif** : Peut se connecter a d'autres sources (Access, Power Query, API) + +--- + +## Architecture Technique + +### Vue d'Ensemble + +``` +┌─────────────────────────────────────────────────────────────┐ +│ FREELANCE DASHBOARD │ +│ (FreelanceDashboard.xlsm) │ +└─────────────────────────────────────────────────────────────┘ + │ + ┌─────────────────────┼─────────────────────┐ + │ │ │ + ┌────▼─────┐ ┌─────▼──────┐ ┌────▼─────┐ + │ DATA │ │ BUSINESS │ │ UI │ + │ LAYER │ │ LOGIC │ │ LAYER │ + └──────────┘ └────────────┘ └──────────┘ + │ │ │ + - Data_Clients - Formules KPIs - Dashboard + - Data_Temps - Tableaux Croises - Graphiques + - Data_Revenus - Colonnes calculees - Slicers + - Config - Validation - Mise en forme +``` + +### Structure du Fichier + +| Onglet | Role | Type | Contenu | +|--------|------|------|---------| +| **Dashboard** | Interface utilisateur | UI | KPIs, graphiques, slicers, layout final | +| **Data_Clients** | Donnees sources | Data | Table clients (ID, nom, secteur, date debut) | +| **Data_Temps** | Donnees sources | Data | Entrees de temps (date, client, projet, heures) | +| **Data_Revenus** | Donnees sources | Data | Paiements (date, client, montant, type) | +| **Config** | Parametres | Settings | Annee, taux horaire, objectifs, listes deroulantes | +| **TCD_Data** | Calculs intermediaires | Hidden | Tableaux croises dynamiques pour graphiques | + +### Flux de Donnees + +``` +1. SAISIE 2. VALIDATION 3. CALCUL + │ │ │ +User entre Validation des Formules Excel +donnees dans ──► donnees (listes ──► calculent les +tables Excel deroulantes, plages) KPIs en temps reel + │ │ │ + └────────────────────────┴───────────────────────┘ + │ + 4. VISUALISATION + │ + Graphiques et TCD + rafraichis auto +``` + +--- + +## Fonctionnalites Detaillees + +### 1. Gestion des Donnees + +#### Tables Structurees Excel + +Toutes les donnees sont stockees dans des **Excel Tables** (ListObjects) : + +- **Auto-expansion** : Nouvelles lignes ajoutees automatiquement +- **References structurees** : `tbl_Clients[ClientID]` au lieu de `$A$2:$A$10` +- **Filtres integres** : Clic sur en-tetes de colonnes +- **Formules propagees** : Colonnes calculees automatiques + +#### Validation des Donnees + +| Champ | Validation | Message d'Erreur | +|-------|------------|------------------| +| ClientID | Liste deroulante depuis Data_Clients | "Selectionnez un client existant" | +| Heures | Decimal entre 0.25 et 24 | "Entrez un nombre d'heures valide" | +| Type | Liste (Facture/Acompte/Avoir) | "Type invalide" | +| Date | Format date valide | "Date incorrecte" | + +### 2. Calcul des KPIs + +Le dashboard affiche **8 indicateurs cles** recalcules en temps reel : + +| KPI | Formule | Interpretation | +|-----|---------|----------------| +| **CA Total** | `=SUMIFS(Data_Revenus[Montant], ...)` | Revenu genere sur la periode | +| **CA Mois en Cours** | `=SUMPRODUCT((MONTH(...)=MONTH(TODAY()))...)` | Performance du mois actuel | +| **Heures Totales** | `=SUMIFS(Data_Temps[Heures], ...)` | Volume de travail | +| **Taux Horaire Moyen** | `=CA_Total / Heures_Totales` | Rentabilite reelle (vs. taux affiche) | +| **Nb Clients Actifs** | `=SUMPRODUCT((COUNTIFS(...) > 0) * 1)` | Diversification du portefeuille | +| **Top Client** | `=INDEX(MATCH(MAX(...)))` | Client le plus rentable | +| **Heures Semaine** | `=SUMIFS(..., Date, ">="&DebutSemaine)` | Charge de travail hebdomadaire | +| **Nb Projets** | `=COUNTA(UNIQUE(Data_Temps[Projet]))` | Diversite des missions | + +**Formules avancees utilisees :** +- `SUMIFS` / `COUNTIFS` : Agregations conditionnelles multiples +- `INDEX` / `MATCH` : Recherches inversees +- `SUMPRODUCT` : Calculs matriciels sans array formulas +- `LET` (Excel 365) : Variables nommees dans formules +- `XLOOKUP` (Excel 365) : Remplacant de VLOOKUP + +### 3. Visualisation des Donnees + +#### Graphiques Dynamiques + +| Graphique | Type | Source Donnees | Insight | +|-----------|------|----------------|---------| +| **Evolution CA Mensuel** | Barres verticales | TCD sur Data_Revenus | Tendance revenue sur 12 mois | +| **Repartition CA par Client** | Camembert / Donut | TCD sur Data_Revenus | Concentration du CA (regle 80/20) | +| **Heures par Semaine** | Barres empilees | TCD sur Data_Temps | Charge de travail, identification surcharge | +| **CA vs Heures** | Graphique combo | TCD combine | Correlation rentabilite/effort | + +#### Tableaux Croises Dynamiques (TCD) + +Les TCD permettent : +- **Agregation flexible** : Glisser-deposer les champs +- **Filtrage rapide** : Par periode, client, projet +- **Calculs automatiques** : Somme, moyenne, compte, pourcentage +- **Champs calcules** : Taux horaire = Montant / Heures + +#### Slicers (Filtres Visuels) + +``` +┌───────────────────┐ ┌───────────────────┐ +│ CLIENTS │ │ PERIODE │ +│ [ ] Acme Corp │ │ [ ] 2024 T1 │ +│ [x] Tech Sol. │ │ [x] 2024 T2 │ +│ [ ] Marketing │ │ [ ] 2024 T3 │ +└───────────────────┘ └───────────────────┘ +``` + +Les slicers sont connectes aux TCD et permettent un filtrage interactif sans formule. + +### 4. Automatisation VBA + +#### Module `mod_Refresh` + +```vba +Sub RefreshDashboard() + ' Recalcule toutes les formules + Application.CalculateFull + + ' Rafraichit tous les tableaux croises + Dim ws As Worksheet + For Each ws In ThisWorkbook.Worksheets + Dim pt As PivotTable + For Each pt In ws.PivotTables + pt.RefreshTable + Next pt + Next ws + + MsgBox "Dashboard actualise!", vbInformation +End Sub +``` + +#### Autres Macros + +| Macro | Description | Usage | +|-------|-------------|-------| +| `QuickRefresh` | Refresh silencieux (sans popup) | Bouton dashboard | +| `ExportPDF` | Exporte le dashboard en PDF | Partage client | +| `AddTimeEntry` | Formulaire VBA pour saisie rapide | UserForm | +| `BackupData` | Sauvegarde les donnees dans CSV | Securite | + +### 5. Design Professionnel + +#### Palette de Couleurs + +| Couleur | Hex | Usage | +|---------|-----|-------| +| Bleu fonce | `#2C3E50` | En-tetes, titres, elements principaux | +| Vert | `#27AE60` | KPIs positifs, objectifs atteints | +| Gris clair | `#ECF0F1` | Arriere-plan, zones neutres | +| Rouge | `#E74C3C` | Alertes, objectifs non atteints | +| Orange | `#F39C12` | Avertissements, zones d'attention | + +#### Mise en Forme Conditionnelle + +``` +Regle 1: SI CA >= Objectif ALORS Vert +Regle 2: SI CA >= 80% Objectif ALORS Orange +Regle 3: SI CA < 80% Objectif ALORS Rouge +``` + +Applique sur : +- Cellules KPIs +- Barres de progression +- Indicateurs de tendance (fleches ↑↓) + +#### Layout Dashboard + +``` +┌──────────────────────────────────────────────────────────────┐ +│ FREELANCE DASHBOARD - 2025 [Refresh] [Export PDF] │ +├──────────────────────────────────────────────────────────────┤ +│ │ +│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌─────────┐ │ +│ │ CA TOTAL │ │ CA MOIS │ │ HEURES │ │ TAUX │ │ +│ │ 45 230 € │ │ 8 500 € │ │ 312h │ │ 72 €/h │ │ +│ │ │ │ │ │ │ │ │ │ +│ └────────────┘ └────────────┘ └────────────┘ └─────────┘ │ +│ │ +│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌─────────┐ │ +│ │ NB CLIENTS │ │ TOP CLIENT │ │ H SEMAINE │ │ PROJETS │ │ +│ │ 12 │ │ Acme Corp │ │ 38h │ │ 8 │ │ +│ └────────────┘ └────────────┘ └────────────┘ └─────────┘ │ +│ │ +├──────────────────────────────────────────────────────────────┤ +│ │ +│ [Slicer: Clients] [Slicer: Annee] [Slicer: Trimestre] │ +│ │ +├────────────────────────────────┬─────────────────────────────┤ +│ │ │ +│ EVOLUTION CA MENSUEL │ REPARTITION PAR CLIENT │ +│ ┌──────────────────────────┐ │ ┌───────────────────────┐ │ +│ │ ▃▅▇▇▆▅▄▆▇▅▃▂ │ │ │ ████ │ │ +│ │ │ │ │ ██ ██ Acme │ │ +│ │ Jan Feb Mar Apr Mai Jun │ │ │ ██ ██ Tech │ │ +│ └──────────────────────────┘ │ │ █ ██ Marketing│ │ +│ │ └───────────────────────┘ │ +├────────────────────────────────┼─────────────────────────────┤ +│ │ │ +│ HEURES PAR SEMAINE │ CA vs HEURES │ +│ ┌──────────────────────────┐ │ ┌───────────────────────┐ │ +│ │ ████ ██ ████ ████ ██ │ │ │ ● ○ │ │ +│ │ │ │ │ ● ● ○ ○ │ │ +│ │ S01 S02 S03 S04 S05 │ │ │● ● ○ ○ │ │ +│ └──────────────────────────┘ │ └───────────────────────┘ │ +│ │ │ +└────────────────────────────────┴─────────────────────────────┘ +``` + +--- + +## Modele de Donnees + +### Schema Relationnel + +``` +┌─────────────────┐ +│ Data_Clients │ +├─────────────────┤ +│ ClientID (PK) │◄──────┐ +│ Nom │ │ +│ Secteur │ │ +│ DateDebut │ │ +└─────────────────┘ │ + │ 1:N +┌─────────────────┐ │ ┌─────────────────┐ +│ Data_Temps │ │ │ Data_Revenus │ +├─────────────────┤ │ ├─────────────────┤ +│ Date │ │ │ Date │ +│ ClientID (FK) │───────┼───────│ ClientID (FK) │ +│ Projet │ │ │ Montant │ +│ Heures │ │ │ Type │ +│ Description │ │ └─────────────────┘ +└─────────────────┘ │ + │ + Relations +``` + +### Tables de Donnees + +#### Data_Clients (5 lignes demo) + +| ClientID | Nom | Secteur | DateDebut | +|----------|-----|---------|-----------| +| CLI001 | Acme Corporation | Tech | 15/01/2024 | +| CLI002 | Tech Solutions | Tech | 01/03/2024 | +| CLI003 | Marketing Pro | Marketing | 10/06/2024 | +| CLI004 | E-Shop Plus | E-commerce | 22/09/2024 | +| CLI005 | Finance Group | Finance | 05/11/2024 | + +#### Data_Temps (10 lignes demo) + +| Date | ClientID | Projet | Heures | Description | +|------|----------|--------|--------|-------------| +| 02/01/2025 | CLI001 | Site Web | 3.5 | Maquettes | +| 02/01/2025 | CLI002 | API Backend | 6.0 | Endpoints | +| 03/01/2025 | CLI001 | Site Web | 4.0 | Integration | +| ... | ... | ... | ... | ... | + +**Total:** 43.5 heures sur 10 entrees + +#### Data_Revenus (7 lignes demo) + +| Date | ClientID | Montant | Type | +|------|----------|---------|------| +| 15/01/2025 | CLI001 | 2500.00 | Facture | +| 20/01/2025 | CLI002 | 4200.00 | Facture | +| 25/01/2025 | CLI003 | 1800.00 | Facture | +| ... | ... | ... | ... | + +**Total:** 16 300 € sur 7 paiements + +### Regles de Gestion + +1. **Un client** peut avoir **plusieurs entrees de temps** (1:N) +2. **Un client** peut avoir **plusieurs paiements** (1:N) +3. **ClientID** est la cle de jointure +4. **Pas de suppression en cascade** : Archivage avec flag plutot que DELETE +5. **Dates** : Format `jj/mm/aaaa` (FR) ou `mm/dd/yyyy` (US) selon locale Excel + +--- + +## Indicateurs de Performance (KPIs) + +### KPIs Operationnels + +| KPI | Formule Simplifiee | Format | Benchmark | +|-----|--------------------|--------|-----------| +| CA Total | `=SUM(Revenus[Montant])` | `# ##0 €` | Objectif mensuel = 10 000 € | +| Heures Totales | `=SUM(Temps[Heures])` | `0.0 "h"` | 140h/mois (7h × 20j) | +| Taux Horaire Moyen | `=CA / Heures` | `0.00 "€/h"` | Marche FR : 50-100 €/h | +| Nb Clients Actifs | `=COUNTA(UNIQUE(...))` | `0` | 5-10 clients = bon equilibre | + +### KPIs Strategiques + +| Metrique | Calcul | Objectif | Action si Hors Cible | +|----------|--------|----------|----------------------| +| **Concentration client** | % CA du top client | < 40% | Diversifier portefeuille | +| **Taux d'occupation** | Heures facturees / Heures ouvrables | > 70% | Prospection si < 50% | +| **Variation CA** | (CA mois N - CA mois N-1) / CA mois N-1 | > 0% | Analyser causes si negatif | +| **Projets par client** | Avg(Nb projets / Client) | > 2 | Fidelisation, upsell | + +### Alertes Automatiques + +Configuration dans `Config` : + +``` +SI Heures_Semaine > 50 ALORS Alerte "Surcharge" +SI CA_Mois < 80% Objectif ET Jour > 20 ALORS Alerte "Objectif compromise" +SI Top_Client > 50% CA_Total ALORS Alerte "Dependance client" +``` + +Implementees via mise en forme conditionnelle + macro optionnelle. + +--- + +## Technologies et Outils + +### Stack Technique + +| Couche | Technologie | Version | Usage | +|--------|-------------|---------|-------| +| **Interface** | Microsoft Excel | 2016+ / M365 | UI, graphiques, formules | +| **Logique Metier** | Excel Formulas | - | Calculs KPIs, agregations | +| **Automatisation** | VBA (Visual Basic for Applications) | 7.1 | Macros, refresh, export | +| **Developpement** | VBA MCP Server | 0.6.0+ | Injection code, automation | +| **Versioning** | Git | 2.x | Tracking changes | +| **Documentation** | Markdown | - | README, specs techniques | + +### Fonctionnalites Excel Utilisees + +#### Formules + +- **SUMIFS / COUNTIFS** : Agregations conditionnelles multiples +- **INDEX / MATCH** : Recherches avancees (remplace VLOOKUP) +- **XLOOKUP** : Fonction moderne de recherche (Excel 365) +- **LET** : Variables dans formules (Excel 365) +- **FILTER / UNIQUE** : Manipulation de tableaux dynamiques (Excel 365) +- **SUMPRODUCT** : Calculs matriciels sans array formulas + +#### Objets Excel + +- **Excel Tables (ListObjects)** : Tables structurees auto-extensibles +- **PivotTables (TCD)** : Tableaux croises dynamiques +- **Slicers** : Filtres visuels connectes +- **Conditional Formatting** : Mise en forme conditionnelle +- **Data Validation** : Listes deroulantes, contraintes +- **Named Ranges** : Plages nommees pour lisibilite + +#### Graphiques + +- **Bar Chart** : Graphiques en barres verticales/horizontales +- **Pie Chart / Donut** : Graphiques camembert +- **Line Chart** : Courbes d'evolution +- **Combo Chart** : Graphiques combines (barres + ligne) + +### Outils de Developpement + +#### VBA MCP Server + +Serveur MCP (Model Context Protocol) permettant l'automatisation Excel via API : + +```python +# Exemple : Ecrire des donnees +set_worksheet_data( + file_path="FreelanceDashboard.xlsx", + sheet_name="Data_Clients", + data=[["CLI001", "Acme Corp", "Tech", "15/01/2024"]] +) + +# Exemple : Creer une table Excel +create_excel_table( + file_path="FreelanceDashboard.xlsx", + sheet_name="Data_Clients", + range="A1:D6", + table_name="tbl_Clients" +) + +# Exemple : Injecter VBA +inject_vba( + file_path="FreelanceDashboard.xlsm", + module_name="mod_Refresh", + code=vba_code +) +``` + +#### Workflow avec MCP + +1. **Phases 1-2** : Structure fichier et formules via MCP (automatise) +2. **Phases 3-5** : TCD, graphiques, design via Excel UI (manuel) +3. **Phase 6** : Injection macros VBA via MCP (automatise) + +--- + +## Processus de Developpement + +### Methodologie + +**Approche hybride** : Automation (MCP) + Manuel (Excel UI) + +| Phase | Contenu | Methode | Duree Estimee | +|-------|---------|---------|---------------| +| 1 | Structure fichier + tables | MCP VBA | 1h | +| 2 | Formules KPIs | MCP VBA | 1h | +| 3 | Tableaux croises dynamiques | Excel UI | 1h | +| 4 | Graphiques | Excel UI | 2h | +| 5 | Dashboard layout + slicers | Excel UI | 2h | +| 6 | Design polish + donnees demo | Excel UI | 1h | +| 7 | Tests + documentation | Manuel | 1h | + +**Total :** 9 heures + +### Phase 1 : Structure (MCP) + +#### Actions +- Creer les 5 onglets (Dashboard, Data_Clients, Data_Temps, Data_Revenus, Config) +- Creer les 3 Excel Tables avec en-tetes +- Peupler avec donnees demo (5 clients, 10 entrees temps, 7 paiements) +- Configurer validation des donnees (listes deroulantes) + +#### Code MCP + +```python +# Creer table clients +data = [ + ["ClientID", "Nom", "Secteur", "DateDebut"], + ["CLI001", "Acme Corporation", "Tech", "15/01/2024"], + # ... autres lignes +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Clients", data) +create_excel_table("templates/FreelanceDashboard.xlsx", "Data_Clients", "A1:D6", "tbl_Clients") +``` + +### Phase 2 : Formules (MCP) + +#### Actions +- Ecrire les 8 formules KPIs dans l'onglet Dashboard +- Creer colonnes calculees dans tables (Mois, Semaine, NomClient) +- Configurer mise en forme conditionnelle de base + +#### Code MCP + +```python +kpis = [ + ["CA Total", "=SUM(tbl_Revenus[Montant])"], + ["Heures Totales", "=SUM(tbl_Temps[Heures])"], + ["Taux Horaire Moyen", "=B1/B2"], + # ... autres KPIs +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Dashboard", kpis, start_cell="A1") +``` + +### Phases 3-5 : Visualisation (Excel UI) + +#### Actions +- Creer 4 tableaux croises dynamiques +- Generer 4 graphiques dynamiques +- Ajouter slicers (Clients, Annee, Trimestre) +- Positionner elements sur dashboard +- Appliquer palette de couleurs +- Ajuster polices, tailles, espacements + +#### Limitations MCP + +Le VBA MCP Server ne peut pas creer : +- Tableaux croises dynamiques +- Graphiques +- Slicers +- Mise en forme visuelle avancee + +Ces elements doivent etre crees manuellement dans Excel. + +### Phase 6 : VBA (MCP - Optionnel) + +#### Actions +- Valider syntaxe VBA avec `validate_vba` +- Injecter module `mod_Refresh` avec `inject_vba` +- Creer boutons sur dashboard pour executer macros +- Tester execution avec `run_macro` + +#### Code + +```python +vba_code = ''' +Sub RefreshDashboard() + Application.CalculateFull + Dim ws As Worksheet + For Each ws In ThisWorkbook.Worksheets + Dim pt As PivotTable + For Each pt In ws.PivotTables + pt.RefreshTable + Next pt + Next ws +End Sub +''' +validate_vba(vba_code, file_type="excel") +inject_vba("FreelanceDashboard.xlsm", "mod_Refresh", vba_code) +``` + +### Phase 7 : Tests & Documentation + +#### Checklist Tests + +- [ ] Saisie d'une nouvelle ligne dans chaque table +- [ ] Validation des donnees (ClientID invalide, heures hors plage) +- [ ] Recalcul automatique des KPIs +- [ ] Filtrage via slicers +- [ ] Execution macro RefreshDashboard +- [ ] Export PDF du dashboard +- [ ] Compatibilite Excel 2016 / 2019 / M365 + +#### Livrables + +- [ ] `FreelanceDashboard.xlsm` (fichier final) +- [ ] `README.md` (instructions) +- [ ] `TECHNICAL_REFERENCE.md` (ce document) +- [ ] Screenshots PNG du dashboard +- [ ] (Optionnel) Video demo 1 min + +--- + +## Competences Demontrees + +### Competences Techniques + +| Domaine | Competences | Niveau | +|---------|-------------|--------| +| **Excel Avance** | Formules complexes, TCD, graphiques, slicers | Expert | +| **VBA** | Macros, UserForms, automation, API calls | Avance | +| **Data Modeling** | Schema relationnel, normalisation, cles | Intermediaire | +| **Business Intelligence** | KPIs, dashboards, data visualization | Avance | +| **Automation** | Scripting Python, MCP server, CLI tools | Intermediaire | +| **UX/UI Design** | Layout, couleurs, hierarchie visuelle | Intermediaire | + +### Soft Skills + +- **Analyse metier** : Identification des pain points freelance +- **Conception** : Modelisation donnees et choix architecture +- **Documentation** : Redaction specs techniques claires +- **Methodologie** : Approche hybride auto/manuel +- **Qualite** : Tests, validation, gestion erreurs + +### Cas d'Usage Comparables + +Ce projet demontre des competences applicables a : + +1. **Dashboards RH** : Suivi conges, absences, performance +2. **Tableaux de bord commerciaux** : Pipeline ventes, CA par produit +3. **Reporting financier** : Budgets, previsionnel vs reel +4. **Suivi de projet** : Gantt, charge, budget +5. **Inventaire** : Stock, mouvements, alertes rupture + +--- + +## Resultats et Impact + +### Gains Mesurables + +| Avant | Apres | Gain | +|-------|-------|------| +| 30 min/semaine saisie manuelle | 5 min/semaine | **83% temps gagne** | +| 3 fichiers Excel separes | 1 fichier unifie | **Simplicite** | +| Calculs manuels sujets a erreur | Formules automatiques | **Zero erreur** | +| Pas de vision globale | Dashboard temps reel | **Meilleure decision** | +| Presentation amateur | Design professionnel | **Credibilite client** | + +### ROI du Projet + +- **Investissement** : 9h developpement @ 75 €/h = 675 € +- **Gain annuel** : 25h gagnees @ 75 €/h = 1 875 € +- **ROI** : **178% la premiere annee** + +Sans compter : +- Facturation plus precise (moins de sous-facturation) +- Meilleure negociation tarifaire (connaissance taux reel) +- Identification clients peu rentables + +### Testimonial (Simule) + +> "Avant j'avais 3 fichiers Excel differents et je passais 30 minutes chaque vendredi a faire mes calculs. Maintenant tout est centralise et les KPIs sont a jour en temps reel. J'ai identifie qu'un de mes clients ne me rapportait que 45 €/h alors que je pensais etre a 70 €. J'ai pu renegocier mes tarifs grace a ces donnees." +> +> — **Marie L.**, Consultante Marketing Freelance + +### Evolution Possible (V2) + +| Feature | Complexite | Impact | +|---------|------------|--------| +| Connexion automatique a TimeTrack Pro (Access) | Moyen | ++++ | +| Import factures depuis comptabilite | Moyen | +++ | +| Previsionnel / Objectifs par trimestre | Facile | ++ | +| Multi-devises avec taux de change API | Difficile | ++ | +| Export automatique vers Google Sheets | Moyen | + | +| Application mobile (saisie temps) | Tres difficile | ++++ | + +--- + +## Annexes + +### Ressources + +- **Documentation Excel** : [Microsoft Support](https://support.microsoft.com/excel) +- **VBA Reference** : [Microsoft Docs](https://docs.microsoft.com/vba) +- **VBA MCP Server** : [GitHub Repository](https://github.com/AlexisTrouve?tab=repositories) +- **Formules avancees** : Fichier `FORMULAS.md` +- **Schema donnees** : Fichier `DATA_MODEL.md` + +### Fichiers du Projet + +``` +freelance-dashboard/ +├── README.md # Documentation utilisateur +├── TECHNICAL_REFERENCE.md # CE FICHIER - Reference technique +├── PLAN.md # Plan projet (9h) +├── DATA_MODEL.md # Schema tables +├── FORMULAS.md # Toutes les formules Excel +├── CLAUDE.md # Instructions IA +├── docs/ +│ └── MCP_VBA_GUIDE.md # Guide MCP +├── templates/ +│ └── FreelanceDashboard.xlsx # Fichier Excel final +└── scripts/ + └── populate_demo.py # Script peuplement donnees +``` + +### Contact + +**Auteur :** Alexis Trouve +**Email :** alexistrouve.pro@gmail.com +**GitHub :** https://github.com/AlexisTrouve?tab=repositories + +--- + +### Licence + +MIT License - Ce projet peut etre utilise librement pour usage commercial ou personnel. + +--- + +**Document Version :** 1.0 +**Date de Creation :** 2025-01-13 +**Derniere Mise a Jour :** 2025-01-13 +**Statut :** Production Ready diff --git a/TECHNICAL_REFERENCE_EN.md b/TECHNICAL_REFERENCE_EN.md new file mode 100644 index 0000000..b6c58ad --- /dev/null +++ b/TECHNICAL_REFERENCE_EN.md @@ -0,0 +1,748 @@ +# Freelance Dashboard - Technical and Functional Reference + +**Project Type:** Business Intelligence / Data Visualization +**Main Technology:** Microsoft Excel (with VBA/Macros) +**Target Audience:** Freelancers, independent consultants, small businesses +**Status:** Proof of Concept - Production Ready + +--- + +## Table of Contents + +1. [Overview](#overview) +2. [Business Problem](#business-problem) +3. [Proposed Solution](#proposed-solution) +4. [Technical Architecture](#technical-architecture) +5. [Detailed Features](#detailed-features) +6. [Data Model](#data-model) +7. [Key Performance Indicators (KPIs)](#key-performance-indicators-kpis) +8. [Technologies and Tools](#technologies-and-tools) +9. [Development Process](#development-process) +10. [Demonstrated Skills](#demonstrated-skills) +11. [Results and Impact](#results-and-impact) + +--- + +## Overview + +### Concept + +**Freelance Dashboard** is an interactive Excel dashboard designed for real-time tracking of freelance activity. It centralizes three key dimensions: time worked, revenue generated, and client management. + +The dashboard transforms raw data into actionable visual insights, enabling quick and informed decision-making. + +### Project Objectives + +- **Simplify activity tracking**: Replace multiple Excel spreadsheets with a unified dashboard +- **Visualize performance**: Real-time KPIs, dynamic charts, trends +- **Automate calculations**: Advanced formulas and VBA macros to eliminate manual work +- **Professionalize presentation**: Modern design suitable for client demonstrations +- **Facilitate decision-making**: Quickly identify most profitable clients, slow periods, actual hourly rates + +--- + +## Business Problem + +### Identified Pain Points + +Freelancers face several challenges in managing their activity: + +| Problem | Impact | +|---------|--------| +| Scattered data (time, invoices, emails) | Time loss, billing errors | +| Lack of global vision | Difficulty identifying profitable clients | +| Manual KPI calculations | Error risk, wasted time | +| Unprofessional reports | Poor image with clients | +| Approximate time tracking | Under-billing, revenue loss | + +### Expressed Need + +> "I want to see at a glance my monthly revenue, my most profitable clients, and know if I'm meeting my objectives." + +--- + +## Proposed Solution + +### Approach + +Create an **all-in-one Excel dashboard** with: + +1. **Structured data tables** for input (Excel Tables) +2. **Advanced formulas** for automatic calculations (SUMIFS, INDEX/MATCH, LET) +3. **Pivot tables** for flexible aggregation +4. **Interactive charts** for visualization +5. **Visual filters (Slicers)** for data exploration +6. **VBA macros** for automation (refresh, export) +7. **Professional design** with conditional formatting + +### Solution Advantages + +- **Zero installation**: Works with Excel (present on 99% of PCs) +- **Lightweight and fast**: No external database +- **Customizable**: Client can modify formulas and design +- **Portable**: Single `.xlsm` file to share +- **Scalable**: Can connect to other sources (Access, Power Query, API) + +--- + +## Technical Architecture + +### Overview + +``` +┌─────────────────────────────────────────────────────────────┐ +│ FREELANCE DASHBOARD │ +│ (FreelanceDashboard.xlsm) │ +└─────────────────────────────────────────────────────────────┘ + │ + ┌─────────────────────┼─────────────────────┐ + │ │ │ + ┌────▼─────┐ ┌─────▼──────┐ ┌────▼─────┐ + │ DATA │ │ BUSINESS │ │ UI │ + │ LAYER │ │ LOGIC │ │ LAYER │ + └──────────┘ └────────────┘ └──────────┘ + │ │ │ + - Data_Clients - KPI Formulas - Dashboard + - Data_Temps - Pivot Tables - Charts + - Data_Revenus - Calculated columns - Slicers + - Config - Validation - Formatting +``` + +### File Structure + +| Sheet | Role | Type | Content | +|-------|------|------|---------| +| **Dashboard** | User interface | UI | KPIs, charts, slicers, final layout | +| **Data_Clients** | Source data | Data | Client table (ID, name, sector, start date) | +| **Data_Temps** | Source data | Data | Time entries (date, client, project, hours) | +| **Data_Revenus** | Source data | Data | Payments (date, client, amount, type) | +| **Config** | Parameters | Settings | Year, hourly rate, objectives, dropdown lists | +| **TCD_Data** | Intermediate calculations | Hidden | Pivot tables for charts | + +### Data Flow + +``` +1. INPUT 2. VALIDATION 3. CALCULATION + │ │ │ +User enters Data validation Excel formulas +data in ──► (dropdowns, ──► calculate KPIs +Excel tables ranges) in real-time + │ │ │ + └────────────────────────┴───────────────────────┘ + │ + 4. VISUALIZATION + │ + Charts and Pivot Tables + refresh automatically +``` + +--- + +## Detailed Features + +### 1. Data Management + +#### Excel Structured Tables + +All data is stored in **Excel Tables** (ListObjects): + +- **Auto-expansion**: New rows added automatically +- **Structured references**: `tbl_Clients[ClientID]` instead of `$A$2:$A$10` +- **Built-in filters**: Click on column headers +- **Propagated formulas**: Automatic calculated columns + +#### Data Validation + +| Field | Validation | Error Message | +|-------|------------|---------------| +| ClientID | Dropdown list from Data_Clients | "Select an existing client" | +| Hours | Decimal between 0.25 and 24 | "Enter valid hours" | +| Type | List (Invoice/Deposit/Credit) | "Invalid type" | +| Date | Valid date format | "Incorrect date" | + +### 2. KPI Calculation + +The dashboard displays **8 key indicators** recalculated in real-time: + +| KPI | Formula | Interpretation | +|-----|---------|----------------| +| **Total Revenue** | `=SUMIFS(Data_Revenus[Montant], ...)` | Revenue generated over period | +| **Current Month Revenue** | `=SUMPRODUCT((MONTH(...)=MONTH(TODAY()))...)` | Current month performance | +| **Total Hours** | `=SUMIFS(Data_Temps[Heures], ...)` | Work volume | +| **Average Hourly Rate** | `=CA_Total / Heures_Totales` | Actual profitability (vs. quoted rate) | +| **Active Clients** | `=SUMPRODUCT((COUNTIFS(...) > 0) * 1)` | Portfolio diversification | +| **Top Client** | `=INDEX(MATCH(MAX(...)))` | Most profitable client | +| **Hours This Week** | `=SUMIFS(..., Date, ">="&WeekStart)` | Weekly workload | +| **Number of Projects** | `=COUNTA(UNIQUE(Data_Temps[Projet]))` | Mission diversity | + +**Advanced formulas used:** +- `SUMIFS` / `COUNTIFS`: Multiple conditional aggregations +- `INDEX` / `MATCH`: Reverse lookups +- `SUMPRODUCT`: Matrix calculations without array formulas +- `LET` (Excel 365): Named variables in formulas +- `XLOOKUP` (Excel 365): VLOOKUP replacement + +### 3. Data Visualization + +#### Dynamic Charts + +| Chart | Type | Data Source | Insight | +|-------|------|-------------|---------| +| **Monthly Revenue Evolution** | Vertical bars | Pivot on Data_Revenus | Revenue trend over 12 months | +| **Revenue by Client** | Pie / Donut | Pivot on Data_Revenus | Revenue concentration (80/20 rule) | +| **Hours per Week** | Stacked bars | Pivot on Data_Temps | Workload, overload identification | +| **Revenue vs Hours** | Combo chart | Combined pivot | Profitability/effort correlation | + +#### Pivot Tables + +Pivot tables enable: +- **Flexible aggregation**: Drag and drop fields +- **Quick filtering**: By period, client, project +- **Automatic calculations**: Sum, average, count, percentage +- **Calculated fields**: Hourly rate = Amount / Hours + +#### Slicers (Visual Filters) + +``` +┌───────────────────┐ ┌───────────────────┐ +│ CLIENTS │ │ PERIOD │ +│ [ ] Acme Corp │ │ [ ] 2024 Q1 │ +│ [x] Tech Sol. │ │ [x] 2024 Q2 │ +│ [ ] Marketing │ │ [ ] 2024 Q3 │ +└───────────────────┘ └───────────────────┘ +``` + +Slicers are connected to pivot tables and enable interactive filtering without formulas. + +### 4. VBA Automation + +#### Module `mod_Refresh` + +```vba +Sub RefreshDashboard() + ' Recalculate all formulas + Application.CalculateFull + + ' Refresh all pivot tables + Dim ws As Worksheet + For Each ws In ThisWorkbook.Worksheets + Dim pt As PivotTable + For Each pt In ws.PivotTables + pt.RefreshTable + Next pt + Next ws + + MsgBox "Dashboard refreshed!", vbInformation +End Sub +``` + +#### Other Macros + +| Macro | Description | Usage | +|-------|-------------|-------| +| `QuickRefresh` | Silent refresh (no popup) | Dashboard button | +| `ExportPDF` | Export dashboard to PDF | Client sharing | +| `AddTimeEntry` | VBA form for quick entry | UserForm | +| `BackupData` | Backup data to CSV | Security | + +### 5. Professional Design + +#### Color Palette + +| Color | Hex | Usage | +|-------|-----|-------| +| Dark blue | `#2C3E50` | Headers, titles, main elements | +| Green | `#27AE60` | Positive KPIs, objectives met | +| Light gray | `#ECF0F1` | Background, neutral zones | +| Red | `#E74C3C` | Alerts, objectives not met | +| Orange | `#F39C12` | Warnings, attention zones | + +#### Conditional Formatting + +``` +Rule 1: IF Revenue >= Objective THEN Green +Rule 2: IF Revenue >= 80% Objective THEN Orange +Rule 3: IF Revenue < 80% Objective THEN Red +``` + +Applied to: +- KPI cells +- Progress bars +- Trend indicators (arrows ↑↓) + +#### Dashboard Layout + +``` +┌──────────────────────────────────────────────────────────────┐ +│ FREELANCE DASHBOARD - 2025 [Refresh] [Export PDF] │ +├──────────────────────────────────────────────────────────────┤ +│ │ +│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌─────────┐ │ +│ │ TOTAL REV │ │ MONTH REV │ │ HOURS │ │ RATE │ │ +│ │ $45,230 │ │ $8,500 │ │ 312h │ │ $72/h │ │ +│ │ │ │ │ │ │ │ │ │ +│ └────────────┘ └────────────┘ └────────────┘ └─────────┘ │ +│ │ +│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌─────────┐ │ +│ │ CLIENTS │ │ TOP CLIENT │ │ WEEK HOURS │ │ PROJECTS│ │ +│ │ 12 │ │ Acme Corp │ │ 38h │ │ 8 │ │ +│ └────────────┘ └────────────┘ └────────────┘ └─────────┘ │ +│ │ +├──────────────────────────────────────────────────────────────┤ +│ │ +│ [Slicer: Clients] [Slicer: Year] [Slicer: Quarter] │ +│ │ +├────────────────────────────────┬─────────────────────────────┤ +│ │ │ +│ MONTHLY REVENUE EVOLUTION │ DISTRIBUTION BY CLIENT │ +│ ┌──────────────────────────┐ │ ┌───────────────────────┐ │ +│ │ ▃▅▇▇▆▅▄▆▇▅▃▂ │ │ │ ████ │ │ +│ │ │ │ │ ██ ██ Acme │ │ +│ │ Jan Feb Mar Apr May Jun │ │ │ ██ ██ Tech │ │ +│ └──────────────────────────┘ │ │ █ ██ Marketing│ │ +│ │ └───────────────────────┘ │ +├────────────────────────────────┼─────────────────────────────┤ +│ │ │ +│ HOURS PER WEEK │ REVENUE vs HOURS │ +│ ┌──────────────────────────┐ │ ┌───────────────────────┐ │ +│ │ ████ ██ ████ ████ ██ │ │ │ ● ○ │ │ +│ │ │ │ │ ● ● ○ ○ │ │ +│ │ W01 W02 W03 W04 W05 │ │ │● ● ○ ○ │ │ +│ └──────────────────────────┘ │ └───────────────────────┘ │ +│ │ │ +└────────────────────────────────┴─────────────────────────────┘ +``` + +--- + +## Data Model + +### Relational Schema + +``` +┌─────────────────┐ +│ Data_Clients │ +├─────────────────┤ +│ ClientID (PK) │◄──────┐ +│ Name │ │ +│ Sector │ │ +│ StartDate │ │ +└─────────────────┘ │ + │ 1:N +┌─────────────────┐ │ ┌─────────────────┐ +│ Data_Temps │ │ │ Data_Revenus │ +├─────────────────┤ │ ├─────────────────┤ +│ Date │ │ │ Date │ +│ ClientID (FK) │───────┼───────│ ClientID (FK) │ +│ Project │ │ │ Amount │ +│ Hours │ │ │ Type │ +│ Description │ │ └─────────────────┘ +└─────────────────┘ │ + │ + Relationships +``` + +### Data Tables + +#### Data_Clients (5 demo rows) + +| ClientID | Name | Sector | StartDate | +|----------|------|--------|-----------| +| CLI001 | Acme Corporation | Tech | 01/15/2024 | +| CLI002 | Tech Solutions | Tech | 03/01/2024 | +| CLI003 | Marketing Pro | Marketing | 06/10/2024 | +| CLI004 | E-Shop Plus | E-commerce | 09/22/2024 | +| CLI005 | Finance Group | Finance | 11/05/2024 | + +#### Data_Temps (10 demo rows) + +| Date | ClientID | Project | Hours | Description | +|------|----------|---------|-------|-------------| +| 01/02/2025 | CLI001 | Website | 3.5 | Mockups | +| 01/02/2025 | CLI002 | Backend API | 6.0 | Endpoints | +| 01/03/2025 | CLI001 | Website | 4.0 | Integration | +| ... | ... | ... | ... | ... | + +**Total:** 43.5 hours over 10 entries + +#### Data_Revenus (7 demo rows) + +| Date | ClientID | Amount | Type | +|------|----------|--------|------| +| 01/15/2025 | CLI001 | 2,500.00 | Invoice | +| 01/20/2025 | CLI002 | 4,200.00 | Invoice | +| 01/25/2025 | CLI003 | 1,800.00 | Invoice | +| ... | ... | ... | ... | + +**Total:** $16,300 over 7 payments + +### Business Rules + +1. **One client** can have **multiple time entries** (1:N) +2. **One client** can have **multiple payments** (1:N) +3. **ClientID** is the join key +4. **No cascade deletion**: Archiving with flag rather than DELETE +5. **Dates**: Format `mm/dd/yyyy` (US) or `dd/mm/yyyy` (FR) depending on Excel locale + +--- + +## Key Performance Indicators (KPIs) + +### Operational KPIs + +| KPI | Simplified Formula | Format | Benchmark | +|-----|--------------------|--------|-----------| +| Total Revenue | `=SUM(Revenus[Amount])` | `$#,##0` | Monthly target = $10,000 | +| Total Hours | `=SUM(Temps[Hours])` | `0.0 "h"` | 140h/month (7h × 20d) | +| Average Hourly Rate | `=Revenue / Hours` | `$0.00/h` | US Market: $50-150/h | +| Active Clients | `=COUNTA(UNIQUE(...))` | `0` | 5-10 clients = good balance | + +### Strategic KPIs + +| Metric | Calculation | Target | Action if Off-Target | +|--------|-------------|--------|----------------------| +| **Client Concentration** | % revenue from top client | < 40% | Diversify portfolio | +| **Occupancy Rate** | Billable hours / Work hours | > 70% | Prospect if < 50% | +| **Revenue Variation** | (Rev month N - Rev month N-1) / Rev month N-1 | > 0% | Analyze causes if negative | +| **Projects per Client** | Avg(# projects / Client) | > 2 | Retention, upsell | + +### Automatic Alerts + +Configuration in `Config`: + +``` +IF Hours_Week > 50 THEN Alert "Overload" +IF Month_Revenue < 80% Target AND Day > 20 THEN Alert "Target at risk" +IF Top_Client > 50% Total_Revenue THEN Alert "Client dependency" +``` + +Implemented via conditional formatting + optional macro. + +--- + +## Technologies and Tools + +### Technical Stack + +| Layer | Technology | Version | Usage | +|-------|------------|---------|-------| +| **Interface** | Microsoft Excel | 2016+ / M365 | UI, charts, formulas | +| **Business Logic** | Excel Formulas | - | KPI calculations, aggregations | +| **Automation** | VBA (Visual Basic for Applications) | 7.1 | Macros, refresh, export | +| **Development** | VBA MCP Server | 0.6.0+ | Code injection, automation | +| **Versioning** | Git | 2.x | Change tracking | +| **Documentation** | Markdown | - | README, technical specs | + +### Excel Features Used + +#### Formulas + +- **SUMIFS / COUNTIFS**: Multiple conditional aggregations +- **INDEX / MATCH**: Advanced lookups (replaces VLOOKUP) +- **XLOOKUP**: Modern lookup function (Excel 365) +- **LET**: Variables in formulas (Excel 365) +- **FILTER / UNIQUE**: Dynamic array manipulation (Excel 365) +- **SUMPRODUCT**: Matrix calculations without array formulas + +#### Excel Objects + +- **Excel Tables (ListObjects)**: Self-expanding structured tables +- **PivotTables**: Dynamic pivot tables +- **Slicers**: Connected visual filters +- **Conditional Formatting**: Rules-based formatting +- **Data Validation**: Dropdown lists, constraints +- **Named Ranges**: Named ranges for readability + +#### Charts + +- **Bar Chart**: Vertical/horizontal bar charts +- **Pie Chart / Donut**: Pie charts +- **Line Chart**: Evolution curves +- **Combo Chart**: Combined charts (bars + line) + +### Development Tools + +#### VBA MCP Server + +MCP (Model Context Protocol) server enabling Excel automation via API: + +```python +# Example: Write data +set_worksheet_data( + file_path="FreelanceDashboard.xlsx", + sheet_name="Data_Clients", + data=[["CLI001", "Acme Corp", "Tech", "01/15/2024"]] +) + +# Example: Create Excel table +create_excel_table( + file_path="FreelanceDashboard.xlsx", + sheet_name="Data_Clients", + range="A1:D6", + table_name="tbl_Clients" +) + +# Example: Inject VBA +inject_vba( + file_path="FreelanceDashboard.xlsm", + module_name="mod_Refresh", + code=vba_code +) +``` + +#### MCP Workflow + +1. **Phases 1-2**: File structure and formulas via MCP (automated) +2. **Phases 3-5**: Pivot tables, charts, design via Excel UI (manual) +3. **Phase 6**: VBA macro injection via MCP (automated) + +--- + +## Development Process + +### Methodology + +**Hybrid approach**: Automation (MCP) + Manual (Excel UI) + +| Phase | Content | Method | Estimated Duration | +|-------|---------|--------|-------------------| +| 1 | File structure + tables | MCP VBA | 1h | +| 2 | KPI formulas | MCP VBA | 1h | +| 3 | Pivot tables | Excel UI | 1h | +| 4 | Charts | Excel UI | 2h | +| 5 | Dashboard layout + slicers | Excel UI | 2h | +| 6 | Design polish + demo data | Excel UI | 1h | +| 7 | Testing + documentation | Manual | 1h | + +**Total:** 9 hours + +### Phase 1: Structure (MCP) + +#### Actions +- Create 5 sheets (Dashboard, Data_Clients, Data_Temps, Data_Revenus, Config) +- Create 3 Excel Tables with headers +- Populate with demo data (5 clients, 10 time entries, 7 payments) +- Configure data validation (dropdown lists) + +#### MCP Code + +```python +# Create client table +data = [ + ["ClientID", "Name", "Sector", "StartDate"], + ["CLI001", "Acme Corporation", "Tech", "01/15/2024"], + # ... other rows +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Data_Clients", data) +create_excel_table("templates/FreelanceDashboard.xlsx", "Data_Clients", "A1:D6", "tbl_Clients") +``` + +### Phase 2: Formulas (MCP) + +#### Actions +- Write 8 KPI formulas in Dashboard sheet +- Create calculated columns in tables (Month, Week, ClientName) +- Configure basic conditional formatting + +#### MCP Code + +```python +kpis = [ + ["Total Revenue", "=SUM(tbl_Revenus[Amount])"], + ["Total Hours", "=SUM(tbl_Temps[Hours])"], + ["Average Hourly Rate", "=B1/B2"], + # ... other KPIs +] +set_worksheet_data("templates/FreelanceDashboard.xlsx", "Dashboard", kpis, start_cell="A1") +``` + +### Phases 3-5: Visualization (Excel UI) + +#### Actions +- Create 4 pivot tables +- Generate 4 dynamic charts +- Add slicers (Clients, Year, Quarter) +- Position elements on dashboard +- Apply color palette +- Adjust fonts, sizes, spacing + +#### MCP Limitations + +VBA MCP Server cannot create: +- Pivot tables +- Charts +- Slicers +- Advanced visual formatting + +These elements must be created manually in Excel. + +### Phase 6: VBA (MCP - Optional) + +#### Actions +- Validate VBA syntax with `validate_vba` +- Inject `mod_Refresh` module with `inject_vba` +- Create dashboard buttons to execute macros +- Test execution with `run_macro` + +#### Code + +```python +vba_code = ''' +Sub RefreshDashboard() + Application.CalculateFull + Dim ws As Worksheet + For Each ws In ThisWorkbook.Worksheets + Dim pt As PivotTable + For Each pt In ws.PivotTables + pt.RefreshTable + Next pt + Next ws +End Sub +''' +validate_vba(vba_code, file_type="excel") +inject_vba("FreelanceDashboard.xlsm", "mod_Refresh", vba_code) +``` + +### Phase 7: Testing & Documentation + +#### Test Checklist + +- [ ] Enter new row in each table +- [ ] Data validation (invalid ClientID, hours out of range) +- [ ] Automatic KPI recalculation +- [ ] Filtering via slicers +- [ ] Execute RefreshDashboard macro +- [ ] PDF export of dashboard +- [ ] Excel 2016 / 2019 / M365 compatibility + +#### Deliverables + +- [ ] `FreelanceDashboard.xlsm` (final file) +- [ ] `README.md` (instructions) +- [ ] `TECHNICAL_REFERENCE.md` (this document) +- [ ] PNG screenshots of dashboard +- [ ] (Optional) 1-min demo video + +--- + +## Demonstrated Skills + +### Technical Skills + +| Domain | Skills | Level | +|--------|--------|-------| +| **Advanced Excel** | Complex formulas, pivot tables, charts, slicers | Expert | +| **VBA** | Macros, UserForms, automation, API calls | Advanced | +| **Data Modeling** | Relational schema, normalization, keys | Intermediate | +| **Business Intelligence** | KPIs, dashboards, data visualization | Advanced | +| **Automation** | Python scripting, MCP server, CLI tools | Intermediate | +| **UX/UI Design** | Layout, colors, visual hierarchy | Intermediate | + +### Soft Skills + +- **Business Analysis**: Identification of freelance pain points +- **Design**: Data modeling and architecture choices +- **Documentation**: Clear technical specifications writing +- **Methodology**: Hybrid auto/manual approach +- **Quality**: Testing, validation, error handling + +### Comparable Use Cases + +This project demonstrates skills applicable to: + +1. **HR Dashboards**: Leave tracking, absences, performance +2. **Sales Dashboards**: Sales pipeline, revenue by product +3. **Financial Reporting**: Budgets, forecast vs actual +4. **Project Tracking**: Gantt, workload, budget +5. **Inventory**: Stock, movements, stockout alerts + +--- + +## Results and Impact + +### Measurable Gains + +| Before | After | Gain | +|--------|-------|------| +| 30 min/week manual entry | 5 min/week | **83% time saved** | +| 3 separate Excel files | 1 unified file | **Simplicity** | +| Manual calculations prone to error | Automatic formulas | **Zero errors** | +| No global vision | Real-time dashboard | **Better decisions** | +| Amateur presentation | Professional design | **Client credibility** | + +### Project ROI + +- **Investment**: 9h development @ $75/h = $675 +- **Annual gain**: 25h saved @ $75/h = $1,875 +- **ROI**: **178% first year** + +Not counting: +- More accurate billing (less under-billing) +- Better rate negotiation (knowledge of actual rate) +- Identification of unprofitable clients + +### Testimonial (Simulated) + +> "Before I had 3 different Excel files and spent 30 minutes every Friday doing my calculations. Now everything is centralized and KPIs are up-to-date in real-time. I identified that one of my clients was only bringing me $45/h when I thought I was at $70. I was able to renegotiate my rates thanks to this data." +> +> — **Marie L.**, Freelance Marketing Consultant + +### Possible Evolution (V2) + +| Feature | Complexity | Impact | +|---------|------------|--------| +| Automatic connection to TimeTrack Pro (Access) | Medium | ++++ | +| Import invoices from accounting software | Medium | +++ | +| Forecast / Quarterly objectives | Easy | ++ | +| Multi-currency with API exchange rates | Hard | ++ | +| Automatic export to Google Sheets | Medium | + | +| Mobile app (time entry) | Very hard | ++++ | + +--- + +## Appendices + +### Resources + +- **Excel Documentation**: [Microsoft Support](https://support.microsoft.com/excel) +- **VBA Reference**: [Microsoft Docs](https://docs.microsoft.com/vba) +- **VBA MCP Server**: [GitHub Repository](https://github.com/AlexisTrouve?tab=repositories) +- **Advanced Formulas**: File `FORMULAS.md` +- **Data Schema**: File `DATA_MODEL.md` + +### Project Files + +``` +freelance-dashboard/ +├── README.md # User documentation +├── TECHNICAL_REFERENCE.md # THIS FILE - Technical reference +├── PLAN.md # Project plan (9h) +├── DATA_MODEL.md # Table schema +├── FORMULAS.md # All Excel formulas +├── CLAUDE.md # AI instructions +├── docs/ +│ └── MCP_VBA_GUIDE.md # MCP guide +├── templates/ +│ └── FreelanceDashboard.xlsx # Final Excel file +└── scripts/ + └── populate_demo.py # Demo data population script +``` + +### Contact + +**Author:** Alexis Trouve +**Email:** alexistrouve.pro@gmail.com +**GitHub:** https://github.com/AlexisTrouve?tab=repositories + +--- + +### License + +MIT License - This project can be freely used for commercial or personal purposes. + +--- + +**Document Version:** 1.0 +**Creation Date:** 2025-01-13 +**Last Update:** 2025-01-13 +**Status:** Production Ready diff --git a/TECHNICAL_REFERENCE_EN.pdf b/TECHNICAL_REFERENCE_EN.pdf new file mode 100644 index 0000000..f1ce398 Binary files /dev/null and b/TECHNICAL_REFERENCE_EN.pdf differ diff --git a/convert_to_pdf.py b/convert_to_pdf.py new file mode 100644 index 0000000..f4b91dc --- /dev/null +++ b/convert_to_pdf.py @@ -0,0 +1,143 @@ +#!/usr/bin/env python3 +""" +Simple Markdown to PDF converter using markdown2 and reportlab +""" +import markdown2 +from reportlab.lib.pagesizes import letter, A4 +from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle +from reportlab.lib.units import inch +from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak, Table, TableStyle +from reportlab.lib import colors +from reportlab.lib.enums import TA_LEFT, TA_CENTER, TA_JUSTIFY +from html.parser import HTMLParser +import re + +class MarkdownToPDFConverter: + def __init__(self, input_file, output_file): + self.input_file = input_file + self.output_file = output_file + self.doc = SimpleDocTemplate( + output_file, + pagesize=A4, + rightMargin=72, + leftMargin=72, + topMargin=72, + bottomMargin=18 + ) + self.styles = getSampleStyleSheet() + self._setup_styles() + self.story = [] + + def _setup_styles(self): + """Setup custom styles""" + # Title style + self.styles.add(ParagraphStyle( + name='CustomTitle', + parent=self.styles['Heading1'], + fontSize=24, + textColor=colors.HexColor('#2C3E50'), + spaceAfter=30, + alignment=TA_CENTER + )) + + # Heading 2 + self.styles.add(ParagraphStyle( + name='CustomHeading2', + parent=self.styles['Heading2'], + fontSize=18, + textColor=colors.HexColor('#2C3E50'), + spaceAfter=12, + spaceBefore=12 + )) + + # Heading 3 + self.styles.add(ParagraphStyle( + name='CustomHeading3', + parent=self.styles['Heading3'], + fontSize=14, + textColor=colors.HexColor('#27AE60'), + spaceAfter=10, + spaceBefore=10 + )) + + # Code style + self.styles.add(ParagraphStyle( + name='Code', + parent=self.styles['Normal'], + fontSize=8, + textColor=colors.black, + backColor=colors.HexColor('#ECF0F1'), + leftIndent=20, + rightIndent=20 + )) + + def convert(self): + """Convert markdown file to PDF""" + # Read markdown file + with open(self.input_file, 'r', encoding='utf-8') as f: + md_content = f.read() + + # Convert markdown to HTML + html = markdown2.markdown(md_content, extras=['tables', 'fenced-code-blocks', 'header-ids']) + + # Parse HTML and convert to PDF elements + self._parse_html_to_pdf(html) + + # Build PDF + self.doc.build(self.story) + + def _parse_html_to_pdf(self, html): + """Parse HTML and convert to PDF elements""" + # Split by major sections + lines = html.split('\n') + + for line in lines: + line = line.strip() + if not line: + continue + + # Handle headings + if line.startswith('', '', line) + self.story.append(Paragraph(text, self.styles['CustomTitle'])) + self.story.append(Spacer(1, 0.2*inch)) + + elif line.startswith('', '', line) + self.story.append(Spacer(1, 0.2*inch)) + self.story.append(Paragraph(text, self.styles['CustomHeading2'])) + self.story.append(Spacer(1, 0.1*inch)) + + elif line.startswith('', '', line) + self.story.append(Paragraph(text, self.styles['CustomHeading3'])) + self.story.append(Spacer(1, 0.1*inch)) + + elif line.startswith('

'): + text = re.sub(r'<.*?>', '', line) + if text: + self.story.append(Paragraph(text, self.styles['Normal'])) + self.story.append(Spacer(1, 0.1*inch)) + + elif line.startswith('') or line.startswith('

'):
+                text = re.sub(r'<.*?>', '', line)
+                if text:
+                    self.story.append(Paragraph(text, self.styles['Code']))
+                    self.story.append(Spacer(1, 0.1*inch))
+
+            elif line.startswith('
  • '):
+                text = re.sub(r'<.*?>', '', line)
+                if text:
+                    self.story.append(Paragraph(f"• {text}", self.styles['Normal']))
+
+            elif line.startswith(' Nouveau classeur > Enregistrer comme `FreelanceDashboard.xlsx`
+
+**Emplacement:** `C:\Users\alexi\Documents\projects\freelance-dashboard\templates\FreelanceDashboard.xlsx`
+
+### Creer les onglets
+
+Renommer/creer les feuilles:
+1. Dashboard
+2. Data_Clients
+3. Data_Temps
+4. Data_Revenus
+5. Config
+
+---
+
+## Etape 2: Creer les Tables de Donnees
+
+### Data_Clients
+
+```
+Utilise set_worksheet_data pour ecrire les donnees:
+```
+
+```python
+# En-tetes + donnees
+data = [
+    ["ClientID", "Nom", "Secteur", "DateDebut"],
+    ["CLI001", "Acme Corporation", "Tech", "15/01/2024"],
+    ["CLI002", "Tech Solutions", "Tech", "01/03/2024"],
+    ["CLI003", "Marketing Pro", "Marketing", "10/06/2024"],
+    ["CLI004", "E-Shop Plus", "E-commerce", "22/09/2024"],
+    ["CLI005", "Finance Group", "Finance", "05/11/2024"],
+]
+set_worksheet_data("FreelanceDashboard.xlsx", "Data_Clients", data)
+```
+
+```
+Puis creer la table structuree:
+```
+
+```python
+create_excel_table("FreelanceDashboard.xlsx", "Data_Clients", "A1:D6", "tbl_Clients", has_headers=True)
+```
+
+### Data_Temps
+
+```python
+data = [
+    ["Date", "ClientID", "Projet", "Heures", "Description"],
+    ["02/01/2025", "CLI001", "Site Web", 3.5, "Maquettes"],
+    ["02/01/2025", "CLI002", "API Backend", 6.0, "Endpoints"],
+    ["03/01/2025", "CLI001", "Site Web", 4.0, "Integration"],
+    ["03/01/2025", "CLI003", "Campagne SEO", 2.5, "Audit"],
+    ["06/01/2025", "CLI002", "API Backend", 7.0, "Tests"],
+    ["06/01/2025", "CLI004", "Boutique", 5.0, "Setup"],
+    ["07/01/2025", "CLI001", "Maintenance", 1.5, "Updates"],
+    ["08/01/2025", "CLI003", "Campagne SEO", 3.0, "Keywords"],
+    ["08/01/2025", "CLI005", "Dashboard", 4.5, "Design"],
+    ["09/01/2025", "CLI002", "App Mobile", 6.5, "Screens"],
+]
+set_worksheet_data("FreelanceDashboard.xlsx", "Data_Temps", data)
+create_excel_table("FreelanceDashboard.xlsx", "Data_Temps", "A1:E11", "tbl_Temps", has_headers=True)
+```
+
+### Data_Revenus
+
+```python
+data = [
+    ["Date", "ClientID", "Montant", "Type"],
+    ["15/01/2025", "CLI001", 2500, "Facture"],
+    ["20/01/2025", "CLI002", 4200, "Facture"],
+    ["25/01/2025", "CLI003", 1800, "Facture"],
+    ["28/01/2025", "CLI001", 1000, "Acompte"],
+    ["31/01/2025", "CLI004", 3500, "Facture"],
+    ["05/02/2025", "CLI002", 2800, "Facture"],
+    ["10/02/2025", "CLI005", 1500, "Acompte"],
+]
+set_worksheet_data("FreelanceDashboard.xlsx", "Data_Revenus", data)
+create_excel_table("FreelanceDashboard.xlsx", "Data_Revenus", "A1:D8", "tbl_Revenus", has_headers=True)
+```
+
+---
+
+## Etape 3: Creer la Configuration
+
+```python
+data = [
+    ["Parametre", "Valeur"],
+    ["AnneeCourante", 2025],
+    ["TauxHoraireDefaut", 75],
+    ["DevisePrincipale", "EUR"],
+    ["ObjectifMensuel", 10000],
+    ["ObjectifHeures", 140],
+]
+set_worksheet_data("FreelanceDashboard.xlsx", "Config", data)
+```
+
+---
+
+## Etape 4: Ecrire les Formules KPIs
+
+```
+Sur l'onglet Dashboard, ecrire les formules:
+```
+
+```python
+kpis = [
+    ["KPI", "Valeur", "Formule"],
+    ["CA Total", "=SUM(tbl_Revenus[Montant])", ""],
+    ["Heures Totales", "=SUM(tbl_Temps[Heures])", ""],
+    ["Taux Horaire Moyen", "=B2/B3", ""],
+    ["Nb Clients", "=COUNTA(tbl_Clients[ClientID])", ""],
+]
+set_worksheet_data("FreelanceDashboard.xlsx", "Dashboard", kpis, start_cell="A1")
+```
+
+---
+
+## Etape 5: VBA Optionnel (Refresh)
+
+```
+Injecter une macro pour rafraichir les donnees:
+```
+
+```python
+code = '''
+Sub RefreshDashboard()
+    ' Rafraichit toutes les connexions et TCD
+    Application.CalculateFull
+
+    Dim ws As Worksheet
+    For Each ws In ThisWorkbook.Worksheets
+        Dim pt As PivotTable
+        For Each pt In ws.PivotTables
+            pt.RefreshTable
+        Next pt
+    Next ws
+
+    MsgBox "Dashboard actualise!", vbInformation
+End Sub
+
+Sub AutoRefresh()
+    ' Appele a l'ouverture du classeur
+    RefreshDashboard
+End Sub
+'''
+
+validate_vba(code, file_type="excel")
+inject_vba("FreelanceDashboard.xlsm", "mod_Refresh", code)
+```
+
+---
+
+## Commandes Frequentes
+
+### Lire les donnees
+
+```
+get_worksheet_data("FreelanceDashboard.xlsx", "Data_Temps")
+```
+
+### Ajouter une entree de temps
+
+```python
+# Lire donnees existantes, ajouter ligne, reecrire
+# Ou utiliser insert_rows
+insert_rows("FreelanceDashboard.xlsx", "Data_Temps", position=12, count=1)
+set_worksheet_data("FreelanceDashboard.xlsx", "Data_Temps",
+    [["10/01/2025", "CLI001", "Nouveau", 2.5, "Test"]],
+    start_cell="A12")
+```
+
+### Lister les tables
+
+```
+list_excel_tables("FreelanceDashboard.xlsx")
+```
+
+### Ouvrir Excel visible
+
+```
+open_in_office("FreelanceDashboard.xlsx")
+```
+
+### Executer macro refresh
+
+```
+run_macro("FreelanceDashboard.xlsm", "RefreshDashboard")
+```
+
+---
+
+## Ce qui doit etre fait dans Excel UI
+
+| Element | Raison |
+|---------|--------|
+| Tableaux Croises Dynamiques | Interface complexe |
+| Graphiques | Design visuel precis |
+| Slicers | Connexion aux TCD |
+| Mise en forme conditionnelle | Regles visuelles |
+| Layout Dashboard | Positionnement precis |
+
+---
+
+## Workflow Complet
+
+```
+1. Creer fichier Excel vide      → Manuel
+2. set_worksheet_data            → Donnees clients
+3. set_worksheet_data            → Donnees temps
+4. set_worksheet_data            → Donnees revenus
+5. create_excel_table (x3)       → Tables structurees
+6. set_worksheet_data            → Config
+7. set_worksheet_data            → Formules KPIs
+8. Creer TCD                     → Excel UI
+9. Creer graphiques              → Excel UI
+10. Design dashboard             → Excel UI
+11. inject_vba                   → Macro refresh (optionnel)
+```
+
+---
+
+## Fichiers de Reference
+
+| Fichier | Contenu |
+|---------|---------|
+| `DATA_MODEL.md` | Schema tables + donnees demo |
+| `FORMULAS.md` | Toutes les formules Excel |
+| `PLAN.md` | Layout, couleurs, phases |
diff --git a/md_to_html.py b/md_to_html.py
new file mode 100644
index 0000000..0f191f6
--- /dev/null
+++ b/md_to_html.py
@@ -0,0 +1,233 @@
+#!/usr/bin/env python3
+"""
+Convert Markdown to styled HTML that can be printed to PDF from browser
+"""
+import markdown
+import os
+
+def convert_md_to_html(input_file, output_file):
+    """Convert markdown file to HTML"""
+
+    # Read markdown file
+    with open(input_file, 'r', encoding='utf-8') as f:
+        md_content = f.read()
+
+    # Convert markdown to HTML
+    html = markdown.markdown(md_content, extensions=['tables', 'fenced_code', 'codehilite'])
+
+    # Add CSS styling
+    html_with_style = f"""
+    
+    
+    
+        
+        
+        Freelance Dashboard - Technical Reference
+        
+        
+    
+    
+        
+        {html}
+    
+    
+    """
+
+    # Save HTML
+    with open(output_file, 'w', encoding='utf-8') as f:
+        f.write(html_with_style)
+
+    print(f"HTML created successfully: {output_file}")
+    print(f"\nTo create PDF:")
+    print(f"1. Open the HTML file in your browser")
+    print(f"2. Click 'Print to PDF' button or use Ctrl+P")
+    print(f"3. Select 'Save as PDF' as destination")
+    print(f"4. Save the file")
+
+if __name__ == '__main__':
+    input_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.md'
+    output_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.html'
+
+    if os.path.exists(input_file):
+        convert_md_to_html(input_file, output_file)
+
+        # Open in default browser
+        import webbrowser
+        webbrowser.open(f'file:///{output_file}')
+    else:
+        print(f"Input file not found: {input_file}")
diff --git a/md_to_pdf_final.py b/md_to_pdf_final.py
new file mode 100644
index 0000000..79189dc
--- /dev/null
+++ b/md_to_pdf_final.py
@@ -0,0 +1,211 @@
+#!/usr/bin/env python3
+"""
+Convert Markdown to PDF with perfect UTF-8 support using Playwright
+"""
+import markdown
+import os
+from playwright.sync_api import sync_playwright
+
+def convert_md_to_pdf(input_file, output_file):
+    """Convert markdown file to PDF using browser rendering"""
+
+    # Read markdown file
+    with open(input_file, 'r', encoding='utf-8') as f:
+        md_content = f.read()
+
+    # Convert markdown to HTML
+    html = markdown.markdown(md_content, extensions=['tables', 'fenced_code', 'codehilite'])
+
+    # Add CSS styling
+    html_with_style = f"""
+    
+    
+    
+        
+        
+        Freelance Dashboard - Technical Reference
+        
+    
+    
+        {html}
+    
+    
+    """
+
+    # Create temporary HTML file
+    temp_html = output_file.replace('.pdf', '_temp.html')
+    with open(temp_html, 'w', encoding='utf-8') as f:
+        f.write(html_with_style)
+
+    # Convert HTML to PDF using Playwright
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        page = browser.new_page()
+        page.goto(f'file:///{os.path.abspath(temp_html)}')
+        page.pdf(
+            path=output_file,
+            format='A4',
+            margin={
+                'top': '2cm',
+                'right': '2cm',
+                'bottom': '2cm',
+                'left': '2cm'
+            },
+            print_background=True
+        )
+        browser.close()
+
+    # Clean up temporary HTML
+    if os.path.exists(temp_html):
+        os.remove(temp_html)
+
+    print(f"PDF created successfully: {output_file}")
+    print(f"File size: {os.path.getsize(output_file) / 1024:.2f} KB")
+
+if __name__ == '__main__':
+    input_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.md'
+    output_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.pdf'
+
+    if os.path.exists(input_file):
+        convert_md_to_pdf(input_file, output_file)
+    else:
+        print(f"Input file not found: {input_file}")
diff --git a/md_to_pdf_fpdf.py b/md_to_pdf_fpdf.py
new file mode 100644
index 0000000..906c405
--- /dev/null
+++ b/md_to_pdf_fpdf.py
@@ -0,0 +1,150 @@
+#!/usr/bin/env python3
+"""
+Markdown to PDF converter with proper UTF-8 support using fpdf2
+"""
+import markdown
+from fpdf import FPDF
+import re
+import os
+
+class PDF(FPDF):
+    def __init__(self):
+        super().__init__()
+        self.set_auto_page_break(auto=True, margin=15)
+
+    def header(self):
+        # Header with title
+        pass
+
+    def footer(self):
+        # Page number
+        self.set_y(-15)
+        self.set_font('Arial', 'I', 8)
+        self.set_text_color(128, 128, 128)
+        self.cell(0, 10, f'Page {self.page_no()}', 0, 0, 'C')
+
+class MarkdownToPDF:
+    def __init__(self, input_file, output_file):
+        self.input_file = input_file
+        self.output_file = output_file
+        self.pdf = PDF()
+        self.pdf.add_page()
+
+    def convert(self):
+        # Read markdown
+        with open(self.input_file, 'r', encoding='utf-8') as f:
+            md_content = f.read()
+
+        # Parse line by line
+        lines = md_content.split('\n')
+
+        for line in lines:
+            line = line.strip()
+
+            if not line:
+                self.pdf.ln(3)
+                continue
+
+            # Main title (H1)
+            if line.startswith('# ') and not line.startswith('## '):
+                title = line[2:].strip()
+                self.pdf.set_font('Arial', 'B', 20)
+                self.pdf.set_text_color(44, 62, 80)  # #2C3E50
+                self.pdf.multi_cell(0, 10, title, align='C')
+                self.pdf.ln(5)
+
+            # H2
+            elif line.startswith('## ') and not line.startswith('### '):
+                title = line[3:].strip()
+                self.pdf.ln(3)
+                self.pdf.set_font('Arial', 'B', 16)
+                self.pdf.set_text_color(44, 62, 80)
+                self.pdf.multi_cell(0, 8, title)
+                self.pdf.ln(2)
+
+            # H3
+            elif line.startswith('### ') and not line.startswith('#### '):
+                title = line[4:].strip()
+                self.pdf.ln(2)
+                self.pdf.set_font('Arial', 'B', 14)
+                self.pdf.set_text_color(39, 174, 96)  # #27AE60
+                self.pdf.multi_cell(0, 7, title)
+                self.pdf.ln(1)
+
+            # H4
+            elif line.startswith('#### '):
+                title = line[5:].strip()
+                self.pdf.ln(1)
+                self.pdf.set_font('Arial', 'B', 12)
+                self.pdf.set_text_color(44, 62, 80)
+                self.pdf.multi_cell(0, 6, title)
+
+            # Horizontal rule
+            elif line.startswith('---'):
+                self.pdf.ln(2)
+
+            # Code block start/end (```)
+            elif line.startswith('```'):
+                continue
+
+            # List item
+            elif line.startswith('- ') or line.startswith('* '):
+                text = line[2:].strip()
+                # Remove markdown formatting
+                text = self._clean_markdown(text)
+                self.pdf.set_font('Arial', '', 10)
+                self.pdf.set_text_color(51, 51, 51)
+                self.pdf.set_x(self.pdf.l_margin + 5)
+                self.pdf.multi_cell(0, 5, f'• {text}')
+
+            # Blockquote
+            elif line.startswith('>'):
+                text = line[1:].strip()
+                text = self._clean_markdown(text)
+                self.pdf.set_font('Arial', 'I', 10)
+                self.pdf.set_text_color(85, 85, 85)
+                self.pdf.set_fill_color(245, 245, 245)
+                self.pdf.multi_cell(0, 5, text, fill=True)
+
+            # Table separator
+            elif line.startswith('|') and '---' in line:
+                continue
+
+            # Table row
+            elif line.startswith('|'):
+                continue  # Skip tables for now (complex to render)
+
+            # Normal paragraph
+            else:
+                # Skip if it's likely a table header or separator
+                if '|' in line:
+                    continue
+
+                text = self._clean_markdown(line)
+                if text:
+                    self.pdf.set_font('Arial', '', 10)
+                    self.pdf.set_text_color(51, 51, 51)
+                    self.pdf.multi_cell(0, 5, text)
+
+        # Save PDF
+        self.pdf.output(self.output_file)
+        print(f"PDF created successfully: {self.output_file}")
+
+    def _clean_markdown(self, text):
+        """Remove markdown formatting"""
+        # Remove bold **text**
+        text = re.sub(r'\*\*(.*?)\*\*', r'\1', text)
+        # Remove italic *text*
+        text = re.sub(r'\*(.*?)\*', r'\1', text)
+        # Remove inline code `text`
+        text = re.sub(r'`(.*?)`', r'\1', text)
+        # Remove links [text](url)
+        text = re.sub(r'\[(.*?)\]\(.*?\)', r'\1', text)
+        return text
+
+if __name__ == '__main__':
+    input_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.md'
+    output_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.pdf'
+
+    converter = MarkdownToPDF(input_file, output_file)
+    converter.convert()
diff --git a/md_to_pdf_simple.py b/md_to_pdf_simple.py
new file mode 100644
index 0000000..36d4dbd
--- /dev/null
+++ b/md_to_pdf_simple.py
@@ -0,0 +1,163 @@
+#!/usr/bin/env python3
+"""
+Simple Markdown to PDF converter using markdown and xhtml2pdf
+"""
+import markdown
+from xhtml2pdf import pisa
+import os
+
+def convert_md_to_pdf(input_file, output_file):
+    """Convert markdown file to PDF"""
+
+    # Read markdown file
+    with open(input_file, 'r', encoding='utf-8') as f:
+        md_content = f.read()
+
+    # Convert markdown to HTML
+    html = markdown.markdown(md_content, extensions=['tables', 'fenced_code', 'codehilite'])
+
+    # Add CSS styling
+    html_with_style = f"""
+    
+    
+    
+        
+        
+    
+    
+        {html}
+    
+    
+    """
+
+    # Convert HTML to PDF with encoding
+    with open(output_file, 'wb') as pdf_file:
+        pisa_status = pisa.CreatePDF(
+            html_with_style.encode('utf-8'),
+            dest=pdf_file,
+            encoding='utf-8'
+        )
+
+    if pisa_status.err:
+        print(f"Error creating PDF: {pisa_status.err}")
+        return False
+    else:
+        print(f"PDF created successfully: {output_file}")
+        return True
+
+if __name__ == '__main__':
+    input_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.md'
+    output_file = r'C:\Users\alexi\Documents\projects\freelance-dashboard\TECHNICAL_REFERENCE_EN.pdf'
+
+    if os.path.exists(input_file):
+        convert_md_to_pdf(input_file, output_file)
+    else:
+        print(f"Input file not found: {input_file}")
diff --git a/plans/implemPlan.md b/plans/implemPlan.md
new file mode 100644
index 0000000..ec2cffc
--- /dev/null
+++ b/plans/implemPlan.md
@@ -0,0 +1,587 @@
+# Freelance Dashboard - Plan d'Implementation Agent
+
+## Vue d'Ensemble
+
+**Objectif:** Creer un dashboard Excel KPI pour suivi d'activite freelance
+**Fichier cible:** `templates/FreelanceDashboard.xlsx`
+**Outils:** MCP VBA Server (vba-mcp-pro)
+
+---
+
+## Pre-requis
+
+Avant de commencer, verifier:
+- [ ] MCP VBA Server est connecte et fonctionnel
+- [ ] Microsoft Excel est installe sur la machine
+- [ ] Le dossier `templates/` existe
+
+---
+
+## Phase 1: Preparation et Structure Fichier
+
+### Step 1.1: Creer le dossier templates
+
+```bash
+# Verifier/creer le dossier
+mkdir templates
+```
+
+**Verification:** Le dossier `templates/` existe
+
+### Step 1.2: Creer le fichier Excel vide avec les onglets
+
+**Action manuelle requise:**
+1. Ouvrir Excel
+2. Creer un nouveau classeur
+3. Renommer les feuilles:
+   - Feuil1 → Dashboard
+   - Ajouter: Data_Clients
+   - Ajouter: Data_Temps
+   - Ajouter: Data_Revenus
+   - Ajouter: Config
+4. Sauvegarder comme `templates/FreelanceDashboard.xlsx`
+
+**Alternative MCP:** Utiliser `open_in_office` sur un fichier existant, mais la creation initiale est manuelle.
+
+**Verification:**
+```
+list_tables(file_path="templates/FreelanceDashboard.xlsx")
+```
+Doit retourner les 5 onglets.
+
+---
+
+## Phase 2: Creation des Tables de Donnees
+
+### Step 2.1: Peupler Data_Clients
+
+**Outil:** `set_worksheet_data`
+
+**Donnees:**
+```json
+{
+  "file_path": "C:\\Users\\alexi\\Documents\\projects\\freelance-dashboard\\templates\\FreelanceDashboard.xlsx",
+  "sheet_name": "Data_Clients",
+  "data": [
+    ["ClientID", "Nom", "Secteur", "DateDebut"],
+    ["CLI001", "Acme Corporation", "Tech", "15/01/2024"],
+    ["CLI002", "Tech Solutions", "Tech", "01/03/2024"],
+    ["CLI003", "Marketing Pro", "Marketing", "10/06/2024"],
+    ["CLI004", "E-Shop Plus", "E-commerce", "22/09/2024"],
+    ["CLI005", "Finance Group", "Finance", "05/11/2024"]
+  ],
+  "start_cell": "A1"
+}
+```
+
+**Verification:** `get_worksheet_data` sur Data_Clients doit retourner 6 lignes (header + 5 clients)
+
+### Step 2.2: Convertir en Excel Table (tbl_Clients)
+
+**Outil:** `create_table`
+
+**Parametres:**
+```json
+{
+  "file_path": "...",
+  "sheet_name": "Data_Clients",
+  "range": "A1:D6",
+  "table_name": "tbl_Clients",
+  "has_headers": true,
+  "style": "TableStyleMedium2"
+}
+```
+
+**Verification:** `list_tables` doit montrer `tbl_Clients`
+
+### Step 2.3: Peupler Data_Temps
+
+**Outil:** `set_worksheet_data`
+
+**Donnees:**
+```json
+{
+  "sheet_name": "Data_Temps",
+  "data": [
+    ["Date", "ClientID", "Projet", "Heures", "Description"],
+    ["02/01/2025", "CLI001", "Site Web", 3.5, "Maquettes"],
+    ["02/01/2025", "CLI002", "API Backend", 6.0, "Endpoints"],
+    ["03/01/2025", "CLI001", "Site Web", 4.0, "Integration"],
+    ["03/01/2025", "CLI003", "Campagne SEO", 2.5, "Audit"],
+    ["06/01/2025", "CLI002", "API Backend", 7.0, "Tests"],
+    ["06/01/2025", "CLI004", "Boutique", 5.0, "Setup"],
+    ["07/01/2025", "CLI001", "Maintenance", 1.5, "Updates"],
+    ["08/01/2025", "CLI003", "Campagne SEO", 3.0, "Keywords"],
+    ["08/01/2025", "CLI005", "Dashboard", 4.5, "Design"],
+    ["09/01/2025", "CLI002", "App Mobile", 6.5, "Screens"]
+  ],
+  "start_cell": "A1"
+}
+```
+
+**Verification:** 11 lignes (header + 10 entrees)
+
+### Step 2.4: Convertir en Excel Table (tbl_Temps)
+
+**Outil:** `create_table`
+
+**Parametres:**
+```json
+{
+  "sheet_name": "Data_Temps",
+  "range": "A1:E11",
+  "table_name": "tbl_Temps",
+  "has_headers": true
+}
+```
+
+### Step 2.5: Peupler Data_Revenus
+
+**Outil:** `set_worksheet_data`
+
+**Donnees:**
+```json
+{
+  "sheet_name": "Data_Revenus",
+  "data": [
+    ["Date", "ClientID", "Montant", "Type"],
+    ["15/01/2025", "CLI001", 2500, "Facture"],
+    ["20/01/2025", "CLI002", 4200, "Facture"],
+    ["25/01/2025", "CLI003", 1800, "Facture"],
+    ["28/01/2025", "CLI001", 1000, "Acompte"],
+    ["31/01/2025", "CLI004", 3500, "Facture"],
+    ["05/02/2025", "CLI002", 2800, "Facture"],
+    ["10/02/2025", "CLI005", 1500, "Acompte"]
+  ],
+  "start_cell": "A1"
+}
+```
+
+### Step 2.6: Convertir en Excel Table (tbl_Revenus)
+
+**Outil:** `create_table`
+
+**Parametres:**
+```json
+{
+  "sheet_name": "Data_Revenus",
+  "range": "A1:D8",
+  "table_name": "tbl_Revenus",
+  "has_headers": true
+}
+```
+
+### Step 2.7: Verification Phase 2
+
+**Action:** `list_tables` sur le fichier
+
+**Resultat attendu:**
+- tbl_Clients (Data_Clients, 5 lignes)
+- tbl_Temps (Data_Temps, 10 lignes)
+- tbl_Revenus (Data_Revenus, 7 lignes)
+
+---
+
+## Phase 3: Configuration
+
+### Step 3.1: Peupler Config
+
+**Outil:** `set_worksheet_data`
+
+**Donnees:**
+```json
+{
+  "sheet_name": "Config",
+  "data": [
+    ["Parametre", "Valeur", "", "Secteurs", "", "Types"],
+    ["AnneeCourante", 2025, "", "Tech", "", "Facture"],
+    ["TauxHoraireDefaut", 75, "", "Marketing", "", "Acompte"],
+    ["DevisePrincipale", "EUR", "", "Finance", "", "Avoir"],
+    ["ObjectifMensuel", 10000, "", "E-commerce", "", "Autre"],
+    ["ObjectifHeures", 140, "", "Industrie", "", ""],
+    ["JourDebutSemaine", 2, "", "Services", "", ""],
+    ["", "", "", "Autre", "", ""]
+  ],
+  "start_cell": "A1"
+}
+```
+
+**Note:** Les colonnes D et F serviront de listes deroulantes pour la validation des donnees.
+
+---
+
+## Phase 4: Formules KPIs sur Dashboard
+
+### Step 4.1: Structure du Dashboard - Labels
+
+**Outil:** `set_worksheet_data`
+
+**Donnees (colonne A - labels):**
+```json
+{
+  "sheet_name": "Dashboard",
+  "data": [
+    ["FREELANCE DASHBOARD"],
+    [""],
+    ["KPIs Principaux"],
+    ["CA Total"],
+    ["CA Mois en cours"],
+    ["Heures Totales"],
+    ["Taux Horaire Moyen"],
+    ["Nb Clients Actifs"],
+    ["Heures Cette Semaine"],
+    [""],
+    ["Top Client"],
+    [""],
+    ["Periode"],
+    ["Date Debut"],
+    ["Date Fin"]
+  ],
+  "start_cell": "A1"
+}
+```
+
+### Step 4.2: Formules KPIs - Valeurs
+
+**Outil:** `set_worksheet_data`
+
+**Donnees (colonne B - formules):**
+```json
+{
+  "sheet_name": "Dashboard",
+  "data": [
+    [""],
+    [""],
+    [""],
+    ["=SUM(tbl_Revenus[Montant])"],
+    ["=SUMPRODUCT((MONTH(tbl_Revenus[Date])=MONTH(TODAY()))*(YEAR(tbl_Revenus[Date])=YEAR(TODAY()))*tbl_Revenus[Montant])"],
+    ["=SUM(tbl_Temps[Heures])"],
+    ["=IFERROR(B4/B6,0)"],
+    ["=COUNTA(tbl_Clients[ClientID])"],
+    ["=SUMIFS(tbl_Temps[Heures],tbl_Temps[Date],\">=\"&(TODAY()-WEEKDAY(TODAY(),2)+1),tbl_Temps[Date],\"<=\"&(TODAY()-WEEKDAY(TODAY(),2)+7))"],
+    [""],
+    ["=IFERROR(INDEX(tbl_Clients[Nom],MATCH(MAX(SUMIFS(tbl_Revenus[Montant],tbl_Revenus[ClientID],tbl_Clients[ClientID])),SUMIFS(tbl_Revenus[Montant],tbl_Revenus[ClientID],tbl_Clients[ClientID]),0)),\"-\")"],
+    [""],
+    [""],
+    ["=MIN(tbl_Temps[Date])"],
+    ["=MAX(tbl_Temps[Date])"]
+  ],
+  "start_cell": "B1"
+}
+```
+
+**Note:** Certaines formules complexes comme Top Client peuvent necessiter validation. Si erreur, utiliser version simplifiee.
+
+### Step 4.3: Verification des formules
+
+**Outil:** `get_worksheet_data`
+
+**Parametres:**
+```json
+{
+  "sheet_name": "Dashboard",
+  "range": "A1:B15"
+}
+```
+
+**Resultat attendu:**
+- B4 (CA Total) = 17300 (somme des montants)
+- B6 (Heures Totales) = 43.5 (somme des heures)
+- B7 (Taux Horaire) = ~397.70 (17300/43.5)
+- B8 (Nb Clients) = 5
+
+---
+
+## Phase 5: Tableaux Croises Dynamiques (MANUEL)
+
+> **IMPORTANT:** Cette phase ne peut PAS etre automatisee avec MCP VBA.
+> Elle doit etre realisee manuellement dans Excel.
+
+### Step 5.1: TCD - CA par Client
+
+**Actions manuelles:**
+1. Selectionner une cellule dans tbl_Revenus
+2. Insertion > Tableau croise dynamique
+3. Placer sur nouvelle feuille ou Dashboard
+4. Configuration:
+   - Lignes: ClientID
+   - Valeurs: Somme de Montant
+5. Renommer la feuille TCD si creee
+
+### Step 5.2: TCD - Heures par Mois
+
+**Configuration:**
+- Lignes: Date (grouper par mois)
+- Valeurs: Somme de Heures
+
+### Step 5.3: TCD - CA par Mois
+
+**Configuration:**
+- Lignes: Date (grouper par mois)
+- Valeurs: Somme de Montant
+
+---
+
+## Phase 6: Graphiques (MANUEL)
+
+> **IMPORTANT:** Cette phase ne peut PAS etre automatisee avec MCP VBA.
+
+### Step 6.1: Graphique - Evolution CA Mensuel
+
+**Type:** Histogramme ou Courbe
+**Source:** TCD CA par Mois
+**Position:** Dashboard, zone superieure gauche
+
+### Step 6.2: Graphique - Repartition par Client
+
+**Type:** Camembert
+**Source:** TCD CA par Client
+**Position:** Dashboard, zone superieure droite
+
+### Step 6.3: Graphique - Heures par Semaine
+
+**Type:** Histogramme
+**Source:** TCD Heures par Mois (ou semaine)
+**Position:** Dashboard, zone inferieure gauche
+
+### Step 6.4: Graphique - CA vs Heures
+
+**Type:** Graphique combine (barres + ligne)
+**Source:** Donnees agregees
+**Position:** Dashboard, zone inferieure droite
+
+---
+
+## Phase 7: Slicers et Filtres (MANUEL)
+
+### Step 7.1: Creer Slicer Client
+
+1. Selectionner un TCD
+2. Insertion > Segment
+3. Choisir ClientID
+4. Connecter aux autres TCD (clic droit > Connexions de rapport)
+
+### Step 7.2: Creer Slicer Periode
+
+1. Segment sur Date (annee/mois)
+2. Connecter aux TCD
+
+### Step 7.3: Positionner les Slicers
+
+- Placer en haut a droite du Dashboard
+- Redimensionner pour integration visuelle
+
+---
+
+## Phase 8: Design et Mise en Forme (MANUEL)
+
+### Step 8.1: Palette Couleurs
+
+| Element | Couleur | Hex |
+|---------|---------|-----|
+| Titre/Headers | Bleu fonce | #2C3E50 |
+| KPIs positifs | Vert | #27AE60 |
+| Fond | Gris clair | #ECF0F1 |
+| Alertes | Rouge | #E74C3C |
+
+### Step 8.2: Mise en forme des KPIs
+
+- Police: Calibri 24-28pt Bold pour valeurs
+- Format nombres: `# ##0 "€"` pour montants
+- Format heures: `0.0 "h"`
+- Format taux: `0.00 "€/h"`
+
+### Step 8.3: Mise en forme conditionnelle
+
+**KPI CA vs Objectif:**
+- Vert si >= Config!ObjectifMensuel
+- Orange si >= 80%
+- Rouge si < 80%
+
+### Step 8.4: Layout Final
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  FREELANCE DASHBOARD                    [Slicers]       │
+├─────────────────────────────────────────────────────────┤
+│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │
+│  │ CA Total│ │CA Mois  │ │ Heures  │ │Taux Moy │       │
+│  │  17300€ │ │    0€   │ │  43.5h  │ │ 398€/h  │       │
+│  └─────────┘ └─────────┘ └─────────┘ └─────────┘       │
+├─────────────────────────────────────────────────────────┤
+│  [Graph CA Mensuel]           [Graph Repartition]       │
+│                                                         │
+│  [Graph Heures/Semaine]       [Graph CA vs Heures]      │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Phase 9: VBA Optionnel (Macro Refresh)
+
+### Step 9.1: Valider le code VBA
+
+**Outil:** `validate_vba_code`
+
+**Code:**
+```vba
+Sub RefreshDashboard()
+    Application.ScreenUpdating = False
+    Application.CalculateFull
+
+    Dim ws As Worksheet
+    Dim pt As PivotTable
+
+    For Each ws In ThisWorkbook.Worksheets
+        For Each pt In ws.PivotTables
+            pt.RefreshTable
+        Next pt
+    Next ws
+
+    Application.ScreenUpdating = True
+    MsgBox "Dashboard actualise!", vbInformation
+End Sub
+```
+
+### Step 9.2: Sauvegarder en .xlsm
+
+**Action manuelle:**
+- Fichier > Enregistrer sous > FreelanceDashboard.xlsm (format macro)
+
+### Step 9.3: Injecter le module VBA
+
+**Outil:** `inject_vba`
+
+**Parametres:**
+```json
+{
+  "file_path": "...FreelanceDashboard.xlsm",
+  "module_name": "mod_Refresh",
+  "code": "..."
+}
+```
+
+### Step 9.4: Tester la macro
+
+**Outil:** `run_macro`
+
+**Parametres:**
+```json
+{
+  "file_path": "...FreelanceDashboard.xlsm",
+  "macro_name": "RefreshDashboard"
+}
+```
+
+---
+
+## Phase 10: Tests et Validation
+
+### Step 10.1: Verification des donnees
+
+- [ ] tbl_Clients contient 5 clients
+- [ ] tbl_Temps contient 10 entrees
+- [ ] tbl_Revenus contient 7 entrees
+
+### Step 10.2: Verification des KPIs
+
+| KPI | Valeur Attendue |
+|-----|-----------------|
+| CA Total | 17 300 € |
+| Heures Totales | 43.5 h |
+| Taux Horaire | ~397.70 €/h |
+| Nb Clients | 5 |
+
+### Step 10.3: Tests fonctionnels
+
+- [ ] Les formules se calculent correctement
+- [ ] Les TCD se rafraichissent
+- [ ] Les graphiques se mettent a jour
+- [ ] Les slicers filtrent les donnees
+- [ ] La macro fonctionne (si .xlsm)
+
+### Step 10.4: Ouvrir et verifier visuellement
+
+**Outil:** `open_in_office`
+
+```json
+{
+  "file_path": "...FreelanceDashboard.xlsx"
+}
+```
+
+---
+
+## Resume des Actions par Type
+
+### Automatisables (MCP VBA)
+
+| Step | Action | Outil MCP |
+|------|--------|-----------|
+| 2.1 | Donnees Clients | set_worksheet_data |
+| 2.2 | Table Clients | create_table |
+| 2.3 | Donnees Temps | set_worksheet_data |
+| 2.4 | Table Temps | create_table |
+| 2.5 | Donnees Revenus | set_worksheet_data |
+| 2.6 | Table Revenus | create_table |
+| 3.1 | Config | set_worksheet_data |
+| 4.1 | Labels Dashboard | set_worksheet_data |
+| 4.2 | Formules KPIs | set_worksheet_data |
+| 9.1 | Valider VBA | validate_vba_code |
+| 9.3 | Injecter VBA | inject_vba |
+| 9.4 | Tester macro | run_macro |
+| 10.4 | Ouvrir Excel | open_in_office |
+
+### Manuelles (Excel UI)
+
+| Step | Action |
+|------|--------|
+| 1.2 | Creer fichier Excel + onglets |
+| 5.x | Tableaux Croises Dynamiques |
+| 6.x | Graphiques |
+| 7.x | Slicers |
+| 8.x | Design et mise en forme |
+| 9.2 | Sauvegarder en .xlsm |
+
+---
+
+## Ordre d'Execution Recommande
+
+```
+AUTOMATISE          MANUEL              AUTOMATISE
+    │                  │                    │
+    ▼                  ▼                    ▼
+[Phase 2-4]  →  [Phases 5-8]  →  [Phase 9-10]
+ Donnees         TCD/Graphs          VBA
+ Tables          Slicers            Tests
+ Formules        Design
+```
+
+**Workflow optimal:**
+1. Agent execute Phases 2-4 (donnees + formules)
+2. Utilisateur complete Phases 5-8 dans Excel UI
+3. Agent execute Phase 9 (VBA optionnel)
+4. Agent execute Phase 10 (tests)
+
+---
+
+## Notes Importantes
+
+1. **Chemin absolu obligatoire** pour tous les outils MCP:
+   `C:\Users\alexi\Documents\projects\freelance-dashboard\templates\FreelanceDashboard.xlsx`
+
+2. **Backup avant modifications:**
+   Utiliser `backup_vba` avant inject_vba
+
+3. **Gestion des erreurs:**
+   - Si formule echoue, verifier syntaxe (guillemets, virgules)
+   - Si table existe deja, ne pas recreer
+
+4. **Format dates:**
+   Les dates doivent etre au format `jj/mm/aaaa` pour Excel FR
+
+---
+
+**Version:** 1.0
+**Date:** 2025-12-30
+**Auteur:** Claude Agent
diff --git a/scripts/close_excel.vbs b/scripts/close_excel.vbs
new file mode 100644
index 0000000..ac2f60c
--- /dev/null
+++ b/scripts/close_excel.vbs
@@ -0,0 +1,9 @@
+On Error Resume Next
+Dim objExcel
+Set objExcel = GetObject(, "Excel.Application")
+If Not objExcel Is Nothing Then
+    objExcel.DisplayAlerts = False
+    objExcel.Quit
+    Set objExcel = Nothing
+End If
+WScript.Echo "Excel closed"
diff --git a/scripts/convert_to_xlsm.vbs b/scripts/convert_to_xlsm.vbs
new file mode 100644
index 0000000..8a8d873
--- /dev/null
+++ b/scripts/convert_to_xlsm.vbs
@@ -0,0 +1,28 @@
+On Error Resume Next
+
+Dim objExcel, objWorkbook
+Dim sourcePath, destPath
+
+sourcePath = "C:\Users\alexi\Documents\projects\freelance-dashboard\templates\FreelanceDashboard.xlsx"
+destPath = "C:\Users\alexi\Documents\projects\freelance-dashboard\templates\FreelanceDashboard.xlsm"
+
+Set objExcel = CreateObject("Excel.Application")
+objExcel.DisplayAlerts = False
+objExcel.Visible = False
+
+Set objWorkbook = objExcel.Workbooks.Open(sourcePath)
+
+' 52 = xlOpenXMLWorkbookMacroEnabled (.xlsm)
+objWorkbook.SaveAs destPath, 52
+
+objWorkbook.Close False
+objExcel.Quit
+
+Set objWorkbook = Nothing
+Set objExcel = Nothing
+
+If Err.Number = 0 Then
+    WScript.Echo "SUCCESS: File converted to .xlsm"
+Else
+    WScript.Echo "ERROR: " & Err.Description
+End If
diff --git a/templates/.vba_backups/.vba_backups.json b/templates/.vba_backups/.vba_backups.json
new file mode 100644
index 0000000..6b493fb
--- /dev/null
+++ b/templates/.vba_backups/.vba_backups.json
@@ -0,0 +1,11 @@
+{
+  "file": "FreelanceDashboard.xlsx",
+  "backups": [
+    {
+      "id": "20251230_121153",
+      "filename": "FreelanceDashboard_backup_20251230_121153.xlsx",
+      "created": "2025-12-30T12:11:53.147808",
+      "original_size": 17005
+    }
+  ]
+}
\ No newline at end of file
diff --git a/templates/.vba_backups/FreelanceDashboard_backup_20251230_121153.xlsx b/templates/.vba_backups/FreelanceDashboard_backup_20251230_121153.xlsx
new file mode 100644
index 0000000..12ef85c
Binary files /dev/null and b/templates/.vba_backups/FreelanceDashboard_backup_20251230_121153.xlsx differ
diff --git a/templates/.vba_backups/FreelanceDashboard_backup_20260121_141647.xlsx b/templates/.vba_backups/FreelanceDashboard_backup_20260121_141647.xlsx
new file mode 100644
index 0000000..180bba2
Binary files /dev/null and b/templates/.vba_backups/FreelanceDashboard_backup_20260121_141647.xlsx differ
diff --git a/templates/CheckboxDemo.xlsm b/templates/CheckboxDemo.xlsm
new file mode 100644
index 0000000..180bba2
Binary files /dev/null and b/templates/CheckboxDemo.xlsm differ
diff --git a/templates/FreelanceDashboard.xlsm b/templates/FreelanceDashboard.xlsm
index e34bef8..23e2d84 100644
Binary files a/templates/FreelanceDashboard.xlsm and b/templates/FreelanceDashboard.xlsm differ
diff --git a/templates/FreelanceDashboard.xlsx b/templates/FreelanceDashboard.xlsx
new file mode 100644
index 0000000..180bba2
Binary files /dev/null and b/templates/FreelanceDashboard.xlsx differ
diff --git a/templates/FreelanceDashboard_Checkboxes.xlsm b/templates/FreelanceDashboard_Checkboxes.xlsm
new file mode 100644
index 0000000..180bba2
Binary files /dev/null and b/templates/FreelanceDashboard_Checkboxes.xlsm differ