MadJax
9d2b676c84
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).
20 lines
757 B
C#
20 lines
757 B
C#
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);
|
|
}
|