# datahub-project/rfcs architecture

> Architecture diagram of the GitHub repository datahub-project/rfcs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/datahub-project/rfcs
- Repository: https://github.com/datahub-project/rfcs

## Overview

##### Main Components
- RFC Process Repository – The overall container for all RFC-related documents.
- Active RFCs – This is the “active” directory, which holds subfolders for various RFC proposals (e.g., “1778-dashboards”, “1812-ml_models”, etc.).
- Finished RFCs – The “finished” directory, which appears to manage RFCs that have been concluded (e.g., the presence of a .lock file may indicate state/version control).
- Templates – The “templates” directory containing template files used to start RFCs (e.g., “000-template.md”).
- Supplemental Components – Other directories like “access-control” and “tags” should also be recognized as specialized RFC topics.

##### Understand the Repository Purpose and Flow
- The README points to DataHub’s online RFC process. This gives context that the repository is not for running production code but for managing RFC proposals.
- Think of the repository as a workflow system: starting with a template, moving into an “active” phase for discussion and development, and finally moving to “finished” status after review and approval.

##### Data Flow and Lifecycle
- Start at Templates: Proposals are created from a template.
- Move to Active RFCs: The RFC enters a discussion/development phase.
- End at Finished RFCs: Once approved, the RFC (or the decision output) is marked as finished.

##### Architectural and Design Patterns
- Modular Organization: Each RFC proposal is kept independent as a folder under “active” or “finished” which promotes separation of concerns.
- Lifecycle Management: The clear transition from template → active → finished is an architectural pattern for managing state.
- Extensibility: The repository structure can be extended with new RFCs by simply adding new directories under “active” (or moving them to “finished” post-approval).

## Diagram (Mermaid)

```mermaid
flowchart TD
    R["DataHub RFC Repository"]:::repository
    T["Templates (RFC Starter)"]:::templates
    AR["Active RFCs"]:::active
    F["Finished RFCs"]:::finished
    AC["Access Control"]:::supplemental
    TAG["Tags"]:::supplemental

    a1["Active RFC: 1778-dashboards"]:::proposal
    a2["Active RFC: 1812-ml_models"]:::proposal
    a3["Active RFC: 1820-azkaban-flow-job"]:::proposal
    a4["Active RFC: 1841-lineage"]:::proposal
    a5["Active RFC: 1842-business_glossary"]:::proposal
    a6["Active RFC: 2042-graphql_frontend"]:::proposal
    a7["Active RFC: 2055-react-app"]:::proposal
    a8["Active RFC: 4237-datadoc-entity"]:::proposal

    R -->|"contains"| T
    T -->|"initiates"| AR
    AR -->|"evolves_to"| F

    AR -->|"includes"| a1
    AR -->|"includes"| a2
    AR -->|"includes"| a3
    AR -->|"includes"| a4
    AR -->|"includes"| a5
    AR -->|"includes"| a6
    AR -->|"includes"| a7
    AR -->|"includes"| a8

    AR -->|"specialized"| AC
    AR -->|"specialized"| TAG

    click R "https://github.com/datahub-project/rfcs/blob/main/README.md"
    click T "https://github.com/datahub-project/rfcs/blob/main/templates/000-template.md"
    click AR "https://github.com/datahub-project/rfcs/tree/main/active/"
    click a1 "https://github.com/datahub-project/rfcs/tree/main/active/1778-dashboards"
    click a2 "https://github.com/datahub-project/rfcs/tree/main/active/1812-ml_models"
    click a3 "https://github.com/datahub-project/rfcs/tree/main/active/1820-azkaban-flow-job"
    click a4 "https://github.com/datahub-project/rfcs/tree/main/active/1841-lineage"
    click a5 "https://github.com/datahub-project/rfcs/tree/main/active/1842-business_glossary"
    click a6 "https://github.com/datahub-project/rfcs/tree/main/active/2042-graphql_frontend"
    click a7 "https://github.com/datahub-project/rfcs/tree/main/active/2055-react-app"
    click a8 "https://github.com/datahub-project/rfcs/tree/main/active/4237-datadoc-entity"
    click F "https://github.com/datahub-project/rfcs/tree/main/finished/"
    click AC "https://github.com/datahub-project/rfcs/tree/main/active/access-control/"
    click TAG "https://github.com/datahub-project/rfcs/tree/main/active/tags/"

    classDef repository fill:#f9f,stroke:#333,stroke-width:2px;
    classDef templates fill:#ccf,stroke:#333,stroke-width:2px;
    classDef active fill:#cfc,stroke:#333,stroke-width:2px;
    classDef finished fill:#fcf,stroke:#333,stroke-width:2px;
    classDef supplemental fill:#cff,stroke:#333,stroke-width:2px;
    classDef proposal fill:#ffc,stroke:#333,stroke-width:2px;
```
