manager-service/ManagerService/Services/IIngestionService.cs
Thomas Fransolet 18e4240f0f RAG: pipeline d'ingestion, endpoints du guide IA, journalisation RGPD
Ingestion et indexation
- IIngestionService/IngestionService : chargement des collections filles par
  sous-type, un jeu de morceaux par langue, ChunkIndex continu.
- SectionIndexingInterceptor retenu comme unique déclencheur : les 5
  sous-contrôleurs totalisaient 30 SaveChanges et 0 Enqueue, donc ajouter des
  points d'intérêt à une carte ne réindexait rien.
- HTML retiré avant l'embedding et lignes trop longues recoupées : sans cela un
  article dépassait l'entrée max du modèle et emportait son lot de 50 morceaux.
- Gabarits de LanguageInit filtrés, DistinctBy(Text) avant le Take : ils
  occupaient les cinq premiers résultats d'une recherche en néerlandais.

Endpoints du guide IA
- GET /api/Ai/knowledge/{id} : agrégats sur ContentEmbedding, donc sur ce qui
  est réellement indexé — compter les sections publiées serait plus flatteur et faux.
- GET /api/Ai/insights/{id} : miroir de GuideIaInsights côté manager-app, c'est
  l'écran qui a fixé la forme pour que le job de thèmes la remplisse.

RGPD
- VisitorQuestion journalisée dans AiController.Chat. HasAnswer se déduit des
  sources du retrieval, pas du texte : un repli poli ressemble à une réponse.
  L'écriture n'échoue jamais la réponse au visiteur.
- VisitorQuestionPurgeService, 90 jours, actif sans condition de configuration :
  une durée écrite dans les CGU n'est pas un réglage commercial.

Corrections
- Updateinstance ne recopiait pas les quotas du nouveau plan.
- CheckQuota ne bloquait ni ne comptait à quota 0 — IA gratuite non comptée.
- StoragePath et SizeBytes renseignés à Create, types URL exclus.

dotnet build 0 erreur, dotnet test 130/130.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 10:48:10 +02:00

23 lines
922 B
C#

using System.Threading.Tasks;
namespace ManagerService.Services
{
/// <summary>
/// Ré-indexation du contenu CMS pour le guide IA, exécutée en tâche de fond.
/// Les méthodes prennent un id, jamais un contenu : Hangfire sérialise les arguments
/// de job en JSON dans sa table Postgres, et le texte y serait recopié à chaque tentative.
/// </summary>
public interface IIngestionService
{
Task IngestSectionAsync(string sectionId);
/// <summary>
/// Réindexe toutes les sections d'une instance et rend le nombre de morceaux produits.
/// Sert au rattrapage après un passage à un plan avec IA : sans lui, le client paie un
/// guide qui ne connaît rien de son contenu, puisque rien n'a été indexé tant qu'il
/// était sur un plan sans IA.
/// </summary>
Task<int> BackfillInstanceAsync(string instanceId);
}
}