From a89fa6a7af19641274c09a1818c9e6f0606eb66d Mon Sep 17 00:00:00 2001 From: Matthieu Date: Thu, 19 Mar 2026 10:36:28 +0100 Subject: [PATCH] docs : update CLAUDE.md with Zimbra calendar integration references Co-Authored-By: Claude Sonnet 4.6 --- CLAUDE.md | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 654b363..a2ec8d0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,10 +12,11 @@ Application de gestion de projet. Monorepo Symfony 8 (API Platform 4) + Nuxt 4. ## Structure ``` -src/Entity/ # Entités Doctrine (User, Client, Project, Task, TaskStatus, TaskEffort, TaskPriority, TaskTag, TaskGroup, TimeEntry, GiteaConfiguration, ClientTicket, Notification, TaskDocument, BookStackConfiguration, TaskBookStackLink) -src/ApiResource/ # Ressources API Platform (si découplées des entités) -src/State/ # Providers et Processors API Platform (MeProvider, AppVersionProvider, ActiveTimeEntryProvider, UserPasswordHasherProcessor, TaskNumberProcessor, ClientTicket*Provider/Processor, NotificationProvider, Gitea*Provider, Gitea*Processor) -src/Service/ # Services métier (NotificationService) +src/Entity/ # Entités Doctrine (User, Client, Project, Task, TaskStatus, TaskEffort, TaskPriority, TaskTag, TaskGroup, TimeEntry, GiteaConfiguration, ClientTicket, Notification, TaskDocument, BookStackConfiguration, TaskBookStackLink, TaskRecurrence, ZimbraConfiguration) +src/ApiResource/ # Ressources API Platform (si découplées des entités) (ZimbraSettings, ZimbraTestConnection) +src/Enum/ # PHP enums (RecurrenceType) +src/State/ # Providers et Processors API Platform (MeProvider, AppVersionProvider, ActiveTimeEntryProvider, UserPasswordHasherProcessor, TaskNumberProcessor, ClientTicket*Provider/Processor, NotificationProvider, Gitea*Provider, Gitea*Processor, ZimbraSettingsProvider/Processor, ZimbraTestConnectionProvider, TaskCalendarProcessor, RecurrenceHandler) +src/Service/ # Services métier (NotificationService, CalDavService, RecurrenceCalculator) src/Controller/ # Controllers custom Symfony (NotificationUnreadCountController, MarkAllReadController, UserAvatarController, TaskDocumentDownloadController) src/Mcp/Tool/ # MCP tools organisés par domaine (Project/, Task/, TaskMeta/, TimeEntry/, Reference/) src/Security/ # Authenticators custom (ApiTokenAuthenticator pour MCP HTTP) @@ -30,10 +31,10 @@ docs/superpowers/ # Plans et specs superpowers frontend/ # App Nuxt 4 frontend/pages/ # Pages (index, login, my-tasks, profile, projects, projects/[id], projects/[id]/groups, projects/[id]/archives, time-tracking, admin, portal/, portal/projects/[id], portal/projects/[id]/new-ticket) frontend/layouts/ # Layouts (default, portal) -frontend/components/ # Composants Vue organisés en sous-dossiers (ui/, client/, project/, task/, user/, admin/, time-tracking/, client-ticket/, notification/) +frontend/components/ # Composants Vue organisés en sous-dossiers (ui/, client/, project/, task/, user/, admin/, time-tracking/, client-ticket/, notification/) — inclut admin/AdminZimbraTab frontend/composables/# Composables (useApi, useAppVersion, useNotifications, useClientTicketHelpers, useAvatarService) frontend/stores/ # Stores Pinia (auth, ui, timer) -frontend/services/ # Services API (auth, clients, gitea, projects, tasks, task-statuses, task-efforts, task-groups, task-priorities, task-tags, users, time-entries, client-tickets, notifications, task-documents) +frontend/services/ # Services API (auth, clients, gitea, projects, tasks, task-statuses, task-efforts, task-groups, task-priorities, task-tags, users, time-entries, client-tickets, notifications, task-documents, zimbra, task-recurrences) frontend/services/dto/ # Types TypeScript frontend/i18n/locales/ # Fichiers de traduction (langDir résolu depuis i18n/) ``` @@ -68,6 +69,13 @@ Types autorisés (minuscules) : `build`, `chore`, `ci`, `docs`, `feat`, `fix`, ` Exemples : `feat : add login page`, `fix(auth) : prevent null token crash` +### Tags & Versioning + +- La version de l'app est dans `config/version.yaml` (paramètre `app.version`) +- À chaque création de tag, **toujours** mettre à jour `config/version.yaml` avec la même version +- Faire un commit séparé de bump : `chore : bump version to v` +- Puis créer le tag et pusher : `git tag v && git push origin develop --tags` + ### Backend - Toujours `declare(strict_types=1)` en haut des fichiers PHP @@ -97,7 +105,7 @@ Exemples : `feat : add login page`, `fix(auth) : prevent null token crash` ### MCP Server -- 22 tools MCP exposant projets, tâches, métadonnées, et time tracking +- 25 tools MCP exposant projets, tâches, métadonnées, time tracking, et récurrences - Transport STDIO (local) : `docker exec -i php-lesstime-fpm php bin/console mcp:server` - Transport HTTP (réseau) : `POST /_mcp` avec header `Authorization: Bearer ` - Auth HTTP : `ApiTokenAuthenticator` vérifie le champ `apiToken` de l'entité `User` @@ -126,3 +134,5 @@ Exemples : `feat : add login page`, `fix(auth) : prevent null token crash` - Users internes : `alice` / `alice`, `bob` / `bob`, `charlie` / `charlie` (ROLE_USER) - Users client : `client-liot` / `client` (ROLE_CLIENT, client LIOT → SIRH), `client-acme` / `client` (ROLE_CLIENT, client ACME → CRM) - API token admin (dev) : `dev-mcp-token-for-testing-only-do-not-use-in-production` +- ZimbraConfiguration : serverUrl `https://mail.ovh.com`, username `lesstime@ovh.fr`, enabled false +- TaskRecurrence (hebdomadaire lun/mer/ven) attachée à la tâche "Réunion de suivi hebdomadaire" (SIRH)