# mrkamanov/atmosphere architecture

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

## Overview

Атмосфера — офлайн-приложение для учителей и завучей: учителя ведут классы и отмечают поведение на уроках, затем передают отчёты завучу для сводной аналитики. Завуч импортирует отчёты, анализирует период и классы, а настройки позволяют управлять локальными данными. Граф объединяет документированный пользовательский поток с внутренними слоями каталога и Room. Некоторые связи экранов с данными не видны в выдержках; такие связи не утверждаются.

Main entry points: [`app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt`](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt) (Приложение), [`app/src/main/java/ru/golpom/atmosphere/data/repository/CatalogRepository.kt`](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/repository/CatalogRepository.kt) (Каталог данных), [`app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyHomeScreen.kt`](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyHomeScreen.kt) (Сводка завуча), [`app/src/main/java/ru/golpom/atmosphere/data/export/DeputyReportImporter.kt`](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/export/DeputyReportImporter.kt) (Импорт отчёта)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_teacher["Учитель"]
  node_app["Приложение<br/>[AtmosphereApp.kt]"]
  node_class_setup["Классы и ученики"]
  node_schedule["Расписание"]
  node_lesson["Урок и отметки"]
end

subgraph group_deputy["Завуч"]
  node_deputy_home["Сводка завуча"]
  node_class_insights["Разбор класса"]
  node_student_search["Поиск ученика"]
  node_report_export["Отчёты завуча"]
end

subgraph group_transfer["Обмен отчётами"]
  node_teacher_export["Отчёт учителя"]
  node_file_import["Импорт отчёта"]
  node_import_parsers["Парсеры файлов"]
end

subgraph group_storage["Локальные данные"]
  node_catalog["Каталог данных"]
  node_room[("Локальная база")]
  node_preferences[("Настройки пользователя")]
end

node_teacher(("Учитель"))
node_deputy(("Завуч"))
node_messaging(("Почта или мессенджер"))

node_teacher -->|"открывает"| node_app
node_app -->|"ведёт к"| node_class_setup
node_app -->|"ведёт к"| node_schedule
node_app -->|"открывает"| node_lesson
node_teacher -->|"добавляет данные"| node_class_setup
node_teacher -->|"заполняет"| node_schedule
node_teacher -->|"ставит отметки"| node_lesson
node_lesson -.->|"сохраняет отметки"| node_catalog
node_class_setup -.->|"изменяет каталог"| node_catalog
node_schedule -.->|"читает расписание"| node_catalog
node_teacher -->|"формирует отчёт"| node_teacher_export
node_teacher_export -->|"передаёт файл"| node_messaging
node_messaging -->|"доставляет файл"| node_deputy
node_deputy -->|"импортирует отчёты"| node_file_import
node_file_import -.->|"разбирает файл"| node_import_parsers
node_file_import -.->|"добавляет данные"| node_catalog
node_deputy -->|"смотрит сводку"| node_deputy_home
node_deputy_home -->|"открывает разбор"| node_class_insights
node_deputy_home -->|"ищет ученика"| node_student_search
node_deputy -->|"создаёт отчёты"| node_report_export
node_catalog -->|"читает и пишет"| node_room
node_app -.->|"выбирает роль"| node_preferences

click node_app "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt"
click node_class_setup "https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/ui/classes"
click node_schedule "https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/ui/schedule"
click node_lesson "https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/ui/lesson"
click node_teacher_export "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/export/TeacherBehaviorExporter.kt"
click node_file_import "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/export/DeputyReportImporter.kt"
click node_deputy_home "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyHomeScreen.kt"
click node_class_insights "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyClassDetailScreen.kt"
click node_student_search "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/deputy/StudentSearchAnalytics.kt"
click node_report_export "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/export/deputy/DeputyAnalyticsReportExporter.kt"
click node_catalog "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/repository/CatalogRepository.kt"
click node_room "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/local/AtmosphereDatabase.kt"
click node_preferences "https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/preferences/UserPreferencesRepository.kt"
click node_import_parsers "https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/data/csv"

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_app,node_class_setup,node_schedule,node_lesson toneBlue
class node_deputy_home,node_class_insights,node_student_search,node_report_export toneAmber
class node_teacher_export,node_file_import,node_import_parsers toneMint
class node_catalog,node_room,node_preferences toneRose
class node_teacher,node_deputy,node_messaging toneIndigo
```

## Components

### Учитель

- [Приложение](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt): `app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt`
- [Классы и ученики](https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/ui/classes): `app/src/main/java/ru/golpom/atmosphere/ui/classes`
- [Расписание](https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/ui/schedule): `app/src/main/java/ru/golpom/atmosphere/ui/schedule`
- [Урок и отметки](https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/ui/lesson): `app/src/main/java/ru/golpom/atmosphere/ui/lesson`

### Завуч

- [Сводка завуча](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyHomeScreen.kt): `app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyHomeScreen.kt`
- [Разбор класса](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyClassDetailScreen.kt): `app/src/main/java/ru/golpom/atmosphere/ui/deputy/DeputyClassDetailScreen.kt`
- [Поиск ученика](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/ui/deputy/StudentSearchAnalytics.kt): `app/src/main/java/ru/golpom/atmosphere/ui/deputy/StudentSearchAnalytics.kt`
- [Отчёты завуча](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/export/deputy/DeputyAnalyticsReportExporter.kt): `app/src/main/java/ru/golpom/atmosphere/data/export/deputy/DeputyAnalyticsReportExporter.kt`

### Обмен отчётами

- [Отчёт учителя](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/export/TeacherBehaviorExporter.kt): `app/src/main/java/ru/golpom/atmosphere/data/export/TeacherBehaviorExporter.kt`
- [Импорт отчёта](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/export/DeputyReportImporter.kt): `app/src/main/java/ru/golpom/atmosphere/data/export/DeputyReportImporter.kt`
- [Парсеры файлов](https://github.com/mrkamanov/atmosphere/tree/main/app/src/main/java/ru/golpom/atmosphere/data/csv): `app/src/main/java/ru/golpom/atmosphere/data/csv`

### Локальные данные

- [Каталог данных](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/repository/CatalogRepository.kt): `app/src/main/java/ru/golpom/atmosphere/data/repository/CatalogRepository.kt`
- [Локальная база](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/local/AtmosphereDatabase.kt): `app/src/main/java/ru/golpom/atmosphere/data/local/AtmosphereDatabase.kt`
- [Настройки пользователя](https://github.com/mrkamanov/atmosphere/blob/main/app/src/main/java/ru/golpom/atmosphere/data/preferences/UserPreferencesRepository.kt): `app/src/main/java/ru/golpom/atmosphere/data/preferences/UserPreferencesRepository.kt`

### Other components

- **Учитель**
- **Завуч**
- **Почта или мессенджер**

## Connections

- Учитель → Приложение: открывает
- Приложение → Классы и ученики: ведёт к (evidence: `app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt`)
- Приложение → Расписание: ведёт к (evidence: `app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt`)
- Приложение → Урок и отметки: открывает (evidence: `app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt`)
- Учитель → Классы и ученики: добавляет данные
- Учитель → Расписание: заполняет
- Учитель → Урок и отметки: ставит отметки
- Урок и отметки → Каталог данных: сохраняет отметки
- Классы и ученики → Каталог данных: изменяет каталог
- Расписание → Каталог данных: читает расписание
- Учитель → Отчёт учителя: формирует отчёт
- Отчёт учителя → Почта или мессенджер: передаёт файл
- Почта или мессенджер → Завуч: доставляет файл
- Завуч → Импорт отчёта: импортирует отчёты
- Импорт отчёта → Парсеры файлов: разбирает файл
- Импорт отчёта → Каталог данных: добавляет данные
- Завуч → Сводка завуча: смотрит сводку
- Сводка завуча → Разбор класса: открывает разбор (evidence: `app/src/main/java/ru/golpom/atmosphere/ui/AtmosphereApp.kt`)
- Сводка завуча → Поиск ученика: ищет ученика
- Завуч → Отчёты завуча: создаёт отчёты
- Каталог данных → Локальная база: читает и пишет (evidence: `app/src/main/java/ru/golpom/atmosphere/data/repository/CatalogRepository.kt`)
- Приложение → Настройки пользователя: выбирает роль
