# selamhemanth/patchvane architecture

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

- Interactive diagram: https://gitdiagram.com/selamhemanth/patchvane
- Repository: https://github.com/selamhemanth/patchvane

## Overview

Patchvane tracks a user's Linux kernel mailing-list patches from posting through review, maintainer uptake, linux-next, and mainline, then presents their status and follow-up needs in a web dashboard. The main workflow is sign-in, public-archive collection and classification, then dashboard display and optional email notices. Separate branches provide subsystem/author discovery, AI-assisted interpretation, and feedback handling. The excerpts and index establish key module references, but do not show all runtime routing or collection internals; uncertain connections are omitted or marked unverified.

Main entry points: [`src/serve.py`](https://github.com/selamhemanth/patchvane/blob/main/src/serve.py) (HTTP application), [`src/collect.py`](https://github.com/selamhemanth/patchvane/blob/main/src/collect.py) (Patch collection), [`src/discover.py`](https://github.com/selamhemanth/patchvane/blob/main/src/discover.py) (Subsystem discovery), [`src/mailer.py`](https://github.com/selamhemanth/patchvane/blob/main/src/mailer.py) (Email delivery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and delivery"]
  node_server["HTTP application<br/>[serve.py]"]
  node_webui["Dashboard UI<br/>[app.js]"]
  node_accounts["Account access<br/>[accounts.py]"]
  node_vault["Encrypted secrets<br/>[vault.py]"]
  node_mailer["Email delivery<br/>[mailer.py]"]
end

subgraph group_tracking["Patch tracking"]
  node_collector["Patch collection<br/>[collect.py]"]
  node_classifier["Thread classification<br/>[aiclass.py]"]
  node_releasecycle["Release cycle<br/>[releases.py]"]
  node_notice["Patch notices<br/>[notices.py]"]
end

subgraph group_insight["Discovery and assistance"]
  node_discover["Subsystem discovery<br/>[discover.py]"]
  node_assistant["AI assistance<br/>[aiclass.py]"]
  node_providers["Model providers<br/>[providers.py]"]
end

subgraph group_support["Feedback"]
  node_feedback["Feedback intake<br/>[feedback.py]"]
  node_redaction["Data redaction<br/>[redact.py]"]
end

node_person(("Patch author"))
node_browser(("Web browser"))
node_mailservice["Mail service"]
node_lore["Lore archives"]
node_patchwork["Patchwork records"]
node_kerneltrees["Kernel trees"]
node_modelservice["Model API"]

node_person -->|"uses"| node_browser
node_browser -.->|"requests pages"| node_server
node_server -->|"serves"| node_webui
node_server -->|"uses"| node_accounts
node_server -->|"uses"| node_vault
node_server -->|"runs collection"| node_collector
node_server -->|"raises notices"| node_notice
node_server -->|"uses"| node_discover
node_server -->|"routes feedback"| node_feedback
node_server -->|"uses"| node_redaction
node_server -->|"sends mail"| node_mailer
node_collector -->|"reads threads"| node_lore
node_collector -.->|"reads records"| node_patchwork
node_collector -->|"reads commits"| node_kerneltrees
node_collector -->|"classifies threads"| node_classifier
node_collector -->|"uses models"| node_providers
node_collector -->|"uses release data"| node_releasecycle
node_collector -->|"uses secrets"| node_vault
node_discover -->|"reads records"| node_patchwork
node_discover -->|"uses release data"| node_releasecycle
node_classifier -->|"requests answers"| node_providers
node_providers -->|"calls model API"| node_modelservice
node_mailer -->|"delivers mail"| node_mailservice
node_feedback -->|"sends reports"| node_mailer
node_webui -.->|"submits actions"| node_server

click node_server "https://github.com/selamhemanth/patchvane/blob/main/src/serve.py"
click node_webui "https://github.com/selamhemanth/patchvane/blob/main/web/app.js"
click node_accounts "https://github.com/selamhemanth/patchvane/blob/main/src/accounts.py"
click node_vault "https://github.com/selamhemanth/patchvane/blob/main/src/vault.py"
click node_mailer "https://github.com/selamhemanth/patchvane/blob/main/src/mailer.py"
click node_collector "https://github.com/selamhemanth/patchvane/blob/main/src/collect.py"
click node_classifier "https://github.com/selamhemanth/patchvane/blob/main/src/aiclass.py"
click node_releasecycle "https://github.com/selamhemanth/patchvane/blob/main/src/releases.py"
click node_notice "https://github.com/selamhemanth/patchvane/blob/main/src/notices.py"
click node_discover "https://github.com/selamhemanth/patchvane/blob/main/src/discover.py"
click node_assistant "https://github.com/selamhemanth/patchvane/blob/main/src/aiclass.py"
click node_providers "https://github.com/selamhemanth/patchvane/blob/main/src/providers.py"
click node_feedback "https://github.com/selamhemanth/patchvane/blob/main/src/feedback.py"
click node_redaction "https://github.com/selamhemanth/patchvane/blob/main/src/redact.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_server,node_webui,node_accounts,node_vault,node_mailer,node_browser toneBlue
class node_collector,node_classifier,node_releasecycle,node_notice toneAmber
class node_discover,node_assistant,node_providers,node_modelservice toneMint
class node_feedback,node_redaction toneRose
class node_person,node_mailservice,node_lore,node_patchwork,node_kerneltrees toneIndigo
```

## Components

### Access and delivery

- [HTTP application](https://github.com/selamhemanth/patchvane/blob/main/src/serve.py): `src/serve.py`
- [Dashboard UI](https://github.com/selamhemanth/patchvane/blob/main/web/app.js): `web/app.js`
- [Account access](https://github.com/selamhemanth/patchvane/blob/main/src/accounts.py): `src/accounts.py`
- [Encrypted secrets](https://github.com/selamhemanth/patchvane/blob/main/src/vault.py): `src/vault.py`
- [Email delivery](https://github.com/selamhemanth/patchvane/blob/main/src/mailer.py): `src/mailer.py`

### Patch tracking

- [Patch collection](https://github.com/selamhemanth/patchvane/blob/main/src/collect.py): `src/collect.py`
- [Thread classification](https://github.com/selamhemanth/patchvane/blob/main/src/aiclass.py): `src/aiclass.py`
- [Release cycle](https://github.com/selamhemanth/patchvane/blob/main/src/releases.py): `src/releases.py`
- [Patch notices](https://github.com/selamhemanth/patchvane/blob/main/src/notices.py): `src/notices.py`

### Discovery and assistance

- [Subsystem discovery](https://github.com/selamhemanth/patchvane/blob/main/src/discover.py): `src/discover.py`
- [AI assistance](https://github.com/selamhemanth/patchvane/blob/main/src/aiclass.py): `src/aiclass.py`
- [Model providers](https://github.com/selamhemanth/patchvane/blob/main/src/providers.py): `src/providers.py`

### Feedback

- [Feedback intake](https://github.com/selamhemanth/patchvane/blob/main/src/feedback.py): `src/feedback.py`
- [Data redaction](https://github.com/selamhemanth/patchvane/blob/main/src/redact.py): `src/redact.py`

### Other components

- **Patch author**
- **Web browser**
- **Mail service**
- **Lore archives**
- **Patchwork records**
- **Kernel trees**
- **Model API**

## Connections

- Patch author → Web browser: uses (evidence: `README.md`)
- Web browser → HTTP application: requests pages
- HTTP application → Dashboard UI: serves (evidence: `README.md`)
- HTTP application → Account access: uses (evidence: `src/serve.py`)
- HTTP application → Encrypted secrets: uses (evidence: `src/serve.py`)
- HTTP application → Patch collection: runs collection (evidence: `README.md`)
- HTTP application → Patch notices: raises notices (evidence: `src/serve.py`)
- HTTP application → Subsystem discovery: uses (evidence: `src/serve.py`)
- HTTP application → Feedback intake: routes feedback (evidence: `src/serve.py`)
- HTTP application → Data redaction: uses (evidence: `src/serve.py`)
- HTTP application → Email delivery: sends mail (evidence: `src/serve.py`)
- Patch collection → Lore archives: reads threads (evidence: `src/collect.py`)
- Patch collection → Patchwork records: reads records
- Patch collection → Kernel trees: reads commits (evidence: `src/collect.py`)
- Patch collection → Thread classification: classifies threads (evidence: `src/collect.py`)
- Patch collection → Model providers: uses models (evidence: `src/collect.py`)
- Patch collection → Release cycle: uses release data (evidence: `src/collect.py`)
- Patch collection → Encrypted secrets: uses secrets (evidence: `src/collect.py`)
- Subsystem discovery → Patchwork records: reads records (evidence: `src/discover.py`)
- Subsystem discovery → Release cycle: uses release data (evidence: `src/discover.py`)
- Thread classification → Model providers: requests answers (evidence: `src/aiclass.py`)
- Model providers → Model API: calls model API (evidence: `src/providers.py`)
- Email delivery → Mail service: delivers mail (evidence: `src/mailer.py`)
- Feedback intake → Email delivery: sends reports (evidence: `src/feedback.py`)
- Dashboard UI → HTTP application: submits actions
