ViewNova

ViewNova is a SCADA platform that compiles an engineering model into an immutable runtime snapshot and runs the live tag, alarm, and command loop with field drivers.

The product name is ViewNova. Environment variables (VION_*) and the config file (vion.toml) remain technical identifiers.

Spine

flowchart LR
  Studio[Studio Web] -->|REST /api/v1| CP[Control Plane]
  CP --> PG[(PostgreSQL)]
  CP -->|publish validate compile| Rev[Immutable Revision]
  Rev --> Snap[Runtime Snapshot]
  CP -->|gRPC Stage then Activate| RT[Runtime Core]
  Snap --> RT
  RT -->|1s poll| Drivers[Field drivers]
  RT --> Spool[Historian spool]

Order:

Project → Workspace → Validation → Publish → immutable Revision → Runtime Snapshot → Runtime Core

Three truths

Truth	Holds	Who reads it
Engineering	Project, workspace deltas, revision, resource bodies	Control plane. Runtime does not open these tables
Snapshot	Compiled, hashed runtime document	Compiler produces, runtime loads
Live process	Tag values, alarms, leases, SOE, spool	Runtime Core memory

Do not write live values into engineering rows. After activation, values live in runtime memory.

Components

Component	Role
Control plane	REST API, identity, publish, compile, gRPC client
Runtime Core	Snapshot, poll, alarm, command, spool
Historian writer	Drains ready/ to columnar or PostgreSQL (optional)
Studio Web	Browser client; setup wizard and engineering surfaces
Drivers	Modbus, IEC 104, OPC UA, MQTT, DNP3, Sparkplug, HTTP JSON

In these docs

• Getting started — local bring-up and first-run
• Installation — Compose, native services, TLS
• Configuration — vion.toml and VION_* reference
• User guide — Studio surfaces
• Integrations — protocol fields
• API — OpenAPI, Runtime HTTP, gRPC
• Feature status — ready / partial / later

Internal domain maps stay under docs/domains/ in the repo; this site is the user and integrator manual.