MALIO-DEV/Lesstime
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 32 Wiki Activity

feat(help) : centre d'aide in-app /help avec 9 sections #4

Merged
matthieu merged 2 commits from feat/in-app-help-doc into develop 2026-05-20 07:44:45 +00:00
Conversation 0 Commits 2 Files Changed 11 +714
matthieu commented 2026-05-19 19:09:47 +00:00
Owner
Copy Link

Résumé

Ajoute un centre d'aide complet in-app accessible depuis l'icône ? dans la topbar.

Architecture

  • Page /help avec sidebar (sections) + zone contenu (markdown rendu)
  • Contenu en markdown statique dans frontend/content/help/*.md (versionné en git, simple à éditer)
  • Rendu via marked (déjà présent dans le projet)
  • Styling avec @tailwindcss/typography (prose-* utilities) + accent gradient par section

9 sections livrées

  1. Bienvenue — vue d'ensemble + rôles
  2. Projets & Workflows — workflows custom, 5 catégories canoniques, switch
  3. Mes tâches — kanban par catégorie, filtres, bulk actions
  4. Time tracking — timer, time entries, vue mois
  5. Tâches en détail — tous les champs, récurrence, sync calendrier, Gitea
  6. Portal client — soumission tickets, statuts visibles
  7. Administration — onglets clients/workflows/efforts/priorités/tags/users
  8. Intégrations — Gitea / BookStack / Zimbra (config + usage)
  9. Token MCP & API — génération token, config .mcp.json, 27 tools listés

Visibilité par rôle

Section Admin User Client
Bienvenue ✅ ✅ ✅
Projets & Workflows ✅ ✅ —
Mes tâches ✅ ✅ —
Time tracking ✅ ✅ —
Tâches détail ✅ ✅ —
Portal client ✅ — ✅
Admin ✅ — —
Intégrations ✅ ✅ —
MCP / API ✅ ✅ —

UX

  • Hero header par section avec gradient distinct + icône
  • Sidebar fixe desktop / horizontale scrollable mobile
  • Navigation prev/next en bas de section
  • Deep-link via ?section=... (partageable)
  • Prose typography soignée : tables, code, blockquotes en mode "callout" ambré

Dépendance

Cette PR dépend du merge de #3 workflows (la section 02 et la 09 mentionnent les workflows). Si #3 est mergé en premier, cette PR se rebase proprement sur develop.

Test plan

  • L'icône ? est visible dans la topbar (à gauche du dark mode toggle)
  • Clic sur ? ouvre /help avec la section "Bienvenue" sélectionnée
  • Naviguer entre les sections via la sidebar
  • L'URL met à jour ?section=<id> (deep-link OK au reload)
  • Avec un user ROLE_USER : pas de section Admin
  • Avec un user ROLE_CLIENT : seules Bienvenue + Portal client visibles
  • Responsive mobile : sidebar passe en barre horizontale scrollable

🤖 Generated with Claude Code

## Résumé Ajoute un **centre d'aide complet** in-app accessible depuis l'icône `?` dans la topbar. ### Architecture - **Page `/help`** avec sidebar (sections) + zone contenu (markdown rendu) - Contenu en **markdown statique** dans `frontend/content/help/*.md` (versionné en git, simple à éditer) - Rendu via `marked` (déjà présent dans le projet) - Styling avec `@tailwindcss/typography` (`prose-*` utilities) + accent gradient par section ### 9 sections livrées 1. **Bienvenue** — vue d'ensemble + rôles 2. **Projets & Workflows** — workflows custom, 5 catégories canoniques, switch 3. **Mes tâches** — kanban par catégorie, filtres, bulk actions 4. **Time tracking** — timer, time entries, vue mois 5. **Tâches en détail** — tous les champs, récurrence, sync calendrier, Gitea 6. **Portal client** — soumission tickets, statuts visibles 7. **Administration** — onglets clients/workflows/efforts/priorités/tags/users 8. **Intégrations** — Gitea / BookStack / Zimbra (config + usage) 9. **Token MCP & API** — génération token, config `.mcp.json`, 27 tools listés ### Visibilité par rôle | Section | Admin | User | Client | |---|:---:|:---:|:---:| | Bienvenue | ✅ | ✅ | ✅ | | Projets & Workflows | ✅ | ✅ | — | | Mes tâches | ✅ | ✅ | — | | Time tracking | ✅ | ✅ | — | | Tâches détail | ✅ | ✅ | — | | Portal client | ✅ | — | ✅ | | Admin | ✅ | — | — | | Intégrations | ✅ | ✅ | — | | MCP / API | ✅ | ✅ | — | ### UX - **Hero header** par section avec gradient distinct + icône - **Sidebar fixe** desktop / horizontale scrollable mobile - **Navigation prev/next** en bas de section - **Deep-link** via `?section=...` (partageable) - **Prose typography** soignée : tables, code, blockquotes en mode "callout" ambré ### Dépendance Cette PR dépend du merge de [#3 workflows](/MALIO-DEV/Lesstime/pulls/3) (la section 02 et la 09 mentionnent les workflows). Si #3 est mergé en premier, cette PR se rebase proprement sur develop. ## Test plan - [ ] L'icône `?` est visible dans la topbar (à gauche du dark mode toggle) - [ ] Clic sur `?` ouvre `/help` avec la section "Bienvenue" sélectionnée - [ ] Naviguer entre les sections via la sidebar - [ ] L'URL met à jour `?section=<id>` (deep-link OK au reload) - [ ] Avec un user `ROLE_USER` : pas de section Admin - [ ] Avec un user `ROLE_CLIENT` : seules Bienvenue + Portal client visibles - [ ] Responsive mobile : sidebar passe en barre horizontale scrollable 🤖 Generated with [Claude Code](https://claude.com/claude-code)
matthieu added 27 commits 2026-05-19 19:09:48 +00:00
docs(workflows) : spec workflows de statuts par projet 6a942def3f 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs(workflows) : ajout note de reprise sur autre poste ba86a71e12 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
feat(workflow) : ajoute l'enum StatusCategory (5 catégories canoniques) b8b03048b6
feat(workflow) : ajoute l'entité Workflow et son repository a3e3fd6da6
feat(workflow) : ajoute workflow et category sur TaskStatus 43e6d1aed2
feat(workflow) : ajoute workflow requis sur Project (RESTRICT) 8a68e0d397
feat(workflow) : migration M1 - création table workflow + seed Standard 03f3c85fd8
feat(workflow) : migration M2 - rattache les statuts existants à Standard + category f6a947ec15
feat(workflow) : migration M3 - workflow requis sur Project (RESTRICT) a21914312a
feat(workflow) : fixtures - workflow Standard + statuts catégorisés + projets attachés 25f2fc4b16
feat(workflow) : listener garantissant un seul workflow isDefault=true a9f87be8e5
feat(workflow) : migration M4 - alignement schéma Doctrine (indexes + IDENTITY) eec61c089c
feat(workflow) : valide que task.status appartient au workflow du projet cf94635121
feat(workflow) : protège la suppression d'un workflow lié à des projets (409) 80a41db34f
feat(workflow) : endpoint POST /projects/{id}/switch-workflow + processor transactionnel 6a084489ea
feat(workflow) : DTOs front Workflow + category sur TaskStatus + workflow embarqué sur Project + service + i18n 18bc96082f
feat(workflow) : admin UI - WorkflowDrawer + AdminWorkflowTab + remplacement onglet Statuts, suppression composants obsolètes 8e4ddf00a8
feat(workflow) : kanban projet et archives basés sur workflow.statuses du projet 5d42009348
feat(workflow) : my-tasks - kanban groupé par catégorie avec badge statut, suppression drag-to-status e6d765f7bb
feat(workflow) : ProjectWorkflowSwitchModal + section workflow et bouton switch dans ProjectDrawer 52b78d6bbc
feat(workflow) : bulk status désactivé sur sélection multi-projets, scoped au workflow du projet 6a37349cf7
feat(workflow) : MCP - list-statuses projectId + list-workflows + switch-project-workflow + maj descriptions create/update-task 9f179e400d
chore : bump version to v0.4.0 1fd2c05db3
docs(workflows) : plan d'implémentation + validations Matthieu sur le spec + gitignore dumps locaux f86698e7cd
fix(workflow) : WorkflowDrawer - input position natif (MalioInputText n'accepte pas les number) c1560468e6
fix(workflow) : M4 - aligne la séquence workflow.id après recréation de l'identity (évite conflit avec row Standard de M1) 5fb7fbe66c
feat(help) : centre d'aide in-app — page /help avec sidebar + 9 sections markdown stylées, icône ? dans la topbar 55301c9c63
matthieu added 1 commit 2026-05-19 19:12:09 +00:00
fix(help) : retire definePageMeta auth (middleware global déjà appliqué) 930e1a1e37
matthieu merged commit 40a1d737f3 into develop 2026-05-20 07:44:45 +00:00
matthieu deleted branch feat/in-app-help-doc 2026-05-20 07:44:47 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
malio matthieu tristan
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MALIO-DEV/Lesstime#4
Delete Branch "feat/in-app-help-doc"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?