Consultation des specs dans l'app (menu Specs + rendu Markdown/Mermaid)
Nouvelle fonctionnalité : consulter les documents de spécification (exigences,
conception technique, plan de tâches) en lecture seule dans le frontend.
Backend :
- SpecsController (GET /api/specs, GET /api/specs/{cle}) protégé par l'auth
globale ; SpecDocumentService avec whitelist (pas de path traversal) et
lecture depuis le dossier specs/ embarqué, repli sur .kiro/specs en dev.
- DTOs SpecDocumentDto / SpecContenuDto ; service enregistré dans Program.cs.
Docker :
- Contexte de build backend = racine du dépôt (dockerfile: backend/Dockerfile)
pour embarquer .kiro/specs/*.md dans l'image (app autonome).
- .dockerignore racine ajouté (exclut frontend/node_modules, bin/obj, etc.).
Frontend :
- SpecService + SpecsComponent (lazy-loadé) : page dédiée avec menu latéral par
document ; rendu Markdown via marked (GFM) assaini par DOMPurify.
- Diagrammes Mermaid (ex. graph TB) rendus en SVG via mermaid.js importé
dynamiquement ; déclenchement après résolution du @ViewChild (setTimeout).
- Barre de navigation : simple lien « Specs » (le choix du document se fait dans
le menu latéral de la page, pas dans la barre).
- Routes /specs et /specs/:cle protégées par authGuard.
Specs : exigence 19 (consultation des documents) ajoutée à requirements.md ;
design.md complété (DTOs, endpoints, composant, rendu Mermaid, note Docker).
This commit is contained in:
@@ -0,0 +1,21 @@
|
||||
namespace SchotzIadKmTracker.Api.Models.DTOs;
|
||||
|
||||
/// <summary>Métadonnées d'un document de spécification exposé au frontend.</summary>
|
||||
/// <param name="Cle">Clé stable et sûre (whitelist) : "requirements", "design" ou "tasks".</param>
|
||||
/// <param name="Titre">Libellé lisible pour le sous-menu (ex. « Exigences »).</param>
|
||||
/// <param name="Disponible">Vrai si le fichier Markdown correspondant est présent et lisible.</param>
|
||||
public record SpecDocumentDto(
|
||||
string Cle,
|
||||
string Titre,
|
||||
bool Disponible
|
||||
);
|
||||
|
||||
/// <summary>Contenu Markdown d'un document de spécification.</summary>
|
||||
/// <param name="Cle">Clé du document ("requirements", "design", "tasks").</param>
|
||||
/// <param name="Titre">Libellé lisible du document.</param>
|
||||
/// <param name="Markdown">Contenu brut Markdown du document, rendu côté frontend.</param>
|
||||
public record SpecContenuDto(
|
||||
string Cle,
|
||||
string Titre,
|
||||
string Markdown
|
||||
);
|
||||
Reference in New Issue
Block a user