# unlaesh/project architecture

> Architecture diagram of the GitHub repository unlaesh/project, 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/unlaesh/project
- Repository: https://github.com/unlaesh/project

## Overview

ЮУУ.Пары is a Telegram bot for students to view group-based schedules, keep notes tied to classes, and receive class reminders. The documented workflow starts with a student choosing a group, then requesting a schedule through the bot; a service parses the university schedule and stores cached schedule data. Notes, reminders, and administrator user viewing are documented capabilities, but their implementation and connections to the listed REST API and Kafka are not described. Only README-supported relationships are shown; source paths are unavailable in the supplied tree.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Telegram interaction"]
  node_bot["Bot interface"]
  node_schedule_view["Schedule view"]
  node_user_admin["User viewing"]
end

subgraph group_schedule["Schedule data"]
  node_parser["Schedule parser"]
  node_schedule_store[("Schedule cache")]
end

subgraph group_personal["Student features"]
  node_notes["Class notes"]
  node_reminders["Class reminders"]
end

node_student(("Student"))
node_telegram["Telegram"]
node_admin(("Administrator"))
node_university_site["ЮУрГУ schedule site"]

node_student -->|"uses"| node_telegram
node_telegram -->|"delivers messages"| node_bot
node_bot -->|"shows schedule"| node_schedule_view
node_student -->|"sets group"| node_bot
node_parser -->|"parses schedule"| node_university_site
node_parser -->|"caches schedule"| node_schedule_store
node_admin -->|"views users"| node_user_admin
node_student -->|"writes notes"| node_notes
node_schedule_view -->|"shows with schedule"| node_notes
node_student -->|"configures alerts"| node_reminders
node_reminders -.->|"sends alerts"| node_telegram

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,node_schedule_view,node_user_admin toneBlue
class node_parser,node_schedule_store toneAmber
class node_notes,node_reminders toneMint
class node_student,node_telegram,node_admin,node_university_site toneIndigo
```

## Components

### Telegram interaction

- **Bot interface**
- **Schedule view**
- **User viewing**

### Schedule data

- **Schedule parser**
- **Schedule cache**

### Student features

- **Class notes**
- **Class reminders**

### Other components

- **Student**
- **Telegram**
- **Administrator**
- **ЮУрГУ schedule site**

## Connections

- Student → Telegram: uses (evidence: `README.md`)
- Telegram → Bot interface: delivers messages (evidence: `README.md`)
- Bot interface → Schedule view: shows schedule (evidence: `README.md`)
- Student → Bot interface: sets group (evidence: `README.md`)
- Schedule parser → ЮУрГУ schedule site: parses schedule (evidence: `README.md`)
- Schedule parser → Schedule cache: caches schedule (evidence: `README.md`)
- Administrator → User viewing: views users (evidence: `README.md`)
- Student → Class notes: writes notes (evidence: `README.md`)
- Schedule view → Class notes: shows with schedule (evidence: `README.md`)
- Student → Class reminders: configures alerts (evidence: `README.md`)
- Class reminders → Telegram: sends alerts
