Trasversale

Questa sezione documenta gli abilitatori non di dominio: runtime locale, operativita, osservabilita, package condivisi e contratti riusabili.

Trasversale · Workspace

platform-local-stack

Single local bootstrap entrypoint for the workspace, centralizing host routing, infra provisioning, observability and start-stop lifecycle scripts.

• Node.js scripts
• Docker Compose
• http-proxy
• Loki

Trasversale · Service

platform-status-service

Operational control plane that probes service health, exposes an aggregate status API and renders the status/operator dashboard.

• NestJS
• React
• Vite
• @platform/observability

Trasversale · Workspace

platform-shared-packages

Shared npm workspace that hosts contracts, frontend clients, observability helpers and UI primitives reused across Core and Experience repositories.

• npm workspaces
• CommonJS and ESM exports

Runtime locale

• platform-local-stack: entrypoint locale, profili, proxy, infra e osservabilita.
• Avvio stack in localhost: prerequisiti, setup, environment, database, bootstrap e verifiche rapide.
• Nuovo progetto stack globale: baseline per creare un repository EXPERIENCE con apps/api, apps/web e packages/shared.

Operazioni

• platform-status-service: API aggregate e dashboard operatori.
• Deploy GitHub Railway: configurazione secrets e pipeline Railway via GitHub.

Package condivisi

• platform-shared-packages: workspace @platform/* con contratti, client, osservabilita e UI.
• Contratti condivisi: DTO e tipi riusabili tra servizi e prodotti.
• Client, osservabilita e UI: helper frontend, logging condiviso e primitive visuali.