# petrov-kirill-241-321/web2026-4sem architecture

> Architecture diagram of the GitHub repository petrov-kirill-241-321/web2026-4sem, 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/petrov-kirill-241-321/web2026-4sem
- Repository: https://github.com/petrov-kirill-241-321/web2026-4sem

## Overview

Это Django-приложение для каталога спортивных площадок и занятий: посетитель просматривает и ищет площадки, затем изучает страницу площадки; предусмотрены модели занятий, временных слотов, бронирований и отзывов. Организаторы управляют площадками и занятиями через формы, а администраторы — через Django Admin. Граф отражает подтверждённые URL-маршруты, вызовы и настройки; часть возможностей видна только по моделям и именам модулей, поэтому неподтверждённые связи не проведены.

Main entry points: [`places/views.py`](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/views.py) (Обработчики сайта), [`places/models.py`](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py) (Площадки и удобства), [`places/admin.py`](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/admin.py) (Django Admin), [`places/management/commands/seed_demo.py`](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/management/commands/seed_demo.py) (Демо-данные)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Каталог и управление"]
  node_routes["Маршруты<br/>[urls.py]"]
  node_views["Обработчики сайта<br/>[views.py]"]
  node_forms["Формы управления<br/>[forms.py]"]
  node_templates["Страницы сайта"]
  node_searchjs["Поиск площадок"]
end

subgraph group_domain["Предметная область"]
  node_users_roles["Пользователи и роли<br/>[models.py]"]
  node_organizers["Организаторы<br/>[models.py]"]
  node_venues["Площадки и удобства<br/>[models.py]"]
  node_activities["Занятия и категории<br/>[models.py]"]
  node_slots["Временные слоты<br/>[models.py]"]
  node_bookings["Бронирования<br/>[models.py]"]
  node_reviews["Отзывы<br/>[models.py]"]
end

subgraph group_operations["Администрирование"]
  node_admin["Django Admin<br/>[admin.py]"]
  node_seed["Демо-данные<br/>[seed_demo.py]"]
  node_lab09["DB-демонстрация<br/>[lab09_demo.py]"]
end

subgraph group_platform["Приложение и данные"]
  node_settings["Настройки Django<br/>[settings.py]"]
  node_database[("PostgreSQL")]
end

node_visitor(("Посетитель"))
node_organizer(("Организатор"))

node_visitor -->|"запрашивает страницы"| node_routes
node_organizer -->|"открывает управление"| node_routes
node_routes -->|"маршрутизирует"| node_views
node_views -->|"обрабатывает формы"| node_forms
node_views -->|"ищет площадки"| node_venues
node_views -->|"выбирает слоты"| node_slots
node_views -->|"рендерит страницы"| node_templates
node_forms -->|"сохраняет площадки"| node_venues
node_forms -->|"сохраняет занятия"| node_activities
node_views -.->|"использует поиск"| node_searchjs
node_admin -->|"управляет данными"| node_venues
node_admin -->|"управляет данными"| node_activities
node_admin -->|"администрирует"| node_bookings
node_seed -->|"создаёт пользователей"| node_users_roles
node_seed -->|"создаёт организаторов"| node_organizers
node_seed -->|"наполняет каталог"| node_venues
node_lab09 -->|"выполняет SQL"| node_database
node_settings -->|"настраивает подключение"| node_database
node_settings -->|"задаёт модель пользователя"| node_users_roles

click node_routes "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/urls.py"
click node_views "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/views.py"
click node_forms "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/forms.py"
click node_templates "https://github.com/petrov-kirill-241-321/web2026-4sem/tree/main/places/templates"
click node_searchjs "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/static/places/js/venue_search_react.js"
click node_users_roles "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py"
click node_organizers "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py"
click node_venues "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py"
click node_activities "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py"
click node_slots "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py"
click node_bookings "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py"
click node_reviews "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py"
click node_admin "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/admin.py"
click node_seed "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/management/commands/seed_demo.py"
click node_lab09 "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/management/commands/lab09_demo.py"
click node_settings "https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/config/settings.py"

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_routes,node_views,node_forms,node_templates,node_searchjs toneBlue
class node_users_roles,node_organizers,node_venues,node_activities,node_slots,node_bookings,node_reviews toneAmber
class node_admin,node_seed,node_lab09 toneMint
class node_settings,node_database toneRose
class node_visitor,node_organizer toneIndigo
```

## Components

### Каталог и управление

- [Маршруты](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/urls.py): `places/urls.py`
- [Обработчики сайта](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/views.py): `places/views.py`
- [Формы управления](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/forms.py): `places/forms.py`
- [Страницы сайта](https://github.com/petrov-kirill-241-321/web2026-4sem/tree/main/places/templates): `places/templates`
- [Поиск площадок](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/static/places/js/venue_search_react.js): `places/static/places/js/venue_search_react.js`

### Предметная область

- [Пользователи и роли](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py): `places/models.py`
- [Организаторы](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py): `places/models.py`
- [Площадки и удобства](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py): `places/models.py`
- [Занятия и категории](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py): `places/models.py`
- [Временные слоты](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py): `places/models.py`
- [Бронирования](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py): `places/models.py`
- [Отзывы](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/models.py): `places/models.py`

### Администрирование

- [Django Admin](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/admin.py): `places/admin.py`
- [Демо-данные](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/management/commands/seed_demo.py): `places/management/commands/seed_demo.py`
- [DB-демонстрация](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/places/management/commands/lab09_demo.py): `places/management/commands/lab09_demo.py`

### Приложение и данные

- [Настройки Django](https://github.com/petrov-kirill-241-321/web2026-4sem/blob/main/config/settings.py): `config/settings.py`
- **PostgreSQL**

### Other components

- **Посетитель**
- **Организатор**

## Connections

- Посетитель → Маршруты: запрашивает страницы (evidence: `places/urls.py`)
- Организатор → Маршруты: открывает управление (evidence: `places/urls.py`)
- Маршруты → Обработчики сайта: маршрутизирует (evidence: `places/urls.py`)
- Обработчики сайта → Формы управления: обрабатывает формы (evidence: `places/views.py`)
- Обработчики сайта → Площадки и удобства: ищет площадки (evidence: `places/views.py`)
- Обработчики сайта → Временные слоты: выбирает слоты (evidence: `places/views.py`)
- Обработчики сайта → Страницы сайта: рендерит страницы (evidence: `places/views.py`)
- Формы управления → Площадки и удобства: сохраняет площадки (evidence: `places/forms.py`)
- Формы управления → Занятия и категории: сохраняет занятия (evidence: `places/forms.py`)
- Обработчики сайта → Поиск площадок: использует поиск
- Django Admin → Площадки и удобства: управляет данными (evidence: `places/admin.py`)
- Django Admin → Занятия и категории: управляет данными (evidence: `places/admin.py`)
- Django Admin → Бронирования: администрирует (evidence: `places/admin.py`)
- Демо-данные → Пользователи и роли: создаёт пользователей (evidence: `places/management/commands/seed_demo.py`)
- Демо-данные → Организаторы: создаёт организаторов (evidence: `places/management/commands/seed_demo.py`)
- Демо-данные → Площадки и удобства: наполняет каталог (evidence: `places/management/commands/seed_demo.py`)
- DB-демонстрация → PostgreSQL: выполняет SQL (evidence: `places/management/commands/lab09_demo.py`)
- Настройки Django → PostgreSQL: настраивает подключение (evidence: `config/settings.py`)
- Настройки Django → Пользователи и роли: задаёт модель пользователя (evidence: `config/settings.py`)
