# team-reboot-academy/organizer architecture

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

- Interactive diagram: https://gitdiagram.com/team-reboot-academy/organizer
- Repository: https://github.com/team-reboot-academy/organizer

## Overview

This is a cross-platform personal task organizer delivered through Telegram and Max bots. Users send commands, button payloads, or text; platform controllers normalize requests, the core router selects a command/button/screen handler, and the response is mapped back to the platform. The domain includes task management, account linking, persistent user/session state, and notifications. The source index supports several service-to-repository and handler-to-service links; unsampled handler details and reminder scheduling are not expanded into unverified flows.

Main entry points: [`src/main/java/ru/reboot/organizer/services/NotificationService.java`](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/NotificationService.java) (Notifications), [`src/main/java/ru/reboot/organizer/services/CoreRouterService.java`](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/CoreRouterService.java) (Core router), [`src/main/java/ru/reboot/organizer/services/SessionManagerService.java`](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/SessionManagerService.java) (Session manager), [`src/main/java/ru/reboot/organizer/database/repository`](https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/database/repository) (Data repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_channels["Bot channels"]
  node_telegram["Telegram bot"]
  node_max["Max bot"]
  node_platform_maps["Platform mappers"]
end

subgraph group_routing["Interaction routing"]
  node_router["Core router"]
  node_handlers["Command, button, screen handlers"]
  node_responses["Unified response"]
end

subgraph group_domain["Organizer services"]
  node_sessions["Session manager"]
  node_tasks["Task management<br/>[TaskService.java]"]
  node_linking["Platform linking"]
  node_notifications["Notifications"]
  node_scheduler["Reminder scheduler"]
end

subgraph group_storage["Persistent state"]
  node_entities[("User, account, task entities")]
  node_repositories[("Data repositories")]
end

node_user(("Bot user"))
node_platform_apis["Telegram and Max APIs"]

node_user -->|"sends updates"| node_telegram
node_user -->|"sends updates"| node_max
node_telegram -->|"maps requests"| node_platform_maps
node_max -->|"maps responses"| node_platform_maps
node_telegram -->|"routes requests"| node_router
node_max -->|"routes requests"| node_router
node_router -->|"reads screen"| node_sessions
node_router -->|"dispatches to"| node_handlers
node_handlers -->|"updates session"| node_sessions
node_handlers -->|"calls linking"| node_linking
node_handlers -->|"builds response"| node_responses
node_router -->|"returns response"| node_responses
node_telegram -->|"maps response"| node_responses
node_max -->|"maps response"| node_responses
node_sessions -->|"reads and saves"| node_repositories
node_tasks -->|"uses drafts"| node_sessions
node_tasks -->|"reads and writes"| node_repositories
node_linking -->|"reads and updates"| node_repositories
node_linking -->|"requests confirmation"| node_notifications
node_notifications -->|"loads user"| node_repositories
node_notifications -->|"sets approval screen"| node_sessions
node_notifications -->|"maps notifications"| node_platform_maps
node_notifications -->|"sends messages"| node_platform_apis
node_repositories -.->|"persists entities"| node_entities
node_scheduler -.->|"sends reminders"| node_notifications

click node_telegram "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/controllers/TelegramBotController.java"
click node_max "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/controllers/MaxBotController.java"
click node_platform_maps "https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/mappers"
click node_router "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/CoreRouterService.java"
click node_handlers "https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/routing/handlers"
click node_responses "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/dto/UnifiedResponse.java"
click node_sessions "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/SessionManagerService.java"
click node_tasks "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/TaskService.java"
click node_linking "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/PlatformLinkService.java"
click node_notifications "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/NotificationService.java"
click node_entities "https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/database/entity"
click node_repositories "https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/database/repository"
click node_scheduler "https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/jobs/ReminderScheduler.java"

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_telegram,node_max,node_platform_maps,node_user toneBlue
class node_router,node_handlers,node_responses toneAmber
class node_sessions,node_tasks,node_linking,node_notifications,node_scheduler,node_platform_apis toneMint
class node_entities,node_repositories toneRose
```

## Components

### Bot channels

- [Telegram bot](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/controllers/TelegramBotController.java): `src/main/java/ru/reboot/organizer/controllers/TelegramBotController.java`
- [Max bot](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/controllers/MaxBotController.java): `src/main/java/ru/reboot/organizer/controllers/MaxBotController.java`
- [Platform mappers](https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/mappers): `src/main/java/ru/reboot/organizer/mappers`

### Interaction routing

- [Core router](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/CoreRouterService.java): `src/main/java/ru/reboot/organizer/services/CoreRouterService.java`
- [Command, button, screen handlers](https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/routing/handlers): `src/main/java/ru/reboot/organizer/routing/handlers`
- [Unified response](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/dto/UnifiedResponse.java): `src/main/java/ru/reboot/organizer/dto/UnifiedResponse.java`

### Organizer services

- [Session manager](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/SessionManagerService.java): `src/main/java/ru/reboot/organizer/services/SessionManagerService.java`
- [Task management](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/TaskService.java): `src/main/java/ru/reboot/organizer/services/TaskService.java`
- [Platform linking](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/PlatformLinkService.java): `src/main/java/ru/reboot/organizer/services/PlatformLinkService.java`
- [Notifications](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/NotificationService.java): `src/main/java/ru/reboot/organizer/services/NotificationService.java`
- [Reminder scheduler](https://github.com/team-reboot-academy/organizer/blob/master/src/main/java/ru/reboot/organizer/services/jobs/ReminderScheduler.java): `src/main/java/ru/reboot/organizer/services/jobs/ReminderScheduler.java`

### Persistent state

- [User, account, task entities](https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/database/entity): `src/main/java/ru/reboot/organizer/database/entity`
- [Data repositories](https://github.com/team-reboot-academy/organizer/tree/master/src/main/java/ru/reboot/organizer/database/repository): `src/main/java/ru/reboot/organizer/database/repository`

### Other components

- **Bot user**
- **Telegram and Max APIs**

## Connections

- Bot user → Telegram bot: sends updates (evidence: `src/main/java/ru/reboot/organizer/controllers/TelegramBotController.java`)
- Bot user → Max bot: sends updates (evidence: `src/main/java/ru/reboot/organizer/controllers/MaxBotController.java`)
- Telegram bot → Platform mappers: maps requests (evidence: `src/main/java/ru/reboot/organizer/controllers/TelegramBotController.java`)
- Max bot → Platform mappers: maps responses (evidence: `src/main/java/ru/reboot/organizer/controllers/MaxBotController.java`)
- Telegram bot → Core router: routes requests (evidence: `src/main/java/ru/reboot/organizer/controllers/TelegramBotController.java`)
- Max bot → Core router: routes requests (evidence: `src/main/java/ru/reboot/organizer/controllers/MaxBotController.java`)
- Core router → Session manager: reads screen (evidence: `src/main/java/ru/reboot/organizer/services/CoreRouterService.java`)
- Core router → Command, button, screen handlers: dispatches to (evidence: `src/main/java/ru/reboot/organizer/services/CoreRouterService.java`)
- Command, button, screen handlers → Session manager: updates session (evidence: `src/main/java/ru/reboot/organizer/routing/handlers/buttons/MainMenuButtonHandler.java`)
- Command, button, screen handlers → Platform linking: calls linking (evidence: `src/main/java/ru/reboot/organizer/routing/handlers/buttons/link/ConfirmLinkButtonHandler.java`)
- Command, button, screen handlers → Unified response: builds response (evidence: `src/main/java/ru/reboot/organizer/routing/handlers/buttons/MainMenuButtonHandler.java`)
- Core router → Unified response: returns response (evidence: `src/main/java/ru/reboot/organizer/services/CoreRouterService.java`)
- Telegram bot → Unified response: maps response (evidence: `src/main/java/ru/reboot/organizer/controllers/TelegramBotController.java`)
- Max bot → Unified response: maps response (evidence: `src/main/java/ru/reboot/organizer/controllers/MaxBotController.java`)
- Session manager → Data repositories: reads and saves (evidence: `src/main/java/ru/reboot/organizer/services/SessionManagerService.java`)
- Task management → Session manager: uses drafts (evidence: `src/main/java/ru/reboot/organizer/services/TaskService.java`)
- Task management → Data repositories: reads and writes (evidence: `src/main/java/ru/reboot/organizer/services/TaskService.java`)
- Platform linking → Data repositories: reads and updates (evidence: `src/main/java/ru/reboot/organizer/services/PlatformLinkService.java`)
- Platform linking → Notifications: requests confirmation (evidence: `src/main/java/ru/reboot/organizer/services/PlatformLinkService.java`)
- Notifications → Data repositories: loads user (evidence: `src/main/java/ru/reboot/organizer/services/NotificationService.java`)
- Notifications → Session manager: sets approval screen (evidence: `src/main/java/ru/reboot/organizer/services/NotificationService.java`)
- Notifications → Platform mappers: maps notifications (evidence: `src/main/java/ru/reboot/organizer/services/NotificationService.java`)
- Notifications → Telegram and Max APIs: sends messages (evidence: `src/main/java/ru/reboot/organizer/services/NotificationService.java`)
- Data repositories → User, account, task entities: persists entities (evidence: `src/main/java/ru/reboot/organizer/database/repository/AuthCodeRepository.java`)
- Reminder scheduler → Notifications: sends reminders
