Files
Khaemhat/docs/adr/0003-blazor-interactive-server.md
T
Alby96andClaude Opus 5.5 e746d99dab docs: add specification, design docs, mockups, wiki and deploy files
Prepare everything needed before development starts on Khaemhat, the
ERP + CRM for Italian SMEs:

- docs/SPEC.md: the original project specification, unchanged, plus
  CLAUDE.md with operational rules and amendments (Gitea instead of
  GitHub/GHCR, Docker image as the only deliverable).
- ADR 0001-0011 for the baseline decisions.
- Mockups: 22 high-resolution screens, the full gallery, 88 thumbnails
  cropped from it, mockup.css and an index.
- Technical docs (architecture, data model, modules, API, MCP, deploy,
  security, development process, status with open spec questions).
- Full draft wiki in docs/wiki (already published to the Gitea wiki).
- Icons in assets/ and deploy files for Docker Compose and Unraid,
  pointing to the Gitea package registry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 22:26:58 +01:00

1.1 KiB

ADR 0003 — Interfaccia Blazor Web App in modalità Interactive Server

  • Stato: accettata
  • Data: 2026-11-10
  • Fonte: SPEC §2, §10

Contesto

Serve un'interfaccia ricca (griglie editabili, radar, schede, scorciatoie da tastiera) senza librerie JavaScript e con un solo linguaggio. Gli utenti lavorano in rete locale o via VPN/reverse proxy, su un solo server.

Decisione

  • Blazor Web App con render mode Interactive Server su tutta l'applicazione (--all-interactive).
  • Componenti scritti in casa (Kh*, SPEC §10.7) secondo i token e i mattoni di docs/mockups/mockup.css; i mockup in docs/mockups/ sono la specifica visiva vincolante.
  • Sessione verificata a ogni riconnessione del circuito; stato delle schede mantenuto dal TabService.

Conseguenze

  • Ogni utente tiene aperto un circuito SignalR: la memoria del server cresce con gli utenti connessi, accettabile per una PMI. Più repliche richiederebbero sessioni sticky: fuori dal caso d'uso.
  • Le pagine di accesso sono form statici con antiforgery.
  • Il reverse proxy deve inoltrare i WebSocket (documentato in docs/DEPLOY.md).