# temurlangmkm/mimobot architecture

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

## Overview

Mimo is a Telegram bot for group-based class schedules. A user’s message enters through the bot and chat dispatcher, then command or state handling delegates to user services for registration, group selection, schedule submission, or schedule retrieval. Schedule submission parses JSON, resolves group and schedule reference data, and persists schedule entries; retrieval maps stored entries to schedule DTOs for formatting. The tree also shows language and notification-related user state, but those features are incomplete or not evidenced as working flows. The README is empty; unsampled repository and handler behavior is not inferred.

Main entry points: [`src/main/java/Mimo/Schedule/Service/ScheduleService.java`](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Service/ScheduleService.java) (Schedule workflows), [`src/main/java/Mimo/Telegram/Service/UserService.java`](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Service/UserService.java) (User workflows), [`src/main/java/Mimo/Telegram/Handlers/ChatHandler.java`](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Handlers/ChatHandler.java) (Chat dispatcher), [`src/main/java/Mimo/Schedule/Repository/ScheduleRepository.java`](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Repository/ScheduleRepository.java) (Schedule repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_telegram["Telegram interaction"]
  node_bot["Bot adapter<br/>[MyTelegramBot.java]"]
  node_chat["Chat dispatcher<br/>[ChatHandler.java]"]
  node_commands["Command handling"]
  node_states["State handling<br/>[StateHandler.java]"]
end

subgraph group_users["User and groups"]
  node_user_service["User workflows<br/>[UserService.java]"]
  node_user_data["User records<br/>[UserEntity.java]"]
  node_group_service["Group management<br/>[GroupService.java]"]
end

subgraph group_schedule["Schedule domain"]
  node_schedule_service["Schedule workflows"]
  node_schedule_mapper["Schedule mapping"]
  node_schedule_dto["Schedule data<br/>[Schedule.java]"]
  node_schedule_entities["Schedule entities"]
end

subgraph group_persistence["Persistence"]
  node_user_repo["User repository"]
  node_group_repo["Group repository"]
  node_schedule_repo["Schedule repository"]
  node_reference_repos["Schedule reference repositories"]
end

node_person(("Telegram user"))
node_telegram_service{{"Telegram platform"}}
node_database[("Persistence database")]

node_person -->|"sends messages"| node_telegram_service
node_telegram_service -->|"delivers updates"| node_bot
node_bot -->|"dispatches updates"| node_chat
node_chat -->|"routes commands"| node_commands
node_chat -->|"routes state input"| node_states
node_chat -->|"checks user state"| node_user_service
node_commands -->|"delegates actions"| node_user_service
node_states -->|"delegates input"| node_user_service
node_user_service -->|"reads and saves users"| node_user_repo
node_user_repo -->|"persists records"| node_user_data
node_user_service -->|"resolves groups"| node_group_service
node_group_service -->|"reads and saves groups"| node_group_repo
node_user_service -->|"submits or fetches schedules"| node_schedule_service
node_schedule_service -->|"parses schedule data"| node_schedule_dto
node_schedule_service -->|"looks up group"| node_group_service
node_schedule_service -->|"resolves reference data"| node_reference_repos
node_schedule_service -->|"queries and saves entries"| node_schedule_repo
node_schedule_service -->|"maps query results"| node_schedule_mapper
node_schedule_mapper -->|"loads reference records"| node_schedule_repo
node_schedule_repo -->|"persists schedule entries"| node_schedule_entities
node_reference_repos -->|"persists reference records"| node_schedule_entities
node_schedule_repo -->|"reads and writes"| node_database
node_reference_repos -->|"reads and writes"| node_database
node_user_repo -->|"reads and writes"| node_database

click node_bot "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/MyTelegramBot.java"
click node_chat "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Handlers/ChatHandler.java"
click node_commands "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Handlers/CommandHandler.java"
click node_states "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Handlers/StateHandler.java"
click node_user_service "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Service/UserService.java"
click node_user_data "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Entity/UserEntity.java"
click node_user_repo "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Repository/UsersRepository.java"
click node_group_service "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Service/GroupService.java"
click node_group_repo "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Repository/GroupRepository.java"
click node_schedule_service "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Service/ScheduleService.java"
click node_schedule_mapper "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Service/ScheduleMapper.java"
click node_schedule_dto "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/DTO/Schedule.java"
click node_schedule_repo "https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Repository/ScheduleRepository.java"
click node_reference_repos "https://github.com/temurlangmkm/mimobot/tree/main/src/main/java/Mimo/Schedule/Repository"
click node_schedule_entities "https://github.com/temurlangmkm/mimobot/tree/main/src/main/java/Mimo/Schedule/Entity"

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_chat,node_commands,node_states,node_person toneBlue
class node_user_service,node_user_data,node_group_service,node_database toneAmber
class node_schedule_service,node_schedule_mapper,node_schedule_dto,node_schedule_entities toneMint
class node_user_repo,node_group_repo,node_schedule_repo,node_reference_repos toneRose
class node_telegram_service toneIndigo
```

## Components

### Telegram interaction

- [Bot adapter](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/MyTelegramBot.java): `src/main/java/Mimo/Telegram/MyTelegramBot.java`
- [Chat dispatcher](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Handlers/ChatHandler.java): `src/main/java/Mimo/Telegram/Handlers/ChatHandler.java`
- [Command handling](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Handlers/CommandHandler.java): `src/main/java/Mimo/Telegram/Handlers/CommandHandler.java`
- [State handling](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Handlers/StateHandler.java): `src/main/java/Mimo/Telegram/Handlers/StateHandler.java`

### User and groups

- [User workflows](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Service/UserService.java): `src/main/java/Mimo/Telegram/Service/UserService.java`
- [User records](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Entity/UserEntity.java): `src/main/java/Mimo/Telegram/Entity/UserEntity.java`
- [Group management](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Service/GroupService.java): `src/main/java/Mimo/Schedule/Service/GroupService.java`

### Schedule domain

- [Schedule workflows](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Service/ScheduleService.java): `src/main/java/Mimo/Schedule/Service/ScheduleService.java`
- [Schedule mapping](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Service/ScheduleMapper.java): `src/main/java/Mimo/Schedule/Service/ScheduleMapper.java`
- [Schedule data](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/DTO/Schedule.java): `src/main/java/Mimo/Schedule/DTO/Schedule.java`
- [Schedule entities](https://github.com/temurlangmkm/mimobot/tree/main/src/main/java/Mimo/Schedule/Entity): `src/main/java/Mimo/Schedule/Entity`

### Persistence

- [User repository](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Telegram/Repository/UsersRepository.java): `src/main/java/Mimo/Telegram/Repository/UsersRepository.java`
- [Group repository](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Repository/GroupRepository.java): `src/main/java/Mimo/Schedule/Repository/GroupRepository.java`
- [Schedule repository](https://github.com/temurlangmkm/mimobot/blob/main/src/main/java/Mimo/Schedule/Repository/ScheduleRepository.java): `src/main/java/Mimo/Schedule/Repository/ScheduleRepository.java`
- [Schedule reference repositories](https://github.com/temurlangmkm/mimobot/tree/main/src/main/java/Mimo/Schedule/Repository): `src/main/java/Mimo/Schedule/Repository`

### Other components

- **Telegram user**
- **Telegram platform**
- **Persistence database**

## Connections

- Telegram user → Telegram platform: sends messages
- Telegram platform → Bot adapter: delivers updates (evidence: `src/main/java/Mimo/Telegram/MyTelegramBot.java`)
- Bot adapter → Chat dispatcher: dispatches updates (evidence: `src/main/java/Mimo/Telegram/MyTelegramBot.java`)
- Chat dispatcher → Command handling: routes commands (evidence: `src/main/java/Mimo/Telegram/Handlers/ChatHandler.java`)
- Chat dispatcher → State handling: routes state input (evidence: `src/main/java/Mimo/Telegram/Handlers/ChatHandler.java`)
- Chat dispatcher → User workflows: checks user state (evidence: `src/main/java/Mimo/Telegram/Handlers/ChatHandler.java`)
- Command handling → User workflows: delegates actions (evidence: `src/main/java/Mimo/Telegram/Handlers/CommandHandler.java`)
- State handling → User workflows: delegates input (evidence: `src/main/java/Mimo/Telegram/Handlers/StateHandler.java`)
- User workflows → User repository: reads and saves users (evidence: `src/main/java/Mimo/Telegram/Service/UserService.java`)
- User repository → User records: persists records (evidence: `src/main/java/Mimo/Telegram/Repository/UsersRepository.java`)
- User workflows → Group management: resolves groups (evidence: `src/main/java/Mimo/Telegram/Service/UserService.java`)
- Group management → Group repository: reads and saves groups (evidence: `src/main/java/Mimo/Schedule/Service/GroupService.java`)
- User workflows → Schedule workflows: submits or fetches schedules (evidence: `src/main/java/Mimo/Telegram/Service/UserService.java`)
- Schedule workflows → Schedule data: parses schedule data (evidence: `src/main/java/Mimo/Schedule/Service/ScheduleService.java`)
- Schedule workflows → Group management: looks up group (evidence: `src/main/java/Mimo/Schedule/Service/ScheduleService.java`)
- Schedule workflows → Schedule reference repositories: resolves reference data (evidence: `src/main/java/Mimo/Schedule/Service/ScheduleService.java`)
- Schedule workflows → Schedule repository: queries and saves entries (evidence: `src/main/java/Mimo/Schedule/Service/ScheduleService.java`)
- Schedule workflows → Schedule mapping: maps query results (evidence: `src/main/java/Mimo/Schedule/Service/ScheduleService.java`)
- Schedule mapping → Schedule repository: loads reference records (evidence: `src/main/java/Mimo/Schedule/Service/ScheduleMapper.java`)
- Schedule repository → Schedule entities: persists schedule entries (evidence: `src/main/java/Mimo/Schedule/Repository/ScheduleRepository.java`)
- Schedule reference repositories → Schedule entities: persists reference records (evidence: `src/main/java/Mimo/Schedule/Repository/GroupRepository.java`)
- Schedule repository → Persistence database: reads and writes (evidence: `src/main/java/Mimo/Schedule/Repository/ScheduleRepository.java`)
- Schedule reference repositories → Persistence database: reads and writes (evidence: `src/main/java/Mimo/Schedule/Repository/GroupRepository.java`)
- User repository → Persistence database: reads and writes (evidence: `src/main/java/Mimo/Telegram/Repository/UsersRepository.java`)
