Files
ANSCORE/docs/diagrams/02-l2-internals.puml
T
2026-06-12 14:13:26 +10:00

85 lines
2.1 KiB
Plaintext

@startuml 02-l2-internals
title Layer 2 — ANSVIS internal architecture
skinparam componentStyle rectangle
skinparam packageStyle rectangle
actor "Qt / QML UI" as QT
actor "3rd-party\nintegrations" as EXT
package "L2 /api/v1 surface" as EDGE_API {
component "REST router" as ROUTER
component "Auth middleware\n(Bearer)" as AUTHMW
component "Request validation\n(OpenAPI schemas)" as VALID
component "Error mapper\n(RFC 7807)" as ERR
component "Rate limiter" as RATE
component "SSE broadcaster\n(per-subscription filter)" as SSEHUB
}
package "v1 Adapter Layer\n(per-resource modules)" as ADAPTER {
component "cameras" as CAM_AD
component "models" as MOD_AD
component "edges" as EDGE_AD
component "deployment-groups" as DG_AD
component "ai-tasks" as TASK_AD
component "events" as EV_AD
component "fr" as FR_AD
component "alpr" as ALPR_AD
component "notifications" as NOTIF_AD
component "system" as SYS_AD
component "jobs" as JOB_AD
}
package "Legacy ANSVIS server\n(reused as-is)" as LEGACY {
component "Config store" as LEG_CFG
component "AI task engine" as LEG_TASKS
component "FR engine" as LEG_FR
component "ALPR engine" as LEG_ALPR
}
package "Infrastructure" as INFRA {
component "Auth + token store" as AUTH_SVC
queue "Job queue\n(scans, uploads, deploys, updates)" as JOBS_Q
database "Event metadata DB" as EVENTS_DB
database "Clip / image object store\n(S3 / MinIO / FS)" as CLIPS
component "Logs + metrics + health" as LOGS
component "Media relay\nHLS / RTSP / WebRTC" as RELAY
}
actor "L1 edge target(s)" as E1
QT --> ROUTER
EXT --> ROUTER
ROUTER --> AUTHMW
AUTHMW --> VALID
VALID --> RATE
RATE --> ADAPTER
ADAPTER --> ERR
ADAPTER ..> ROUTER : response
AUTHMW --> AUTH_SVC
CAM_AD --> LEG_CFG
MOD_AD --> LEG_CFG
MOD_AD --> CLIPS
EDGE_AD --> LEG_CFG
DG_AD --> LEG_TASKS
TASK_AD --> LEG_TASKS
EV_AD --> EVENTS_DB
EV_AD --> CLIPS
FR_AD --> LEG_FR
ALPR_AD --> LEG_ALPR
SYS_AD --> LOGS
JOB_AD --> JOBS_Q
CAM_AD ..> JOBS_Q : scan / probe
MOD_AD ..> JOBS_Q : large upload
LEG_TASKS --> EVENTS_DB
EVENTS_DB --> SSEHUB
SSEHUB --> ROUTER
LEGACY <--> E1
RELAY <--> E1
@enduml