# ajmaradiaga/feeds architecture

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

- Interactive diagram: https://gitdiagram.com/ajmaradiaga/feeds
- Repository: https://github.com/ajmaradiaga/feeds

## Overview

This repository generates Atom feeds for SAP Community topics, members, and community replies; subscribers read the generated XML files directly. The primary workflow selects a job, uses configured topics or members to query the SAP Community API, builds Atom entries, and writes feeds under the public `scmt/` paths. It also provides a separate Markdown-table generator. Source excerpts show the CLI dispatch and feed implementation; scheduled execution is documented, but its workflow wiring was not excerpted.

Main entry points: [`jobs/generate.py`](https://github.com/ajmaradiaga/feeds/blob/main/jobs/generate.py) (Job dispatcher), [`jobs/feeds.py`](https://github.com/ajmaradiaga/feeds/blob/main/jobs/feeds.py) (Feed job handlers), [`jobs/markdown.py`](https://github.com/ajmaradiaga/feeds/blob/main/jobs/markdown.py) (Markdown tables), [`jobs/config.py`](https://github.com/ajmaradiaga/feeds/blob/main/jobs/config.py) (Topics and members)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Job control"]
  node_cli["Job dispatcher<br/>[generate.py]"]
end

subgraph group_catalog["Feed configuration"]
  node_config["Topics and members<br/>[config.py]"]
end

subgraph group_generation["Feed generation"]
  node_feedjobs["Feed job handlers<br/>[feeds.py]"]
  node_atom["Atom builder<br/>[feeds.py]"]
  node_markdown["Markdown tables<br/>[markdown.py]"]
end

subgraph group_outputs["Published outputs"]
  node_feedfiles[("Generated Atom XML")]
  node_tables["Generated tables"]
end

node_operator(("Job invoker"))
node_sapapi{{"SAP Community API"}}
node_subscriber(("Feed subscriber"))
node_scheduler(("Scheduled trigger"))

node_operator -->|"invokes"| node_cli
node_cli -->|"dispatches feed jobs"| node_feedjobs
node_cli -->|"selects configured sources"| node_config
node_cli -->|"dispatches tables job"| node_markdown
node_feedjobs -->|"queries"| node_sapapi
node_feedjobs -->|"passes search items"| node_atom
node_atom -->|"writes Atom XML"| node_feedfiles
node_markdown -->|"reads source lists"| node_config
node_markdown -->|"writes tables"| node_tables
node_subscriber -->|"reads published feeds"| node_feedfiles
node_scheduler -.->|"starts jobs"| node_cli

click node_cli "https://github.com/ajmaradiaga/feeds/blob/main/jobs/generate.py"
click node_config "https://github.com/ajmaradiaga/feeds/blob/main/jobs/config.py"
click node_feedjobs "https://github.com/ajmaradiaga/feeds/blob/main/jobs/feeds.py"
click node_atom "https://github.com/ajmaradiaga/feeds/blob/main/jobs/feeds.py"
click node_feedfiles "https://github.com/ajmaradiaga/feeds/tree/main/scmt"
click node_markdown "https://github.com/ajmaradiaga/feeds/blob/main/jobs/markdown.py"
click node_tables "https://github.com/ajmaradiaga/feeds/tree/main/jobs/markdown"

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_cli toneBlue
class node_config toneAmber
class node_feedjobs,node_atom,node_markdown,node_sapapi toneMint
class node_feedfiles,node_tables toneRose
class node_operator,node_subscriber,node_scheduler toneIndigo
```

## Components

### Job control

- [Job dispatcher](https://github.com/ajmaradiaga/feeds/blob/main/jobs/generate.py): `jobs/generate.py`

### Feed configuration

- [Topics and members](https://github.com/ajmaradiaga/feeds/blob/main/jobs/config.py): `jobs/config.py`

### Feed generation

- [Feed job handlers](https://github.com/ajmaradiaga/feeds/blob/main/jobs/feeds.py): `jobs/feeds.py`
- [Atom builder](https://github.com/ajmaradiaga/feeds/blob/main/jobs/feeds.py): `jobs/feeds.py`
- [Markdown tables](https://github.com/ajmaradiaga/feeds/blob/main/jobs/markdown.py): `jobs/markdown.py`

### Published outputs

- [Generated Atom XML](https://github.com/ajmaradiaga/feeds/tree/main/scmt): `scmt`
- [Generated tables](https://github.com/ajmaradiaga/feeds/tree/main/jobs/markdown): `jobs/markdown`

### Other components

- **Job invoker**
- **SAP Community API**
- **Feed subscriber**
- **Scheduled trigger**

## Connections

- Job invoker → Job dispatcher: invokes (evidence: `jobs/generate.py`)
- Job dispatcher → Feed job handlers: dispatches feed jobs (evidence: `jobs/generate.py`)
- Job dispatcher → Topics and members: selects configured sources (evidence: `jobs/generate.py`)
- Job dispatcher → Markdown tables: dispatches tables job (evidence: `jobs/generate.py`)
- Feed job handlers → SAP Community API: queries (evidence: `jobs/feeds.py`)
- Feed job handlers → Atom builder: passes search items (evidence: `jobs/feeds.py`)
- Atom builder → Generated Atom XML: writes Atom XML (evidence: `jobs/feeds.py`)
- Markdown tables → Topics and members: reads source lists (evidence: `jobs/markdown.py`)
- Markdown tables → Generated tables: writes tables (evidence: `jobs/markdown.py`)
- Feed subscriber → Generated Atom XML: reads published feeds (evidence: `README.md`)
- Scheduled trigger → Job dispatcher: starts jobs
