# sosoj92/signal-matin architecture

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

- Interactive diagram: https://gitdiagram.com/sosoj92/signal-matin
- Repository: https://github.com/sosoj92/signal-matin

## Overview

Signal Matin turns selected personal and public sources into a dated, normalized morning newspaper, then offers browser, PDF, print, and e-reader outputs. The graph follows the documented CLI workflow and preserves the major content, pagination, and delivery branches. Evidence is limited to the README, SOURCE INDEX references, and excerpts provided; unsampled implementation details are not inferred.

Main entry points: [`src/signal_matin/cli.py`](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/cli.py) (Command interface), [`src/signal_matin/pipeline.py`](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/pipeline.py) (Live collection), [`src/signal_matin/pdf.py`](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/pdf.py) (A4 and e-ink PDF), [`src/signal_matin/renderer.py`](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/renderer.py) (HTML newspaper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and configuration"]
  node_cli["Command interface<br/>[cli.py]"]
  node_config["Local settings<br/>[config.py]"]
end

subgraph group_content["Edition content"]
  node_pipeline["Live collection<br/>[pipeline.py]"]
  node_demo["Demo edition<br/>[mock_data.py]"]
  node_weather["Weather source<br/>[weather.py]"]
  node_calendar["ICS calendar<br/>[calendar_ics.py]"]
  node_google["Google Calendar<br/>[google_calendar.py]"]
  node_tasks["Tasks and reminders<br/>[tasks.py]"]
  node_rss["RSS news and tech<br/>[rss.py]"]
  node_learning["Daily learning<br/>[daily_learning.py]"]
  node_schema["Edition model<br/>[models.py]"]
end

subgraph group_composition["Composition and files"]
  node_normalize["Validate and normalize<br/>[normalizer.py]"]
  node_renderer["HTML newspaper<br/>[renderer.py]"]
  node_pagination["Adaptive pagination"]
  node_pdf["A4 and e-ink PDF<br/>[pdf.py]"]
  node_json["Edition JSON<br/>[normalizer.py]"]
end

subgraph group_delivery["Reading and delivery"]
  node_preview["Browser preview<br/>[cli.py]"]
  node_printer["Printer output<br/>[printer.py]"]
  node_ereader["EPUB edition<br/>[ereader.py]"]
  node_server["Reader server<br/>[ereader_server.py]"]
end

node_user(("User"))
node_rssfeeds(("RSS feeds"))
node_googlecal(("Google Calendar service"))

node_user -->|"runs command"| node_cli
node_cli -->|"loads settings"| node_config
node_cli -->|"builds live edition"| node_pipeline
node_cli -->|"selects demo"| node_demo
node_pipeline -->|"collects weather"| node_weather
node_pipeline -->|"collects events"| node_calendar
node_pipeline -->|"collects optionally"| node_google
node_pipeline -->|"collects tasks"| node_tasks
node_pipeline -->|"collects feeds"| node_rss
node_pipeline -->|"builds learning page"| node_learning
node_pipeline -->|"creates edition"| node_schema
node_demo -->|"builds demo content"| node_learning
node_cli -->|"normalizes edition"| node_normalize
node_normalize -->|"validates data"| node_schema
node_cli -->|"writes edition"| node_json
node_cli -->|"renders preview"| node_renderer
node_renderer -->|"renders model"| node_schema
node_pdf -->|"renders HTML"| node_renderer
node_pdf -->|"runs pagination"| node_pagination
node_cli -->|"generates PDF"| node_pdf
node_cli -->|"sends confirmed print"| node_printer
node_cli -->|"generates EPUB"| node_ereader
node_ereader -->|"generates e-ink PDF"| node_pdf
node_cli -->|"starts reader service"| node_server
node_rss -->|"reads feeds"| node_rssfeeds
node_google -->|"queries events"| node_googlecal
node_user -.->|"views output"| node_preview
node_user -.->|"prints newspaper"| node_printer
node_user -.->|"reads edition"| node_ereader

click node_cli "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/cli.py"
click node_config "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/config.py"
click node_pipeline "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/pipeline.py"
click node_demo "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/mock_data.py"
click node_weather "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/weather.py"
click node_calendar "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/calendar_ics.py"
click node_google "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/google_calendar.py"
click node_tasks "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/tasks.py"
click node_rss "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/rss.py"
click node_learning "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/daily_learning.py"
click node_schema "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/models.py"
click node_normalize "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/normalizer.py"
click node_renderer "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/renderer.py"
click node_pagination "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/assets/signal_matin_pagination.js"
click node_pdf "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/pdf.py"
click node_json "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/normalizer.py"
click node_preview "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/cli.py"
click node_printer "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/printer.py"
click node_ereader "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/ereader.py"
click node_server "https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/ereader_server.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_cli,node_config,node_user toneBlue
class node_pipeline,node_demo,node_weather,node_calendar,node_google,node_tasks,node_rss,node_learning,node_schema toneAmber
class node_normalize,node_renderer,node_pagination,node_pdf,node_json toneMint
class node_preview,node_printer,node_ereader,node_server toneRose
class node_rssfeeds,node_googlecal toneIndigo
```

## Components

### Entry and configuration

- [Command interface](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/cli.py): `src/signal_matin/cli.py`
- [Local settings](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/config.py): `src/signal_matin/config.py`

### Edition content

- [Live collection](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/pipeline.py): `src/signal_matin/pipeline.py`
- [Demo edition](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/mock_data.py): `src/signal_matin/mock_data.py`
- [Weather source](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/weather.py): `src/signal_matin/connectors/weather.py`
- [ICS calendar](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/calendar_ics.py): `src/signal_matin/connectors/calendar_ics.py`
- [Google Calendar](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/google_calendar.py): `src/signal_matin/connectors/google_calendar.py`
- [Tasks and reminders](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/tasks.py): `src/signal_matin/connectors/tasks.py`
- [RSS news and tech](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/connectors/rss.py): `src/signal_matin/connectors/rss.py`
- [Daily learning](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/daily_learning.py): `src/signal_matin/daily_learning.py`
- [Edition model](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/models.py): `src/signal_matin/models.py`

### Composition and files

- [Validate and normalize](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/normalizer.py): `src/signal_matin/normalizer.py`
- [HTML newspaper](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/renderer.py): `src/signal_matin/renderer.py`
- [Adaptive pagination](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/assets/signal_matin_pagination.js): `src/signal_matin/assets/signal_matin_pagination.js`
- [A4 and e-ink PDF](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/pdf.py): `src/signal_matin/pdf.py`
- [Edition JSON](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/normalizer.py): `src/signal_matin/normalizer.py`

### Reading and delivery

- [Browser preview](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/cli.py): `src/signal_matin/cli.py`
- [Printer output](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/printer.py): `src/signal_matin/printer.py`
- [EPUB edition](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/ereader.py): `src/signal_matin/ereader.py`
- [Reader server](https://github.com/sosoj92/signal-matin/blob/main/src/signal_matin/ereader_server.py): `src/signal_matin/ereader_server.py`

### Other components

- **User**
- **RSS feeds**
- **Google Calendar service**

## Connections

- User → Command interface: runs command (evidence: `README.md`)
- Command interface → Local settings: loads settings (evidence: `src/signal_matin/cli.py`)
- Command interface → Live collection: builds live edition (evidence: `src/signal_matin/cli.py`)
- Command interface → Demo edition: selects demo (evidence: `src/signal_matin/cli.py`)
- Live collection → Weather source: collects weather (evidence: `src/signal_matin/pipeline.py`)
- Live collection → ICS calendar: collects events (evidence: `src/signal_matin/pipeline.py`)
- Live collection → Google Calendar: collects optionally (evidence: `src/signal_matin/pipeline.py`)
- Live collection → Tasks and reminders: collects tasks (evidence: `src/signal_matin/pipeline.py`)
- Live collection → RSS news and tech: collects feeds (evidence: `src/signal_matin/pipeline.py`)
- Live collection → Daily learning: builds learning page (evidence: `src/signal_matin/pipeline.py`)
- Live collection → Edition model: creates edition (evidence: `src/signal_matin/pipeline.py`)
- Demo edition → Daily learning: builds demo content (evidence: `src/signal_matin/mock_data.py`)
- Command interface → Validate and normalize: normalizes edition (evidence: `src/signal_matin/cli.py`)
- Validate and normalize → Edition model: validates data (evidence: `src/signal_matin/normalizer.py`)
- Command interface → Edition JSON: writes edition (evidence: `README.md`)
- Command interface → HTML newspaper: renders preview (evidence: `src/signal_matin/cli.py`)
- HTML newspaper → Edition model: renders model (evidence: `src/signal_matin/renderer.py`)
- A4 and e-ink PDF → HTML newspaper: renders HTML (evidence: `src/signal_matin/pdf.py`)
- A4 and e-ink PDF → Adaptive pagination: runs pagination (evidence: `src/signal_matin/pdf.py`)
- Command interface → A4 and e-ink PDF: generates PDF (evidence: `src/signal_matin/cli.py`)
- Command interface → Printer output: sends confirmed print (evidence: `src/signal_matin/cli.py`)
- Command interface → EPUB edition: generates EPUB (evidence: `src/signal_matin/cli.py`)
- EPUB edition → A4 and e-ink PDF: generates e-ink PDF (evidence: `src/signal_matin/ereader.py`)
- Command interface → Reader server: starts reader service (evidence: `src/signal_matin/cli.py`)
- RSS news and tech → RSS feeds: reads feeds (evidence: `src/signal_matin/connectors/rss.py`)
- Google Calendar → Google Calendar service: queries events (evidence: `src/signal_matin/connectors/google_calendar.py`)
- User → Browser preview: views output (evidence: `README.md`)
- User → Printer output: prints newspaper (evidence: `README.md`)
- User → EPUB edition: reads edition (evidence: `README.md`)
