# meowning/energy-latest-tech-trends architecture

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

- Interactive diagram: https://gitdiagram.com/meowning/energy-latest-tech-trends
- Repository: https://github.com/meowning/energy-latest-tech-trends

## Overview

Energy Latest Technology Trends Notifier is documented as a weekday service that collects public-institution publications, organizes their metadata and files, and emails subscribers; it also supports OCR and Korean summarization. The shown backend implements an explicit Celery OCR-to-NLP chain, while the frontend currently only displays the landing page and an email form that alerts locally. Crawler, subscription, persistence, and delivery details are not established by the sampled implementation, so those documented capabilities are represented without inferred runtime connections.

Main entry points: [`backend/common/celery.py`](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/celery.py) (Celery orchestration), [`backend/common/config.py`](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/config.py) (Runtime configuration), [`backend/common/path_tokenization.py`](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/path_tokenization.py) (Path tokenization), [`backend/watcher`](https://github.com/meowning/energy-latest-tech-trends/tree/master/backend/watcher) (Publication crawler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Collection and delivery"]
  node_crawler["Publication crawler"]
  node_content["Content packaging"]
  node_subscribers(("Email subscribers"))
  node_mailer["Email delivery<br/>[mail.py]"]
end

subgraph group_processing["Document processing"]
  node_ocr_task["OCR task<br/>[tasks.py]"]
  node_ocr_engine["PDF and image OCR<br/>[ocr.py]"]
  node_nlp_task["Summarization task<br/>[tasks.py]"]
  node_nlp_engine["Korean summarization<br/>[nlp.py]"]
end

subgraph group_backend["Backend infrastructure"]
  node_celery["Celery orchestration<br/>[celery.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_file_helpers["File hashing and moves<br/>[hashing.py]"]
  node_path_tokens["Path tokenization"]
  node_redis[("Redis service")]
  node_database_helpers["Database access<br/>[db.py]"]
  node_mysql[("MySQL database")]
  node_api["Backend API<br/>[main.py]"]
end

subgraph group_web["Web interface"]
  node_frontend_app["Svelte application<br/>[App.svelte]"]
  node_home["Landing page<br/>[Home.svelte]"]
end

node_institutions(("Public institutions"))
node_web_user(("Site visitor"))

node_institutions -->|"publishes to"| node_crawler
node_crawler -->|"collects and organizes"| node_content
node_content -->|"delivered by"| node_mailer
node_mailer -->|"emails"| node_subscribers
node_celery -->|"chains task"| node_ocr_task
node_celery -->|"chains task"| node_nlp_task
node_ocr_task -->|"calls OCR"| node_ocr_engine
node_nlp_task -->|"calls summarizer"| node_nlp_engine
node_config -->|"configures broker"| node_celery
node_config -->|"sets file paths"| node_file_helpers
node_path_tokens -->|"checks file root"| node_file_helpers
node_path_tokens -->|"stores path tokens"| node_redis
node_database_helpers -->|"uses settings"| node_config
node_web_user -.->|"opens site"| node_frontend_app
node_frontend_app -->|"routes to"| node_home

click node_crawler "https://github.com/meowning/energy-latest-tech-trends/tree/master/backend/watcher"
click node_content "https://github.com/meowning/energy-latest-tech-trends/tree/master/backend"
click node_mailer "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/mail.py"
click node_ocr_task "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/worker/ocr/tasks.py"
click node_ocr_engine "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/ocr.py"
click node_nlp_task "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/worker/nlp/tasks.py"
click node_nlp_engine "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/nlp.py"
click node_celery "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/celery.py"
click node_config "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/config.py"
click node_file_helpers "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/hashing.py"
click node_path_tokens "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/path_tokenization.py"
click node_database_helpers "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/db.py"
click node_api "https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/api/main.py"
click node_frontend_app "https://github.com/meowning/energy-latest-tech-trends/blob/master/frontend/src/App.svelte"
click node_home "https://github.com/meowning/energy-latest-tech-trends/blob/master/frontend/src/routes/Home.svelte"

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_crawler,node_content,node_subscribers,node_mailer toneBlue
class node_ocr_task,node_ocr_engine,node_nlp_task,node_nlp_engine toneAmber
class node_celery,node_config,node_file_helpers,node_path_tokens,node_redis,node_database_helpers,node_mysql,node_api toneMint
class node_frontend_app,node_home toneRose
class node_institutions,node_web_user toneIndigo
```

## Components

### Collection and delivery

- [Publication crawler](https://github.com/meowning/energy-latest-tech-trends/tree/master/backend/watcher): `backend/watcher`
- [Content packaging](https://github.com/meowning/energy-latest-tech-trends/tree/master/backend): `backend`
- **Email subscribers**
- [Email delivery](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/mail.py): `backend/common/mail.py`

### Document processing

- [OCR task](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/worker/ocr/tasks.py): `backend/worker/ocr/tasks.py`
- [PDF and image OCR](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/ocr.py): `backend/common/ocr.py`
- [Summarization task](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/worker/nlp/tasks.py): `backend/worker/nlp/tasks.py`
- [Korean summarization](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/nlp.py): `backend/common/nlp.py`

### Backend infrastructure

- [Celery orchestration](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/celery.py): `backend/common/celery.py`
- [Runtime configuration](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/config.py): `backend/common/config.py`
- [File hashing and moves](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/hashing.py): `backend/common/hashing.py`
- [Path tokenization](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/path_tokenization.py): `backend/common/path_tokenization.py`
- **Redis service**
- [Database access](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/common/db.py): `backend/common/db.py`
- **MySQL database**
- [Backend API](https://github.com/meowning/energy-latest-tech-trends/blob/master/backend/api/main.py): `backend/api/main.py`

### Web interface

- [Svelte application](https://github.com/meowning/energy-latest-tech-trends/blob/master/frontend/src/App.svelte): `frontend/src/App.svelte`
- [Landing page](https://github.com/meowning/energy-latest-tech-trends/blob/master/frontend/src/routes/Home.svelte): `frontend/src/routes/Home.svelte`

### Other components

- **Public institutions**
- **Site visitor**

## Connections

- Public institutions → Publication crawler: publishes to (evidence: `README.md`)
- Publication crawler → Content packaging: collects and organizes (evidence: `README.md`)
- Content packaging → Email delivery: delivered by (evidence: `README.md`)
- Email delivery → Email subscribers: emails (evidence: `README.md`)
- Celery orchestration → OCR task: chains task (evidence: `backend/common/celery.py`)
- Celery orchestration → Summarization task: chains task (evidence: `backend/common/celery.py`)
- OCR task → PDF and image OCR: calls OCR (evidence: `backend/worker/ocr/tasks.py`)
- Summarization task → Korean summarization: calls summarizer (evidence: `backend/worker/nlp/tasks.py`)
- Runtime configuration → Celery orchestration: configures broker (evidence: `backend/common/celery.py`)
- Runtime configuration → File hashing and moves: sets file paths (evidence: `backend/common/hashing.py`)
- Path tokenization → File hashing and moves: checks file root (evidence: `backend/common/path_tokenization.py`)
- Path tokenization → Redis service: stores path tokens (evidence: `backend/common/path_tokenization.py`)
- Database access → Runtime configuration: uses settings (evidence: `backend/common/db.py`)
- Site visitor → Svelte application: opens site
- Svelte application → Landing page: routes to (evidence: `frontend/src/App.svelte`)
