# certcc/ssvc architecture

> Architecture diagram of the GitHub repository certcc/ssvc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/certcc/ssvc
- Repository: https://github.com/certcc/ssvc

## Overview

SSVC is a Python toolkit for stakeholder-specific vulnerability prioritization, with a FastAPI interface alongside its decision-modeling library. The principal workflow is to define or select vulnerability decision points, combine them in decision tables, and interpret the resulting outcome; tables can also be analyzed to enumerate paths and produce CSV. CVSS, CISA, NIST, and SSVC-specific decision-point collections and tables are distinct domain branches. The README documents generated JSON/schema examples and documentation support, but their runtime wiring is not established by the sampled source. API route details are likewise unsampled.

Main entry points: [`src/ssvc/decision_points/base.py`](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/base.py) (Decision point model), [`src/ssvc/decision_tables/base.py`](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/base.py) (Decision table model), [`src/ssvc/policy_generator.py`](https://github.com/certcc/ssvc/blob/main/src/ssvc/policy_generator.py) (Policy generation), [`src/ssvc/api/main.py`](https://github.com/certcc/ssvc/blob/main/src/ssvc/api/main.py) (API application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_api_app["API application<br/>[main.py]"]
  node_api_routes["API v1 routes<br/>[v1_router.py]"]
  node_api_models["Response models"]
end

subgraph group_models["Decision models"]
  node_dp_core["Decision point model<br/>[base.py]"]
  node_cvss_dp["CVSS decision points<br/>[attack_vector.py]"]
  node_ssvc_dp["SSVC decision points<br/>[base.py]"]
  node_cisa_nist_dp["CISA and NIST points"]
  node_dp_helpers["Point helpers<br/>[helpers.py]"]
  node_table_core["Decision table model<br/>[base.py]"]
  node_dp_groups["Legacy point groups<br/>[base.py]"]
end

subgraph group_catalogs["Decision catalog"]
  node_ssvc_tables["SSVC tables<br/>[coord_triage.py]"]
  node_cisa_tables["CISA tables"]
  node_cvss_tables["CVSS tables"]
  node_dp_collections["Point collections<br/>[collections.py]"]
end

subgraph group_analysis["Analysis outputs"]
  node_outcomes["Outcome definitions<br/>[coordinate.py]"]
  node_csv_analyzer["CSV path analysis<br/>[csv_analyzer.py]"]
  node_toposort["Decision ordering<br/>[toposort.py]"]
  node_policy["Policy generation"]
end

subgraph group_foundation["Shared foundation"]
  node_registry[("Object registry<br/>[base.py]")]
  node_namespaces["Namespace rules<br/>[namespaces.py]"]
  node_mixins["Model mixins<br/>[_mixins.py]"]
  node_defaults["Field defaults<br/>[defaults.py]"]
  node_field_specs["Field specifications<br/>[field_specs.py]"]
end

node_user(("Vulnerability manager"))

node_user -.->|"submits requests"| node_api_app
node_api_app -->|"mounts v1"| node_api_routes
node_api_routes -.->|"serves responses"| node_api_models
node_api_app -->|"uses registry"| node_registry
node_dp_core -->|"inherits traits"| node_mixins
node_dp_core -->|"uses defaults"| node_defaults
node_cvss_dp -->|"extends model"| node_dp_core
node_ssvc_dp -.->|"extends model"| node_dp_core
node_cisa_nist_dp -->|"extends model"| node_dp_core
node_cvss_dp -->|"uses helpers"| node_dp_helpers
node_table_core -->|"validates points"| node_dp_core
node_table_core -->|"looks up points"| node_registry
node_table_core -->|"uses fields"| node_field_specs
node_dp_groups -->|"groups points"| node_dp_core
node_ssvc_tables -->|"defines mappings"| node_table_core
node_ssvc_tables -->|"uses outcomes"| node_outcomes
node_cisa_tables -->|"defines mappings"| node_table_core
node_cisa_tables -->|"uses scoring"| node_outcomes
node_cvss_tables -->|"defines mappings"| node_table_core
node_dp_collections -->|"collects points"| node_cvss_dp
node_mixins -->|"validates names"| node_namespaces
node_mixins -->|"uses fields"| node_field_specs
node_csv_analyzer -->|"orders paths"| node_toposort
node_policy -->|"analyzes paths"| node_csv_analyzer
node_policy -->|"uses points"| node_dp_core
node_policy -->|"uses groups"| node_dp_groups
node_policy -->|"uses outcomes"| node_outcomes

click node_api_app "https://github.com/certcc/ssvc/blob/main/src/ssvc/api/main.py"
click node_api_routes "https://github.com/certcc/ssvc/blob/main/src/ssvc/api/v1/routers/v1_router.py"
click node_api_models "https://github.com/certcc/ssvc/tree/main/src/ssvc/api/v1/response_models"
click node_dp_core "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/base.py"
click node_cvss_dp "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/cvss/attack_vector.py"
click node_ssvc_dp "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/ssvc/base.py"
click node_cisa_nist_dp "https://github.com/certcc/ssvc/tree/main/src/ssvc/decision_points/cisa"
click node_dp_helpers "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/helpers.py"
click node_table_core "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/base.py"
click node_dp_groups "https://github.com/certcc/ssvc/blob/main/src/ssvc/dp_groups/base.py"
click node_ssvc_tables "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/ssvc/coord_triage.py"
click node_cisa_tables "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py"
click node_cvss_tables "https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/cvss/equivalence_set_six.py"
click node_dp_collections "https://github.com/certcc/ssvc/blob/main/src/ssvc/dp_groups/cvss/collections.py"
click node_registry "https://github.com/certcc/ssvc/blob/main/src/ssvc/registry/base.py"
click node_namespaces "https://github.com/certcc/ssvc/blob/main/src/ssvc/namespaces.py"
click node_mixins "https://github.com/certcc/ssvc/blob/main/src/ssvc/_mixins.py"
click node_defaults "https://github.com/certcc/ssvc/blob/main/src/ssvc/utils/defaults.py"
click node_field_specs "https://github.com/certcc/ssvc/blob/main/src/ssvc/utils/field_specs.py"
click node_outcomes "https://github.com/certcc/ssvc/blob/main/src/ssvc/outcomes/ssvc/coordinate.py"
click node_csv_analyzer "https://github.com/certcc/ssvc/blob/main/src/ssvc/csv_analyzer.py"
click node_toposort "https://github.com/certcc/ssvc/blob/main/src/ssvc/utils/toposort.py"
click node_policy "https://github.com/certcc/ssvc/blob/main/src/ssvc/policy_generator.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api_app,node_api_routes,node_api_models toneBlue
class node_dp_core,node_cvss_dp,node_ssvc_dp,node_cisa_nist_dp,node_dp_helpers,node_table_core,node_dp_groups toneAmber
class node_ssvc_tables,node_cisa_tables,node_cvss_tables,node_dp_collections toneMint
class node_outcomes,node_csv_analyzer,node_toposort,node_policy toneRose
class node_registry,node_namespaces,node_mixins,node_defaults,node_field_specs,node_user toneIndigo
```

## Components

### HTTP API

- [API application](https://github.com/certcc/ssvc/blob/main/src/ssvc/api/main.py): `src/ssvc/api/main.py`
- [API v1 routes](https://github.com/certcc/ssvc/blob/main/src/ssvc/api/v1/routers/v1_router.py): `src/ssvc/api/v1/routers/v1_router.py`
- [Response models](https://github.com/certcc/ssvc/tree/main/src/ssvc/api/v1/response_models): `src/ssvc/api/v1/response_models`

### Decision models

- [Decision point model](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/base.py): `src/ssvc/decision_points/base.py`
- [CVSS decision points](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/cvss/attack_vector.py): `src/ssvc/decision_points/cvss/attack_vector.py`
- [SSVC decision points](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/ssvc/base.py): `src/ssvc/decision_points/ssvc/base.py`
- [CISA and NIST points](https://github.com/certcc/ssvc/tree/main/src/ssvc/decision_points/cisa): `src/ssvc/decision_points/cisa`
- [Point helpers](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_points/helpers.py): `src/ssvc/decision_points/helpers.py`
- [Decision table model](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/base.py): `src/ssvc/decision_tables/base.py`
- [Legacy point groups](https://github.com/certcc/ssvc/blob/main/src/ssvc/dp_groups/base.py): `src/ssvc/dp_groups/base.py`

### Decision catalog

- [SSVC tables](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/ssvc/coord_triage.py): `src/ssvc/decision_tables/ssvc/coord_triage.py`
- [CISA tables](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py): `src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py`
- [CVSS tables](https://github.com/certcc/ssvc/blob/main/src/ssvc/decision_tables/cvss/equivalence_set_six.py): `src/ssvc/decision_tables/cvss/equivalence_set_six.py`
- [Point collections](https://github.com/certcc/ssvc/blob/main/src/ssvc/dp_groups/cvss/collections.py): `src/ssvc/dp_groups/cvss/collections.py`

### Analysis outputs

- [Outcome definitions](https://github.com/certcc/ssvc/blob/main/src/ssvc/outcomes/ssvc/coordinate.py): `src/ssvc/outcomes/ssvc/coordinate.py`
- [CSV path analysis](https://github.com/certcc/ssvc/blob/main/src/ssvc/csv_analyzer.py): `src/ssvc/csv_analyzer.py`
- [Decision ordering](https://github.com/certcc/ssvc/blob/main/src/ssvc/utils/toposort.py): `src/ssvc/utils/toposort.py`
- [Policy generation](https://github.com/certcc/ssvc/blob/main/src/ssvc/policy_generator.py): `src/ssvc/policy_generator.py`

### Shared foundation

- [Object registry](https://github.com/certcc/ssvc/blob/main/src/ssvc/registry/base.py): `src/ssvc/registry/base.py`
- [Namespace rules](https://github.com/certcc/ssvc/blob/main/src/ssvc/namespaces.py): `src/ssvc/namespaces.py`
- [Model mixins](https://github.com/certcc/ssvc/blob/main/src/ssvc/_mixins.py): `src/ssvc/_mixins.py`
- [Field defaults](https://github.com/certcc/ssvc/blob/main/src/ssvc/utils/defaults.py): `src/ssvc/utils/defaults.py`
- [Field specifications](https://github.com/certcc/ssvc/blob/main/src/ssvc/utils/field_specs.py): `src/ssvc/utils/field_specs.py`

### Other components

- **Vulnerability manager**

## Connections

- Vulnerability manager → API application: submits requests
- API application → API v1 routes: mounts v1 (evidence: `src/ssvc/api/main.py`)
- API v1 routes → Response models: serves responses
- API application → Object registry: uses registry (evidence: `src/ssvc/api/main.py`)
- Decision point model → Model mixins: inherits traits (evidence: `src/ssvc/decision_points/base.py`)
- Decision point model → Field defaults: uses defaults (evidence: `src/ssvc/decision_points/base.py`)
- CVSS decision points → Decision point model: extends model (evidence: `src/ssvc/decision_points/cvss/attack_vector.py`)
- SSVC decision points → Decision point model: extends model
- CISA and NIST points → Decision point model: extends model (evidence: `src/ssvc/decision_points/cisa/mission_prevalence.py`)
- CVSS decision points → Point helpers: uses helpers (evidence: `src/ssvc/decision_points/cvss/attack_vector.py`)
- Decision table model → Decision point model: validates points (evidence: `src/ssvc/decision_tables/base.py`)
- Decision table model → Object registry: looks up points (evidence: `src/ssvc/decision_tables/base.py`)
- Decision table model → Field specifications: uses fields (evidence: `src/ssvc/decision_tables/base.py`)
- Legacy point groups → Decision point model: groups points (evidence: `src/ssvc/dp_groups/base.py`)
- SSVC tables → Decision table model: defines mappings (evidence: `src/ssvc/decision_tables/ssvc/coord_triage.py`)
- SSVC tables → Outcome definitions: uses outcomes (evidence: `src/ssvc/decision_tables/ssvc/coord_triage.py`)
- CISA tables → Decision table model: defines mappings (evidence: `src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py`)
- CISA tables → Outcome definitions: uses scoring (evidence: `src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py`)
- CVSS tables → Decision table model: defines mappings (evidence: `src/ssvc/decision_tables/cvss/equivalence_set_six.py`)
- Point collections → CVSS decision points: collects points (evidence: `src/ssvc/dp_groups/cvss/collections.py`)
- Model mixins → Namespace rules: validates names (evidence: `src/ssvc/_mixins.py`)
- Model mixins → Field specifications: uses fields (evidence: `src/ssvc/_mixins.py`)
- CSV path analysis → Decision ordering: orders paths (evidence: `src/ssvc/csv_analyzer.py`)
- Policy generation → CSV path analysis: analyzes paths (evidence: `src/ssvc/policy_generator.py`)
- Policy generation → Decision point model: uses points (evidence: `src/ssvc/policy_generator.py`)
- Policy generation → Legacy point groups: uses groups (evidence: `src/ssvc/policy_generator.py`)
- Policy generation → Outcome definitions: uses outcomes (evidence: `src/ssvc/policy_generator.py`)
