111 changed files with 6686 additions and 38 deletions
+2
View File
@@ -16,5 +16,7 @@ backups
.venv
__pycache__
node_modules
**/bin
**/obj
evidence
.DS_Store
+5 -10
View File
@@ -1,11 +1,6 @@
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
# These are logical interface suggestions; map actual framework names in REPORT.md.
APP_HOST=0.0.0.0
APP_PORT=8080
APP_ENV=lab
# Copy to .env for the local Compose stack; never commit .env.
# Use unquoted NAME=value lines: Makefile also reads this file.
API_PORT=8080
SESSION_TTL_SECONDS=3600
# Choose credentials locally. File paths contain no secret values.
DATABASE_URL_FILE=/run/secrets/database_url
# Optional on 3, required use on 4 in lab2; Redis OR Valkey:
SESSION_STORE=postgres
CACHE_URL_FILE=/run/secrets/cache_url
# make up generates credentials in ignored secrets/.
# Compose sets APP_HOST, APP_PORT, DATABASE_URL_FILE and REDIS_URL inside the API container.
+37
View File
@@ -0,0 +1,37 @@
FROM mcr.microsoft.com/dotnet/sdk:9.0.306 AS build
WORKDIR /src
COPY src/Messenger.Api/Messenger.Api.csproj src/Messenger.Api/
RUN dotnet restore src/Messenger.Api/Messenger.Api.csproj
COPY src/Messenger.Api/ src/Messenger.Api/
RUN dotnet publish src/Messenger.Api/Messenger.Api.csproj \
-c Release \
--no-restore \
-o /app/publish
FROM mcr.microsoft.com/dotnet/aspnet:9.0.10 AS runtime
RUN apt-get update \
&& apt-get install -y --no-install-recommends curl \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /app/publish .
ENV APP_HOST=0.0.0.0
ENV APP_PORT=8080
ENV APP_ENV=lab
EXPOSE 8080
USER app
HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \
CMD curl --fail --silent http://127.0.0.1:8080/health/ready > /dev/null || exit 1
ENTRYPOINT ["dotnet", "Messenger.Api.dll"]
+61 -5
View File
@@ -1,13 +1,41 @@
PYTHON ?= python3
BASE_URL ?= http://localhost:8080
-include .env
API_PORT ?= 8080
PYTHON ?= $(if $(wildcard .venv/bin/python),.venv/bin/python,python3)
BASE_URL ?= http://localhost:$(API_PORT)
CA_FILE ?=
ACTION_SCRIPT ?=
ACTION_SCRIPT ?= scripts/restart.sh
TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",)
.PHONY: help check validate test load test-persistence
.PHONY: help build run up down restart check validate test student-test test-ui test-expiry test-grade4 test-dependencies explain-history verify-grade4 research-grade5 verify-grade5 load test-persistence
help:
@echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes"
@echo "build: compile C# API; run: start API with DATABASE_URL or DATABASE_URL_FILE"
@echo "up: start API/PostgreSQL/Redis; down: stop without deleting data; restart: restart all three"
@echo "check: offline skeleton structure; validate: full OpenAPI (requirements-dev.txt)"
@echo "test: public Lab2 smoke; student-test: additional Lab2 checks"
@echo "test-ui: optional web API authentication, privacy and backwards pagination"
@echo "test-expiry: short session TTL; test-persistence: restart check"
@echo "test-grade4: registration race, transaction rollback and Redis cache; test-dependencies: local outage checks"
@echo "explain-history: seed 10000 synthetic messages and capture EXPLAIN ANALYZE BUFFERS"
@echo "verify-grade4: run all checks on the running stack, save evidence/grade4-checks.txt"
@echo "research-grade5: 100000 messages, index comparison and independent backup/restore; verify-grade5: grades 3/4 + research"
build:
dotnet build src/Messenger.Api/Messenger.Api.csproj --nologo
run:
dotnet run --no-launch-profile --project src/Messenger.Api/Messenger.Api.csproj
up:
./scripts/init-secrets.sh
docker compose up -d --build --wait --wait-timeout 90
down:
docker compose down
restart:
./scripts/restart.sh
check:
$(PYTHON) scripts/check_contract.py
@@ -18,6 +46,34 @@ validate:
test:
$(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS)
student-test:
$(PYTHON) student-tests/lab2_tests.py --base-url "$(BASE_URL)"
test-ui:
$(PYTHON) student-tests/ui_api_tests.py --base-url "$(BASE_URL)"
test-grade4:
$(PYTHON) student-tests/grade4_tests.py --base-url "$(BASE_URL)"
test-dependencies:
$(PYTHON) student-tests/dependency_tests.py --base-url "$(BASE_URL)"
explain-history:
$(PYTHON) student-tests/explain_history.py --base-url "$(BASE_URL)"
verify-grade4:
BASE_URL="$(BASE_URL)" PYTHON="$(PYTHON)" ./scripts/verify-grade4.sh
@echo "PASS: grade 4 checks; results in evidence/grade4-checks.txt"
research-grade5:
$(PYTHON) -u student-tests/research_track2.py --base-url "$(BASE_URL)"
verify-grade5:
BASE_URL="$(BASE_URL)" PYTHON="$(PYTHON)" ./scripts/verify-grade5.sh
test-expiry:
BASE_URL="$(BASE_URL)" PYTHON="$(PYTHON)" ./scripts/test-expiry.sh
load:
$(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS)
+204 -23
View File
@@ -1,37 +1,218 @@
# Отчёт — лабораторная 2
# Отчёт - лабораторная 2
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
- Автор, группа: Каменский, БВТ2302.
- Целевая оценка: **5**, трек 2 - план запроса и восстановление.
- Исходники основаны на собственной реализации Lab1. Перенесены API, Dockerfile и подход к валидации, логированию и курсорам. Контракт и публичные проверки сохранены из skeleton Lab2.
- Помощь: ChatGPT для разбора задания; ИИ для кода, тестов и текста.
## Запуск из чистого clone
## Запуск из чистой копии на macOS
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
Нужны запущенный Docker Desktop с Compose, `make`, Python 3.9+, `openssl` и `curl`. Для сборки через `make build` нужен .NET SDK 9; сборка контейнера использует SDK внутри образа.
Закреплённые версии: .NET SDK `9.0.306`, ASP.NET runtime `9.0.10`, PostgreSQL `17.6`, Redis `7.4.2-alpine`, Npgsql `9.0.5`, Isopoh.Cryptography.Argon2 `2.0.0`, StackExchange.Redis `2.8.58`.
Из корня репозитория:
```sh
cp .env.example .env
# Если порт 8080 занят, поменять API_PORT в .env, например на 18080.
make up
docker compose ps
make check
make test
make student-test
make test-grade4
make explain-history
make test-dependencies
make test-expiry
make test-persistence
```
`make up` создаёт случайный пароль и строку подключения в игнорируемой папке `secrets/`, собирает API и ожидает здоровья контейнеров. Существующие секреты повторно не генерируются. PostgreSQL получает пароль через `POSTGRES_PASSWORD_FILE`; API читает строку подключения через `DATABASE_URL_FILE`. Не заменять эти файлы отдельно от уже созданной БД.
Миграция `Data/Migrations/001_initial.sql` встроена в сборку API и выполняется перед приёмом запросов. Таблица `schema_migrations` фиксирует её версию; транзакция и advisory lock обеспечивают безопасный повторный запуск. Ручного seed нет.
Makefile читает `.env`, поэтому `make test`, `make student-test`, `make load` и другие HTTP-проверки используют `API_PORT`. `BASE_URL` можно переопределить явно: `make test BASE_URL=http://localhost:18080`. `make test-persistence` по умолчанию использует `scripts/restart.sh`.
Полная проверка OpenAPI требует отдельной зависимости:
```sh
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
make validate
```
Если `.venv` существует, Makefile использует его Python; `PYTHON` можно переопределить. Без `.venv` smoke и собственные HTTP-тесты работают со стандартной библиотекой Python.
После установки зависимостей для OpenAPI все проверки можно запустить одной командой: `make verify-grade4`. Она сохраняет результат в `evidence/grade4-checks.txt`. Перед ней нужен `make up`. Тесты отказов временно приостанавливают Redis и останавливают PostgreSQL, восстанавливают их в `finally`; запускать на локальном учебном стенде. При принудительном убийстве тестового процесса восстановить сервисы командами `docker compose unpause redis` (если paused) и `docker compose start postgres`.
Безопасная остановка с сохранением данных:
```sh
make down
# Повторный make up использует тот же volume и те же секреты.
```
Намеренное удаление всех учебных данных, только для осознанного сброса стенда: `docker compose down -v`. Эта команда отсутствует в restart hook и тестах.
## Архитектура и решения
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
```text
Клиент → Middleware → Endpoints → Services → AppDatabase/Npgsql → PostgreSQL
↘ RedisSessionCache → Redis
```
## Доказательства критериев
- `Program.cs`: настройка JSON, регистрация зависимостей, применение миграции и подключение маршрутов.
- `Endpoints/`: HTTP-маршруты, проверка формы запросов, аутентификация и HTTP-ответы.
- `Contracts/`: входящие DTO и ответы API. Пароль и его hash не входят в `UserDto`.
- `Services/`: регистрация, Argon2id, создание/отзыв сессий и операции с чатами и сообщениями.
- `Data/`: параметризованные SQL-команды, транзакции и миграции. `Entities/` содержит записи, прочитанные из БД.
- `Middleware/`: `X-Request-Id`, логирование метода/пути/статуса и ошибки без внутренних деталей в HTTP-ответе.
- `Infrastructure/`: необязательный для доступности `RedisSessionCache`, JSON с `UserDto` и expires_at, TTL и обработка ошибок Redis.
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | make test | TODO | TODO |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
| Данные | Таблица и ограничения |
| --- | --- |
| Пользователи | `users`: UUID PK, уникальный username, Argon2id hash |
| Чаты | `chats`: UUID PK, title, created_at |
| Участники | `chat_members`: составной PK `(chat_id, user_id)`, FK на чаты и пользователей |
| Сообщения | `messages`: UUID PK, FK на чат и отправителя |
| Сессии | `sessions`: PK по SHA-256 случайного токена, FK на пользователя, expires_at и revoked_at |
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
PostgreSQL - источник истины для всех обязательных данных и сессий. Создание чата, проверка существования участников и запись членства выполняются в одной транзакции. Уникальный индекс username разрешает конфликт регистрации на уровне БД.
## Эксперименты и отказы
История сообщений и список чатов читаются по keyset `(created_at, id)` с выборкой `limit + 1`; cursor проверяется на соответствие чату или пользователю. Индекс сообщений - `(chat_id, created_at, id)`. Часы API назначают время UTC с точностью до микросекунд PostgreSQL. При конкурентных вставках между страницами snapshot не гарантируется: запись с ключом до уже пройденного cursor может не попасть в текущий обход. Для неизменной истории повторы исключены.
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
Регистрация принимает пароль 12-128 Unicode code points. Argon2id использует случайную соль 16 байт, 32 MiB памяти, 3 прохода, 1 lane, hash 32 байта; параметры и соль входят в кодированную строку hash. UTF-8 пароль, включая двоеточие, не обрезается.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| TODO | TODO | TODO | TODO |
`POST /api/v1/auth/sessions` принимает Basic без JSON body. Сессия получает 32 случайных байта энтропии, кодированных в Base64URL. В БД хранится только SHA-256 токена. Это hash случайного токена, а пароль защищён отдельно Argon2id. Действительность проверяется в PostgreSQL по `expires_at > now()` и отсутствию `revoked_at`. Logout отзывает текущую сессию. Рестарт не меняет expires_at.
## Ограничения и следующие шаги
Бизнес-маршруты используют только Bearer. `X-User-Id` игнорируется. Неверный Basic получает challenge Basic; недействительный Bearer - challenge Bearer. Чужой чат возвращает 404.
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
Npgsql использует общий пул с максимумом 20 соединений, временем подключения 5 секунд и таймаутом команды 10 секунд. `/health/live` проверяет процесс, `/health/ready` выполняет запрос к PostgreSQL. БД - критичная зависимость; ошибки доступа к БД возвращаются как 503.
| Компонент | Сервис Compose | Хранение / публикация |
| --- | --- | --- |
| API | `api`, образ собирается из Dockerfile | Состояние в PostgreSQL; порт опубликован только на `127.0.0.1` |
| PostgreSQL | `postgres`, образ `postgres:17.6` | Именованный volume `postgres_data`; порт БД наружу не опубликован |
| Redis | `redis`, образ `redis:7.4.2-alpine` | Восстанавливаемый кэш в RAM, без публикации порта и без persistence |
В `.env` используются `API_PORT` и `SESSION_TTL_SECONDS` (по умолчанию 8080 и 3600). Compose задаёт внутри API `APP_HOST=0.0.0.0`, `APP_PORT=8080`, `DATABASE_URL_FILE=/run/secrets/database_url`, `REDIS_URL=redis:6379`. Для запуска API отдельно через `make run` нужна строка подключения в `DATABASE_URL` или файл в `DATABASE_URL_FILE`; `REDIS_URL` - адрес в формате StackExchange.Redis, по умолчанию `localhost:6379`.
## Redis, expiry и инвалидация
PostgreSQL хранит действительность сессии; Redis кэширует её публичные данные пользователя и expires_at по ключу `messenger:session:<SHA-256-token>`. Пароль, password hash и исходный Bearer-токен в Redis не записываются. Пользователь в обязательном API неизменяемый.
При входе сначала COMMIT сессии в PostgreSQL, затем попытка записи кэша. При каждом Bearer-запросе выполняется небольшой SELECT активной сессии по PK с условием `revoked_at IS NULL AND expires_at > now()`. После этого cache hit экономит SELECT из users (в том числе чтение password_hash). При miss API читает пользователя из БД и заполняет кэш. Это не устраняет обращения к PostgreSQL: выбранная схема сохраняет немедленную проверку отзыва без распределённого протокола инвалидации. Тест подтверждает реальные Redis hits и повторное заполнение после удаления одного синтетического ключа.
TTL кэша равен оставшемуся времени до исходного expires_at; чтение кэша TTL не продлевает. Redis ограничен 64 MiB с `allkeys-lru`; eviction равен cache miss. Logout сначала отзывает сессию в PostgreSQL, затем удаляет ключ Redis. Если удаление не удалось или конкурентное заполнение позднее вернуло старый ключ, будущий запрос всё равно не проходит проверку PostgreSQL. Запрос, уже прошедший аутентификацию до logout, может завершиться; общей транзакции на весь HTTP-запрос нет.
Redis не является единственным хранилищем сессий, поэтому AOF/RDB и отдельный volume ему не нужны. Его рестарт очищает кэш; ещё действительная сессия восстанавливается из PostgreSQL с прежним expires_at. История сообщений не кэшируется и читается из источника истины после COMMIT.
Используется один общий ConnectionMultiplexer: ConnectTimeout/AsyncTimeout/SyncTimeout - 500 ms, ConnectRetry=0, AbortOnConnectFail=false, BacklogPolicy.FailFast. Каждая операция кэша дополнительно ограничена ожиданием 750 ms. RedisException, timeout и отмена операции приводят к fallback в PostgreSQL; ошибки кэша не раскрывают credentials. Для одного запроса может понадобиться больше одной операции кэша, поэтому суммарный бюджет выше 750 ms. Отмена ожидания не гарантирует отмену команды, уже отправленной Redis; проверка отзыва в PostgreSQL защищает от позднего выполнения.
При недоступности Redis API и readiness остаются доступны через PostgreSQL. При недоступности PostgreSQL readiness и защищённые запросы возвращают 503 `unavailable`, даже при прогретом кэше. Запрос без Bearer по-прежнему получает 401. Redis нужен для оптимизации, PostgreSQL - для безопасной работы API.
## Доказательства уровней 3 и 4
Текущая полная проверка: [evidence/grade4-checks.txt](evidence/grade4-checks.txt). Предыдущие проверки уровня 3: [evidence/grade3-checks.txt](evidence/grade3-checks.txt) и [evidence/final-checks.txt](evidence/final-checks.txt).
| Критерий | Проверка | Наблюдение |
| --- | --- | --- |
| Сборка и skeleton | `make build`, `make check`, `make validate` | Сборка без ошибок/предупреждений; структура и OpenAPI проходят |
| API и переход с Lab1 | `make test` | Публичный сквозной сценарий Lab2 проходит |
| Пароль и правильная идентификация | `make student-test`, публичный smoke | Ошибочный пароль и X-User-Id дают 401; Bearer определяет владельца |
| Expiry и logout | `make test-expiry`, `make student-test` | Сессия с TTL=2 становится недействительной; отозванная сессия даёт 401 |
| Сохранность данных и сессии | `make test-persistence` | После рестарта PostgreSQL, Redis и API прежний токен читает подтверждённое сообщение |
| Реальный перезапуск хранилищ и API | StartedAt контейнеров до/после hook в evidence | Время старта изменилось у PostgreSQL, Redis и API |
| Повтор миграции | Запрос к `schema_migrations` после рестарта | Одна запись версии 1; данные не дублируются миграцией |
| Постоянное хранилище и ограничения | SQL-миграция и Compose | PK/FK/unique, транзакция создания чата, именованный volume |
| Секреты вне Git | `git check-ignore .env secrets/postgres_password secrets/database_url` | Все локальные секреты и .env игнорируются |
| Гонка регистрации | `make test-grade4`, 4 одновременных HTTP-запроса | Один 201, три 409; ровно одна строка users |
| Rollback составной операции | `make test-grade4`, временный trigger на вставку Bob в chat_members | Ошибка после INSERT чата откатывает чат и участников; после удаления trigger обычный запрос успешен |
| Реальная роль Redis | `make test-grade4` | PTTL > 0, hits растут, чтение не продлевает TTL; miss заполняет кэш, logout удаляет ключ |
| Индекс истории | `make explain-history` | ≥10 000 сообщений, Index Scan на первой и глубокой странице, без Seq Scan и повторов между страницами |
| Отказ Redis | `make test-dependencies`, pause/unpause Redis | Ответ через БД <3 s; запись работает, logout действует; намеренно восстановленный stale ключ не авторизует |
| Отказ PostgreSQL | `make test-dependencies`, stop/start PostgreSQL | 503, не подтверждает запись и не доверяет прогретому Redis; после восстановления данные и токен работают |
| Expiry в обоих хранилищах | `make test-expiry`, SESSION_TTL_SECONDS=2 | После 3 s API даёт 401, ключ Redis отсутствует |
## Индекс истории и EXPLAIN
`student-tests/explain_history.py` создаёт через API отдельного синтетического пользователя и чат, добавляет SQL-командой 10 000 сообщений, выполняет ANALYZE и сохраняет реальные `EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)` в [evidence/history-explain.json](evidence/history-explain.json). Каждое повторение создаёт отдельный набор; существующие сообщения не удаляет. SQL-загрузка здесь - подготовка большого набора для анализа; HTTP-запись отдельно проверяется smoke и тестом отказа.
Запрос соответствует `AppDatabase.ListMessagesAsync`:
```sql
SELECT id, chat_id, sender_id, text, created_at
FROM messages
WHERE chat_id = @chat_id
AND (created_at, id) > (@cursor_time, @cursor_id)
ORDER BY created_at, id
LIMIT @count;
```
Индекс `(chat_id, created_at, id)` сначала ограничивает чат, затем сразу позволяет перейти к cursor и читать в нужном порядке. На первой странице условие cursor отсутствует. `@count=51` - 50 записей ответа и одна для определения next_cursor. В API нет OFFSET; тест использует его один раз только для выбора якоря после 9000-й записи.
В записанном плане обе страницы используют `Index Scan` по `messages_chat_created_id_idx`, возвращают 51 строку и не выполняют Seq Scan. Конкретные времена и число buffer hits находятся в JSON. Тест также читает первую, глубокую и следующую страницы через API и проверяет отсутствие повторов. Это проверка выбранного индекса на небольшом локальном наборе с прогретыми buffers, а не оценка предельной производительности или сравнение индексов для уровня 5.
## Проверки перезапуска и ограничения
`scripts/restart.sh` перезапускает PostgreSQL и Redis, ожидает `pg_isready`, затем перезапускает API. Volume PostgreSQL сохраняется; очистки, flush или seed нет. Redis теряет только восстанавливаемый кэш. Публичный persistence-тест держит старый токен в памяти и проверяет данные после hook. В evidence записаны изменения StartedAt всех трёх контейнеров.
Проверены локальный штатный рестарт контейнеров, остановка PostgreSQL, приостановка Redis и восстановление backup в независимую БД (см. трек 2 ниже). Проверки повреждения диска, аварийной потери хоста и исследование предельной производительности не выполнялись. Удаление volume приводит к потере данных. Один экземпляр API и PostgreSQL не обеспечивают высокую доступность.
Реализован исследовательский трек 2 уровня 5. Кэш экономит чтение данных пользователя; снижение latency или нагрузки самого кэша под нагрузкой не измерялось. Истёкшие/отозванные сессии остаются в таблице; для длительной эксплуатации нужна очистка. HTTP используется на локальном изолированном стенде с синтетическими данными.
## Уровень 5 - трек 2
Гипотеза, методика, реальные планы, цена записи, восстановление и ограничения подробно описаны в [docs/RESEARCH.md](docs/RESEARCH.md). Результаты: [evidence/research-track2.json](evidence/research-track2.json), полный запуск уровней 3/4/5: [evidence/grade5-checks.txt](evidence/grade5-checks.txt). Короткая подготовка к защите: [docs/DEFENSE.md](docs/DEFENSE.md).
```sh
make up
make verify-grade5
# Повторить только исследование:
make research-grade5
```
Один запуск создаёт 100 000 сообщений в четырёх чатах: 80 000 / 15 000 / 4 000 / 1 000. Два индекса сравниваются на отдельных таблицах с одинаковыми PK/FK. Замеры: один прогрев и три вставки, один прогрев и пять чтений; порядок вставок чередуется. EXPLAIN ANALYZE BUFFERS сохраняется целиком. Рабочие индексы API остаются прежними.
Backup public-схемы приложения сохраняется в игнорируемой папке backups/ с правами 0600 и восстанавливается в postgres-restore (Compose profile research), отдельный volume restore_data и новую пустую БД. Проверяются количества всех шести таблиц, 12 сообщений и checksum всех 100 000 сообщений нового набора. Подтверждённая запись после dump отсутствует в восстановленной БД, показывая границу snapshot и возможной потери данных.
Во время исследования исключить параллельные записи API. При повторении создаётся новый набор и новая восстановленная БД; существующие сообщения сохраняются. Restore-контейнер можно остановить после защиты: `docker compose --profile research stop postgres-restore`. Данные и backup сохраняются.
## Веб-интерфейс
Клиент «n1k0der» находится в `src/Messenger.Api/wwwroot/`: `index.html`, `app.css`, `app.js`. ASP.NET Core отдаёт его на `/` из того же контейнера, что и API. Отдельный сервер, npm и CDN не нужны. На текущем стенде адрес - http://localhost:18080/; порт задаётся `API_PORT` в `.env`.
Оформление: антрацитовый фон `#262626`, основной текст и акценты `#FFE135`, отдельные оттенки графита для панелей и приглушённые подписи. Исходящие сообщения и основные кнопки имеют жёлтый фон с тёмным текстом. Формы, модальные окна и режим защиты используют общую палитру; на телефоне список чатов и переписка показываются отдельно. Проверка дизайна - `evidence/ui-anthracite-checks.txt`, снимки - `evidence/ui-anthracite-*.jpg`.
Доступны регистрация, вход, профиль с копированием ID, создание чата, поиск среди загруженных чатов, участники, отправка и просмотр сообщений, загрузка старой истории и выход. Чтобы начать переписку, второй пользователь копирует свой ID из профиля; создатель чата вставляет его в поле участников. Пустое поле создаёт чат только с самим собой. Для демонстрации двух пользователей подходят разные браузеры или отдельное приватное окно.
Архитектура: `wwwroot → Endpoints → Services → AppDatabase → PostgreSQL`; `SessionService` дополнительно использует `RedisSessionCache`. `Program.cs` настраивает зависимости и подключает middleware/маршруты. DTO находятся в `Contracts`, записи БД - в `Data/Entities`, миграции - в `Data/Migrations`. Клиент выполняет HTTP-запросы; в нём нет доступа к базе или секретам сервера.
Дополнительные маршруты клиента: `GET /api/ui/chats/{chat_id}/messages` читает последние сообщения и листает назад, `GET /api/ui/chats/{chat_id}/members` возвращает публичные данные участников. Оба требуют Bearer и членство в чате; постороннему возвращается 404. Обязательный `/api/v1` сохраняет исходную сортировку истории по возрастанию. Для отдельных направлений используются отдельные cursor scopes. Имена и тексты вставляются через `textContent`.
Для демонстрации добавлен отключаемый «Режим защиты» (`wwwroot/defense.js`): показывает метод/путь последнего запроса этой вкладки, реальный HTTP-код и X-Request-Id, тип авторизации без её значения, длительность fetch/обработки ответа в браузере, пользователя, обратный отсчёт до expires_at и количество загруженных сообщений. До получения страницы не заявляется отсутствие старой истории. Фоновые чтения записываются отдельно и не затирают результат отправки. Хранятся только четыре последние записи с выбранными метаданными в памяти; пароли, токены, тела и полные заголовки в панель не передаются. В sessionStorage записывается только дополнительное предпочтение on/off панели. Закрыть можно кнопкой или Escape. На широком экране панель расположена рядом с чатом, на узком - поверх части истории.
В режиме защиты добавлены два сценария (`wwwroot/scenarios.js`). «Подготовить демонстрацию» создаёт двух пользователей с уникальными логинами и допустимыми случайными паролями, входит под ними, создаёт чат основного пользователя с одним тестовым участником и три сообщения от обоих. Второй тестовый пользователь остаётся вне чата. Основной аккаунт не переключается. Тестовые сессии отзываются в finally. Повторная кнопка открывает тот же чат, сохраняя журнал проверок; после перезагрузки страницы нужен новый набор. Созданные пользователи/чаты остаются в PostgreSQL. Пароли и токены тестовых пользователей хранятся только в памяти модуля до выхода/перезагрузки и не выводятся в журнал.
«Проверить типичные вопросы» сравнивает реальные HTTP-коды с ожидаемыми: повтор username - 409, неверный пароль - 401, короткий пароль - 400, пустое сообщение - 400, повтор участника - 400, чужой чат - 404, отзыв тестовой сессии - 204, старый токен - 401. Ожидаемые ошибки отмечаются как пройденные проверки. Непредвиденный ответ останавливает основной сценарий; отдельно предпринимается завершение созданных тестовых сессий. Для каждого запроса доступны объяснение, маршрут, ожидаемый/фактический код, длительность и X-Request-Id. Источник запросов обозначается отдельно от основного пользователя. Эти сценарии проверяют HTTP-поведение, а не заменяют исследование PostgreSQL/Redis/backup.
На экране входа три CSS-фигуры и два облачка (`wwwroot/mascots.js`). Фигуры реагируют на ввод, показ пароля, ожидание ответа и результат входа. На телефоне композиция уменьшается. Декорация скрыта от screen reader, ошибки отображаются в форме. При `prefers-reduced-motion` движение отключено; при скрытой вкладке или форме входа анимация останавливается.
Панель не показывает запросы curl и других вкладок: их результаты видны после чтения общей истории. Она также не является независимой проверкой Redis, SQL/COMMIT или backup; это подтверждают отдельные консольные проверки и отчёт исследования. Обратный отсчёт зависит от часов браузера; срок и отзыв на сервере по-прежнему проверяет PostgreSQL.
Токен хранится в `sessionStorage` текущей вкладки; пароль клиент не сохраняет. При перезагрузке токен проверяется через `/api/v1/users/me`, при выходе сервер отзывает сессию. Для fetch задано `credentials: "omit"`: Basic/Bearer передаются явным Authorization, а браузер не перехватывает ответ 401 диалогом HTTP-auth. Это учебный клиент: защита от XSS остаётся необходимой, `sessionStorage` не является защищённым хранилищем. Сообщения обновляются раз в 4 секунды, пока вкладка видима, и вручную; WebSocket, редактирование, файлы и статусы прочтения не реализованы.
Проверки: `make test-ui` проверяет авторизацию, закрытость чужого чата, форму DTO участников и обе страницы обратной истории (75 сообщений с одинаковым временем), а также изоляцию cursors и сохранение прямой сортировки обязательного API. Проверка входит в `make verify-grade4` и `make verify-grade5`. Результаты исследования уровня 5 записаны до добавления интерфейса; итоговый прогон API и клиента - в `evidence/grade4-checks.txt`.
## Источники
- [Npgsql: использование и параметризованные команды](https://www.npgsql.org/doc/basic-usage.html).
- [Fetch Standard: HTTP network/cache fetch и обработка 401](https://fetch.spec.whatwg.org/#http-network-or-cache-fetch).
- [Isopoh.Cryptography.Argon2](https://github.com/mheyman/Isopoh.Cryptography.Argon2).
- [PostgreSQL: транзакции](https://www.postgresql.org/docs/17/tutorial-transactions.html).
- [Docker Compose: secrets](https://docs.docker.com/compose/how-tos/use-secrets/).
- [StackExchange.Redis: configuration, таймауты и backlog](https://stackexchange.github.io/StackExchange.Redis/Configuration.html).
- [Redis: EXPIRE](https://redis.io/docs/latest/commands/expire/).
- [PostgreSQL 17: EXPLAIN](https://www.postgresql.org/docs/17/using-explain.html).
- Нормативные требования: `README.md`, `COURSE.md`, `contracts/README.md`, `contracts/openapi.json` текущего skeleton.
+75
View File
@@ -0,0 +1,75 @@
services:
postgres:
image: postgres:17.6
environment:
POSTGRES_DB: messenger
POSTGRES_USER: messenger
POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password
secrets:
- postgres_password
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"]
interval: 2s
timeout: 2s
retries: 30
restart: unless-stopped
redis:
image: redis:7.4.2-alpine
command: ["redis-server", "--save", "", "--appendonly", "no", "--maxmemory", "64mb", "--maxmemory-policy", "allkeys-lru"]
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 2s
timeout: 2s
retries: 15
restart: unless-stopped
postgres-restore:
profiles: ["research"]
image: postgres:17.6
environment:
POSTGRES_DB: restore_control
POSTGRES_USER: messenger
POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password
secrets:
- postgres_password
volumes:
- restore_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U messenger -d restore_control"]
interval: 2s
timeout: 2s
retries: 30
restart: unless-stopped
api:
build: .
image: messenger-lab2:local
environment:
APP_HOST: 0.0.0.0
APP_PORT: 8080
SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600}
DATABASE_URL_FILE: /run/secrets/database_url
REDIS_URL: redis:6379
secrets:
- database_url
ports:
- "127.0.0.1:${API_PORT:-8080}:8080"
depends_on:
postgres:
condition: service_healthy
redis:
condition: service_started
restart: unless-stopped
secrets:
postgres_password:
file: ./secrets/postgres_password
database_url:
file: ./secrets/database_url
volumes:
postgres_data:
restore_data:
+39
View File
@@ -0,0 +1,39 @@
# Короткая подготовка к защите Lab2
## Как рассказать работу за две минуты
«У меня ASP.NET Core API. PostgreSQL хранит пользователей, чаты, участников, сообщения и сессии. Регистрация хеширует пароль Argon2id. Basic используется для входа, после входа клиент получает случайный Bearer-токен. В БД хранится hash токена и срок действия. Redis кэширует данные пользователя, а PostgreSQL при каждом запросе проверяет, что сессия действует. Поэтому logout работает и при отказе Redis.
На уровень 5 я исследовал индексы на 100 000 сообщениях в чатах разного размера. Сравнил индекс chat_id и составной chat_id/created_at/id, измерил чтение и вставку. Составной индекс позволяет перейти сразу к cursor и читать в нужном порядке. Затем сделал backup, восстановил в отдельный PostgreSQL и сверил количества, сообщения и checksum. Сообщение после backup не попало в restore - это показывает границу возможной потери данных».
Точные числа своего последнего прогона посмотри в [RESEARCH.md](RESEARCH.md). Нужно объяснять смысл чисел, а не запоминать их все.
## Пять понятий
1. **Индекс:** дополнительная структура для поиска. Составной индекс сначала группирует чат, потом упорядочивает сообщения по времени и ID. При вставке его тоже нужно обновить: это стоит времени и места.
2. **EXPLAIN ANALYZE:** показывает план и действительно выполняет запрос. Actual Rows - реально обработанные строки, Execution Time - время выполнения; BUFFERS показывает работу со страницами памяти/диска. EXPLAIN ANALYZE INSERT действительно вставляет строки, поэтому эксперимент делает это в отдельных таблицах.
3. **Транзакция:** операции подтверждаются вместе через COMMIT. При ошибке создания участника rollback отменяет также уже вставленный чат. PK/FK/unique поддерживают целостность. При fsync=on и synchronous_commit=on подтверждение зависит от записи WAL; исправность хранения остаётся предпосылкой.
4. **Backup/restore:** pg_dump сохраняет согласованный снимок схемы и данных; pg_restore разворачивает архив в новую БД. В этой работе используется отдельный контейнер и volume, проверяются counts, 12 сообщений и checksum всего исследуемого набора.
5. **RPO/RTO:** RPO - допустимый объём/возраст потерянных данных, RTO - допустимое время восстановления работы. Один dump покрывает свой snapshot. Полный RTO включает больше этапов, чем выполнение pg_restore.
## Частые вопросы
- **Зачем id в индексе, если есть время?** Несколько сообщений могут иметь одинаковое время. Пара created_at/id задаёт устойчивый порядок и границу страницы.
- **Почему cursor вместо OFFSET?** Cursor задаёт место в индексе; глубина страницы не требует заново пропускать все предыдущие строки. В исследовании сравниваются одинаковые keyset-запросы с разными индексами.
- **Почему медиана?** Она меньше зависит от одного случайного медленного замера. Здесь также сохранены отдельные замеры и описаны прогрев и порядок запусков.
- **Что происходит после рестарта Redis?** Кэш исчезает, а действующая сессия читается из PostgreSQL с прежним expires_at.
- **Что происходит после остановки PostgreSQL?** API возвращает 503; кэш самостоятельно не разрешает доступ.
- **Пароль хешируется SHA-256?** Пароль защищён Argon2id с солью. SHA-256 применяется к случайному токену с 256 битами энтропии. MD5 в исследовании - только checksum/детерминированный ID синтетических данных.
- **Почему restore не содержит сообщение после backup?** Оно создано позже snapshot. Для восстановления более поздних транзакций нужны последующий backup или архив WAL/PITR.
- **Достаточно ли volume как backup?** Volume сохраняет рабочие файлы после рестарта. Отдельный dump позволяет восстановить данные в новое хранилище.
## Что показать
```sh
make up
make test
make test-persistence
make verify-grade5
```
Открыть REPORT.md, docs/RESEARCH.md и evidence/research-track2.json. Показать распределение данных, оба плана, цену записи, отдельный volume восстановления и проверку сообщения после snapshot. Проверки создают синтетические данные; перед исследованием исключить параллельные записи в API.
+444
View File
@@ -0,0 +1,444 @@
# Lab2: подготовка к защите с нуля
Требования: README.md. Реализация и запуск: REPORT.md. Измерения: RESEARCH.md.
## 1. Что сделано одной фразой
«Я сделал мессенджер на C# и ASP.NET Core. Данные и сессии сохраняются в PostgreSQL, Redis используется как кэш. Для оценки 5 я сравнил индексы на 100 000 сообщений и проверил восстановление резервной копии в отдельную базу».
В Lab1 данные хранились в памяти процесса. После его остановки они терялись. В Lab2 сервер записывает их в PostgreSQL; при сохранении volume они переживают проверенный перезапуск контейнеров.
На 3 нужны база, безопасное хранение паролей, сессии и сохранность после перезапуска. На 4 добавляются Redis, проверки ошибок/конкуренции/транзакций и обоснование индекса. На 5 нужен один законченный исследовательский трек. Здесь выбран трек 2: запросы и восстановление. Фронтенд - дополнительный способ показать работу.
## 2. Слова, которые встретятся
| Слово | Простое объяснение |
| --- | --- |
| Клиент | Тот, кто отправляет запрос: браузер, curl или тестовый Python-скрипт |
| Фронтенд | Страница с кнопками, формами и сообщениями |
| Бэкенд | Сервер, который проверяет запросы, права и обращается к базе |
| API | Набор адресов и правил, по которым клиент общается с сервером |
| HTTP | Способ обмена запросами и ответами между клиентом и сервером |
| Endpoint | Конкретный адрес API и операция, например POST /api/v1/chats |
| JSON | Текстовый формат данных: поля и значения в фигурных скобках |
| SQL | Язык команд для чтения и изменения таблиц PostgreSQL |
| UUID | Длинный идентификатор пользователя, чата или сообщения |
| Docker image | Подготовленный образ с приложением и нужным окружением |
| Контейнер | Запущенный экземпляр образа |
| Compose | Файл и команда, которые запускают несколько связанных контейнеров |
| Volume | Отдельное хранилище рабочих файлов БД, сохраняемое при обычном перезапуске/пересоздании контейнера |
| Кэш | Дополнительная копия данных для более быстрого повторного чтения |
| Сессия | Запись о состоявшемся входе пользователя: до какого времени он действует и не отозван ли |
| Токен | Случайный секрет, который клиент предъявляет после входа |
| TTL | Сколько времени осталось жить сессии или записи кэша |
| Миграция | Версионируемый SQL-сценарий создания или изменения структуры БД |
## 3. Как проходит одно сообщение
```text
Браузер или curl
↓ HTTP: текст + Bearer-токен
ASP.NET Core API
↓ проверка сессии и участия в чате
PostgreSQL: запись сообщения
↓ успешный ответ API
Клиент показывает сообщение
```
Браузер не подключается напрямую к PostgreSQL или Redis. Он вызывает API. Два клиента видят одну переписку, потому что обращаются к одной базе через один сервер.
JavaScript периодически запрашивает новые сообщения: раз в 4 секунды, пока вкладка видима. Можно обновить вручную. Это polling; WebSocket в текущем проекте нет.
## 4. Почему всё разложено по папкам
| Папка/файл | За что отвечает | Пример |
| --- | --- | --- |
| Program.cs | Собирает и запускает приложение, настраивает зависимости | Подключает маршруты и миграции |
| Endpoints | Принимает HTTP-запросы, проверяет их форму и формирует ответы | MessageEndpoints принимает отправку сообщения |
| Contracts | Формы входящих и исходящих данных, DTO | UserDto не содержит hash пароля |
| Services | Выполняет операции приложения | SessionService создаёт и отзывает сессии |
| Data/AppDatabase.cs | Выполняет SQL, управляет транзакцией создания чата | INSERT сообщения |
| Data/Entities | Представляет прочитанные записи БД в C# | UserEntity содержит внутренний password_hash |
| Data/Migrations | Создаёт структуру БД | 001_initial.sql |
| Middleware | Общие действия вокруг запросов | ID запроса, журнал, обработка ошибок |
| Infrastructure | Работа с Redis | RedisSessionCache |
| wwwroot | HTML, CSS и JavaScript интерфейса | index.html, app.css, app.js |
DTO - объект для передачи данных. Entity - внутреннее представление записи базы. Благодаря отдельному UserDto пароль/hash не попадает в JSON пользователю.
Npgsql - библиотека, через которую C# выполняет команды PostgreSQL. В этом проекте SQL написан явно, Entity Framework не используется. Зависимости регистрируются в Program.cs и передаются нужным классам механизмом ASP.NET Core (dependency injection).
## 5. Что лежит в базе
| Таблица | Смысл |
| --- | --- |
| users | Кто зарегистрирован: ID, login, отображаемое имя, hash пароля |
| chats | Какие чаты существуют |
| chat_members | Кто участвует в каком чате |
| messages | Кто, что, когда и в какой чат отправил |
| sessions | Hash токена, пользователь, срок действия и время отзыва |
| schema_migrations | Какая версия структуры базы уже применена |
PK (primary key) - уникальный ключ строки: например ID сообщения. FK (foreign key) - ссылка на существующую строку другой таблицы: сообщение ссылается на чат и отправителя. UNIQUE у username запрещает два одинаковых login. Составной PK chat_members по chat_id/user_id запрещает дважды добавить одного человека в один чат.
Членство отправителя в чате проверяет приложение; одного FK sender_id недостаточно для этой проверки. FK подтверждает существование пользователя.
## 6. Как работает вход
1. Регистрация принимает пароль. PasswordService создаёт Argon2id hash со случайной солью. В users сохраняется hash, исходный пароль не сохраняется.
2. При входе клиент передаёт login/password через Basic на POST /api/v1/auth/sessions.
3. Сервер проверяет пароль и создаёт случайный токен: 32 случайных байта, после кодирования 43 символа.
4. Клиент получает исходный токен. В sessions сохраняется SHA-256 этого токена, срок жизни и пользователь.
5. Дальше клиент передаёт заголовок Authorization: Bearer <токен>.
6. Сервер хеширует предъявленный токен и ищет действующую, не отозванную сессию в PostgreSQL.
Basic - формат передачи login/password в Base64. Base64 легко декодируется и не является шифрованием. Для реальной сети нужен HTTPS; текущий стенд работает локально по HTTP.
Bearer означает: доступ предъявляет владелец токена. Здесь токен непрозрачный (opaque): случайная строка, а не JWT с данными внутри. Нормальный срок сессии - 3600 секунд (1 час); он задаётся SESSION_TTL_SECONDS.
Hash - результат преобразования данных, который не используют для обратного получения пароля. Argon2id специально расходует время и память, чтобы усложнить перебор паролей. Соль - случайное добавление, из-за которого одинаковые пароли разных регистраций получают разные hashes. Здесь 16 байт соли, 32 MiB памяти и 3 прохода.
У случайного токена много энтропии: угадывать его практически невыгодно. Поэтому для его хранения применяется быстрый SHA-256. MD5 в исследовании используется только для сверки синтетических данных и формирования их ID, не для паролей.
## 7. Кто вошёл и куда ему можно - разные проверки
Аутентификация: «Кто ты? Есть действующая сессия?»
Авторизация: «Ты участвуешь именно в этом чате?»
Вошедший пользователь не получает доступ ко всем чатам. Участие проверяется отдельно. При обращении к чужому чату API возвращает 404, чтобы не раскрывать его существование. X-User-Id не даёт доступ: доверять присланному ID пользователя нельзя.
## 8. Что именно делает Redis
PostgreSQL - главная база. В ней сервер проверяет действительность сессии при каждом защищённом запросе. Redis хранит UserDto и expires_at под ключом, связанным с hash токена.
Если запись Redis найдена, сервер использует уже прочитанные данные пользователя и экономит дополнительный SELECT пользователя. Если запись не найдена или Redis не работает, данные пользователя читаются из PostgreSQL и по возможности снова кладутся в кэш.
TTL кэша равен оставшемуся сроку сессии. Чтение не продлевает сессию. При выходе сервер сначала отзывает сессию в PostgreSQL, затем удаляет ключ Redis. Если удалить ключ не удалось, PostgreSQL всё равно отклонит следующие запросы с отозванным токеном.
Redis здесь не сохраняет кэш на диск. Это допустимо в этой реализации: после потери кэша обязательные данные и сессии остаются в PostgreSQL. При недоступности самой PostgreSQL API возвращает 503, даже если кэш прогрет.
## 9. Транзакция, COMMIT, rollback
Создать чат - значит создать строку chats и несколько строк chat_members. Эти записи должны появиться вместе.
Транзакция объединяет операции. Если всё получилось - COMMIT подтверждает изменения. Если вставка участника сломалась - rollback отменяет и уже вставленный чат. Не останется половины операции.
В тесте специально вызывается ошибка при вставке участника после вставки чата. Проверяется, что чат и участники не сохранились, затем обычная попытка успешно проходит.
Для отдельного сообщения выполняется один INSERT; отдельная явная транзакция для нескольких команд ему не нужна. Успешный ответ отправляется после завершения записи. Если клиент потерял ответ, он может не знать, была ли запись: автоматического устранения повторных POST в Lab2 нет.
При fsync=on и synchronous_commit=on PostgreSQL подтверждает обычный COMMIT после сброса записи журнала WAL на устойчивое хранилище. WAL - журнал изменений для восстановления БД. Это зависит от корректной работы диска/хоста; COMMIT не создаёт отдельный backup и не гарантирует защиту от потери всего компьютера.
## 10. Почему два одинаковых login не появятся
Два запроса могут одновременно попытаться зарегистрировать один username. Это гонка. Простая проверка «имя свободно» в коде не решает её: оба запроса могут увидеть свободное имя.
Ограничение UNIQUE в PostgreSQL разрешает только одну вставку. Тест отправляет 4 конкурентных регистрации: одна получает 201, три получают 409, строка в users одна.
## 11. Индекс и страницы истории
Индекс похож на оглавление: помогает найти нужное место, не перечитывая всё подряд. Здесь индекс messages_chat_created_id_idx состоит из chat_id, created_at, id.
Первый ключ задаёт нужный чат. Следующие задают порядок сообщений. id разрешает ситуацию, когда несколько сообщений имеют одинаковое время.
Пагинация - чтение истории частями. Cursor хранит точку, с которой продолжать. Для обязательного API запрос по смыслу такой:
```sql
WHERE chat_id = @chat_id
AND (created_at, id) > (@cursor_time, @cursor_id)
ORDER BY created_at, id
LIMIT @count
```
Это keyset pagination. При limit=50 читается до 51 строки: первые 50 вернуть, 51-я сообщает, есть ли следующая страница. OFFSET потребовал бы пропускать предыдущие строки; cursor задаёт границу поиска по индексу.
Cursor не даёт права доступа. Сессию и членство всё равно проверяют. Cursor проверяется на принадлежность нужному пользователю/чату. Это закодированная структура, не зашифрованный секрет.
Обязательный /api/v1 читает историю по возрастанию. Дополнительный /api/ui читает последние сообщения в обратном направлении; клиент показывает их в хронологическом порядке и подгружает более старые. Одинаковые timestamps проверены в тесте.
При неизменной истории проверяется отсутствие пропусков/повторов. Это не обещание одного неподвижного снимка при любых параллельных вставках между страницами.
EXPLAIN показывает план запроса. ANALYZE действительно запускает запрос и даёт измерения. BUFFERS показывает обращения к страницам данных в памяти/хранилище. Index Scan означает использование индекса; Seq Scan - последовательное чтение таблицы. Seq Scan не всегда плох: для маленькой таблицы он может быть выгоднее.
## 12. Что доказано на 5
Гипотеза: составной индекс ускорит страницы истории, особенно глубоко в большом чате. За индекс нужно платить дополнительным местом и его обслуживанием при записи.
Методика: 100 000 сообщений, чаты 80 000 / 15 000 / 4 000 / 1 000. Две отдельные таблицы с одинаковыми данными и PK/FK, но разными индексами: chat_id и chat_id/created_at/id. Прогрев, 3 замера вставки с чередованием порядка и 5 замеров чтения; берётся медиана. Рабочие индексы приложения не удаляются.
Последний записанный прогон на момент подготовки:
| Что | chat_id | chat_id/created_at/id |
| --- | ---: | ---: |
| Глубокая страница, ms | 8.794 | 0.066 |
| INSERT 100 000, ms | 2140.540 | 2016.552 |
| Размер исследуемого индекса, bytes | 671744 | 10526720 |
Глубокое чтение ускорилось примерно в 133 раза. Индекс занимает существенно больше места. В последнем прогоне вставка оказалась примерно на 5.8% быстрее с составным индексом; утверждать, что этот прогон доказал замедление записи, нельзя. Обслуживание индекса существует, но общее время зависит от нагрузки, кешей, порядка и конкретных данных. Результаты другого запуска могут отличаться.
Медиана - средний по месту результат в отсортированном списке измерений. Она меньше зависит от одного случайно очень медленного измерения.
Это локальный эксперимент с прогретыми buffers. Вставка пакетом SQL отличается от сообщений по одному через HTTP; время COMMIT/HTTP/Argon2 в измерение INSERT не включено. Результат не означает, что весь мессенджер или любой сервер ускорился в 133 раза.
## 13. Backup и восстановление
pg_dump сохраняет согласованный снимок public-схемы приложения в файл. pg_restore восстанавливает его в новую пустую БД другого контейнера PostgreSQL с отдельным volume.
Проверяются количества всех 6 таблиц, 12 выбранных сообщений и checksum всех 100 000 сообщений нового исследовательского набора. Checksum - вычисленная метка содержимого для сверки; один count не доказывает, что тексты и отправители совпали.
В последнем snapshot было 380 569 сообщений: в базе уже находились данные предыдущих запусков, а новый исследуемый набор содержит 100 000. После восстановления count совпал. pg_restore занял примерно 2.165 секунды; остальные этапы измерены отдельно.
После backup тест записывает дополнительное сообщение через API. В источнике оно есть, в восстановленной БД нет: запись сделана после момента снимка.
RPO - допустимая потеря данных по времени. Если доступен только backup 12:00, записи после этого снимка им не восстановить. Возраст последнего backup определяет покрываемую границу; восстановление более новых изменений требует следующего backup или журнала WAL/PITR.
RTO - допустимое время возвращения сервиса в работу. В эксперименте измерены этапы восстановления; один pg_restore не равен полному RTO, в который ещё входят обнаружение сбоя, подготовка, переключение API и проверка.
Исходный API не переключался на восстановленную БД. Тест сверяет новую БД SQL-запросами. Непрерывная репликация, высокая доступность и PITR здесь не реализованы.
## 14. Порядок показа преподавателю
### Перед защитой
Запусти Docker Desktop. Затем:
```sh
cd ~/Documents/mtusi2026lab2
make up
docker compose ps
make verify-grade5
```
Полный прогон выполняй без параллельной переписки и второго запуска тестов: некоторые тесты перезапускают сервисы, а исследование сверяет snapshot. Запуск создаёт новые учебные данные. Подробный вывод - evidence/grade4-checks.txt и evidence/grade5-checks.txt; планы/сверка - evidence/research-track2.json.
### Показ 1: приложение
Открой http://localhost:18080/. Покажи вход, свой профиль, создание чата и отправку сообщения. Для двух пользователей используй два браузера или обычное и приватное окно. Второй пользователь копирует ID из профиля; первый вставляет его при создании чата. При новом чате обнови список у второго пользователя.
Скажи: «Это клиент моего API. Сообщения сохраняются сервером в PostgreSQL. Разные клиенты читают одни данные».
Для наглядного показа включи «Режим защиты» под списком чатов (на телефоне - значок кода в заголовке чата). При отправке из браузера покажи POST/201, Bearer без значения токена, время запроса и X-Request-Id. Панель также показывает пользователя, срок сессии и количество загруженных сообщений; при загрузке старой страницы счётчик увеличивается. Фоновые чтения не затирают отправку. Кнопка закрытия или Escape возвращает обычный вид. Панель наблюдает только запросы этой вкладки; консольную отправку подтверждают сообщение в истории и её GET-запрос. Реальную работу Redis/SQL и backup показывай тестами ниже.
### Показ 2: контейнеры и готовность
```sh
docker compose ps
curl -i http://localhost:18080/health/ready
```
Покажи api/postgres/redis и, после исследования, postgres-restore. ready отвечает 200 и status=ok, когда API может обратиться к PostgreSQL. live проверяет работающий процесс, ready - готовность с критичной базой.
### Показ 3: данные в БД и ограничения
```sh
docker compose exec -T postgres psql -X -U messenger -d messenger -c '\dt'
docker compose exec -T postgres psql -X -U messenger -d messenger -c '\d messages'
docker compose exec -T postgres psql -X -U messenger -d messenger -c 'SELECT version, applied_at FROM schema_migrations;'
docker compose exec -T postgres psql -X -U messenger -d messenger -c 'SELECT text, created_at FROM messages ORDER BY created_at DESC LIMIT 5;'
```
Разбор команды: docker compose exec запускает команду внутри сервиса; postgres - сервис; psql - консоль PostgreSQL; -U - имя пользователя БД; -d - имя БД; -c - выполняемая команда. Пароли/hash/token не выводятся.
### Показ 4: тесты и сохранность
```sh
make test
make test-ui
make test-persistence
```
make test - публичный сквозной сценарий API. make test-ui - проверки дополнительных маршрутов клиента и сохранения обязательной сортировки. make test-persistence создаёт данные и сессию, перезапускает API/PostgreSQL/Redis, затем проверяет данные старым токеном. Токен остаётся в памяти теста; новый вход для проверки не выполняется.
Скажи: «Сохранены и подтверждённые данные, и действующая сессия». Подтверждение реального перезапуска всех трёх контейнеров записано в evidence/grade4-checks.txt через StartedAt.
### Показ 5: уровень 4
```sh
make test-grade4
make test-dependencies
make test-expiry
make explain-history
```
| Команда | Что сказать после успешной проверки |
| --- | --- |
| test-grade4 | Один username регистрируется только один раз; ошибка участника откатывает создание чата; кэш работает и удаляется при logout |
| test-dependencies | При отказе Redis API обходит кэш; при отказе PostgreSQL отвечает 503; после возврата сервисов данные и токен работают |
| test-expiry | Новая сессия с TTL=2 секунды перестаёт действовать; проверяются PostgreSQL и Redis |
| explain-history | План чтения истории проверен на 10 000 сообщений с первой и глубокой страницей |
Эти действия уже входят в verify-grade5. На короткой защите можно показать записанный лог и запустить только интересующую преподавателя проверку.
### Показ 6: уровень 5
Открой docs/RESEARCH.md и evidence/research-track2.json. Покажи гипотезу, распределение данных, два индекса, время чтения/вставки, размер индексов, сверку restore и сообщение после backup. Для повтора:
```sh
make research-grade5
```
Показывай числа именно последнего прогона. Пока работает исследование, не отправляй сообщения и не запускай другие тесты.
### Если попросят запуск с пустой БД
Создай отдельный Compose-проект на другом порту, сохранив основной стенд:
```sh
API_PORT=18081 docker compose -p lab2-clean-demo up -d --build --wait
docker compose -p lab2-clean-demo exec -T postgres psql -X -U messenger -d messenger -c 'SELECT version FROM schema_migrations; SELECT count(*) FROM users;'
```
При первом запуске имя проекта даёт отдельный volume: автоматически появится миграция 1 и пользователей будет 0. Открой http://localhost:18081/ и зарегистрируй пользователя. Повторный запуск с тем же именем использует уже созданную БД. Остановить этот отдельный стенд с сохранением данных: docker compose -p lab2-clean-demo down.
## 15. Сообщение из терминала - и то же сообщение в браузере
Это отдельная ручная демонстрация. На текущем локальном стенде логин - `n1k0der`, пароль - `125125125125` (12 символов). Этот аккаунт находится в текущем volume, на чистом стенде его нужно зарегистрировать заново. Войди в браузере под тем же login, который указал ниже. curl при входе сам спросит пароль. Выполняй в одном окне терминала:
```sh
cd ~/Documents/mtusi2026lab2
API=http://localhost:18080
LOGIN=n1k0der
SESSION_JSON=$(curl -fsS -X POST -u "$LOGIN" "$API/api/v1/auth/sessions")
TOKEN=$(printf '%s' "$SESSION_JSON" | python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])')
ACTOR_ID=$(printf '%s' "$SESSION_JSON" | python3 -c 'import json,sys; print(json.load(sys.stdin)["user"]["id"])')
CHAT_ID=$(curl -fsS "$API/api/v1/chats" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
--data "{\"title\":\"Защита Lab2\",\"member_ids\":[\"$ACTOR_ID\"]}" \
| python3 -c 'import json,sys; print(json.load(sys.stdin)["id"])')
curl -fsS "$API/api/v1/chats/$CHAT_ID/messages" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
--data '{"text":"Это сообщение отправлено командой curl на защите"}' \
| python3 -m json.tool
```
В браузере нажми «Обновить чаты», открой «Защита Lab2». Отправь ответ из интерфейса и прочитай оба сообщения командой:
```sh
curl -fsS "$API/api/v1/chats/$CHAT_ID/messages" \
-H "Authorization: Bearer $TOKEN" \
| python3 -m json.tool
```
curl отправляет HTTP-запрос. -H задаёт заголовок. --data передаёт тело и выбирает POST. python3 -m json.tool только красиво печатает JSON. Переменные TOKEN/CHAT_ID держат полученные значения в текущем терминале; токен не нужно показывать преподавателю.
### Показать отсутствие доступа и отзыв
```sh
# Без токена: 401
curl -i "$API/api/v1/chats"
# Выйти из консольной сессии: 204
curl -i -X DELETE "$API/api/v1/auth/sessions/current" \
-H "Authorization: Bearer $TOKEN"
# Тот же токен больше не действует: 401
curl -i "$API/api/v1/chats" \
-H "Authorization: Bearer $TOKEN"
```
В браузере вход может сохраниться: браузер и curl получили две отдельные сессии. Logout здесь отзывает только предъявленную консольную сессию.
## 16. HTTP-коды
| Код | Значение в проекте |
| --- | --- |
| 200 | Успешное чтение |
| 201 | Пользователь, сессия, чат или сообщение созданы |
| 204 | Успешный logout, без тела ответа |
| 400 | Запрос некорректен |
| 401 | Нет действительной авторизации |
| 404 | Чат не найден или недоступен этому пользователю |
| 409 | Такой username уже занят |
| 503 | Критичная база временно недоступна |
## 17. Готовые короткие ответы
**Что главное изменилось после Lab1?** Данные и действующие сессии хранятся в PostgreSQL и переживают проверенный рестарт. Пользователя определяет Bearer-сессия.
**Почему Program.cs небольшой?** Он настраивает и запускает приложение. Маршруты, операции, SQL и общие обработчики выделены в отдельные файлы.
**Где главный источник данных?** PostgreSQL. Redis хранит восстанавливаемую копию данных пользователя.
**Почему не доверять только Redis?** Его записи могут исчезнуть или остаться устаревшими. PostgreSQL подтверждает срок и отзыв сессии.
**Что будет после restart/потери Redis?** Кэш будет восстановлен по обращениям. Действующие сессии остаются в PostgreSQL.
**Что будет, если PostgreSQL остановить?** API отвечает 503; кэш не даёт самостоятельного разрешения доступа.
**Чем аутентификация отличается от авторизации?** Первая определяет пользователя, вторая проверяет его участие в конкретном чате.
**Что подтверждает COMMIT?** Успешное завершение транзакции. В текущих настройках PostgreSQL перед подтверждением сбрасывает WAL на хранилище; гарантия зависит от исправности хранения и не заменяет backup.
**Как проверен rollback?** После вставки чата специально вызывается ошибка вставки участника. Проверяется отсутствие обеих частей операции.
**Как защищён пароль?** Argon2id со случайной солью. Исходный пароль не хранится; проверяется через Argon2.Verify.
**Basic шифрует пароль?** Нет, это Base64. Для реальной сети нужен HTTPS.
**Почему SHA-256 допустим для токена, но пароль защищён Argon2id?** Пароли обычно угадываемы и требуют дорогого перебора. Токен генерируется случайно с 256 битами энтропии.
**Это JWT?** Нет, opaque token. Пользователь и срок хранятся на сервере в sessions.
**Что делает logout?** Ставит revoked_at в PostgreSQL и удаляет ключ кэша. Следующие проверки этой сессии не проходят.
**Что делает TTL?** Ограничивает время жизни. TTL не сохраняет данные после рестарта и не заменяет persistence.
**Для чего UNIQUE/FK/PK?** UNIQUE предотвращает дубли username, FK поддерживает связи с существующими записями, PK идентифицирует строку.
**Почему нельзя просто проверить username до INSERT?** При параллельных запросах оба могут увидеть свободное имя. Ограничение БД разрешает только одну вставку.
**Как защищены SQL-запросы от подстановки команд?** Пользовательские значения передаются параметрами Npgsql, а не вставляются в SQL-текст. Пул соединений ограничен 20, настроены таймауты.
**Почему индекс содержит id?** Время у нескольких сообщений может совпадать; id задаёт однозначный порядок.
**Что доказал EXPLAIN ANALYZE?** Какой план реально выполнялся, сколько строк он обработал и сколько времени занял. Это не прогноз любой нагрузки.
**Почему индекс не бесплатный?** Он занимает место и обслуживается при записи. В последнем замере общее время вставки с составным индексом не выросло; фиксируем измеренный результат и ограничения.
**Почему нужна проверка сообщений после restore, если counts совпали?** Одинаковое количество не подтверждает одинаковое содержимое. Поэтому сверяются выбранные записи и checksum исследуемого набора.
**Что потеряется при restore backup?** Записи после его snapshot этим backup не покрываются. Тест доказывает это дополнительным сообщением.
**Чем volume отличается от backup?** Volume содержит текущие рабочие файлы. Backup - отдельный сохранённый снимок, который можно восстановить в новую БД.
**Как интерфейс получает новые сообщения?** HTTP polling раз в 4 секунды и ручное обновление. WebSocket нет.
**Где клиент хранит токен?** В sessionStorage вкладки. Пароль клиентский JavaScript не сохраняет. Это не защищённое от XSS хранилище; тексты вставляются через textContent.
**Как найти запрос в логах?** Middleware присваивает X-Request-Id и записывает метод, путь и статус в журнал.
**Что делает миграция при повторном запуске?** Проверяет schema_migrations. Уже выполненная версия повторно не создаёт таблицы; применение защищено транзакцией и advisory lock.
**Готов ли проект для production?** Это локальный учебный стенд. Есть один API и одна основная БД, нет автоматического failover/PITR/HTTPS, не измерена максимальная пропускная способность. Проверены конкретные сценарии в отчёте.
## 18. Что выучить в первую очередь
1. Браузер/curl → API → PostgreSQL; Redis - кэш.
2. Регистрация → Argon2id; вход → Basic; дальнейшие запросы → Bearer.
3. Действующая сессия и участие в чате - две разные проверки.
4. Транзакция: все части создания чата вместе, иначе rollback.
5. Volume сохраняет рабочие данные; отдельный backup нужен для восстановления снимка.
6. Индекс chat_id/created_at/id подходит под порядок и cursor истории.
7. На 5: 100 000 сообщений, два индекса, замеры чтения/записи, отдельное восстановление и сверка.
8. Показывать результаты тестов и ограничения, не обещать непроверенные гарантии.
Порядок сдачи через fork и PR описан в CONTRIBUTING.md.
## 19. Показ без ручного создания пользователей
1. Войди в основной аккаунт и открой «Режим защиты».
2. Нажми «Подготовить демонстрацию»: появятся два тестовых пользователя, чат с тобой и три сообщения. В чат входит только один тестовый пользователь; второй проверяет доступ снаружи.
3. Нажми «Проверить типичные вопросы»: программа выполнит восемь настоящих проверок API.
4. Раскрой шаг: покажи ожидаемый код, фактический ответ, объяснение и X-Request-Id. Например, «Посторонний открывает чат» успешно получает 404: сервер не раскрывает чужой чат.
5. Покажи свой профиль: основной вход сохранился. При проверке выхода отзывается отдельная тестовая сессия.
400/401/404/409 здесь могут означать успешную проверку: мы специально послали плохие данные или обратились без доступа и получили ожидаемый отказ. При неожиданном коде сценарий останавливается и показывает ошибку.
Тестовые пользователи и чат остаются в базе. «Открыть демочат» в той же вкладке не создаёт новый набор; после обновления страницы сценарий нужно подготовить заново. Кнопки не перезапускают Docker, не проверяют backup или SQL-индексы - для этого нужны консольные команды из предыдущих разделов.
+205
View File
@@ -0,0 +1,205 @@
# Защита Lab2: рассказ и ответы простыми словами
Подробная подготовка: [DEFENSE_BEGINNER.md](DEFENSE_BEGINNER.md). Требования: [README.md](../README.md). Исследование: [RESEARCH.md](RESEARCH.md).
## 1. Сначала понять пять вещей
1. Браузер рисует страницу и отправляет запросы. Сервер решает, разрешена ли операция.
2. PostgreSQL хранит пользователей, чаты, сообщения и сессии входа.
3. Пароль нужен для входа. После входа браузер предъявляет случайный токен.
4. Redis хранит дополнительную копию данных пользователя. Без Redis можно работать через PostgreSQL.
5. Docker запускает компоненты вместе. Volume сохраняет рабочие файлы базы при обычном перезапуске.
Пример отправки сообщения:
```text
Нажал «Отправить»
→ JavaScript послал текст и токен в API
→ сервер проверил сессию
→ сервер проверил участие в чате
→ PostgreSQL записала сообщение
→ API вернул успешный ответ
→ браузер показал сообщение.
```
## 2. Готовый рассказ примерно на две минуты
> В проекте реализован мессенджер на C# и ASP.NET Core. В первой лабораторной данные хранились в памяти приложения. Во второй они перенесены в PostgreSQL, поэтому данные и действующие сессии переживают перезапуск с сохранением хранилища.
>
> Код разделён по задачам. Program.cs настраивает запуск. Endpoints принимают HTTP-запросы. Services выполняют операции приложения. Data содержит SQL и миграции. Contracts задаёт формат запросов и ответов. Middleware обрабатывает общие действия: журнал, ошибки и идентификатор запроса.
>
> При регистрации пароль преобразуется в Argon2id hash со случайной солью. Исходный пароль в базу не записывается. Для входа используется Basic, после входа - случайный Bearer-токен. Сессия имеет срок действия и может быть отозвана при выходе.
>
> PostgreSQL проверяет сессию при каждом защищённом запросе. Redis кэширует данные пользователя, чтобы повторно не читать их из таблицы users. Если Redis недоступен, сервер обращается к PostgreSQL. Если сама PostgreSQL недоступна, сервер возвращает 503.
>
> Создание чата и его участников выполняется в одной транзакции. Для истории сообщений используется составной индекс по чату, времени и ID, а история загружается страницами через cursor.
>
> На уровень 5 выбран трек исследования запросов и восстановления: сравниваются два индекса на 100 тысячах сообщений, измеряются чтение, запись и размер. Резервная копия восстанавливается в отдельную базу, затем сравниваются количества и содержимое сообщений.
>
> Дополнительно сделан интерфейс на HTML, CSS и обычном JavaScript. Он вызывает тот же API. Фигуры и облачка на входе - CSS-элементы, их реакции управляются JavaScript.
## 3. Что находится в папках
| Где | Объяснение | Что открыть |
| --- | --- | --- |
| Program.cs | Собирает и запускает приложение | Регистрация зависимостей, миграции, Map…Endpoints |
| Endpoints | Адреса API, проверка входных данных и ответы | MessageEndpoints.cs |
| Services | Операции приложения | SessionService.cs |
| Contracts | Формат данных для клиента - DTO | CreateMessageRequest.cs и UserDto.cs |
| Data | SQL и работа с базой | AppDatabase.cs |
| Data/Entities | Внутренние записи, прочитанные из БД | UserEntity.cs |
| Data/Migrations | Версии структуры БД | 001_initial.sql |
| Middleware | Общая обработка запросов | RequestIdMiddleware.cs |
| Infrastructure | Подключение к Redis | RedisSessionCache.cs |
| wwwroot | Страница, оформление и поведение клиента | index.html, app.css, app.js |
Здесь Npgsql и явный SQL, без Entity Framework. Services местами тонкие: они вызывают Data и преобразуют записи в DTO. Не нужно приписывать проекту сложную архитектуру или отдельный микросервис для каждой папки.
DTO - данные для передачи клиенту. Entity - внутренняя запись БД. Например, UserEntity содержит hash пароля, а UserDto его не содержит.
## 4. Основные вопросы преподавателя
**Что такое API?** Набор адресов и правил общения с сервером. Например, POST отправляет новое сообщение, GET читает историю.
**Почему данные сохраняются после перезапуска?** Они записаны в PostgreSQL, чьи рабочие файлы находятся в именованном Docker volume. Обычный рестарт этот volume сохраняет.
**Volume - это backup?** Volume содержит текущие файлы базы. Backup - отдельная копия снимка данных, которую можно восстановить в другую базу.
**Какие таблицы есть?** users - пользователи; chats - чаты; chat_members - участники; messages - сообщения; sessions - сессии. Ещё schema_migrations хранит версии структуры базы.
**Что такое миграция?** SQL-файл, создающий или изменяющий структуру базы. Выполненная версия отмечается в schema_migrations и повторно не применяется.
**Что такое транзакция?** Группа операций, которые должны завершиться вместе. В нашем случае чат и его участники либо сохраняются все, либо операция откатывается.
**COMMIT и rollback?** COMMIT подтверждает транзакцию. Rollback отменяет её изменения. COMMIT не создаёт резервную копию. Техническое уточнение о WAL и настройках durability есть в подробной памятке.
**Как хранится пароль?** В виде Argon2id hash со случайной солью. При входе библиотека проверяет введённый пароль по сохранённому hash.
**Что такое соль?** Случайные байты, добавляемые при хешировании. Одинаковые пароли разных регистраций получают разные hashes.
**Basic - это шифрование?** Нет. Login/password кодируются Base64, которую можно декодировать. Вход по настоящей сети должен идти через HTTPS. Стенд сейчас локальный, HTTP.
**Что такое токен и сессия?** Токен - случайный секрет, предъявляемый клиентом. Сессия - запись на сервере: кому он выдан, когда истекает и отозван ли.
**Это JWT?** Нет. Здесь opaque token - случайная строка без встроенного пользователя или срока. Эти данные хранятся на сервере.
**Почему пароль - Argon2id, а токен - SHA-256?** Пароль может быть предсказуемым, поэтому его перебор делают дорогим. Токен генерируется из 32 случайных байтов. В БД хранится только SHA-256 токена, исходный токен получает клиент.
**Что такое аутентификация и авторизация?** Первая определяет, кто вошёл. Вторая проверяет, разрешена ли ему операция, например доступ к конкретному чату.
**Можно прислать чужой sender_id?** Отправитель определяется по сессии. Клиент передаёт текст сообщения, а ID отправителя сервер берёт у вошедшего пользователя. X-User-Id не даёт доступа.
**Что делает Redis?** Кэширует UserDto и срок сессии. PostgreSQL при каждом защищённом запросе всё равно проверяет срок и отзыв сессии. Cache hit экономит дополнительное чтение пользователя.
**Redis выключился или очистился?** При потерянном ключе или ошибке кэша пользователь читается из PostgreSQL. Действующие сессии остаются в PostgreSQL.
**PostgreSQL выключилась, но Redis работает?** Сервер возвращает 503. Кэш сам по себе не разрешает доступ.
**Что такое TTL?** Оставшееся время жизни. Кэш получает TTL до исходного expires_at; чтение не продлевает сессию.
**Что происходит при выходе?** В PostgreSQL записывается revoked_at, затем удаляется ключ Redis. Следующие проверки этой сессии завершаются 401. Другая сессия того же пользователя отдельно не отзывается.
**Почему два одинаковых login не зарегистрируются одновременно?** В PostgreSQL стоит UNIQUE на username. При гонке одна вставка проходит, остальные получают конфликт 409.
**Зачем индекс?** Чтобы находить нужную часть истории без просмотра всей истории при каждой странице. Индекс `(chat_id, created_at, id)` соответствует выборке и порядку сообщений.
**Зачем в индексе id, если есть время?** У нескольких сообщений время может совпадать. ID задаёт однозначный порядок.
**Что такое cursor?** Указатель на место продолжения истории. В нём время и ID последнего сообщения страницы. Он не даёт права доступа: сессия и членство проверяются отдельно.
**Что такое EXPLAIN ANALYZE?** План и измерения действительно выполненного SQL-запроса: как читались данные и сколько это заняло.
**Почему SQL-инъекция не должна превратить текст в команду?** Значения пользователя передаются параметрами Npgsql, отдельно от текста SQL-команды.
## 5. Необычные ситуации
| Ситуация | Ответ для нашей реализации |
| --- | --- |
| Один ID участника дважды в запросе создания чата | 400: сервер отвергает повтор; БД дополнительно защищает составным PK |
| ID участника не существует | 400: чат не создаётся |
| Создателя нет в member_ids | 400: создатель должен быть участником |
| Чат только с собой | Можно: один участник допустим |
| Два чата с одним названием | Можно: уникальность title не задана |
| Два пользователя с одним display_name | Можно: уникален username, отображаемое имя может совпадать |
| Добавить участника после создания | Такого endpoint сейчас нет; список задаётся при создании |
| Посторонний открывает чат | С действующей сессией получает 404; чужой чат не раскрывается |
| Нет токена, токен истёк или отозван | 401 |
| Пустое сообщение или только пробелы | 400 |
| Сообщение длиннее 4000 символов | 400 |
| Один текст отправлен дважды двумя POST | Два отдельных сообщения: одинаковый текст допустим |
| Клиент потерял ответ и повторил POST | Возможен дубль: механизма идемпотентности для сообщений нет |
| Сервер упал посередине создания чата | Незавершённая транзакция не оставляет половину операции |
В интерфейсе список участников может быть нормализован до отправки. Проверка API проверяет именно повторяющиеся ID в JSON-запросе.
## 6. Как объяснить уровень 5
> Сравнил индекс только по chat_id с индексом по chat_id, created_at и id. Подготовил 100 тысяч сообщений в четырёх чатах разного размера. Измерил время чтения первой и глубокой страницы, время вставки и занимаемое место. Затем сделал pg_dump, восстановил копию через pg_restore в отдельную пустую БД и сверил данные.
В сохранённом прогоне из RESEARCH.md глубокая страница: 8,794 ms против 0,066 ms, примерно 133 раза. Составной индекс занимает больше места. Измеренная вставка с ним оказалась немного быстрее; нельзя утверждать, что эксперимент доказал замедление записи. Это локальные измерения с прогретыми данными, результаты могут меняться.
После restore сверены количества строк, 12 выбранных сообщений и checksum всех 100 тысяч сообщений нового набора. Сообщение, записанное после снимка backup, в восстановленной копии отсутствует. Это демонстрирует границу копии: более поздние записи данным backup не покрываются.
## 7. Что отвечать про интерфейс и фигуры
**На чём фронтенд?** Обычные HTML, CSS и JavaScript, без React. HTML - элементы страницы, CSS - их вид, JavaScript - поведение и запросы.
**Отдельный сервер для страницы есть?** Нет. ASP.NET Core отдаёт файлы из wwwroot и обслуживает API в том же приложении.
**Как кнопка отправляет сообщение?** Обработчик JavaScript вызывает fetch с HTTP-запросом, текстом JSON и Bearer-токеном. Ответ сервера обновляет интерфейс.
**Как появляются новые сообщения?** Клиент запрашивает их раз в 4 секунды, пока вкладка видима и открыт чат. Это polling, WebSocket нет.
**Где токен?** В памяти клиента и sessionStorage вкладки. Сервер отдельно хранит hash токена и сессию. Клиент не хранит исходный пароль после входа.
**Почему введённый HTML в сообщении не выполняется?** Текст вставляется через textContent. Он отображается как текст, а не разбирается как HTML. Это конкретная мера, не обещание полной защиты от XSS.
**Как сделаны фигуры?** Это div-элементы. border-radius скругляет прямоугольник и полукруг, clip-path задаёт треугольник. Сейчас нет SVG-тела, отдельной головы или ног.
**Как они двигаются?** JavaScript обрабатывает focus, input и наведение. requestAnimationFrame обновляет положение перед отрисовкой браузера. CSS transform перемещает, наклоняет и немного сжимает цельный силуэт. Пружинное сглаживание даёт мягкий переход к цели; восемь небольших прыжков составляют подход к полю и возврат.
**Почему реагируют на пароль?** mascots.js использует фокус, тип поля и длину пароля. Полукруг закрывает глаза, лицо прямоугольника исчезает при повороте, треугольник подсматривает. Сам текст пароля не передаётся в анимацию.
**Облачка - настоящие сообщения?** Нет, декоративные элементы. Точки и лёгкое движение сделаны CSS keyframes. Когда фигуры подходят к вводу, облачка приглушаются.
**Что показывает режим защиты?** Метод и путь запросов текущей вкладки, HTTP-код, длительность и X-Request-Id. Пароли и токены не выводятся. Подготовка демонстрации создаёт тестовые данные; сценарий проверок выполняет настоящие запросы API. Эта панель отдельно не доказывает работу SQL-индекса или backup.
## 8. Порядок показа
1. Открыть http://localhost:18080/. Показать вход, чат и отправку сообщения.
2. Открыть режим защиты, показать метод, HTTP-код и X-Request-Id.
3. При необходимости нажать «Подготовить демонстрацию», затем «Проверить типичные вопросы». Эти кнопки создают учебные записи в базе.
4. Показать три контейнера и готовность API.
5. Запустить публичный тест и проверку сохранности после перезапуска.
6. Для уровня 5 открыть RESEARCH.md и evidence/research-track2.json: два индекса, числа, восстановление и ограничения.
Команды для macOS:
```sh
cd ~/Documents/mtusi2026lab2
make up
docker compose ps
curl -i http://localhost:18080/health/ready
make test
make test-persistence
```
Перезапуск на время прерывает работу приложения. Тесты создают свои учебные данные. Не открывай новые запросы параллельно с исследованием backup.
Для заранее подготовленной полной проверки:
```sh
make verify-grade5
```
Она запускает проверки и исследование, создаёт дополнительный набор из 100 тысяч сообщений. Для обычного короткого показа достаточно открыть уже сохранённые доказательства; если преподаватель попросит повторить эксперимент, запускай research-grade5.
## 9. Как отвечать, если забыл
Формула: «Что происходит → какой компонент это делает → какой результат → где это в коде».
Пример: «На выходе сессия отзывается в PostgreSQL. Следующий запрос получает 401. Код в SessionService.RevokeAsync и AppDatabase.RevokeSessionAsync».
Если не помнишь: «Точную настройку сейчас не помню, покажу её в коде». Если не реализовано: «Сейчас такой операции нет, реализована только …». Не называй технологию, которой нет, и не обещай гарантию, которую не проверял.
Минимум для первого занятия: выучи рассказ из раздела 2, объясни путь одного сообщения, потом разбери вход и Redis. Следующим занятием - транзакция, индекс и backup. Последним - ответы про интерфейс и необычные ситуации.
+197
View File
@@ -0,0 +1,197 @@
# n1k0der: где находится мессенджер
Весь репозиторий: `/Users/nikitakamensky/Documents/mtusi2026lab2`.
Код приложения: `src/Messenger.Api/`. Код страницы: `src/Messenger.Api/wwwroot/`.
На Mac открыть проект в Finder можно так:
```sh
open ~/Documents/mtusi2026lab2
```
Сервер и страница находятся в одном ASP.NET Core проекте. База PostgreSQL и Redis запускаются отдельными контейнерами. Данные сообщений находятся в PostgreSQL, не в HTML-файле и не в папке с исходниками.
## 1. Карта папок
```text
mtusi2026lab2/
├── src/Messenger.Api/ приложение
│ ├── Program.cs запуск и подключение частей
│ ├── Endpoints/ HTTP-адреса, проверки и ответы
│ ├── Services/ операции приложения
│ ├── Data/ SQL и работа с PostgreSQL
│ │ ├── Entities/ внутренние записи базы в C#
│ │ └── Migrations/ SQL создания структуры базы
│ ├── Contracts/ формат входных/выходных данных
│ ├── Middleware/ общая обработка HTTP-запросов
│ ├── Infrastructure/ работа с Redis
│ └── wwwroot/ HTML, CSS, JavaScript страницы
├── compose.yaml API, PostgreSQL, Redis, восстановление
├── Dockerfile сборка контейнера приложения
├── Makefile короткие команды запуска и проверок
├── scripts/ перезапуск и запуск проверок
├── student-tests/ собственные тесты и исследование
├── tests/ публичные проверки преподавателя
├── contracts/ обязательный контракт задания
├── docs/ объяснения и подготовка к защите
└── evidence/ результаты проверок и исследования
```
## 2. Что открыть, если спрашивают конкретную возможность
| Вопрос | Файл | Простое объяснение |
| --- | --- | --- |
| Где запускается сервер? | [Program.cs](../src/Messenger.Api/Program.cs) | Настраивает приложение и подключает остальные части |
| Где регистрация и ограничения login/password? | [UserEndpoints.cs](../src/Messenger.Api/Endpoints/UserEndpoints.cs) | Принимает данные, проверяет их и возвращает HTTP-ответ |
| Где сохраняется новый пользователь? | [UserService.cs](../src/Messenger.Api/Services/UserService.cs) | Хеширует пароль, вызывает БД, обрабатывает занятый username |
| Где хешируется пароль? | [PasswordService.cs](../src/Messenger.Api/Services/PasswordService.cs) | Argon2id со случайной солью; Hash и Verify |
| Где вход и выход? | [AuthEndpoints.cs](../src/Messenger.Api/Endpoints/AuthEndpoints.cs) | Вход через Basic, выход через DELETE текущей сессии |
| Где токен, срок и проверка сессии? | [SessionService.cs](../src/Messenger.Api/Services/SessionService.cs) | LoginAsync, AuthenticateAsync, RevokeAsync |
| Где создание чата и проверка повторных участников? | [ChatEndpoints.cs](../src/Messenger.Api/Endpoints/ChatEndpoints.cs) | Проверяет список участников, включая повторы и создателя |
| Где отправка и история сообщений? | [MessageEndpoints.cs](../src/Messenger.Api/Endpoints/MessageEndpoints.cs) | Проверяет сессию, доступ к чату и текст сообщения |
| Где SQL, INSERT и транзакция? | [AppDatabase.cs](../src/Messenger.Api/Data/AppDatabase.cs) | Выполняет команды PostgreSQL; CreateChatAsync объединяет чат и участников |
| Где проверяется участие в чате? | [AppDatabase.cs](../src/Messenger.Api/Data/AppDatabase.cs) | FindChatForMemberAsync проверяет chat_members; endpoint использует результат |
| Где таблицы, UNIQUE и индекс? | [001_initial.sql](../src/Messenger.Api/Data/Migrations/001_initial.sql) | CREATE TABLE и CREATE INDEX |
| Где применяются миграции? | [DatabaseMigrator.cs](../src/Messenger.Api/Data/DatabaseMigrator.cs) | Выполняет новые SQL-версии и отмечает их в schema_migrations |
| Где Redis и его TTL? | [RedisSessionCache.cs](../src/Messenger.Api/Infrastructure/RedisSessionCache.cs) | Чтение, запись и удаление кэша, таймауты и fallback |
| Где страницы истории и cursor? | [CursorService.cs](../src/Messenger.Api/Services/CursorService.cs) | Кодирует/декодирует cursor; ApiSupport проверяет его и limit |
| Где ошибки 400/401? | [ApiSupport.cs](../src/Messenger.Api/Services/ApiSupport.cs) | Общие JSON-ошибки, Bearer/Basic challenge и проверки параметров |
| Где ответ 503 при отказе базы? | [ExceptionHandlingMiddleware.cs](../src/Messenger.Api/Middleware/ExceptionHandlingMiddleware.cs) | Переводит ошибки зависимости в безопасный HTTP-ответ |
| Где журнал запросов? | [RequestLoggingMiddleware.cs](../src/Messenger.Api/Middleware/RequestLoggingMiddleware.cs) | Метод, путь, статус и длительность |
| Где X-Request-Id? | [RequestIdMiddleware.cs](../src/Messenger.Api/Middleware/RequestIdMiddleware.cs) | Идентификатор для сопоставления ответа и журнала |
| Где проверка готовности? | [HealthEndpoints.cs](../src/Messenger.Api/Endpoints/HealthEndpoints.cs) | /health/live и /health/ready |
Пример ответа: «Повторных участников проверяем в ChatEndpoints.cs. Список сравнивается с Distinct. Если есть повтор, возвращаем 400. База дополнительно запрещает повтор пары chat_id/user_id».
## 3. Весь фронтенд: шесть файлов
| Файл | Что в нём |
| --- | --- |
| [index.html](../src/Messenger.Api/wwwroot/index.html) | Название n1k0der, формы входа/регистрации, кнопки, список чатов, область сообщений, окна и элементы фигур |
| [app.css](../src/Messenger.Api/wwwroot/app.css) | Цвета, размеры, расположение, мобильная версия, внешний вид фигур и CSS-анимации облачков |
| [app.js](../src/Messenger.Api/wwwroot/app.js) | Обработчики кнопок, fetch к API, токен, отображение чатов/сообщений, обновление раз в 4 секунды |
| [mascots.js](../src/Messenger.Api/wwwroot/mascots.js) | Реакции фигур на поля и пароль, прыжки к вводу и назад, наклоны, страх и сон |
| [defense.js](../src/Messenger.Api/wwwroot/defense.js) | Панель режима защиты: последние запросы, HTTP-коды, X-Request-Id, срок сессии |
| [scenarios.js](../src/Messenger.Api/wwwroot/scenarios.js) | Кнопки подготовки демонстрации и проверки типичных ошибок через реальные API-запросы |
Если просят изменить название - index.html. Цвет - app.css, переменные --accent/--paper/--ink. Движение фигуры - mascots.js. Отправку сообщения из браузера - app.js, обработчик message-form.
UiEndpoints.cs - дополнительная серверная часть для фронтенда: список участников и чтение последних сообщений с загрузкой более старых. Это C# endpoint, не файл дизайна. Обязательный API /api/v1 сохранён отдельно.
## 4. Оставшиеся серверные файлы
### Services
- ChatService.cs: операции с чатами и преобразование записей БД в ответы.
- MessageService.cs: запись/чтение сообщений и преобразование в ответы.
- UserService.cs: регистрация и публичные данные пользователей.
- SessionService.cs: создание, проверка и отзыв сессии.
- PasswordService.cs: hash/проверка пароля.
- CursorService.cs: упаковка/разбор указателя страницы.
- ApiSupport.cs: общие проверки входных данных и JSON-ошибки.
Здесь некоторые сервисы небольшие: они делегируют SQL в AppDatabase. Проверки входных данных и доступа также находятся в Endpoints.
### Contracts: какие данные принимает/возвращает API
- CreateUserRequest.cs: username, display_name, password при регистрации.
- CreateChatRequest.cs: title и member_ids при создании чата.
- CreateMessageRequest.cs: text при отправке сообщения.
- UserDto.cs: публичные данные пользователя, без hash пароля.
- ChatDto.cs: данные чата.
- MessageDto.cs: данные сообщения.
- SessionDto.cs: результат входа с токеном, сроком и пользователем.
- ChatCursor.cs: место продолжения списка чатов или истории.
DTO - объект, который отправляем клиенту. Request - объект входного запроса.
### Data/Entities: внутренние записи
- UserEntity.cs: пользователь, включая внутренний password_hash.
- ChatEntity.cs: чат и его участники в представлении C#.
- MessageEntity.cs: сообщение.
- SessionEntity.cs: пользователь и срок найденной активной сессии.
Участники хранятся в отдельной SQL-таблице chat_members; отдельный ChatMemberEntity.cs здесь не нужен и отсутствует. UtcClock.cs задаёт время UTC с точностью, подходящей PostgreSQL.
### Настройки и библиотеки
- Messenger.Api.csproj: версия .NET, библиотеки Npgsql/Argon2/Redis, включение SQL-миграций в сборку.
- appsettings.json и appsettings.Development.json: настройки приложения и журнала.
- Properties/launchSettings.json: параметры локального запуска через dotnet.
## 5. Запуск, база и проверка работы
| Файл/папка | Что сказать |
| --- | --- |
| compose.yaml | Запускает компоненты и подключает volume БД; дополнительная база восстановления включается профилем research |
| Dockerfile | Собирает C# и упаковывает приложение для запуска в контейнере |
| Makefile | Даёт команды make up, make test, make test-persistence, make verify-grade5 |
| .env | Локальный порт и срок сессии; в Git не публикуется |
| secrets/ | Локальные секреты подключения; создаются init-secrets.sh, в Git не публикуются |
| scripts/init-secrets.sh | Подготавливает секреты для запуска |
| scripts/restart.sh | Перезапускает API и хранилища с сохранением volume |
| scripts/test-expiry.sh | Проверяет короткий срок сессии |
| scripts/verify-grade4.sh и verify-grade5.sh | Запускают наборы проверок и сохраняют лог |
| tests/ | Публичные проверки лабораторной |
| student-tests/ | Дополнительные проверки этой реализации |
| evidence/ | Сохранённые результаты проверок и планы SQL |
| backups/ | Локальные резервные копии; игнорируются Git |
| REPORT.md | Описание реализации, запуск, проверки и ограничения |
| docs/RESEARCH.md | Сравнение индексов и восстановление уровня 5 |
В student-tests: lab2_tests.py - дополнительный API; grade4_tests.py - гонка регистрации, rollback и кэш; dependency_tests.py - отказы; explain_history.py - индекс на 10 тысячах сообщений; research_track2.py - 100 тысяч, два индекса, backup/restore; ui_api_tests.py - серверные маршруты для интерфейса.
## 6. Проследить одну возможность по файлам
### Отправка сообщения
```text
index.html: форма message-form
→ app.js: обработчик submit, HTTP POST через fetch
→ MessageEndpoints.cs: сессия, доступ и проверка текста
→ MessageService.cs: операция создания
→ AppDatabase.cs: CreateMessageAsync, SQL INSERT
→ PostgreSQL: таблица messages
→ ответ API
→ app.js: отображение сообщения.
```
Перед выполнением операции SessionService.AuthenticateAsync проверяет токен. Проверка участия проходит через ChatService.FindForMemberAsync и AppDatabase.FindChatForMemberAsync.
### Вход
```text
app.js: отправляет Basic
→ AuthEndpoints.cs: разбирает заголовок
→ SessionService.LoginAsync
→ AppDatabase: найти пользователя
→ PasswordService.Verify: проверить пароль
→ SessionService: создать случайный токен
→ AppDatabase: сохранить hash токена и срок
→ RedisSessionCache: попытаться заполнить кэш
→ app.js: сохранить сессию и открыть чаты.
```
### Создание чата
```text
app.js → ChatEndpoints.cs → ChatService.cs → AppDatabase.CreateChatAsync
→ одна транзакция: chats + chat_members → COMMIT.
```
### Изменение оформления
```text
Название/элементы → index.html
Цвета/размеры → app.css
Реакции фигур → mascots.js
Поведение кнопок/запросы → app.js
```
## 7. Восемь файлов, которые стоит запомнить сначала
Program.cs → запуск. index.html → страница. app.css → вид. app.js → действия клиента. MessageEndpoints.cs → сообщение приходит на сервер. SessionService.cs → проверка входа. AppDatabase.cs → SQL. 001_initial.sql → таблицы и индексы.
Рассказ на защите: «Открою путь этой операции от браузера до базы». Покажи перечисленные файлы по цепочке. Так проще объяснить связь частей, чем читать весь проект подряд.
+62
View File
@@ -0,0 +1,62 @@
# ЛР 2 - БВТ2302 - Каменский - на 5
## Лабораторная 2
**Автор / группа:** Каменский, БВТ2302.
**Целевая оценка:** 5.
**Трек:** 2 - план запроса и восстановление.
### Реализация и перенос из Lab1
C# / ASP.NET Core, PostgreSQL для пользователей, чатов, участников, сообщений и сессий. Код разделён на Endpoints, Contracts, Services, Middleware, Data/Entities/Migrations и Infrastructure. Из собственной Lab1 перенесены исходники API и подходы к валидации, логированию и курсорам. Skeleton Lab2, обязательный контракт и публичные тесты сохранены.
Пароли защищены Argon2id со случайной солью. Basic применяется при создании сессии; остальные бизнес-запросы используют opaque Bearer. В PostgreSQL хранится SHA-256 токена, срок и отзыв сессии. Redis кэширует публичные данные пользователя с TTL; проверка действительности сессии остаётся в PostgreSQL. При недоступности Redis выполняется fallback, при недоступности PostgreSQL возвращается 503.
Создание чата и участников выполняется в одной транзакции. Используются параметризованные SQL-запросы Npgsql, ограниченный пул и таймауты. История читается через keyset cursor с индексом `(chat_id, created_at, id)`.
Для уровня 5 исследованы 100 000 сообщений в чатах 80 000 / 15 000 / 4 000 / 1 000, два варианта индекса, стоимость чтения/вставки и размер. Backup восстановлен в отдельное хранилище с проверкой количеств, выбранных записей и checksum набора. Показана граница snapshot по сообщению после backup.
Дополнительно реализован веб-клиент n1k0der на HTML/CSS/JavaScript с регистрацией, входом, чатами, сообщениями, историей и режимом защиты. Он использует тот же сервер; UI не заменяет доказательства SQL/Redis/backup.
### Запуск из чистого clone
Нужны Docker Desktop с Compose, make, Python 3.9+, openssl и curl. Полная проверка OpenAPI требует requirements-dev.txt; локальная make build - .NET SDK 9. Подробности в [REPORT.md](../REPORT.md).
Команды выполнять из корня репозитория:
```sh
cp .env.example .env
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
make up
make verify-grade5
```
Порт по умолчанию 8080; при конфликте изменить API_PORT в .env. Секреты генерируются автоматически в игнорируемой папке secrets/. Именованный volume PostgreSQL сохраняется при обычном перезапуске.
### Результаты
Полная проверка выполнена 5 октября 2026 года. Интерфейс проверен сборкой и в браузере.
- [REPORT.md](../REPORT.md): архитектура, запуск, критерии и ограничения.
- [evidence/grade4-checks.txt](../evidence/grade4-checks.txt): проверки API, expiry, persistence, rollback, гонки, кэша и зависимостей.
- [evidence/grade5-checks.txt](../evidence/grade5-checks.txt): полный записанный прогон уровней 3/4/5.
- [docs/RESEARCH.md](RESEARCH.md): методика и результаты трека 2.
- [evidence/research-track2.json](../evidence/research-track2.json): планы и сверка восстановления.
### Ограничения
Один локальный хост, один основной API и PostgreSQL. HTTPS, failover и PITR не реализованы. Замеры выполнены на синтетическом наборе и прогретых buffers, не показывают предельную нагрузку. Backup покрывает snapshot, записи после него в копию не входят. Redis - восстанавливаемый кэш. Повтор POST сообщения может создать дубль. Веб-клиент использует polling раз в 4 секунды.
### Материалы
Описание реализации и сведения о помощи: [REPORT.md](../REPORT.md). Результаты исследования: [RESEARCH.md](RESEARCH.md).
- [x] Обязательный минимум сохранён с объявленным переходом на аутентификацию Lab2.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены в записанном прогоне; вывод приложен.
- [x] Сценарии отказов и безопасности воспроизведены в записанном прогоне.
- [x] .env, secrets/ и backups/ игнорируются Git; в доказательствах не публикуются токены.
- [x] README задания сохранён, REPORT.md содержит инструкцию реализации.
+92
View File
@@ -0,0 +1,92 @@
# Уровень 5 - трек 2: SQL и восстановление
Проверено: 2026-10-05T17:43:13.860337+00:00. Полные планы, отдельные измерения и manifest: [research-track2.json](../evidence/research-track2.json). Лог всех проверок: [grade5-checks.txt](../evidence/grade5-checks.txt).
## Гипотеза
Составной индекс `(chat_id, created_at, id)` ускоряет чтение упорядоченной страницы истории, особенно после глубокого cursor в большом чате. Дополнительные ключи увеличивают размер индекса и могут увеличить стоимость вставки.
## Повторяемая методика
```sh
make up
make verify-grade5
# Только исследование, если уровни 3/4 уже проверены:
make research-grade5
```
Скрипт `student-tests/research_track2.py` создаёт нового пользователя и четыре чата через API, затем вставляет SQL-командами 100 000 синтетических сообщений: 80 000 / 15 000 / 4 000 / 1 000. Тексты имеют разные размеры, время назначено на фиксированной временной шкале. Каждый запуск создаёт отдельный набор; существующие данные сохраняются.
В отдельной временной схеме создаются две таблицы с одинаковыми UUID PK, FK на пользователей/чаты и теми же 100 000 сообщениями. У первой индекс `(chat_id)`, у второй `(chat_id, created_at, id)`. Индексы рабочей таблицы API не меняются. Временная схема удаляется в finally.
Для INSERT выполняются один прогрев и три замера с чередованием порядка вариантов; перед каждым таблица очищается TRUNCATE. `EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)` измеряет серверное выполнение INSERT, включая обслуживание индексов и FK. COMMIT и HTTP в это время не входят. Для чтения - ANALYZE, один прогрев и пять измерений каждого запроса; приведена медиана `Execution Time`.
Страницы используют реальный набор колонок и keyset-условие API, ORDER BY created_at, id и LIMIT 51. Исследованы первая страница большого чата, страница после 75 000-й записи и после 500-й записи малого чата. Никакие enable_seqscan/другие настройки planner не отключаются.
Окружение PostgreSQL: `17.6 (Debian 17.6-2.pgdg13+1)`, shared_buffers `128MB`, work_mem `4MB`, fsync `on`, synchronous_commit `on`. Один локальный Docker Desktop на macOS; buffers прогреты.
## Результаты
| Чтение, медиана ms | Индекс chat_id | Составной индекс |
| --- | ---: | ---: |
| large_first | 15.970 | 0.072 |
| large_after_75000 | 8.794 | 0.066 |
| small_after_500 | 0.420 | 0.083 |
| Запись и хранение | Индекс chat_id | Составной индекс |
| --- | ---: | ---: |
| INSERT 100 000, медиана ms | 2140.540 | 2016.552 |
| Размер индекса, bytes | 671744 | 10526720 |
| Таблица с индексами, bytes | 23142400 | 32997376 |
Глубокая страница в этом прогоне ускорилась в **133.2 раза**. Изменение медианного времени INSERT составило **-5.8%**. Полные планы показывают выбранный scan, условия индекса, сортировку, фактические строки и buffer hits; данные позволяют проверить причину результата.
Составной индекс соответствует запросу API: равенство по chat_id задаёт первый ключ, пара created_at/id задаёт границу cursor и порядок. Выбранный индекс оставлен в миграции API. Число и времена локального прогона не являются универсальной характеристикой сервера; повторные измерения меняются с нагрузкой и состоянием caches.
## Backup → новое хранилище → сверка
Использован pg_dump PostgreSQL 17 в custom-формате (`-Fc --schema=public`) и pg_restore (`--no-owner --no-privileges --exit-on-error --single-transaction`). Dump включает всю public-схему приложения: пользователей, чаты, членство, сообщения, сессии и версии миграций. Во время сравнения manifest и dump другие записи API должны быть остановлены; pg_dump сам получает согласованный snapshot.
Backup: `backups/lab2-9141f49f4eb947bf.dump`, 12239941 bytes. Файл имеет права 0600; папка backups/ игнорируется Git и Docker build. Его содержимое включает password/session hashes, поэтому в Git сохраняются только обезличенные результаты проверки.
Цель - отдельный Compose-сервис postgres-restore (profile research), PostgreSQL 17.6, volume `mtusi2026lab2_restore_data`; источник использует `mtusi2026lab2_postgres_data`. Каждый запуск создаёт новую пустую БД `restored_9141f49f4eb947bf`. До восстановления public-таблиц: 0. Пустая public-схема, созданная template0, удаляется только в этой новой БД перед восстановлением schema dump.
| Таблица | В snapshot | После restore |
| --- | ---: | ---: |
| users | 191 | 191 |
| chats | 73 | 73 |
| chat_members | 125 | 125 |
| messages | 380569 | 380569 |
| sessions | 183 | 183 |
| schema_migrations | 1 | 1 |
Также совпали 12 выбранных сообщений (начало/середина/конец каждого чата) и MD5 канонического содержимого всех 100 000 сообщений исследуемого набора: `7f31b71a7f144ef51b8cebfafd4b80df`. MD5 здесь - checksum синтетического набора для сверки, password KDF остаётся Argon2id.
| Этап | Время, s |
| --- | ---: |
| pg_dump и запись файла | 1.491 |
| Запуск/ожидание контейнера восстановления | 0.736 |
| pg_restore | 2.165 |
| Сверка manifest и границы snapshot | 3.741 |
Время bootstrap при повторном запуске учитывает уже существующий контейнер; отдельная восстановленная БД всё равно новая и пустая. Это измерения отдельных этапов локального восстановления. Полный production RTO дополнительно включает обнаружение отказа, доставку backup, переключение API, проверку и эксплуатационные действия.
## Граница потери данных
После завершения dump через API подтверждено ещё одно сообщение `6e5ad2c3-e930-4aaf-a651-c9a972dac9a3`. Оно есть в источнике и отсутствует в восстановленной БД. Это показывает границу snapshot: успешные записи после снимка не входят в данный backup.
RPO определяется возрастом последнего доступного согласованного backup. Без архивирования WAL/PITR более поздние записи этим dump не восстанавливаются. В этом эксперименте показана одна такая подтверждённая запись; число потерь при реальном отказе зависит от активности и частоты backup.
## Ограничения
Один локальный хост, фиксированный набор из четырёх чатов, прогретые buffers, три замера вставки и пять чтений. Вставка SQL-пакетом отличается от одиночных HTTP-запросов; COMMIT/HTTP/Argon2 не входят в её замер. Восстановление логического dump не моделирует повреждение диска, failover или PITR. Redis - восстанавливаемый кэш; его RAM не входит в backup. API после restore в этом эксперименте не переключается: исходный стенд продолжает работать, цель проверяется SQL-сверкой.
После эксперимента контейнер восстановления можно остановить: `docker compose --profile research stop postgres-restore`. Его volume и dump остаются для защиты. Основные API/Redis/PostgreSQL продолжают работу.
## Первичные источники
- [PostgreSQL: составные индексы](https://www.postgresql.org/docs/17/indexes-multicolumn.html).
- [PostgreSQL: EXPLAIN](https://www.postgresql.org/docs/17/using-explain.html).
- [PostgreSQL: pg_dump](https://www.postgresql.org/docs/17/app-pgdump.html).
- [PostgreSQL: pg_restore](https://www.postgresql.org/docs/17/app-pgrestore.html).
- [PostgreSQL: SQL dump и snapshot](https://www.postgresql.org/docs/17/backup-dump.html).
+68
View File
@@ -0,0 +1,68 @@
Verified: 2026-10-05 16:03:17 UTC
$ make build
dotnet build src/Messenger.Api/Messenger.Api.csproj --nologo
Определение проектов для восстановления...
Все проекты обновлены для восстановления.
Messenger.Api -> /Users/nikitakamensky/Documents/mtusi2026lab2/src/Messenger.Api/bin/Debug/net9.0/Messenger.Api.dll
Сборка успешно завершена.
Предупреждений: 0
Ошибок: 0
Прошло времени 00:00:04.33
$ make check
.venv/bin/python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
$ make validate
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
$ make test
.venv/bin/python tests/smoke.py --base-url "http://localhost:18080"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
$ make student-test
.venv/bin/python student-tests/lab2_tests.py --base-url "http://localhost:18080"
PASS: Lab2 password, Basic, Bearer, input validation and session lifecycle
$ make test-expiry
BASE_URL="http://localhost:18080" PYTHON=".venv/bin/python" ./scripts/test-expiry.sh
Container mtusi2026lab2-api-1 Recreate
Container mtusi2026lab2-api-1 Recreated
Container mtusi2026lab2-api-1 Starting
Container mtusi2026lab2-api-1 Started
PASS: Lab2 password, Basic, Bearer, input validation and session lifecycle
Container mtusi2026lab2-api-1 Recreate
Container mtusi2026lab2-api-1 Recreated
Container mtusi2026lab2-api-1 Starting
Container mtusi2026lab2-api-1 Started
Container start times before persistence hook:
postgres 2026-10-05T15:56:37.702433876Z
api 2026-10-05T16:03:38.056657501Z
$ make test-persistence
.venv/bin/python tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://localhost:18080"
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
Container start times after persistence hook:
postgres 2026-10-05T16:03:41.532620919Z
api 2026-10-05T16:03:42.119589503Z
Migration count and password KDF prefix (no hashes or credentials):
migrations=1
$argon2id
$ git check-ignore .env secrets/postgres_password secrets/database_url
.env
secrets/postgres_password
secrets/database_url
$ docker compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
mtusi2026lab2-api-1 messenger-lab2:local "dotnet Messenger.Ap…" api 7 seconds ago Up 1 second (health: starting) 127.0.0.1:18080->8080/tcp
mtusi2026lab2-postgres-1 postgres:17.6 "docker-entrypoint.s…" postgres 6 days ago Up 2 seconds (healthy) 5432/tcp
+58
View File
@@ -0,0 +1,58 @@
Verified: 2026-09-29 10:59:59 UTC
$ make build
dotnet build src/Messenger.Api/Messenger.Api.csproj --nologo
Определение проектов для восстановления...
Все проекты обновлены для восстановления.
Messenger.Api -> /Users/nikitakamensky/Documents/mtusi2026lab2/src/Messenger.Api/bin/Debug/net9.0/Messenger.Api.dll
Сборка успешно завершена.
Предупреждений: 0
Ошибок: 0
Прошло времени 00:00:02.36
$ make check
python3 scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
$ make validate PYTHON=.venv/bin/python
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
$ make test BASE_URL=http://localhost:18080
python3 tests/smoke.py --base-url "http://localhost:18080"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
$ make student-test BASE_URL=http://localhost:18080
python3 student-tests/lab2_tests.py --base-url "http://localhost:18080"
PASS: Lab2 password, Basic, Bearer, input validation and session lifecycle
$ make test-expiry BASE_URL=http://localhost:18080
BASE_URL="http://localhost:18080" PYTHON="python3" ./scripts/test-expiry.sh
Container mtusi2026lab2-api-1 Recreate
Container mtusi2026lab2-api-1 Recreated
Container mtusi2026lab2-api-1 Starting
Container mtusi2026lab2-api-1 Started
PASS: Lab2 password, Basic, Bearer, input validation and session lifecycle
Container mtusi2026lab2-api-1 Recreate
Container mtusi2026lab2-api-1 Recreated
Container mtusi2026lab2-api-1 Starting
Container mtusi2026lab2-api-1 Started
Container start times before persistence hook:
postgres 2026-09-29T10:57:17.514431375Z
api 2026-09-29T11:00:11.981683054Z
$ make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:18080
python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://localhost:18080"
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
Container start times after persistence hook:
postgres 2026-09-29T11:00:13.851495055Z
api 2026-09-29T11:00:14.208942221Z
Migration count and password KDF prefix (no hashes or credentials):
migrations=1
$argon2id
+26
View File
@@ -0,0 +1,26 @@
Verified: 2026-10-06 10:26:33 UTC
$ make build
dotnet build src/Messenger.Api/Messenger.Api.csproj --nologo
Определение проектов для восстановления...
Все проекты обновлены для восстановления.
Messenger.Api -> /Users/nikitakamensky/Documents/mtusi2026lab2/src/Messenger.Api/bin/Debug/net9.0/Messenger.Api.dll
Сборка успешно завершена.
Предупреждений: 0
Ошибок: 0
Прошло времени 00:00:08.20
$ make check
.venv/bin/python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
$ make validate
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
$ make test
.venv/bin/python tests/smoke.py --base-url "http://localhost:18080"
FAIL: GET /health/live: connection/TLS failure (URLError)
make[2]: *** [test] Error 1
+34
View File
@@ -0,0 +1,34 @@
Verified: 2026-10-06 10:26:33 UTC
$ make verify-grade4
BASE_URL="http://localhost:18080" PYTHON=".venv/bin/python" ./scripts/verify-grade4.sh
Running: make build
Running: make check
Running: make validate
Running: make test
$ make build
dotnet build src/Messenger.Api/Messenger.Api.csproj --nologo
Определение проектов для восстановления...
Все проекты обновлены для восстановления.
Messenger.Api -> /Users/nikitakamensky/Documents/mtusi2026lab2/src/Messenger.Api/bin/Debug/net9.0/Messenger.Api.dll
Сборка успешно завершена.
Предупреждений: 0
Ошибок: 0
Прошло времени 00:00:08.20
$ make check
.venv/bin/python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
$ make validate
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
$ make test
.venv/bin/python tests/smoke.py --base-url "http://localhost:18080"
FAIL: GET /health/live: connection/TLS failure (URLError)
make[2]: *** [test] Error 1
make[1]: *** [verify-grade4] Error 1
+163
View File
@@ -0,0 +1,163 @@
{
"verified_at": "2026-10-05T17:42:04.803527+00:00",
"message_count_in_chat": 10000,
"fixture": "synthetic data; no tokens or passwords in evidence",
"plans": {
"first_page": {
"query": "SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = '8a4f99db-6858-45e8-a2f6-a86c9194d89b' ORDER BY created_at, id LIMIT 51",
"explain_analyze_buffers": {
"Plan": {
"Node Type": "Limit",
"Parallel Aware": false,
"Async Capable": false,
"Startup Cost": 0.42,
"Total Cost": 115.29,
"Plan Rows": 51,
"Plan Width": 151,
"Actual Startup Time": 0.018,
"Actual Total Time": 0.051,
"Actual Rows": 51,
"Actual Loops": 1,
"Shared Hit Blocks": 6,
"Shared Read Blocks": 0,
"Shared Dirtied Blocks": 0,
"Shared Written Blocks": 0,
"Local Hit Blocks": 0,
"Local Read Blocks": 0,
"Local Dirtied Blocks": 0,
"Local Written Blocks": 0,
"Temp Read Blocks": 0,
"Temp Written Blocks": 0,
"Plans": [
{
"Node Type": "Index Scan",
"Parent Relationship": "Outer",
"Parallel Aware": false,
"Async Capable": false,
"Scan Direction": "Forward",
"Index Name": "messages_chat_created_id_idx",
"Relation Name": "messages",
"Alias": "messages",
"Startup Cost": 0.42,
"Total Cost": 22349.08,
"Plan Rows": 9923,
"Plan Width": 151,
"Actual Startup Time": 0.017,
"Actual Total Time": 0.044,
"Actual Rows": 51,
"Actual Loops": 1,
"Index Cond": "(chat_id = '8a4f99db-6858-45e8-a2f6-a86c9194d89b'::uuid)",
"Rows Removed by Index Recheck": 0,
"Shared Hit Blocks": 6,
"Shared Read Blocks": 0,
"Shared Dirtied Blocks": 0,
"Shared Written Blocks": 0,
"Local Hit Blocks": 0,
"Local Read Blocks": 0,
"Local Dirtied Blocks": 0,
"Local Written Blocks": 0,
"Temp Read Blocks": 0,
"Temp Written Blocks": 0
}
]
},
"Planning": {
"Shared Hit Blocks": 109,
"Shared Read Blocks": 0,
"Shared Dirtied Blocks": 0,
"Shared Written Blocks": 0,
"Local Hit Blocks": 0,
"Local Read Blocks": 0,
"Local Dirtied Blocks": 0,
"Local Written Blocks": 0,
"Temp Read Blocks": 0,
"Temp Written Blocks": 0
},
"Planning Time": 0.219,
"Triggers": [],
"Execution Time": 0.082
}
},
"after_message_9000": {
"query": "SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = '8a4f99db-6858-45e8-a2f6-a86c9194d89b' AND (created_at, id) > ('2026-01-01T00:00:09.000000Z'::timestamptz, 'a0fd947d-f261-da1c-181d-6e19f2e18f68'::uuid) ORDER BY created_at, id LIMIT 51",
"explain_analyze_buffers": {
"Plan": {
"Node Type": "Limit",
"Parallel Aware": false,
"Async Capable": false,
"Startup Cost": 0.42,
"Total Cost": 140.46,
"Plan Rows": 51,
"Plan Width": 151,
"Actual Startup Time": 0.018,
"Actual Total Time": 0.029,
"Actual Rows": 51,
"Actual Loops": 1,
"Shared Hit Blocks": 5,
"Shared Read Blocks": 0,
"Shared Dirtied Blocks": 0,
"Shared Written Blocks": 0,
"Local Hit Blocks": 0,
"Local Read Blocks": 0,
"Local Dirtied Blocks": 0,
"Local Written Blocks": 0,
"Temp Read Blocks": 0,
"Temp Written Blocks": 0,
"Plans": [
{
"Node Type": "Index Scan",
"Parent Relationship": "Outer",
"Parallel Aware": false,
"Async Capable": false,
"Scan Direction": "Forward",
"Index Name": "messages_chat_created_id_idx",
"Relation Name": "messages",
"Alias": "messages",
"Startup Cost": 0.42,
"Total Cost": 15882.85,
"Plan Rows": 5784,
"Plan Width": 151,
"Actual Startup Time": 0.017,
"Actual Total Time": 0.022,
"Actual Rows": 51,
"Actual Loops": 1,
"Index Cond": "((chat_id = '8a4f99db-6858-45e8-a2f6-a86c9194d89b'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:09+00'::timestamp with time zone, 'a0fd947d-f261-da1c-181d-6e19f2e18f68'::uuid)))",
"Rows Removed by Index Recheck": 0,
"Shared Hit Blocks": 5,
"Shared Read Blocks": 0,
"Shared Dirtied Blocks": 0,
"Shared Written Blocks": 0,
"Local Hit Blocks": 0,
"Local Read Blocks": 0,
"Local Dirtied Blocks": 0,
"Local Written Blocks": 0,
"Temp Read Blocks": 0,
"Temp Written Blocks": 0
}
]
},
"Planning": {
"Shared Hit Blocks": 106,
"Shared Read Blocks": 0,
"Shared Dirtied Blocks": 0,
"Shared Written Blocks": 0,
"Local Hit Blocks": 0,
"Local Read Blocks": 0,
"Local Dirtied Blocks": 0,
"Local Written Blocks": 0,
"Temp Read Blocks": 0,
"Temp Written Blocks": 0
},
"Planning Time": 0.196,
"Triggers": [],
"Execution Time": 0.053
}
}
},
"api_pages": {
"first": 50,
"deep": 50,
"continuation": 50,
"duplicates": 0
}
}
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,16 @@
UI refinement verification - 2026-10-06
Build: make up succeeded; API, PostgreSQL and Redis healthy.
Syntax: app.js, mascots.js, scenarios.js checked as ES modules.
Desktop registration: mascot names/caption absent (DOM count 0); one short registration joke.
Username input: mood looking.
Private password: mood private; triangle animation mascot-peek-arc.
Observed triangle transform changed from baseline x=0,y=0 to x=21.238,y=-29.024 (up and sideways).
Shown password: mood revealed; animation mascot-retreat; triangle face opacity 0.
Mobile viewport 390x844: document clientWidth=scrollWidth=375; no horizontal overflow.
Mobile password view: stage and triangle visible; animation mascot-peek-arc.
Defense panel: compact scenario description; explanatory footer collapsed under О проверках.
Browser Uncaught errors: none on main and registration tabs.
Viewport reset; login restored; main UI shows @n1k0der and existing 5 chats.
Existing demo data preserved; scenario request logic unchanged in this refinement.
Reduced-motion CSS disables new animations with !important; not runtime-emulated.
+15
View File
@@ -0,0 +1,15 @@
Verified: 2026-10-05T21:06:13.536358+00:00
Scope: CSS theme and HTML metadata/heading spacing.
Build: make up passed; dotnet publish Release passed; API/PostgreSQL/Redis healthy.
Browser: real localhost UI, CUA, desktop 1280x720 and mobile 390x844.
Computed root background: rgb(38,38,38) = #262626.
Computed root text: rgb(255,225,53) = #FFE135.
Desktop: demo login passed; 3 chats loaded; team chat loaded 4 messages.
Profile and new-chat dialogs opened/closed; themed inputs and visible focus verified.
Defense panel: desktop side layout and mobile overlay checked; GET 200/Bearer and history count visible.
Composer: nonempty draft enables send; cleared without submission.
Mobile: sidebar and conversation width 390, document width 390; composer bottom 844.
Mobile auth/register: width 375 (390 viewport minus scrollbar), document width 375; headings no longer join words.
Viewport restored: document width 1280, content width 1280.
Contrast ratios: primary 11.58:1, muted on #303030 6.40:1, own timestamp on yellow 5.91:1.
Evidence: ui-anthracite-desktop.jpg, ui-anthracite-mobile.jpg, ui-anthracite-login.jpg, ui-anthracite-defense.jpg.
Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

+21
View File
@@ -0,0 +1,21 @@
Verified: 2026-10-05, local http://localhost:18080/, browser
All accounts and messages used for this check are synthetic demo data.
PASS: registration and automatic login for two separate users
PASS: profile exposes participant ID; shared chat created with that ID
PASS: messages sent by both users, displayed with author names and server timestamps
PASS: Enter submits a message; textarea is cleared after confirmed response
PASS: reload resumes the stored session and reloads the actor's chat list
PASS: logout returns to login form; incorrect password displays the credentials error
PASS: subsequent correct password opens the application
PASS: personal notes chat is created with no extra participant IDs
PASS: literal <b> text is displayed unchanged, with no b element in message content
PASS: notes history opens with 50 messages and loads the remaining 11; total DOM messages 61
PASS: 390 x 844 mobile view displays chat list, conversation and composer
PASS: mobile back button returns to chat list
PASS: mobile document clientWidth=390 and scrollWidth=390
PASS: temporary viewport override reset; final desktop view 818 x 668
Screenshots: ui-desktop.jpg, ui-mobile.jpg
HTTP/API pagination and privacy are separately checked by make test-ui.
These are manual UI observations, not an automated browser suite.
Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

+402
View File
@@ -0,0 +1,402 @@
[
{
"class": "mascot-stage is-sleepy",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "idle",
"scrollWidth": 1265,
"trip": "home",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "looking",
"scrollWidth": 1265,
"trip": "near",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "private",
"scrollWidth": 1265,
"trip": "near",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "private",
"scrollWidth": 1265,
"trip": "near",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "revealed",
"scrollWidth": 1265,
"trip": "near",
"width": 1265
},
{
"class": "mascot-stage is-scared",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "idle",
"scrollWidth": 1265,
"trip": "back",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "idle",
"scrollWidth": 1265,
"trip": "home",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "short",
"scrollWidth": 1265,
"trip": "back",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "pending",
"scrollWidth": 1265,
"trip": "back",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 4.96,
"rotate": "none"
}
],
"mood": "private",
"scrollWidth": 375,
"trip": "near",
"width": 375
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 4.96,
"rotate": "none"
}
],
"mood": "private",
"scrollWidth": 305,
"trip": "near",
"width": 305
},
{
"class": "mascot-stage is-sleepy",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
}
],
"mood": "idle",
"scrollWidth": 1265,
"trip": "home",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 1,
"rotate": "none"
}
],
"mood": "private",
"scrollWidth": 1265,
"trip": "near",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 8,
"rotate": "none"
},
{
"connected": true,
"gap": 1,
"rotate": "none"
}
],
"mood": "revealed",
"scrollWidth": 1265,
"trip": "near",
"width": 1265
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 0.62,
"rotate": "none"
}
],
"mood": "private",
"scrollWidth": 305,
"trip": "near",
"width": 305
},
{
"class": "mascot-stage",
"feet": 0,
"joints": [
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 4.96,
"rotate": "none"
},
{
"connected": true,
"gap": 0.62,
"rotate": "none"
}
],
"mood": "private",
"scrollWidth": 305,
"trip": "near",
"width": 305
}
]
+11
View File
@@ -0,0 +1,11 @@
Проверка фигур после исправления соединений и ширины тела
Ширина SVG тела равна ширине головы: квадрат 64 px, полукруг 74 px, треугольник 76 px.
Ноги и нижние площадки удалены.
Проверены соединения головы с телом: покой, ввод, скрытый и открытый пароль, страх, возврат, ожидание входа, короткий пароль регистрации.
После изменения ширины повторно проверены скрытый/открытый пароль на компьютере и скрытый пароль на узком мобильном экране. Все три соединения сохраняются; горизонтального переполнения нет.
Короткий пароль регистрации отклонён интерфейсом; неверный логин возвращает обычное сообщение об ошибке. Тестовые аккаунты не создавались.
make up выполнен успешно, контейнеры здоровы. Проверка синтаксиса mascots.js и git diff --check прошли.
Uncaught ошибок JavaScript в обеих проверочных вкладках нет.
Основная вкладка возвращена в аккаунт n1k0der: загружены 5 существующих чатов. Временный размер окна сброшен.
Режим уменьшенного движения проверен по исходникам, без эмуляции системной настройки.
Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

+5
View File
@@ -0,0 +1,5 @@
Декоративная композиция авторизации
Фигуры собраны ближе: настольные позиции 24/82/154 px, на телефоне группа центрируется по ширине блока. Два облачка позади фигур, три анимированные точки в жёлтом облачке. При подходе к форме облачка приглушаются.
Проверены настольный покой, подход к полю, скрытый и открытый пароль. На мобильном экране 320 px (clientWidth 305) горизонтального переполнения нет: scrollWidth 305. Скриншоты сохранены. Uncaught ошибок нет.
make up, проверка синтаксиса JavaScript и git diff --check прошли. Временный размер окна сброшен.
Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

+23
View File
@@ -0,0 +1,23 @@
Verified: 2026-10-05, local http://localhost:18080/, browser
Accounts and messages used in this check are synthetic demo data.
PASS: panel is hidden by default and opens from login screen/chat sidebar
PASS: wrong password shows actual POST /api/v1/auth/sessions -> 401 and Basic
PASS: successful login shows 201/Basic, actor and session countdown
PASS: opening chat shows GET 200/Bearer and received X-Request-Id
PASS: sending a message shows POST 201/Bearer and visible confirmed message
PASS: a later background read at 23:50:04 does not replace the send result at 23:49:38
PASS: panel displays loaded history 50 with older page available, then 61 with no older page
PASS: nonexistent participant produces 400 and the matching panel explanation
PASS: logout displays DELETE 204 and clears actor/session/history summary
PASS: Escape closes panel; disabled preference survives reload
PASS: reload resumes a valid session
PASS: visible panel contains no demo password or 43-character token-like leaf text
PASS: wide desktop layout places panel beside chat; form remains usable
PASS: 390 x 844 mobile chat can open/close panel and return to chat list
PASS: mobile document clientWidth=390 and scrollWidth=390
PASS: viewport override reset before completion
Screenshots: ui-defense-desktop.jpg (confirmed send), ui-defense-mobile.jpg
Panel records selected metadata of this tab only; no request/response bodies or full headers.
These are manual UI observations, not an automated browser suite.
+7
View File
@@ -0,0 +1,7 @@
Verified: 2026-10-05 20:52:52 UTC
.venv/bin/python tests/smoke.py --base-url "http://localhost:18080"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
.venv/bin/python student-tests/lab2_tests.py --base-url "http://localhost:18080"
PASS: Lab2 password, Basic, Bearer, input validation and session lifecycle
.venv/bin/python student-tests/ui_api_tests.py --base-url "http://localhost:18080"
PASS: UI authentication, privacy, newest page, backwards pagination, cursor isolation; required API stays ascending
Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

+17
View File
@@ -0,0 +1,17 @@
Elastic mascot verification - 2026-10-06
Build: make up succeeded; API, PostgreSQL and Redis healthy.
Syntax: mascots.js ES module check passed.
Desktop username input: mood looking; SVG outlines changed for all three shapes.
Top outline coordinates rose above y=0; settled wrapper translations were x=4,y=0 for all three.
At typing onset observed staggered wrapper positions: (9.49,-6.79), (7.49,-4.39), (5.6,-2.11).
Actual pointer entering the close button: is-scared true; panel remained visible.
Scared wrapper positions sampled: (-3.67,0), (-2.93,0), (-2.21,0).
Pointer moved away: is-scared absent. Keyboard focus also triggers the reaction.
Auth defense panel moved to the right so shapes remain visible.
Mobile viewport 390x844: document clientWidth=scrollWidth=375; no horizontal overflow.
Mobile outlines deform; stage is 150px and remains visible with the password field.
Shown password: mood revealed; triangle face settles to opacity 0.
Uncaught browser errors: none in main and auxiliary registration tabs.
Reduced motion / hidden-tab handling inspected in source; reduced motion was not runtime-emulated.
Login after success animation verified; main view restored to @n1k0der with 5 existing chats. Viewport reset; auxiliary tab closed.
Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

+11
View File
@@ -0,0 +1,11 @@
Verified: 2026-10-05T21:09:30.542235+00:00
Build: make up passed, API/PostgreSQL/Redis healthy.
Copy: humorous lab-themed login, registration, hero, empty-state, chat dialog and toast text.
Credentials: existing local demo account renamed to n1k0der; Argon2id password hash updated for a 12-character password.
Data: same user UUID; 3 memberships and 63 authored messages preserved.
API: correct login 201; former 6-character password rejected 401; temporary API verification session revoked 204.
Policy: backend and browser registration remain 12-128 code points; no validation exception added.
Tests: make student-test passed (password, Basic, Bearer, input validation, session lifecycle).
Browser: login succeeded with new credentials; same 3 chats visible; profile username @n1k0der.
Browser: desktop registration screenshot saved; mobile registration content width equals viewport minus scrollbar (375px), no horizontal overflow.
Screenshot: ui-humor-registration.jpg.
Binary file not shown.

After

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

+24
View File
@@ -0,0 +1,24 @@
Verified: 2026-10-06T00:32:42.399572+03:00
Build: make up passed; dotnet publish Release; API/PostgreSQL/Redis healthy.
Syntax: node --input-type=module --check passed for app.js, defense.js, mascots.js, scenarios.js.
Browser: real local UI, CUA; desktop 1280x720, mobile 390x844.
Mascots: cursor gaze changed (1.05px, -3px); username focus=looking; short password=short; valid masked password=private; shown password=revealed.
Mobile mascot stage sticks at top 0; content width equals viewport minus scrollbar (375px); no horizontal overflow.
Duplicate registration returned conflict; login succeeded with the existing primary account; show/hide password checked.
Scenario buttons disabled without login; check button disabled before preparation; both disabled while scenario runs.
Preparation: 2 users, 2 test logins, shared chat with primary user, 3 messages; test sessions revoked.
Question checks: duplicate username 409; wrong password 401; short password 400; whitespace-only message 400; duplicate member 400; outsider chat 404; test logout 204; revoked token 401.
All eight matched; 11 logged HTTP steps including two logins and final cleanup, all passed.
Repeat-open: same chat and messages, 11 previous step records retained.
Primary profile remains @n1k0der; foreground and background interface reads continue with HTTP 200.
Panel contains neither generated password prefix nor token-shaped strings; uncaught JavaScript errors=0.
Mobile scenarios: document width=390, content width=390, composer bottom=844; both scenario buttons visible.
PostgreSQL after question checks and repeat-open:
demo_users=2
active_demo_sessions=0
demo_chats=1
messages=3
members=2
observer_memberships=0
Screenshots: ui-mascots-registration.jpg, ui-mascots-password.jpg, ui-mascots-mobile.jpg, ui-scenarios-desktop.jpg, ui-scenarios-mobile.jpg.
Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 85 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

+7
View File
@@ -0,0 +1,7 @@
Цельные фигуры после удаления вытягивающегося тела
По прежнему скриншоту восстановлены разные размеры: жёлтая фигура 84×150 px, полукруг 104×112 px, треугольник 84×110 px.
Проверены покой и подход к полю на компьютере, скрытый и открытый пароль. Дополнительные SVG-тела, головы, ноги и основания отсутствуют. Uncaught ошибок JavaScript нет.
Мобильный вариант 390 px проверен перед финальным восстановлением исходных размеров: горизонтального переполнения нет. Последние размеры повторно проверены на компьютере.
make up, проверка синтаксиса JavaScript и git diff --check прошли.
Основная вкладка обновлена: вход n1k0der сохранился, 5 чатов загружены.
Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

+2
View File
@@ -0,0 +1,2 @@
Прямоугольник сужен с 84 до 64 px при высоте 150 px, радиус углов 16 px. Полукруг изменён с 104×112 до 82×102 px, верхние углы 44 px, нижние 16 px. Глаза и закрывающая их ладонь подогнаны под новую ширину.
Проверены покой, подход к полю, скрытый/открытый пароль. Uncaught ошибок нет. make up, проверка синтаксиса JS и git diff --check прошли.
Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

+22
View File
@@ -0,0 +1,22 @@
Walking mascots verification - 2026-10-06
Build: make up succeeded; API, PostgreSQL and Redis healthy.
Syntax: mascots.js ES module check passed.
Structure: three heads, three thick SVG necks, three bases and six feet.
Computed neck stroke widths: 38px, 40px, 32px.
Desktop trip observed: forward -> near -> back -> home.
Journey uses eight eased steps in each direction with 80ms staggering.
Near-field head dimensions remain 64x64, 74x58, 76x70; computed rotate=none.
Observed head rises: approximately 66px, 69px and 79px beyond their resting neck lengths.
Nearest head right edge 770.82px; input left edge 784.30px (~13.5px gap).
Backward jumping observed at different offsets for each figure; after pause trip returns home.
Mobile viewport 390x844: clientWidth=scrollWidth=375; no horizontal overflow.
Mobile head rectangles remain inside the sticky stage; movement fans within the stage.
Shown password: mood revealed; triangle face opacity settles to 0; head moves behind the round figure.
Close button keyboard interaction: is-scared class present; clears after closing.
Idle state observed: trip=home, mood=idle, is-sleepy class present.
Reduced motion / hidden-screen reset inspected in source; reduced motion was not runtime-emulated.
Typing wakes the figures: is-sleepy class removed.
Uncaught browser errors: none in main and auxiliary tabs.
One sign-in attempt timed out; retry succeeded with HTTP 201 (8171ms), then chats loaded with HTTP 200.
Main UI restored to @n1k0der with existing five chats; viewport reset and auxiliary tab closed.
Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

+19
View File
@@ -0,0 +1,19 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
umask 077
mkdir -p secrets
if [ -e secrets/postgres_password ] || [ -e secrets/database_url ]; then
if [ ! -s secrets/postgres_password ] || [ ! -s secrets/database_url ]; then
printf '%s\n' 'Incomplete secrets directory; repair it manually without replacing an existing database password.' >&2
exit 1
fi
exit 0
fi
password="$(openssl rand -hex 24)"
printf '%s' "$password" > secrets/postgres_password
printf 'Host=postgres;Port=5432;Database=messenger;Username=messenger;Password=%s' "$password" > secrets/database_url
printf '%s\n' 'Created local database secrets in ignored secrets/ directory.'
+17
View File
@@ -0,0 +1,17 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
docker compose restart postgres redis >/dev/null
attempt=0
until docker compose exec -T postgres pg_isready -U messenger -d messenger >/dev/null 2>&1; do
attempt=$((attempt + 1))
if [ "$attempt" -ge 60 ]; then
printf '%s\n' 'PostgreSQL did not become ready after restart.' >&2
exit 1
fi
sleep 1
done
docker compose restart api >/dev/null
+25
View File
@@ -0,0 +1,25 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
base_url="${BASE_URL:-http://localhost:8080}"
python="${PYTHON:-python3}"
restore() {
docker compose up -d --no-deps --force-recreate api >/dev/null
}
trap restore EXIT
SESSION_TTL_SECONDS=2 docker compose up -d --no-deps --force-recreate api >/dev/null
attempt=0
until curl --fail --silent "$base_url/health/ready" >/dev/null; do
attempt=$((attempt + 1))
if [ "$attempt" -ge 30 ]; then
printf '%s\n' 'API did not become ready for expiry test.' >&2
exit 1
fi
sleep 1
done
"$python" student-tests/lab2_tests.py --base-url "$base_url" --check-expiry
+32
View File
@@ -0,0 +1,32 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
mkdir -p evidence
exec 3>&1
exec > evidence/grade4-checks.txt 2>&1
date -u '+Verified: %Y-%m-%d %H:%M:%S UTC'
for target in build check validate test student-test test-ui test-grade4 explain-history test-dependencies test-expiry; do
printf '\n$ make %s\n' "$target"
printf 'Running: make %s\n' "$target" >&3
if ! make "$target"; then
tail -n 25 evidence/grade4-checks.txt >&3
exit 1
fi
done
printf '\nContainer start times before persistence hook:\n'
for service in postgres redis api; do
docker inspect "$(docker compose ps -q "$service")" --format "$service {{.State.StartedAt}}"
done
printf '\n$ make test-persistence\n'
make test-persistence
printf '\nContainer start times after persistence hook:\n'
for service in postgres redis api; do
docker inspect "$(docker compose ps -q "$service")" --format "$service {{.State.StartedAt}}"
done
printf '\nPostgreSQL migrations and password KDF (no hashes/credentials):\n'
docker compose exec -T postgres psql -X -U messenger -d messenger -Atc "SELECT 'migrations=' || count(*) FROM schema_migrations; SELECT DISTINCT left(password_hash, 9) FROM users;"
printf '\n$ git check-ignore .env secrets/postgres_password secrets/database_url\n'
git check-ignore .env secrets/postgres_password secrets/database_url
printf '\nPASS: all required local grade 4 checks completed\n'
+19
View File
@@ -0,0 +1,19 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
mkdir -p evidence
exec 3>&1
exec > evidence/grade5-checks.txt 2>&1
date -u '+Verified: %Y-%m-%d %H:%M:%S UTC'
for target in verify-grade4 research-grade5; do
printf '\n$ make %s\n' "$target"
printf 'Running: make %s (details in evidence/grade5-checks.txt)\n' "$target" >&3
if make "$target"; then
printf 'PASS: make %s\n' "$target" >&3
else
tail -n 30 evidence/grade5-checks.txt >&3
exit 1
fi
done
printf '\nPASS: all required local grade 5 checks completed\n'
printf 'PASS: grade 5; evidence/grade5-checks.txt and evidence/research-track2.json\n' >&3
@@ -0,0 +1,7 @@
namespace Messenger.Api.Contracts;
public sealed record ChatCursor(
string Scope,
string CreatedAt,
Guid Id
);
+3
View File
@@ -0,0 +1,3 @@
namespace Messenger.Api.Contracts;
public sealed record ChatDto(Guid Id, string Title, List<Guid> MemberIds, string CreatedAt);
@@ -0,0 +1,6 @@
namespace Messenger.Api.Contracts;
public sealed record CreateChatRequest(
string? Title,
List<Guid>? MemberIds
);
@@ -0,0 +1,5 @@
namespace Messenger.Api.Contracts;
public sealed record CreateMessageRequest(
string? Text
);
@@ -0,0 +1,7 @@
namespace Messenger.Api.Contracts;
public sealed record CreateUserRequest(
string? Username,
string? DisplayName,
string? Password
);
@@ -0,0 +1,3 @@
namespace Messenger.Api.Contracts;
public sealed record MessageDto(Guid Id, Guid ChatId, Guid SenderId, string Text, string CreatedAt);
@@ -0,0 +1,3 @@
namespace Messenger.Api.Contracts;
public sealed record SessionDto(string Token, string TokenType, string ExpiresAt, UserDto User);
+3
View File
@@ -0,0 +1,3 @@
namespace Messenger.Api.Contracts;
public sealed record UserDto(Guid Id, string Username, string DisplayName, string CreatedAt);
@@ -0,0 +1,60 @@
using System.Text;
using System.Text.RegularExpressions;
using Messenger.Api.Services;
using static Messenger.Api.Services.ApiSupport;
namespace Messenger.Api.Endpoints;
public static class AuthEndpoints
{
private static readonly UTF8Encoding StrictUtf8 = new(false, true);
public static IEndpointRouteBuilder MapAuthEndpoints(this IEndpointRouteBuilder app)
{
app.MapPost("/api/v1/auth/sessions", async (HttpContext context, SessionService sessions) =>
{
if (!context.Request.Headers.TryGetValue("Authorization", out var header))
return Unauthorized(context, basic: true);
var authorization = header.ToString();
if (!authorization.StartsWith("Basic ", StringComparison.OrdinalIgnoreCase))
return Unauthorized(context, basic: true);
string credentials;
try
{
credentials = StrictUtf8.GetString(Convert.FromBase64String(authorization[6..]));
}
catch (Exception exception) when (exception is FormatException or DecoderFallbackException)
{
return Unauthorized(context, basic: true);
}
var delimiter = credentials.IndexOf(':');
if (delimiter < 0) return Unauthorized(context, basic: true);
var username = credentials[..delimiter];
var password = credentials[(delimiter + 1)..];
if (!Regex.IsMatch(username, "\\A[a-z0-9_]{3,32}\\z"))
return Unauthorized(context, basic: true);
if (context.Request.ContentLength > 0 || context.Request.Headers.ContainsKey("Transfer-Encoding"))
return ApiError(context, 400, "invalid_request", "Вход принимает Basic без тела запроса");
var session = await sessions.LoginAsync(username, password);
return session is null
? Unauthorized(context, basic: true)
: Results.Json(session, statusCode: StatusCodes.Status201Created);
});
app.MapDelete("/api/v1/auth/sessions/current", async (HttpContext context, SessionService sessions) =>
{
var (user, tokenHash) = await sessions.AuthenticateAsync(context);
if (user is null || tokenHash is null) return Unauthorized(context);
return await sessions.RevokeAsync(tokenHash)
? Results.NoContent()
: Unauthorized(context);
});
return app;
}
}
@@ -0,0 +1,67 @@
using Messenger.Api.Contracts;
using Messenger.Api.Services;
using static Messenger.Api.Services.ApiSupport;
namespace Messenger.Api.Endpoints;
public static class ChatEndpoints
{
public static IEndpointRouteBuilder MapChatEndpoints(this IEndpointRouteBuilder app)
{
app.MapPost("/api/v1/chats", async (HttpContext context, SessionService sessions, ChatService chats) =>
{
var (actor, _) = await sessions.AuthenticateAsync(context);
if (actor is null) return Unauthorized(context);
var (request, error) = await ReadJsonAsync<CreateChatRequest>(context);
if (error is not null) return error;
if (string.IsNullOrWhiteSpace(request!.Title) || request.Title.EnumerateRunes().Count() > 100)
return ApiError(context, 400, "invalid_request", "Некорректное название чата");
if (request.MemberIds is null || request.MemberIds.Count is < 1 or > 100 ||
request.MemberIds.Distinct().Count() != request.MemberIds.Count ||
!request.MemberIds.Contains(actor.Id))
return ApiError(context, 400, "invalid_request", "Некорректный список участников");
var chat = await chats.CreateAsync(request.Title, request.MemberIds);
return chat is null
? ApiError(context, 400, "invalid_request", "Один из участников не существует")
: Results.Json(chat, statusCode: StatusCodes.Status201Created);
});
app.MapGet("/api/v1/chats", async (HttpContext context, SessionService sessions, ChatService chats) =>
{
var (actor, _) = await sessions.AuthenticateAsync(context);
if (actor is null) return Unauthorized(context);
var (limit, limitError) = ParseLimit(context);
if (limitError is not null) return limitError;
var (cursor, cursorTime, cursorError) = ParseCursor(context, $"user:{actor.Id}");
if (cursorError is not null) return cursorError;
var page = await chats.ListAsync(actor.Id, cursorTime, cursor?.Id, limit + 1);
string? nextCursor = null;
if (page.Count > limit)
{
var last = page[limit - 1];
nextCursor = CursorService.EncodeChatCursor(new ChatCursor($"user:{actor.Id}", last.CreatedAt, last.Id));
page = page.Take(limit).ToList();
}
return Results.Ok(new { items = page, next_cursor = nextCursor });
});
app.MapGet("/api/v1/chats/{chat_id}", async (
string chat_id, HttpContext context, SessionService sessions, ChatService chats) =>
{
var (actor, _) = await sessions.AuthenticateAsync(context);
if (actor is null) return Unauthorized(context);
if (!Guid.TryParse(chat_id, out var chatId))
return ApiError(context, 400, "invalid_request", "Некорректный chat_id");
var chat = await chats.FindForMemberAsync(chatId, actor.Id);
return chat is null
? ApiError(context, 404, "not_found", "Чат не найден")
: Results.Ok(chat);
});
return app;
}
}
@@ -0,0 +1,17 @@
using Messenger.Api.Data;
using Messenger.Api.Services;
namespace Messenger.Api.Endpoints;
public static class HealthEndpoints
{
public static IEndpointRouteBuilder MapHealthEndpoints(this IEndpointRouteBuilder app)
{
app.MapGet("/health/live", () => Results.Ok(new { status = "ok" }));
app.MapGet("/health/ready", async (HttpContext context, AppDatabase database) =>
await database.IsReadyAsync()
? Results.Ok(new { status = "ok" })
: ApiSupport.ApiError(context, 503, "unavailable", "База данных недоступна"));
return app;
}
}
@@ -0,0 +1,57 @@
using Messenger.Api.Contracts;
using Messenger.Api.Services;
using static Messenger.Api.Services.ApiSupport;
namespace Messenger.Api.Endpoints;
public static class MessageEndpoints
{
public static IEndpointRouteBuilder MapMessageEndpoints(this IEndpointRouteBuilder app)
{
app.MapPost("/api/v1/chats/{chat_id}/messages", async (
string chat_id, HttpContext context, SessionService sessions, ChatService chats, MessageService messages) =>
{
var (actor, _) = await sessions.AuthenticateAsync(context);
if (actor is null) return Unauthorized(context);
if (!Guid.TryParse(chat_id, out var chatId))
return ApiError(context, 400, "invalid_request", "Некорректный chat_id");
if (await chats.FindForMemberAsync(chatId, actor.Id) is null)
return ApiError(context, 404, "not_found", "Чат не найден");
var (request, error) = await ReadJsonAsync<CreateMessageRequest>(context);
if (error is not null) return error;
if (string.IsNullOrWhiteSpace(request!.Text) || request.Text.EnumerateRunes().Count() > 4000)
return ApiError(context, 400, "invalid_request", "Некорректный текст сообщения");
var message = await messages.CreateAsync(chatId, actor.Id, request.Text);
return Results.Json(message, statusCode: StatusCodes.Status201Created);
});
app.MapGet("/api/v1/chats/{chat_id}/messages", async (
string chat_id, HttpContext context, SessionService sessions, ChatService chats, MessageService messages) =>
{
var (actor, _) = await sessions.AuthenticateAsync(context);
if (actor is null) return Unauthorized(context);
if (!Guid.TryParse(chat_id, out var chatId))
return ApiError(context, 400, "invalid_request", "Некорректный chat_id");
if (await chats.FindForMemberAsync(chatId, actor.Id) is null)
return ApiError(context, 404, "not_found", "Чат не найден");
var (limit, limitError) = ParseLimit(context);
if (limitError is not null) return limitError;
var (cursor, cursorTime, cursorError) = ParseCursor(context, $"chat:{chatId}");
if (cursorError is not null) return cursorError;
var page = await messages.ListAsync(chatId, cursorTime, cursor?.Id, limit + 1);
string? nextCursor = null;
if (page.Count > limit)
{
var last = page[limit - 1];
nextCursor = CursorService.EncodeChatCursor(new ChatCursor($"chat:{chatId}", last.CreatedAt, last.Id));
page = page.Take(limit).ToList();
}
return Results.Ok(new { items = page, next_cursor = nextCursor });
});
return app;
}
}
@@ -0,0 +1,51 @@
using Messenger.Api.Contracts;
using Messenger.Api.Services;
using static Messenger.Api.Services.ApiSupport;
namespace Messenger.Api.Endpoints;
public static class UiEndpoints
{
// The required /api/v1 history stays ascending. The web client has a separate,
// optional route to open a large chat at its newest page and page backwards.
public static IEndpointRouteBuilder MapUiEndpoints(this IEndpointRouteBuilder app)
{
app.MapGet("/api/ui/chats/{chat_id}/members", async (
string chat_id, HttpContext context, SessionService sessions, ChatService chats, UserService users) =>
{
var (actor, _) = await sessions.AuthenticateAsync(context);
if (actor is null) return Unauthorized(context);
if (!Guid.TryParse(chat_id, out var chatId))
return ApiError(context, 400, "invalid_request", "Некорректный chat_id");
if (await chats.FindForMemberAsync(chatId, actor.Id) is null)
return ApiError(context, 404, "not_found", "Чат не найден");
return Results.Ok(new { items = await users.ListForChatAsync(chatId) });
});
app.MapGet("/api/ui/chats/{chat_id}/messages", async (
string chat_id, HttpContext context, SessionService sessions, ChatService chats, MessageService messages) =>
{
var (actor, _) = await sessions.AuthenticateAsync(context);
if (actor is null) return Unauthorized(context);
if (!Guid.TryParse(chat_id, out var chatId))
return ApiError(context, 400, "invalid_request", "Некорректный chat_id");
if (await chats.FindForMemberAsync(chatId, actor.Id) is null)
return ApiError(context, 404, "not_found", "Чат не найден");
var (limit, limitError) = ParseLimit(context);
if (limitError is not null) return limitError;
var (cursor, cursorTime, cursorError) = ParseCursor(context, $"recent-chat:{chatId}");
if (cursorError is not null) return cursorError;
var page = await messages.ListAsync(chatId, cursorTime, cursor?.Id, limit + 1, newestFirst: true);
string? nextCursor = null;
if (page.Count > limit)
{
var last = page[limit - 1];
nextCursor = CursorService.EncodeChatCursor(new ChatCursor($"recent-chat:{chatId}", last.CreatedAt, last.Id));
page = page.Take(limit).ToList();
}
return Results.Ok(new { items = page, next_cursor = nextCursor });
});
return app;
}
}
@@ -0,0 +1,40 @@
using System.Text.RegularExpressions;
using Messenger.Api.Contracts;
using Messenger.Api.Services;
using static Messenger.Api.Services.ApiSupport;
namespace Messenger.Api.Endpoints;
public static class UserEndpoints
{
public static IEndpointRouteBuilder MapUserEndpoints(this IEndpointRouteBuilder app)
{
app.MapPost("/api/v1/users", async (HttpContext context, UserService users) =>
{
var (request, error) = await ReadJsonAsync<CreateUserRequest>(context);
if (error is not null) return error;
if (request!.Username is null || !Regex.IsMatch(request.Username, "\\A[a-z0-9_]{3,32}\\z"))
return ApiError(context, 400, "invalid_request", "Некорректный username");
if (string.IsNullOrWhiteSpace(request.DisplayName) ||
request.DisplayName.EnumerateRunes().Count() is < 1 or > 100)
return ApiError(context, 400, "invalid_request", "Некорректный display_name");
if (string.IsNullOrWhiteSpace(request.Password) ||
request.Password.EnumerateRunes().Count() is < 12 or > 128)
return ApiError(context, 400, "invalid_request", "Пароль должен содержать 12-128 символов");
var user = await users.RegisterAsync(request.Username, request.DisplayName, request.Password);
return user is null
? ApiError(context, 409, "conflict", "Username уже занят")
: Results.Json(user, statusCode: StatusCodes.Status201Created);
});
app.MapGet("/api/v1/users/me", async (HttpContext context, SessionService sessions) =>
{
var (user, _) = await sessions.AuthenticateAsync(context);
return user is null ? Unauthorized(context) : Results.Ok(user);
});
return app;
}
}
@@ -0,0 +1,58 @@
using System.Text.Json;
using Messenger.Api.Contracts;
using StackExchange.Redis;
namespace Messenger.Api.Infrastructure;
// PostgreSQL validates the session on every request. This cache saves the user lookup
// and never grants access independently of the durable session row.
public sealed class RedisSessionCache(IConnectionMultiplexer connection, ILogger<RedisSessionCache> logger)
{
private static readonly TimeSpan OperationBudget = TimeSpan.FromMilliseconds(750);
private static string Key(byte[] hash) => "messenger:session:" + Convert.ToHexString(hash).ToLowerInvariant();
public sealed record Entry(UserDto User, DateTime ExpiresAt);
public async Task<Entry?> GetAsync(byte[] hash)
{
if (!connection.IsConnected) return null;
try
{
var value = await connection.GetDatabase().StringGetAsync(Key(hash)).WaitAsync(OperationBudget);
return value.IsNullOrEmpty ? null : JsonSerializer.Deserialize<Entry>(value.ToString());
}
catch (Exception exception) when (exception is RedisException or TimeoutException or OperationCanceledException or JsonException)
{
logger.LogWarning("Session cache read unavailable; using PostgreSQL");
return null;
}
}
public async Task SetAsync(byte[] hash, UserDto user, DateTime expiresAt)
{
var remaining = expiresAt - DateTime.UtcNow;
if (!connection.IsConnected || remaining <= TimeSpan.Zero) return;
try
{
await connection.GetDatabase().StringSetAsync(Key(hash),
JsonSerializer.Serialize(new Entry(user, expiresAt)), remaining).WaitAsync(OperationBudget);
}
catch (Exception exception) when (exception is RedisException or TimeoutException or OperationCanceledException)
{
logger.LogWarning("Session cache write unavailable; using PostgreSQL");
}
}
public async Task RemoveAsync(byte[] hash)
{
if (!connection.IsConnected) return;
try
{
await connection.GetDatabase().KeyDeleteAsync(Key(hash)).WaitAsync(OperationBudget);
}
catch (Exception exception) when (exception is RedisException or TimeoutException or OperationCanceledException)
{
logger.LogWarning("Session cache invalidation unavailable; PostgreSQL still enforces revocation");
}
}
}
+19
View File
@@ -0,0 +1,19 @@
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<EmbeddedResource Include="Data/Migrations/*.sql" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="Isopoh.Cryptography.Argon2" Version="2.0.0" />
<PackageReference Include="Npgsql" Version="9.0.5" />
<PackageReference Include="StackExchange.Redis" Version="2.8.58" />
</ItemGroup>
</Project>
@@ -0,0 +1,28 @@
using Messenger.Api.Services;
using System.Net.Sockets;
using Npgsql;
namespace Messenger.Api.Middleware;
public sealed class ExceptionHandlingMiddleware(RequestDelegate next, ILogger<ExceptionHandlingMiddleware> logger)
{
public async Task InvokeAsync(HttpContext context)
{
try
{
await next(context);
}
catch (Exception exception) when (exception is NpgsqlException or SocketException or TimeoutException)
{
logger.LogError(exception, "Database request failed");
if (!context.Response.HasStarted)
await ApiSupport.ApiError(context, 503, "unavailable", "Сервис временно недоступен").ExecuteAsync(context);
}
catch (Exception exception)
{
logger.LogError(exception, "Request failed");
if (!context.Response.HasStarted)
await ApiSupport.ApiError(context, 500, "internal_error", "Внутренняя ошибка").ExecuteAsync(context);
}
}
}
@@ -0,0 +1,16 @@
namespace Messenger.Api.Middleware;
public sealed class RequestIdMiddleware
{
private readonly RequestDelegate _next;
public RequestIdMiddleware(RequestDelegate next) => _next = next;
public async Task InvokeAsync(HttpContext context)
{
var requestId = Guid.NewGuid().ToString();
context.Items["RequestId"] = requestId;
context.Response.Headers["X-Request-Id"] = requestId;
await _next(context);
}
}
@@ -0,0 +1,25 @@
namespace Messenger.Api.Middleware;
public sealed class RequestLoggingMiddleware
{
private readonly RequestDelegate _next;
public RequestLoggingMiddleware(RequestDelegate next) => _next = next;
public async Task InvokeAsync(HttpContext context)
{
var logger = context.RequestServices
.GetRequiredService<ILoggerFactory>()
.CreateLogger("Http");
await _next(context);
logger.LogInformation(
"{Method} {Path} -> {StatusCode} request_id={RequestId}",
context.Request.Method,
context.Request.Path,
context.Response.StatusCode,
context.Items["RequestId"]
);
}
}
+73
View File
@@ -0,0 +1,73 @@
using System.Text.Json;
using System.Text.Json.Serialization;
using Messenger.Api.Data;
using Messenger.Api.Endpoints;
using Messenger.Api.Infrastructure;
using Messenger.Api.Middleware;
using Messenger.Api.Services;
using Npgsql;
using StackExchange.Redis;
var builder = WebApplication.CreateBuilder(args);
var host = Environment.GetEnvironmentVariable("APP_HOST") ?? "0.0.0.0";
var port = Environment.GetEnvironmentVariable("APP_PORT") ?? "8080";
builder.WebHost.UseUrls($"http://{host}:{port}");
builder.Services.ConfigureHttpJsonOptions(options =>
{
options.SerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower;
options.SerializerOptions.UnmappedMemberHandling = JsonUnmappedMemberHandling.Disallow;
});
var databaseUrlFile = Environment.GetEnvironmentVariable("DATABASE_URL_FILE");
var databaseUrl = databaseUrlFile is not null
? File.ReadAllText(databaseUrlFile).Trim()
: Environment.GetEnvironmentVariable("DATABASE_URL");
if (string.IsNullOrWhiteSpace(databaseUrl))
throw new InvalidOperationException("Set DATABASE_URL_FILE or DATABASE_URL before starting the API");
var connectionString = new NpgsqlConnectionStringBuilder(databaseUrl)
{
MaxPoolSize = 20,
Timeout = 5,
CommandTimeout = 10
};
var dataSource = NpgsqlDataSource.Create(connectionString.ConnectionString);
builder.Services.AddSingleton(dataSource);
builder.Services.AddSingleton<AppDatabase>();
var redisOptions = ConfigurationOptions.Parse(builder.Configuration["REDIS_URL"] ?? "localhost:6379");
redisOptions.AbortOnConnectFail = false;
redisOptions.ConnectTimeout = 500;
redisOptions.ConnectRetry = 0;
redisOptions.AsyncTimeout = 500;
redisOptions.SyncTimeout = 500;
redisOptions.BacklogPolicy = BacklogPolicy.FailFast;
builder.Services.AddSingleton<IConnectionMultiplexer>(await ConnectionMultiplexer.ConnectAsync(redisOptions));
builder.Services.AddSingleton<RedisSessionCache>();
builder.Services.AddSingleton<PasswordService>();
builder.Services.AddSingleton<UserService>();
builder.Services.AddSingleton<SessionService>();
builder.Services.AddSingleton<ChatService>();
builder.Services.AddSingleton<MessageService>();
var app = builder.Build();
await DatabaseMigrator.ApplyAsync(dataSource);
app.UseMiddleware<RequestIdMiddleware>();
app.UseMiddleware<RequestLoggingMiddleware>();
app.UseMiddleware<ExceptionHandlingMiddleware>();
app.UseDefaultFiles();
app.UseStaticFiles(new StaticFileOptions
{
OnPrepareResponse = context => context.Context.Response.Headers.CacheControl = "no-cache"
});
app.MapHealthEndpoints();
app.MapUserEndpoints();
app.MapAuthEndpoints();
app.MapChatEndpoints();
app.MapMessageEndpoints();
app.MapUiEndpoints();
app.Run();
@@ -0,0 +1,23 @@
{
"$schema": "https://json.schemastore.org/launchsettings.json",
"profiles": {
"http": {
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": true,
"applicationUrl": "http://localhost:5052",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
},
"https": {
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": true,
"applicationUrl": "https://localhost:7253;http://localhost:5052",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
}
}
+93
View File
@@ -0,0 +1,93 @@
using System.Globalization;
using System.Text.Json;
using Messenger.Api.Contracts;
namespace Messenger.Api.Services;
public static class ApiSupport
{
public static async Task<(T? Value, IResult? Error)> ReadJsonAsync<T>(HttpContext context)
{
if (!context.Request.HasJsonContentType())
return (default, ApiError(context, 400, "invalid_request", "Требуется application/json"));
try
{
var value = await context.Request.ReadFromJsonAsync<T>();
return value is null
? (default, ApiError(context, 400, "invalid_request", "Тело запроса обязательно"))
: (value, null);
}
catch (Exception exception) when (exception is JsonException or NotSupportedException or BadHttpRequestException)
{
return (default, ApiError(context, 400, "invalid_request", "Некорректный JSON"));
}
}
public static IResult Unauthorized(HttpContext context, bool basic = false)
{
context.Response.Headers["WWW-Authenticate"] = basic
? "Basic realm=\"messenger\", charset=\"UTF-8\""
: "Bearer realm=\"messenger\"";
return ApiError(context, 401, "unauthorized", "Требуется действительная сессия");
}
public static (ChatCursor? Cursor, DateTime? Time, IResult? Error) ParseCursor(
HttpContext context, string scope)
{
if (!context.Request.Query.TryGetValue("cursor", out var value))
return (null, null, null);
var cursor = CursorService.DecodeChatCursor(value.ToString());
if (cursor is null || cursor.Scope != scope || cursor.Id == Guid.Empty ||
!DateTime.TryParse(cursor.CreatedAt, CultureInfo.InvariantCulture,
DateTimeStyles.RoundtripKind, out var time) || time.Kind != DateTimeKind.Utc)
return (null, null, ApiError(context, 400, "invalid_request", "Некорректный cursor"));
return (cursor, time, null);
}
public static (int Limit, IResult? Error) ParseLimit(HttpContext context)
{
const int defaultLimit = 50;
if (!context.Request.Query.TryGetValue("limit", out var value))
return (defaultLimit, null);
if (!int.TryParse(value.ToString(), out var limit) ||
limit < 1 ||
limit > 100)
{
return (
0,
ApiError(context, 400, "invalid_request", "limit должен быть от 1 до 100")
);
}
return (limit, null);
}
public static IResult ApiError(
HttpContext context,
int status,
string code,
string message)
{
var requestId =
context.Items["RequestId"]?.ToString()
?? Guid.NewGuid().ToString();
return Results.Json(
new
{
error = new
{
code,
message,
request_id = requestId
}
},
statusCode: status
);
}
}
+16
View File
@@ -0,0 +1,16 @@
using Messenger.Api.Contracts;
using Messenger.Api.Data;
namespace Messenger.Api.Services;
public sealed class ChatService(AppDatabase database)
{
public async Task<ChatDto?> CreateAsync(string title, List<Guid> memberIds) =>
(await database.CreateChatAsync(title, memberIds))?.ToDto();
public async Task<ChatDto?> FindForMemberAsync(Guid chatId, Guid userId) =>
(await database.FindChatForMemberAsync(chatId, userId))?.ToDto();
public async Task<List<ChatDto>> ListAsync(Guid userId, DateTime? cursorTime, Guid? cursorId, int count) =>
(await database.ListChatsAsync(userId, cursorTime, cursorId, count)).Select(chat => chat.ToDto()).ToList();
}
@@ -0,0 +1,49 @@
using System.Text;
using System.Text.Json;
using Messenger.Api.Contracts;
namespace Messenger.Api.Services;
public static class CursorService
{
public static string EncodeChatCursor(ChatCursor cursor)
{
var json = JsonSerializer.Serialize(cursor);
return Convert.ToBase64String(Encoding.UTF8.GetBytes(json))
.TrimEnd('=')
.Replace('+', '-')
.Replace('/', '_');
}
public static ChatCursor? DecodeChatCursor(string cursor)
{
try
{
var base64 = cursor
.Replace('-', '+')
.Replace('_', '/');
switch (base64.Length % 4)
{
case 2:
base64 += "==";
break;
case 3:
base64 += "=";
break;
case 1:
return null;
}
var bytes = Convert.FromBase64String(base64);
var json = Encoding.UTF8.GetString(bytes);
return JsonSerializer.Deserialize<ChatCursor>(json);
}
catch
{
return null;
}
}
}
@@ -0,0 +1,13 @@
using Messenger.Api.Contracts;
using Messenger.Api.Data;
namespace Messenger.Api.Services;
public sealed class MessageService(AppDatabase database)
{
public async Task<MessageDto> CreateAsync(Guid chatId, Guid senderId, string text) =>
(await database.CreateMessageAsync(chatId, senderId, text)).ToDto();
public async Task<List<MessageDto>> ListAsync(Guid chatId, DateTime? cursorTime, Guid? cursorId, int count, bool newestFirst = false) =>
(await database.ListMessagesAsync(chatId, cursorTime, cursorId, count, newestFirst)).Select(message => message.ToDto()).ToList();
}
@@ -0,0 +1,28 @@
using System.Security.Cryptography;
using System.Text;
using Isopoh.Cryptography.Argon2;
namespace Messenger.Api.Services;
public sealed class PasswordService
{
public string Hash(string password)
{
var salt = RandomNumberGenerator.GetBytes(16);
var config = new Argon2Config
{
Type = Argon2Type.HybridAddressing,
Version = Argon2Version.Nineteen,
TimeCost = 3,
MemoryCost = 32768,
Lanes = 1,
Threads = 1,
Password = Encoding.UTF8.GetBytes(password),
Salt = salt,
HashLength = 32
};
return Argon2.Hash(config);
}
public bool Verify(string hash, string password) => Argon2.Verify(hash, password);
}
@@ -0,0 +1,65 @@
using System.Security.Cryptography;
using System.Text;
using Messenger.Api.Contracts;
using Messenger.Api.Data;
using Messenger.Api.Infrastructure;
namespace Messenger.Api.Services;
public sealed class SessionService(AppDatabase database, PasswordService passwords, RedisSessionCache cache, IConfiguration configuration)
{
private readonly int _ttlSeconds = int.TryParse(configuration["SESSION_TTL_SECONDS"], out var ttl) && ttl > 0
? ttl : 3600;
public async Task<SessionDto?> LoginAsync(string username, string password)
{
var user = await database.FindUserByUsernameAsync(username);
if (user is null || !passwords.Verify(user.PasswordHash, password))
return null;
var token = Convert.ToBase64String(RandomNumberGenerator.GetBytes(32))
.TrimEnd('=').Replace('+', '-').Replace('/', '_');
var expiresAt = UtcClock.Now().AddSeconds(_ttlSeconds);
var hash = HashToken(token);
await database.CreateSessionAsync(hash, user.Id, expiresAt);
await cache.SetAsync(hash, user.ToDto(), expiresAt);
return new SessionDto(token, "Bearer", expiresAt.ToString("O"), user.ToDto());
}
public async Task<(UserDto? User, byte[]? TokenHash)> AuthenticateAsync(HttpContext context)
{
if (!context.Request.Headers.TryGetValue("Authorization", out var value))
return (null, null);
var authorization = value.ToString();
if (!authorization.StartsWith("Bearer ", StringComparison.OrdinalIgnoreCase))
return (null, null);
var token = authorization[7..];
if (token.Length != 43 || token.Any(c => !char.IsAsciiLetterOrDigit(c) && c != '-' && c != '_'))
return (null, null);
var hash = HashToken(token);
var session = await database.FindActiveSessionAsync(hash);
if (session is null) return (null, null);
var cached = await cache.GetAsync(hash);
if (cached is not null && cached.User.Id == session.UserId && cached.ExpiresAt == session.ExpiresAt)
return (cached.User, hash);
var user = await database.FindUserByIdAsync(session.UserId);
if (user is null) return (null, null);
var dto = user.ToDto();
await cache.SetAsync(hash, dto, session.ExpiresAt);
return (dto, hash);
}
public async Task<bool> RevokeAsync(byte[] tokenHash)
{
var revoked = await database.RevokeSessionAsync(tokenHash);
if (revoked) await cache.RemoveAsync(tokenHash);
return revoked;
}
private static byte[] HashToken(string token) => SHA256.HashData(Encoding.ASCII.GetBytes(token));
}
+24
View File
@@ -0,0 +1,24 @@
using Messenger.Api.Contracts;
using Messenger.Api.Data;
using Npgsql;
namespace Messenger.Api.Services;
public sealed class UserService(AppDatabase database, PasswordService passwords)
{
public async Task<List<UserDto>> ListForChatAsync(Guid chatId) =>
(await database.ListChatUsersAsync(chatId)).Select(user => user.ToDto()).ToList();
public async Task<UserDto?> RegisterAsync(string username, string displayName, string password)
{
var hash = passwords.Hash(password);
try
{
return (await database.CreateUserAsync(username, displayName, hash)).ToDto();
}
catch (PostgresException exception) when (exception.SqlState == PostgresErrorCodes.UniqueViolation)
{
return null;
}
}
}
@@ -0,0 +1,8 @@
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}
+9
View File
@@ -0,0 +1,9 @@
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*"
}
+408
View File
@@ -0,0 +1,408 @@
:root {
color-scheme: dark;
--ink: #FFE135;
--muted: #b6b5aa;
--accent: #FFE135;
--accent-hover: #ffeb79;
--paper: #262626;
--surface: #303030;
--soft: #38382c;
--border: #414139;
--danger: #ffaaa0;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
color: var(--ink);
background: #262626;
font-size: 15px;
}
* { box-sizing: border-box; }
body { margin: 0; }
button, input, textarea { font: inherit; }
button, a, input, textarea { -webkit-tap-highlight-color: transparent; }
button { cursor: pointer; }
button:disabled { cursor: default; opacity: .5; }
button, textarea, input { outline: none; }
button:focus-visible, a:focus-visible { outline: 2px solid var(--accent); outline-offset: 4px; }
input:focus, textarea:focus { border-color: var(--accent); box-shadow: 0 0 0 3px #ffe13515; }
a { color: inherit; text-decoration: none; }
[hidden] { display: none !important; }
svg { width: 21px; height: 21px; fill: none; stroke: currentColor; stroke-width: 1.7; stroke-linecap: round; stroke-linejoin: round; flex-shrink: 0; }
.svg-sprite { position: absolute; width: 0; height: 0; overflow: hidden; }
.visually-hidden { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0; }
::selection { color: #262626; background: var(--accent); }
/* Brand and shared controls */
.brand { display: inline-flex; align-items: center; font-size: 30px; font-weight: 750; letter-spacing: -1.6px; gap: 10px; line-height: 1; }
.brand-dot { color: var(--accent); margin-left: -8px; }
.brand-mark { height: 36px; width: 36px; background: var(--accent); border-radius: 12px; display: flex; flex-direction: column; justify-content: center; gap: 4px; padding: 9px; }
.brand-mark i { display: block; height: 2px; border-radius: 2px; background: #262626; }
.brand-mark i:nth-child(2) { width: 75%; }
.brand-mark i:nth-child(3) { width: 45%; }
.eyebrow { display: block; color: var(--muted); font-size: 10px; font-weight: 650; letter-spacing: 2px; text-transform: uppercase; line-height: 1.6; }
.muted { color: var(--muted); font-size: 14px; line-height: 1.7; }
label { display: grid; gap: 9px; font-size: 12px; font-weight: 550; color: var(--ink); }
input, textarea { width: 100%; color: var(--ink); background: #292929; border: 1px solid #4b4b42; border-radius: 12px; padding: 14px 15px; font-size: 14px; transition: border-color .18s, box-shadow .18s; }
input::placeholder, textarea::placeholder { color: #a6a69a; }
textarea { resize: vertical; line-height: 1.5; }
.field-note { color: var(--muted); font-size: 11px; font-weight: 400; line-height: 1.7; }
.button { display: inline-flex; align-items: center; justify-content: center; gap: 10px; border-radius: 12px; border: 1px solid transparent; padding: 14px 20px; font-weight: 650; font-size: 13px; transition: background .18s, transform .18s; }
.button.primary { background: var(--accent); color: #262626; }
.button.primary:hover { background: var(--accent-hover); transform: translateY(-1px); }
.button.secondary { background: #3a3a32; border-color: var(--border); color: var(--ink); }
.button.secondary:hover { background: #454538; }
.button.wide { width: 100%; }
.icon-button { display: inline-flex; align-items: center; justify-content: center; border: 1px solid transparent; background: transparent; color: var(--muted); width: 36px; height: 36px; border-radius: 11px; flex-shrink: 0; transition: background .18s, color .18s; }
.icon-button:hover { background: #3c3c32; color: var(--accent); }
.icon-button.filled { background: var(--accent); color: #262626; }
.icon-button.filled:hover { background: var(--accent-hover); }
.text-button { background: none; border: 0; color: var(--accent); font-size: 11px; padding: 10px 14px; border-radius: 9px; }
.text-button:hover { background: #ffe1350e; }
.form-notice { color: var(--danger); font-size: 12px; line-height: 1.6; background: #452f2d; border: 1px solid #70453e; border-radius: 10px; padding: 11px 13px; }
.form-notice.success { color: var(--ink); background: var(--soft); border-color: #686032; }
/* Entry screen */
.auth-layout { min-height: 100svh; display: grid; grid-template-columns: 1.1fr 1fr; max-width: 1440px; margin: auto; }
.intro { position: relative; min-height: 760px; padding: 50px 64px 40px; overflow: hidden; background: radial-gradient(ellipse at 5% 95%, #ffe13508, transparent 65%), var(--paper); }
.intro::before { content: ""; position: absolute; inset: auto auto -270px -250px; width: 760px; height: 760px; border: 1px solid #ffe13520; border-radius: 50%; pointer-events: none; }
.intro::after { content: ""; position: absolute; right: -190px; top: 90px; width: 440px; height: 440px; border: 1px solid #ffe13512; border-radius: 50%; pointer-events: none; }
.intro-copy { margin-top: 82px; position: relative; z-index: 1; }
.intro-copy .eyebrow { color: var(--accent); padding-left: 22px; position: relative; }
.intro-copy .eyebrow::before { content: ""; width: 7px; height: 7px; background: var(--accent); border-radius: 50%; position: absolute; left: 0; top: 5px; }
.intro h1 { font-size: clamp(48px, 5vw, 72px); line-height: 1.04; font-weight: 700; letter-spacing: -3.5px; margin: 22px 0 26px; }
.intro em, .welcome em { font-family: Georgia, "Times New Roman", serif; font-weight: 400; color: var(--accent); }
.intro-copy p { color: var(--muted); line-height: 1.8; font-size: 15px; }
.conversation-art { position: relative; width: 330px; height: 165px; margin: 38px 0 25px 34px; z-index: 1; }
.art-bubble { position: absolute; padding: 17px 22px 13px; border-radius: 18px; font-size: 14px; box-shadow: 0 12px 30px #00000020; }
.art-bubble span { display: block; font-size: 10px; text-align: right; margin-top: 8px; opacity: .65; }
.art-bubble b { font-weight: 500; }
.art-one { background: #353530; border: 1px solid #4a4a3c; left: 0; top: 0; transform: rotate(-4deg); border-bottom-left-radius: 5px; min-width: 195px; }
.art-two { background: var(--accent); color: #262626; right: 0; top: 67px; transform: rotate(3deg); border-bottom-right-radius: 5px; min-width: 218px; }
.art-typing { position: absolute; bottom: 0; left: 15px; display: flex; gap: 5px; border-radius: 12px; background: #353530; border: 1px solid var(--border); padding: 13px 19px; }
.art-typing i { background: var(--accent); width: 5px; height: 5px; border-radius: 50%; }
.art-orbit { position: absolute; right: -45px; top: 5px; width: 11px; height: 11px; background: var(--accent); border-radius: 50%; box-shadow: 0 0 0 9px #ffe13508; }
.intro-footer { font-size: 11px; color: var(--muted); display: flex; align-items: center; gap: 9px; margin-top: 38px; position: relative; }
.status-dot { height: 6px; width: 6px; background: var(--accent); border-radius: 50%; }
.auth-side { background: #2c2c2a; border-left: 1px solid var(--border); display: flex; flex-direction: column; justify-content: center; align-items: center; padding: 50px 64px 25px; min-height: 760px; }
.auth-card { width: 100%; max-width: 360px; }
.auth-switch { display: flex; padding: 5px; background: #222222; border: 1px solid #404037; border-radius: 14px; margin-bottom: 42px; }
.auth-switch button { width: 50%; background: transparent; border: 0; border-radius: 9px; color: var(--muted); padding: 11px; font-size: 12px; font-weight: 600; }
.auth-switch .active { background: var(--accent); color: #262626; box-shadow: 0 3px 12px #00000018; }
.auth-card h2 { font-weight: 650; font-size: 40px; letter-spacing: -1.7px; line-height: 1.15; margin: 12px 0; }
.auth-card .muted { margin: 13px 0 30px; }
.auth-card form { display: grid; gap: 20px; }
.auth-card .wide { margin-top: 5px; justify-content: space-between; }
.auth-card .wide > span { font-size: 21px; line-height: 1; }
.auth-footnote { font-size: 11px; color: var(--muted); margin: 24px 0; text-align: center; }
.auth-bottom { color: var(--muted); font-size: 10px; letter-spacing: .6px; margin-top: 40px; }
/* Conversations */
.app-shell { display: grid; grid-template-columns: 310px minmax(0,1fr); height: calc(100svh - 44px); max-width: 1440px; margin: 22px auto; border: 1px solid #46463c; border-radius: 24px; overflow: hidden; box-shadow: 0 20px 70px #00000025; background: var(--paper); }
.sidebar { min-height: 0; background: #222222; border-right: 1px solid var(--border); display: flex; flex-direction: column; padding: 29px 19px 0; }
.sidebar-top { display: flex; align-items: center; justify-content: space-between; padding: 0 9px; }
.sidebar .brand { font-size: 28px; }
.sidebar .brand-mark { width: 32px; height: 32px; border-radius: 10px; }
.sidebar-heading { display: flex; justify-content: space-between; align-items: center; padding: 35px 9px 22px; }
.sidebar-heading .eyebrow { font-size: 9px; letter-spacing: 1.7px; }
.sidebar-heading h2 { margin: 6px 0 0; font-size: 22px; font-weight: 650; letter-spacing: -.7px; }
.count { font-size: 11px; font-weight: 600; background: #ffe13516; border: 1px solid #ffe13525; border-radius: 7px; margin-left: 9px; padding: 3px 7px; vertical-align: middle; color: var(--accent); }
.count:empty { display: none; }
.search-field { display: flex; align-items: center; background: #2d2d2b; border: 1px solid #414139; border-radius: 12px; margin: 0 9px 22px; padding: 0 11px; gap: 8px; }
.search-field > span:not(.visually-hidden) { font-size: 25px; line-height: 1; color: var(--muted); }
.search-field input { border: 0; background: transparent; padding: 12px 0; font-size: 12px; box-shadow: none; }
.search-field:focus-within { border-color: var(--accent); }
.chat-list { flex: 1; overflow: auto; min-height: 0; scrollbar-width: thin; scrollbar-color: #646451 transparent; }
.chat-row { display: flex; align-items: center; gap: 13px; position: relative; border: 1px solid transparent; background: transparent; text-align: left; padding: 15px 11px; width: 100%; border-radius: 14px; color: var(--ink); margin-bottom: 6px; transition: background .18s, border-color .18s; }
.chat-row:hover { background: #2e2e29; }
.chat-row.active { background: #ffe1350f; border-color: #ffe13540; }
.chat-row.active::after { content: ""; position: absolute; right: 11px; height: 6px; width: 6px; border-radius: 50%; background: var(--accent); box-shadow: 0 0 0 4px #ffe1350b; }
.avatar { display: flex; align-items: center; justify-content: center; width: 43px; height: 43px; border-radius: 14px; background: #45432a; color: var(--accent); font-size: 14px; font-weight: 650; flex-shrink: 0; letter-spacing: -.5px; border: 1px solid #ffe1351a; }
.avatar.tone-1 { background: #4b3e2a; color: #ffd68a; border-color: #ffd68a20; }
.avatar.tone-2 { background: #3b4032; color: #d9df9d; border-color: #d9df9d20; }
.avatar.tone-3 { background: #493b36; color: #edc5a5; border-color: #edc5a520; }
.chat-row.active .avatar { background: var(--accent); color: #262626; border-color: transparent; }
.chat-row-text { display: grid; gap: 6px; min-width: 0; flex: 1; }
.chat-row strong { font-size: 13px; font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; padding-right: 10px; }
.chat-row small { font-size: 11px; color: var(--muted); }
.list-empty { font-size: 12px; text-align: center; line-height: 1.7; color: var(--muted); padding: 20px 15px; }
.profile { border-top: 1px solid var(--border); display: flex; align-items: center; gap: 6px; margin-top: 12px; padding: 20px 7px; }
.profile-main { display: flex; align-items: center; gap: 11px; text-align: left; background: none; border: 0; padding: 0; min-width: 0; flex: 1; color: var(--ink); }
.profile .avatar { border-radius: 50%; background: #39392c; color: var(--accent); width: 37px; height: 37px; font-size: 12px; }
.profile-text { display: grid; gap: 5px; min-width: 0; }
.profile-text strong { font-size: 12px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: 600; }
.profile-text > span { font-size: 10px; color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.workspace { min-width: 0; min-height: 0; position: relative; background: var(--paper); }
.welcome { height: 100%; display: flex; align-items: center; justify-content: center; flex-direction: column; text-align: center; position: relative; padding: 35px; background: radial-gradient(ellipse at center, #ffe13505, transparent 70%); }
.welcome-symbol { width: 110px; height: 110px; background: #ffe1350b; border: 1px solid #ffe13529; border-radius: 34px; position: relative; display: flex; align-items: center; justify-content: center; margin-bottom: 34px; transform: rotate(-6deg); }
.welcome-symbol svg { width: 44px; height: 44px; color: var(--accent); stroke-width: 1.4; transform: rotate(6deg); }
.tiny-dot { position: absolute; width: 17px; height: 17px; right: -4px; top: 4px; border-radius: 50%; background: var(--accent); border: 4px solid var(--paper); }
.welcome .eyebrow { font-size: 9px; letter-spacing: 1.5px; }
.welcome h1 { font-weight: 650; font-size: 43px; letter-spacing: -1.7px; line-height: 1.2; margin: 18px 0; }
.welcome p { font-size: 13px; line-height: 1.8; color: var(--muted); margin: 0 0 27px; }
.welcome .button svg { width: 17px; height: 17px; }
.welcome-bottom { position: absolute; bottom: 30px; font-size: 10px; color: var(--muted); letter-spacing: .4px; }
.conversation { height: 100%; display: flex; flex-direction: column; }
.chat-header { display: flex; align-items: center; gap: 14px; padding: 21px 30px; border-bottom: 1px solid var(--border); min-height: 90px; background: #292929; }
.chat-header .chat-avatar { height: 43px; width: 43px; }
.chat-heading { flex: 1; min-width: 0; }
.chat-heading h2 { font-size: 17px; font-weight: 650; margin: 0 0 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; letter-spacing: -.3px; }
.chat-heading span { font-size: 11px; color: var(--muted); }
.message-scroll { flex: 1; min-height: 0; overflow: auto; padding: 12px 32px 24px; scrollbar-width: thin; scrollbar-color: #646451 transparent; scroll-behavior: auto; background: radial-gradient(ellipse at 100% 100%, #ffe13504, transparent 70%); }
.history-control { text-align: center; min-height: 18px; }
.message-list { display: flex; flex-direction: column; gap: 14px; }
.date-separator { align-self: center; background: #30302c; border: 1px solid #414139; border-radius: 20px; padding: 6px 12px; text-align: center; color: var(--muted); font-size: 10px; letter-spacing: .3px; margin: 20px 0 12px; }
.message { max-width: 76%; align-self: flex-start; display: grid; gap: 6px; }
.message.mine { align-self: flex-end; }
.message-author { font-size: 10px; color: var(--muted); padding-left: 8px; }
.message-bubble { background: #343430; border: 1px solid #46463b; border-radius: 17px 17px 17px 5px; padding: 13px 16px 10px; min-width: 90px; box-shadow: 0 4px 14px #00000008; }
.mine .message-bubble { background: var(--accent); color: #262626; border: 1px solid var(--accent); border-radius: 17px 17px 5px 17px; }
.message-text { font-size: 14px; white-space: pre-wrap; overflow-wrap: anywhere; line-height: 1.65; margin: 0; }
.message-time { font-size: 10px; display: block; text-align: right; color: var(--muted); margin-top: 7px; }
.mine .message-time { color: #5c5324; }
.empty-conversation { text-align: center; position: relative; top: 28%; font-size: 13px; color: var(--muted); line-height: 1.9; }
.composer { display: grid; grid-template-columns: minmax(0,1fr) 46px; gap: 10px; align-items: end; border-top: 1px solid var(--border); padding: 20px 29px 16px; background: #292929; }
.composer textarea { border: 1px solid #4b4b42; background: #30302d; border-radius: 13px; padding: 13px 15px; font-size: 14px; resize: none; max-height: 140px; min-height: 47px; scrollbar-width: thin; }
.send-button { display: flex; align-items: center; justify-content: center; background: var(--accent); border: 0; color: #262626; width: 46px; height: 47px; border-radius: 13px; margin-bottom: 1px; transition: background .18s; }
.send-button:hover { background: var(--accent-hover); }
.send-button:disabled { background: #444439; opacity: 1; color: #abab95; }
.send-button svg { height: 21px; width: 21px; }
.composer-note { grid-column: 1/-1; display: flex; justify-content: space-between; font-size: 9px; color: var(--muted); padding: 2px 3px; gap: 15px; }
.composer-note .over-limit { color: var(--danger); }
.mobile-only { display: none; }
.toast { position: fixed; bottom: 27px; left: 50%; transform: translateX(-50%); background: var(--accent); color: #262626; border: 1px solid #ffec7d; box-shadow: 0 8px 35px #00000030; border-radius: 13px; padding: 13px 20px; font-size: 12px; line-height: 1.5; max-width: min(90%,520px); z-index: 20; }
.toast.error { background: #452f2d; color: var(--danger); border-color: #70453e; }
/* Dialogs */
dialog { border: 1px solid #575744; border-radius: 22px; padding: 28px; max-width: 440px; width: calc(100% - 36px); color: var(--ink); background: #2c2c2a; box-shadow: 0 24px 100px #00000060; }
dialog::backdrop { background: #151515aa; backdrop-filter: blur(6px); }
.dialog-heading { display: flex; align-items: center; justify-content: space-between; gap: 15px; }
.dialog-heading h2 { font-size: 25px; font-weight: 650; letter-spacing: -.8px; margin: 0; }
.dialog-heading .icon-button { width: 30px; height: 30px; }
dialog .muted { font-size: 12px; margin: 14px 0 25px; }
dialog form { display: grid; gap: 20px; }
.dialog-actions { display: flex; justify-content: flex-end; gap: 10px; margin-top: 3px; }
#my-id { font-size: 12px; font-family: ui-monospace, monospace; background: #242424; }
#profile-dialog .wide { margin-top: 17px; }
.members-list { display: grid; gap: 16px; padding-top: 25px; }
.member-item { display: grid; gap: 8px; }
.member-item strong { font-size: 13px; font-weight: 550; }
.member-item code { font-size: 11px; overflow-wrap: anywhere; color: var(--muted); background: #242424; border: 1px solid var(--border); padding: 12px; border-radius: 10px; }
/* Optional API explanation panel */
.defense-toggle { display: flex; align-items: center; justify-content: center; gap: 8px; background: transparent; border: 1px solid #515143; border-radius: 11px; padding: 11px 12px; color: var(--muted); font-size: 11px; font-weight: 550; }
.defense-toggle svg { width: 15px; height: 15px; }
.defense-toggle:hover, .defense-toggle[aria-expanded=true] { background: #ffe1350d; border-color: #ffe13565; color: var(--accent); }
.auth-bottom .defense-toggle { margin: 15px auto 0; }
.sidebar-defense { margin: 10px 9px 0; flex-shrink: 0; }
.defense-panel { position: fixed; z-index: 15; right: 30px; top: 108px; width: 330px; max-height: min(56svh,490px); overflow: auto; background: #2c2c2a; border: 1px solid #66603a; border-radius: 20px; box-shadow: 0 18px 55px #00000030; padding: 20px; scrollbar-width: thin; scrollbar-color: #646451 transparent; }
.defense-heading { display: flex; justify-content: space-between; align-items: center; gap: 10px; margin-bottom: 18px; }
.defense-heading .eyebrow { font-size: 9px; letter-spacing: 1.4px; }
.defense-heading h2 { font-size: 19px; font-weight: 650; letter-spacing: -.5px; margin: 5px 0 0; }
.defense-heading .icon-button { width: 30px; height: 30px; }
.defense-label { display: block; font-size: 10px; color: var(--muted); margin-bottom: 6px; }
.defense-summary { display: grid; grid-template-columns: minmax(0,1fr) auto; gap: 14px; background: #ffe1350c; border: 1px solid #ffe13520; border-radius: 12px; padding: 12px; }
.defense-summary strong { display: block; font-size: 11px; overflow-wrap: anywhere; }
.defense-history { padding: 16px 0; border-bottom: 1px solid var(--border); }
.defense-history > strong { display: block; font-size: 13px; overflow-wrap: anywhere; }
.defense-history > p { font-size: 11px; color: var(--muted); margin: 8px 0 0; }
.defense-request { padding-top: 16px; }
.defense-section-heading { display: flex; align-items: center; justify-content: space-between; gap: 10px; margin-bottom: 12px; }
.defense-section-heading h3 { font-size: 12px; margin: 0; font-weight: 600; }
.defense-section-heading time { font-size: 10px; color: var(--muted); }
.defense-request-line { display: flex; align-items: center; gap: 8px; }
.defense-method, .defense-status { font: 600 11px ui-monospace, monospace; padding: 6px 8px; border-radius: 6px; background: #404036; color: var(--accent); }
.defense-status { background: var(--accent); color: #262626; }
.defense-status.failed { background: #56332e; color: var(--danger); }
.defense-path { display: block; font: 11px/1.6 ui-monospace, monospace; overflow-wrap: anywhere; color: var(--muted); margin-top: 10px; }
.defense-result { font-size: 12px; line-height: 1.6; color: var(--accent); margin: 10px 0 14px; }
.defense-result.failed { color: var(--danger); }
.defense-metrics { display: grid; grid-template-columns: 1fr 1fr; margin: 0 0 14px; gap: 12px; }
.defense-metrics dt { font-size: 10px; color: var(--muted); margin-bottom: 6px; }
.defense-metrics dd { font: 550 12px ui-monospace, monospace; margin: 0; color: var(--ink); }
.defense-request-id { display: block; font: 10px/1.7 ui-monospace, monospace; overflow-wrap: anywhere; color: var(--muted); }
.defense-previous { list-style: none; margin: 15px 0 0; padding: 12px 0 0; border-top: 1px solid var(--border); display: grid; gap: 10px; }
.defense-previous li { display: flex; gap: 8px; align-items: center; min-width: 0; }
.defense-mini-status { font: 550 10px ui-monospace, monospace; color: var(--accent); min-width: 23px; }
.defense-mini-status.failed { color: var(--danger); }
.defense-previous code { font: 10px ui-monospace, monospace; color: var(--muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.defense-background { font-size: 10px; color: var(--muted); margin: 12px 0 0; line-height: 1.7; }
.defense-note { font-size: 11px; color: var(--muted); line-height: 1.7; margin: 0; }
.defense-footnote { border-top: 1px solid var(--border); padding-top: 12px; margin-top: 14px; font-size: 10px; }
@media (min-width: 1490px) {
.app-shell { height: calc(100svh - 64px); margin: 32px auto; }
}
@media (max-width: 1100px) {
.intro { padding: 40px 38px; }
.auth-side { padding: 40px 35px; }
.app-shell { margin: 14px; height: calc(100svh - 28px); grid-template-columns: 280px minmax(0,1fr); }
.conversation-art { margin-left: 0; width: 290px; }
.intro h1 { font-size: 56px; }
.sidebar { padding-left: 14px; padding-right: 14px; }
.message-scroll { padding-left: 24px; padding-right: 24px; }
}
@media (max-width: 720px) {
.auth-layout { display: block; }
.intro { min-height: 0; padding: 28px; }
.intro-copy { margin-top: 30px; }
.intro h1 { font-size: 42px; letter-spacing: -2px; line-height: 1.08; margin: 14px 0 0; }
.intro h1 br { display: none; }
.intro-copy .eyebrow { font-size: 9px; }
.intro-copy p, .conversation-art, .intro-footer { display: none; }
.auth-side { min-height: 0; padding: 30px 28px; align-items: center; border-left: 0; border-top: 1px solid var(--border); }
.auth-card { max-width: 440px; }
.auth-switch { margin-bottom: 28px; }
.auth-card h2 { font-size: 32px; }
.auth-card h2 br { display: none; }
.auth-card .muted { margin-bottom: 22px; }
.auth-card form { gap: 17px; }
.auth-bottom { margin-top: 20px; }
.app-shell { margin: 0; border: 0; border-radius: 0; height: 100svh; display: block; }
.sidebar { height: 100%; width: 100%; padding: 25px 18px 0; border: 0; }
.sidebar-heading { padding-top: 30px; }
.workspace { display: none; height: 100%; }
.app-shell.chat-open .sidebar { display: none; }
.app-shell.chat-open .workspace { display: block; }
.welcome { display: none; }
.mobile-only { display: flex; }
.chat-header { padding: 15px; gap: 7px; min-height: 75px; }
.chat-header .avatar { width: 35px; height: 35px; border-radius: 11px; }
.chat-heading h2 { font-size: 14px; }
.chat-header .icon-button { width: 31px; height: 31px; }
.chat-header .icon-button svg { width: 19px; height: 19px; }
.message-scroll { padding: 10px 16px 20px; }
.message { max-width: 88%; }
.composer { padding: 14px 16px max(13px, env(safe-area-inset-bottom)); }
.composer-note { font-size: 9px; }
.composer-note > span:first-child { max-width: 70%; }
.profile { padding-bottom: max(18px, env(safe-area-inset-bottom)); }
.toast { bottom: 20px; }
.defense-panel { top: 83px; right: 12px; width: calc(100% - 24px); max-height: 52svh; padding: 16px; }
.sidebar-defense { margin-top: 9px; }
}
@media (min-width: 721px) {
body:not(.has-session) .defense-panel { right: 24px; left: auto; }
}
@media (min-width: 1100px) {
.defense-open.has-session .app-shell { margin-left: 22px; margin-right: 380px; }
.defense-open.has-session .defense-panel { top: 22px; max-height: calc(100svh - 44px); }
}
@media (prefers-reduced-motion: reduce) {
* { transition: none !important; scroll-behavior: auto !important; }
}
/* Animated CSS silhouettes and faces, no image assets. */
.password-field { position: relative; display: block; }
.password-field input { padding-right: 47px; }
.password-toggle { position: absolute; right: 7px; top: 7px; width: 33px; height: 33px; border: 0; background: transparent; border-radius: 9px; color: var(--muted); display: flex; align-items: center; justify-content: center; }
.password-toggle:hover, .password-toggle[aria-pressed=true] { color: var(--accent); background: #ffe1350c; }
.password-toggle svg { width: 18px; height: 18px; }
/* Each character is one complete geometric silhouette. */
.mascot-stage { position: relative; width: 330px; height: 205px; margin: 32px 0 0 18px; z-index: 2; isolation: isolate; pointer-events: none; --scene-surface: #262626; --gaze-x: 0px; --gaze-y: 0px; }
.mascot-stage::before { content: ""; position: absolute; bottom: 20px; left: 0; right: 0; height: 1px; background: linear-gradient(90deg, transparent, #ffe13545, transparent); }
.mascot { position: absolute; bottom: 21px; z-index: 2; width: 64px; transform-origin: center bottom; will-change: transform; --mascot-color: var(--accent); }
.mascot-tall { left: 24px; }
.mascot-round { left: 82px; z-index: 3; width: 82px; --mascot-color: #e1e0d6; }
.mascot-triangle { left: 154px; width: 84px; --mascot-color: #f7b560; }
.mascot-conversation { position: absolute; inset: 0; z-index: 0; transition: opacity .65s ease; }
.mascot-stage:is([data-trip=forward], [data-trip=near], [data-trip=back]) .mascot-conversation { opacity: .25; }
.mascot-bubble { position: absolute; border-radius: 18px; animation: mascot-bubble-float 5.6s ease-in-out infinite; }
.mascot-bubble-filled { left: 146px; top: 0; width: 96px; height: 54px; background: var(--accent); display: flex; align-items: center; justify-content: center; gap: 7px; rotate: -6deg; }
.mascot-bubble-filled::after { content: ""; position: absolute; bottom: -7px; left: 18px; width: 17px; height: 17px; background: var(--accent); clip-path: polygon(0 0, 100% 0, 0 100%); }
.mascot-bubble-filled span { width: 6px; height: 6px; border-radius: 50%; background: #262626; animation: mascot-typing 1.8s ease-in-out infinite; }
.mascot-bubble-filled span:nth-child(2) { animation-delay: .16s; }
.mascot-bubble-filled span:nth-child(3) { animation-delay: .32s; }
.mascot-bubble-outline { left: 226px; top: 73px; width: 84px; height: 60px; border: 1.5px solid #ffe13555; background: var(--scene-surface); rotate: 7deg; animation-delay: -2.8s; padding: 20px 17px; }
.mascot-bubble-outline::after { content: ""; position: absolute; bottom: -6px; right: 16px; width: 11px; height: 11px; border-right: 1.5px solid #ffe13555; border-bottom: 1.5px solid #ffe13555; background: var(--scene-surface); rotate: 45deg; }
.mascot-bubble-outline i { display: block; height: 2px; width: 100%; margin-bottom: 8px; border-radius: 2px; background: #ffe13555; }
.mascot-bubble-outline i:last-child { width: 65%; }
@keyframes mascot-bubble-float { 0%, 100% { translate: 0 0; } 50% { translate: 0 -5px; } }
@keyframes mascot-typing { 0%, 55%, 100% { translate: 0 0; opacity: .4; } 28% { translate: 0 -3px; opacity: 1; } }
.mascot-body { position: relative; width: 64px; height: 150px; border-radius: 16px; background: var(--mascot-color); transform-origin: center bottom; }
.mascot-round .mascot-body { width: 82px; height: 102px; border-radius: 44px 44px 16px 16px; }
.mascot-triangle .mascot-body { width: 84px; height: 110px; border-radius: 8px; clip-path: polygon(50% 0, 100% 100%, 0 100%); }
.mascot-face { position: absolute; top: 44px; left: 50%; width: 38px; margin-left: -19px; display: flex; gap: 6px; justify-content: center; transition: opacity .45s, transform .5s cubic-bezier(.22, 1, .36, 1); }
.mascot-round .mascot-face { top: 34px; }
.mascot-triangle .mascot-face { top: 66px; width: 38px; margin-left: -19px; gap: 6px; }
.mascot-eye { position: relative; display: block; width: 14px; height: 18px; border-radius: 50%; background: #fffdf2; overflow: hidden; animation: mascot-blink 7s infinite; transition: scale .45s ease; }
.mascot-round .mascot-eye { animation-delay: 1.7s; }
.mascot-triangle .mascot-eye { width: 14px; height: 17px; animation-delay: 3.1s; }
.mascot-eye i { position: absolute; width: 6px; height: 8px; left: 4px; top: 5px; border-radius: 50%; background: #262626; transform: translate(var(--gaze-x), var(--gaze-y)); transition: transform .4s cubic-bezier(.22, 1, .36, 1); }
.mascot-triangle .mascot-eye i { left: 4px; top: 5px; }
.mascot-mouth { position: absolute; left: 50%; top: 28px; width: 11px; height: 5px; margin-left: -5px; border-bottom: 2px solid #262626; border-radius: 0 0 50% 50%; transition: width .4s, height .4s, border-radius .4s; }
.mascot-triangle .mascot-mouth { top: 21px; width: 9px; }
.mascot-arm { position: absolute; height: 23px; width: 54px; top: 32px; left: 14px; border-radius: 10px; background: #b7b6ab; opacity: 0; translate: 0 24px; rotate: -9deg; transition: translate .5s, opacity .45s; }
.mascot-stage[data-mood=looking] { --gaze-x: 4px !important; --gaze-y: 3px !important; }
.mascot-stage:is([data-mood=private],[data-mood=short],[data-mood=revealed]) .mascot-tall .mascot-face { opacity: 0; transform: translateX(-10px) scaleX(.75); }
.mascot-stage:is([data-mood=private],[data-mood=short],[data-mood=revealed]) .mascot-round .mascot-arm { opacity: 1; translate: 0 0; }
.mascot-stage:is([data-mood=private],[data-mood=short]) .mascot-triangle .mascot-eye:first-child { transform: scaleY(.12); animation: none; }
.mascot-stage:is([data-mood=private],[data-mood=short]) .mascot-triangle .mascot-eye:last-child { animation: mascot-peek-eye 6.4s ease-in-out infinite; }
.mascot-stage:is([data-mood=private],[data-mood=short]) .mascot-triangle .mascot-eye i { transform: translate(3px, 0); }
.mascot-stage[data-mood=revealed] .mascot-triangle .mascot-face { opacity: 0; transform: translateX(8px) scaleX(.75); }
.mascot-stage.is-scared { --gaze-x: 3px !important; --gaze-y: -3px !important; }
.mascot-stage.is-scared .mascot-eye { animation: none; scale: 1.12; }
.mascot-stage.is-scared .mascot-mouth { width: 6px; height: 9px; border: 2px solid #262626; border-radius: 50%; }
.mascot-stage.is-sleepy .mascot-eye { animation: none; scale: 1 .3; }
.mascot-stage[data-mood=revealed] .mascot-triangle { z-index: 1; }
@keyframes mascot-blink { 0%, 42%, 46%, 100% { transform: scaleY(1); } 44% { transform: scaleY(.08); } }
@keyframes mascot-peek-eye { 0%, 16%, 65%, 100% { transform: scaleY(.12); } 24%, 57% { transform: scaleY(1); } }
.scenario-section { padding: 17px 0 15px; border-bottom: 1px solid var(--border); }
.scenario-section h3 { font-size: 13px; margin: 0 0 9px; }
.scenario-description { font-size: 10px; line-height: 1.7; color: var(--muted); margin: 0 0 12px; }
.scenario-actions { display: grid; gap: 8px; }
.scenario-actions .button { padding: 11px 10px; font-size: 11px; }
.scenario-status { font-size: 11px; line-height: 1.6; margin: 12px 0 0; color: var(--ink); }
.scenario-status.failed { color: var(--danger); }
.scenario-scope { margin: 12px 0 0; }
.scenario-steps { list-style: none; padding: 0; margin: 12px 0 0; display: grid; gap: 8px; max-height: 245px; overflow: auto; scrollbar-width: thin; scrollbar-color: #646451 transparent; }
.scenario-step { border: 1px solid var(--border); border-radius: 10px; background: #262626; padding: 10px; }
.scenario-step[data-state=failed] { border-color: #9a5b51; }
.scenario-step summary { display: flex; align-items: flex-start; gap: 8px; cursor: pointer; font-size: 11px; line-height: 1.5; list-style: none; }
.scenario-step summary::before { content: "▸"; color: var(--muted); }
.scenario-step[open] summary::before { content: "▾"; }
.scenario-step summary::-webkit-details-marker { display: none; }
.scenario-step-badge { flex-shrink: 0; color: var(--accent); font: 650 10px/1.65 ui-monospace, monospace; }
.scenario-step[data-state=failed] .scenario-step-badge { color: var(--danger); }
.scenario-step[data-state=pending] .scenario-step-badge { color: var(--muted); }
.scenario-step p { color: var(--muted); font-size: 10px; line-height: 1.7; margin: 9px 0 0; }
.scenario-step code { display: block; color: var(--muted); font: 10px/1.7 ui-monospace, monospace; overflow-wrap: anywhere; margin-top: 7px; }
@media (max-width: 1100px) and (min-width: 721px) {
.mascot-stage { margin-left: 0; width: 315px; }
}
@media (max-width: 720px) {
.mascot-stage { width: 300px; height: 150px; margin: 18px auto 0; }
.mascot-stage::before { bottom: 10px; }
.mascot { bottom: 11px; }
.mascot-tall { left: calc(50% - 84px); }
.mascot-round { left: calc(50% - 44px); }
.mascot-triangle { left: calc(50% + 2px); width: 84px; }
.mascot-body { scale: .62; transform-origin: center bottom; }
.mascot-bubble { border-radius: 13px; }
.mascot-bubble-filled { left: calc(50% - 14px); top: 12px; width: 64px; height: 35px; gap: 5px; }
.mascot-bubble-filled span { width: 4px; height: 4px; }
.mascot-bubble-filled::after { width: 12px; height: 12px; bottom: -5px; left: 13px; }
.mascot-bubble-outline { left: calc(50% + 68px); top: 59px; width: 56px; height: 42px; padding: 13px 11px; }
.mascot-bubble-outline i { margin-bottom: 6px; }
.mascot-bubble-outline::after { width: 8px; height: 8px; bottom: -5px; right: 12px; }
.intro h1 { font-size: 36px; }
.intro { padding-bottom: 18px; }
.scenario-steps { max-height: 175px; }
}
@media (max-width: 370px) {
.mascot-stage { width: 264px; }
}
@media (prefers-reduced-motion: reduce) {
.mascot-stage *, .mascot-stage *::before { animation: none !important; transition: none !important; }
}
.defense-origin { margin-top: 10px; }
@media (max-width: 720px) {
.auth-card .mascot-stage { position: sticky; top: 0; z-index: 3; width: 100%; margin-top: -9px; margin-bottom: 22px; background: #2c2c2a; --scene-surface: #2c2c2a; border-bottom: 1px solid var(--border); box-shadow: 0 6px 0 #2c2c2a; }
}
.auth-card form { margin-top: 24px; }
.auth-card .muted + form { margin-top: 0; }
.defense-help { border-top: 1px solid var(--border); margin-top: 14px; padding-top: 12px; }
.defense-help summary { color: var(--muted); font-size: 10px; cursor: pointer; }
.defense-help .defense-note { margin-top: 10px; font-size: 10px; }
@media (prefers-reduced-motion: reduce) {
.mascot-stage *, .mascot-stage *::before { animation: none !important; transition: none !important; }
}
+453
View File
@@ -0,0 +1,453 @@
import { recordDefenseRequest, updateDefenseSession, updateDefenseHistory } from "/defense.js";
import { setMascotMood, celebrateMascots } from "/mascots.js";
import { configureScenarios, updateScenarioAccess } from "/scenarios.js";
const $ = id => document.getElementById(id);
const storageKey = "linia.session";
const state = { session: null, chats: [], chatsCursor: null, current: null, messages: new Map(),
serverIds: new Set(), members: new Map(), olderCursor: null, historyReady: false, epoch: 0, syncing: false, sending: false, drafts: new Map() };
let toastTimer;
class ApiError extends Error {
constructor(message, status = 0) { super(message); this.status = status; }
}
function notice(id, message, success = false) {
const element = $(id);
element.textContent = message;
element.hidden = !message;
element.classList.toggle("success", success);
}
function toast(message, error = false) {
clearTimeout(toastTimer);
$("toast").textContent = message;
$("toast").classList.toggle("error", error);
$("toast").hidden = false;
toastTimer = setTimeout(() => { $("toast").hidden = true; }, error ? 6500 : 3000);
}
async function request(path, { method = "GET", body, headers = {}, auth = true, background = false } = {}) {
const started = performance.now();
let httpStatus = null, requestId = null, outcome = "network";
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), 12000);
// Authorization is explicit; disable the browser's implicit Basic-auth handling.
const options = { method, headers: { Accept: "application/json", ...headers }, signal: controller.signal, cache: "no-store", credentials: "omit" };
if (auth && state.session) options.headers.Authorization = "Bearer " + state.session.token;
if (body !== undefined) {
options.body = JSON.stringify(body);
options.headers["Content-Type"] = "application/json";
}
try {
const response = await fetch(path, options);
httpStatus = response.status;
requestId = response.headers.get("X-Request-Id");
outcome = "unreadable";
const data = response.status === 204 ? null : await response.json();
outcome = response.ok ? "success" : "http_error";
if (!response.ok) {
if (response.status === 401 && auth) endSession("Сессия закончилась. Войдите снова.");
throw new ApiError(data?.error?.message || "Не удалось выполнить запрос.", response.status);
}
return data;
} catch (error) {
if (error instanceof ApiError) throw error;
throw new ApiError("Нет ответа от сервера. Проверьте соединение и попробуйте позже.");
} finally {
clearTimeout(timer);
recordDefenseRequest({ method, path, status: httpStatus, requestId, outcome, background,
durationMs: Math.round(performance.now() - started),
authorization: options.headers.Authorization?.split(" ")[0] || "Без авторизации" });
}
}
function basic(username, password) {
const bytes = new TextEncoder().encode(username + ":" + password);
return "Basic " + btoa(Array.from(bytes, byte => String.fromCharCode(byte)).join(""));
}
function selectAuthTab(register) {
$("register-panel").hidden = !register;
$("login-panel").hidden = register;
$("tab-register").classList.toggle("active", register);
$("tab-login").classList.toggle("active", !register);
$("tab-register").setAttribute("aria-pressed", String(register));
$("tab-login").setAttribute("aria-pressed", String(!register));
notice("auth-notice", "");
}
function setFormBusy(form, busy) {
form.querySelectorAll("input, textarea, button").forEach(element => { element.disabled = busy; });
}
function persistSession(session) {
try { sessionStorage.setItem(storageKey, JSON.stringify(session)); } catch { /* session still works in memory */ }
}
async function enterSession(session) {
state.epoch++;
state.session = session;
updateScenarioAccess();
updateDefenseSession({ name: session.user.display_name, expiresAt: session.expires_at });
updateDefenseHistory(null);
state.current = null;
state.messages.clear();
state.serverIds.clear();
state.chats = [];
state.chatsCursor = null;
state.drafts.clear();
state.syncing = false;
state.sending = false;
persistSession(session);
$("auth-screen").hidden = true;
$("app-screen").hidden = false;
$("app-screen").classList.remove("chat-open");
$("welcome").hidden = false;
$("conversation").hidden = true;
$("profile-name").textContent = session.user.display_name;
$("profile-username").textContent = "@" + session.user.username;
$("profile-avatar").textContent = initials(session.user.display_name);
$("chat-search").value = "";
renderChats();
try { await loadChats(false, true); } catch (error) { toast(error.message, true); }
}
function endSession(message = "") {
state.epoch++;
state.session = null;
updateScenarioAccess();
updateDefenseSession(null);
updateDefenseHistory(null);
state.current = null;
state.chats = [];
state.messages.clear();
state.serverIds.clear();
state.drafts.clear();
try { sessionStorage.removeItem(storageKey); } catch { /* storage unavailable */ }
document.querySelectorAll("dialog[open]").forEach(dialog => dialog.close());
$("message-list").replaceChildren();
$("chat-list").replaceChildren();
$("message-input").value = "";
$("app-screen").hidden = true;
$("auth-screen").hidden = false;
$("login-password").value = "";
selectAuthTab(false);
notice("auth-notice", message);
}
$("tab-login").addEventListener("click", () => selectAuthTab(false));
$("tab-register").addEventListener("click", () => selectAuthTab(true));
$("login-form").addEventListener("submit", async event => {
event.preventDefault();
const form = event.currentTarget;
const username = $("login-username").value.trim();
const password = $("login-password").value;
setFormBusy(form, true);
setMascotMood("pending");
notice("auth-notice", "");
try {
const session = await request("/api/v1/auth/sessions", { method: "POST", auth: false, headers: { Authorization: basic(username, password) } });
form.reset();
await celebrateMascots();
await enterSession(session);
} catch (error) { setMascotMood("error"); notice("auth-notice", error.status === 401 ? "Неверный логин или пароль." : error.message); }
finally { setFormBusy(form, false); }
});
$("register-form").addEventListener("submit", async event => {
event.preventDefault();
const form = event.currentTarget;
const username = $("register-username").value.trim();
const displayName = $("register-name").value.trim();
const password = $("register-password").value;
if (Array.from(displayName).length > 100) return notice("auth-notice", "Имя должно содержать от 1 до 100 символов.");
if (Array.from(password).length < 12 || Array.from(password).length > 128 || !password.trim()) {
setMascotMood("short");
return notice("auth-notice", "Пароль должен содержать от 12 до 128 символов.");
}
setFormBusy(form, true);
setMascotMood("pending");
notice("auth-notice", "");
let registered = false;
try {
await request("/api/v1/users", { method: "POST", auth: false, body: { username, display_name: displayName, password } });
registered = true;
const session = await request("/api/v1/auth/sessions", { method: "POST", auth: false, headers: { Authorization: basic(username, password) } });
form.reset();
await celebrateMascots();
await enterSession(session);
toast("Добро пожаловать, " + session.user.display_name + "!");
} catch (error) {
setMascotMood("error");
if (registered) {
form.reset();
selectAuthTab(false);
$("login-username").value = username;
notice("auth-notice", "Аккаунт создан. Войдите, когда сервер будет доступен.");
} else notice("auth-notice", error.status === 409 ? "Это имя пользователя уже занято. Выберите другое." : error.message);
} finally { setFormBusy(form, false); }
});
function initials(value) { return (value.match(/[\p{L}\p{N}]+/gu) || []).slice(0, 2).map(part => Array.from(part)[0]).join("").toUpperCase(); }
function memberCount(count) { const n = count % 100, d = count % 10; return count + " " + (n >= 11 && n <= 14 ? "участников" : d === 1 ? "участник" : d >= 2 && d <= 4 ? "участника" : "участников"); }
function avatarTone(id) { return "tone-" + (parseInt(id.slice(0, 4), 16) % 4); }
async function loadChats(more = false, background = false) {
const token = state.session?.token;
const cursor = more ? state.chatsCursor : null;
const data = await request("/api/v1/chats?limit=100" + (cursor ? "&cursor=" + encodeURIComponent(cursor) : ""), { background });
if (token !== state.session?.token) return;
state.chats = more ? [...state.chats, ...data.items.filter(chat => !state.chats.some(existing => existing.id === chat.id))] : data.items;
state.chatsCursor = data.next_cursor;
renderChats();
}
function renderChats() {
const query = $("chat-search").value.trim().toLocaleLowerCase("ru-RU");
const chats = [...state.chats].sort((a, b) => b.created_at.localeCompare(a.created_at) || b.id.localeCompare(a.id))
.filter(chat => chat.title.toLocaleLowerCase("ru-RU").includes(query));
$("chat-count").textContent = state.chats.length || "";
$("more-chats").hidden = !state.chatsCursor;
const nodes = chats.map(chat => {
const button = document.createElement("button");
button.className = "chat-row" + (chat.id === state.current?.id ? " active" : "");
button.setAttribute("aria-pressed", String(chat.id === state.current?.id));
const avatar = document.createElement("span"); avatar.className = "avatar " + avatarTone(chat.id); avatar.textContent = initials(chat.title);
const description = document.createElement("span"); description.className = "chat-row-text";
const title = document.createElement("strong"); title.textContent = chat.title;
const members = document.createElement("small"); members.textContent = memberCount(chat.member_ids.length);
description.append(title, members); button.append(avatar, description);
button.addEventListener("click", () => selectChat(chat));
return button;
});
if (!nodes.length) {
const empty = document.createElement("p"); empty.className = "list-empty";
empty.textContent = query ? "Чаты не найдены." : "Пока нет чатов.";
nodes.push(empty);
}
$("chat-list").replaceChildren(...nodes);
}
$("chat-search").addEventListener("input", renderChats);
$("refresh-chats").addEventListener("click", async () => { try { await loadChats(); } catch (error) { toast(error.message, true); } });
$("more-chats").addEventListener("click", async () => { try { await loadChats(true); } catch (error) { toast(error.message, true); } });
async function selectChat(chat) {
if (state.current?.id === chat.id) { $("app-screen").classList.add("chat-open"); return; }
if (state.current) state.drafts.set(state.current.id, $("message-input").value);
state.epoch++;
state.current = chat;
state.members = new Map([[state.session.user.id, state.session.user]]);
renderChats();
state.messages = new Map();
state.serverIds = new Set();
state.olderCursor = null;
state.historyReady = false;
updateDefenseHistory({ title: chat.title, loaded: 0, hasOlder: false, ready: false });
state.syncing = false;
$("current-title").textContent = chat.title;
$("current-members").textContent = memberCount(chat.member_ids.length);
$("current-avatar").textContent = initials(chat.title);
$("current-avatar").className = "avatar chat-avatar " + avatarTone(chat.id);
$("welcome").hidden = true;
$("conversation").hidden = false;
$("app-screen").classList.add("chat-open");
$("message-input").value = state.drafts.get(chat.id) || "";
updateComposer();
$("message-list").replaceChildren();
$("empty-conversation").hidden = true;
$("older-messages").hidden = true;
try { await Promise.all([syncRecent(true), loadMembers(state.epoch, chat.id)]); }
catch (error) { toast(error.message, true); }
}
async function loadMembers(epoch, chatId) {
const data = await request(`/api/ui/chats/${chatId}/members`, { background: true });
if (epoch !== state.epoch) return;
state.members = new Map(data.items.map(user => [user.id, user]));
renderMessages();
}
async function syncRecent(initial = false, background = false) {
if (!state.current || !state.session || state.syncing) return;
const epoch = state.epoch, chatId = state.current.id;
state.syncing = true;
try {
const page = await request(`/api/ui/chats/${chatId}/messages?limit=50`, { background });
if (epoch !== state.epoch) return;
state.historyReady = true;
const overlap = page.items.some(item => state.serverIds.has(item.id));
// On a large burst, the older button pages through the newly discovered gap.
if (initial || (!overlap && page.items.length === 50)) state.olderCursor = page.next_cursor;
page.items.forEach(item => { state.messages.set(item.id, item); state.serverIds.add(item.id); });
renderMessages(initial ? "bottom" : "preserve");
} finally { if (epoch === state.epoch) state.syncing = false; }
}
$("older-messages").addEventListener("click", async () => {
if (!state.olderCursor || !state.current) return;
const epoch = state.epoch;
$("older-messages").disabled = true;
try {
const page = await request(`/api/ui/chats/${state.current.id}/messages?limit=50&cursor=${encodeURIComponent(state.olderCursor)}`);
if (epoch !== state.epoch) return;
page.items.forEach(item => { state.messages.set(item.id, item); state.serverIds.add(item.id); });
state.olderCursor = page.next_cursor;
renderMessages("prepend");
} catch (error) { toast(error.message, true); }
finally { $("older-messages").disabled = false; }
});
function renderMessages(mode = "preserve") {
const scroll = $("message-scroll"), oldHeight = scroll.scrollHeight, oldTop = scroll.scrollTop;
const atBottom = oldHeight - oldTop - scroll.clientHeight < 85;
const messages = [...state.messages.values()].sort((a, b) => a.created_at.localeCompare(b.created_at) || a.id.localeCompare(b.id));
const nodes = []; let previousDay = "";
for (const message of messages) {
const date = new Date(message.created_at);
const day = date.toLocaleDateString("ru-RU", { day: "numeric", month: "long", year: "numeric" });
if (day !== previousDay) {
const divider = document.createElement("div"); divider.className = "date-separator"; divider.textContent = day; nodes.push(divider); previousDay = day;
}
const mine = message.sender_id === state.session?.user.id;
const article = document.createElement("article"); article.className = "message" + (mine ? " mine" : "");
if (!mine) {
const author = document.createElement("span"); author.className = "message-author"; author.textContent = state.members.get(message.sender_id)?.display_name || "Участник " + message.sender_id.slice(0, 8); author.title = message.sender_id; article.append(author);
}
const bubble = document.createElement("div"); bubble.className = "message-bubble";
const text = document.createElement("p"); text.className = "message-text"; text.textContent = message.text;
const stamp = document.createElement("time"); stamp.className = "message-time"; stamp.dateTime = message.created_at;
stamp.textContent = date.toLocaleTimeString("ru-RU", { hour: "2-digit", minute: "2-digit" });
bubble.append(text, stamp); article.append(bubble); nodes.push(article);
}
$("message-list").replaceChildren(...nodes);
$("empty-conversation").hidden = messages.length !== 0;
$("older-messages").hidden = !state.olderCursor;
updateDefenseHistory({ title: state.current?.title, loaded: messages.length, hasOlder: Boolean(state.olderCursor), ready: state.historyReady });
if (mode === "bottom" || (mode === "preserve" && atBottom)) scroll.scrollTop = scroll.scrollHeight;
else if (mode === "prepend") scroll.scrollTop = oldTop + scroll.scrollHeight - oldHeight;
else scroll.scrollTop = oldTop;
}
function updateComposer() {
const text = $("message-input").value, count = Array.from(text).length;
$("message-count").textContent = `${count} / 4000`;
$("message-count").classList.toggle("over-limit", count > 4000);
$("send-message").disabled = state.sending || !text.trim() || count > 4000;
$("message-input").style.height = "auto";
const height = $("message-input").scrollHeight + 2;
$("message-input").style.height = Math.min(140, height) + "px";
$("message-input").style.overflowY = height > 140 ? "auto" : "hidden";
if (state.current) state.drafts.set(state.current.id, text);
}
$("message-input").addEventListener("input", updateComposer);
$("message-input").addEventListener("keydown", event => {
if (event.key === "Enter" && !event.shiftKey && !event.isComposing) {
event.preventDefault();
if (!$("send-message").disabled) $("message-form").requestSubmit();
}
});
$("message-form").addEventListener("submit", async event => {
event.preventDefault();
if (state.sending || !state.current || $("send-message").disabled) return;
const epoch = state.epoch, chatId = state.current.id, text = $("message-input").value;
state.sending = true; updateComposer();
try {
const message = await request(`/api/v1/chats/${chatId}/messages`, { method: "POST", body: { text } });
if (epoch !== state.epoch) return;
state.messages.set(message.id, message);
if ($("message-input").value === text) $("message-input").value = "";
renderMessages("bottom");
await syncRecent(false, true);
} catch (error) { toast(error.status === 0 ? "Отправка не подтверждена. Обновите чат перед повторной отправкой." : error.message, true); }
finally { state.sending = false; updateComposer(); }
});
function openNewChat() {
$("new-chat-form").reset(); notice("chat-dialog-notice", "");
$("new-chat-dialog").showModal(); $("new-chat-title").focus();
}
$("new-chat").addEventListener("click", openNewChat);
$("welcome-new-chat").addEventListener("click", openNewChat);
document.querySelectorAll("[data-close-dialog]").forEach(button => button.addEventListener("click", () => button.closest("dialog").close()));
$("new-chat-form").addEventListener("submit", async event => {
event.preventDefault();
const form = event.currentTarget, token = state.session?.token;
const title = $("new-chat-title").value.trim();
if (!title || Array.from(title).length > 100) return notice("chat-dialog-notice", "Название должно содержать от 1 до 100 символов.");
const ids = $("new-chat-members").value.split(/[\s,;]+/u).filter(Boolean);
if (ids.some(id => !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(id)))
return notice("chat-dialog-notice", "Проверьте ID участников: нужен полный ID из профиля.");
const members = [...new Set([state.session.user.id, ...ids.map(id => id.toLowerCase())])];
if (members.length > 100) return notice("chat-dialog-notice", "В чате может быть не более 100 участников.");
setFormBusy(form, true); notice("chat-dialog-notice", "");
try {
const chat = await request("/api/v1/chats", { method: "POST", body: { title, member_ids: members } });
if (token !== state.session?.token) return;
$("new-chat-dialog").close(); state.chats.push(chat); renderChats();
await selectChat(chat); toast("Чат создан.");
} catch (error) { notice("chat-dialog-notice", error.message); }
finally { setFormBusy(form, false); }
});
$("open-profile").addEventListener("click", () => {
$("profile-details").textContent = state.session.user.display_name + " · @" + state.session.user.username;
$("my-id").value = state.session.user.id; $("profile-dialog").showModal();
});
$("copy-id").addEventListener("click", async () => {
try { await navigator.clipboard.writeText(state.session.user.id); toast("ID скопирован."); }
catch { $("my-id").select(); toast("Выделили ID. Скопируйте его сочетанием ⌘C или Ctrl+C."); }
});
$("show-members").addEventListener("click", () => {
$("members-list").replaceChildren(...state.current.member_ids.map(id => {
const item = document.createElement("div"); item.className = "member-item";
const label = document.createElement("strong"); label.textContent = (state.members.get(id)?.display_name || "Участник") + (id === state.session.user.id ? " (вы)" : "");
const code = document.createElement("code"); code.textContent = id; item.append(label, code); return item;
}));
$("members-dialog").showModal();
});
$("logout").addEventListener("click", async () => {
$("logout").disabled = true;
try { await request("/api/v1/auth/sessions/current", { method: "DELETE" }); endSession(); }
catch (error) { if (error.status !== 401) toast(error.message, true); }
finally { $("logout").disabled = false; }
});
$("back-to-chats").addEventListener("click", () => $("app-screen").classList.remove("chat-open"));
$("refresh-messages").addEventListener("click", async () => {
try { await syncRecent(); } catch (error) { toast(error.message, true); }
});
setInterval(async () => {
if (!state.session || document.hidden) return;
if (new Date(state.session.expires_at).getTime() <= Date.now()) return endSession("Сессия закончилась. Войдите снова.");
if (state.current) { try { await syncRecent(false, true); } catch { /* manual actions still show errors */ } }
}, 4000);
async function resume() {
try {
const stored = sessionStorage.getItem(storageKey);
if (!stored) return;
const session = JSON.parse(stored);
if (!session?.token || !session.user || !(new Date(session.expires_at).getTime() > Date.now())) return endSession();
state.session = session;
const user = await request("/api/v1/users/me");
await enterSession({ ...session, user });
} catch (error) {
state.session = null;
if (error instanceof ApiError) notice("auth-notice", error.message);
else { try { sessionStorage.removeItem(storageKey); } catch { /* storage unavailable */ } }
}
}
configureScenarios({
getActor: () => state.session ? { id: state.session.user.id, token: state.session.token } : null,
openChat: async (chat, owner) => {
await loadChats(false, true);
if (state.session?.token !== owner.token) throw new Error("Основной вход изменился. Откройте демочат из списка после входа.");
await selectChat(chat);
}
});
void resume();

Some files were not shown because too many files have changed in this diff Show More