Architecture, BesluitBron documentatie

BesluitBron est un processus unique sur un seul port. Ce processus dessert trois interfaces qui n'ont pas besoin de communiquer entre elles : les adresses MCP pour un assistant IA, le site web public et la console d'administration. Chaque chemin correspond à une seule et unique interface. Toute autre tentative renvoie une erreur 404.

Le choix d'un processus unique est délibéré. Si chaque plateforme source disposait de son propre service, cela impliquerait, pour chaque plateforme, les mêmes besoins en matière de mise en mémoire tampon, de journalisation et de gestion des erreurs. Il faudrait alors répondre à la question « quelles sont les sources proposées par cette installation ? » pour chaque service, plutôt qu'en un seul endroit. Voir Connectorregister.

Le processus vu d'en haut

flowchart TD
    CL["Assistant IA<br/>Claude Desktop,<br/>claude.ai, Claude Code"] --> MCP["Adresses MCP<br/>/ mcp/ori jusqu’au<br/>/ mcp/unified /v1"]
    BE["Visiteur de<br/>le site web"] --> SITE["Site web public<br/>16 langues"]
    BR["Navigateur de<br/>l'administrateur"] --> ADM["Console d'administration<br/>explorateur, journal de bord,<br/>tableau de bord"]
    CAT["ConnectorCatalog<br/>quelles sources sont<br/>proposé"] --> MCP
    CAT --> SITE
    CAT --> ADM
    MCP --> SURF["McpConnectorSurface<br/>une boîte à outils<br/>par adresse"]
    SURF --> EXEC["ToolExecutor<br/>mesure du temps, origine,<br/>exploitation forestière"]
    ADM --> QS
    EXEC --> QS["Moteurs de recherche par plateforme<br/>structure de la requête"]
    QS --> UC["UpstreamCache<br/>séparés par plateforme"]
    QS --> UP["Les plateformes sources<br/>voir Sources"]
    EXEC --> LOG["McpRequestLog<br/>table et tampon circulaire"]
    LOG --> DATA[("Stockage<br/>journal, exportations,<br/>en option : PostgreSQL 18")]
    LOG --> HUB["SignalR -hub<br/>tableau de bord en temps réel"]
    HUB --> BR

Les plateformes sources sont regroupées ici en un seul bloc. Pour savoir de quelles plateformes il s'agit et connaître les fonctionnalités de chacune d'entre elles, consultez la page Bronnen.

Les rubriques fixes

ConnectorCatalog est la seule à répondre à la question de savoir quelles sources cette installation propose. Voir Connectorregister ;
McpConnectorSurface crée une boîte à outils spécifique pour chaque connecteur. Une session se voit attribuer la boîte correspondant à l'adresse à partir de laquelle elle est arrivée. Ainsi, huit boîtes à outils peuvent coexister au sein d'un même processus ;
ToolExecutor est présent à chaque appel : ce composant mesure la durée, enregistre l'origine et consigne les informations dans le journal. Un outil qui omettrait cette étape serait invisible dans le rapport ;
Les moteurs de recherche de chaque plateforme traduisent une requête dans la langue de recherche de cette plateforme. Ils suppriment de la requête les caractères qui pourraient perturber la langue de recherche et limitent la portée de la réponse ;
UpstreamCache est séparé par plateforme. Une plateforme lente ou défaillante n'affecte donc pas les six autres. Voir Buffering en Doorlooptijd.

L'ajout d'une plateforme entraîne l'ajout de fichiers

L'ajout d'une huitième plateforme source se fait en trois étapes : ajouter des fichiers portant le nom de cette plateforme, ajouter un bloc de paramètres et insérer une ligne dans le registre des connecteurs. Les fichiers existants ne sont pas modifiés. Il ne s'agit pas d'une préférence stylistique. C’est la raison pour laquelle les six plateformes suivantes ont chacune été mises en service en quelques jours, sans affecter le fonctionnement des plateformes existantes.

L'exception est clairement indiquée. Les menus de la console d'administration et le pied de page du site web énumèrent chacune de leurs règles. Ces deux éléments sont donc bien mis à jour lorsqu'une nouvelle source est ajoutée.

Pour en savoir plus

Verloop van een Aanroep : le déroulement étape par étape d'une requête ;
Connectorregister : comment l'activer et le désactiver, et pourquoi « désactiver » signifie vraiment « désactiver » ;
Buffering en Doorlooptijd : délai de réponse et durée de conservation des données ;
Logging en Verantwoording : ce qui est enregistré et comment le consulter ;
Laadstatus : si de nouveaux contenus sont encore ajoutés sur chaque plateforme source, avec les seuils et les chiffres correspondants ;
Uitrol en Beheer : fonctionnement du service et modalités de mise à jour.