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,19 @@
|
||||
using SchotzIadKmTracker.Api.Models.DTOs;
|
||||
|
||||
namespace SchotzIadKmTracker.Api.Services;
|
||||
|
||||
/// <summary>
|
||||
/// Fournit l'accès en lecture seule aux documents de spécification du projet
|
||||
/// (requirements, design, tasks) pour affichage dans le frontend.
|
||||
/// </summary>
|
||||
public interface ISpecDocumentService
|
||||
{
|
||||
/// <summary>Liste les documents de spécification connus et leur disponibilité.</summary>
|
||||
IReadOnlyList<SpecDocumentDto> Lister();
|
||||
|
||||
/// <summary>
|
||||
/// Retourne le contenu Markdown du document identifié par <paramref name="cle"/>,
|
||||
/// ou <c>null</c> si la clé est inconnue (hors whitelist) ou le fichier absent.
|
||||
/// </summary>
|
||||
Task<SpecContenuDto?> ObtenirAsync(string cle, CancellationToken cancellationToken = default);
|
||||
}
|
||||
Reference in New Issue
Block a user