06.18

Administracija i konzola platforme

Sažetak

Administracija klinike djeluje unutar jedne klinike; konzola platforme jedina je površina preko više klinika i svaka je njezina radnja revidirana. Pristup preko klinika koristi izričit opseg platforme, a ne zaobilaženje sigurnosti na razini redaka.

Tehnička specifikacija vodi se na engleskom jeziku; naslovi i sažeci poglavlja prevedeni su na hrvatski.

Overview

  • ProductionGovern · Administration and platform console
    Operate the platform and each clinic without giving any operator a path around tenant isolation.

Pipeline

  1. Clinic administrators act through tenant-scoped admin routes behind authentication and an admin rate limiter.
  2. Platform administrators act through /api/platform/*, which additionally requires the platform-admin role.
  3. Cross-tenant work runs under an explicit platform scope helper and an audited admin-action wrapper.
  4. A scheduled anomaly scan reads the audit trail for cross-clinic access patterns and raises security anomalies.

Data owned

  • Users, roles, clinic membership
    Holds
    Authorization
  • Rollout grants and entitlements
    Holds
    Who may use what
  • Security anomalies
    Holds
    Flagged access patterns from the audit trail
  • Bug reports
    Holds
    Stored in Cloud Storage and forwarded to the issue tracker

Models and engines

This module makes no model calls. Everything it computes is deterministic code.

Guardrails

  • Platform routes require a separate role on top of authentication.
  • Cross-tenant scope is explicit and audited; accepted exceptions live in a tenant-isolation exception register enforced by a test.
  • Erasure runs through one audited endpoint with tombstones replayed after any restore.

Rollout and status

  • ProductionClinic administration and platform console
    Audited

Interfaces

  • Consumes
    What
    Audit trail
  • Consumes
    What
    Rollout and entitlement state
  • Emits
    What
    Grants, releases and entitlements
  • Emits
    What
    Security anomalies
SOURCE OF TRUTH
  • server/routes/admin.ts
  • server/routes/platform*.ts
  • server/services/anomalyDetection.ts
  • docs/runbooks/tenant-isolation-exception-register.md
Svaki broj u ovoj specifikaciji generira se iz repozitorija i provjerava u CI-ju.