Skip to content
36 changes: 36 additions & 0 deletions docs/features/vso/_assets/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# VSO Assets

This folder contains visual assets for the Vehicle Service Orchestrator (VSO) feature documentation.


## Architecture Diagrams

### VSO_architecture.svg
**Used in:** [docs/features/vso/index.rst](../index.rst) - System Architecture section

Main architecture diagram showing the Multi-node Scenario Evidence Layer:
- **Data Inputs Layer:** Per-node signals from Runtime Plane, Diagnostics Module, and Platform Resources (purple boxes)
- **VSO Core Modules:** Scenario Management, State Manager, Evidence Aggregation, Scenario Evidence Violation, Response Management (orange/yellow boxes)
- **Output Layer:** OEM State Manager / Safety Manager integration and S-CORE Lifecycle handoff (green boxes)

Key principle: VSO observes and generates evidence but does NOT execute or decide.

### VSO_component_relationship.svg
**Used in:** [docs/features/vso/index.rst](../index.rst) - Integration with S-CORE Components section

Diagram showing the clear separation of concerns between:
- **S-CORE Diagnostics / OpenSOVD** (blue) - raw signals, fault lifecycle
- **VSO** (orange) - evidence generation, pipeline monitoring
- **OEM State Manager / Safety Manager** (green) - decision-making
- **S-CORE Lifecycle** (purple) - execution

### VSO_evidence_state_matrix.svg
**Used in:** [docs/features/vso/index.rst](../index.rst) - Evidence State Response Matrix section

Visual representation of the Evidence State Response Matrix showing six evidence states:
- **OK** (green): Normal execution, no action
- **WATCH** (yellow): Light monitoring, minor deviations
- **WARN** (orange): Focused debugging (30s), pre-snapshot, dashboard warning
- **VIOLATED** (red): Intensive diagnostics (60s), snapshot freeze, critical alert
- **INCOMPLETE** (purple): Missing signals, low confidence evidence
- **RECOVERED** (blue): Return to normal, recovery package archived
254 changes: 254 additions & 0 deletions docs/features/vso/_assets/SCORE_architecture_with_VSO.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
187 changes: 187 additions & 0 deletions docs/features/vso/_assets/VSO_architecture.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading