# zenodo/zenodo architecture

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

- Interactive diagram: https://gitdiagram.com/zenodo/zenodo
- Repository: https://github.com/zenodo/zenodo

## Overview

Zenodo is a research-output repository built as a layer on Invenio. Researchers submit and manage deposits, which become records with metadata and files, then are discoverable and shareable in multiple formats; preservation is a core product goal. The tree also shows distinct community, identifier, export, audit, metrics, and external-indexing capabilities. The excerpts support several internal calls, but do not expose the main HTTP route wiring or most subsystem implementations, so those connections are omitted or marked unverified rather than presented as inspected.

Main entry points: [`zenodo/modules/records/serializers/__init__.py`](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/serializers/__init__.py) (Metadata formats), [`zenodo/modules/records/api.py`](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/api.py) (Record API), [`zenodo/modules/communities/tasks.py`](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/communities/tasks.py) (Community webhooks), [`zenodo/modules/openaire/tasks.py`](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/openaire/tasks.py) (OpenAIRE integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deposit["Deposit workflow"]
  node_deposit_api["Deposit API<br/>[api.py]"]
  node_deposit_views["Deposit views<br/>[views.py]"]
  node_deposit_tasks["Deposit tasks<br/>[tasks.py]"]
end

subgraph group_records["Records and discovery"]
  node_record_api["Record API<br/>[api.py]"]
  node_record_models["Record models<br/>[models.py]"]
  node_record_minters["PID minters<br/>[minters.py]"]
  node_record_query["Record search<br/>[query.py]"]
  node_record_serializers["Metadata formats<br/>[__init__.py]"]
  node_record_views["Record views<br/>[views.py]"]
  node_export_api["Export API<br/>[api.py]"]
  node_export_tasks["Export tasks<br/>[tasks.py]"]
end

subgraph group_community["Communities and integrations"]
  node_communities["Community features<br/>[views.py]"]
  node_community_webhooks["Community webhooks<br/>[tasks.py]"]
  node_openaire["OpenAIRE integration<br/>[tasks.py]"]
  node_github["GitHub integration<br/>[api.py]"]
end

subgraph group_operations["Repository operations"]
  node_auditor["Record auditing<br/>[tasks.py]"]
  node_stats["Usage statistics<br/>[tasks.py]"]
  node_metrics["Metrics<br/>[tasks.py]"]
end

node_researcher(("Researcher"))
node_external_services(("External services"))

node_researcher -.->|"submits deposit"| node_deposit_api
node_deposit_api -.->|"routes requests"| node_deposit_views
node_deposit_views -.->|"creates records"| node_record_api
node_deposit_tasks -->|"mints identifiers"| node_record_minters
node_deposit_tasks -->|"serializes records"| node_record_serializers
node_record_models -.->|"backs record API"| node_record_api
node_record_models -->|"uses date fields"| node_record_serializers
node_record_views -.->|"searches records"| node_record_query
node_record_views -.->|"formats responses"| node_record_serializers
node_record_serializers -.->|"offers metadata formats"| node_external_services
node_export_tasks -->|"runs exports"| node_export_api
node_export_api -->|"streams exports"| node_external_services
node_community_webhooks -->|"loads record"| node_record_api
node_community_webhooks -->|"transforms payload"| node_record_serializers
node_community_webhooks -->|"posts webhooks"| node_external_services
node_openaire -->|"loads records"| node_record_api
node_openaire -->|"serializes records"| node_record_serializers
node_openaire -->|"indexes records"| node_external_services
node_auditor -.->|"checks OAI records"| node_external_services
node_stats -->|"reindexes affected"| node_record_models
node_stats -->|"exports statistics"| node_external_services
node_metrics -.->|"updates metrics"| node_external_services
node_github -.->|"integrates GitHub"| node_external_services

click node_deposit_api "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/api.py"
click node_deposit_views "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/views.py"
click node_deposit_tasks "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/tasks.py"
click node_record_api "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/api.py"
click node_record_models "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/models.py"
click node_record_minters "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/minters.py"
click node_record_query "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/query.py"
click node_record_serializers "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/serializers/__init__.py"
click node_record_views "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/views.py"
click node_export_api "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/exporter/api.py"
click node_export_tasks "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/exporter/tasks.py"
click node_communities "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/communities/views.py"
click node_community_webhooks "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/communities/tasks.py"
click node_openaire "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/openaire/tasks.py"
click node_github "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/github/api.py"
click node_auditor "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/auditor/tasks.py"
click node_stats "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/stats/tasks.py"
click node_metrics "https://github.com/zenodo/zenodo/blob/master/zenodo/modules/metrics/tasks.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_deposit_api,node_deposit_views,node_deposit_tasks toneBlue
class node_record_api,node_record_models,node_record_minters,node_record_query,node_record_serializers,node_record_views,node_export_api,node_export_tasks toneAmber
class node_communities,node_community_webhooks,node_openaire,node_github toneMint
class node_auditor,node_stats,node_metrics toneRose
class node_researcher,node_external_services toneIndigo
```

## Components

### Deposit workflow

- [Deposit API](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/api.py): `zenodo/modules/deposit/api.py`
- [Deposit views](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/views.py): `zenodo/modules/deposit/views.py`
- [Deposit tasks](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/tasks.py): `zenodo/modules/deposit/tasks.py`

### Records and discovery

- [Record API](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/api.py): `zenodo/modules/records/api.py`
- [Record models](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/models.py): `zenodo/modules/records/models.py`
- [PID minters](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/minters.py): `zenodo/modules/records/minters.py`
- [Record search](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/query.py): `zenodo/modules/records/query.py`
- [Metadata formats](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/serializers/__init__.py): `zenodo/modules/records/serializers/__init__.py`
- [Record views](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/records/views.py): `zenodo/modules/records/views.py`
- [Export API](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/exporter/api.py): `zenodo/modules/exporter/api.py`
- [Export tasks](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/exporter/tasks.py): `zenodo/modules/exporter/tasks.py`

### Communities and integrations

- [Community features](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/communities/views.py): `zenodo/modules/communities/views.py`
- [Community webhooks](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/communities/tasks.py): `zenodo/modules/communities/tasks.py`
- [OpenAIRE integration](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/openaire/tasks.py): `zenodo/modules/openaire/tasks.py`
- [GitHub integration](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/github/api.py): `zenodo/modules/github/api.py`

### Repository operations

- [Record auditing](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/auditor/tasks.py): `zenodo/modules/auditor/tasks.py`
- [Usage statistics](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/stats/tasks.py): `zenodo/modules/stats/tasks.py`
- [Metrics](https://github.com/zenodo/zenodo/blob/master/zenodo/modules/metrics/tasks.py): `zenodo/modules/metrics/tasks.py`

### Other components

- **Researcher**
- **External services**

## Connections

- Researcher → Deposit API: submits deposit
- Deposit API → Deposit views: routes requests
- Deposit views → Record API: creates records
- Deposit tasks → PID minters: mints identifiers (evidence: `zenodo/modules/deposit/tasks.py`)
- Deposit tasks → Metadata formats: serializes records (evidence: `zenodo/modules/deposit/tasks.py`)
- Record models → Record API: backs record API
- Record models → Metadata formats: uses date fields (evidence: `zenodo/modules/records/models.py`)
- Record views → Record search: searches records
- Record views → Metadata formats: formats responses
- Metadata formats → External services: offers metadata formats
- Export tasks → Export API: runs exports (evidence: `zenodo/modules/exporter/tasks.py`)
- Export API → External services: streams exports (evidence: `zenodo/modules/exporter/api.py`)
- Community webhooks → Record API: loads record (evidence: `zenodo/modules/communities/tasks.py`)
- Community webhooks → Metadata formats: transforms payload (evidence: `zenodo/modules/communities/tasks.py`)
- Community webhooks → External services: posts webhooks (evidence: `zenodo/modules/communities/tasks.py`)
- OpenAIRE integration → Record API: loads records (evidence: `zenodo/modules/openaire/tasks.py`)
- OpenAIRE integration → Metadata formats: serializes records (evidence: `zenodo/modules/openaire/tasks.py`)
- OpenAIRE integration → External services: indexes records (evidence: `zenodo/modules/openaire/tasks.py`)
- Record auditing → External services: checks OAI records
- Usage statistics → Record models: reindexes affected (evidence: `zenodo/modules/stats/tasks.py`)
- Usage statistics → External services: exports statistics (evidence: `zenodo/modules/stats/tasks.py`)
- Metrics → External services: updates metrics
- GitHub integration → External services: integrates GitHub
