# cssegisanddata/covid-19 architecture

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

- Interactive diagram: https://gitdiagram.com/cssegisanddata/covid-19
- Repository: https://github.com/cssegisanddata/covid-19

## Overview

This repository is a published COVID-19 surveillance dataset, not an application runtime. Its user workflow is to obtain case and outcome data from dated reports or longitudinal series for use in the JHU CSSE visual dashboard and other analysis. The tree also preserves U.S.-specific reports, geographic identifiers, WHO situation-report material, and archived snapshots. The README documents the dashboard purpose and historical data sources, but no source excerpts were provided, so collection-level relationships beyond those statements are not inferred.

Main entry points: [`csse_covid_19_data/csse_covid_19_daily_reports`](https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_daily_reports) (Global daily reports), [`csse_covid_19_data/csse_covid_19_time_series`](https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_time_series) (Global time series), [`csse_covid_19_data/csse_covid_19_daily_reports_us`](https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_daily_reports_us) (U.S. daily reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_published["Published datasets"]
  node_daily_global[("Global daily reports")]
  node_global_series[("Global time series")]
  node_us_daily[("U.S. daily reports")]
  node_who_pdfs["WHO report PDFs"]
  node_who_series[("WHO report series")]
end

subgraph group_history["Historical archives"]
  node_archived_daily[("Archived daily updates")]
  node_archived_series[("Archived time series")]
end

subgraph group_references["Reference material"]
  node_lookup["Geographic lookup"]
end

node_data_users(("Dashboard and data users"))
node_data_sources(("Historical data sources"))

node_daily_global -->|"serves data"| node_data_users
node_global_series -->|"serves data"| node_data_users
node_us_daily -->|"serves data"| node_data_users
node_data_sources -->|"informs dataset"| node_daily_global

click node_daily_global "https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_daily_reports"
click node_global_series "https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_time_series"
click node_us_daily "https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_daily_reports_us"
click node_lookup "https://github.com/cssegisanddata/covid-19/blob/master/csse_covid_19_data/UID_ISO_FIPS_LookUp_Table.csv"
click node_who_pdfs "https://github.com/cssegisanddata/covid-19/tree/master/who_covid_19_situation_reports/who_covid_19_sit_rep_pdfs"
click node_who_series "https://github.com/cssegisanddata/covid-19/tree/master/who_covid_19_situation_reports/who_covid_19_sit_rep_time_series"
click node_archived_daily "https://github.com/cssegisanddata/covid-19/tree/master/archived_data/archived_daily_case_updates"
click node_archived_series "https://github.com/cssegisanddata/covid-19/tree/master/archived_data/archived_time_series"

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_daily_global,node_global_series,node_us_daily,node_who_pdfs,node_who_series,node_data_users toneBlue
class node_archived_daily,node_archived_series toneAmber
class node_lookup toneMint
class node_data_sources toneIndigo
```

## Components

### Published datasets

- [Global daily reports](https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_daily_reports): `csse_covid_19_data/csse_covid_19_daily_reports`
- [Global time series](https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_time_series): `csse_covid_19_data/csse_covid_19_time_series`
- [U.S. daily reports](https://github.com/cssegisanddata/covid-19/tree/master/csse_covid_19_data/csse_covid_19_daily_reports_us): `csse_covid_19_data/csse_covid_19_daily_reports_us`
- [WHO report PDFs](https://github.com/cssegisanddata/covid-19/tree/master/who_covid_19_situation_reports/who_covid_19_sit_rep_pdfs): `who_covid_19_situation_reports/who_covid_19_sit_rep_pdfs`
- [WHO report series](https://github.com/cssegisanddata/covid-19/tree/master/who_covid_19_situation_reports/who_covid_19_sit_rep_time_series): `who_covid_19_situation_reports/who_covid_19_sit_rep_time_series`

### Historical archives

- [Archived daily updates](https://github.com/cssegisanddata/covid-19/tree/master/archived_data/archived_daily_case_updates): `archived_data/archived_daily_case_updates`
- [Archived time series](https://github.com/cssegisanddata/covid-19/tree/master/archived_data/archived_time_series): `archived_data/archived_time_series`

### Reference material

- [Geographic lookup](https://github.com/cssegisanddata/covid-19/blob/master/csse_covid_19_data/UID_ISO_FIPS_LookUp_Table.csv): `csse_covid_19_data/UID_ISO_FIPS_LookUp_Table.csv`

### Other components

- **Dashboard and data users**
- **Historical data sources**

## Connections

- Global daily reports → Dashboard and data users: serves data (evidence: `README.md`)
- Global time series → Dashboard and data users: serves data (evidence: `README.md`)
- U.S. daily reports → Dashboard and data users: serves data (evidence: `README.md`)
- Historical data sources → Global daily reports: informs dataset (evidence: `README.md`)