# github/advisory-database architecture

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

- Interactive diagram: https://gitdiagram.com/github/advisory-database
- Repository: https://github.com/github/advisory-database

## Overview

This repository is a community-maintained database of security advisories, stored as individual OSV-formatted records. The principal workflow is that advisory information arrives from external databases or community submissions, is reviewed by GitHub’s security advisory curation team, and is merged into the records for downstream readers and systems. The tree shows the reviewed-advisory collection, but no application source; relationships and capabilities beyond that collection are therefore represented only where the README documents them.

Main entry points: [`advisories/github-reviewed`](https://github.com/github/advisory-database/tree/main/advisories/github-reviewed) (Reviewed advisories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Advisory intake"]
  node_sources["Advisory sources"]
  node_suggestion["Improvement form"]
  node_pull_request["Pull request"]
end

subgraph group_curation["Curation workflow"]
  node_curators["Security curators"]
  node_ecosystems["Supported ecosystems"]
end

subgraph group_database["Advisory database"]
  node_reviewed_records[("Reviewed advisories")]
  node_osv["OSV records"]
  node_ghsa_ids["GHSA identifiers"]
  node_specific_values["Database-specific values"]
end

subgraph group_consumption["Records and use"]
  node_readers(("Advisory readers"))
  node_consuming_systems(("Consuming systems"))
end

node_contributors(("Community contributors"))
node_publisher(("Original publisher"))

node_sources -->|"provide advisories"| node_reviewed_records
node_contributors -->|"suggest changes"| node_suggestion
node_suggestion -->|"opens"| node_pull_request
node_contributors -->|"submit directly"| node_pull_request
node_pull_request -->|"review"| node_curators
node_curators -->|"merge or close"| node_reviewed_records
node_curators -.->|"mention optionally"| node_publisher
node_reviewed_records -->|"formatted as"| node_osv
node_reviewed_records -->|"assigned identifiers"| node_ghsa_ids
node_reviewed_records -->|"includes metadata"| node_specific_values
node_reviewed_records -->|"constrained by"| node_ecosystems
node_readers -->|"read advisories"| node_reviewed_records
node_consuming_systems -->|"consume records"| node_reviewed_records

click node_reviewed_records "https://github.com/github/advisory-database/tree/main/advisories/github-reviewed"
click node_osv "https://github.com/github/advisory-database/tree/main/advisories/github-reviewed"
click node_ghsa_ids "https://github.com/github/advisory-database/tree/main/advisories/github-reviewed"
click node_specific_values "https://github.com/github/advisory-database/tree/main/advisories/github-reviewed"
click node_ecosystems "https://github.com/github/advisory-database/tree/main/advisories/github-reviewed"

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_sources,node_suggestion,node_pull_request toneBlue
class node_curators,node_ecosystems toneAmber
class node_reviewed_records,node_osv,node_ghsa_ids,node_specific_values toneMint
class node_readers,node_consuming_systems toneRose
class node_contributors,node_publisher toneIndigo
```

## Components

### Advisory intake

- **Advisory sources**
- **Improvement form**
- **Pull request**

### Curation workflow

- **Security curators**
- [Supported ecosystems](https://github.com/github/advisory-database/tree/main/advisories/github-reviewed): `advisories/github-reviewed`

### Advisory database

- [Reviewed advisories](https://github.com/github/advisory-database/tree/main/advisories/github-reviewed): `advisories/github-reviewed`
- [OSV records](https://github.com/github/advisory-database/tree/main/advisories/github-reviewed): `advisories/github-reviewed`
- [GHSA identifiers](https://github.com/github/advisory-database/tree/main/advisories/github-reviewed): `advisories/github-reviewed`
- [Database-specific values](https://github.com/github/advisory-database/tree/main/advisories/github-reviewed): `advisories/github-reviewed`

### Records and use

- **Advisory readers**
- **Consuming systems**

### Other components

- **Community contributors**
- **Original publisher**

## Connections

- Advisory sources → Reviewed advisories: provide advisories
- Community contributors → Improvement form: suggest changes
- Improvement form → Pull request: opens
- Community contributors → Pull request: submit directly
- Pull request → Security curators: review
- Security curators → Reviewed advisories: merge or close
- Security curators → Original publisher: mention optionally
- Reviewed advisories → OSV records: formatted as
- Reviewed advisories → GHSA identifiers: assigned identifiers
- Reviewed advisories → Database-specific values: includes metadata
- Reviewed advisories → Supported ecosystems: constrained by
- Advisory readers → Reviewed advisories: read advisories
- Consuming systems → Reviewed advisories: consume records
