ЛР2 - Свидерский - На 3 #182

Closed
luxxeboy wants to merge 2 commits from luxxeboy/mtusi2026lab2-fork:solution/bpi2301-sviderskii into master
First-time contributor

Лабораторная 2

Автор / группа: Свидерский К.Ю.
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено: Из лабораторной работы №1 перенесён обязательный функционал мессенджера: регистрация пользователей, получение информации о текущем пользователе, создание и просмотр чатов, отправка и получение сообщений, а также пагинация.

Все данные перенесены в PostgreSQL 16. Для взаимодействия с базой данных используется библиотека asyncpg. Созданы таблицы users, sessions, chats, chat_members, messages.

Реализованы следующие возможности:

Регистрация пользователей через POST /api/v1/users с обязательным паролем длиной 12–128 символов. Пароли сохраняются в виде BCrypt-хешей.

Авторизация через POST /api/v1/auth/sessions с использованием Basic Authentication и выдачей Bearer-токена.

Защита бизнес-эндпоинтов с помощью Authorization: Bearer. Заголовок X-User-Id не используется для авторизации.

Хранение сессий в PostgreSQL с временем действия из SESSION_TTL_SECONDS (по умолчанию 3600 секунд).

Отзыв текущей сессии через DELETE /api/v1/auth/sessions/current.

Сохранение пользователей, чатов, сообщений и активных сессий при перезапуске контейнеров благодаря Docker volume.

Транзакционное создание чатов с проверкой участников.

Миграция api/migrations/001_init_db.sql для автоматического создания таблиц и индексов.

Проверка готовности приложения через /health/live и /health/ready.

Команды запуска из чистого clone:
git clone https://gitea.privcloud.tech/luxxeboy/mtusi2026lab2-fork.git
cd mtusi2026lab2-fork

cp .env.example .env

docker compose --env-file .env up -d --build

Проверка готовности API

curl http://localhost:8080/health/ready

Проверка структуры проекта

make check

Публичные тесты

make test

Проверка сохранности данных после перезапуска

make test-persistence ACTION_SCRIPT=scripts/restart.cmd

Остановка контейнеров с сохранением данных

docker compose down

Полное удаление контейнеров и учебных данных

docker compose down -v

остановка (данные сохраняются):

docker compose down

намеренное удаление учебных данных:

docker compose down -v

Результаты проверок и ссылка на REPORT.md:
Сырые выводы: evidence/tests.txt, evidence/persistence.txt, evidence/check.txt, evidence/rollback.txt. Полный отчёт с архитектурой, таблицей доказательств и ограничениями — REPORT.md.
Ограничения / известные ошибки:
Redis/Valkey не используется, поскольку для целевой оценки 3 достаточно хранения сессий в PostgreSQL.

Отказоустойчивость нескольких экземпляров API и автоматическое переключение между репликами не реализованы.

Нагрузочное тестирование и анализ производительности SQL-запросов не проводились.

Система рассчитана на локальный учебный запуск через Docker Compose.
Источники и использование ИИ:
При выполнении лабораторной работы использовались README курса, contracts/openapi.json, contracts/README.md, документация Python, FastAPI, asyncpg, PostgreSQL, Docker Compose и bcrypt.

ИИ ChatGPT использовался для поиска и исправления ошибок, анализа SQL-миграций, настройки Docker, проверки соответствия API-контракту, исправления формата временных меток, отладки тестов и подготовки отчётной документации.

Результаты работы проверялись локально с помощью Docker Compose и публичных тестов проекта.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Свидерский К.Ю. Целевая оценка (3/4/5): 3 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: Из лабораторной работы №1 перенесён обязательный функционал мессенджера: регистрация пользователей, получение информации о текущем пользователе, создание и просмотр чатов, отправка и получение сообщений, а также пагинация. Все данные перенесены в PostgreSQL 16. Для взаимодействия с базой данных используется библиотека asyncpg. Созданы таблицы users, sessions, chats, chat_members, messages. Реализованы следующие возможности: Регистрация пользователей через POST /api/v1/users с обязательным паролем длиной 12–128 символов. Пароли сохраняются в виде BCrypt-хешей. Авторизация через POST /api/v1/auth/sessions с использованием Basic Authentication и выдачей Bearer-токена. Защита бизнес-эндпоинтов с помощью Authorization: Bearer. Заголовок X-User-Id не используется для авторизации. Хранение сессий в PostgreSQL с временем действия из SESSION_TTL_SECONDS (по умолчанию 3600 секунд). Отзыв текущей сессии через DELETE /api/v1/auth/sessions/current. Сохранение пользователей, чатов, сообщений и активных сессий при перезапуске контейнеров благодаря Docker volume. Транзакционное создание чатов с проверкой участников. Миграция api/migrations/001_init_db.sql для автоматического создания таблиц и индексов. Проверка готовности приложения через /health/live и /health/ready. Команды запуска из чистого clone: git clone https://gitea.privcloud.tech/luxxeboy/mtusi2026lab2-fork.git cd mtusi2026lab2-fork cp .env.example .env docker compose --env-file .env up -d --build # Проверка готовности API curl http://localhost:8080/health/ready # Проверка структуры проекта make check # Публичные тесты make test # Проверка сохранности данных после перезапуска make test-persistence ACTION_SCRIPT=scripts/restart.cmd # Остановка контейнеров с сохранением данных docker compose down # Полное удаление контейнеров и учебных данных docker compose down -v # остановка (данные сохраняются): docker compose down # намеренное удаление учебных данных: docker compose down -v Результаты проверок и ссылка на REPORT.md: Сырые выводы: evidence/tests.txt, evidence/persistence.txt, evidence/check.txt, evidence/rollback.txt. Полный отчёт с архитектурой, таблицей доказательств и ограничениями — REPORT.md. Ограничения / известные ошибки: Redis/Valkey не используется, поскольку для целевой оценки 3 достаточно хранения сессий в PostgreSQL. Отказоустойчивость нескольких экземпляров API и автоматическое переключение между репликами не реализованы. Нагрузочное тестирование и анализ производительности SQL-запросов не проводились. Система рассчитана на локальный учебный запуск через Docker Compose. Источники и использование ИИ: При выполнении лабораторной работы использовались README курса, contracts/openapi.json, contracts/README.md, документация Python, FastAPI, asyncpg, PostgreSQL, Docker Compose и bcrypt. ИИ ChatGPT использовался для поиска и исправления ошибок, анализа SQL-миграций, настройки Docker, проверки соответствия API-контракту, исправления формата временных меток, отладки тестов и подготовки отчётной документации. Результаты работы проверялись локально с помощью Docker Compose и публичных тестов проекта. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
luxxeboy added 1 commit 2026-11-14 05:05:57 +03:00
lab2 complete
Skeleton contracts / contracts (pull_request) Canceled after 0s
684d00c899
luxxeboy added 1 commit 2026-11-14 05:07:23 +03:00
report change
Skeleton contracts / contracts (pull_request) Canceled after 0s
ae11723671
luxxeboy changed title from lab2 complete to ЛР2 - Свидерский - На 3 2026-11-14 05:08:04 +03:00
Owner

Принято. Закрываю.

Принято. Закрываю.
veprickiy closed this pull request 2026-11-14 08:44:19 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#182