# syoumzic/link-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/syoumzic/link-tracker
- Repository: https://github.com/syoumzic/link-tracker

## Overview

This repository is a Scala 2 Link Tracker scaffold: the tree contains no service implementation files, so the map reflects only capabilities and relationships stated in the README. The documented workflow is tracking content changes and delivering update notifications through Telegram, with an AI processing stage described as an intermediary. Internal call paths, storage implementations, and REST/Kafka wiring cannot be verified from the available source.

Main entry points: [`scrapper/src/main/scala/tbank/academy`](https://github.com/syoumzic/link-tracker/tree/init/scrapper/src/main/scala/tbank/academy) (URL monitoring), [`bot/src/main/scala/tbank/academy`](https://github.com/syoumzic/link-tracker/tree/init/bot/src/main/scala/tbank/academy) (User commands), [`ai/src/main/scala/tbank/academy`](https://github.com/syoumzic/link-tracker/tree/init/ai/src/main/scala/tbank/academy) (Update processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bot["Bot Service"]
  node_bot_interaction["User commands"]
  node_bot_data[("User settings")]
  node_bot_notifications["Telegram notifications"]
end

subgraph group_scrapper["Scrapper Service"]
  node_scrapper_tracking["URL monitoring"]
  node_change_detection["Change detection"]
  node_scrapper_data[("Subscription state")]
end

subgraph group_ai["AI Agent"]
  node_ai_processing["Update processing"]
end

node_user(("Telegram user"))
node_content_sources["Content sources"]

node_user -->|"sends commands"| node_bot_interaction
node_bot_interaction -->|"manages settings"| node_bot_data
node_bot_interaction -->|"manages subscriptions"| node_scrapper_tracking
node_scrapper_tracking -->|"checks URLs"| node_content_sources
node_scrapper_tracking -->|"tracks subscriptions"| node_scrapper_data
node_scrapper_tracking -->|"detects updates"| node_change_detection
node_change_detection -->|"processes updates"| node_ai_processing
node_ai_processing -->|"forwards updates"| node_bot_notifications
node_bot_notifications -->|"sends notifications"| node_user

click node_bot_interaction "https://github.com/syoumzic/link-tracker/tree/init/bot/src/main/scala/tbank/academy"
click node_bot_data "https://github.com/syoumzic/link-tracker/tree/init/bot/src/main/scala/tbank/academy"
click node_scrapper_tracking "https://github.com/syoumzic/link-tracker/tree/init/scrapper/src/main/scala/tbank/academy"
click node_change_detection "https://github.com/syoumzic/link-tracker/tree/init/scrapper/src/main/scala/tbank/academy"
click node_scrapper_data "https://github.com/syoumzic/link-tracker/tree/init/scrapper/src/main/scala/tbank/academy"
click node_ai_processing "https://github.com/syoumzic/link-tracker/tree/init/ai/src/main/scala/tbank/academy"
click node_bot_notifications "https://github.com/syoumzic/link-tracker/tree/init/bot/src/main/scala/tbank/academy"

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_bot_interaction,node_bot_data,node_bot_notifications,node_user toneBlue
class node_scrapper_tracking,node_change_detection,node_scrapper_data toneAmber
class node_ai_processing toneMint
class node_content_sources toneIndigo
```

## Components

### Bot Service

- [User commands](https://github.com/syoumzic/link-tracker/tree/init/bot/src/main/scala/tbank/academy): `bot/src/main/scala/tbank/academy`
- [User settings](https://github.com/syoumzic/link-tracker/tree/init/bot/src/main/scala/tbank/academy): `bot/src/main/scala/tbank/academy`
- [Telegram notifications](https://github.com/syoumzic/link-tracker/tree/init/bot/src/main/scala/tbank/academy): `bot/src/main/scala/tbank/academy`

### Scrapper Service

- [URL monitoring](https://github.com/syoumzic/link-tracker/tree/init/scrapper/src/main/scala/tbank/academy): `scrapper/src/main/scala/tbank/academy`
- [Change detection](https://github.com/syoumzic/link-tracker/tree/init/scrapper/src/main/scala/tbank/academy): `scrapper/src/main/scala/tbank/academy`
- [Subscription state](https://github.com/syoumzic/link-tracker/tree/init/scrapper/src/main/scala/tbank/academy): `scrapper/src/main/scala/tbank/academy`

### AI Agent

- [Update processing](https://github.com/syoumzic/link-tracker/tree/init/ai/src/main/scala/tbank/academy): `ai/src/main/scala/tbank/academy`

### Other components

- **Telegram user**
- **Content sources**

## Connections

- Telegram user → User commands: sends commands (evidence: `README.md`)
- User commands → User settings: manages settings (evidence: `README.md`)
- User commands → URL monitoring: manages subscriptions (evidence: `README.md`)
- URL monitoring → Content sources: checks URLs (evidence: `README.md`)
- URL monitoring → Subscription state: tracks subscriptions (evidence: `README.md`)
- URL monitoring → Change detection: detects updates (evidence: `README.md`)
- Change detection → Update processing: processes updates (evidence: `README.md`)
- Update processing → Telegram notifications: forwards updates (evidence: `README.md`)
- Telegram notifications → Telegram user: sends notifications (evidence: `README.md`)
