De Webadmin is een Venster, geen Tweede Bron van Waarheid

Het APX webadmin-paneel is niet het middelpunt van het systeem.

Het ontwerp is strikt. De daemon beheert de state. De web-UI is een lokale client. Dit onderscheid is van belang. Het bepaalt waar de waarheid ligt en hoeveel data kan afwijken.

APC biedt de draagbare contextlaag. APX biedt de runtime- en toolinglaag. De webadmin hoort bij APX. Het stelt je in staat de runtime in een browser te inspecteren. Het bevat geen eigen kopie van de project-waarheid.

De architectuur werkt als volgt:

  • De daemon draait een lokale HTTP-server.
  • Elke interface communiceert met de daemon via HTTP.
  • De webadmin wordt geserveerd door de daemon.
  • De browser haalt een token op bij de daemon.

De browser is geen gelijkwaardige database. Het is slechts één interface. Wanneer een webpaneel een tweede bron van waarheid wordt, gaat het mis.

Twee kopieën van de state leiden tot fouten:

  • De CLI schrijft het ene, terwijl de UI het andere laat zien.
  • Een browsersessie bewerkt een configuratie, maar de daemon gebruikt oude gegevens.
  • Een reload toont het ene project, terwijl een ander tabblad verouderde gegevens laat zien.
  • Een UI-fix bereikt de eigenlijke runtime nooit.

APX voorkomt dit door de browser lichtgewicht te houden. De UI vraagt het aan de daemon. De daemon vraagt het aan de core. De core leest of schrijft naar de eigenlijke backing store. Deze keten is eenvoudig. Eenvoud is goed.

Een goed lokaal paneel doet drie dingen:

  • Toon de live status.
  • Stuur een kleine actie.
  • Valideer opnieuw na de actie.

Het paneel laat je projecten, agents, routines, sessies, MCP's en instellingen bekijken. Het is een weergave van het systeem, geen fork van het systeem.

Implementatiedetails houden het lokaal:

  • De ontwikkelmodus gebruikt Vite en fungeert als proxy naar de daemon.
  • In productie wordt de gebouwde app geserveerd vanuit de daemon.
  • Same-origin houdt authenticatie en routing eenvoudig.
  • De browser heeft nooit directe schrijfrechten voor de repo nodig.

Het voordeel is niet visuele verfijning. Het voordeel is dat elke actie via één backend verloopt.

Als je een instelling in het paneel bewerkt, stuurt het paneel de wijziging naar de daemon. De daemon werkt de project-store bij. De volgende render leest dezelfde bron van waarheid als de CLI. Eén systeem, vele interfaces.

De UI kan verdwijnen zonder je project te schaden. Je kunt het tabblad sluiten of overstappen naar een andere machine. De status blijft in de daemon en in de .apc/ map staan.

Het mentale model is eenvoudig:

  • APC: wat het project is.
  • APX: hoe het project draait.
  • Webadmin: één venster naar die runtime.

Houd deze grens helder. De stack blijft vervangbaar. De browser blijft optioneel. De daemon blijft leidend. Het project blijft draagbaar.

Bron: https://dev.to/agentprojectcontext/the-web-admin-is-a-window-not-a-second-source-of-truth-2aip

Optionele leercommunity: https://t.me/GyaanSetuAi