ЛР2 – БПИ2303 – Поликарпов – На 5 #155

Closed
Grbisba wants to merge 5 commits from Grbisba/mtusi2026lab2:solution/bpi2303-polikarpov into master
118 changed files with 14653 additions and 35 deletions
+52 -8
View File
@@ -1,11 +1,55 @@
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
# These are logical interface suggestions; map actual framework names in REPORT.md.
# Copy to .env and replace both password placeholders for a local synthetic stand.
# Never commit .env. Existing .env files must be updated manually; see REPORT.md.
HOST_PORT=8080
APP_ENABLED=true
APP_HOST=0.0.0.0
APP_PORT=8080
APP_ENV=lab
APP_READ_TIMEOUT=5s
APP_WRITE_TIMEOUT=10s
APP_IDLE_TIMEOUT=60s
APP_SHUTDOWN_TIMEOUT=8s
APPLICATION_LOG_LEVEL=info
APPLICATION_ENVIRONMENT=dev
APPLICATION_SHUTDOWN_TIMEOUT=8s
APPLICATION_REQUEST_RATE_LIMIT=100
APPLICATION_BURST_RATE_LIMIT=100
APPLICATION_RATE_LIMIT_TTL=1m
# Container addresses and ports for the Compose network.
# These ports are not published on the host.
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_USER=messenger
POSTGRES_PASSWORD=replace-with-local-postgres-password
POSTGRES_DATABASE=messenger
POSTGRES_VERSION_TABLE=versions
# Tern applies embedded migrations at API startup.
POSTGRES_RUN_MIGRATIONS=true
POSTGRES_MAX_CONNECTIONS=10
POSTGRES_CONNECT_TIMEOUT=500ms
POSTGRES_QUERY_TIMEOUT=2s
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_USERNAME=default
REDIS_PASSWORD=replace-with-local-redis-password
REDIS_DB=0
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
JWT_ACCESS_TOKEN_LIFETIME=15m
# Legacy fallback used only when SESSION_TTL_SECONDS is empty.
JWT_REFRESH_TOKEN_LIFETIME=24h
# Container paths. Compose mounts ./certs read-only at /run/certs.
JWT_PUBLIC_KEY_PATH=/run/certs/public_key.pem
JWT_PRIVATE_KEY_PATH=/run/certs/private_key.pem
# Local HTTP defaults. Use secure cookies when serving through HTTPS.
COOKIES_ENABLED=false
COOKIES_DOMAIN=localhost
COOKIES_PATH=/
COOKIES_SECURE=false
COOKIES_SAME_SITE=lax
# Viper accepts a whitespace-separated list of origins.
COOKIES_ALLOWED_ORIGINS=http://localhost:8080
+1
View File
@@ -0,0 +1 @@
*.csv text eol=lf
+7
View File
@@ -28,5 +28,12 @@ coverage/
.DS_Store
.idea/
.vscode/
certs/
# Keep small, sanitized evidence summaries in evidence/ under version control.
# Inspect git diff --cached: ignore rules are not a secret scanner.
# Sanitized Redis experiment log accompanying evidence/redis-cache.md.
!evidence/redis-cache-api.log
# Sanitized cache stampede experiment evidence.
!evidence/cache-stampede/api.log
+32
View File
@@ -0,0 +1,32 @@
# syntax=docker/dockerfile:1
FROM --platform=$BUILDPLATFORM golang:1.27.2-alpine3.23 AS build
WORKDIR /src
COPY service/go.mod service/go.sum ./
RUN go mod download
COPY service/ ./
ARG TARGETOS
ARG TARGETARCH
RUN CGO_ENABLED=0 GOOS=$TARGETOS GOARCH=$TARGETARCH \
go build -mod=readonly -trimpath -ldflags="-s -w" -o /out/messenger ./cmd/app
FROM alpine:3.23.6
COPY --from=build --chmod=0555 /out/messenger /usr/local/bin/messenger
ENV APP_HOST=0.0.0.0 \
APP_PORT=8080 \
APP_SHUTDOWN_TIMEOUT=8s
USER 65532:65532
EXPOSE 8080
STOPSIGNAL SIGTERM
HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \
CMD wget -q -O /dev/null "http://127.0.0.1:${APP_PORT}/health/ready" || exit 1
ENTRYPOINT ["/usr/local/bin/messenger"]
+28 -1
View File
@@ -3,8 +3,12 @@ BASE_URL ?= http://localhost:8080
CA_FILE ?=
ACTION_SCRIPT ?=
TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",)
OPENAPI_SPEC := contracts/openapi.json
GEN_OUTPUT := service/internal/gen/contracts/types.gen.go
GEN_PACKAGE := contracts
OAPI_CODEGEN ?= $(shell go env GOPATH)/bin/oapi-codegen
.PHONY: help check validate test load test-persistence
.PHONY: help check validate test load test-persistence openapi-generate certs key-gen
help:
@echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes"
@@ -24,3 +28,26 @@ load:
test-persistence:
@test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2)
$(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)
openapi-generate:
@mkdir -p $(dir $(GEN_OUTPUT))
@echo "Generating Go types from $(OPENAPI_SPEC)..."
@set -o pipefail; \
jq '(.components.schemas.ChatPage.properties.next_cursor.type, .components.schemas.MessagePage.properties.next_cursor.type) |= "string" | (.components.schemas.ChatPage.properties.next_cursor.nullable, .components.schemas.MessagePage.properties.next_cursor.nullable) = true' $(OPENAPI_SPEC) | \
$(OAPI_CODEGEN) -generate types -package $(GEN_PACKAGE) -o $(GEN_OUTPUT) /dev/stdin
key-gen: create-dir gen-private-key gen-public-key
create-dir:
@mkdir -p certs
gen-private-key:
@openssl genrsa -out certs/private_key.pem 2048
gen-public-key:
@openssl rsa -in certs/private_key.pem -pubout -outform PEM -out certs/public_key.pem
certs: gen-key gen-crt
gen-key:
@openssl genrsa -out ./certs/server.key 2048
gen-crt:
@openssl req -new -x509 -key ./certs/server.key -out ./certs/server.crt -days 365
+354 -22
View File
@@ -1,37 +1,369 @@
# Отчёт — лабораторная 2
# Отчёт — лабораторная 2: PostgreSQL, сессии и Redis
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
- Автор: Поликарпов Даниил Александрович. Группа: БПИ2303.
- Дата оформления: 6 ноября 2026 года.
- Выбранный эксперимент уровня «5»: трек 1, cache stampede — одновременные промахи кэша.
- Базовый commit: `711754bbcd6e47a7b83d7f5c922f5f37f6bc0764`. Реализация и эксперименты относятся к изменённому рабочему дереву поверх этого commit; сам commit не содержит всех описанных изменений. Ссылка на PR не предоставлена.
- ChatGPT/Codex использовался для доработок Redis/singleflight, исправлений конфигурации и обработки отказов, подготовки сценариев проверки и отчёта. Версии библиотек закреплены в [go.mod](service/go.mod); источники и исходные результаты приведены ниже.
## Запуск из чистого clone
Цель работы — перенести пользователей, чаты, участников, сообщения и сессии в PostgreSQL, заменить идентификацию через `X-User-Id` аутентификацией и использовать Redis как необязательный кэш. Завершён эксперимент с защитой от повторных SQL-чтений при наплыве запросов. На исправленной сборке выполнен отдельный автоматизированный прогон требований уровней «3» и «4»: все 16 групп проверок прошли. Доказательства находятся в [evidence/levels-3-4](evidence/levels-3-4/README.md). Эксперимент трека «5» сохранён как результат предшествующей сборки; итоговая оценка остаётся предметом проверки преподавателя.
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
## 1. Запуск из чистого clone
## Архитектура и решения
### 1.1. Предварительные условия и версии
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
Нужны Git, Docker Engine с Docker Compose v2, поддерживающим `--wait`, OpenSSL, Make и Python 3.9+. На Linux для приведённой настройки доступа к ключам нужна утилита `setfacl` и поддержка POSIX ACL файловой системой. Go на хосте нужен для локальной сборки; Docker собирает приложение самостоятельно.
## Доказательства критериев
| Компонент | Версия / образ |
| --- | --- |
| Язык Go | `go 1.27.0` в go.mod; сборка контейнера `golang:1.27.2-alpine3.23` |
| Runtime API | `alpine:3.23.6`, пользователь `65532:65532` |
| PostgreSQL | `postgres:17.11-alpine3.23` |
| Redis | `redis:8.2.11-alpine3.22` |
| HTTP-маршрутизация | chi v5.5.0 |
| Доступ к PostgreSQL / миграции | pgx v5.11.0 / Tern v2.4.3 |
| Redis / объединение загрузок | go-redis v9.23.0 / x/sync v0.23.0 |
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
Команды этого раздела — инструкция воспроизведения основного стенда. Сборка, миграции и проверки выполнены автоматически на отдельном изолированном Compose-проекте; основной стенд не перезапускался. Реальные результаты находятся в разделе 3 и evidence/levels-3-4. Инструкция рассчитана на итоговое дерево исходников с описанными изменениями, а не только на базовый commit.
```sh
git clone https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2.git
cd mtusi2026lab2
```
### 1.2. Локальное окружение
Следующая команда создаёт новый `.env` из [примера](.env.example), генерирует отдельные пароли PostgreSQL и Redis и включает миграции. Существующий `.env` не перезаписывается; пароли не выводятся. Выполнять из корня проекта:
```sh
umask 077
python3 - <<'PY'
from pathlib import Path
import re
import secrets
text = Path('.env.example').read_text()
values = {
'POSTGRES_PASSWORD': secrets.token_urlsafe(32),
'REDIS_PASSWORD': secrets.token_urlsafe(32),
'POSTGRES_RUN_MIGRATIONS': 'true',
}
for key, value in values.items():
text = re.sub(r'^' + key + r'=.*$', key + '=' + value, text, flags=re.MULTILINE)
with Path('.env').open('x') as stream:
stream.write(text)
PY
```
В актуальном `.env.example` включены миграции Tern, добавлены SESSION_TTL_SECONDS=3600, лимит пула и таймауты PostgreSQL. Для существующего `.env` нужно проверить реквизиты и включение миграций. Если SESSION_TTL_SECONDS отсутствует или пуст, используется прежний JWT_REFRESH_TOKEN_LIFETIME; если обе переменные не заданы — один час. Новая переменная имеет приоритет и проверяется как положительное целое число секунд.
Для описанного Compose адреса внутри сети — `postgres:5432` и `redis:6379`; API слушает `0.0.0.0:8080`, на хост опубликован только `127.0.0.1:8080`. `HOST_PORT` меняет хостовый порт. `APP_PORT` следует оставить равным 8080: целевой порт публикации в Compose закреплён на 8080. PostgreSQL и Redis на хост не публикуются.
Пароли и ключи необходимо сохранять между перезапусками. Изменение пароля PostgreSQL в `.env` само по себе не меняет пароль роли в существующем volume.
### 1.3. RSA-ключи
На чистом clone создать пару ключей для подписи JWT. При повторном запуске существующие ключи нужно использовать повторно: их замена делает прежние подписанные сессии непригодными.
```sh
umask 077
make key-gen
chmod 600 certs/private_key.pem
chmod 644 certs/public_key.pem
```
Команда `make key-gen` генерирует RSA-ключ 2048 бит и публичную часть. Это ключи JWT, а не TLS-сертификат; локальный API работает по HTTP. Каталог `certs` монтируется только для чтения в `/run/certs`.
API работает от UID 65532. На Linux выдать этому UID доступ, сохраняя приватный ключ закрытым для остальных пользователей:
```sh
setfacl -m u:65532:rx certs
setfacl -m u:65532:r certs/private_key.pem certs/public_key.pem
```
На Docker Desktop отображение прав зависит от механизма файлового обмена. После сборки проверить чтение обоих файлов из контейнера командой ниже; ошибка требует настройки прав bind mount для UID 65532. Открывать приватный ключ всем пользователям через `chmod 644` не требуется.
### 1.4. Сборка, миграции и готовность
```sh
docker compose --env-file .env config --quiet
docker compose --env-file .env build api
docker compose --env-file .env run --rm --no-deps --entrypoint sh api \
-c 'test -r /run/certs/private_key.pem && test -r /run/certs/public_key.pem'
docker compose --env-file .env up -d --no-build --wait --wait-timeout 120
curl --fail --silent --show-error http://127.0.0.1:8080/health/live
curl --fail --silent --show-error http://127.0.0.1:8080/health/ready
docker compose --env-file .env ps -a
```
На старте API Tern применяет встроенные SQL-миграции и ведёт версию в таблице `versions`. Отдельный SQL-bootstrap контейнера PostgreSQL в текущем Compose не настроен. Ошибка миграции останавливает запуск API. Чистый первый запуск применил все пять миграций. Повторный запуск сохранил версию 5 и количества строк всех таблиц без изменений; результаты приведены в summary.json проверки уровней 3/4.
Compose ожидает здоровый PostgreSQL перед запуском API. Redis является необязательной зависимостью по доступности: API не зависит от его healthcheck и продолжает запуск при ошибке стартового PING. При этом конфигурационные реквизиты Redis, включая пароль для Compose, всё равно должны быть заданы.
`/health/live` отражает жизнь HTTP-процесса. `/health/ready` проверяет флаг HTTP-сервера и PING PostgreSQL с бюджетом 200 мс; при недоступной БД возвращает 503. Redis в readiness не участвует. Проверено: при остановленной БД liveness=200, readiness=503, после запуска БД readiness вновь 200.
Для диагностики использовать выборочные журналы; полный вывод конфигурации с секретами в отчёт не сохранять:
```sh
docker compose --env-file .env logs --tail 100 api
```
При нестандартном `HOST_PORT` заменить порт в curl и передать соответствующий `BASE_URL` проверкам.
### 1.5. Готовые проверки и остановка
Доступные команды проекта:
```sh
make check
make test BASE_URL=http://127.0.0.1:8080
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:8080
```
В [tests/README.md](tests/README.md) описана методика. `make test` создаёт синтетические данные. Persistence использует [scripts/restart.sh](scripts/restart.sh): он пересобирает API, останавливает его, пересоздаёт PostgreSQL и Redis с прежними volumes, затем пересоздаёт API и ждёт healthchecks. Для выполнения hook нужен executable bit. Существующие публичные проверки выполнены без изменений; `make check`, `make test` и полный `make test-persistence` завершились с exit code 0. Реальный вывод сохранён в [checks.txt](evidence/levels-3-4/checks.txt). Новые unit-тесты не добавлялись; дополнительные сценарии автоматизированы в отдельном runner.
Повторить проверку всех критериев на отдельном стенде, сохранив новый прогон отдельно:
```sh
python3 scripts/verify_lab2.py --port 18084 --output evidence/levels-3-4-repeat
```
Runner сам создаёт проект, ключи, пароли и volumes. Restart-hook поддерживает COMPOSE_PROJECT_NAME, COMPOSE_ENV_FILE и COMPOSE_OVERRIDE_FILE; он не генерирует ключи заново. После проверки отдельный стенд остановлен, его volumes сохранены, основной проект не затрагивается.
Обычная остановка сохраняет именованные volumes и локальные ключи:
```sh
docker compose --env-file .env down
```
Следующая отдельная команда предназначена только для намеренного сброса учебного стенда. Она удаляет volumes PostgreSQL и Redis текущего Compose-проекта, включая пользователей, сообщения, сессии и кэш; это не способ обычного перезапуска:
```sh
docker compose --env-file .env down --volumes
```
### 1.6. Фактически используемая конфигурация
| Переменные | Назначение и текущее поведение |
| --- | --- |
| `HOST_PORT`, `APP_HOST`, `APP_PORT` | Публикация хостового порта и адрес HTTP-listener; целевой порт публикации — 8080 |
| `APP_ENABLED` | В Compose принудительно задано `true` |
| `APP_READ_TIMEOUT`, `APP_WRITE_TIMEOUT`, `APP_IDLE_TIMEOUT`, `APP_SHUTDOWN_TIMEOUT` | Таймауты HTTP и graceful shutdown; значения Compose по умолчанию 5/10/60/8 секунд |
| `POSTGRES_HOST`, `POSTGRES_PORT`, `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DATABASE` | Соединение с PostgreSQL; внутри Compose следует использовать имя сервиса |
| `POSTGRES_RUN_MIGRATIONS`, `POSTGRES_VERSION_TABLE` | Включение Tern и таблица версии; для первого запуска нужны `true` и `versions` |
| `POSTGRES_MAX_CONNECTIONS` | Применяется к `pgxpool.MaxConns`; по умолчанию 10. Проверен лимит 2 при восьми параллельных запросах |
| `POSTGRES_CONNECT_TIMEOUT`, `POSTGRES_QUERY_TIMEOUT` | По умолчанию 500 мс и 2 с; connect timeout, statement_timeout соединений и общий контекст бизнес-запроса |
| `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`, `REDIS_DB` | Подключение к Redis; время операций ограничено константами в коде, отдельных env-переменных таймаутов нет |
| `JWT_REFRESH_TOKEN_LIFETIME` | Legacy fallback срока Bearer-сессии, если SESSION_TTL_SECONDS не задан; при отсутствии обеих переменных — 3600 секунд |
| `JWT_ACCESS_TOKEN_LIFETIME` | Срок отдельного access JWT, по умолчанию 15 минут; обязательный API принимает session token, а не этот access token |
| `JWT_PUBLIC_KEY_PATH`, `JWT_PRIVATE_KEY_PATH` | Контейнерные пути `/run/certs/public_key.pem` и `/run/certs/private_key.pem` |
| `SESSION_TTL_SECONDS` | Основной срок сессии в положительных целых секундах; пример окружения задаёт 3600, проверено значение 2 и приоритет над legacy |
| `APPLICATION_ENVIRONMENT`, `APPLICATION_LOG_LEVEL`, `APPLICATION_SHUTDOWN_TIMEOUT` | Читаются конфигурацией приложения; наличие этих полей не заменяет фактическую настройку HTTP shutdown через `APP_SHUTDOWN_TIMEOUT` или обработчика slog |
| `APPLICATION_REQUEST_RATE_LIMIT`, `APPLICATION_BURST_RATE_LIMIT`, `APPLICATION_RATE_LIMIT_TTL` | Читаются в конфигурацию; в текущем запуске rate-limit middleware не подключён |
| `COOKIES_*` | Остались в примере окружения; текущий основной Config их не загружает, обязательный путь аутентификации использует заголовок Bearer |
## 2. Архитектура и решения
### 2.1. Компоненты и источник истины
Клиент обращается к HTTP API на Go. Маршрутизатор chi применяет request ID, логирование и проверку сессии; обработчики декодируют и проверяют JSON, сервисы выполняют бизнес-операции, репозитории используют pgx и go-redis. Контракт находится в [OpenAPI](contracts/openapi.json) и [описании семантики](contracts/README.md).
PostgreSQL — источник истины для пользователей, чатов, членства, сообщений и сессий. Redis хранит только копии метаданных чатов. Отказ или очистка кэша не должны удалять сообщения и отзывать сессии. Подтверждены stop/start Redis, отказ PostgreSQL и полный рестарт всех сервисов с сохранением данных и прежней сессии на изолированном стенде.
По сравнению с lab1 идентификация через `X-User-Id` заменена входом по паролю и серверной сессией. Состояние перенесено в PostgreSQL; добавлены постоянные volumes и кэш. Обязательный публичный smoke прошёл; его вывод сохранён, дополнительно проверены 14 отрицательных случаев валидации.
### 2.2. Схема и транзакционные границы
[SQL-миграции](service/migrations) встроены в бинарник через `go:embed` и применяются Tern последовательно.
| Таблица | Основные данные и ограничения |
| --- | --- |
| `users` | UUID PK, уникальный username, имя, Argon2id-хэш пароля, времена; CHECK формата username и непустых данных |
| `refresh_tokens` | UUID PK сессии, FK пользователя, хэш токена, роль, `expires_at`, `revoked_at`; индексы по пользователю и сроку |
| `chats` | UUID PK, непустой заголовок, время; индекс `(created_at, id)` |
| `chat_members` | Составной PK `(chat_id, user_id)`, FK на чат и пользователя; дополнительный индекс `(user_id, chat_id)` |
| `messages` | UUID PK, чат, отправитель, текст и время; составной FK `(chat_id, sender_id)` на членство и индекс `(chat_id, created_at, id)` |
Создание чата и всех участников выполняется одной транзакцией: сначала INSERT чата, затем INSERT участников. Сервис проверяет отсутствие дублей и включение создателя; FK не позволяет записать неизвестного пользователя. Commit выполняется только после успешного завершения всей операции; при ошибке или panic менеджер пытается выполнить rollback. Rollback проверен запросом с существующим создателем и неизвестным участником: после успешного INSERT чата FK второго INSERT нарушается; ответ 400, частичных строк нет, количества всех таблиц совпадают с исходными.
Создание сообщения — один параметризованный INSERT после проверки доступа. Успешный ответ отправляется после успешного выполнения SQL. Создание и отзыв серверной сессии используют транзакции; при logout строка сессии блокируется для проверки и обновления `revoked_at`. Прикладной COMMIT не является самостоятельным доказательством сохранности при потере диска или питания: отдельной проверки durability и восстановления backup нет.
### 2.3. Аутентификация и доступ
`POST /api/v1/users` регистрирует пользователя. Пароль хранится в виде Argon2id: память 64 MiB, 3 прохода, параллелизм 4, случайная соль 16 байт и ключ 32 байта. Пароль и хэш не включаются в публичный объект User.
`POST /api/v1/auth/sessions` принимает Basic и возвращает `201` с `token`, `token_type`, `expires_at`, `user`. Формат токена реализации — JWT RS256 с новым случайным nonce из 32 байт crypto/rand; клиент передаёт его как непрозрачную строку и не должен разбирать claims. Возвращается refresh/session JWT. Сгенерированный отдельно access JWT не подходит для обязательного session middleware.
Для каждого защищённого запроса middleware проверяет подпись и claims, читает `refresh_tokens`, проверяет срок, отсутствие отзыва, соответствие пользователя и роли, затем сравнивает хэш токена. Сессионный хэш вычисляется как bcrypt от hex-представления SHA-256 токена, с `bcrypt.DefaultCost`. Это отдельная CPU-работа даже при попадании чата в Redis. `DELETE /api/v1/auth/sessions/current` отзывает текущую сессию. `X-User-Id` не используется этим middleware как источник идентификации.
Членство проверяется в SQL или по `MemberIDs` кэшированного чата. Постороннему возвращается 404, чтобы не раскрывать наличие чужого ресурса. Публичный smoke подтвердил вход, logout, неверный пароль, отказ Basic на бизнес-endpoint и запрет подмены через X-User-Id. Дополнительно проверены expiry с SESSION_TTL_SECONDS=2, изменённая подпись JWT и неизвестный пользователь. Прежние сессии сохраняют свой expires_at; nonce не стал обязательным для старых JWT.
### 2.4. История и read-after-write
История читается из PostgreSQL по `chat_id`, отсортирована по `(created_at, id)` и использует keyset-условие `(created_at, id) > (cursor_created_at, cursor_id)`. Курсор API содержит UUID записи; сервер получает её позицию в пределах нужного ресурса. Размер страницы ограничен 1–100, по умолчанию 50; дополнительная запись определяет наличие следующей страницы. OFFSET и кэш истории не используются.
Индекс `idx_messages_chat_id_created_at_id` соответствует фильтрации чата и порядку выдачи. На истории из 20 001 сообщения первая и глубокая страницы проверены EXPLAIN (ANALYZE, BUFFERS): обе используют этот индекс без Seq Scan. Полный обход через API вернул все ID в правильном порядке без потерь и дублей. Текст и JSON планов находятся в evidence/levels-3-4.
После подтверждённого POST следующий запрос истории другого участника увидел ID сообщения. Проверка выполнялась с одной API-репликой. Отдельного snapshot между страницами нет; при конкурентных вставках новые записи с позицией до уже выданного курсора могут не попасть в дальнейший обход. Многорепличная конфигурация и распределённая синхронизация часов не исследовались.
### 2.5. Политика кэша и singleflight
Ключ Redis — `chat:<UUID>`, значение — JSON с ID, заголовком, списком участников и временем создания. Чат сохраняется в кэш после успешного чтения из PostgreSQL. Срок хранения не задан (`SET` с expiration=0); автоматической инвалидации нет. В обязательном API нет изменения или удаления состава участников, поэтому существующий сценарий не содержит такого источника устаревших разрешений. При добавлении этих операций потребуется инвалидация или иная политика согласованности.
При промахе или ошибке Redis приложение читает PostgreSQL. `redis.Nil` обозначает отсутствие ключа, остальные ошибки чтения логируются отдельно. Ошибка записи в кэш не отменяет успешное чтение из БД. Redis использует AOF с `appendfsync everysec` и именованный volume; наблюдалось сохранение ключа при корректном stop/start, а не при аварийном отключении питания.
В `GetForMember` singleflight объединяет одновременные загрузки по `(ChatID, UserID)` внутри одного процесса. Общая загрузка повторно проверяет Redis, читает БД при необходимости и заполняет кэш. Пользователь входит в ключ, поскольку SQL-результат зависит от его членства: нельзя разделить отказ одного пользователя с другим. Отмена ожидающего HTTP-клиента не отменяет общую загрузку; для неё установлен отдельный таймаут 2 секунды. Членство проверяется перед возвратом результата.
Dial/read/write/pool timeout Redis установлены по 200 мс, повторы команд отключены (`MaxRetries=-1`), `DialerRetries=1`; GET, SET и стартовый PING имеют отдельные контексты по 300 мс. Чтение и последующая запись могут расходовать разные бюджеты; 300 мс не является общим таймаутом HTTP-запроса. Бизнес-запросы дополнительно ограничены POSTGRES_QUERY_TIMEOUT=2s, этот же бюджет установлен как statement_timeout на соединениях приложения. Отдельный контекст singleflight не зависит от отмены одного клиента и остаётся ограниченным двумя секундами. Ошибки доступности и deadline возвращаются как 503 unavailable, не раскрывая детали подключения.
Диагностика: `chat_cache_hit`, `chat_cache_miss`, `chat_cache_read_error`, `chat_db_lookup`; ошибки заполнения кэша записываются как `failed to cache chat`. Отсутствие `chat_db_lookup` означает экономию чтения чата, но не отсутствие SQL проверки сессии.
## 3. Соответствие критериям лабораторной
Итоговая приёмка уровней «3» и «4» выполнена на исправленной сборке: **16/16 групп PASS**. Период, commit рабочего дерева, image ID и SHA-256 исходников приведены в [методике](evidence/levels-3-4/README.md) и [summary.json](evidence/levels-3-4/summary.json). Основной работающий Compose-проект не перезапускался. Проверки подтверждают перечисленные сценарии и не являются доказательством отсутствия любых ошибок.
| Уровень / критерий README | Что выполнено | Фактический результат | Доказательство |
| --- | --- | --- | --- |
| Публичный smoke | make test | TODO | TODO |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
| 3: минимум lab1 и переход на новую аутентификацию | Публичный smoke и 14 дополнительных отрицательных случаев | PASS: данные, членство, сообщения, пагинация, ошибки; неверный UUID — 400 | [stdout](evidence/levels-3-4/checks.txt), [HTTP](evidence/levels-3-4/http.csv) |
| Постоянные данные и сессии после рестарта API и всех хранилищ | Публичный persistence с настоящим restart-hook | PASS: все три ID контейнеров изменились; volumes, подтверждённые данные и прежняя сессия сохранены | `full_persistence` в [summary](evidence/levels-3-4/summary.json) |
| PostgreSQL: таблицы, PK/FK, уникальный username | Миграции новой пустой БД и проверка pg_catalog | PASS: пять миграций, четыре FK, PK и unique; операции API работают | [schema.txt](evidence/levels-3-4/schema.txt) |
| Миграции с нуля и повтор без дублей | Чистые volumes, затем повторный запуск | PASS: версия 5 и количества строк не изменились | `repeat_migrations` в [summary](evidence/levels-3-4/summary.json) |
| Атомарное создание чата | FK-ошибка участников после INSERT чата | PASS: 400, чат и частичные участники отсутствуют, количества таблиц прежние | `chat_creation_rollback` в [summary](evidence/levels-3-4/summary.json) |
| Basic только для входа, Bearer на бизнес-запросах | Публичный smoke | PASS: вход 201; Basic на private endpoint — 401 | [stdout](evidence/levels-3-4/checks.txt) |
| X-User-Id не даёт доступ | Публичный smoke | PASS: без Bearer — 401; дополнительный заголовок не меняет Bearer-пользователя | [stdout](evidence/levels-3-4/checks.txt) |
| Expiry, отзыв сессии и KDF | Smoke, короткий TTL, проверка алгоритма БД | PASS: logout/reuse — 401; TTL 2 с истекает; Argon2id m=65536,t=3,p=4; новый nonce 32 байта | [summary](evidence/levels-3-4/summary.json) |
| make check, make test, make test-persistence | Запуск неизменённых публичных сценариев | PASS: все три команды exit_code=0, реальный вывод сохранён | [checks.txt](evidence/levels-3-4/checks.txt) |
| Secrets и volumes вне Git | Аудит текущего tracked tree и новых материалов | PASS: env/ключи/volumes не отслеживаются, JWT и приватных ключей в материалах нет; полная история Git не сертифицировалась | `tracked_secrets_and_contract_audit` в [summary](evidence/levels-3-4/summary.json) |
| 4: осмысленный Redis-кэш, источник истины, expiry/инвалидация | Miss → DB → hit, проверка членства; политика раздела 2.5 | PASS: один lookup при холодном/повторном GET; посторонний — 404; PostgreSQL — источник истины | [summary](evidence/levels-3-4/summary.json), [первая демонстрация](evidence/redis-cache.md) |
| Параметризованный SQL, ограниченный pool и таймауты | Пул 2 при восьми параллельных запросах и заблокированный SQL | PASS: максимум 2 соединения; 503 примерно за 2 с; основной лимит восстановлен к 10 | [summary](evidence/levels-3-4/summary.json), [startup](evidence/levels-3-4/startup.txt) |
| Гонка регистрации username | Восемь одновременных POST одного username | PASS: один 201, семь 409, одна строка БД | `username_registration_race` в [summary](evidence/levels-3-4/summary.json) |
| Rollback составной операции | Создание чата с неизвестным участником | PASS: ошибка второго INSERT не оставляет данных первого | `chat_creation_rollback` в [summary](evidence/levels-3-4/summary.json) |
| Индекс истории и EXPLAIN на ≥10 000 сообщений | 20 001 сообщение; первая и глубокая страницы | PASS: Limit → Index Scan, без полного scan; 101 запись в каждом плане | [Первая](evidence/levels-3-4/explain-first.txt), [глубокая](evidence/levels-3-4/explain-deep.txt) |
| Пагинация истории | Полный обход API страницами по 100 | PASS: все 20 001 ID в порядке, без пропусков и дублей | `history_20000_and_explain` в [summary](evidence/levels-3-4/summary.json) |
| Автоматические expiry при SESSION_TTL_SECONDS, logout, неверный пароль | Изолированный runner и публичный smoke | PASS: SESSION TTL имеет приоритет, 200 → 401; logout и неверный пароль отклоняются | [Сценарий](scripts/verify_lab2.py), [summary](evidence/levels-3-4/summary.json) |
| Недоступность Redis/БД, отсутствие анонимного доступа при отказе | Stop/start отдельных сервисов проверочного проекта | PASS: без Redis — 200; без PostgreSQL действующая сессия — 503, анонимный/неверный токен — 401; после старта данные доступны | [summary](evidence/levels-3-4/summary.json), [HTTP](evidence/levels-3-4/http.csv) |
| Контракт и публичные tests не ослаблены | Сравнение с upstream/master | PASS: README задания, contracts и tests не изменены | `tracked_secrets_and_contract_audit` в [summary](evidence/levels-3-4/summary.json) |
| 5, трек 1: stampede, защита, SQL/latency до и после | Исторический эксперимент 10 × 32 GET | PASS на идентифицированной предшествующей сборке: SELECT чата 308 → 10, ошибок нет | [Методика и результаты](evidence/cache-stampede/README.md) |
| Read-after-write и Redis restart выбранного трека | Создание сообщения, чтение другим участником, рестарт кэша | Подтверждено историческим экспериментом; сохранность после полного рестарта дополнительно проверена итоговой приёмкой | [Трек 1](evidence/cache-stampede/summary.json), [приёмка](evidence/levels-3-4/summary.json) |
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
Трек 2 с ≥100 000 сообщений и backup → restore не выбран; его выполнение не требуется для выбранного трека и не заявляется.
## Эксперименты и отказы
## 4. Эксперименты и отказы
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
Разделы 4.1–4.4 сохраняют результаты предшествующих сборок. Исправления и итоговая проверка уровней 3/4 выполнены позже на отдельном стенде; они описаны в разделе 4.5. Старые численные результаты не пересчитывались и не выдаются за измерения новой сборки.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
### 4.1. Последовательный кэш и необязательный Redis
[Первый эксперимент](evidence/redis-cache.md) выполнен 6 ноября 2026 года до добавления singleflight. Удалялся только ключ синтетического чата. Первый GET дал `chat_cache_miss` и `chat_db_lookup`, повторный — `chat_cache_hit` без чтения чата из БД. Посторонний пользователь при заполненном кэше получил 404.
При остановленном Redis GET вернул 200 за 56,076 мс. API был пересоздан при всё ещё остановленном Redis и продолжил работу: GET — 200 за 72,418 мс. После запуска Redis кэш восстановился без ещё одного перезапуска API. Эти результаты относятся к предшествующей сборке, идентифицированной в соответствующем отчёте; отказ Redis также повторён на версии с singleflight в следующем эксперименте.
### 4.2. Cache stampede: гипотеза и методика
Гипотеза: при одновременном промахе один и тот же пользователь многократно читает чат из PostgreSQL; singleflight позволит выполнять одну общую загрузку.
Итоговый сравнительный прогон: 6 ноября 2026 года, 09:49:37–09:50:20 UTC. Стенд — Docker Engine 29.7.2, Linux/aarch64, 14 CPU, 8 320 954 368 байт памяти Docker VM (примерно 7,75 GiB), без отдельных CPU/RAM-лимитов контейнеров. PostgreSQL 17.11, Redis 8.2.11, одна API-реплика. Один синтетический чат с двумя участниками; третий пользователь посторонний.
Перед исправлением собран baseline, затем отдельный образ с singleflight. Их точные IDs, хэши исходников и [patch изменения](evidence/cache-stampede/singleflight.patch.txt) сохранены вместе с результатами. Полная инструкция восстановления baseline в отдельной копии и сборки двух образов находится в [методике](evidence/cache-stampede/README.md); переключатель отключения защиты в приложение не добавлялся. В текущем дереве patch называется `singleflight.patch.txt`; при воспроизведении команды из методики нужно использовать это актуальное имя вместо прежнего `singleflight.patch`:
```sh
# В отдельной временной копии итоговых исходников baseline восстанавливается так:
git apply --reverse evidence/cache-stampede/singleflight.patch.txt
```
Обратный patch следует применять только в копии для сборки baseline, сохраняя основное рабочее дерево с исправлением.
Для обеих версий проведены 10 холодных наплывов по 32 GET одного участника с общим стартовым барьером. Перед каждым удалялся только экспериментальный ключ. Чтобы промахи воспроизводились на быстрой локальной БД, отдельная транзакция получала `ACCESS EXCLUSIVE` на таблицу `chats` и освобождала её через 200 мс после барьера. Это искусственная задержка чтения, одинаковая до/после; она блокирует всю таблицу и предназначена только для локального стенда. Дополнительно выполнены по 5 тёплых наплывов по 32 GET без блокировки. Между группами была пауза 300 мс.
SQL измерялся по разности `pg_stat_statements.calls` до/после каждого прогона, отдельно для SELECT чата и SELECT сессии. Расширение и preload включались временно, без глобального сброса статистики; после завершения убраны с восстановлением обычного Compose и сохранением volumes. Это серверный подсчёт SQL, а не вывод только из `chat_db_lookup`.
HTTP-длительности измерены монотонными часами клиента; timeout — 5 секунд. Перцентили рассчитаны ближайшим рангом по всем запросам серии. Все успешные GET сравнены с полным объектом чата. В дополнительных сценариях получены ожидаемые 404, ошибки доступа не смешаны с сетевыми сбоями.
### 4.3. Результаты до и после
| Версия / режим | Группы / GET | SELECT чата | SELECT сессии | p50, мс | p95, мс | p99, мс | Ошибки ответов |
| --- | --- | --- | --- | --- | --- | --- | --- |
| До, пустой кэш | 10 / 320 | 308 | 320 | 208,124 | 215,502 | 260,385 | 0 |
| После, пустой кэш | 10 / 320 | 10 | 320 | 207,056 | 209,568 | 210,032 | 0 |
| До, заполненный кэш | 5 / 160 | 0 | 160 | 138,915 | 161,038 | 172,568 | 0 |
| После, заполненный кэш | 5 / 160 | 0 | 160 | 136,467 | 172,304 | 200,266 | 0 |
Чтения чата сократились на **96,75%**: в среднем 30,8 → 1 на холодный наплыв. С учётом SELECT проверки сессий эти два вида SQL сократились с 628 до 330, на **47,45%**. Проверки сессий по-прежнему выполняются на каждом GET, поэтому «один SELECT чата» не означает «один SQL на весь наплыв».
В холодной серии p50 почти не изменился из-за общей задержки 200 мс; p99 уменьшился примерно на 50 мс. Тёплый p95, наоборот, вырос. Один последовательный порядок «до → после», небольшой объём и искусственная блокировка не доказывают устойчивое ускорение или предел throughput. Подтверждённый результат — устранение дублирующихся загрузок для выбранного ключа, а не ускорение любого HTTP-запроса.
Во время обеих фаз одинаково собирался `docker stats`. Максимальные значения среди восьми выборок каждой фазы:
| Контейнер | CPU до / после | MemUsage до / после |
| --- | --- | --- |
| API | 280,69% / 213,82% | 140,30 / 19,36 MiB |
| PostgreSQL | 5,44% / 5,44% | 52,64 / 48,31 MiB |
| Redis | 1,97% / 1,84% | 11,29 / 11,21 MiB |
Это максимумы наблюдавшихся выборок, а не точные мгновенные пики; CPU более 100% означает несколько ядер. Регистрация пользователей выполнялась перед baseline, а исправленный API использовал уже созданные записи. Поэтому различие heap/GC и памяти API нельзя приписывать singleflight.
Сводные исходные данные:
- [summary.json](evidence/cache-stampede/summary.json): параметры, образы, SQL-снимки и разности, перцентили по группам, batch RPS, выборки ресурсов и функциональные checks.
- [requests.csv](evidence/cache-stampede/requests.csv): 1016 GET основного сравнения и дополнительных наплывов, включая 8 ожидаемых 404; все ответы признаны корректными.
- [api.log](evidence/cache-stampede/api.log): выбранные события кэша и состояния контейнеров.
- [Первый сценарий: CSV](evidence/redis-cache-requests.csv) и [журнал](evidence/redis-cache-api.log).
Batch RPS в JSON учитывает время завершения группы и исключает подготовку и паузы. Он не является измерением устойчивой производительности открытого потока запросов. Пароли, Bearer-токены и ответы создания сессий в материалы не включались.
### 4.4. Дополнительные сценарии и границы восстановления
| Воздействие / сценарий | Ожидаемое поведение | Фактический результат | Границы вывода |
| --- | --- | --- | --- |
| TODO | TODO | TODO | TODO |
| Смешанный холодный наплыв: два участника и посторонний | 200 участникам, 404 постороннему | 12 GET, 3 SELECT чата, 12 SELECT сессии; все статусы корректны | Ключ singleflight включает пользователя, поэтому общее чтение не одно для всех пользователей |
| Та же группа с заполненным кэшем | Те же права без чтения чата из БД | 12 GET, 0 SELECT чата | Проверки сессий остаются |
| Отмена первого клиента во время заблокированного SELECT | Остальные клиенты продолжают общую загрузку | Следующий клиент получил 200 за 104,652 мс; один SELECT чата на два запроса | Проверена отмена инициатора, не все возможные сетевые отказы |
| POST сообщения → GET другим участником | Подтверждённое сообщение сразу видно | POST — 201; следующий GET — 200, ID сообщения найден | Одна API-реплика, история читается из PostgreSQL |
| Остановка Redis на исправленной версии | Доступ к чату через PostgreSQL | GET — 200 за 62,674 мс | Docker DNS вернул ошибку подключения; сетевой blackhole не моделировался |
| Запуск Redis с прежним volume | Возобновление кэша без рестарта API | `EXISTS` до/после — 1/1; GET — 200 за 48,701 мс; ID контейнера API не изменился | 48,701 мс — длительность GET после готовности, а не RTO Redis |
| Чтение истории после Redis restart | Сессия и подтверждённое сообщение сохранены | Прежняя сессия дала 200, ID сообщения найден | PostgreSQL в этом сценарии не перезапускался |
| DEL тестового ключа после восстановления | Защищённое заполнение пустого кэша | 32 GET, один SELECT чата, 32 SELECT сессии, ошибок нет | Действует для одного пользователя внутри одной API-реплики |
| Пересоздание API при остановленном Redis | Запуск без необязательной зависимости | На предшествующей версии GET — 200 за 72,418 мс, startup warning записан | Результат отдельно идентифицирован в первом эксперименте |
| Отказ PostgreSQL | Отказ обязательного пути без обхода аутентификации | В исходном stampede-эксперименте не проверялся; позже подтверждён в разделе 4.5 | Актуальный readiness возвращает 503; RTO потери хоста не измерялся |
| Полный рестарт всех сервисов / потеря хоста или диска | Сохранность / аварийное восстановление | Полный рестарт позже подтверждён persistence; потеря диска не исследовалась | RPO/RTO потери хоста и backup → restore не измерены |
## Ограничения и следующие шаги
Оба эксперимента завершились с работающими API, PostgreSQL и Redis; итоговые healthy-состояния записаны в приложенных журналах. Это наблюдение на момент эксперимента, а не текущая непрерывная гарантия доступности. Обязательные данные и volumes не удалялись. Синтетические учётные записи и данные экспериментов остаются на локальном стенде.
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
### 4.5. Итоговая приёмка уровней «3» и «4»
Прогон 2026-11-06T10:43:16.282804Z — 2026-11-06T10:44:52.582387Z UTC завершился PASS во всех 16 группах. Образ: `sha256:0effe11ab9f4d860b5b79d6096ff95325336c752c0d5ca335878ec89baf4f269`, SHA-256 исходников: `11bd17ca0b86a6db845ec7c2954c91fd8a870e1999ca45d708a546f0f863fb0e`. Точный состав хэшируемых файлов, параметры, проект и stdout сохранены в [evidence/levels-3-4](evidence/levels-3-4/README.md).
Включены миграции с нуля и повтор, публичные check/smoke/persistence, реальное пересоздание трёх контейнеров с прежними volumes, KDF/случайность JWT, совместимость TTL и ошибки конфигурации, 14 отрицательных случаев контракта, гонка username, rollback, 20 001 сообщение и EXPLAIN, короткое expiry, отказ Redis/PostgreSQL, pool limit и SQL deadline.
При отказе Redis GET дал 200 за 62.898 мс. При отказе PostgreSQL — 503 за 2.511 мс, readiness — 503 за 10.516 мс; анонимный и неверный Bearer получили 401, liveness остался 200. После старта БД прежняя сессия вновь работала. При пуле 2 восемь заблокированных запросов завершились 503 за 2005.983–2008.694 мс; после освобождения блокировки и возврата пула к 10 работа восстановлена.
Для EXPLAIN первая и глубокая страницы вернули по 101 записи через индекс; Execution Time — 0.04 и 0.082 мс соответственно. Полный обход API дал все 20 001 сообщений в порядке. Это измерения конкретных запросов на синтетических данных, не универсальный SLA.
Проверочный проект остановлен без удаления volumes; локальные секреты находятся вне Git. Основной работающий стенд на 8080 не перезапускался. Исправленная сборка проверена на 18084; для применения изменений к основному стенду его API нужно отдельно пересобрать и пересоздать обычной командой запуска.
## 5. Ограничения и дальнейшая работа
Обязательные сценарии уровней «3» и «4» теперь имеют реальные успешные результаты. Исправлены SESSION_TTL_SECONDS с совместимым fallback, применение MaxConns, connect/query timeouts, обработка недоступности БД через 503, PostgreSQL readiness, безопасное закрытие мигратора, случайный nonce JWT и HTTP 400 для ошибок валидации. Пример окружения и restart-hook приведены к актуальному запуску.
Остаются границы проведённых исследований:
1. Проверки выполнены с одной API-репликой. Singleflight объединяет только одинаковую пару «чат + пользователь» внутри процесса; распределённой защиты нет.
2. Кэш не имеет TTL и автоматической инвалидации. Обязательный API не изменяет членство; будущие изменения состава участников должны сопровождаться отдельной политикой согласованности.
3. При отказе PostgreSQL авторизованный API не работает независимо от заполненного Redis: серверная сессия проверяется в БД. Это корректный 503, а не режим автономной работы.
4. Исследованы stop/start и пересоздание контейнеров с сохранением volumes. Потеря питания/диска, HA, сетевой blackhole и backup → restore не исследовались, их RPO/RTO не заявляются.
5. Старый stampede-эксперимент относится к предшествующей сборке. Его сравнение и ограничения сохранены; его цифры нельзя выдавать за производительность новой конфигурации пула.
6. Локальный HTTP и PostgreSQL sslmode=disable предназначены для учебного стенда. TLS и production hardening не входят в выполненную проверку.
7. Аудит секретов охватил текущее отслеживаемое дерево и новые материалы; полная история Git отдельно не сертифицировалась. Публичный smoke также не является полным fuzz/security suite.
Доказанная экономия чтений чата не устраняет SELECT и bcrypt-проверку сессии на каждом запросе. Значения задержек в evidence — наблюдения данного стенда; автоматические сценарии и серверные таймауты дают проверяемые ограничения для исследованных отказов, а не универсальные гарантии доступности.
## 6. Источники и материалы
- [Задание и критерии](README.md), [семантика API](contracts/README.md), [OpenAPI](contracts/openapi.json), [описание публичных проверок](tests/README.md).
- [Dockerfile](Dockerfile), [Compose](docker-compose.yml), [пример окружения](.env.example), [список зависимостей](service/go.mod).
- [Приёмка уровней 3/4](evidence/levels-3-4/README.md), [runner](scripts/verify_lab2.py).
- [Эксперимент кэша и отказа Redis](evidence/redis-cache.md), [эксперимент stampede](evidence/cache-stampede/README.md), [скрипт воспроизведения](scripts/cache_stampede.py).
- [singleflight v0.23.0](https://pkg.go.dev/golang.org/x/sync@v0.23.0/singleflight), [PostgreSQL 17: pg_stat_statements](https://www.postgresql.org/docs/17/pgstatstatements.html).
- [Redis: использование go-redis](https://redis.io/docs/latest/develop/clients/go/produsage/), [Redis INFO](https://redis.io/docs/latest/commands/info/).
При актуализации отчёта исправлена реализация и выполнена отдельная приёмка уровней 3/4; старые материалы экспериментов сохранены. Авторские данные и существующие пользовательские изменения сохранены. Ссылки, числа и исходники сверяются с evidence; новые unit-тесты не добавлялись, публичные tests и контракт не изменялись.
+98
View File
@@ -0,0 +1,98 @@
services:
api:
build:
context: .
dockerfile: Dockerfile
container_name: api
image: mtusi-messenger:lab2
restart: unless-stopped
environment:
APP_ENABLED: "true"
APP_HOST: ${APP_HOST:-0.0.0.0}
APP_PORT: ${APP_PORT:-8080}
APP_READ_TIMEOUT: ${APP_READ_TIMEOUT:-5s}
APP_WRITE_TIMEOUT: ${APP_WRITE_TIMEOUT:-10s}
APP_IDLE_TIMEOUT: ${APP_IDLE_TIMEOUT:-60s}
APP_SHUTDOWN_TIMEOUT: ${APP_SHUTDOWN_TIMEOUT:-8s}
APPLICATION_LOG_LEVEL: ${APPLICATION_LOG_LEVEL:-info}
APPLICATION_ENVIRONMENT: ${APPLICATION_ENVIRONMENT:-dev}
APPLICATION_SHUTDOWN_TIMEOUT: ${APPLICATION_SHUTDOWN_TIMEOUT:-8s}
APPLICATION_REQUEST_RATE_LIMIT: ${APPLICATION_REQUEST_RATE_LIMIT:-100}
APPLICATION_BURST_RATE_LIMIT: ${APPLICATION_BURST_RATE_LIMIT:-100}
APPLICATION_RATE_LIMIT_TTL: ${APPLICATION_RATE_LIMIT_TTL:-1m}
POSTGRES_HOST: ${POSTGRES_HOST:-postgres}
POSTGRES_PORT: ${POSTGRES_PORT:-5432}
POSTGRES_USER: ${POSTGRES_USER:-messenger}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}
POSTGRES_DATABASE: ${POSTGRES_DATABASE:-messenger}
POSTGRES_VERSION_TABLE: ${POSTGRES_VERSION_TABLE:-versions}
POSTGRES_RUN_MIGRATIONS: ${POSTGRES_RUN_MIGRATIONS:-true}
POSTGRES_MAX_CONNECTIONS: ${POSTGRES_MAX_CONNECTIONS:-10}
POSTGRES_CONNECT_TIMEOUT: ${POSTGRES_CONNECT_TIMEOUT:-500ms}
POSTGRES_QUERY_TIMEOUT: ${POSTGRES_QUERY_TIMEOUT:-2s}
REDIS_HOST: ${REDIS_HOST:-redis}
REDIS_PORT: ${REDIS_PORT:-6379}
REDIS_USERNAME: ${REDIS_USERNAME:-default}
REDIS_PASSWORD: ${REDIS_PASSWORD:?Set REDIS_PASSWORD in .env}
REDIS_DB: ${REDIS_DB:-0}
JWT_ACCESS_TOKEN_LIFETIME: ${JWT_ACCESS_TOKEN_LIFETIME:-15m}
SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-}
JWT_REFRESH_TOKEN_LIFETIME: ${JWT_REFRESH_TOKEN_LIFETIME:-}
JWT_PUBLIC_KEY_PATH: ${JWT_PUBLIC_KEY_PATH:-/run/certs/public_key.pem}
JWT_PRIVATE_KEY_PATH: ${JWT_PRIVATE_KEY_PATH:-/run/certs/private_key.pem}
depends_on:
postgres:
condition: service_healthy
volumes:
- type: bind
source: ./certs
target: /run/certs
read_only: true
bind:
create_host_path: false
ports:
- "127.0.0.1:${HOST_PORT:-8080}:8080"
stop_grace_period: 10s
postgres:
image: postgres:17.11-alpine3.23
restart: unless-stopped
environment:
POSTGRES_USER: ${POSTGRES_USER:-messenger}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}
POSTGRES_DB: ${POSTGRES_DATABASE:-messenger}
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: [ "CMD-SHELL", "pg_isready -h 127.0.0.1 -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\"" ]
interval: 5s
timeout: 3s
start_period: 30s
retries: 12
stop_grace_period: 60s
redis:
image: redis:8.2.11-alpine3.22
restart: unless-stopped
environment:
REDIS_PASSWORD: ${REDIS_PASSWORD:?Set REDIS_PASSWORD in .env}
# Redis does not apply REDIS_PASSWORD by itself. Re-enter its entrypoint
# with redis-server so it also drops privileges to the redis user.
command:
- sh
- -c
- exec docker-entrypoint.sh redis-server --appendonly yes --appendfsync everysec --requirepass "$$REDIS_PASSWORD"
volumes:
- redis_data:/data
healthcheck:
test: [ "CMD-SHELL", "REDISCLI_AUTH=\"$${REDIS_PASSWORD}\" redis-cli --no-auth-warning ping | grep -qx PONG" ]
interval: 5s
timeout: 3s
start_period: 5s
retries: 12
stop_grace_period: 30s
volumes:
postgres_data:
redis_data:
+8
View File
@@ -3,3 +3,11 @@
Храните небольшие обезличенные результаты: команды и stdout проверок, JSON/CSV агрегатов нагрузки, EXPLAIN, dashboard JSON, текст разбора отказа. Укажите дату, commit, аппаратные лимиты и профиль нагрузки.
Не добавляйте .env, session tokens, cookies, приватные ключи, credentials, реальные сообщения, raw dumps и signed URLs. Для скриншотов скрывайте секреты. Большие логи/бинарные traces сохраняйте отдельно по правилам преподавателя; одного скриншота без методики недостаточно.
## Выполненные проверки
- [Кэш чатов и отказ Redis](redis-cache.md): экономия чтения чата, проверка доступа, запуск API без Redis и восстановление кэша; журнал и CSV приложены.
- [Cache stampede: эксперимент до/после](cache-stampede/README.md): SQL-статистика PostgreSQL, задержки, защита singleflight, read-after-write и рестарт Redis.
- [Проверки уровней 3 и 4](levels-3-4/README.md): 16 групп PASS, публичные check/smoke/persistence, миграции, гонка/rollback, история 20 001 сообщений с EXPLAIN, expiry и отказы зависимостей.
+121
View File
@@ -0,0 +1,121 @@
# Cache stampede: воспроизведение, исправление и сравнение
## Результат и гипотеза
При одновременном GET одного чата несколько запросов видят пустой Redis и независимо выполняют один и тот же SELECT PostgreSQL. Гипотеза: объединение таких загрузок через singleflight сократит число SQL-запросов чтения чата до одного на наплыв одного пользователя.
В завершённом сравнении **308 SELECT чата до исправления → 10 после** для одинаковых 10 наплывов по 32 GET: снижение на 96.75%, в среднем 30.8 → 1.0 SELECT на наплыв. До исправления получалось 27–32 чтения на наплыв, после — ровно одно в каждом из 10 прогонов.
Проверки сессий отдельно выполнили 320 SELECT в каждой серии. С учётом этих двух видов SELECT общее число уменьшилось с 628 до 330, на 47.45%. Это измерения `pg_stat_statements`, а не оценка по числу HTTP-запросов или логов.
## Стенд и идентификация
- Время: 2026-11-06T09:49:37.903672Z — 2026-11-06T09:50:20.072991Z UTC (Москва UTC+3).
- Базовый commit: `8d44c745358f131ac2836ac05153af687bcf6bc0`; проверялось изменённое рабочее дерево с ранее незакоммиченными изменениями пользователя. Этот commit сам по себе не содержит проверяемую реализацию.
- Baseline image ID: `sha256:9c289d3a5a1043411647917239ec36394a5950203d03bb2c40e8dc1ff59da9cc`.
- Fixed image ID: `sha256:98776dbb15c7e0b2827a1fb96ac04a96dc48dd584a1076f71847b80cb36bc332`.
- Docker Engine 29.7.2; linux/aarch64 CPUs=14 memory_bytes=8320954368. Docker VM имеет примерно 7,75 GiB памяти; отдельных лимитов CPU/RAM у сервисов нет. Одна API-реплика; Go 1.27.2 в Dockerfile; PostgreSQL 17.11, Redis 8.2.11, go-redis v9.23.0, golang.org/x/sync v0.23.0.
- Тестовый чат: `f6da90da-8c90-4044-b1f6-29d41b5081c0`. Один новый чат с двумя синтетическими участниками; третий пользователь в него не входит. Создано одно синтетическое сообщение. Существующие пользовательские данные не удалялись; экспериментальные записи остаются в PostgreSQL.
SHA-256 исходника сервиса, go.mod и скрипта, параметры запуска и ограничения контейнера сохранены в [summary.json](summary.json). До/после использовались те же чат, пользователи и сессии. Для сбора SQL-статистики PostgreSQL временно запускался с `shared_preload_libraries=pg_stat_statements`; расширение отсутствовало до эксперимента и было создано только на время измерения.
## Изменение реализации
В `GetForMember` быстрый путь Redis сохранён. На промахе запросы объединяются `singleflight.Group.DoChan` по ключу `(ChatID, UserID)`. SQL `GetForMember` зависит от пользователя, поэтому объединять его результаты только по ChatID нельзя: отказ постороннего мог бы попасть участнику.
Внутри общей загрузки Redis проверяется повторно, затем при необходимости читается PostgreSQL и заполняется кэш. Каждый ожидающий запрос учитывает собственную отмену; общая загрузка использует `context.WithoutCancel` и отдельный таймаут 2 секунды. Отмена первого клиента не срывает загрузку для остальных. Перед возвратом проверяется `MemberIDs`. Ошибки загрузки не сохраняются после завершения singleflight; ошибки Redis по-прежнему обходятся через PostgreSQL. Таймауты Redis из предыдущей работы сохранены.
HTTP-контракт и SQL-схема приложения не менялись. Модуль x/sync уже был в зависимостях; версия не обновлялась. Точная разница с baseline сохранена в [singleflight.patch](singleflight.patch).
## Повторяемая методика
Запускать на локальном стенде без постороннего трафика. Требуются Docker Compose, Python 3.9+ и подготовленные `.env` и сертификаты по инструкции проекта. Скрипт создаёт синтетические учётные записи; пароли и Bearer-токены остаются только в памяти и не попадают в файлы или аргументы процессов.
Для повторного сравнения из итогового исходного дерева сначала подготовить baseline в отдельной временной копии. Обратный patch применяется только в копии:
```sh
baseline_dir=$(mktemp -d)
tar --exclude='.git' --exclude='.env*' --exclude='certs' --exclude='.venv' \
-cf - . | tar -xf - -C "$baseline_dir"
(cd "$baseline_dir" && git apply --reverse evidence/cache-stampede/singleflight.patch)
docker build -t mtusi-messenger:stampede-before "$baseline_dir"
docker compose --env-file .env build api
docker image tag mtusi-messenger:lab2 mtusi-messenger:stampede-after
docker compose --env-file .env up -d --no-build
python3 scripts/cache_stampede.py \
--before-image mtusi-messenger:stampede-before \
--after-image mtusi-messenger:stampede-after \
--concurrency 32 --repetitions 10 --lock-ms 200
```
Скрипт временно включает pg_stat_statements через отдельный Compose override в системном временном каталоге и переключает образы API без изменения основного Compose. Перезапуск PostgreSQL сохраняет volume. Глобальный сброс SQL-статистики не используется: для каждого прогона снимаются значения `calls` до и после отдельно для SELECT чата и SELECT сессии, с фильтром по БД и нормализованной форме запроса. Значения параметров SQL не выгружаются. Снимки, query IDs и разности находятся в JSON. Диагностические `chat_db_lookup` в журнале служат дополнительным подтверждением.
Перед каждым холодным прогоном удаляется только `chat:<экспериментальный ChatID>` в настроенной Redis DB. Все 32 потока сначала обращаются к `/health/live`, затем ожидают общего барьера. Отдельная транзакция предварительно получает `LOCK TABLE chats IN ACCESS EXCLUSIVE MODE`; через 200 мс после барьера выполняется ROLLBACK. Это моделирует медленное чтение чатов и делает одновременные промахи воспроизводимыми. Session SELECT таблицу `chats` не использует. Блокировка освобождается в `finally`; дополнительно действует пятисекундный `idle_in_transaction_session_timeout`.
Блокировка относится ко всей таблице `chats`, а не только к тестовому чату: во время этих коротких окон прочие операции с этой таблицей также будут ждать. Поэтому методика предназначена для локального стенда. В приложение искусственные задержки не добавлены.
Для каждого образа выполнены 10 холодных наплывов по 32 GET и 5 тёплых наплывов по 32 GET без блокировки. Между группами выдерживается пауза 300 мс; создание пользователей, переключение образа, сбор статистики и паузы не входят в длительность HTTP-запросов. Часы клиента монотонные; HTTP timeout — 5 секунд. Все 200-ответы сравнены с полным объектом созданного чата.
## SQL и задержки до/после
Перцентили ниже вычислены методом ближайшего ранга по всем запросам соответствующей серии; это не среднее перцентилей отдельных прогонов. Основная таблица исключает дополнительные функциональные сценарии и прогон после рестарта Redis.
| Версия и режим | Прогоны / GET | SELECT чата | SELECT сессии | p50 / p95 / p99, мс | Ошибки |
| --- | --- | --- | --- | --- | --- |
| До: пустой кэш, 200 мс | 10 / 320 | 308 | 320 | 208.124 / 215.502 / 260.385 | 0 |
| До: заполненный кэш | 5 / 160 | 0 | 160 | 138.915 / 161.038 / 172.568 | 0 |
| После: пустой кэш, 200 мс | 10 / 320 | 10 | 320 | 207.056 / 209.568 / 210.032 | 0 |
| После: заполненный кэш | 5 / 160 | 0 | 160 | 136.467 / 172.304 / 200.266 | 0 |
Полные длительности, статусы, корректность ответов и request IDs находятся в [requests.csv](requests.csv); по каждому наплыву JSON содержит перцентили, время завершения группы и successful batch RPS. Batch RPS не учитывает паузы и подготовку и не является доказательством устойчивой пропускной способности.
В холодной серии p50 почти одинаков: основную задержку задаёт общее ожидание блокировки. p99 в этом запуске уменьшился с 260,385 до 210,032 мс, однако один порядок запуска «до → после» не доказывает устойчивое ускорение. У тёплой серии p95 вырос с 161,038 до 172,304 мс, хотя SQL чтения чата в обеих версиях равен нулю. Нагрузка проверок сессии, включая bcrypt-проверку токена, осталась; шум и порядок запуска не контролировались отдельными случайными перестановками. Надёжный результат эксперимента — подавление дублирующихся SELECT чата, а не универсальное сокращение задержки каждого запроса.
### Ресурсы
`docker stats --no-stream` собирался параллельно одинаково для обеих фаз. Ниже максимальные **наблюдавшиеся значения выборки**; CPU более 100% означает использование нескольких ядер. Выборка включает холодные и тёплые серии и интервалы между ними, это не точный мгновенный пик.
| Фаза | Контейнер | Выборок | Максимум CPU | Максимум MemUsage |
| --- | --- | --- | --- | --- |
| До | api | 8 | 280.69% | 140.30 MiB |
| До | mtusi2026lab2-postgres-1 | 8 | 5.44% | 52.64 MiB |
| До | mtusi2026lab2-redis-1 | 8 | 1.97% | 11.29 MiB |
| После | api | 8 | 213.82% | 19.36 MiB |
| После | mtusi2026lab2-postgres-1 | 8 | 5.44% | 48.31 MiB |
| После | mtusi2026lab2-redis-1 | 8 | 1.84% | 11.21 MiB |
У baseline перед замерами регистрировались пользователи, тогда как после переключения на исправленную версию использовались готовые данные. Поэтому различие занятой памяти API нельзя приписать singleflight: подготовка, состояние heap и GC различаются. Значения приведены для описания условий, без вывода об экономии RAM.
## Доступ, отмена, read-after-write и рестарт
Дополнительный смешанный холодный наплыв: 12 запросов от двух участников и постороннего; участники получили 200, посторонний — 404, ошибок ответов нет. Выполнено 3 SELECT чата — разные пользователи имеют разные ключи singleflight. При заполненном кэше та же группа выполнила 0 SELECT чата с теми же статусами.
В сценарии отмены первый HTTP-клиент дошёл до заблокированного SELECT, затем его соединение было закрыто. Следующий клиент того же пользователя получил 200 после освобождения блокировки; серверная статистика показала один SELECT чата на оба запроса. Общая загрузка пережила отмену инициатора.
Сразу после создания чат прочитан другим участником без расхождений. После подтверждённого POST сообщения другой участник сразу прочитал историю и нашёл ID созданного сообщения. История сообщений не кэшируется; источником истины остаётся PostgreSQL.
При `stop redis` GET вернул 200 из PostgreSQL за 62,674 мс. После `start redis` ключ сохранился: `EXISTS` до/после вернул `1` / `1`. Это корректный stop/start с AOF и сохранённым volume, а не проверка аварийного отключения питания. ID контейнера API не изменился; прежние сессии продолжили работать. Сообщение снова найдено в истории. После удаления тестового ключа дополнительный наплыв 32 GET выполнил один SELECT чата, 32 SELECT сессии и завершился без ошибок.
| Проверка | HTTP | Время клиента, мс |
| --- | --- | --- |
| `chat_created` | 201 | 50.800 |
| `before_chat_read_after_create` | 200 | 50.977 |
| `after_chat_read_after_create` | 200 | 60.209 |
| `leader_cancelled_survivor_succeeded` | 200 | 104.652 |
| `message_committed` | 201 | 79.656 |
| `read_after_write` | 200 | 50.551 |
| `redis_unavailable` | 200 | 62.674 |
| `redis_recovered` | 200 | 48.701 |
| `message_after_restart` | 200 | 46.597 |
В конце скрипт удалил созданное им расширение, вернул исходный запуск PostgreSQL без preload, восстановил обычный Compose с исправленным API и запущенным Redis. `restored_preload` пуст, `extension_restored=true`; volumes не удалялись. Итоговые состояния контейнеров и диагностические записи находятся в [api.log](api.log). Логи содержат только выбранные события экспериментального чата и состояния контейнеров, без тел запросов и ответов создания сессий.
## Ограничения и вывод
Защита подавляет одновременные загрузки одинаковой пары `(ChatID, UserID)` внутри одной API-реплики. Для наплыва разных пользователей или нескольких реплик может выполняться несколько SELECT; распределённой блокировки нет. Отрицательные ответы не кэшируются. Чат хранится в Redis без TTL; обязательный API не изменяет состав участников. При добавлении таких изменений понадобится инвалидация.
Функциональные проверки read-after-write выполнены на имеющемся стенде с одной API-репликой, а не на многорепличной конфигурации. Данные небольшие; 200 мс созданы блокировкой, а не измерены как естественная задержка production-БД. Сравнение не оценивает предел throughput, поведение при сетевом blackhole или все требования оценки «5».
Сборка `go build -mod=readonly ./...` прошла локально с GOCACHE во временном каталоге и в Docker. `git diff --check` прошёл. Новые unit-тесты не добавлялись; скрипт является воспроизводимым инструментом эксперимента. Реализация и эксперимент подготовлены с помощью ИИ Codex.
Источники: [singleflight](https://pkg.go.dev/golang.org/x/sync@v0.23.0/singleflight), [PostgreSQL 17 pg_stat_statements](https://www.postgresql.org/docs/17/pgstatstatements.html), требования трека в [README](../../README.md), [контракт read-after-write](../../contracts/README.md).
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,135 @@
--- a/service/internal/service/chat/svc.go
+++ b/service/internal/service/chat/svc.go
@@ -11,6 +11,7 @@
"github.com/google/uuid"
"github.com/jackc/pgx/v5"
"github.com/redis/go-redis/v9"
+ "golang.org/x/sync/singleflight"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
@@ -18,12 +19,15 @@
)
var _ API = (*Chat)(nil)
+
+const chatLoadTimeout = 2 * time.Second
type Chat struct {
tm *txmanager.TransactionManager
chatsRepo chatsRepo
messagesRepo messagesRepo
chatsCache chatsCache
+ loads singleflight.Group
}
func New(tm *txmanager.TransactionManager, chatsRepo chatsRepo, messagesRepo messagesRepo, chatsCache chatsCache) *Chat {
@@ -72,30 +76,68 @@
}
func (c *Chat) GetForMember(ctx context.Context, req dto.ChatMember) (*dto.Chat, error) {
- chat, err := c.chatsCache.Get(ctx, req.ChatID)
- if err == nil {
- slog.Info("chat_cache_hit", "chat_id", req.ChatID)
- if !slices.Contains(chat.MemberIDs, req.UserID) {
- return nil, apperr.New(apperr.CodeNotFound, "chat not found")
+ if err := ctx.Err(); err != nil {
+ return nil, err
+ }
+ if chat, err := c.cachedChat(ctx, req.ChatID); err == nil {
+ return chatForMember(chat, req.UserID)
+ }
+
+ // Repository results depend on membership: never share a user's 404 with
+ // another user requesting the same chat.
+ key := req.ChatID.String() + ":" + req.UserID.String()
+ result := c.loads.DoChan(key, func() (any, error) {
+ // One client disconnecting must not cancel the other clients' load.
+ loadCtx, cancel := context.WithTimeout(context.WithoutCancel(ctx), chatLoadTimeout)
+ defer cancel()
+
+ // A previous load may have populated Redis after our initial miss.
+ if chat, err := c.cachedChat(loadCtx, req.ChatID); err == nil {
+ return chatForMember(chat, req.UserID)
+ }
+
+ slog.Info("chat_db_lookup", "chat_id", req.ChatID)
+ chat, err := c.chatsRepo.GetForMember(loadCtx, req)
+ if err != nil {
+ return nil, err
+ }
+ if err = c.chatsCache.Create(loadCtx, *chat); err != nil {
+ slog.Warn("failed to cache chat", "chat_id", req.ChatID, "error", err)
}
return chat, nil
- }
-
- if errors.Is(err, redis.Nil) {
- slog.Info("chat_cache_miss", "chat_id", req.ChatID)
- } else {
- slog.Warn("chat_cache_read_error", "chat_id", req.ChatID, "error", err)
- }
-
- slog.Info("chat_db_lookup", "chat_id", req.ChatID)
- chat, err = c.chatsRepo.GetForMember(ctx, req)
- if err != nil {
- return nil, err
- }
- if err = c.chatsCache.Create(ctx, *chat); err != nil {
- slog.Warn("failed to cache chat", "chat_id", req.ChatID, "error", err)
- }
-
+ })
+
+ select {
+ case <-ctx.Done():
+ return nil, ctx.Err()
+ case loaded := <-result:
+ if err := ctx.Err(); err != nil {
+ return nil, err
+ }
+ if loaded.Err != nil {
+ return nil, loaded.Err
+ }
+ return chatForMember(loaded.Val.(*dto.Chat), req.UserID)
+ }
+}
+
+func (c *Chat) cachedChat(ctx context.Context, chatID uuid.UUID) (*dto.Chat, error) {
+ chat, err := c.chatsCache.Get(ctx, chatID)
+ switch {
+ case err == nil:
+ slog.Info("chat_cache_hit", "chat_id", chatID)
+ case errors.Is(err, redis.Nil):
+ slog.Info("chat_cache_miss", "chat_id", chatID)
+ default:
+ slog.Warn("chat_cache_read_error", "chat_id", chatID, "error", err)
+ }
+ return chat, err
+}
+
+func chatForMember(chat *dto.Chat, userID uuid.UUID) (*dto.Chat, error) {
+ if !slices.Contains(chat.MemberIDs, userID) {
+ return nil, apperr.New(apperr.CodeNotFound, "chat not found")
+ }
return chat, nil
}
--- a/service/go.mod
+++ b/service/go.mod
@@ -14,6 +14,7 @@
github.com/spf13/viper v1.21.0
go.uber.org/multierr v1.11.0
golang.org/x/crypto v0.57.0
+ golang.org/x/sync v0.23.0
google.golang.org/grpc v1.85.0
)
@@ -51,7 +52,6 @@
github.com/vgarvardt/pgx-google-uuid/v5 v5.6.0 // indirect
go.uber.org/atomic v1.12.0 // indirect
go.yaml.in/yaml/v3 v3.0.5 // indirect
- golang.org/x/sync v0.23.0 // indirect
golang.org/x/sys v0.48.0 // indirect
golang.org/x/text v0.42.0 // indirect
)
File diff suppressed because it is too large Load Diff
+90
View File
@@ -0,0 +1,90 @@
# Проверка требований лабораторной 2: уровни «3» и «4»
Итог: **16 из 16 групп проверок PASS** на исправленной сборке. Команды и исходные результаты сохранены; существующие публичные проверки выполнены без изменений. Это подтверждение перечисленных сценариев на указанном стенде, а не гарантия отсутствия любых ошибок.
## Идентификация и изоляция
- Период: 2026-11-06T10:43:16.282804Z — 2026-11-06T10:44:52.582387Z UTC.
- Базовый commit: `711754bbcd6e47a7b83d7f5c922f5f37f6bc0764`; проверялось рабочее дерево с незакоммиченными исправлениями.
- Docker image ID: `sha256:0effe11ab9f4d860b5b79d6096ff95325336c752c0d5ca335878ec89baf4f269`.
- SHA-256 исходников Go и миграций: `11bd17ca0b86a6db845ec7c2954c91fd8a870e1999ca45d708a546f0f863fb0e`. Алгоритм: отсортированные пути всех `service/**/*.go`, затем миграций `service/migrations/*.sql`; для каждого относительный путь UTF-8, нулевой байт, содержимое файла.
- Docker Engine 29.7.2; linux/aarch64 CPUs=14 memory_bytes=8320954368; отдельные CPU/RAM limits не задавались.
- Проект: `lab2-verify-20261106t104316z-ed3f45`, порт хоста 18084; собственные PostgreSQL 17.11, Redis 8.2.11, два новых именованных volume и отдельная пара RSA-ключей.
Основной проект на порту 8080 не перезапускался, его данные не использовались и не удалялись. Доступ к тестовому проекту и повторяемая генерация данных описаны в [скрипте](../../scripts/verify_lab2.py). Пароли и ключи сохранены локально в игнорируемом `secrets/levels-3-4/<run_id>/`; значения и токены в evidence не экспортируются.
## Воспроизведение
Требуются Docker Compose v2 с `--wait`, Python 3.9+, OpenSSL, Make; на Linux — setfacl. В корне проекта:
```sh
python3 scripts/verify_lab2.py --port 18084 --output evidence/levels-3-4-repeat
```
`--output` выше сохраняет новый прогон отдельно от этих результатов. Для первоначального сохранённого прогона использовались значения по умолчанию: `python3 scripts/verify_lab2.py`.
Сценарий создаёт уникальный Compose-проект, env-файл с случайными паролями и отдельные ключи. Исполняет `make check`, `make test BASE_URL=http://127.0.0.1:18084` и `make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:18084`. Hook получает `COMPOSE_PROJECT_NAME`, `COMPOSE_ENV_FILE` и `COMPOSE_OVERRIDE_FILE`, поэтому пересоздаёт именно проверочный стенд. В конце возвращает конфигурацию с TTL 3600 и пулом 10, проверяет готовность, затем выполняет `down` без `--volumes`. При ошибке восстановление и остановка также выполняются через finally. Сохранённые volumes остаются для изучения; каждый следующий прогон получает новые.
## Результаты по группам
| Ключ в summary.json | Проверка | Результат | Время группы, с |
| --- | --- | --- | --- |
| `fresh_build_and_start` | Новые volumes, сборка и запуск с нуля | PASS | 35.497 |
| `public_check_and_smoke` | make check и публичный make test | PASS | 1.398 |
| `schema_kdf_and_session_randomness` | Схема, ограничения, Argon2id и случайность токена | PASS | 0.873 |
| `configuration_compatibility` | SESSION TTL: default, legacy, приоритет и ошибки конфигурации | PASS | 4.543 |
| `contract_validation_edges` | 14 отрицательных случаев валидации контракта | PASS | 0.396 |
| `repeat_migrations` | Повторные миграции без изменения данных | PASS | 0.877 |
| `full_persistence` | Полный рестарт API, PostgreSQL, Redis и прежняя сессия | PASS | 25.771 |
| `username_registration_race` | Гонка восьми регистраций одного username | PASS | 0.264 |
| `chat_creation_rollback` | Rollback после INSERT чата при ошибке FK участников | PASS | 0.317 |
| `history_20000_and_explain` | 20 001 сообщение, EXPLAIN и полный обход API | PASS | 10.792 |
| `session_expiry_seconds` | SESSION_TTL_SECONDS=2: 200 → 401 | PASS | 2.896 |
| `additional_authentication` | Подделанная подпись и неизвестный пользователь | PASS | 0.004 |
| `redis_cache_and_failure` | Кэш, 404 постороннему, отказ и восстановление Redis | PASS | 1.697 |
| `postgres_failure_and_recovery` | Отказ PostgreSQL, 503/401, readiness/liveness и восстановление | PASS | 0.552 |
| `pool_limit_and_sql_deadline` | Лимит пула и deadline заблокированного SQL | PASS | 3.628 |
| `tracked_secrets_and_contract_audit` | Отсутствие приватного состояния в tracked tree; неизменность задания/контракта/tests | PASS | 0.078 |
[checks.txt](checks.txt) содержит реальный stdout/stderr команд сборки и публичных проверок с exit codes. Вывод restart-hook подавляется самим публичным persistence-тестом; факт пересоздания сервисов подтверждается разными ID API/PostgreSQL/Redis до и после при совпадающих именах volumes в [summary.json](summary.json).
### Уровень «3»
Схема содержит users, refresh_tokens, chats, chat_members, messages и versions. Версия миграций — 5, присутствуют PK, четыре FK и уникальность username: [schema.txt](schema.txt). Повторный запуск API сохранил количества пользователей, чатов, участников, сообщений, сессий и версию миграций без изменений.
Публичный smoke проверил регистрацию, конфликт username, доступ участников, запрет постороннему, сообщение, пагинацию и ошибки, неверный пароль, отказ Basic на private endpoint, отказ одного X-User-Id, невозможность подменить Bearer-пользователя другим X-User-Id, logout и повторное использование отозванного токена. Все эти проверки завершились PASS.
Persistence пересоздал все три сервиса с прежними volumes. Подтверждённые данные и сессия публичного теста сохранились. Дополнительно прежняя собственная сессия клиента сценария прочитала прежнего пользователя, а другой участник прочитал ранее подтверждённое сообщение.
Проверка БД выявила профиль пароля Argon2id `m=65536,t=3,p=4`. Полный хэш и пароль не сохранялись. Новые JWT содержат nonce из 32 случайных байт `crypto/rand`; проверены размер декодированного поля и подпись. Это обоснование 256 бит случайных данных по источнику генерации, а не статистическая оценка энтропии выборки. Неизвестный username и токен с изменённой подписью получили 401.
Исправлен HTTP-статус ошибок валидации: неверный UUID возвращает контрактный 400 вместо прежнего 422. Дополнительные отрицательные сценарии включают cursor/limit, неизвестные поля, запрет sender_id, некорректные поля пользователя, malformed JSON и неподдерживаемый Content-Type.
### Уровень «4»
Гонка 8 регистраций одного username дала ровно 1 × 201, 7 × 409 и одну строку БД. При создании чата с неизвестным участником INSERT чата выполнялся до FK-ошибки INSERT участников; ответ — 400, количества всех таблиц до/после равны. Частичный чат не сохранился.
В истории создано 20 000 синтетических сообщений дополнительно к одному ранее подтверждённому, итого 20 001. После ANALYZE первая страница и страница после позиции 10 000 имеют `Limit → Index Scan`, индекс `idx_messages_chat_id_created_at_id`, без Seq Scan таблицы messages:
| Страница | Записей плана | Execution Time, мс | Доказательства |
| --- | --- | --- | --- |
| Первая | 101 | 0.04 | [Текст](explain-first.txt), [JSON](explain-first.json) |
| Глубокая | 101 | 0.082 | [Текст](explain-deep.txt), [JSON](explain-deep.json) |
Использован запрос репозитория с фильтром chat_id, tuple cursor `(created_at,id)`, ORDER BY и LIMIT 101; OFFSET используется только для подготовки значения курсора наблюдателем, а не в исследуемом запросе API. Полный обход API страницами по 100 вернул все 20 001 ID в правильном порядке, без пропусков и дублей. Execution Time в таблице — время одного конкретного EXPLAIN, не универсальная оценка latency.
SESSION_TTL_SECONDS=2 имеет приоритет над legacy JWT_REFRESH_TOKEN_LIFETIME=24h: новая сессия дала 200 до истечения и 401 после expires_at. Проверены default 3600 секунд, legacy 86400 и приоритет 2 секунд даже при некорректном legacy значении. Пять некорректных конфигураций отвергнуты до запуска сервера: нулевой и нечисловой SESSION TTL, нулевой пул, connect timeout и query timeout.
Кэш дал один `chat_db_lookup` в последовательности miss → hit, посторонний получил 404. Подсчёт здесь выполнен по диагностике ветки кода, а не pg_stat_statements. Без Redis авторизованный GET вернул 200 за 62.898 мс, анонимный — 401. API также пересоздан при остановленном Redis и продолжил работать. После старта Redis удалён только тестовый ключ и подтверждено повторное заполнение кэша.
При остановке PostgreSQL после прогрева кэша действующая сессия получила 503 unavailable за 2.511 мс, анонимный запрос и неверный Bearer — 401. Readiness вернул 503 за 10.516 мс, liveness остался 200. После запуска БД прежняя сессия вновь прочитала чат.
При временном лимите пула 2 восемь параллельных запросов к заблокированной таблице наблюдали максимум ровно два соединения приложения. Все получили 503 через 2005.983–2008.694 мс. Затем блокировка освобождена, лимит возвращён к 10, доступ восстановлен. В [startup.txt](startup.txt) зафиксированы фактически применённые MaxConns=10, connect timeout=500ms и statement_timeout=2000ms. Общий контекст бизнес-запроса также ограничен двумя секундами; наблюдаемые дополнительные миллисекунды относятся к обработке и передаче ответа.
## Файлы и ограничения
- [summary.json](summary.json): статусы, численные результаты, исходная версия, образ, SHA-256, IDs контейнеров и имена сохранённых volumes.
- [http.csv](http.csv): статусы, пути, времена и request IDs дополнительных HTTP-проверок; тела, пароли и Authorization отсутствуют. Встроенные запросы публичных проверок здесь не дублируются, их stdout находится в checks.txt.
- [checks.txt](checks.txt), [startup.txt](startup.txt), [schema.txt](schema.txt) и четыре файла EXPLAIN — первичные текстовые результаты.
Все проверки — на одной API-реплике и синтетических данных. Исследованы корректные restarts и stop сервисов, а не потеря диска/питания, HA, backup/restore или сетевой blackhole. Политика кэша остаётся прежней: PostgreSQL — источник истины, TTL отсутствует, обязательный API не меняет членство; при добавлении изменения участников потребуется инвалидация. История Git полностью не сертифицировалась; автоматический аудит охватывает текущее отслеживаемое дерево и новые материалы. Старые результаты stampede сохранены как исторический эксперимент отдельной сборки и не пересчитывались.
+139
View File
@@ -0,0 +1,139 @@
$ docker compose [isolated project] config --quiet
exit_code=0
$ docker compose [isolated project] build api
#1 [internal] load local bake definitions
#1 reading from stdin 654B done
#1 DONE 0.0s
#2 [internal] load build definition from Dockerfile
#2 transferring dockerfile: 800B done
#2 DONE 0.0s
#3 resolve image config for docker-image://docker.io/docker/dockerfile:1
#3 DONE 13.4s
#4 docker-image://docker.io/docker/dockerfile:1@sha256:4edf897a3ffa55b89f906fc8cc78afdb3f1834cc9c7083565e611a8a7d5fe99e
#4 resolve docker.io/docker/dockerfile:1@sha256:4edf897a3ffa55b89f906fc8cc78afdb3f1834cc9c7083565e611a8a7d5fe99e done
#4 CACHED
#5 [internal] load metadata for docker.io/library/alpine:3.23.6
#5 ...
#6 [internal] load metadata for docker.io/library/golang:1.27.2-alpine3.23
#6 DONE 0.7s
#5 [internal] load metadata for docker.io/library/alpine:3.23.6
#5 DONE 0.7s
#7 [internal] load .dockerignore
#7 transferring context: 196B done
#7 DONE 0.0s
#8 [stage-1 1/2] FROM docker.io/library/alpine:3.23.6@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0
#8 resolve docker.io/library/alpine:3.23.6@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0 0.0s done
#8 DONE 0.0s
#9 [build 1/6] FROM docker.io/library/golang:1.27.2-alpine3.23@sha256:9e45f0eb4a63ed37ad6e604950407558b7c738e34e015ae77a5d4ad369cde079
#9 resolve docker.io/library/golang:1.27.2-alpine3.23@sha256:9e45f0eb4a63ed37ad6e604950407558b7c738e34e015ae77a5d4ad369cde079 0.0s done
#9 DONE 0.0s
#10 [internal] load build context
#10 transferring context: 17.22kB done
#10 DONE 0.0s
#11 [build 3/6] COPY service/go.mod service/go.sum ./
#11 CACHED
#12 [build 2/6] WORKDIR /src
#12 CACHED
#13 [build 4/6] RUN go mod download
#13 CACHED
#14 [build 5/6] COPY service/ ./
#14 DONE 0.0s
#15 [build 6/6] RUN CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -mod=readonly -trimpath -ldflags="-s -w" -o /out/messenger ./cmd/app
#15 DONE 8.0s
#8 [stage-1 1/2] FROM docker.io/library/alpine:3.23.6@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0
#8 CACHED
#16 [stage-1 2/2] COPY --from=build --chmod=0555 /out/messenger /usr/local/bin/messenger
#16 DONE 0.0s
#17 exporting to image
#17 exporting layers
#17 exporting layers 0.4s done
#17 exporting manifest sha256:6c01ef08b4dfb60665b11e1c9e2d6a794416848f0c06a30c2f6003303e153f22 done
#17 exporting config sha256:6ca293350d7a17febd3b643f71e6a335a81cf21ecbde108cb286e82ac183a28c done
#17 exporting attestation manifest sha256:c2a5e741b0a9ab238000c88633a676c64c818934364096d1bb5b0e49ede7dee9 done
#17 exporting manifest list sha256:0effe11ab9f4d860b5b79d6096ff95325336c752c0d5ca335878ec89baf4f269 done
#17 naming to docker.io/library/mtusi-messenger:lab2-verify-20261106t104316z-ed3f45 done
#17 unpacking to docker.io/library/mtusi-messenger:lab2-verify-20261106t104316z-ed3f45 0.1s done
#17 DONE 0.5s
#18 resolving provenance for metadata file
#18 DONE 0.0s
Image mtusi-messenger:lab2-verify-20261106t104316z-ed3f45 Building
Image mtusi-messenger:lab2-verify-20261106t104316z-ed3f45 Built
exit_code=0
$ docker compose [isolated project] up -d --no-build --wait --wait-timeout 120
Network lab2-verify-20261106t104316z-ed3f45_default Creating
Network lab2-verify-20261106t104316z-ed3f45_default Created
Volume lab2-verify-20261106t104316z-ed3f45_postgres_data Creating
Volume lab2-verify-20261106t104316z-ed3f45_postgres_data Created
Volume lab2-verify-20261106t104316z-ed3f45_redis_data Creating
Volume lab2-verify-20261106t104316z-ed3f45_redis_data Created
Container lab2-verify-20261106t104316z-ed3f45-redis-1 Creating
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Creating
Container lab2-verify-20261106t104316z-ed3f45-redis-1 Created
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Created
Container lab2-verify-20261106t104316z-ed3f45-api Creating
Container lab2-verify-20261106t104316z-ed3f45-api Created
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Starting
Container lab2-verify-20261106t104316z-ed3f45-redis-1 Starting
Container lab2-verify-20261106t104316z-ed3f45-redis-1 Started
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Started
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Waiting
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Healthy
Container lab2-verify-20261106t104316z-ed3f45-api Starting
Container lab2-verify-20261106t104316z-ed3f45-api Started
Container lab2-verify-20261106t104316z-ed3f45-api Waiting
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Waiting
Container lab2-verify-20261106t104316z-ed3f45-redis-1 Waiting
Container lab2-verify-20261106t104316z-ed3f45-redis-1 Healthy
Container lab2-verify-20261106t104316z-ed3f45-postgres-1 Healthy
Container lab2-verify-20261106t104316z-ed3f45-api Healthy
exit_code=0
$ make check
python3 scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
exit_code=0
$ make test BASE_URL=http://127.0.0.1:18084
python3 tests/smoke.py --base-url "http://127.0.0.1:18084"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
exit_code=0
$ make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:18084
python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://127.0.0.1:18084"
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
exit_code=0
Final isolated state before shutdown:
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
lab2-verify-20261106t104316z-ed3f45-api mtusi-messenger:lab2-verify-20261106t104316z-ed3f45 "/usr/local/bin/mess…" api 5 seconds ago Up 5 seconds (healthy) 127.0.0.1:18084->8080/tcp
lab2-verify-20261106t104316z-ed3f45-postgres-1 postgres:17.11-alpine3.23 "docker-entrypoint.s…" postgres 38 seconds ago Up 9 seconds (healthy) 5432/tcp
lab2-verify-20261106t104316z-ed3f45-redis-1 redis:8.2.11-alpine3.22 "docker-entrypoint.s…" redis 38 seconds ago Up 10 seconds (healthy) 6379/tcp
+74
View File
@@ -0,0 +1,74 @@
[
{
"Plan": {
"Node Type": "Limit",
"Parallel Aware": false,
"Async Capable": false,
"Startup Cost": 0.29,
"Total Cost": 10.75,
"Plan Rows": 101,
"Plan Width": 77,
"Actual Startup Time": 0.019,
"Actual Total Time": 0.032,
"Actual Rows": 101,
"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": "idx_messages_chat_id_created_at_id",
"Relation Name": "messages",
"Alias": "messages",
"Startup Cost": 0.29,
"Total Cost": 1036.64,
"Plan Rows": 10002,
"Plan Width": 77,
"Actual Startup Time": 0.018,
"Actual Total Time": 0.027,
"Actual Rows": 101,
"Actual Loops": 1,
"Index Cond": "((chat_id = 'e6a45519-82bb-44d1-9c50-60d6694ddbb6'::uuid) AND (ROW(created_at, id) > ROW('2020-01-01 00:00:00.010001+00'::timestamp with time zone, 'a6488848-3a03-4ccc-b300-5ff9d1cc2cd5'::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.361,
"Triggers": [],
"Execution Time": 0.082
}
]
+9
View File
@@ -0,0 +1,9 @@
Limit (cost=0.29..10.75 rows=101 width=77) (actual time=0.020..0.033 rows=101 loops=1)
Buffers: shared hit=5
-> Index Scan using idx_messages_chat_id_created_at_id on messages (cost=0.29..1036.64 rows=10002 width=77) (actual time=0.020..0.027 rows=101 loops=1)
Index Cond: ((chat_id = 'e6a45519-82bb-44d1-9c50-60d6694ddbb6'::uuid) AND (ROW(created_at, id) > ROW('2020-01-01 00:00:00.010001+00'::timestamp with time zone, 'a6488848-3a03-4ccc-b300-5ff9d1cc2cd5'::uuid)))
Buffers: shared hit=5
Planning:
Buffers: shared hit=106
Planning Time: 0.490 ms
Execution Time: 0.079 ms
+74
View File
@@ -0,0 +1,74 @@
[
{
"Plan": {
"Node Type": "Limit",
"Parallel Aware": false,
"Async Capable": false,
"Startup Cost": 0.29,
"Total Cost": 8.11,
"Plan Rows": 101,
"Plan Width": 77,
"Actual Startup Time": 0.013,
"Actual Total Time": 0.022,
"Actual Rows": 101,
"Actual Loops": 1,
"Shared Hit Blocks": 4,
"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": "idx_messages_chat_id_created_at_id",
"Relation Name": "messages",
"Alias": "messages",
"Startup Cost": 0.29,
"Total Cost": 1549.43,
"Plan Rows": 20001,
"Plan Width": 77,
"Actual Startup Time": 0.012,
"Actual Total Time": 0.017,
"Actual Rows": 101,
"Actual Loops": 1,
"Index Cond": "(chat_id = 'e6a45519-82bb-44d1-9c50-60d6694ddbb6'::uuid)",
"Rows Removed by Index Recheck": 0,
"Shared Hit Blocks": 4,
"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": 107,
"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.248,
"Triggers": [],
"Execution Time": 0.04
}
]
+9
View File
@@ -0,0 +1,9 @@
Limit (cost=0.29..8.11 rows=101 width=77) (actual time=0.011..0.020 rows=101 loops=1)
Buffers: shared hit=4
-> Index Scan using idx_messages_chat_id_created_at_id on messages (cost=0.29..1549.43 rows=20001 width=77) (actual time=0.010..0.015 rows=101 loops=1)
Index Cond: (chat_id = 'e6a45519-82bb-44d1-9c50-60d6694ddbb6'::uuid)
Buffers: shared hit=4
Planning:
Buffers: shared hit=107
Planning Time: 0.259 ms
Execution Time: 0.038 ms
+268
View File
@@ -0,0 +1,268 @@
timestamp_utc,method,path,status,duration_ms,request_id
2026-11-06T10:43:53.469309Z,POST,/api/v1/users,201,30.087,999eadf8-676d-46d2-85c4-e7aa1e165945
2026-11-06T10:43:53.499436Z,POST,/api/v1/auth/sessions,201,78.142,1761a981-5e7d-40ee-8dcd-1d05d336a17c
2026-11-06T10:43:53.577642Z,POST,/api/v1/users,201,29.507,e8414039-710d-493c-b2e1-94e7cd9608b4
2026-11-06T10:43:53.607185Z,POST,/api/v1/auth/sessions,201,81.991,8f8d7e2a-428a-4d1d-a1fc-2dc5ec7d3302
2026-11-06T10:43:53.689240Z,POST,/api/v1/users,201,30.443,ec47e965-d9e7-4ad8-ac0a-d4bd1bc871de
2026-11-06T10:43:53.719742Z,POST,/api/v1/auth/sessions,201,80.717,7d0572fd-4ee1-48ce-8a77-26f4191ac13b
2026-11-06T10:43:53.800497Z,POST,/api/v1/chats,201,48.073,9698ae37-656a-4fa5-a7da-8fde1eb73b32
2026-11-06T10:43:53.848601Z,POST,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages,201,48.799,b5d7f8ae-6cbe-4db4-bb93-81b648a483ce
2026-11-06T10:43:54.957501Z,POST,/api/v1/auth/sessions,201,82.729,0adfdc4e-1743-432e-b243-7ea9170e344d
2026-11-06T10:43:55.691577Z,POST,/api/v1/auth/sessions,201,93.591,80470377-780e-41ea-a13a-462fb3f4febf
2026-11-06T10:43:56.405003Z,POST,/api/v1/auth/sessions,201,87.802,18506276-b187-4c83-9151-be09a6f5a7f4
2026-11-06T10:43:58.621253Z,GET,/api/v1/chats/not-a-uuid,400,52.023,09fe6893-868a-40d2-94c5-eabe8ad6976c
2026-11-06T10:43:58.673351Z,GET,/api/v1/chats?limit=101,400,48.897,6ba45ba1-2100-47f1-b6a4-50bfbd9d4020
2026-11-06T10:43:58.722301Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?cursor=invalid,400,47.529,8b942401-15d4-447a-ad48-507819867719
2026-11-06T10:43:58.769876Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=1&limit=2,400,47.833,abffd884-a283-42ba-b9ae-970110f3955b
2026-11-06T10:43:58.817762Z,POST,/api/v1/chats,400,49.353,ca7e9d3a-787b-405f-a5ab-573a5a52bf72
2026-11-06T10:43:58.867165Z,POST,/api/v1/chats,400,48.038,f036a529-83e9-4071-8c7f-b13b8021e3f3
2026-11-06T10:43:58.915253Z,POST,/api/v1/chats,400,48.966,de94ff49-d495-4ab9-a4f4-9b52aa9d1984
2026-11-06T10:43:58.964276Z,POST,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages,400,48.021,5f880650-ef43-412b-9c01-38cc1555d084
2026-11-06T10:43:59.012348Z,POST,/api/v1/users,400,0.863,62a3d48b-f2f4-4752-bc10-7b98e8fa9603
2026-11-06T10:43:59.013245Z,POST,/api/v1/users,400,0.836,e6fabc6c-7d31-443b-930c-b62fdb634d7b
2026-11-06T10:43:59.014111Z,POST,/api/v1/users,400,0.725,787307e0-eb4c-45c7-bb5c-d5db7c0a41da
2026-11-06T10:43:59.014863Z,POST,/api/v1/users,400,0.683,705e17d3-c04c-483d-b114-e2772a8a6a26
2026-11-06T10:43:59.015582Z,POST,/api/v1/users,400,0.567,979f15e0-38b6-49ca-9321-fd176e87b4fc
2026-11-06T10:43:59.016177Z,POST,/api/v1/users,415,0.728,e4573e93-49b8-412d-a32f-241c42af4b56
2026-11-06T10:44:25.560847Z,GET,/api/v1/users/me,200,56.432,93dfb0c0-d084-409c-9ddd-b713f168e0d5
2026-11-06T10:44:25.617315Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100,200,49.854,28a5ade4-3737-40b4-bc17-a2350f49f48b
2026-11-06T10:44:25.674454Z,POST,/api/v1/users,201,152.476,496ffebc-c448-42ad-82e1-ab36ad6e98ca
2026-11-06T10:44:25.674381Z,POST,/api/v1/users,409,153.497,ffeacdf3-fd41-4136-bc69-7dc5ca5fdc99
2026-11-06T10:44:25.674487Z,POST,/api/v1/users,409,154.3,0c53babe-c337-4583-bb6f-12acd4b46e78
2026-11-06T10:44:25.674272Z,POST,/api/v1/users,409,156.319,8f952cce-25e1-4ece-94db-e57a08677193
2026-11-06T10:44:25.674416Z,POST,/api/v1/users,409,156.791,439e5127-6c50-4c1a-8f7b-26d575bde439
2026-11-06T10:44:25.674341Z,POST,/api/v1/users,409,157.71,7c1f264f-64e4-4afd-bfba-1df3cfe2690f
2026-11-06T10:44:25.674587Z,POST,/api/v1/users,409,157.603,dbdde0a2-b78b-454a-a26d-75ef0d35fcd2
2026-11-06T10:44:25.674553Z,POST,/api/v1/users,409,157.724,889fde82-774b-4e5f-8eaf-88c459a9c271
2026-11-06T10:44:26.013817Z,POST,/api/v1/chats,400,53.994,59a630dd-ca24-4f56-bf99-f0339044492c
2026-11-06T10:44:27.140724Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100,200,54.098,60f58a2f-c57c-4395-99a4-cfdac9bdd790
2026-11-06T10:44:27.194890Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=09eb83f4-8d98-4f60-9a07-1edf0c2fca9d,200,49.104,d203ee46-021a-4052-bfd6-32a1ad958a0d
2026-11-06T10:44:27.244043Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1a7e3684-f9ab-4e8b-88f1-3e9229f4bcce,200,49.581,25a2ede1-57b4-4043-8ac2-a31c4354df2c
2026-11-06T10:44:27.293661Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b7363323-a8ea-4e90-a6ab-8d4217adf4b4,200,49.295,2d1d215f-ada7-4603-a5b8-d503ea0bea23
2026-11-06T10:44:27.343014Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=45cdafb3-1a09-4e59-bbe4-8e87f1fab968,200,49.535,ca09303c-5d8d-4cee-809a-180b1e85fd0b
2026-11-06T10:44:27.392603Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c2ff71fc-b4cf-4969-a3bc-161c6ea59e4b,200,49.08,e64c5156-4044-40b3-97cc-d5955a4791e4
2026-11-06T10:44:27.441724Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=dcb1e2a7-2e32-4f05-84d6-401a3b85939b,200,49.534,4f1a6608-fea7-4333-a8df-e38beb7c060e
2026-11-06T10:44:27.491304Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3c23154d-ce14-4925-bd0c-7e886ccee93d,200,48.821,a8171728-3bdd-4253-aef5-7c4e199bb802
2026-11-06T10:44:27.540168Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=313f8725-e512-49e4-b42a-d59cb07b53c5,200,49.068,17bdfead-28cc-4ec5-8285-af3d59545911
2026-11-06T10:44:27.589275Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=61381e5f-6e89-434d-a2fc-bcb1fff1b878,200,48.629,fa946be8-470d-48f3-a2db-9f2cc0a56038
2026-11-06T10:44:27.637951Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6457549-8a04-4fbd-a937-92b907acf4a9,200,49.048,a3cbe239-cd3d-4b4b-8f3f-18abbbd3a427
2026-11-06T10:44:27.687037Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=5e41c8f1-9c5d-46c0-9e97-d271b5d08c33,200,48.418,5b223b89-6988-4be4-9591-fa923700548b
2026-11-06T10:44:27.735497Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=036802c9-848a-4f1b-aed7-29c00cac8ea4,200,48.676,3bc4323a-2e46-49e3-8a58-c4c22ea533bc
2026-11-06T10:44:27.784233Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d2ae6aeb-f87c-4fe3-87b6-b26c98082843,200,48.667,8034fae9-8fd7-4476-9d9f-37d46d770c36
2026-11-06T10:44:27.832966Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bcf495f7-dded-4c28-b9f9-3b54f093c261,200,49.89,725fa95e-9c05-4c7d-b800-0b483ac5f8c7
2026-11-06T10:44:27.882897Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bf994f87-7e6d-4f9e-b916-364453513941,200,49.023,5627b5b1-537e-415c-8ed1-d1dd68a51e41
2026-11-06T10:44:27.931959Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=672b29ae-689a-4129-9018-d42d7eb6c870,200,48.451,98ca486e-752c-4e1b-98f6-87cd237479ba
2026-11-06T10:44:27.980466Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=630c5d02-8d8c-406c-a3db-d2c368c6db2a,200,48.899,fcff18b6-7d11-49e6-a183-095f42dd4f89
2026-11-06T10:44:28.029409Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=eeb55fcb-94f4-430b-8384-e90c8baeabde,200,49.696,cf7a32de-490f-4672-bc76-a7b5a29615fd
2026-11-06T10:44:28.079167Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2f9de347-7666-44bf-a1bc-a1c5659c68aa,200,48.569,d3271ab0-95c0-4e69-aa5b-9aba215da08e
2026-11-06T10:44:28.127778Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c512a5f4-2b53-4feb-9ad7-a9529024744f,200,47.505,fbee3e36-0a03-450c-96a2-a08bdf0228f7
2026-11-06T10:44:28.175327Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=83aa36fd-d754-4c43-9791-08d175c59aea,200,48.625,77183621-485a-4c8d-a552-994f9c727fac
2026-11-06T10:44:28.224003Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=257cbd39-1b79-4e9e-a94a-784681ebeb09,200,48.257,30c9a9d6-5007-489a-894c-dd7478bcaab7
2026-11-06T10:44:28.272304Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d37e1fe3-c6e3-419f-b701-90c85e999136,200,49.47,d66ec970-c38f-4058-ab7f-5c7a46387f95
2026-11-06T10:44:28.321951Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=60bacab4-d829-4476-938e-d41e082020d9,200,49.188,e2ef2998-9ed6-4f1c-8575-034190df36b7
2026-11-06T10:44:28.371266Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=fc960806-beab-4f58-b70c-ad0afd97084b,200,50.032,175ffecc-2c5a-4965-a2a3-9f8f3564a988
2026-11-06T10:44:28.421341Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e31cf60a-3680-4c40-98ae-610a6df74512,200,48.975,95fd839b-759c-40c7-b03f-8400fe554440
2026-11-06T10:44:28.470377Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0b4427e2-ec6f-404e-a4f9-94f92edb3d70,200,51.331,3a8cca98-50af-4ee6-8110-1f93b6cb6655
2026-11-06T10:44:28.521759Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=afbce7fc-2acd-4388-b920-80f26c5426ae,200,48.873,ea63701d-d047-46e5-bd65-decac1c30e65
2026-11-06T10:44:28.570679Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=369f839d-b1b4-4757-b604-95c419af04a7,200,48.038,43f106cc-f46c-4626-a07f-2f67cf553a01
2026-11-06T10:44:28.618770Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6f0a44cf-348e-465f-b5ac-84e49f284f08,200,47.895,e9d0a7e6-2b22-41d5-a967-535f01b4fa6b
2026-11-06T10:44:28.666711Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cd402ced-97a9-4f63-8a09-23be4814d67b,200,48.237,4a34452c-736a-4baa-8e98-3dea219ea79d
2026-11-06T10:44:28.714991Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=06affc3b-1bcd-4f3a-adba-21ffacc19bd2,200,49.064,598fb0b2-6ece-435e-b43a-e64121e2f4f0
2026-11-06T10:44:28.764095Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=77263868-f4a1-4bb7-bbc7-5f60d92468cf,200,49.208,693b8086-cda7-45ab-bad6-66da3da3b0db
2026-11-06T10:44:28.813347Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=50dc8782-7ecc-4f8f-a3b8-0c43bbb67eae,200,48.513,93e6e086-1366-4111-b30b-a1eb010b1e3d
2026-11-06T10:44:28.861901Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bd81f6ff-d93c-4e3d-ba60-d9ac2182d84c,200,48.079,cd6333d4-71ed-4ae1-9876-78380ccde56e
2026-11-06T10:44:28.910031Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=396185f4-e6e1-40af-9608-28752b16a3b1,200,48.402,1db77724-6b0f-499e-8ee7-99d019886ff9
2026-11-06T10:44:28.958479Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=20db4635-9397-4843-8045-7433267f7f8c,200,49.383,7fe6388f-c856-4268-abb9-c5659fbdf425
2026-11-06T10:44:29.007906Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b7742c44-297e-44c1-95bd-f2c5983d667d,200,48.104,5c9b968d-5271-4b5c-989c-7b002a5bddc6
2026-11-06T10:44:29.056052Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d77d6349-791f-4448-892f-18276d53d2a0,200,49.286,212bc195-fa7f-42d0-92a3-cd93396bcc4d
2026-11-06T10:44:29.105378Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2bd45d93-0e6f-4977-b814-fea1bc373a26,200,48.724,eec6837d-76a1-4f93-b74f-4826181b4ecb
2026-11-06T10:44:29.154149Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ea9e58d7-a123-4710-be3a-05ec16893a07,200,49.023,9467010e-142c-4d41-a501-6b8bda912671
2026-11-06T10:44:29.203211Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c1ea8a5e-377b-4f4c-80ab-f0b10d547bdc,200,48.872,28ef18c8-0569-4e05-a788-9d86cd35fd7e
2026-11-06T10:44:29.252230Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=428b24e9-5d76-43b7-bff0-13b614c26abd,200,48.79,37920692-7a10-4fa4-b368-369bf919b951
2026-11-06T10:44:29.301063Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ef0885d5-4832-4663-bfd5-f9ecb59df4df,200,49.033,db6cdcb3-3063-4696-8b83-4e0ee6db2349
2026-11-06T10:44:29.350184Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=79183f22-59e4-4e25-9eef-169c8dc90ccf,200,48.613,379f0119-1315-451f-8d60-8f1d52bc290f
2026-11-06T10:44:29.398843Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=111c43e4-b7c7-494d-9577-0eddd14dd86f,200,48.905,bc76340c-d1ea-40b5-964e-b02d28d4805f
2026-11-06T10:44:29.447798Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4b0fa5c8-c270-4e63-92f0-16704915fc13,200,48.687,38f375bc-9573-49cd-acd6-6389fbf79c95
2026-11-06T10:44:29.496529Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7caf5de9-9007-4b7f-823f-333a6413dad4,200,48.655,6646946b-6149-4119-b3f0-56bd59a33710
2026-11-06T10:44:29.545230Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4e45efaa-44f8-4b08-b988-af37c46630e3,200,49.376,df9a3098-380c-4e8e-99b9-9129dc91682c
2026-11-06T10:44:29.594660Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b0445a04-3ea2-4161-a37f-1f41374f9899,200,48.088,feacc3c4-b3b7-4105-bd41-8406460aa552
2026-11-06T10:44:29.642808Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8f3c9eaa-0202-4238-a7a8-1905b78ff8a6,200,51.496,c53c2387-860b-4552-9808-c60a9b6252de
2026-11-06T10:44:29.694350Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a6ce22db-149c-4596-b513-47e5970d1ef9,200,48.982,a1a5a66d-fb7a-4da7-854a-c27098dbf262
2026-11-06T10:44:29.743384Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=51a1002a-f8bd-4e92-8f2c-dc7806e44c81,200,48.167,dfeed10e-d532-4bdc-a090-fea7c8585dec
2026-11-06T10:44:29.791591Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=084bef91-5e5e-4c6d-b26c-a50c59356003,200,48.068,8a3a3ee1-9805-44bc-b1b8-1c6ea30cd81c
2026-11-06T10:44:29.839701Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7997998d-24e4-47da-bf3c-b00e4c091397,200,48.379,bf87207c-bf2c-48bf-89ee-572fe5399463
2026-11-06T10:44:29.888122Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=14bd40d2-8591-45b9-a1d3-f036d8077994,200,48.735,9cc862fe-1631-490f-994b-4399fc290520
2026-11-06T10:44:29.936905Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3941bf40-5385-4f2f-8ce6-240897693138,200,48.91,97fa7628-6644-4eae-a98d-e0fb25f6d625
2026-11-06T10:44:29.985851Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2eee6b8f-2db8-42bc-ac67-0ee7d06728d1,200,49.281,5512cddd-0868-4713-9034-21532e71c90e
2026-11-06T10:44:30.035178Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=720ef0cb-a158-4bf2-b81d-a419c41c2558,200,49.799,8ca6c4a5-15a6-449f-8906-daf852851374
2026-11-06T10:44:30.085024Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c2f52e91-0ae3-45e0-9daa-184a22f160fc,200,51.784,23d9f6db-a8b4-48ee-8d40-4881fc37bc98
2026-11-06T10:44:30.136856Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e15af3f6-e37a-4e66-b49e-7c75d6d8bbc5,200,53.568,2d1182ad-e2ce-47cb-a72d-c3c735cb69c6
2026-11-06T10:44:30.190487Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=50ea00f5-09b4-4782-b995-042c31d70844,200,49.268,cc62b25c-9da8-4a3d-9894-3360bcf7a7d5
2026-11-06T10:44:30.239810Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4e5ed43a-741e-454f-8739-732cec8b166a,200,51.102,9fc2ef36-f34b-4229-9946-4f120eb8ad3e
2026-11-06T10:44:30.290973Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3550048c-a6bb-4540-b31d-4ad36c3ab972,200,50.431,1a32bed4-0af1-4523-99a3-defa968b81f0
2026-11-06T10:44:30.341462Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=01556b22-7461-453c-82d1-48444c446fba,200,51.649,a1bed472-1d43-4c06-91cd-2459135c3c07
2026-11-06T10:44:30.393161Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6b04d7e4-8581-4cd9-90ce-d282e00944a4,200,55.453,29041661-6426-4e62-b692-f70924f5b66c
2026-11-06T10:44:30.448662Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d1081d9f-7dfa-46d6-81ba-22c8f7143bd3,200,50.885,faa10246-a4f5-4007-a91e-655e4cf7b1db
2026-11-06T10:44:30.499596Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d7cb49b6-63db-4db8-b38e-d116a8e78ec2,200,50.257,e8add903-ba07-47eb-b821-3041a9620ea4
2026-11-06T10:44:30.549896Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cb1781ee-59ad-4519-9651-951e252b9ec8,200,48.862,297eea9b-9e56-49e7-b464-f056dbd40a12
2026-11-06T10:44:30.598810Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cb6a3e97-5bed-4ee0-9247-deb8decd0854,200,48.212,2948d2f1-0e49-43d9-b2b7-57667ad02311
2026-11-06T10:44:30.647079Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=412db721-6a91-4a24-83c3-88ec4f69e740,200,48.445,f865774d-fa9a-45a5-9c20-88fe7e653394
2026-11-06T10:44:30.695565Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8e2fdceb-e596-4729-8b9a-bb5cee3b43ed,200,48.315,bcf7fc71-ba86-4c13-82c9-995d31732652
2026-11-06T10:44:30.743928Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4ec963d7-6328-4979-b74a-78c5680b60e3,200,49.327,9bae78bb-0dba-4cd4-aacb-695ff42e6c3e
2026-11-06T10:44:30.793351Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4ad9e825-8671-4bec-a203-440ebd8b6366,200,48.576,f458618e-88d4-49a6-bfe1-8b90983200bb
2026-11-06T10:44:30.841973Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4d6892bd-4914-4b7c-879b-91e2a1afeac0,200,48.079,e36a4c85-9c1d-4c80-bd74-de8f50dffb80
2026-11-06T10:44:30.890102Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b8e076ad-4285-436a-9826-ce85a0daf705,200,48.987,346904f3-a59f-4e94-ae00-3488075a937f
2026-11-06T10:44:30.939133Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f4516406-5f9e-4bb5-9fac-66eca74a5e4e,200,47.818,35f08c31-5611-48db-82ac-025931370aae
2026-11-06T10:44:30.986990Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=130a3096-8377-44b2-9b52-c56a64cf6086,200,49.241,8cdef271-5ee4-4e76-9bb2-be913941705f
2026-11-06T10:44:31.036281Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1fcaaf85-22c1-4d6a-9aa5-005bf7c7b987,200,50.64,1851eeed-6f51-479c-9cab-65fac4a1d554
2026-11-06T10:44:31.086963Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=935be148-da91-4264-b9d4-03604676c638,200,48.817,5f38ec6c-e5df-4f18-a45f-6346a7c0ca06
2026-11-06T10:44:31.135829Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d149fcae-e2a6-4bd2-9ccb-44952bdeb9a7,200,48.911,c3a048e9-a947-4f35-b6dd-c9bc25bcb83e
2026-11-06T10:44:31.184846Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e3101747-32a5-4bfd-a302-1bdbaffbe522,200,48.274,c7aed71d-e7cd-4e85-892c-9fa3be037121
2026-11-06T10:44:31.233163Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=677d7776-4331-42e3-9ce0-4b508d2b3e0e,200,48.406,86e91535-d296-4b91-8507-3f591e430b37
2026-11-06T10:44:31.281610Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bd0d6b89-7642-4bfc-a6af-6aaa8900b296,200,48.209,aa6dd84a-5d68-4eb5-88ad-09db129b625b
2026-11-06T10:44:31.329865Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e91733b9-f5d7-4a63-8b15-3e6bdec204b7,200,48.981,24de4f76-f2ed-4640-b084-f47366bc71bd
2026-11-06T10:44:31.378885Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8cddbb26-9c20-42cb-9cd7-d6c582e1e704,200,48.372,2c0f209a-2215-4902-88d9-e08d4b87592d
2026-11-06T10:44:31.427300Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c5044663-aa58-4a9b-b918-2ec06a395db6,200,48.924,403a41a7-c248-4f44-b08c-6d20d79ffd98
2026-11-06T10:44:31.476267Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e2eb2860-c04e-4b96-9841-07b16ab5c037,200,47.723,1d700b38-e320-4467-b1ad-dd3b08ba3b6d
2026-11-06T10:44:31.524045Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f946a355-bd4a-4ccc-bad5-bf136500f05d,200,48.928,9389df8d-b5be-4b3e-af42-d93f12860424
2026-11-06T10:44:31.573010Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2a95a4bd-9b21-44af-9998-e1fdf1e725ee,200,55.242,09592ed2-994d-4b85-a0c5-9237953e6d64
2026-11-06T10:44:31.628321Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=337c0b43-6d43-4a33-85cb-7576a45b1420,200,48.284,3d62eb34-8cf5-4ee5-ba07-deffba63291e
2026-11-06T10:44:31.676658Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f60f3d97-a00f-40d1-b2fd-fb0a6821f1be,200,48.921,158c555c-5eac-428e-bf71-eb89f9839c3d
2026-11-06T10:44:31.725634Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=611cafef-55ea-4cad-9e34-acbe0a5460ba,200,48.453,362fa9d0-8c43-45d8-8c18-d6c562ed482b
2026-11-06T10:44:31.774131Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ed288080-2a56-4403-9ff9-179e749c1b93,200,49.377,f9fdc5f3-d13b-48b2-9196-1525c84540da
2026-11-06T10:44:31.823549Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d8b92c8f-819f-40b0-8315-82d6b4469cb3,200,52.353,ca03b3b5-144c-46a8-99ab-558ae6950612
2026-11-06T10:44:31.875961Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b530e3ac-0090-4836-97c6-4a87945f1750,200,52.771,a1f1b392-2f2e-4f83-af29-8862bd7a1b74
2026-11-06T10:44:31.928778Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8ffbecd3-ccd9-4842-ad63-c2823790a06d,200,47.866,ed8f1f5b-6253-4eb8-bc40-cbe03ffd26eb
2026-11-06T10:44:31.976691Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6bc79ac7-151a-454c-85ba-82acd123f760,200,49.331,e2e45ed1-3c85-4f86-8a0a-e753cb5a7491
2026-11-06T10:44:32.026071Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a090e707-03e1-4f30-889b-6d841b48834f,200,48.45,2de6c9da-dd69-4b48-99e3-4164822d2396
2026-11-06T10:44:32.074573Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6fc4c5f-660a-4d65-9893-3eaab8f38154,200,48.767,0b6a647f-9777-46d6-bedb-3b12b17d68d8
2026-11-06T10:44:32.123380Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6caaaf7-1b59-4063-9a0c-7b970d736ddc,200,48.31,75edfad0-def6-4654-b09c-b1e998dbd933
2026-11-06T10:44:32.171743Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0c62bb0a-a8be-43ac-a568-72071ec41cd4,200,48.908,9a4b55e7-294f-437b-a9a6-27e2baebcc0e
2026-11-06T10:44:32.220695Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=540dca09-2b6f-4c34-8b31-4917e61eb76f,200,48.172,5f2e80bb-16e6-450e-9e21-ac73176ec660
2026-11-06T10:44:32.268906Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3efa6e01-0e8b-44fa-ae60-04a92cea8760,200,49.094,8cab791e-67d9-47dc-9788-75d7708eb23a
2026-11-06T10:44:32.318042Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6c04678a-f0ec-480e-91b1-005c7a5c1379,200,48.237,4411648a-7843-4f11-a749-75467d17e05a
2026-11-06T10:44:32.366322Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2b2f1962-9af7-4a3d-9fde-eafb24d5a128,200,48.985,59085f4a-2d5b-4228-938c-34fa0e86f700
2026-11-06T10:44:32.415348Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=458814d3-297b-451b-8f28-351ed5f42408,200,48.653,81256741-9f88-4a3a-8281-5aee4b9c4b3b
2026-11-06T10:44:32.464042Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c6ca9082-77b0-4313-bce0-170ba9de82dc,200,48.818,b5c26d5b-a98a-4d3b-80ba-152ea3d360f3
2026-11-06T10:44:32.512905Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e95ab831-09b2-4c58-a668-bc329f0279df,200,50.886,2c5e908b-2dfe-4ce9-abdf-7c5470e30fdd
2026-11-06T10:44:32.563845Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c9317e40-0c0a-4d25-8ff1-276a70f7d03a,200,49.429,42b10b5b-a6f0-471f-affc-83c66fb2151d
2026-11-06T10:44:32.613314Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8154a38a-3998-4e4f-83d0-79dea62a5943,200,49.192,d4cf0604-3db2-4cdc-af74-887b797b7486
2026-11-06T10:44:32.662619Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3e0a633a-1370-4703-8137-6c761768eabd,200,48.83,ab119142-26ab-4194-bcbc-02e773cf9426
2026-11-06T10:44:32.711538Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6bae4c3-2139-452e-a81e-c773a5eea697,200,48.264,9e521d8d-248c-4f3a-89ee-e8066aa8e12a
2026-11-06T10:44:32.759843Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7c31f9d5-aca8-4fe1-b0ec-ac2d72127ac2,200,48.553,28c51b5f-82f1-4626-a2e9-78c14135f041
2026-11-06T10:44:32.808440Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d4db29b8-6ebd-47a9-a4d3-40a48844e0d4,200,49.8,3020df19-3e55-49c6-9cee-d0b2ac1b20c0
2026-11-06T10:44:32.858293Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=59258bca-15d6-4974-855b-89e0be4f6640,200,49.749,8fc37a3c-a935-46dc-9cbc-7bdbf427040b
2026-11-06T10:44:32.908088Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3ff6f844-723b-4910-b07a-60576b74793f,200,50.506,45274776-fde7-4fe0-9201-843678c2d486
2026-11-06T10:44:32.958651Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=23526a14-6045-4a46-a587-b8778df13c43,200,51.373,254998d6-47f0-4764-a053-c372e36bc47f
2026-11-06T10:44:33.010069Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d0edc957-38e1-4973-a701-a38c74a35757,200,50.567,668fd0ed-0a69-4a44-aaae-1a96757ec360
2026-11-06T10:44:33.060683Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0f144363-5c3c-4bb6-80fa-4eac3d2bd546,200,49.338,3609838f-0270-409d-a8cf-fcadce46c5a2
2026-11-06T10:44:33.110064Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=dbe11e7a-c20b-458d-9708-ca44edbbfe3b,200,48.45,31297066-8f53-49bd-84ed-3b1dfa640def
2026-11-06T10:44:33.158567Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=5d212971-4227-47cd-8578-c72ab28dc70d,200,48.547,ddaf0c17-5992-4c80-90b6-9e7c0bf12e15
2026-11-06T10:44:33.207163Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=87e188f5-6f58-4041-beb6-2fb0029427a9,200,47.947,8ced77db-b54e-4a39-9820-8a8675ab8355
2026-11-06T10:44:33.255155Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b362be62-49d5-432d-858a-fb2fd3091825,200,48.146,74bb9d19-0356-40f4-a73c-fb00f6ccf798
2026-11-06T10:44:33.303348Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2a2a8220-7dbe-404e-b8e5-c17408864993,200,57.356,6d650ade-2a08-4912-93a6-221102478c88
2026-11-06T10:44:33.360754Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2e4c654b-3797-48a5-9cd6-1b2ed79291d2,200,48.73,9406f41d-8fbd-4dae-bbc2-c84765506124
2026-11-06T10:44:33.409531Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1bc447a3-fec2-41da-a3b0-a3ef6bf1bbd0,200,51.271,e61deb47-3a29-44db-a834-f9c6f8bda1ef
2026-11-06T10:44:33.460853Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b4190035-5f21-4978-bba5-68e30a3b43f0,200,49.785,a0cc2ea4-939a-47d9-88d7-42506aa7847e
2026-11-06T10:44:33.510691Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e3fb825a-69f2-4193-8125-b7ebd21db395,200,52.58,a05e9b89-9d52-436f-958b-d557a1b476dc
2026-11-06T10:44:33.563330Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ea55c898-1d13-492a-9b7a-d3333c12d455,200,51.368,7d564696-367a-4340-8af0-2a9a89d672af
2026-11-06T10:44:33.614746Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f1142848-99cb-4acd-abb5-d4a112b47aa3,200,51.615,81fe4488-d4d8-431e-8e81-d7ced19cbf95
2026-11-06T10:44:33.666413Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d3ff72d1-dfd3-455f-9f44-67e3caf4730c,200,49.188,c391d731-9ab4-4d0c-92fc-421c87d766f2
2026-11-06T10:44:33.715652Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e49d981b-8dec-4aa2-8d94-0ef28aa7d969,200,48.937,b149c5a8-3151-4c5d-9e45-973fb9dd7e97
2026-11-06T10:44:33.764639Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=22213f26-65a9-4da0-8369-84e2b79a481a,200,50.176,dd7bb4b0-bd07-475c-aa44-9a71a794f5eb
2026-11-06T10:44:33.814855Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d58120f1-8b9b-4850-afaf-9d4b8add440c,200,47.976,aeedfee1-a9d0-4fa6-8d66-0ba2fdc0908a
2026-11-06T10:44:33.862869Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f961266a-e235-471d-9751-e001f1bb286f,200,48.701,b4d1ccc9-886e-4303-8b9c-57d58dc2851a
2026-11-06T10:44:33.911619Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a4a6dd2f-5a60-4df2-a2c7-fbff1274c401,200,48.565,5f901438-4dc8-4144-91d8-ea7c1a9b65d8
2026-11-06T10:44:33.960298Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c1f5ad3b-b2e6-4dfd-8ff6-cbca6aa089a2,200,47.418,5ad0e8c9-7280-4f0e-a1f6-612c5bf7076c
2026-11-06T10:44:34.007761Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=53a91cb7-85bf-4ded-b1f9-29800e0b26a3,200,48.417,c937479d-8e56-43e6-a1c9-3a6c7776b502
2026-11-06T10:44:34.056231Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1620d036-399f-4cd0-9bf3-5a0e676bc3ec,200,49.119,c454de5a-121e-4843-8a23-83beb807987a
2026-11-06T10:44:34.105395Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8739385c-bf97-464d-b84b-b12ed4c93285,200,49.423,cfff3513-4c52-42ff-929b-e08bd1bf8fb1
2026-11-06T10:44:34.154861Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=628b018b-85eb-4195-ba7e-3306e07b6379,200,49.106,6c983714-cd79-4599-bd3f-5af371c6b0b5
2026-11-06T10:44:34.204009Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0c992425-cd6c-4e56-b249-8239c57abf6d,200,48.274,a65ee699-9a8f-4bbc-8dc7-e34a7b3220a4
2026-11-06T10:44:34.252326Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=324e4439-d7d9-40fa-bf82-8d86f3ba3433,200,48.507,0977056d-f079-41b5-a45e-f608ec3a78d6
2026-11-06T10:44:34.300878Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=36d23f17-cbcd-4e6f-a061-928e05fdb994,200,49.227,d5cd7ddb-4003-45eb-92dd-e9935fe3f352
2026-11-06T10:44:34.350152Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=90f5a1b5-0f32-45b9-afe9-ead08a08d4f1,200,49.027,0c314181-bdb8-4e49-98ae-df47cae6d004
2026-11-06T10:44:34.399219Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cbca3d14-a881-43d0-a1a3-631573cd23a2,200,48.444,d3f5f781-229e-4b35-93ce-aca05c670dec
2026-11-06T10:44:34.447703Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1151e6c7-53ea-40d8-93e7-f00278754ee2,200,48.411,70f31adb-8bff-4b81-a692-13fa4ee88399
2026-11-06T10:44:34.496247Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d3eeaa28-e5a9-4b0c-bf82-e8c140e26690,200,48.607,1c8053f1-d084-4c78-8a53-a9c8b03f4927
2026-11-06T10:44:34.544893Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=90a86bd2-dc6e-4f94-a2f2-4f209ef7ba75,200,49.514,b6044384-21c5-46b8-afd1-9e4c922c1708
2026-11-06T10:44:34.594526Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a912248c-be9b-402a-9df9-21022455be2f,200,48.157,e2932827-3047-42de-914b-0bfbbd8715ae
2026-11-06T10:44:34.642732Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d6a39843-0e26-43bb-b4ca-b61b0f3fca5d,200,49.958,c2cdf396-ddb8-44da-ae40-752f05198273
2026-11-06T10:44:34.692798Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e7984ece-e9d7-448f-bbb5-073c23e17e0e,200,49.672,2779999b-ccf9-4473-9f04-29301b4ffb97
2026-11-06T10:44:34.742512Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bae7b41a-eea3-4be8-89f9-9929aa14538b,200,48.603,c508b67f-5434-46af-a18c-0b0319c2eb59
2026-11-06T10:44:34.791163Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=08896ffc-91a8-4780-94ea-7e15823a4695,200,48.959,0b476040-f046-4074-aacf-f8c65b6c0e99
2026-11-06T10:44:34.840161Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4ab7dd76-19da-405d-a845-7fc31678aa13,200,48.817,ba133764-a524-4a2a-bc6b-61e4c3e3d5cb
2026-11-06T10:44:34.889016Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=79dc519e-a9fc-424b-873e-123b06234417,200,49.227,2d8eb0dd-d689-4180-8176-586fc2ad8890
2026-11-06T10:44:34.938285Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=17521be5-fd6f-413c-b496-4f9ded6b6613,200,47.66,3b788fc0-49eb-4ae5-839d-15faa190a46e
2026-11-06T10:44:34.985989Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=618943cc-c29d-456b-a004-245e38c0a926,200,48.832,f94bc508-8533-4910-be28-cf004f5d58db
2026-11-06T10:44:35.034862Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f3a68e4d-afc4-46ae-8504-a4e64151bbb2,200,47.499,c8bd728c-1d1b-42c1-bbd6-ac1b92278628
2026-11-06T10:44:35.082408Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0056bc26-7a4e-4a5d-835a-0937a05de645,200,48.679,049db403-3616-4129-b4eb-b8df7508c7b4
2026-11-06T10:44:35.131128Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=13d6a9d5-c6c9-4c40-b8de-1bb818d337c0,200,48.843,749447b3-a458-40d5-80d2-6711fa384900
2026-11-06T10:44:35.180029Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=120d398f-b797-460b-9f9b-e1939cd2b75e,200,49.377,0b61c8a4-c717-436d-94b9-df2c55c74ee9
2026-11-06T10:44:35.229460Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=9a4e6a60-26c0-491f-8612-172b59128c63,200,48.121,02945554-08e3-4ee3-9622-1dda276f9241
2026-11-06T10:44:35.277627Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d0c48402-3612-434e-9d08-5855262d9543,200,49.253,2890176c-bca4-4554-9db5-e488f12e57ce
2026-11-06T10:44:35.327018Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ee300952-58ce-446e-ac98-8deb2c41a925,200,48.502,c0422fa2-c06f-4a2d-8539-01f878643b50
2026-11-06T10:44:35.375558Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=fa54d6c7-c7ab-4a36-bd38-76067eefad97,200,49.084,bd57e677-746c-4f8d-923b-ec859e8aa450
2026-11-06T10:44:35.424681Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b2880e2e-5f39-4017-8f66-90ae226734c3,200,49.079,db75429a-c3dc-4d2e-a7c1-beb7d272b551
2026-11-06T10:44:35.473812Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=95a5a815-2f6d-447c-870d-14dc4de4c21c,200,48.865,945d9c55-4e40-4107-ba01-8c0d39b01a5f
2026-11-06T10:44:35.522717Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a7060259-f3d4-4128-846b-d1b9ad4932dc,200,48.215,f4b1c606-43fe-41f2-a51d-6a83583a0f7e
2026-11-06T10:44:35.570972Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=651e5a41-dc9a-4f54-9b76-e0fdbb069b55,200,49.694,9562a350-6d77-4f0d-87cc-fdd9d039023a
2026-11-06T10:44:35.620718Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3101c3b6-0663-49f0-8c03-ceb6bbb8a6c2,200,48.209,e05b778a-2af4-44bb-a255-d79ed633e1f3
2026-11-06T10:44:35.668967Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c1f649b7-d4e8-4c7a-951f-b54fd4fb060b,200,48.594,86b599b8-4975-4ab0-b87f-d2c960b0d3a5
2026-11-06T10:44:35.717605Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d336d074-da53-4054-a978-6cbe89b47752,200,49.157,dc8b4587-580d-47e7-a89b-46280ce8676b
2026-11-06T10:44:35.766805Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d9f13829-2c18-4ba8-9ed8-a35bfa73f086,200,49.524,5c4f673e-c891-4762-812d-93a9c3a76361
2026-11-06T10:44:35.816372Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1e914b74-00b1-4e0f-817e-0a6dfbafd460,200,48.337,9bd7d085-8607-4d71-84d4-d0021a82b3e9
2026-11-06T10:44:35.864756Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2680916d-d13c-4777-8cdc-82f796b3ed2a,200,48.2,7e569484-8b6e-4581-a284-14d994eda0a2
2026-11-06T10:44:35.913007Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=22d497b8-761c-44bd-b0c1-b7f220363187,200,49.1,de668473-1ea5-4707-af6b-2d7961a0e5ba
2026-11-06T10:44:35.962148Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2277404a-f7c2-44c9-a5b3-f91896ce357d,200,49.021,e016eeeb-df6e-4b60-965d-b19070ee3da4
2026-11-06T10:44:36.011211Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7c3fdaaa-f048-46a3-a925-4748b0675023,200,48.313,75118216-893c-4bf8-afb2-69d770839fa1
2026-11-06T10:44:36.059635Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ddb9c536-7ef4-4508-acf8-8b6bfbbb6849,200,49.149,2ecc550c-112e-43f8-a56f-fc9cbb3897e0
2026-11-06T10:44:36.108826Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=74c07576-eb7a-4ff2-8050-af0ecfa61852,200,48.833,6a1bc128-cebf-4e22-999a-b5283c4d90ce
2026-11-06T10:44:36.157918Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ecc5effa-e5f3-4733-9c6e-990290e285bb,200,49.333,32b73d1c-825c-49fc-b789-a2cf5a428d0a
2026-11-06T10:44:36.207299Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=954ab263-3aa2-4ec9-b4b6-91a415800048,200,48.768,9c404dbf-51d6-4ee2-b1ba-0e695da2817d
2026-11-06T10:44:36.256299Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b3709915-27d8-4a55-8887-4ce420c5c51c,200,48.273,2bb6f74e-18b3-40e3-b998-df68017e9501
2026-11-06T10:44:36.304621Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a0639331-88aa-42f2-a30d-52cca6c4d74a,200,49.297,b9cd8c63-53ea-4212-a8dc-6b483a3fe326
2026-11-06T10:44:36.353973Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=28a6b936-ef61-4184-8adf-f86708788464,200,49.503,7202e762-fb87-4b39-b2ab-e2cb0d6fc5dd
2026-11-06T10:44:36.403523Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=5dc81c4e-2cd7-43b3-8f50-d0b3ab7b0c46,200,48.49,cc92502d-1707-4d43-a466-a44d73400920
2026-11-06T10:44:36.452055Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ebc83f5b-c3f9-42e7-878d-61d210c8e3db,200,48.286,5a368343-af4e-459d-989f-a0969e68d8dd
2026-11-06T10:44:36.500382Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=11a33776-9250-4e16-b60f-87500e1ad109,200,48.516,831254cf-0c86-47e6-bf63-9184640eaf1d
2026-11-06T10:44:36.548935Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=973f29af-9337-4fdb-b572-07dea2f9e671,200,48.2,daed38b7-e0f4-449d-af61-943d0710d6e2
2026-11-06T10:44:36.597179Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cefac4c5-844b-48a9-91a1-4d3a15200535,200,50.431,48c5cbd3-fe8f-4e12-a94b-efdc480b19dd
2026-11-06T10:44:36.647654Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2f5ede4a-f21d-4b2b-85f8-5685f30b6574,200,50.37,135d375f-8017-4a7e-bee5-217e7633acc1
2026-11-06T10:44:36.698076Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7bdcd025-1183-4a8a-9201-1401bf1886f1,200,48.789,17cd4b0d-6b01-4ce4-b598-b981120afe2d
2026-11-06T10:44:36.746917Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3be74f7f-2bf1-438e-85f3-613993fb68b3,200,48.672,bc4ecc9f-de11-4420-9603-51e55c1b3cf7
2026-11-06T10:44:36.795632Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=53e0427c-e198-44ed-a870-ff74f35169cd,200,49.287,f215d501-1463-4a6f-80e1-ee6757a70619
2026-11-06T10:44:36.845054Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=59ea82ae-9adf-463a-b728-c9a24c4f621d,200,49.753,8aa19f1d-871d-4088-8f00-328674b6fc0c
2026-11-06T10:44:36.894859Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bed24cc7-3047-408b-9cf3-61ca3123a131,200,49.077,793c2088-ffb7-44d4-b2b2-526df22d418c
2026-11-06T10:44:36.943973Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=09ac6496-7f42-4a98-b1cd-d97ebb9ab331,200,48.86,959179db-7127-49ec-b2c6-f2aa579e631e
2026-11-06T10:44:36.992877Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=fdb04044-a474-4cb2-8eeb-7dce580665e2,200,48.539,c121eaed-dad6-4558-8c00-3dfbfeb3f58b
2026-11-06T10:44:37.747366Z,POST,/api/v1/users,201,36.974,d0561e50-848b-414d-b743-fdfcb23709c0
2026-11-06T10:44:37.784389Z,POST,/api/v1/auth/sessions,201,90.242,e6e88caf-4f41-4270-9256-214686c7b5fb
2026-11-06T10:44:37.874661Z,GET,/api/v1/users/me,200,48.115,8eca8bd6-572f-412a-a0ac-598d2ab1b6b2
2026-11-06T10:44:39.255095Z,GET,/api/v1/users/me,401,2.478,cafb73fa-e684-4197-9fac-4504520555ef
2026-11-06T10:44:39.941671Z,GET,/api/v1/users/me,401,1.332,a7c38ec2-d0d3-4f5b-9405-56c7272969f6
2026-11-06T10:44:39.943123Z,POST,/api/v1/auth/sessions,401,2.372,40f154f2-f2d5-4dae-9ff8-a1f45bbe56e9
2026-11-06T10:44:40.034099Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,51.678,3ae54258-5e65-4c75-a268-134bf88863eb
2026-11-06T10:44:40.085814Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,48.339,6e07cbd2-2b53-4cb2-b958-d54956255865
2026-11-06T10:44:40.134183Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,404,48.573,0efb2986-0761-40dc-b8df-f145314b9317
2026-11-06T10:44:40.473965Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,62.898,695f1ea3-671f-42ae-b5d6-77c85b93e561
2026-11-06T10:44:40.536904Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,401,0.779,8b5e648d-e6d3-4c3c-9818-357ba8f9c2bf
2026-11-06T10:44:41.177283Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,60.095,1a2e9d85-46ed-407e-bfb5-db4c889b9c64
2026-11-06T10:44:41.538161Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,52.814,6b14ef0f-76dc-4bff-b7aa-630e4e7df543
2026-11-06T10:44:41.591022Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,53.064,93069924-03d4-473c-9b5b-9f31ae347cb3
2026-11-06T10:44:41.645634Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,48.576,1f41a014-0fb7-4eaf-9da2-fd808b6e1d33
2026-11-06T10:44:41.881711Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2.511,a1507a8f-63c2-4fa5-94c7-45353cd9c69b
2026-11-06T10:44:41.884300Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,401,1.816,20f3e995-abcf-4601-b88f-05ee974618d3
2026-11-06T10:44:41.886162Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,401,1.582,fe53c87d-8fa3-4cee-9736-3ca083e5b710
2026-11-06T10:44:41.887795Z,GET,/health/ready,503,10.516,a0431f6e-1881-4c94-9462-37b8427df08b
2026-11-06T10:44:41.898396Z,GET,/health/live,200,1.685,c601cd97-a488-4979-91b0-a27db2badb23
2026-11-06T10:44:42.148996Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,48.916,90211ae9-24ac-4cb5-8386-7dfddc021370
2026-11-06T10:44:43.031341Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2005.983,96303eb1-fd6e-4d4a-93ee-8c76cff4764f
2026-11-06T10:44:43.031064Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2006.399,ecc050ab-ae4b-4506-97af-9a4fb3da5b09
2026-11-06T10:44:43.031016Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2006.609,cb80f49a-437d-4417-8e6d-ba216c4b2a9d
2026-11-06T10:44:43.031255Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2006.508,e96d004f-9bb5-4ff3-b3f2-6541773949d7
2026-11-06T10:44:43.031112Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2006.816,51948b7b-35bd-439c-aa95-9febea247359
2026-11-06T10:44:43.030818Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2007.255,043660d7-ec6c-4661-a0dd-1c52caf48a8d
2026-11-06T10:44:43.029491Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2008.694,206c1e58-095e-4ec1-a281-495c1a79e75f
2026-11-06T10:44:43.031196Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,503,2007.084,3d0d0102-3f83-4a34-8bf0-e0cda6a90c95
2026-11-06T10:44:45.718620Z,GET,/api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6,200,48.037,0095100e-cb71-4ae6-be6c-45be1ade818d
1 timestamp_utc method path status duration_ms request_id
2 2026-11-06T10:43:53.469309Z POST /api/v1/users 201 30.087 999eadf8-676d-46d2-85c4-e7aa1e165945
3 2026-11-06T10:43:53.499436Z POST /api/v1/auth/sessions 201 78.142 1761a981-5e7d-40ee-8dcd-1d05d336a17c
4 2026-11-06T10:43:53.577642Z POST /api/v1/users 201 29.507 e8414039-710d-493c-b2e1-94e7cd9608b4
5 2026-11-06T10:43:53.607185Z POST /api/v1/auth/sessions 201 81.991 8f8d7e2a-428a-4d1d-a1fc-2dc5ec7d3302
6 2026-11-06T10:43:53.689240Z POST /api/v1/users 201 30.443 ec47e965-d9e7-4ad8-ac0a-d4bd1bc871de
7 2026-11-06T10:43:53.719742Z POST /api/v1/auth/sessions 201 80.717 7d0572fd-4ee1-48ce-8a77-26f4191ac13b
8 2026-11-06T10:43:53.800497Z POST /api/v1/chats 201 48.073 9698ae37-656a-4fa5-a7da-8fde1eb73b32
9 2026-11-06T10:43:53.848601Z POST /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages 201 48.799 b5d7f8ae-6cbe-4db4-bb93-81b648a483ce
10 2026-11-06T10:43:54.957501Z POST /api/v1/auth/sessions 201 82.729 0adfdc4e-1743-432e-b243-7ea9170e344d
11 2026-11-06T10:43:55.691577Z POST /api/v1/auth/sessions 201 93.591 80470377-780e-41ea-a13a-462fb3f4febf
12 2026-11-06T10:43:56.405003Z POST /api/v1/auth/sessions 201 87.802 18506276-b187-4c83-9151-be09a6f5a7f4
13 2026-11-06T10:43:58.621253Z GET /api/v1/chats/not-a-uuid 400 52.023 09fe6893-868a-40d2-94c5-eabe8ad6976c
14 2026-11-06T10:43:58.673351Z GET /api/v1/chats?limit=101 400 48.897 6ba45ba1-2100-47f1-b6a4-50bfbd9d4020
15 2026-11-06T10:43:58.722301Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?cursor=invalid 400 47.529 8b942401-15d4-447a-ad48-507819867719
16 2026-11-06T10:43:58.769876Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=1&limit=2 400 47.833 abffd884-a283-42ba-b9ae-970110f3955b
17 2026-11-06T10:43:58.817762Z POST /api/v1/chats 400 49.353 ca7e9d3a-787b-405f-a5ab-573a5a52bf72
18 2026-11-06T10:43:58.867165Z POST /api/v1/chats 400 48.038 f036a529-83e9-4071-8c7f-b13b8021e3f3
19 2026-11-06T10:43:58.915253Z POST /api/v1/chats 400 48.966 de94ff49-d495-4ab9-a4f4-9b52aa9d1984
20 2026-11-06T10:43:58.964276Z POST /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages 400 48.021 5f880650-ef43-412b-9c01-38cc1555d084
21 2026-11-06T10:43:59.012348Z POST /api/v1/users 400 0.863 62a3d48b-f2f4-4752-bc10-7b98e8fa9603
22 2026-11-06T10:43:59.013245Z POST /api/v1/users 400 0.836 e6fabc6c-7d31-443b-930c-b62fdb634d7b
23 2026-11-06T10:43:59.014111Z POST /api/v1/users 400 0.725 787307e0-eb4c-45c7-bb5c-d5db7c0a41da
24 2026-11-06T10:43:59.014863Z POST /api/v1/users 400 0.683 705e17d3-c04c-483d-b114-e2772a8a6a26
25 2026-11-06T10:43:59.015582Z POST /api/v1/users 400 0.567 979f15e0-38b6-49ca-9321-fd176e87b4fc
26 2026-11-06T10:43:59.016177Z POST /api/v1/users 415 0.728 e4573e93-49b8-412d-a32f-241c42af4b56
27 2026-11-06T10:44:25.560847Z GET /api/v1/users/me 200 56.432 93dfb0c0-d084-409c-9ddd-b713f168e0d5
28 2026-11-06T10:44:25.617315Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100 200 49.854 28a5ade4-3737-40b4-bc17-a2350f49f48b
29 2026-11-06T10:44:25.674454Z POST /api/v1/users 201 152.476 496ffebc-c448-42ad-82e1-ab36ad6e98ca
30 2026-11-06T10:44:25.674381Z POST /api/v1/users 409 153.497 ffeacdf3-fd41-4136-bc69-7dc5ca5fdc99
31 2026-11-06T10:44:25.674487Z POST /api/v1/users 409 154.3 0c53babe-c337-4583-bb6f-12acd4b46e78
32 2026-11-06T10:44:25.674272Z POST /api/v1/users 409 156.319 8f952cce-25e1-4ece-94db-e57a08677193
33 2026-11-06T10:44:25.674416Z POST /api/v1/users 409 156.791 439e5127-6c50-4c1a-8f7b-26d575bde439
34 2026-11-06T10:44:25.674341Z POST /api/v1/users 409 157.71 7c1f264f-64e4-4afd-bfba-1df3cfe2690f
35 2026-11-06T10:44:25.674587Z POST /api/v1/users 409 157.603 dbdde0a2-b78b-454a-a26d-75ef0d35fcd2
36 2026-11-06T10:44:25.674553Z POST /api/v1/users 409 157.724 889fde82-774b-4e5f-8eaf-88c459a9c271
37 2026-11-06T10:44:26.013817Z POST /api/v1/chats 400 53.994 59a630dd-ca24-4f56-bf99-f0339044492c
38 2026-11-06T10:44:27.140724Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100 200 54.098 60f58a2f-c57c-4395-99a4-cfdac9bdd790
39 2026-11-06T10:44:27.194890Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=09eb83f4-8d98-4f60-9a07-1edf0c2fca9d 200 49.104 d203ee46-021a-4052-bfd6-32a1ad958a0d
40 2026-11-06T10:44:27.244043Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1a7e3684-f9ab-4e8b-88f1-3e9229f4bcce 200 49.581 25a2ede1-57b4-4043-8ac2-a31c4354df2c
41 2026-11-06T10:44:27.293661Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b7363323-a8ea-4e90-a6ab-8d4217adf4b4 200 49.295 2d1d215f-ada7-4603-a5b8-d503ea0bea23
42 2026-11-06T10:44:27.343014Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=45cdafb3-1a09-4e59-bbe4-8e87f1fab968 200 49.535 ca09303c-5d8d-4cee-809a-180b1e85fd0b
43 2026-11-06T10:44:27.392603Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c2ff71fc-b4cf-4969-a3bc-161c6ea59e4b 200 49.08 e64c5156-4044-40b3-97cc-d5955a4791e4
44 2026-11-06T10:44:27.441724Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=dcb1e2a7-2e32-4f05-84d6-401a3b85939b 200 49.534 4f1a6608-fea7-4333-a8df-e38beb7c060e
45 2026-11-06T10:44:27.491304Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3c23154d-ce14-4925-bd0c-7e886ccee93d 200 48.821 a8171728-3bdd-4253-aef5-7c4e199bb802
46 2026-11-06T10:44:27.540168Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=313f8725-e512-49e4-b42a-d59cb07b53c5 200 49.068 17bdfead-28cc-4ec5-8285-af3d59545911
47 2026-11-06T10:44:27.589275Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=61381e5f-6e89-434d-a2fc-bcb1fff1b878 200 48.629 fa946be8-470d-48f3-a2db-9f2cc0a56038
48 2026-11-06T10:44:27.637951Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6457549-8a04-4fbd-a937-92b907acf4a9 200 49.048 a3cbe239-cd3d-4b4b-8f3f-18abbbd3a427
49 2026-11-06T10:44:27.687037Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=5e41c8f1-9c5d-46c0-9e97-d271b5d08c33 200 48.418 5b223b89-6988-4be4-9591-fa923700548b
50 2026-11-06T10:44:27.735497Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=036802c9-848a-4f1b-aed7-29c00cac8ea4 200 48.676 3bc4323a-2e46-49e3-8a58-c4c22ea533bc
51 2026-11-06T10:44:27.784233Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d2ae6aeb-f87c-4fe3-87b6-b26c98082843 200 48.667 8034fae9-8fd7-4476-9d9f-37d46d770c36
52 2026-11-06T10:44:27.832966Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bcf495f7-dded-4c28-b9f9-3b54f093c261 200 49.89 725fa95e-9c05-4c7d-b800-0b483ac5f8c7
53 2026-11-06T10:44:27.882897Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bf994f87-7e6d-4f9e-b916-364453513941 200 49.023 5627b5b1-537e-415c-8ed1-d1dd68a51e41
54 2026-11-06T10:44:27.931959Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=672b29ae-689a-4129-9018-d42d7eb6c870 200 48.451 98ca486e-752c-4e1b-98f6-87cd237479ba
55 2026-11-06T10:44:27.980466Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=630c5d02-8d8c-406c-a3db-d2c368c6db2a 200 48.899 fcff18b6-7d11-49e6-a183-095f42dd4f89
56 2026-11-06T10:44:28.029409Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=eeb55fcb-94f4-430b-8384-e90c8baeabde 200 49.696 cf7a32de-490f-4672-bc76-a7b5a29615fd
57 2026-11-06T10:44:28.079167Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2f9de347-7666-44bf-a1bc-a1c5659c68aa 200 48.569 d3271ab0-95c0-4e69-aa5b-9aba215da08e
58 2026-11-06T10:44:28.127778Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c512a5f4-2b53-4feb-9ad7-a9529024744f 200 47.505 fbee3e36-0a03-450c-96a2-a08bdf0228f7
59 2026-11-06T10:44:28.175327Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=83aa36fd-d754-4c43-9791-08d175c59aea 200 48.625 77183621-485a-4c8d-a552-994f9c727fac
60 2026-11-06T10:44:28.224003Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=257cbd39-1b79-4e9e-a94a-784681ebeb09 200 48.257 30c9a9d6-5007-489a-894c-dd7478bcaab7
61 2026-11-06T10:44:28.272304Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d37e1fe3-c6e3-419f-b701-90c85e999136 200 49.47 d66ec970-c38f-4058-ab7f-5c7a46387f95
62 2026-11-06T10:44:28.321951Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=60bacab4-d829-4476-938e-d41e082020d9 200 49.188 e2ef2998-9ed6-4f1c-8575-034190df36b7
63 2026-11-06T10:44:28.371266Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=fc960806-beab-4f58-b70c-ad0afd97084b 200 50.032 175ffecc-2c5a-4965-a2a3-9f8f3564a988
64 2026-11-06T10:44:28.421341Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e31cf60a-3680-4c40-98ae-610a6df74512 200 48.975 95fd839b-759c-40c7-b03f-8400fe554440
65 2026-11-06T10:44:28.470377Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0b4427e2-ec6f-404e-a4f9-94f92edb3d70 200 51.331 3a8cca98-50af-4ee6-8110-1f93b6cb6655
66 2026-11-06T10:44:28.521759Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=afbce7fc-2acd-4388-b920-80f26c5426ae 200 48.873 ea63701d-d047-46e5-bd65-decac1c30e65
67 2026-11-06T10:44:28.570679Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=369f839d-b1b4-4757-b604-95c419af04a7 200 48.038 43f106cc-f46c-4626-a07f-2f67cf553a01
68 2026-11-06T10:44:28.618770Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6f0a44cf-348e-465f-b5ac-84e49f284f08 200 47.895 e9d0a7e6-2b22-41d5-a967-535f01b4fa6b
69 2026-11-06T10:44:28.666711Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cd402ced-97a9-4f63-8a09-23be4814d67b 200 48.237 4a34452c-736a-4baa-8e98-3dea219ea79d
70 2026-11-06T10:44:28.714991Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=06affc3b-1bcd-4f3a-adba-21ffacc19bd2 200 49.064 598fb0b2-6ece-435e-b43a-e64121e2f4f0
71 2026-11-06T10:44:28.764095Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=77263868-f4a1-4bb7-bbc7-5f60d92468cf 200 49.208 693b8086-cda7-45ab-bad6-66da3da3b0db
72 2026-11-06T10:44:28.813347Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=50dc8782-7ecc-4f8f-a3b8-0c43bbb67eae 200 48.513 93e6e086-1366-4111-b30b-a1eb010b1e3d
73 2026-11-06T10:44:28.861901Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bd81f6ff-d93c-4e3d-ba60-d9ac2182d84c 200 48.079 cd6333d4-71ed-4ae1-9876-78380ccde56e
74 2026-11-06T10:44:28.910031Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=396185f4-e6e1-40af-9608-28752b16a3b1 200 48.402 1db77724-6b0f-499e-8ee7-99d019886ff9
75 2026-11-06T10:44:28.958479Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=20db4635-9397-4843-8045-7433267f7f8c 200 49.383 7fe6388f-c856-4268-abb9-c5659fbdf425
76 2026-11-06T10:44:29.007906Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b7742c44-297e-44c1-95bd-f2c5983d667d 200 48.104 5c9b968d-5271-4b5c-989c-7b002a5bddc6
77 2026-11-06T10:44:29.056052Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d77d6349-791f-4448-892f-18276d53d2a0 200 49.286 212bc195-fa7f-42d0-92a3-cd93396bcc4d
78 2026-11-06T10:44:29.105378Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2bd45d93-0e6f-4977-b814-fea1bc373a26 200 48.724 eec6837d-76a1-4f93-b74f-4826181b4ecb
79 2026-11-06T10:44:29.154149Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ea9e58d7-a123-4710-be3a-05ec16893a07 200 49.023 9467010e-142c-4d41-a501-6b8bda912671
80 2026-11-06T10:44:29.203211Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c1ea8a5e-377b-4f4c-80ab-f0b10d547bdc 200 48.872 28ef18c8-0569-4e05-a788-9d86cd35fd7e
81 2026-11-06T10:44:29.252230Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=428b24e9-5d76-43b7-bff0-13b614c26abd 200 48.79 37920692-7a10-4fa4-b368-369bf919b951
82 2026-11-06T10:44:29.301063Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ef0885d5-4832-4663-bfd5-f9ecb59df4df 200 49.033 db6cdcb3-3063-4696-8b83-4e0ee6db2349
83 2026-11-06T10:44:29.350184Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=79183f22-59e4-4e25-9eef-169c8dc90ccf 200 48.613 379f0119-1315-451f-8d60-8f1d52bc290f
84 2026-11-06T10:44:29.398843Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=111c43e4-b7c7-494d-9577-0eddd14dd86f 200 48.905 bc76340c-d1ea-40b5-964e-b02d28d4805f
85 2026-11-06T10:44:29.447798Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4b0fa5c8-c270-4e63-92f0-16704915fc13 200 48.687 38f375bc-9573-49cd-acd6-6389fbf79c95
86 2026-11-06T10:44:29.496529Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7caf5de9-9007-4b7f-823f-333a6413dad4 200 48.655 6646946b-6149-4119-b3f0-56bd59a33710
87 2026-11-06T10:44:29.545230Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4e45efaa-44f8-4b08-b988-af37c46630e3 200 49.376 df9a3098-380c-4e8e-99b9-9129dc91682c
88 2026-11-06T10:44:29.594660Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b0445a04-3ea2-4161-a37f-1f41374f9899 200 48.088 feacc3c4-b3b7-4105-bd41-8406460aa552
89 2026-11-06T10:44:29.642808Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8f3c9eaa-0202-4238-a7a8-1905b78ff8a6 200 51.496 c53c2387-860b-4552-9808-c60a9b6252de
90 2026-11-06T10:44:29.694350Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a6ce22db-149c-4596-b513-47e5970d1ef9 200 48.982 a1a5a66d-fb7a-4da7-854a-c27098dbf262
91 2026-11-06T10:44:29.743384Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=51a1002a-f8bd-4e92-8f2c-dc7806e44c81 200 48.167 dfeed10e-d532-4bdc-a090-fea7c8585dec
92 2026-11-06T10:44:29.791591Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=084bef91-5e5e-4c6d-b26c-a50c59356003 200 48.068 8a3a3ee1-9805-44bc-b1b8-1c6ea30cd81c
93 2026-11-06T10:44:29.839701Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7997998d-24e4-47da-bf3c-b00e4c091397 200 48.379 bf87207c-bf2c-48bf-89ee-572fe5399463
94 2026-11-06T10:44:29.888122Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=14bd40d2-8591-45b9-a1d3-f036d8077994 200 48.735 9cc862fe-1631-490f-994b-4399fc290520
95 2026-11-06T10:44:29.936905Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3941bf40-5385-4f2f-8ce6-240897693138 200 48.91 97fa7628-6644-4eae-a98d-e0fb25f6d625
96 2026-11-06T10:44:29.985851Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2eee6b8f-2db8-42bc-ac67-0ee7d06728d1 200 49.281 5512cddd-0868-4713-9034-21532e71c90e
97 2026-11-06T10:44:30.035178Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=720ef0cb-a158-4bf2-b81d-a419c41c2558 200 49.799 8ca6c4a5-15a6-449f-8906-daf852851374
98 2026-11-06T10:44:30.085024Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c2f52e91-0ae3-45e0-9daa-184a22f160fc 200 51.784 23d9f6db-a8b4-48ee-8d40-4881fc37bc98
99 2026-11-06T10:44:30.136856Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e15af3f6-e37a-4e66-b49e-7c75d6d8bbc5 200 53.568 2d1182ad-e2ce-47cb-a72d-c3c735cb69c6
100 2026-11-06T10:44:30.190487Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=50ea00f5-09b4-4782-b995-042c31d70844 200 49.268 cc62b25c-9da8-4a3d-9894-3360bcf7a7d5
101 2026-11-06T10:44:30.239810Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4e5ed43a-741e-454f-8739-732cec8b166a 200 51.102 9fc2ef36-f34b-4229-9946-4f120eb8ad3e
102 2026-11-06T10:44:30.290973Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3550048c-a6bb-4540-b31d-4ad36c3ab972 200 50.431 1a32bed4-0af1-4523-99a3-defa968b81f0
103 2026-11-06T10:44:30.341462Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=01556b22-7461-453c-82d1-48444c446fba 200 51.649 a1bed472-1d43-4c06-91cd-2459135c3c07
104 2026-11-06T10:44:30.393161Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6b04d7e4-8581-4cd9-90ce-d282e00944a4 200 55.453 29041661-6426-4e62-b692-f70924f5b66c
105 2026-11-06T10:44:30.448662Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d1081d9f-7dfa-46d6-81ba-22c8f7143bd3 200 50.885 faa10246-a4f5-4007-a91e-655e4cf7b1db
106 2026-11-06T10:44:30.499596Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d7cb49b6-63db-4db8-b38e-d116a8e78ec2 200 50.257 e8add903-ba07-47eb-b821-3041a9620ea4
107 2026-11-06T10:44:30.549896Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cb1781ee-59ad-4519-9651-951e252b9ec8 200 48.862 297eea9b-9e56-49e7-b464-f056dbd40a12
108 2026-11-06T10:44:30.598810Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cb6a3e97-5bed-4ee0-9247-deb8decd0854 200 48.212 2948d2f1-0e49-43d9-b2b7-57667ad02311
109 2026-11-06T10:44:30.647079Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=412db721-6a91-4a24-83c3-88ec4f69e740 200 48.445 f865774d-fa9a-45a5-9c20-88fe7e653394
110 2026-11-06T10:44:30.695565Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8e2fdceb-e596-4729-8b9a-bb5cee3b43ed 200 48.315 bcf7fc71-ba86-4c13-82c9-995d31732652
111 2026-11-06T10:44:30.743928Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4ec963d7-6328-4979-b74a-78c5680b60e3 200 49.327 9bae78bb-0dba-4cd4-aacb-695ff42e6c3e
112 2026-11-06T10:44:30.793351Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4ad9e825-8671-4bec-a203-440ebd8b6366 200 48.576 f458618e-88d4-49a6-bfe1-8b90983200bb
113 2026-11-06T10:44:30.841973Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4d6892bd-4914-4b7c-879b-91e2a1afeac0 200 48.079 e36a4c85-9c1d-4c80-bd74-de8f50dffb80
114 2026-11-06T10:44:30.890102Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b8e076ad-4285-436a-9826-ce85a0daf705 200 48.987 346904f3-a59f-4e94-ae00-3488075a937f
115 2026-11-06T10:44:30.939133Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f4516406-5f9e-4bb5-9fac-66eca74a5e4e 200 47.818 35f08c31-5611-48db-82ac-025931370aae
116 2026-11-06T10:44:30.986990Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=130a3096-8377-44b2-9b52-c56a64cf6086 200 49.241 8cdef271-5ee4-4e76-9bb2-be913941705f
117 2026-11-06T10:44:31.036281Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1fcaaf85-22c1-4d6a-9aa5-005bf7c7b987 200 50.64 1851eeed-6f51-479c-9cab-65fac4a1d554
118 2026-11-06T10:44:31.086963Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=935be148-da91-4264-b9d4-03604676c638 200 48.817 5f38ec6c-e5df-4f18-a45f-6346a7c0ca06
119 2026-11-06T10:44:31.135829Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d149fcae-e2a6-4bd2-9ccb-44952bdeb9a7 200 48.911 c3a048e9-a947-4f35-b6dd-c9bc25bcb83e
120 2026-11-06T10:44:31.184846Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e3101747-32a5-4bfd-a302-1bdbaffbe522 200 48.274 c7aed71d-e7cd-4e85-892c-9fa3be037121
121 2026-11-06T10:44:31.233163Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=677d7776-4331-42e3-9ce0-4b508d2b3e0e 200 48.406 86e91535-d296-4b91-8507-3f591e430b37
122 2026-11-06T10:44:31.281610Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bd0d6b89-7642-4bfc-a6af-6aaa8900b296 200 48.209 aa6dd84a-5d68-4eb5-88ad-09db129b625b
123 2026-11-06T10:44:31.329865Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e91733b9-f5d7-4a63-8b15-3e6bdec204b7 200 48.981 24de4f76-f2ed-4640-b084-f47366bc71bd
124 2026-11-06T10:44:31.378885Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8cddbb26-9c20-42cb-9cd7-d6c582e1e704 200 48.372 2c0f209a-2215-4902-88d9-e08d4b87592d
125 2026-11-06T10:44:31.427300Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c5044663-aa58-4a9b-b918-2ec06a395db6 200 48.924 403a41a7-c248-4f44-b08c-6d20d79ffd98
126 2026-11-06T10:44:31.476267Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e2eb2860-c04e-4b96-9841-07b16ab5c037 200 47.723 1d700b38-e320-4467-b1ad-dd3b08ba3b6d
127 2026-11-06T10:44:31.524045Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f946a355-bd4a-4ccc-bad5-bf136500f05d 200 48.928 9389df8d-b5be-4b3e-af42-d93f12860424
128 2026-11-06T10:44:31.573010Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2a95a4bd-9b21-44af-9998-e1fdf1e725ee 200 55.242 09592ed2-994d-4b85-a0c5-9237953e6d64
129 2026-11-06T10:44:31.628321Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=337c0b43-6d43-4a33-85cb-7576a45b1420 200 48.284 3d62eb34-8cf5-4ee5-ba07-deffba63291e
130 2026-11-06T10:44:31.676658Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f60f3d97-a00f-40d1-b2fd-fb0a6821f1be 200 48.921 158c555c-5eac-428e-bf71-eb89f9839c3d
131 2026-11-06T10:44:31.725634Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=611cafef-55ea-4cad-9e34-acbe0a5460ba 200 48.453 362fa9d0-8c43-45d8-8c18-d6c562ed482b
132 2026-11-06T10:44:31.774131Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ed288080-2a56-4403-9ff9-179e749c1b93 200 49.377 f9fdc5f3-d13b-48b2-9196-1525c84540da
133 2026-11-06T10:44:31.823549Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d8b92c8f-819f-40b0-8315-82d6b4469cb3 200 52.353 ca03b3b5-144c-46a8-99ab-558ae6950612
134 2026-11-06T10:44:31.875961Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b530e3ac-0090-4836-97c6-4a87945f1750 200 52.771 a1f1b392-2f2e-4f83-af29-8862bd7a1b74
135 2026-11-06T10:44:31.928778Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8ffbecd3-ccd9-4842-ad63-c2823790a06d 200 47.866 ed8f1f5b-6253-4eb8-bc40-cbe03ffd26eb
136 2026-11-06T10:44:31.976691Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6bc79ac7-151a-454c-85ba-82acd123f760 200 49.331 e2e45ed1-3c85-4f86-8a0a-e753cb5a7491
137 2026-11-06T10:44:32.026071Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a090e707-03e1-4f30-889b-6d841b48834f 200 48.45 2de6c9da-dd69-4b48-99e3-4164822d2396
138 2026-11-06T10:44:32.074573Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6fc4c5f-660a-4d65-9893-3eaab8f38154 200 48.767 0b6a647f-9777-46d6-bedb-3b12b17d68d8
139 2026-11-06T10:44:32.123380Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6caaaf7-1b59-4063-9a0c-7b970d736ddc 200 48.31 75edfad0-def6-4654-b09c-b1e998dbd933
140 2026-11-06T10:44:32.171743Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0c62bb0a-a8be-43ac-a568-72071ec41cd4 200 48.908 9a4b55e7-294f-437b-a9a6-27e2baebcc0e
141 2026-11-06T10:44:32.220695Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=540dca09-2b6f-4c34-8b31-4917e61eb76f 200 48.172 5f2e80bb-16e6-450e-9e21-ac73176ec660
142 2026-11-06T10:44:32.268906Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3efa6e01-0e8b-44fa-ae60-04a92cea8760 200 49.094 8cab791e-67d9-47dc-9788-75d7708eb23a
143 2026-11-06T10:44:32.318042Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=6c04678a-f0ec-480e-91b1-005c7a5c1379 200 48.237 4411648a-7843-4f11-a749-75467d17e05a
144 2026-11-06T10:44:32.366322Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2b2f1962-9af7-4a3d-9fde-eafb24d5a128 200 48.985 59085f4a-2d5b-4228-938c-34fa0e86f700
145 2026-11-06T10:44:32.415348Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=458814d3-297b-451b-8f28-351ed5f42408 200 48.653 81256741-9f88-4a3a-8281-5aee4b9c4b3b
146 2026-11-06T10:44:32.464042Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c6ca9082-77b0-4313-bce0-170ba9de82dc 200 48.818 b5c26d5b-a98a-4d3b-80ba-152ea3d360f3
147 2026-11-06T10:44:32.512905Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e95ab831-09b2-4c58-a668-bc329f0279df 200 50.886 2c5e908b-2dfe-4ce9-abdf-7c5470e30fdd
148 2026-11-06T10:44:32.563845Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c9317e40-0c0a-4d25-8ff1-276a70f7d03a 200 49.429 42b10b5b-a6f0-471f-affc-83c66fb2151d
149 2026-11-06T10:44:32.613314Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8154a38a-3998-4e4f-83d0-79dea62a5943 200 49.192 d4cf0604-3db2-4cdc-af74-887b797b7486
150 2026-11-06T10:44:32.662619Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3e0a633a-1370-4703-8137-6c761768eabd 200 48.83 ab119142-26ab-4194-bcbc-02e773cf9426
151 2026-11-06T10:44:32.711538Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b6bae4c3-2139-452e-a81e-c773a5eea697 200 48.264 9e521d8d-248c-4f3a-89ee-e8066aa8e12a
152 2026-11-06T10:44:32.759843Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7c31f9d5-aca8-4fe1-b0ec-ac2d72127ac2 200 48.553 28c51b5f-82f1-4626-a2e9-78c14135f041
153 2026-11-06T10:44:32.808440Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d4db29b8-6ebd-47a9-a4d3-40a48844e0d4 200 49.8 3020df19-3e55-49c6-9cee-d0b2ac1b20c0
154 2026-11-06T10:44:32.858293Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=59258bca-15d6-4974-855b-89e0be4f6640 200 49.749 8fc37a3c-a935-46dc-9cbc-7bdbf427040b
155 2026-11-06T10:44:32.908088Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3ff6f844-723b-4910-b07a-60576b74793f 200 50.506 45274776-fde7-4fe0-9201-843678c2d486
156 2026-11-06T10:44:32.958651Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=23526a14-6045-4a46-a587-b8778df13c43 200 51.373 254998d6-47f0-4764-a053-c372e36bc47f
157 2026-11-06T10:44:33.010069Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d0edc957-38e1-4973-a701-a38c74a35757 200 50.567 668fd0ed-0a69-4a44-aaae-1a96757ec360
158 2026-11-06T10:44:33.060683Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0f144363-5c3c-4bb6-80fa-4eac3d2bd546 200 49.338 3609838f-0270-409d-a8cf-fcadce46c5a2
159 2026-11-06T10:44:33.110064Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=dbe11e7a-c20b-458d-9708-ca44edbbfe3b 200 48.45 31297066-8f53-49bd-84ed-3b1dfa640def
160 2026-11-06T10:44:33.158567Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=5d212971-4227-47cd-8578-c72ab28dc70d 200 48.547 ddaf0c17-5992-4c80-90b6-9e7c0bf12e15
161 2026-11-06T10:44:33.207163Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=87e188f5-6f58-4041-beb6-2fb0029427a9 200 47.947 8ced77db-b54e-4a39-9820-8a8675ab8355
162 2026-11-06T10:44:33.255155Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b362be62-49d5-432d-858a-fb2fd3091825 200 48.146 74bb9d19-0356-40f4-a73c-fb00f6ccf798
163 2026-11-06T10:44:33.303348Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2a2a8220-7dbe-404e-b8e5-c17408864993 200 57.356 6d650ade-2a08-4912-93a6-221102478c88
164 2026-11-06T10:44:33.360754Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2e4c654b-3797-48a5-9cd6-1b2ed79291d2 200 48.73 9406f41d-8fbd-4dae-bbc2-c84765506124
165 2026-11-06T10:44:33.409531Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1bc447a3-fec2-41da-a3b0-a3ef6bf1bbd0 200 51.271 e61deb47-3a29-44db-a834-f9c6f8bda1ef
166 2026-11-06T10:44:33.460853Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b4190035-5f21-4978-bba5-68e30a3b43f0 200 49.785 a0cc2ea4-939a-47d9-88d7-42506aa7847e
167 2026-11-06T10:44:33.510691Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e3fb825a-69f2-4193-8125-b7ebd21db395 200 52.58 a05e9b89-9d52-436f-958b-d557a1b476dc
168 2026-11-06T10:44:33.563330Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ea55c898-1d13-492a-9b7a-d3333c12d455 200 51.368 7d564696-367a-4340-8af0-2a9a89d672af
169 2026-11-06T10:44:33.614746Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f1142848-99cb-4acd-abb5-d4a112b47aa3 200 51.615 81fe4488-d4d8-431e-8e81-d7ced19cbf95
170 2026-11-06T10:44:33.666413Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d3ff72d1-dfd3-455f-9f44-67e3caf4730c 200 49.188 c391d731-9ab4-4d0c-92fc-421c87d766f2
171 2026-11-06T10:44:33.715652Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e49d981b-8dec-4aa2-8d94-0ef28aa7d969 200 48.937 b149c5a8-3151-4c5d-9e45-973fb9dd7e97
172 2026-11-06T10:44:33.764639Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=22213f26-65a9-4da0-8369-84e2b79a481a 200 50.176 dd7bb4b0-bd07-475c-aa44-9a71a794f5eb
173 2026-11-06T10:44:33.814855Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d58120f1-8b9b-4850-afaf-9d4b8add440c 200 47.976 aeedfee1-a9d0-4fa6-8d66-0ba2fdc0908a
174 2026-11-06T10:44:33.862869Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f961266a-e235-471d-9751-e001f1bb286f 200 48.701 b4d1ccc9-886e-4303-8b9c-57d58dc2851a
175 2026-11-06T10:44:33.911619Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a4a6dd2f-5a60-4df2-a2c7-fbff1274c401 200 48.565 5f901438-4dc8-4144-91d8-ea7c1a9b65d8
176 2026-11-06T10:44:33.960298Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c1f5ad3b-b2e6-4dfd-8ff6-cbca6aa089a2 200 47.418 5ad0e8c9-7280-4f0e-a1f6-612c5bf7076c
177 2026-11-06T10:44:34.007761Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=53a91cb7-85bf-4ded-b1f9-29800e0b26a3 200 48.417 c937479d-8e56-43e6-a1c9-3a6c7776b502
178 2026-11-06T10:44:34.056231Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1620d036-399f-4cd0-9bf3-5a0e676bc3ec 200 49.119 c454de5a-121e-4843-8a23-83beb807987a
179 2026-11-06T10:44:34.105395Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=8739385c-bf97-464d-b84b-b12ed4c93285 200 49.423 cfff3513-4c52-42ff-929b-e08bd1bf8fb1
180 2026-11-06T10:44:34.154861Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=628b018b-85eb-4195-ba7e-3306e07b6379 200 49.106 6c983714-cd79-4599-bd3f-5af371c6b0b5
181 2026-11-06T10:44:34.204009Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0c992425-cd6c-4e56-b249-8239c57abf6d 200 48.274 a65ee699-9a8f-4bbc-8dc7-e34a7b3220a4
182 2026-11-06T10:44:34.252326Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=324e4439-d7d9-40fa-bf82-8d86f3ba3433 200 48.507 0977056d-f079-41b5-a45e-f608ec3a78d6
183 2026-11-06T10:44:34.300878Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=36d23f17-cbcd-4e6f-a061-928e05fdb994 200 49.227 d5cd7ddb-4003-45eb-92dd-e9935fe3f352
184 2026-11-06T10:44:34.350152Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=90f5a1b5-0f32-45b9-afe9-ead08a08d4f1 200 49.027 0c314181-bdb8-4e49-98ae-df47cae6d004
185 2026-11-06T10:44:34.399219Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cbca3d14-a881-43d0-a1a3-631573cd23a2 200 48.444 d3f5f781-229e-4b35-93ce-aca05c670dec
186 2026-11-06T10:44:34.447703Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1151e6c7-53ea-40d8-93e7-f00278754ee2 200 48.411 70f31adb-8bff-4b81-a692-13fa4ee88399
187 2026-11-06T10:44:34.496247Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d3eeaa28-e5a9-4b0c-bf82-e8c140e26690 200 48.607 1c8053f1-d084-4c78-8a53-a9c8b03f4927
188 2026-11-06T10:44:34.544893Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=90a86bd2-dc6e-4f94-a2f2-4f209ef7ba75 200 49.514 b6044384-21c5-46b8-afd1-9e4c922c1708
189 2026-11-06T10:44:34.594526Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a912248c-be9b-402a-9df9-21022455be2f 200 48.157 e2932827-3047-42de-914b-0bfbbd8715ae
190 2026-11-06T10:44:34.642732Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d6a39843-0e26-43bb-b4ca-b61b0f3fca5d 200 49.958 c2cdf396-ddb8-44da-ae40-752f05198273
191 2026-11-06T10:44:34.692798Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=e7984ece-e9d7-448f-bbb5-073c23e17e0e 200 49.672 2779999b-ccf9-4473-9f04-29301b4ffb97
192 2026-11-06T10:44:34.742512Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bae7b41a-eea3-4be8-89f9-9929aa14538b 200 48.603 c508b67f-5434-46af-a18c-0b0319c2eb59
193 2026-11-06T10:44:34.791163Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=08896ffc-91a8-4780-94ea-7e15823a4695 200 48.959 0b476040-f046-4074-aacf-f8c65b6c0e99
194 2026-11-06T10:44:34.840161Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=4ab7dd76-19da-405d-a845-7fc31678aa13 200 48.817 ba133764-a524-4a2a-bc6b-61e4c3e3d5cb
195 2026-11-06T10:44:34.889016Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=79dc519e-a9fc-424b-873e-123b06234417 200 49.227 2d8eb0dd-d689-4180-8176-586fc2ad8890
196 2026-11-06T10:44:34.938285Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=17521be5-fd6f-413c-b496-4f9ded6b6613 200 47.66 3b788fc0-49eb-4ae5-839d-15faa190a46e
197 2026-11-06T10:44:34.985989Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=618943cc-c29d-456b-a004-245e38c0a926 200 48.832 f94bc508-8533-4910-be28-cf004f5d58db
198 2026-11-06T10:44:35.034862Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=f3a68e4d-afc4-46ae-8504-a4e64151bbb2 200 47.499 c8bd728c-1d1b-42c1-bbd6-ac1b92278628
199 2026-11-06T10:44:35.082408Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=0056bc26-7a4e-4a5d-835a-0937a05de645 200 48.679 049db403-3616-4129-b4eb-b8df7508c7b4
200 2026-11-06T10:44:35.131128Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=13d6a9d5-c6c9-4c40-b8de-1bb818d337c0 200 48.843 749447b3-a458-40d5-80d2-6711fa384900
201 2026-11-06T10:44:35.180029Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=120d398f-b797-460b-9f9b-e1939cd2b75e 200 49.377 0b61c8a4-c717-436d-94b9-df2c55c74ee9
202 2026-11-06T10:44:35.229460Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=9a4e6a60-26c0-491f-8612-172b59128c63 200 48.121 02945554-08e3-4ee3-9622-1dda276f9241
203 2026-11-06T10:44:35.277627Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d0c48402-3612-434e-9d08-5855262d9543 200 49.253 2890176c-bca4-4554-9db5-e488f12e57ce
204 2026-11-06T10:44:35.327018Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ee300952-58ce-446e-ac98-8deb2c41a925 200 48.502 c0422fa2-c06f-4a2d-8539-01f878643b50
205 2026-11-06T10:44:35.375558Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=fa54d6c7-c7ab-4a36-bd38-76067eefad97 200 49.084 bd57e677-746c-4f8d-923b-ec859e8aa450
206 2026-11-06T10:44:35.424681Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b2880e2e-5f39-4017-8f66-90ae226734c3 200 49.079 db75429a-c3dc-4d2e-a7c1-beb7d272b551
207 2026-11-06T10:44:35.473812Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=95a5a815-2f6d-447c-870d-14dc4de4c21c 200 48.865 945d9c55-4e40-4107-ba01-8c0d39b01a5f
208 2026-11-06T10:44:35.522717Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a7060259-f3d4-4128-846b-d1b9ad4932dc 200 48.215 f4b1c606-43fe-41f2-a51d-6a83583a0f7e
209 2026-11-06T10:44:35.570972Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=651e5a41-dc9a-4f54-9b76-e0fdbb069b55 200 49.694 9562a350-6d77-4f0d-87cc-fdd9d039023a
210 2026-11-06T10:44:35.620718Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3101c3b6-0663-49f0-8c03-ceb6bbb8a6c2 200 48.209 e05b778a-2af4-44bb-a255-d79ed633e1f3
211 2026-11-06T10:44:35.668967Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=c1f649b7-d4e8-4c7a-951f-b54fd4fb060b 200 48.594 86b599b8-4975-4ab0-b87f-d2c960b0d3a5
212 2026-11-06T10:44:35.717605Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d336d074-da53-4054-a978-6cbe89b47752 200 49.157 dc8b4587-580d-47e7-a89b-46280ce8676b
213 2026-11-06T10:44:35.766805Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=d9f13829-2c18-4ba8-9ed8-a35bfa73f086 200 49.524 5c4f673e-c891-4762-812d-93a9c3a76361
214 2026-11-06T10:44:35.816372Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=1e914b74-00b1-4e0f-817e-0a6dfbafd460 200 48.337 9bd7d085-8607-4d71-84d4-d0021a82b3e9
215 2026-11-06T10:44:35.864756Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2680916d-d13c-4777-8cdc-82f796b3ed2a 200 48.2 7e569484-8b6e-4581-a284-14d994eda0a2
216 2026-11-06T10:44:35.913007Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=22d497b8-761c-44bd-b0c1-b7f220363187 200 49.1 de668473-1ea5-4707-af6b-2d7961a0e5ba
217 2026-11-06T10:44:35.962148Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2277404a-f7c2-44c9-a5b3-f91896ce357d 200 49.021 e016eeeb-df6e-4b60-965d-b19070ee3da4
218 2026-11-06T10:44:36.011211Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7c3fdaaa-f048-46a3-a925-4748b0675023 200 48.313 75118216-893c-4bf8-afb2-69d770839fa1
219 2026-11-06T10:44:36.059635Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ddb9c536-7ef4-4508-acf8-8b6bfbbb6849 200 49.149 2ecc550c-112e-43f8-a56f-fc9cbb3897e0
220 2026-11-06T10:44:36.108826Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=74c07576-eb7a-4ff2-8050-af0ecfa61852 200 48.833 6a1bc128-cebf-4e22-999a-b5283c4d90ce
221 2026-11-06T10:44:36.157918Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ecc5effa-e5f3-4733-9c6e-990290e285bb 200 49.333 32b73d1c-825c-49fc-b789-a2cf5a428d0a
222 2026-11-06T10:44:36.207299Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=954ab263-3aa2-4ec9-b4b6-91a415800048 200 48.768 9c404dbf-51d6-4ee2-b1ba-0e695da2817d
223 2026-11-06T10:44:36.256299Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=b3709915-27d8-4a55-8887-4ce420c5c51c 200 48.273 2bb6f74e-18b3-40e3-b998-df68017e9501
224 2026-11-06T10:44:36.304621Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=a0639331-88aa-42f2-a30d-52cca6c4d74a 200 49.297 b9cd8c63-53ea-4212-a8dc-6b483a3fe326
225 2026-11-06T10:44:36.353973Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=28a6b936-ef61-4184-8adf-f86708788464 200 49.503 7202e762-fb87-4b39-b2ab-e2cb0d6fc5dd
226 2026-11-06T10:44:36.403523Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=5dc81c4e-2cd7-43b3-8f50-d0b3ab7b0c46 200 48.49 cc92502d-1707-4d43-a466-a44d73400920
227 2026-11-06T10:44:36.452055Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=ebc83f5b-c3f9-42e7-878d-61d210c8e3db 200 48.286 5a368343-af4e-459d-989f-a0969e68d8dd
228 2026-11-06T10:44:36.500382Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=11a33776-9250-4e16-b60f-87500e1ad109 200 48.516 831254cf-0c86-47e6-bf63-9184640eaf1d
229 2026-11-06T10:44:36.548935Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=973f29af-9337-4fdb-b572-07dea2f9e671 200 48.2 daed38b7-e0f4-449d-af61-943d0710d6e2
230 2026-11-06T10:44:36.597179Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=cefac4c5-844b-48a9-91a1-4d3a15200535 200 50.431 48c5cbd3-fe8f-4e12-a94b-efdc480b19dd
231 2026-11-06T10:44:36.647654Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=2f5ede4a-f21d-4b2b-85f8-5685f30b6574 200 50.37 135d375f-8017-4a7e-bee5-217e7633acc1
232 2026-11-06T10:44:36.698076Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=7bdcd025-1183-4a8a-9201-1401bf1886f1 200 48.789 17cd4b0d-6b01-4ce4-b598-b981120afe2d
233 2026-11-06T10:44:36.746917Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=3be74f7f-2bf1-438e-85f3-613993fb68b3 200 48.672 bc4ecc9f-de11-4420-9603-51e55c1b3cf7
234 2026-11-06T10:44:36.795632Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=53e0427c-e198-44ed-a870-ff74f35169cd 200 49.287 f215d501-1463-4a6f-80e1-ee6757a70619
235 2026-11-06T10:44:36.845054Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=59ea82ae-9adf-463a-b728-c9a24c4f621d 200 49.753 8aa19f1d-871d-4088-8f00-328674b6fc0c
236 2026-11-06T10:44:36.894859Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=bed24cc7-3047-408b-9cf3-61ca3123a131 200 49.077 793c2088-ffb7-44d4-b2b2-526df22d418c
237 2026-11-06T10:44:36.943973Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=09ac6496-7f42-4a98-b1cd-d97ebb9ab331 200 48.86 959179db-7127-49ec-b2c6-f2aa579e631e
238 2026-11-06T10:44:36.992877Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6/messages?limit=100&cursor=fdb04044-a474-4cb2-8eeb-7dce580665e2 200 48.539 c121eaed-dad6-4558-8c00-3dfbfeb3f58b
239 2026-11-06T10:44:37.747366Z POST /api/v1/users 201 36.974 d0561e50-848b-414d-b743-fdfcb23709c0
240 2026-11-06T10:44:37.784389Z POST /api/v1/auth/sessions 201 90.242 e6e88caf-4f41-4270-9256-214686c7b5fb
241 2026-11-06T10:44:37.874661Z GET /api/v1/users/me 200 48.115 8eca8bd6-572f-412a-a0ac-598d2ab1b6b2
242 2026-11-06T10:44:39.255095Z GET /api/v1/users/me 401 2.478 cafb73fa-e684-4197-9fac-4504520555ef
243 2026-11-06T10:44:39.941671Z GET /api/v1/users/me 401 1.332 a7c38ec2-d0d3-4f5b-9405-56c7272969f6
244 2026-11-06T10:44:39.943123Z POST /api/v1/auth/sessions 401 2.372 40f154f2-f2d5-4dae-9ff8-a1f45bbe56e9
245 2026-11-06T10:44:40.034099Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 51.678 3ae54258-5e65-4c75-a268-134bf88863eb
246 2026-11-06T10:44:40.085814Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 48.339 6e07cbd2-2b53-4cb2-b958-d54956255865
247 2026-11-06T10:44:40.134183Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 404 48.573 0efb2986-0761-40dc-b8df-f145314b9317
248 2026-11-06T10:44:40.473965Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 62.898 695f1ea3-671f-42ae-b5d6-77c85b93e561
249 2026-11-06T10:44:40.536904Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 401 0.779 8b5e648d-e6d3-4c3c-9818-357ba8f9c2bf
250 2026-11-06T10:44:41.177283Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 60.095 1a2e9d85-46ed-407e-bfb5-db4c889b9c64
251 2026-11-06T10:44:41.538161Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 52.814 6b14ef0f-76dc-4bff-b7aa-630e4e7df543
252 2026-11-06T10:44:41.591022Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 53.064 93069924-03d4-473c-9b5b-9f31ae347cb3
253 2026-11-06T10:44:41.645634Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 48.576 1f41a014-0fb7-4eaf-9da2-fd808b6e1d33
254 2026-11-06T10:44:41.881711Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2.511 a1507a8f-63c2-4fa5-94c7-45353cd9c69b
255 2026-11-06T10:44:41.884300Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 401 1.816 20f3e995-abcf-4601-b88f-05ee974618d3
256 2026-11-06T10:44:41.886162Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 401 1.582 fe53c87d-8fa3-4cee-9736-3ca083e5b710
257 2026-11-06T10:44:41.887795Z GET /health/ready 503 10.516 a0431f6e-1881-4c94-9462-37b8427df08b
258 2026-11-06T10:44:41.898396Z GET /health/live 200 1.685 c601cd97-a488-4979-91b0-a27db2badb23
259 2026-11-06T10:44:42.148996Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 48.916 90211ae9-24ac-4cb5-8386-7dfddc021370
260 2026-11-06T10:44:43.031341Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2005.983 96303eb1-fd6e-4d4a-93ee-8c76cff4764f
261 2026-11-06T10:44:43.031064Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2006.399 ecc050ab-ae4b-4506-97af-9a4fb3da5b09
262 2026-11-06T10:44:43.031016Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2006.609 cb80f49a-437d-4417-8e6d-ba216c4b2a9d
263 2026-11-06T10:44:43.031255Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2006.508 e96d004f-9bb5-4ff3-b3f2-6541773949d7
264 2026-11-06T10:44:43.031112Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2006.816 51948b7b-35bd-439c-aa95-9febea247359
265 2026-11-06T10:44:43.030818Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2007.255 043660d7-ec6c-4661-a0dd-1c52caf48a8d
266 2026-11-06T10:44:43.029491Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2008.694 206c1e58-095e-4ec1-a281-495c1a79e75f
267 2026-11-06T10:44:43.031196Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 503 2007.084 3d0d0102-3f83-4a34-8bf0-e0cda6a90c95
268 2026-11-06T10:44:45.718620Z GET /api/v1/chats/e6a45519-82bb-44d1-9c50-60d6694ddbb6 200 48.037 0095100e-cb71-4ae6-be6c-45be1ade818d
+18
View File
@@ -0,0 +1,18 @@
tables=chat_members,chats,messages,refresh_tokens,users,versions
version=5
chat_members|chat_members_chat_fk|f|FOREIGN KEY (chat_id) REFERENCES chats(id)
chat_members|chat_members_pkey|p|PRIMARY KEY (chat_id, user_id)
chat_members|chat_members_user_fk|f|FOREIGN KEY (user_id) REFERENCES users(id)
chats|chats_pkey|p|PRIMARY KEY (id)
chats|chats_title_not_blank|c|CHECK (((title)::text !~ '^[[:space:]]*$'::text))
messages|messages_pkey|p|PRIMARY KEY (id)
messages|messages_sender_member_fk|f|FOREIGN KEY (chat_id, sender_id) REFERENCES chat_members(chat_id, user_id)
messages|messages_text_not_blank|c|CHECK (((text)::text !~ '^[[:space:]]*$'::text))
refresh_tokens|refresh_tokens_pkey|p|PRIMARY KEY (id)
refresh_tokens|refresh_tokens_user_id_fkey|f|FOREIGN KEY (user_id) REFERENCES users(id)
users|users_name_not_blank|c|CHECK (((name)::text !~ '^[[:space:]]*$'::text))
users|users_password_hash_not_empty|c|CHECK ((password_hash <> ''::text))
users|users_pkey|p|PRIMARY KEY (id)
users|users_username_format|c|CHECK (((username)::text ~ '^[a-z0-9_]{3,32}$'::text))
users|users_username_unique|u|UNIQUE (username)
versions|versions_pkey|p|PRIMARY KEY (version)
+2
View File
@@ -0,0 +1,2 @@
lab2-verify-20261106t104316z-ed3f45-api | 2026-11-06T10:44:46.418225667Z 2026/11/06 10:44:46 INFO postgres_pool_config max_conns=10 connect_timeout=500ms statement_timeout_ms=2000
lab2-verify-20261106t104316z-ed3f45-api | 2026-11-06T10:44:46.430481917Z 2026/11/06 10:44:46 INFO HTTP server started address=0.0.0.0:8080
+279
View File
@@ -0,0 +1,279 @@
{
"run_id": "20261106T104316Z-ed3f45",
"started_utc": "2026-11-06T10:43:16.282804Z",
"project": "lab2-verify-20261106t104316z-ed3f45",
"port": 18084,
"commit": "711754bbcd6e47a7b83d7f5c922f5f37f6bc0764",
"dirty": true,
"checks": [
{
"name": "fresh_build_and_start",
"status": "PASS",
"duration_seconds": 35.497,
"details": {
"new_project": "lab2-verify-20261106t104316z-ed3f45",
"initial_volumes": [
"lab2-verify-20261106t104316z-ed3f45_postgres_data",
"lab2-verify-20261106t104316z-ed3f45_redis_data"
]
}
},
{
"name": "public_check_and_smoke",
"status": "PASS",
"duration_seconds": 1.398,
"details": {
"check_exit": 0,
"smoke_exit": 0,
"covers": [
"wrong password",
"Basic rejected on private API",
"X-User-Id rejected/ignored",
"logout and revoked token",
"chat access and pagination"
]
}
},
{
"name": "schema_kdf_and_session_randomness",
"status": "PASS",
"duration_seconds": 0.873,
"details": {
"version": 5,
"fk_count": 4,
"password_kdf": "argon2id",
"password_profile": "m=65536,t=3,p=4",
"nonce_bytes": 32
}
},
{
"name": "configuration_compatibility",
"status": "PASS",
"duration_seconds": 4.543,
"details": {
"lifetime_seconds": {
"default": 3600,
"legacy": 86400,
"primary": 2
},
"invalid_configurations_rejected": 5
}
},
{
"name": "contract_validation_edges",
"status": "PASS",
"duration_seconds": 0.396,
"details": {
"cases": 14,
"invalid_uuid_status": 400,
"unknown_fields_status": 400,
"malformed_json_status": 400,
"unsupported_media_status": 415
}
},
{
"name": "repeat_migrations",
"status": "PASS",
"duration_seconds": 0.877,
"details": {
"before": {
"users": 6,
"chats": 2,
"members": 4,
"messages": 3,
"sessions": 9,
"version": 5
},
"after": {
"users": 6,
"chats": 2,
"members": 4,
"messages": 3,
"sessions": 9,
"version": 5
}
}
},
{
"name": "full_persistence",
"status": "PASS",
"duration_seconds": 25.771,
"details": {
"before": {
"api": "3da7e505efac4433644f050c577a9109c248ccf36699cd86a6694e1ccf3f5ba1",
"postgres": "f6f91429ae056a2acd9b39a463a03939743ef2934105f1e6454d84d40ac73eb2",
"redis": "ec0f4389e65b6ddaeb1b6b539016869fdde04bb00e7abea0820e304dfec6fe45"
},
"after": {
"api": "32585ed5f526683f83a7bea7d2b48b949561b7c61dc43a1159602ac36bf35c85",
"postgres": "d34a7cf3d4cfe8243132c7490df4333cf69b1d58819703a2eab8316b4a7b4854",
"redis": "7461556daa96d8a9857ec466ff6940dab06d7d204ee976f385e74638351543d8"
},
"volumes_preserved": [
"lab2-verify-20261106t104316z-ed3f45_postgres_data",
"lab2-verify-20261106t104316z-ed3f45_redis_data"
],
"previous_session_valid": true
}
},
{
"name": "username_registration_race",
"status": "PASS",
"duration_seconds": 0.264,
"details": {
"concurrency": 8,
"created": 1,
"conflicts": 7,
"rows": 1
}
},
{
"name": "chat_creation_rollback",
"status": "PASS",
"duration_seconds": 0.317,
"details": {
"before": {
"users": 10,
"chats": 3,
"members": 6,
"messages": 4,
"sessions": 12,
"version": 5
},
"after": {
"users": 10,
"chats": 3,
"members": 6,
"messages": 4,
"sessions": 12,
"version": 5
},
"failed_step": "member INSERT FK after chat INSERT",
"http_status": 400
}
},
{
"name": "history_20000_and_explain",
"status": "PASS",
"duration_seconds": 10.792,
"details": {
"messages": 20001,
"page_size": 100,
"plans": {
"first": {
"execution_ms": 0.04,
"returned": 101,
"nodes": [
"Limit",
"Index Scan"
]
},
"deep": {
"execution_ms": 0.082,
"returned": 101,
"nodes": [
"Limit",
"Index Scan"
]
}
}
}
},
{
"name": "session_expiry_seconds",
"status": "PASS",
"duration_seconds": 2.896,
"details": {
"session_ttl_seconds": 2,
"legacy_jwt_refresh": "24h",
"before": 200,
"after": 401,
"wait_seconds": 1.327
}
},
{
"name": "additional_authentication",
"status": "PASS",
"duration_seconds": 0.004,
"details": {
"forged_signature": 401,
"unknown_username": 401
}
},
{
"name": "redis_cache_and_failure",
"status": "PASS",
"duration_seconds": 1.697,
"details": {
"cold_sql": 1,
"warm_cache": true,
"outsider_status": 404,
"outage_ms": 62.898,
"startup_without_redis": true,
"recovered": true
}
},
{
"name": "postgres_failure_and_recovery",
"status": "PASS",
"duration_seconds": 0.552,
"details": {
"valid_session_status": 503,
"anonymous_status": 401,
"invalid_token_status": 401,
"ready": 503,
"live": 200,
"outage_ms": 2.511,
"readiness_ms": 10.516,
"previous_session_recovered": true
}
},
{
"name": "pool_limit_and_sql_deadline",
"status": "PASS",
"duration_seconds": 3.628,
"details": {
"test_limit": 2,
"observed_peak": 2,
"requests": 8,
"status": 503,
"durations_ms": [
2006.399,
2006.609,
2006.508,
2007.084,
2006.816,
2005.983,
2007.255,
2008.694
],
"restored_limit": 10,
"query_timeout_ms": 2000,
"connect_timeout_ms": 500
}
},
{
"name": "tracked_secrets_and_contract_audit",
"status": "PASS",
"duration_seconds": 0.078,
"details": {
"private_paths_tracked": 0,
"jwt_or_private_key_findings": 0,
"readme_contract_tests_unchanged": true,
"scope": "current tracked tree; complete Git history is not certified"
}
}
],
"scope": "isolated Compose; original stack is not restarted",
"docker": "29.7.2",
"resources": "linux/aarch64 CPUs=14 memory_bytes=8320954368",
"image": "sha256:0effe11ab9f4d860b5b79d6096ff95325336c752c0d5ca335878ec89baf4f269",
"service_source_sha256": "11bd17ca0b86a6db845ec7c2954c91fd8a870e1999ca45d708a546f0f863fb0e",
"success": true,
"retained_volumes": [
"lab2-verify-20261106t104316z-ed3f45_postgres_data",
"lab2-verify-20261106t104316z-ed3f45_redis_data"
],
"isolated_stack_stopped": true,
"ended_utc": "2026-11-06T10:44:52.582387Z"
}
+61
View File
@@ -0,0 +1,61 @@
# cold_cache
api | 2026-11-06T09:34:43.708491097Z 2026/11/06 09:34:43 INFO chat_cache_miss chat_id=cf51691d-995d-497d-a361-6d0e5685943c
api | 2026-11-06T09:34:43.708526889Z 2026/11/06 09:34:43 INFO chat_db_lookup chat_id=cf51691d-995d-497d-a361-6d0e5685943c
# warm_cache
api | 2026-11-06T09:34:43.952036889Z 2026/11/06 09:34:43 INFO chat_cache_hit chat_id=cf51691d-995d-497d-a361-6d0e5685943c
# outsider_warm_cache
api | 2026-11-06T09:34:44.167119014Z 2026/11/06 09:34:44 INFO chat_cache_hit chat_id=cf51691d-995d-497d-a361-6d0e5685943c
# Redis stopped
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
api mtusi-messenger:lab2 "/usr/local/bin/mess…" api About a minute ago Up About a minute (healthy) 127.0.0.1:8080->8080/tcp
mtusi2026lab2-postgres-1 postgres:17.11-alpine3.23 "docker-entrypoint.s…" postgres 9 minutes ago Up 9 minutes (healthy) 5432/tcp
mtusi2026lab2-redis-1 redis:8.2.11-alpine3.22 "docker-entrypoint.s…" redis 9 minutes ago Exited (0) Less than a second ago
# redis_down
api | 2026-11-06T09:34:44.767687125Z 2026/11/06 09:34:44 WARN chat_cache_read_error chat_id=cf51691d-995d-497d-a361-6d0e5685943c error="failed to read chat cache: dial tcp: lookup redis on 127.0.0.11:53: no such host"
api | 2026-11-06T09:34:44.767689750Z 2026/11/06 09:34:44 INFO chat_db_lookup chat_id=cf51691d-995d-497d-a361-6d0e5685943c
api | 2026-11-06T09:34:44.770251333Z 2026/11/06 09:34:44 WARN failed to cache chat chat_id=cf51691d-995d-497d-a361-6d0e5685943c error="failed to create chat cache: dial tcp: lookup redis on 127.0.0.11:53: no such host"
# API recreated with Redis stopped
api | 2026-11-06T09:34:45.388880375Z 2026/11/06 09:34:45 WARN redis unavailable at startup; continuing without cache error="dial tcp: lookup redis on 127.0.0.11:53: no such host"
api | 2026-11-06T09:34:45.388881917Z 2026/11/06 09:34:45 INFO HTTP server started address=0.0.0.0:8080
# API ready while Redis remains stopped
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
api mtusi-messenger:lab2 "/usr/local/bin/mess…" api Less than a second ago Up Less than a second (health: starting) 127.0.0.1:8080->8080/tcp
mtusi2026lab2-postgres-1 postgres:17.11-alpine3.23 "docker-entrypoint.s…" postgres 9 minutes ago Up 9 minutes (healthy) 5432/tcp
mtusi2026lab2-redis-1 redis:8.2.11-alpine3.22 "docker-entrypoint.s…" redis 9 minutes ago Exited (0) 1 second ago
# startup_without_redis
api | 2026-11-06T09:34:46.010891250Z 2026/11/06 09:34:46 WARN chat_cache_read_error chat_id=cf51691d-995d-497d-a361-6d0e5685943c error="failed to read chat cache: dial tcp: lookup redis on 127.0.0.11:53: no such host"
api | 2026-11-06T09:34:46.010893125Z 2026/11/06 09:34:46 INFO chat_db_lookup chat_id=cf51691d-995d-497d-a361-6d0e5685943c
api | 2026-11-06T09:34:46.014563084Z 2026/11/06 09:34:46 WARN failed to cache chat chat_id=cf51691d-995d-497d-a361-6d0e5685943c error="failed to create chat cache: dial tcp: lookup redis on 127.0.0.11:53: no such host"
# redis_recovered
api | 2026-11-06T09:34:46.555832459Z 2026/11/06 09:34:46 INFO chat_cache_hit chat_id=cf51691d-995d-497d-a361-6d0e5685943c
# recovery_cold_cache
api | 2026-11-06T09:34:46.884677792Z 2026/11/06 09:34:46 INFO chat_cache_miss chat_id=cf51691d-995d-497d-a361-6d0e5685943c
api | 2026-11-06T09:34:46.884696959Z 2026/11/06 09:34:46 INFO chat_db_lookup chat_id=cf51691d-995d-497d-a361-6d0e5685943c
# recovery_warm_cache
api | 2026-11-06T09:34:47.112979084Z 2026/11/06 09:34:47 INFO chat_cache_hit chat_id=cf51691d-995d-497d-a361-6d0e5685943c
# recovery_outsider
api | 2026-11-06T09:34:47.354961709Z 2026/11/06 09:34:47 INFO chat_cache_hit chat_id=cf51691d-995d-497d-a361-6d0e5685943c
# Final container state
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
api mtusi-messenger:lab2 "/usr/local/bin/mess…" api 2 seconds ago Up 2 seconds (health: starting) 127.0.0.1:8080->8080/tcp
mtusi2026lab2-postgres-1 postgres:17.11-alpine3.23 "docker-entrypoint.s…" postgres 9 minutes ago Up 9 minutes (healthy) 5432/tcp
mtusi2026lab2-redis-1 redis:8.2.11-alpine3.22 "docker-entrypoint.s…" redis 9 minutes ago Up 1 second (health: starting) 6379/tcp
# Final health checks settled
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
api mtusi-messenger:lab2 "/usr/local/bin/mess…" api 2 minutes ago Up 2 minutes (healthy) 127.0.0.1:8080->8080/tcp
mtusi2026lab2-postgres-1 postgres:17.11-alpine3.23 "docker-entrypoint.s…" postgres 11 minutes ago Up 11 minutes (healthy) 5432/tcp
mtusi2026lab2-redis-1 redis:8.2.11-alpine3.22 "docker-entrypoint.s…" redis 11 minutes ago Up 2 minutes (healthy) 6379/tcp
+10
View File
@@ -0,0 +1,10 @@
stage,timestamp_utc,actor,status,duration_ms,request_id
cold_cache,2026-11-06T09:34:43.658980Z,alice,200,52.955,bc83a4a8-d946-4a47-bf56-2fa665bd0656
warm_cache,2026-11-06T09:34:43.892999Z,alice,200,60.433,cbc53e92-06d6-4929-9ec8-95d285ad2c49
outsider_warm_cache,2026-11-06T09:34:44.118562Z,eve,404,50.171,7b97fcb4-7144-4856-a06b-bfecf5408ca4
redis_down,2026-11-06T09:34:44.714879Z,alice,200,56.076,e08e99da-70a6-4cf4-865b-b86885e40dcf
startup_without_redis,2026-11-06T09:34:45.942892Z,alice,200,72.418,ad8653e4-1f7c-482a-a475-f4b34ed9235c
redis_recovered,2026-11-06T09:34:46.508318Z,alice,200,48.239,e7661654-9218-48d5-9056-d64f36ee477b
recovery_cold_cache,2026-11-06T09:34:46.828222Z,alice,200,57.662,6799b337-7c13-486c-a53f-7c93d8ef7dea
recovery_warm_cache,2026-11-06T09:34:47.052792Z,alice,200,60.97,17c00939-9b2a-4d49-bf7f-3e47807772e7
recovery_outsider,2026-11-06T09:34:47.291011Z,eve,404,64.866,0919aec6-9e42-47c0-879f-4cf09ccb836d
1 stage timestamp_utc actor status duration_ms request_id
2 cold_cache 2026-11-06T09:34:43.658980Z alice 200 52.955 bc83a4a8-d946-4a47-bf56-2fa665bd0656
3 warm_cache 2026-11-06T09:34:43.892999Z alice 200 60.433 cbc53e92-06d6-4929-9ec8-95d285ad2c49
4 outsider_warm_cache 2026-11-06T09:34:44.118562Z eve 404 50.171 7b97fcb4-7144-4856-a06b-bfecf5408ca4
5 redis_down 2026-11-06T09:34:44.714879Z alice 200 56.076 e08e99da-70a6-4cf4-865b-b86885e40dcf
6 startup_without_redis 2026-11-06T09:34:45.942892Z alice 200 72.418 ad8653e4-1f7c-482a-a475-f4b34ed9235c
7 redis_recovered 2026-11-06T09:34:46.508318Z alice 200 48.239 e7661654-9218-48d5-9056-d64f36ee477b
8 recovery_cold_cache 2026-11-06T09:34:46.828222Z alice 200 57.662 6799b337-7c13-486c-a53f-7c93d8ef7dea
9 recovery_warm_cache 2026-11-06T09:34:47.052792Z alice 200 60.97 17c00939-9b2a-4d49-bf7f-3e47807772e7
10 recovery_outsider 2026-11-06T09:34:47.291011Z eve 404 64.866 0919aec6-9e42-47c0-879f-4cf09ccb836d
+89
View File
@@ -0,0 +1,89 @@
# Кэш чатов: экономия SQL и отказ Redis
## Условия и изменения
Эксперимент выполнен 2026-11-06T09:34:40.942506Z — 2026-11-06T09:34:47.751055Z (UTC, Москва UTC+3).
Базовый commit: `8d44c745358f131ac2836ac05153af687bcf6bc0`. Проверялась сборка из изменённого рабочего дерева, включая ранее незакоммиченные изменения пользователя; этот commit сам по себе не содержит проверенную реализацию.
API image ID: `sha256:9d4af3c2a5c8209475eb195bf04598b843208527f7278af64326fcc4fd7423ec`.
Стенд: Docker Engine 29.7.2, linux/aarch64; CPUs=14; memory_bytes=8320954368; доступно примерно 7,75 GiB памяти Docker VM. У API, PostgreSQL и Redis отдельные ограничения CPU/RAM не заданы (`Memory=0`, `NanoCpus=0`, `CpuQuota=0`, `CpuPeriod=0`). Redis 8.2.11, PostgreSQL image `postgres:17.11-alpine3.23`, сборка контейнера Go 1.27.2, локально `go version go1.27.0 darwin/arm64`. go-redis v9.23.0.
В `GetForMember` оставлены Info-события `chat_cache_hit`, `chat_cache_miss`, `chat_db_lookup`. `errors.Is(err, redis.Nil)` отличает обычный промах от ошибки чтения `chat_cache_read_error` уровня Warn. Проверка `MemberIDs` выполняется до возврата кэшированного чата. Ошибки чтения и записи Redis не мешают получить чат из PostgreSQL.
Стартовый PING Redis больше не останавливает приложение при ошибке; зависимость API от Redis в Compose удалена. PostgreSQL остаётся обязательной зависимостью. В go-redis установлены `DialTimeout`, `ReadTimeout`, `WriteTimeout`, `PoolTimeout` по 200 мс; `MaxRetries=-1`, `DialerRetries=1`, `ContextTimeoutEnabled=true`. Каждый GET/SET кэша и стартовый PING получает отдельный дочерний контекст с бюджетом 300 мс. Контекст обращения к PostgreSQL остаётся исходным. При GET и последующем SET возможны два отдельных бюджета кэша; это не общий таймаут всего HTTP-запроса.
## Методика и команды
Перед экспериментом успешно выполнены `go build ./...` из `service/`, `docker compose --env-file .env config --quiet` и `docker compose --env-file .env up -d --build api redis`. Новые тесты не добавлялись.
Через API зарегистрированы три уникальных синтетических пользователя alice, bob и eve. Через `POST /api/v1/auth/sessions` с Basic-аутентификацией получены действующие Bearer session tokens. В этом API используется поле `token` ответа создания сессии. Создан один чат с alice и bob; eve в него не входит. Пароли и токены хранились только в памяти процесса проверки; ответы создания сессий не сохранялись. Созданные пользователи и чат остались на локальном стенде.
Тестовый чат: `cf51691d-995d-497d-a361-6d0e5685943c`. Redis DB: `0`, ключ: `chat:cf51691d-995d-497d-a361-6d0e5685943c`.
Профиль: один последовательный поток, 9 GET одного чата, без нагрузки от экспериментального клиента параллельно. Это функциональная демонстрация, а не измерение пропускной способности или процентилей задержки.
Для удаления ровно одного ключа использовалась команда ниже. Пароль разворачивается внутри контейнера и не передаётся значением в аргументах хостовой команды:
```sh
docker compose --env-file .env exec -T redis sh -c \
'REDISCLI_AUTH="$REDIS_PASSWORD" exec redis-cli --no-auth-warning -n 0 DEL "$1"' \
redis-cli chat:cf51691d-995d-497d-a361-6d0e5685943c
```
Первый DEL вернул `0`: новый чат ещё не был закэширован. Затем выполнены два GET участником и один GET посторонним. Запросы имели вид:
```sh
curl -sS -D - -o /dev/null \
-H "Authorization: Bearer $SESSION_TOKEN" \
http://127.0.0.1:8080/api/v1/chats/cf51691d-995d-497d-a361-6d0e5685943c
```
`SESSION_TOKEN` здесь — локальная переменная с действующей сессией нужного пользователя; её значение не включается в отчёт. Реальный прогон выполнялся HTTP-клиентом Python с таймаутом 5 секунд и замером через монотонные часы. У каждого ответа записаны статус, длительность и `X-Request-Id`. Все успешные ответы GET сравнены с полным объектом созданного чата, расхождений нет.
Затем выполнена последовательность:
```sh
docker compose --env-file .env stop redis
# GET участником: 200 из PostgreSQL.
docker compose --env-file .env up -d --no-deps --force-recreate api
# /health/ready: 200; GET прежним Bearer-токеном: 200 при остановленном Redis.
docker compose --env-file .env start redis
# Дождаться PONG; GET: cache hit без перезапуска API.
# Повторить DEL одного ключа, затем два GET участником и один GET посторонним.
docker compose --env-file .env ps -a
```
До остановки `EXISTS` ключа вернул `1`, после запуска Redis — `1`. Повторный DEL вернул `1`. Ключ пережил корректный stop/start с включёнными AOF (`appendonly yes`, `appendfsync everysec`) и сохранённым volume. Это наблюдение для корректной остановки, а не доказательство сохранности при аварийном отключении питания. Удалялись только указанные тестовые ключи; volumes не удалялись.
## Фактические результаты
| Этап | HTTP | Время клиента, мс | События API |
| --- | --- | --- | --- |
| Пустой кэш, участник | 200 | 52.955 | miss → db_lookup |
| Заполненный кэш, участник | 200 | 60.433 | hit, без db_lookup |
| Заполненный кэш, посторонний | 404 | 50.171 | hit, без db_lookup |
| Redis остановлен | 200 | 56.076 | read_error → db_lookup; ошибка SET |
| API пересоздан без Redis | 200 | 72.418 | read_error → db_lookup; ошибка SET |
| Redis восстановлен, API не перезапускался | 200 | 48.239 | hit, без db_lookup |
| После восстановления и DEL | 200 | 57.662 | miss → db_lookup |
| Повтор после заполнения | 200 | 60.97 | hit, без db_lookup |
| Посторонний после восстановления | 404 | 64.866 | hit, без db_lookup |
Здесь `hit`, `miss`, `read_error`, `db_lookup` соответствуют событиям `chat_cache_hit`, `chat_cache_miss`, `chat_cache_read_error`, `chat_db_lookup`. При остановленном контейнере Docker DNS возвращал `lookup redis ... no such host`; это ошибка подключения, а не `redis.Nil`. В этих запросах зафиксированы также ошибки записи кэша, но клиент получил корректный чат.
При старте API без Redis записано предупреждение `redis unavailable at startup; continuing without cache`, затем `HTTP server started`. Готовность проверена через HTTP, поэтому промежуточный статус Docker `health: starting` в журнале не означает, что запросы ещё не обслуживались.
[CSV запросов](redis-cache-requests.csv) содержит точные времена и request IDs. [Журнал API и состояния контейнеров](redis-cache-api.log) содержит отобранные строки исходных логов по временным окнам каждого последовательного запроса. События кэша содержат `chat_id`; HTTP-статусы и request IDs взяты непосредственно из ответов и находятся в CSV. Журнал не является полным дампом логов контейнеров.
## Что доказано и ограничения
Первый GET вызывает `ChatsRepo.GetForMember`, выполняющий один SQL SELECT чата с проверкой членства. Повторный GET возвращается из Redis до вызова репозитория. Таким образом, пара GET участника выполняет **один запрос чтения чата вместо двух: один запрос сэкономлен**. После восстановления Redis это подтверждено повторно. Число вызовов установлено по диагностическим веткам кода; серверный SQL-трейс или `pg_stat_statements` в этом эксперименте не собирались.
Каждый авторизованный GET отдельно проверяет сессию в PostgreSQL (`VerifySession` → `refreshTokensRepo.GetByID`), включая попадание в кэш. Поэтому отсутствие `chat_db_lookup` не означает отсутствие любых SQL-запросов. Время второго запроса в этой короткой серии не уменьшилось; демонстрация подтверждает экономию чтений чата, а не ускорение HTTP.
Посторонний пользователь получил 404 при заполненном кэше до и после отказа. API обслуживает запросы и запускается при недоступном Redis; после восстановления Redis тот же клиент возобновляет работу. Проверялось отключение через stop, а не зависшее соединение или потеря пакетов, поэтому наблюдаемые 56–72 мс не доказывают верхнюю границу задержки для всех сетевых отказов.
Текущий кэш хранит чат без TTL (`SET` с expiration=0). Для существующего API без изменения состава участников это не менялось; при добавлении такого изменения потребуется инвалидация кэша, чтобы кэшированная проверка доступа не устаревала.
Общие `keyspace_hits`/`keyspace_misses` Redis в доказательство отдельных GET не использовались: они включают обращения других клиентов.
Справочники: [таймауты и повторы go-redis](https://redis.io/docs/latest/develop/clients/go/produsage/), [Redis INFO](https://redis.io/docs/latest/commands/info/), [Docker Compose stop](https://docs.docker.com/reference/cli/docker/compose/stop/), [Docker Compose start](https://docs.docker.com/reference/cli/docker/compose/start/).
+230 -4
View File
@@ -1,7 +1,233 @@
# Инфраструктура студента
# Инфраструктура лабораторной 2
Здесь разместите конфигурации выбранных сервисов; основную топологию — в корневом compose.yaml/stack.yaml. `compose.example.yaml` — только worksheet ролей и намеренно не запускается. `contracts/infrastructure.json` задаёт минимальные роли, не готовые образы/пароли.
Рабочая топология описана в корневом [docker-compose.yml](../docker-compose.yml). API собирается из исходников проекта
по [Dockerfile](../Dockerfile). Этот каталог содержит эксплуатационное описание решения; конфигурации сервисов остаются
в корне репозитория.
В REPORT.md сопоставьте роль → service name → версия/digest → health/readiness → volume → сеть/порт → способ передачи credentials. Приведите bootstrap (schema, bucket, broker topology, а с lab6 provisioning) и безопасное повторение этих команд.
[compose.example.yaml](../compose.example.yaml) — учебный worksheet,
а [contracts/infrastructure.json](../contracts/infrastructure.json) — требования к ролям. Для запуска используется
именно docker-compose.yml. Подробные инструкции подготовки окружения и описание реализации находятся
в [REPORT.md](../REPORT.md).
Приложение строится из исходников. Не используйте заранее существующий образ преподавательского сервера вместо своей реализации. Restart hook перезапускает все соответствующие stores с volumes; failover hook останавливает только заданную API-реплику.
## Сервисы и топология
| Роль | Service name | Образ / версия | Healthcheck / readiness | Постоянное хранилище | Сеть и порты | Credentials |
|--------------------------|--------------|------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|----------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|
| HTTP API | `api` | Локальная сборка `mtusi-messenger:lab2`; builder `golang:1.27.2-alpine3.23`, runtime `alpine:3.23.6` | Docker healthcheck вызывает `/health/ready`; обработчик проверяет HTTP-сервер и PING PostgreSQL с бюджетом 200 мс | Прикладные данные находятся в PostgreSQL; `./certs` смонтирован в `/run/certs` только для чтения | Внутри `0.0.0.0:8080`; на хосте `127.0.0.1:${HOST_PORT:-8080}` | Подключения к хранилищам из env; RSA-ключи из bind mount; клиентские запросы — Basic при входе и Bearer после входа |
| Источник истины | `postgres` | `postgres:17.11-alpine3.23` | `pg_isready` по TCP localhost с заданными пользователем и БД | `postgres_data:/var/lib/postgresql/data` | `postgres:5432` внутри сети, порт на хост не опубликован | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB`; Compose получает имя БД из `POSTGRES_DATABASE` |
| Необязательный кэш чатов | `redis` | `redis:8.2.11-alpine3.22` | Аутентифицированный `redis-cli PING`, ожидается `PONG` | `redis_data:/data`; AOF включён | `redis:6379` внутри сети, порт на хост не опубликован | `REDIS_PASSWORD`; сервер запущен с `--requirepass`, API использует пользователя `default` и выбранную Redis DB |
Compose создаёт проектную bridge-сеть `<project>_default`; сервисы обращаются друг к другу по именам `postgres` и
`redis`. Отдельная сеть с `internal: true` не настроена. Именованные volumes получают префикс проекта:
`<project>_postgres_data` и `<project>_redis_data`. В стандартном запуске контейнер API явно называется `api`.
PostgreSQL обязателен: `depends_on` API ожидает его `service_healthy` при запуске. Redis в `depends_on` API не включён;
ошибка стартового PING логируется, приложение продолжает работать через PostgreSQL. Его реквизиты подключения всё равно
должны присутствовать в конфигурации.
API работает от UID/GID `65532:65532`. Политика перезапуска всех трёх сервисов — `unless-stopped`. Время штатной
остановки контейнера: API 10 секунд, PostgreSQL 60 секунд, Redis 30 секунд; HTTP graceful shutdown по умолчанию
ограничен 8 секундами.
### Health и готовность
- `/health/live` возвращает состояние HTTP-процесса и не проверяет хранилища.
- `/health/ready` возвращает 200 при работающем HTTP-сервере и доступном PostgreSQL; при отказе БД — 503. Redis не
влияет на readiness.
- Docker healthcheck API выполняется каждые 10 секунд, timeout 3 секунды, start period 5 секунд, retries 3.
- Healthcheck PostgreSQL выполняется каждые 5 секунд, timeout 3 секунды, start period 30 секунд, retries 12.
- Healthcheck Redis выполняется каждые 5 секунд, timeout 3 секунды, start period 5 секунд, retries 12. Пароль передаётся
redis-cli через `REDISCLI_AUTH` внутри контейнера, его значение в вывод не включается.
Версии базовых образов закреплены тегами в Dockerfile и Compose. Тег собственного образа `mtusi-messenger:lab2`
обновляется при локальной сборке. ID образа, на котором прошла приёмка уровней 3/4:
`sha256:0effe11ab9f4d860b5b79d6096ff95325336c752c0d5ca335878ec89baf4f269`. Это идентификатор проверенной сборки, а не
утверждение о текущем содержимом локального тега или registry digest. Commit, SHA-256 исходников и параметры того
прогона находятся в [summary.json](../evidence/levels-3-4/summary.json).
## Окружение и ключи
Все команды ниже выполняются **из корня репозитория**. Нужны Docker Compose v2 с поддержкой `--wait`, OpenSSL и Make;
для проверок также Python 3.9+. На Linux для показанной настройки доступа к ключам нужна утилита `setfacl`.
На первом запуске создать локальный `.env` из [.env.example](../.env.example), не перезаписывая существующий:
```sh
umask 077
cp -n .env.example .env
```
Перед запуском заменить оба password-placeholder на разные локальные пароли PostgreSQL и Redis. В REPORT.md
приведена [инструкция](../REPORT.md) автоматической генерации `.env` без вывода паролей. Оставить
`POSTGRES_RUN_MIGRATIONS=true`. Для стандартного Compose использовать `POSTGRES_HOST=postgres`, `REDIS_HOST=redis`,
внутренние порты 5432/6379 и `APP_PORT=8080`. `HOST_PORT` меняет только порт API на хосте; целевой порт публикации
закреплён на 8080.
На чистом окружении создать ключи подписи JWT:
```sh
umask 077
if [ ! -e certs/private_key.pem ] && [ ! -e certs/public_key.pem ]; then
make key-gen
fi
test -f certs/private_key.pem && test -f certs/public_key.pem
chmod 600 certs/private_key.pem
chmod 644 certs/public_key.pem
```
Команда генерирует пару только при отсутствии обоих файлов. Если сохранилась только одна часть, сначала нужно восстановить согласованную пару; автоматически перезаписывать оставшуюся часть нельзя. Повторно генерировать уже используемую пару при обычном запуске или рестарте не нужно: прежние сессии требуют прежнего
ключа проверки подписи. Ключи не являются TLS-сертификатами; локальный API использует HTTP.
На Linux предоставить контейнерному UID чтение файлов и доступ к каталогу:
```sh
setfacl -m u:65532:rx certs
setfacl -m u:65532:r certs/private_key.pem certs/public_key.pem
```
На Docker Desktop отображение прав зависит от файлового backend. Проверка чтения из контейнера приведена в разделе
запуска. Приватный ключ не требуется делать общедоступным. В `.env` задаются контейнерные пути
`/run/certs/private_key.pem` и `/run/certs/public_key.pem`; bind mount доступен только для чтения, а
`create_host_path: false` не позволяет незаметно создать отсутствующий каталог.
`.env`, каталог `certs/`, локальные `secrets/`, данные и volumes исключены из Git правилами [.gitignore](../.gitignore).
Пароли передаются через environment контейнеров; Docker secrets в этом Compose не используются. Не сохранять полный
вывод `docker compose config` или credentials в отчёт; для проверки конфигурации достаточно `config --quiet`.
### Основные параметры
| Настройка | Значение и поведение |
|-------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| `POSTGRES_RUN_MIGRATIONS`, `POSTGRES_VERSION_TABLE` | `true`, `versions` в примере; включают миграции API и учёт их версии |
| `POSTGRES_MAX_CONNECTIONS` | Максимум соединений пула API, по умолчанию 10 |
| `POSTGRES_CONNECT_TIMEOUT` | По умолчанию 500 мс |
| `POSTGRES_QUERY_TIMEOUT` | По умолчанию 2 секунды; контекст бизнес-запроса и statement_timeout соединений приложения |
| `SESSION_TTL_SECONDS` | Положительное целое число секунд; в примере 3600. Имеет приоритет над legacy `JWT_REFRESH_TOKEN_LIFETIME`; при отсутствии обеих переменных — 3600 секунд |
| `REDIS_DB` | По умолчанию 0; ключи кэша находятся в выбранной DB |
| Таймауты Redis | Dial/read/write/pool по 200 мс; отдельный бюджет GET/SET/PING 300 мс; повторы команд отключены |
| `APP_READ_TIMEOUT`, `APP_WRITE_TIMEOUT`, `APP_IDLE_TIMEOUT` | По умолчанию 5, 10 и 60 секунд |
Параметры Compose и содержимое `.env.example` не заменяют настройки уже существующего хранилища. Например, замена
`POSTGRES_PASSWORD` в `.env` не меняет пароль роли, ранее созданной в сохранённом PostgreSQL volume. При повторном
использовании данных сохранять согласованные реквизиты, имя БД и ключи JWT.
## Bootstrap и повторный запуск
На новом volume entrypoint PostgreSQL создаёт роль и БД из environment. Схему приложения создаёт API:
SQL-миграции [service/migrations](../service/migrations) встроены в бинарник через `go:embed` и применяются Tern до
запуска HTTP-сервера. Отдельного SQL-bootstrap в Compose нет.
Пять миграций создают `users`, `refresh_tokens`, `chats`, `chat_members`, `messages`, ограничения и индексы. Таблица
`versions` хранит версию Tern. При повторном запуске применяются только ещё не выполненные миграции; данные не
пересоздаются и не заполняются повторно. Обычный старт не создаёт экспериментальные fixtures. При ошибке миграции API
завершает запуск с ошибкой. Отключать миграции на пустом volume нельзя, если схема не подготовлена отдельно.
Redis запускается с `appendonly yes` и `appendfsync everysec`. Отдельного bootstrap кэша нет: первый доступный участнику
GET чата читает PostgreSQL и сохраняет `chat:<UUID>` в Redis. Значение содержит метаданные и MemberIDs. Чат хранится без
TTL; обязательный API не меняет состав участников. При добавлении таких изменений потребуется инвалидация, чтобы
кэшированная проверка доступа не устаревала.
Сессии находятся в PostgreSQL, поэтому Redis не является единственным хранилищем аутентификации. Ошибки чтения/записи
кэша обходятся через PostgreSQL. AOF и volume позволяют сохранять кэш при проверенном корректном stop/start, но не
заменяют backup PostgreSQL и не доказывают сохранность при потере питания.
Собрать API, проверить доступ к ключам и запустить сервисы:
```sh
docker compose --env-file .env config --quiet
docker compose --env-file .env build api
docker compose --env-file .env run --rm --no-deps --entrypoint sh api \
-c 'test -r /run/certs/private_key.pem && test -r /run/certs/public_key.pem'
docker compose --env-file .env up -d --no-build --wait --wait-timeout 120
curl --fail --silent --show-error http://127.0.0.1:8080/health/live
curl --fail --silent --show-error http://127.0.0.1:8080/health/ready
docker compose --env-file .env ps -a
```
При изменённом `HOST_PORT` заменить порт в curl. Повторный `up` использует прежние volumes. После изменения исходников
нужна новая сборка API; после изменения environment — пересоздание соответствующего контейнера, а не только `start`.
Выборочные логи приложения:
```sh
docker compose --env-file .env logs --tail 100 api
```
## Перезапуск, проверки отказов и остановка
[Restart-hook](../scripts/restart.sh) сначала проверяет конфигурацию и собирает API, затем останавливает API,
пересоздаёт PostgreSQL и Redis с прежними volumes, ждёт healthchecks и пересоздаёт API. Ключи и `.env` должны быть
подготовлены заранее; hook их не генерирует и volumes не удаляет.
Обычный полный перезапуск:
```sh
./scripts/restart.sh
```
Hook поддерживает `COMPOSE_ENV_FILE` (по умолчанию `.env`), `COMPOSE_OVERRIDE_FILE` (дополнительный файл при наличии) и
стандартный `COMPOSE_PROJECT_NAME`. Для параллельных стендов одного project name недостаточно: override должен также
заменить фиксированное имя контейнера API, опубликованный порт и bind mount ключей. Это реализовано
в [автоматизированном runner](../scripts/verify_lab2.py).
Публичные проверки выполняют реальные операции с синтетическими данными указанного стенда:
```sh
make check
make test BASE_URL=http://127.0.0.1:8080
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:8080
```
Проверить все критерии на отдельном проекте, сохраняя новый прогон отдельно от уже приложенных доказательств:
```sh
python3 scripts/verify_lab2.py --port 18084 --output evidence/levels-3-4-repeat
```
Runner создаёт собственные ключи, пароли и volumes, проверяет миграции, полный рестарт, expiry и отказы. В конце
проверочный проект останавливается без удаления volumes; основной стенд на 8080 не перезапускается.
Для отдельной проверки отказа Redis используются команды ниже. Между stop и start авторизованный GET должен
обслуживаться из PostgreSQL. После start дождаться готовности Redis и повторить запрос; действительный Bearer-токен не
следует сохранять в журналы команд или evidence.
```sh
docker compose --env-file .env stop redis
docker compose --env-file .env start redis
```
При остановленном PostgreSQL действующая сессия получает 503, анонимный и неверный Bearer — 401; readiness возвращает
503, liveness остаётся 200. После восстановления БД прежняя сессия продолжает работать. Подробная безопасная проверка
этого сценария выполняется runner на отдельном стенде.
Обычная остановка всего проекта сохраняет volumes и локальные ключи:
```sh
docker compose --env-file .env down
```
**Намеренный сброс учебных данных:** следующая команда удаляет оба именованных volume текущего проекта, включая
пользователей, сообщения, сессии и кэш. Она не используется в restart-hook и не является обычным перезапуском:
```sh
docker compose --env-file .env down --volumes
```
При потере ключей JWT записи сессий в PostgreSQL сами по себе недостаточны для проверки ранее подписанных токенов.
Volumes и ключи нужно сохранять согласованно. Backup → restore, потеря диска, HA и многорепличный failover не входят в
проведённые исследования этой инфраструктуры.
## Подтверждённые результаты
- [Приёмка уровней 3/4](../evidence/levels-3-4/README.md): 16 групп PASS; собственный стенд, версии и image ID,
ограничения, миграции, pool/SQL timeouts, история 20 001 сообщений с EXPLAIN, expiry и отказы.
- [Реальный вывод check/smoke/persistence](../evidence/levels-3-4/checks.txt)
и [summary.json](../evidence/levels-3-4/summary.json): IDs всех трёх контейнеров до/после перезапуска и сохранённые
volumes.
- [Демонстрация кэша и отказа Redis](../evidence/redis-cache.md)
и [эксперимент stampede](../evidence/cache-stampede/README.md): результаты предшествующих сборок с их собственными
параметрами и ограничениями.
- [Полный отчёт](../REPORT.md): реализация, соответствие критериям, запуск и границы проведённых проверок.
Эта инструкция основана на текущих конфигурационных файлах и сохранённых результатах. При её оформлении сервисы не
запускались и не перезапускались, новые тесты не добавлялись.
+418
View File
@@ -0,0 +1,418 @@
#!/usr/bin/env python3
"""Repeatable local cache experiment; uses Docker, Python stdlib and synthetic data.
Requires prebuilt before/after API images. Temporarily restarts local PostgreSQL
with pg_stat_statements, then restores Compose without deleting data or volumes.
"""
import argparse
import base64
import concurrent.futures as futures
import contextlib
import csv
import datetime as dt
import http.client
import hashlib
import json
import math
import pathlib
import secrets
import select
import socket
import subprocess
import tempfile
import threading
import time
import uuid
ROOT = pathlib.Path(__file__).resolve().parents[1]
NORMAL = ['docker', 'compose', '--env-file', str(ROOT / '.env'), '-f', str(ROOT / 'docker-compose.yml')]
PSQL = ['exec', '-T', 'postgres', 'sh', '-c',
'exec psql -X -q -At -v ON_ERROR_STOP=1 -U "$POSTGRES_USER" -d "$POSTGRES_DB"']
def now():
return dt.datetime.now(dt.timezone.utc).isoformat().replace('+00:00', 'Z')
def run(args, sql=None, timeout=90):
result = subprocess.run(args, input=sql, text=True, capture_output=True, cwd=ROOT, timeout=timeout)
if result.returncode:
# Never echo config, SQL parameters, HTTP bodies or credentials on failure.
raise RuntimeError('External command failed: ' + ' '.join(args[:3]))
return result.stdout.strip()
def percentile(values, fraction):
values = sorted(values)
return round(values[max(0, math.ceil(len(values) * fraction) - 1)], 3)
class Experiment:
def __init__(self, args, override):
self.args, self.override = args, override
self.out = ROOT / args.output
self.out.mkdir(parents=True, exist_ok=True)
cfg = json.loads(run(NORMAL + ['config', '--format', 'json']))
api = cfg['services']['api']
self.port = int(api['ports'][0]['published'])
self.db = str(api['environment']['REDIS_DB'])
self.pg_command = cfg['services']['postgres'].get('command') or ['postgres']
self.normal_image = api['image']
self.requests, self.runs, self.checks, self.logs, self.resources = [], [], [], [], []
self.summary = dict(started_utc=now(), commit=run(['git', 'rev-parse', 'HEAD']), dirty=True,
method=vars(args).copy(), images={}, runs=self.runs, checks=self.checks, resources=self.resources)
self.summary['docker_resources'] = run(['docker', 'info', '--format',
'{{.OSType}}/{{.Architecture}} CPUs={{.NCPU}} memory_bytes={{.MemTotal}}'])
self.summary['docker_version'] = run(['docker', 'version', '--format', '{{.Server.Version}}'])
for name, image in [('before', args.before_image), ('after', args.after_image)]:
self.summary['images'][name] = run(['docker', 'image', 'inspect', '--format', '{{.Id}}', image])
if self.summary['images']['after'] != run(['docker', 'image', 'inspect', '--format', '{{.Id}}', self.normal_image]):
raise RuntimeError('Build/tag the after image as the normal Compose API image before running')
self.summary['postgres_version'] = self.sql('SHOW server_version;')
self.summary['redis_version'] = self.redis('INFO', 'server').split('redis_version:')[1].splitlines()[0]
self.summary['source_sha256'] = {name: hashlib.sha256((ROOT/name).read_bytes()).hexdigest() for name in ('service/internal/service/chat/svc.go','service/go.mod','scripts/cache_stampede.py')}
self.preload = self.sql('SHOW shared_preload_libraries;')
self.had_extension = self.sql("SELECT count(*) FROM pg_extension WHERE extname='pg_stat_statements';") == '1'
libraries = [s.strip() for s in self.preload.split(',') if s.strip()]
if 'pg_stat_statements' not in libraries:
libraries.append('pg_stat_statements')
self.libraries = ','.join(libraries)
def compose(self, *args):
return run(NORMAL + ['-f', str(self.override)] + list(args))
def sql(self, sql):
return run(NORMAL + PSQL, sql=sql)
def use_image(self, image):
self.override.write_text(json.dumps({'services': {
'api': {'image': image},
'postgres': {'command': self.pg_command + ['-c', 'shared_preload_libraries=' + self.libraries]}}}))
def redis(self, *args):
return run(NORMAL + ['exec', '-T', 'redis', 'sh', '-c',
'REDISCLI_AUTH="$REDIS_PASSWORD" exec redis-cli --no-auth-warning -n "$@"',
'redis-cli', self.db] + list(args))
def wait_postgres(self):
deadline = time.monotonic() + 60
while time.monotonic() < deadline:
try:
if self.sql('SELECT 1;') == '1':
return
except RuntimeError:
pass
time.sleep(.3)
raise RuntimeError('PostgreSQL readiness timeout')
def http(self, method, path, actor=None, body=None, basic=None, timeout=5):
conn = http.client.HTTPConnection('127.0.0.1', self.port, timeout=timeout)
headers = {}
if actor:
headers['Authorization'] = 'Bearer ' + actor['token']
if basic:
headers['Authorization'] = 'Basic ' + base64.b64encode(basic.encode()).decode()
if body is not None:
headers['Content-Type'] = 'application/json'
stamp, started = now(), time.perf_counter()
try:
conn.request(method, path, body=None if body is None else json.dumps(body), headers=headers)
response = conn.getresponse()
data = response.read()
return dict(status=response.status, data=json.loads(data) if data else None,
request_id=response.getheader('X-Request-Id', ''), timestamp_utc=stamp,
duration_ms=round((time.perf_counter() - started) * 1000, 3))
finally:
conn.close()
def ready(self):
deadline = time.monotonic() + 45
while time.monotonic() < deadline:
try:
if self.http('GET', '/health/ready')['status'] == 200:
return
except (OSError, http.client.HTTPException):
pass
time.sleep(.3)
raise RuntimeError('API readiness timeout')
def collect_logs(self, since, label):
time.sleep(.05)
lines = run(NORMAL + ['logs', '--no-color', '--timestamps', '--since', since, 'api'])
safe = [line for line in lines.splitlines() if
(self.chat['id'] in line and ('chat_cache_' in line or 'chat_db_lookup' in line or 'failed to cache chat' in line))
or 'redis unavailable at startup' in line or 'HTTP server started' in line]
self.logs.append('\n# ' + label + '\n' + '\n'.join(safe) + '\n')
self.flush()
def flush(self):
self.summary['updated_utc'] = now()
(self.out / 'summary.json').write_text(json.dumps(self.summary, indent=2) + '\n')
(self.out / 'api.log').write_text(''.join(self.logs))
if self.requests:
with (self.out / 'requests.csv').open('w', newline='') as stream:
writer = csv.DictWriter(stream, fieldnames=list(self.requests[0]), lineterminator="\n")
writer.writeheader()
writer.writerows(self.requests)
def actor(self, label):
username, password = 'stampede_' + uuid.uuid4().hex[:16], secrets.token_urlsafe(24)
user = self.http('POST', '/api/v1/users', body=dict(username=username, display_name='Experiment ' + label, password=password))
if user['status'] != 201:
raise RuntimeError('Synthetic registration failed')
session = self.http('POST', '/api/v1/auth/sessions', basic=username + ':' + password)
if session['status'] != 201:
raise RuntimeError('Synthetic login failed')
return dict(label=label, id=user['data']['id'], token=session['data']['token'])
def snapshot(self):
# Only normalized query identities and counters are exported, never SQL parameters.
data = self.sql("""SELECT coalesce(json_agg(row_to_json(s)), '[]'::json) FROM (
SELECT queryid::text AS queryid, calls, total_exec_time,
CASE WHEN query LIKE '%FROM chats c%' THEN 'chat' ELSE 'session' END AS kind
FROM pg_stat_statements WHERE dbid=(SELECT oid FROM pg_database WHERE datname=current_database())
AND ((query LIKE '%FROM chats c%' AND query LIKE '%AND EXISTS%')
OR (query LIKE '%FROM refresh_tokens%' AND query LIKE '%WHERE id = $1%' AND query NOT LIKE '%FOR UPDATE%'))
) s;""")
return json.loads(data)
@staticmethod
def delta(before, after):
result = {}
for kind in ('chat', 'session'):
result[kind + '_sql'] = sum(r['calls'] for r in after if r['kind'] == kind) - sum(r['calls'] for r in before if r['kind'] == kind)
result[kind + '_sql_exec_ms'] = round(sum(r['total_exec_time'] for r in after if r['kind'] == kind) - sum(r['total_exec_time'] for r in before if r['kind'] == kind), 3)
return result
@contextlib.contextmanager
def lock(self):
proc = subprocess.Popen(NORMAL + PSQL, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
stderr=subprocess.PIPE, text=True, cwd=ROOT)
try:
proc.stdin.write("SET statement_timeout='5s'; SET idle_in_transaction_session_timeout='5s';\nBEGIN;\nLOCK TABLE chats IN ACCESS EXCLUSIVE MODE;\n\\echo LOCKED\n")
proc.stdin.flush()
if not select.select([proc.stdout], [], [], 8)[0] or proc.stdout.readline().strip() != 'LOCKED':
raise RuntimeError('Could not acquire experimental table lock')
yield
finally:
if proc.poll() is None:
try:
proc.communicate('ROLLBACK;\n\\q\n', timeout=8)
except (subprocess.TimeoutExpired, BrokenPipeError):
proc.kill()
proc.communicate()
def burst(self, phase, mode, repetition, actors=None):
actors = actors or [self.alice] * self.args.concurrency
if mode not in ('warm', 'mixed_warm'):
self.redis('DEL', self.key)
before, since = self.snapshot(), now()
barrier = threading.Barrier(len(actors) + 1, timeout=15)
path = '/api/v1/chats/' + self.chat['id']
def worker(index, actor):
# Establish threads and touch HTTP before releasing the simultaneous burst.
if self.http('GET', '/health/live')['status'] != 200:
raise RuntimeError('Worker warmup failed')
barrier.wait()
try:
result = self.http('GET', path, actor)
expected = 404 if actor['label'] == 'eve' else 200
ok = result['status'] == expected and (expected == 404 or result['data'] == self.chat)
status, ms, rid, stamp = result['status'], result['duration_ms'], result['request_id'], result['timestamp_utc']
except (OSError, http.client.HTTPException):
ok, status, ms, rid, stamp = False, 0, 5000, '', now()
return dict(phase=phase, mode=mode, repetition=repetition, worker=index, actor=actor['label'],
timestamp_utc=stamp, status=status, duration_ms=ms, request_id=rid, correct=ok)
with futures.ThreadPoolExecutor(max_workers=len(actors)) as pool:
jobs = [pool.submit(worker, i, actor) for i, actor in enumerate(actors)]
controlled = mode in ('cold', 'mixed_cold')
with self.lock() if controlled else contextlib.nullcontext():
barrier.wait()
started = time.perf_counter()
if controlled:
time.sleep(self.args.lock_ms / 1000)
group = [job.result(timeout=10) for job in jobs]
elapsed = time.perf_counter() - started
after = self.snapshot()
errors = sum(not row['correct'] for row in group)
durations = [row['duration_ms'] for row in group]
measured = dict(phase=phase, mode=mode, repetition=repetition, requests=len(group), errors=errors,
elapsed_ms=round(elapsed*1000, 3), successful_rps=round((len(group)-errors)/elapsed, 3),
latency_ms={f'p{p}': percentile(durations, p/100) for p in (50,95,99)},
sql_before=before, sql_after=after, **self.delta(before, after))
self.requests.extend(group)
self.runs.append(measured)
self.collect_logs(since, f'{phase}/{mode}/{repetition}')
print(f'{phase}/{mode}/{repetition}: chat SQL={measured["chat_sql"]}, session SQL={measured["session_sql"]}, p95={measured["latency_ms"]["p95"]} ms, errors={errors}', flush=True)
if errors:
raise RuntimeError('Incorrect responses during burst')
if mode == 'cold' and phase == 'after' and measured['chat_sql'] != 1:
raise RuntimeError('Expected exactly one chat SELECT with singleflight')
if mode in ('warm', 'mixed_warm') and measured['chat_sql'] != 0:
raise RuntimeError('Warm cache unexpectedly queried chats')
if measured['session_sql'] != len(actors):
raise RuntimeError('Session SQL accounting differs from request count; check concurrent traffic')
time.sleep(.3)
def checked(self, name, method, path, actor, body=None, status=200):
result = self.http(method, path, actor, body)
if result['status'] != status:
raise RuntimeError('Functional check failed: ' + name)
self.checks.append(dict(name=name, status=result['status'], duration_ms=result['duration_ms'], request_id=result['request_id']))
return result['data']
def cancellation(self):
self.redis('DEL', self.key)
before, since = self.snapshot(), now()
path = '/api/v1/chats/' + self.chat['id']
with futures.ThreadPoolExecutor(max_workers=1) as pool:
with self.lock():
leader = http.client.HTTPConnection('127.0.0.1', self.port, timeout=5)
try:
leader.request('GET', path, headers={'Authorization': 'Bearer ' + self.alice['token']})
deadline = time.monotonic() + 1
while self.sql("SELECT count(*) FROM pg_stat_activity WHERE pid <> pg_backend_pid() AND wait_event_type='Lock' AND query LIKE 'SELECT c.id%';") == '0':
if time.monotonic() > deadline:
raise RuntimeError('Leader did not reach SQL')
time.sleep(.01)
leader.sock.shutdown(socket.SHUT_RDWR)
finally:
leader.close()
survivor = pool.submit(self.http, 'GET', path, self.alice)
time.sleep(.1)
result = survivor.result(timeout=5)
counters = self.delta(before, self.snapshot())
if result['status'] != 200 or result['data'] != self.chat or counters['chat_sql'] != 1:
raise RuntimeError('Client cancellation broke shared loading')
self.checks.append(dict(name='leader_cancelled_survivor_succeeded', status=result['status'],
request_id=result['request_id'], duration_ms=result['duration_ms'], **counters))
self.collect_logs(since, 'Cancelled initiating client; surviving client received chat')
def functional(self):
self.cancellation()
path = '/api/v1/chats/' + self.chat['id']
self.burst('after', 'mixed_cold', 1, [self.eve, self.alice, self.bob] * 4)
self.burst('after', 'mixed_warm', 1, [self.eve, self.alice, self.bob] * 4)
message = self.checked('message_committed', 'POST', path+'/messages', self.alice,
{'text': 'Synthetic read-after-write evidence'}, status=201)
history = self.checked('read_after_write', 'GET', path+'/messages?limit=100', self.bob)
if message['id'] not in [item['id'] for item in history['items']]:
raise RuntimeError('Committed message missing from following read')
since = now()
api_before = run(NORMAL + ['ps', '-q', 'api'])
self.summary['key_before_restart'] = self.redis('EXISTS', self.key)
try:
run(NORMAL + ['stop', 'redis'])
self.checked('redis_unavailable', 'GET', path, self.alice)
finally:
run(NORMAL + ['start', 'redis'])
deadline = time.monotonic()+30
while self.redis('PING') != 'PONG':
if time.monotonic()>deadline:
raise RuntimeError('Redis recovery timeout')
time.sleep(.3)
self.summary['key_after_restart'] = self.redis('EXISTS', self.key)
self.checked('redis_recovered', 'GET', path, self.bob)
history = self.checked('message_after_restart', 'GET', path+'/messages?limit=100', self.bob)
if message['id'] not in [item['id'] for item in history['items']]:
raise RuntimeError('Message lost after Redis restart')
if api_before != run(NORMAL + ['ps', '-q', 'api']):
raise RuntimeError('API restarted during Redis recovery')
self.collect_logs(since, 'Redis stop/start and read-after-write')
self.burst('after', 'cold', self.args.repetitions+1)
@contextlib.contextmanager
def sample_resources(self, phase):
stop = threading.Event()
containers = [run(NORMAL + ['ps', '-q', name]) for name in ('api','postgres','redis')]
def sample():
while not stop.is_set():
try:
output = run(['docker','stats','--no-stream','--format','{{json .}}'] + containers, timeout=10)
values = [json.loads(line) for line in output.splitlines() if line.strip()]
self.resources.append(dict(phase=phase, timestamp_utc=now(), containers=[
{key: value[key] for key in ('Name','CPUPerc','MemUsage','MemPerc','PIDs')} for value in values]))
except (RuntimeError, subprocess.TimeoutExpired):
self.resources.append(dict(phase=phase, timestamp_utc=now(), error='resource sampling failed'))
stop.wait(.2)
thread = threading.Thread(target=sample, daemon=True)
thread.start()
try:
yield
finally:
stop.set()
thread.join(timeout=12)
def execute(self):
self.use_image(self.args.before_image)
extension_created = False
try:
self.compose('up', '-d', '--no-build', '--force-recreate', 'postgres')
self.wait_postgres()
if not self.had_extension:
self.sql('CREATE EXTENSION pg_stat_statements;')
extension_created = True
run(NORMAL + ['start', 'redis'])
for phase, image in [('before', self.args.before_image), ('after', self.args.after_image)]:
self.use_image(image)
self.compose('up', '-d', '--no-build', '--no-deps', '--force-recreate', 'api')
self.ready()
if phase == 'before':
self.alice, self.bob, self.eve = [self.actor(label) for label in ('alice', 'bob', 'eve')]
self.chat = self.checked('chat_created', 'POST', '/api/v1/chats', self.alice,
{'title':'Stampede experiment', 'member_ids':[self.alice['id'],self.bob['id']]}, status=201)
self.key = 'chat:' + self.chat['id']
self.summary['chat_id'] = self.chat['id']
observed = self.checked(phase+'_chat_read_after_create', 'GET', '/api/v1/chats/'+self.chat['id'], self.bob)
if observed != self.chat:
raise RuntimeError('Chat read-after-create differs')
self.summary.setdefault('container_limits', {})[phase] = json.loads(run(['docker','inspect','--format',
'{"memory_bytes":{{.HostConfig.Memory}},"nano_cpus":{{.HostConfig.NanoCpus}},"cpu_quota":{{.HostConfig.CpuQuota}}}',
run(NORMAL+['ps','-q','api'])]))
with self.sample_resources(phase):
for repetition in range(1, self.args.repetitions+1):
self.burst(phase, 'cold', repetition)
for repetition in range(1, 6):
self.burst(phase, 'warm', repetition)
if not any(r['chat_sql'] > 1 for r in self.runs if r['phase']=='before' and r['mode']=='cold'):
raise RuntimeError('Baseline stampede not reproduced')
self.functional()
self.summary['success'] = True
finally:
if extension_created:
self.sql('DROP EXTENSION pg_stat_statements;')
# Restore the original Compose command and fixed normal API image.
run(NORMAL + ['up','-d','--no-build','--force-recreate','postgres'])
self.wait_postgres()
run(NORMAL + ['start','redis'])
run(NORMAL + ['up','-d','--no-build','--no-deps','--force-recreate','api'])
self.ready()
self.summary['restored_preload'] = self.sql('SHOW shared_preload_libraries;')
self.summary['extension_restored'] = (self.sql("SELECT count(*) FROM pg_extension WHERE extname='pg_stat_statements';") == ('1' if self.had_extension else '0'))
self.logs.append('\n# Final Compose state\n'+run(NORMAL+['ps','-a'])+'\n')
self.summary['ended_utc'] = now()
self.flush()
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--before-image', default='mtusi-messenger:stampede-before')
parser.add_argument('--after-image', default='mtusi-messenger:stampede-after')
parser.add_argument('--concurrency', type=int, default=32)
parser.add_argument('--repetitions', type=int, default=10)
parser.add_argument('--lock-ms', type=int, default=200)
parser.add_argument('--output', default='evidence/cache-stampede')
args = parser.parse_args()
if not (2 <= args.concurrency <= 64 and 1 <= args.repetitions <= 50 and 50 <= args.lock_ms <= 500):
parser.error('Use concurrency 2..64, repetitions 1..50, lock-ms 50..500')
with tempfile.TemporaryDirectory(prefix='cache-stampede-') as directory:
Experiment(args, pathlib.Path(directory)/'compose.json').execute()
print('Experiment complete; normal Compose restored.', flush=True)
if __name__ == '__main__':
main()
+22
View File
@@ -0,0 +1,22 @@
#!/bin/sh
set -eu
project_root=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
cd "$project_root"
# Keys and environment must already exist; never rotate keys during restart.
compose() {
if [ -n "${COMPOSE_OVERRIDE_FILE:-}" ]; then
docker compose --env-file "${COMPOSE_ENV_FILE:-.env}" -f docker-compose.yml -f "$COMPOSE_OVERRIDE_FILE" "$@"
else
docker compose --env-file "${COMPOSE_ENV_FILE:-.env}" -f docker-compose.yml "$@"
fi
}
# Validate and build before stopping the API. Recreate containers to apply
# current Compose settings, preserve named volumes, and wait for healthchecks.
compose config --quiet
compose build api
compose stop api
compose up -d --force-recreate --wait --wait-timeout 120 postgres redis
compose up -d --no-build --pull never --force-recreate --wait --wait-timeout 60 api
+557
View File
@@ -0,0 +1,557 @@
#!/usr/bin/env python3
"""Verify lab2 levels 3/4 on an isolated Compose project; retain its volumes.
Uses Python stdlib, Docker Compose and OpenSSL. Existing public tests are run
unchanged. Credentials stay in ignored secrets/; evidence contains no tokens.
"""
import argparse
import base64
import concurrent.futures as futures
import contextlib
import csv
import datetime as dt
import hashlib
import http.client
import json
import os
from pathlib import Path
import platform
import re
import secrets
import select
import socket
import subprocess
import threading
import time
import uuid
from urllib.parse import quote
ROOT = Path(__file__).resolve().parents[1]
def utc():
return dt.datetime.now(dt.timezone.utc).isoformat().replace('+00:00', 'Z')
def require(condition, message):
if not condition:
raise RuntimeError(message)
class Verification:
def __init__(self, port, output):
self.port = port
with socket.socket() as probe:
probe.bind(('127.0.0.1', port))
self.run_id = dt.datetime.now(dt.timezone.utc).strftime('%Y%m%dT%H%M%SZ') + '-' + uuid.uuid4().hex[:6]
self.project = 'lab2-verify-' + self.run_id.lower()
self.private = ROOT / 'secrets' / 'levels-3-4' / self.run_id
self.private.mkdir(parents=True, mode=0o700)
self.out = ROOT / output
self.out.mkdir(parents=True, exist_ok=True)
self.envfile, self.override = self.private / '.env', self.private / 'compose.json'
self.env = {k: v for k, v in os.environ.items() if not k.startswith(
('COMPOSE_', 'POSTGRES_', 'REDIS_', 'JWT_', 'SESSION_', 'APP_', 'APPLICATION_')) and k != 'HOST_PORT'}
self.env.update(COMPOSE_PROJECT_NAME=self.project, COMPOSE_ENV_FILE=str(self.envfile), COMPOSE_OVERRIDE_FILE=str(self.override))
self.cmd = ['docker', 'compose', '--project-name', self.project, '--env-file', str(self.envfile),
'-f', str(ROOT / 'docker-compose.yml'), '-f', str(self.override)]
self.image = 'mtusi-messenger:' + self.project
self.passwords = [secrets.token_urlsafe(32), secrets.token_urlsafe(32)]
self.tokens = []
self.http_rows, self.checks, self.transcript = [], [], []
self.summary = dict(run_id=self.run_id, started_utc=utc(), project=self.project,
port=port, commit=self.run(['git','rev-parse','HEAD']), dirty=True,
checks=self.checks, scope='isolated Compose; original stack is not restarted')
self.api_env = {'SESSION_TTL_SECONDS': '3600'}
self.started = False
def safe(self, text):
for value in self.passwords + self.tokens:
text = text.replace(value, '<redacted>')
return re.sub(r'eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+', '<redacted-jwt>', text)
def run(self, args, data=None, timeout=180, record=None):
result = subprocess.run(args, input=data, capture_output=True, text=True, cwd=ROOT, env=self.env, timeout=timeout)
if record:
self.transcript.append(f'\n$ {record}\n' + self.safe(result.stdout + result.stderr) + f'\nexit_code={result.returncode}\n')
self.flush()
require(result.returncode == 0, 'Command failed: ' + (record or ' '.join(args[:3])))
return result.stdout.strip()
def compose(self, *args, record=None):
return self.run(self.cmd + list(args), record=record)
def sql(self, statement):
return self.compose_sql(statement)
def compose_sql(self, statement):
return self.run(self.cmd + ['exec','-T','postgres','sh','-c',
'exec psql -X -q -At -v ON_ERROR_STOP=1 -U "$POSTGRES_USER" -d "$POSTGRES_DB"'], data=statement)
def redis(self, *args):
return self.run(self.cmd + ['exec','-T','redis','sh','-c',
'REDISCLI_AUTH="$REDIS_PASSWORD" exec redis-cli --no-auth-warning -n 0 "$@"', 'redis-cli'] + list(args))
def flush(self):
(self.out/'summary.json').write_text(json.dumps(self.summary, ensure_ascii=False, indent=2)+'\n')
(self.out/'checks.txt').write_text(''.join(self.transcript))
if self.http_rows:
with (self.out/'http.csv').open('w', newline='') as stream:
writer = csv.DictWriter(stream, fieldnames=list(self.http_rows[0]), lineterminator="\n")
writer.writeheader()
writer.writerows(self.http_rows)
def check(self, name, function):
started = time.monotonic()
try:
details = function() or {}
except Exception as error:
self.checks.append(dict(name=name, status='FAIL', duration_seconds=round(time.monotonic()-started,3), reason=self.safe(str(error))))
self.flush()
raise
self.checks.append(dict(name=name, status='PASS', duration_seconds=round(time.monotonic()-started,3), details=details))
self.flush()
print('PASS: ' + name, flush=True)
def call(self, method, path, expected=200, actor=None, body=None, basic=None, headers=None, record=True, raw=None):
conn = http.client.HTTPConnection('127.0.0.1', self.port, timeout=5)
h = dict(headers or {})
if actor:
h['Authorization'] = 'Bearer ' + actor['token']
if basic:
h['Authorization'] = 'Basic ' + base64.b64encode(basic.encode()).decode()
if body is not None:
h['Content-Type'] = 'application/json'
started, stamp = time.monotonic(), utc()
try:
conn.request(method,path,body=raw if raw is not None else (None if body is None else json.dumps(body)),headers=h)
response = conn.getresponse()
raw = response.read()
data = json.loads(raw) if raw else None
elapsed = round((time.monotonic()-started)*1000,3)
rid = response.getheader('X-Request-Id','')
if record:
self.http_rows.append(dict(timestamp_utc=stamp, method=method, path=path, status=response.status,
duration_ms=elapsed, request_id=rid))
if expected is not None:
allowed = [expected] if isinstance(expected,int) else expected
require(response.status in allowed, f'{method} {path}: expected {allowed}, received {response.status}')
require(bool(rid),'missing request ID')
if response.status >= 400:
require(data['error']['request_id']==rid,'error request ID mismatch')
require(not any(v in json.dumps(data) for v in self.passwords+self.tokens),'credential leak in error')
if response.status==401:
scheme='Basic' if path=='/api/v1/auth/sessions' else 'Bearer'
require(response.getheader('WWW-Authenticate','').startswith(scheme),'missing auth challenge')
return dict(status=response.status, data=data, duration_ms=elapsed, request_id=rid)
finally:
conn.close()
def wait_ready(self):
deadline=time.monotonic()+45
while time.monotonic()<deadline:
try:
if self.call('GET','/health/ready',expected=None,record=False)['status']==200:
return
except (OSError,http.client.HTTPException):
pass
time.sleep(.25)
raise RuntimeError('API readiness timeout')
def wait_db(self):
deadline=time.monotonic()+45
while time.monotonic()<deadline:
try:
if self.sql('SELECT 1;')=='1':
return
except RuntimeError:
pass
time.sleep(.25)
raise RuntimeError('PostgreSQL readiness timeout')
def write_override(self):
self.override.write_text(json.dumps({'services':{'api':{
'container_name':self.project+'-api', 'image':self.image,
'environment':self.api_env,
'volumes':[{'type':'bind','source':str(self.private/'certs'),'target':'/run/certs','read_only':True}]}}}))
def recreate_api(self):
self.write_override()
self.compose('up','-d','--no-build','--no-deps','--force-recreate','api')
self.wait_ready()
def prepare(self):
certs=self.private/'certs'
certs.mkdir(mode=0o700)
self.run(['openssl','genrsa','-out',str(certs/'private_key.pem'),'2048'])
self.run(['openssl','rsa','-in',str(certs/'private_key.pem'),'-pubout','-out',str(certs/'public_key.pem')])
(certs/'private_key.pem').chmod(0o600)
(certs/'public_key.pem').chmod(0o644)
if platform.system()=='Linux':
self.run(['setfacl','-m','u:65532:rx',str(certs)])
self.run(['setfacl','-m','u:65532:r',str(certs/'private_key.pem'),str(certs/'public_key.pem')])
content=(ROOT/'.env.example').read_text()
values={'HOST_PORT':str(self.port),'POSTGRES_USER':'acceptance','POSTGRES_DATABASE':'acceptance',
'POSTGRES_PASSWORD':self.passwords[0],'REDIS_PASSWORD':self.passwords[1],
'POSTGRES_RUN_MIGRATIONS':'true','POSTGRES_MAX_CONNECTIONS':'10','SESSION_TTL_SECONDS':'3600',
'POSTGRES_CONNECT_TIMEOUT':'500ms','POSTGRES_QUERY_TIMEOUT':'2s'}
for key,value in values.items():
content=re.sub(r'^'+key+r'=.*$',key+'='+value,content,flags=re.MULTILINE)
fd=os.open(self.envfile,os.O_CREAT|os.O_EXCL|os.O_WRONLY,0o600)
with os.fdopen(fd,'w') as stream:
stream.write(content)
self.write_override()
self.summary['docker']=self.run(['docker','version','--format','{{.Server.Version}}'])
self.summary['resources']=self.run(['docker','info','--format','{{.OSType}}/{{.Architecture}} CPUs={{.NCPU}} memory_bytes={{.MemTotal}}'])
self.compose('config','--quiet',record='docker compose [isolated project] config --quiet')
self.compose('build','api',record='docker compose [isolated project] build api')
self.summary['image']=self.run(['docker','image','inspect','--format','{{.Id}}',self.image])
source_files=sorted((ROOT/'service').rglob('*.go'))+sorted((ROOT/'service/migrations').glob('*.sql'))
digest=hashlib.sha256()
for p in source_files:
digest.update(str(p.relative_to(ROOT)).encode()+b'\0'+p.read_bytes())
self.summary['service_source_sha256']=digest.hexdigest()
self.started=True
self.compose('up','-d','--no-build','--wait','--wait-timeout','120',record='docker compose [isolated project] up -d --no-build --wait --wait-timeout 120')
self.wait_ready()
return {'new_project':self.project,'initial_volumes':self.volumes()}
def ids(self):
return {name:self.compose('ps','-q',name) for name in ('api','postgres','redis')}
def volumes(self):
return self.run(['docker','volume','ls','--filter','label=com.docker.compose.project='+self.project,'--format','{{.Name}}']).splitlines()
def public_checks(self):
self.run(['make','check'],record='make check')
self.run(['make','test','BASE_URL=http://127.0.0.1:'+str(self.port)],record='make test BASE_URL=http://127.0.0.1:'+str(self.port))
return {'check_exit':0,'smoke_exit':0,'covers':['wrong password','Basic rejected on private API','X-User-Id rejected/ignored','logout and revoked token','chat access and pagination']}
def actor(self,label):
username='verify_'+uuid.uuid4().hex[:16]
password=secrets.token_urlsafe(24)
user=self.call('POST','/api/v1/users',201,body=dict(username=username,display_name='Verify '+label,password=password))['data']
session=self.call('POST','/api/v1/auth/sessions',201,basic=username+':'+password)['data']
self.tokens.append(session['token'])
return dict(label=label,id=user['id'],token=session['token'],username=username,password=password,expires_at=session['expires_at'])
def schema(self):
names=self.sql("SELECT string_agg(tablename, ',' ORDER BY tablename) FROM pg_tables WHERE schemaname='public';")
require(set(names.split(','))=={'users','chats','chat_members','messages','refresh_tokens','versions'},'unexpected schema tables')
version=self.sql('SELECT version FROM versions;')
require(version=='5','migration version not 5')
constraints=self.sql("SELECT conrelid::regclass::text || '|' || conname || '|' || contype::text || '|' || pg_get_constraintdef(oid) FROM pg_constraint WHERE connamespace='public'::regnamespace ORDER BY 1;")
(self.out/'schema.txt').write_text('tables='+names+'\nversion='+version+'\n'+constraints+'\n')
require('users_username_unique|u|' in constraints,'username uniqueness missing')
require(len([line for line in constraints.splitlines() if '|f|' in line])==4,'expected four FK constraints')
self.alice,self.bob,self.eve=[self.actor(label) for label in ('alice','bob','eve')]
self.chat=self.call('POST','/api/v1/chats',201,actor=self.alice,
body={'title':'Verification chat','member_ids':[self.alice['id'],self.bob['id']]})['data']
self.path='/api/v1/chats/'+self.chat['id']
self.key='chat:'+self.chat['id']
self.call('POST',self.path+'/messages',201,actor=self.alice,body={'text':'Persistent verification message'})
algorithm=self.sql(f"SELECT split_part(password_hash,'$',2) FROM users WHERE id='{self.alice['id']}';")
profile=self.sql(f"SELECT split_part(password_hash,'$',4) FROM users WHERE id='{self.alice['id']}';")
require(algorithm=='argon2id' and profile=='m=65536,t=3,p=4','unexpected password KDF')
# Do not export claims or nonce values; verify the entropy source's output size.
payload=json.loads(base64.urlsafe_b64decode(self.alice['token'].split('.')[1]+'=='))
nonce=base64.urlsafe_b64decode(payload['nonce']+'==')
require(len(nonce)==32,'expected 32 random nonce bytes')
return dict(version=int(version),fk_count=4,password_kdf=algorithm,password_profile=profile,nonce_bytes=len(nonce))
def counts(self):
return json.loads(self.sql("SELECT json_build_object('users',(SELECT count(*) FROM users),'chats',(SELECT count(*) FROM chats),'members',(SELECT count(*) FROM chat_members),'messages',(SELECT count(*) FROM messages),'sessions',(SELECT count(*) FROM refresh_tokens),'version',(SELECT version FROM versions));"))
def migration_repeat(self):
before=self.counts()
self.recreate_api()
after=self.counts()
require(before==after,'re-running migrations changed counts or version')
return dict(before=before,after=after)
def persistence(self):
before,volumes=self.ids(),self.volumes()
self.run(['make','test-persistence','ACTION_SCRIPT=scripts/restart.sh',
'BASE_URL=http://127.0.0.1:'+str(self.port)],record='make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:'+str(self.port))
after=self.ids()
require(all(before[n]!=after[n] for n in before),'a dependency was not recreated')
require(volumes==self.volumes(),'volumes changed during restart')
me=self.call('GET','/api/v1/users/me',actor=self.alice)['data']
require(me['id']==self.alice['id'],'own previous session lost')
history=self.call('GET',self.path+'/messages?limit=100',actor=self.bob)['data']
require(any(x['text']=='Persistent verification message' for x in history['items']),'own message lost')
return dict(before=before,after=after,volumes_preserved=volumes,previous_session_valid=True)
def registration_race(self):
username='race_'+uuid.uuid4().hex[:16]
barrier=threading.Barrier(8)
body={'username':username,'display_name':'Concurrent registration','password':secrets.token_urlsafe(24)}
def worker(_):
barrier.wait(timeout=10)
return self.call('POST','/api/v1/users',expected=[201,409],body=body)['status']
with futures.ThreadPoolExecutor(max_workers=8) as pool:
statuses=list(pool.map(worker,range(8)))
count=int(self.sql(f"SELECT count(*) FROM users WHERE username='{username}';"))
require(statuses.count(201)==1 and statuses.count(409)==7 and count==1,'registration race mismatch')
return dict(concurrency=8,created=1,conflicts=7,rows=count)
def rollback(self):
title='rollback_'+uuid.uuid4().hex
before=self.counts()
self.call('POST','/api/v1/chats',400,actor=self.alice,
body={'title':title,'member_ids':[self.alice['id'],str(uuid.uuid4())]})
after=self.counts()
require(before==after,'partial chat or member data survived rollback')
require(self.sql(f"SELECT count(*) FROM chats WHERE title='{title}';")=='0','partial chat persisted')
return dict(before=before,after=after,failed_step='member INSERT FK after chat INSERT',http_status=400)
def history(self):
chat=self.chat['id']; user=self.alice['id']
self.sql(f"INSERT INTO messages(id,chat_id,sender_id,text,created_at) SELECT gen_random_uuid(),'{chat}','{user}','History fixture '||i, '2020-01-01'::timestamptz+i*interval '1 microsecond' FROM generate_series(1,20000) i; ANALYZE messages;")
require(self.sql(f"SELECT count(*) FROM messages WHERE chat_id='{chat}';")=='20001','history fixture size mismatch')
cursor=self.sql(f"SELECT created_at::text || '|' || id::text FROM messages WHERE chat_id='{chat}' ORDER BY created_at,id OFFSET 10000 LIMIT 1;").split('|')
plans={}
for label,condition in [('first',''),('deep',f" AND (created_at,id)>('{cursor[0]}'::timestamptz,'{cursor[1]}'::uuid)")]:
query=f"SELECT id,chat_id,sender_id,text,created_at FROM messages WHERE chat_id='{chat}'{condition} ORDER BY created_at,id LIMIT 101"
plan=json.loads(self.sql('EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) '+query+';'))
(self.out/('explain-'+label+'.json')).write_text(json.dumps(plan,indent=2)+'\n')
(self.out/('explain-'+label+'.txt')).write_text(self.sql('EXPLAIN (ANALYZE, BUFFERS) '+query+';')+'\n')
nodes=[]
def walk(node):
nodes.append(node)
for child in node.get('Plans',[]): walk(child)
walk(plan[0]['Plan'])
require(any(n.get('Index Name')=='idx_messages_chat_id_created_at_id' for n in nodes),'history index not selected')
require(not any(n.get('Node Type')=='Seq Scan' and n.get('Relation Name')=='messages' for n in nodes),'history full scan')
plans[label]=dict(execution_ms=plan[0]['Execution Time'],returned=plan[0]['Plan']['Actual Rows'],nodes=[n['Node Type'] for n in nodes])
expected=self.sql(f"SELECT string_agg(id::text,',' ORDER BY created_at,id) FROM messages WHERE chat_id='{chat}';").split(',')
ids=[]; path=self.path+'/messages?limit=100'
for _ in range(205):
page=self.call('GET',path,actor=self.bob)['data']
ids.extend(x['id'] for x in page['items'])
if page['next_cursor'] is None: break
path=self.path+'/messages?limit=100&cursor='+quote(page['next_cursor'],safe='')
require(ids==expected and len(set(ids))==20001,'history traversal lost, duplicated or reordered rows')
return dict(messages=len(ids),page_size=100,plans=plans)
def expiry(self):
self.api_env['SESSION_TTL_SECONDS']='2'
self.recreate_api()
try:
actor=self.actor('expiry')
self.call('GET','/api/v1/users/me',actor=actor)
expires=dt.datetime.fromisoformat(actor['expires_at'].replace('Z','+00:00'))
wait=max(0,(expires-dt.datetime.now(dt.timezone.utc)).total_seconds())+.25
time.sleep(wait)
self.call('GET','/api/v1/users/me',401,actor=actor)
return dict(session_ttl_seconds=2,legacy_jwt_refresh='24h',before=200,after=401,wait_seconds=round(wait,3))
finally:
self.api_env['SESSION_TTL_SECONDS']='3600'
self.recreate_api()
def redis_failure(self):
since=utc()
self.redis('DEL',self.key)
self.call('GET',self.path,actor=self.alice)
self.call('GET',self.path,actor=self.alice)
self.call('GET',self.path,404,actor=self.eve)
raw=self.compose('logs','--no-color','--since',since,'api')
require(raw.count('chat_db_lookup')==1 and 'chat_cache_hit' in raw,'cache miss/hit behavior mismatch')
try:
self.compose('stop','redis')
response=self.call('GET',self.path,actor=self.alice)
require(response['duration_ms']<1000,'Redis failure delayed request >=1s')
self.call('GET',self.path,401)
self.recreate_api()
self.call('GET',self.path,actor=self.alice)
finally:
self.compose('start','redis')
deadline=time.monotonic()+30
while True:
try:
if self.redis('PING')=='PONG': break
except RuntimeError: pass
require(time.monotonic()<deadline,'Redis recovery timed out')
time.sleep(.2)
self.redis('DEL',self.key)
self.call('GET',self.path,actor=self.bob)
self.call('GET',self.path,actor=self.bob)
return dict(cold_sql=1,warm_cache=True,outsider_status=404,outage_ms=response['duration_ms'],startup_without_redis=True,recovered=True)
def postgres_failure(self):
self.call('GET',self.path,actor=self.alice)
try:
self.compose('stop','postgres')
response=self.call('GET',self.path,503,actor=self.alice)
require(response['data']['error']['code']=='unavailable','wrong database outage error code')
require(response['duration_ms']<3000,'PostgreSQL failure exceeded bounded response')
self.call('GET',self.path,401)
self.call('GET',self.path,401,headers={'Authorization':'Bearer invalid-token'})
readiness=self.call('GET','/health/ready',503)
self.call('GET','/health/live',200)
finally:
self.compose('start','postgres')
self.wait_db()
self.wait_ready()
self.call('GET',self.path,actor=self.alice)
return dict(valid_session_status=503,anonymous_status=401,invalid_token_status=401,ready=503,live=200,
outage_ms=response['duration_ms'],readiness_ms=readiness['duration_ms'],previous_session_recovered=True)
@contextlib.contextmanager
def table_lock(self):
proc=subprocess.Popen(self.cmd+['exec','-T','postgres','sh','-c',
'exec psql -X -q -At -v ON_ERROR_STOP=1 -U "$POSTGRES_USER" -d "$POSTGRES_DB"'],
stdin=subprocess.PIPE,stdout=subprocess.PIPE,stderr=subprocess.PIPE,text=True,cwd=ROOT,env=self.env)
try:
proc.stdin.write("SET statement_timeout='5s'; SET idle_in_transaction_session_timeout='5s'; BEGIN; LOCK TABLE chats IN ACCESS EXCLUSIVE MODE;\n\\echo LOCKED\n")
proc.stdin.flush()
require(bool(select.select([proc.stdout],[],[],8)[0]) and proc.stdout.readline().strip()=='LOCKED','could not acquire table lock')
yield
finally:
if proc.poll() is None:
try: proc.communicate('ROLLBACK;\n\\q\n',timeout=8)
except (subprocess.TimeoutExpired,BrokenPipeError):
proc.kill(); proc.communicate()
def pool_and_deadline(self):
self.api_env['POSTGRES_MAX_CONNECTIONS']='2'
self.recreate_api()
self.redis('DEL',self.key)
peak=0
with self.table_lock():
with futures.ThreadPoolExecutor(max_workers=8) as pool:
barrier=threading.Barrier(8)
def worker(_):
barrier.wait(timeout=10)
return self.call('GET',self.path,503,actor=self.alice)
jobs=[pool.submit(worker,i) for i in range(8)]
while not all(job.done() for job in jobs):
count=int(self.sql("SELECT count(*) FROM pg_stat_activity WHERE application_name='mtusi-api';"))
peak=max(peak,count)
time.sleep(.05)
results=[job.result() for job in jobs]
require(peak==2,'pool maximum not applied/observed')
require(all(1500<r['duration_ms']<3000 for r in results),'request budget not enforced')
self.api_env['POSTGRES_MAX_CONNECTIONS']='10'
self.recreate_api()
self.call('GET',self.path,actor=self.alice)
raw=self.compose('logs','--no-color','api')
require('max_conns=10' in raw and 'statement_timeout_ms=2000' in raw and 'connect_timeout=500ms' in raw,'pool startup configuration missing')
return dict(test_limit=2,observed_peak=peak,requests=8,status=503,durations_ms=[r['duration_ms'] for r in results],
restored_limit=10,query_timeout_ms=2000,connect_timeout_ms=500)
def configuration(self):
observed={}
try:
for label,session,legacy,expected in [('default','','',3600),('legacy','','24h',86400),('primary','2','invalid-legacy',2)]:
self.api_env.update(SESSION_TTL_SECONDS=session,JWT_REFRESH_TOKEN_LIFETIME=legacy)
self.recreate_api()
result=self.call('POST','/api/v1/auth/sessions',201,basic=self.alice['username']+':'+self.alice['password'])['data']
self.tokens.append(result['token'])
claims=json.loads(base64.urlsafe_b64decode(result['token'].split('.')[1]+'=='))
require(claims['exp']-claims['iat']==expected,'session lifetime precedence mismatch')
observed[label]=expected
invalid=[('SESSION_TTL_SECONDS','0'),('SESSION_TTL_SECONDS','abc'),
('POSTGRES_MAX_CONNECTIONS','0'),('POSTGRES_CONNECT_TIMEOUT','0s'),('POSTGRES_QUERY_TIMEOUT','0s')]
self.api_env={'SESSION_TTL_SECONDS':'3600'}
self.write_override()
for name,value in invalid:
proc=subprocess.run(self.cmd+['run','--rm','--no-deps','-e',name+'='+value,'api'],capture_output=True,text=True,cwd=ROOT,env=self.env,timeout=15)
require(proc.returncode!=0 and 'load server config' in proc.stderr,'invalid config was not rejected')
return dict(lifetime_seconds=observed,invalid_configurations_rejected=len(invalid))
finally:
self.api_env={'SESSION_TTL_SECONDS':'3600'}
self.recreate_api()
def contract_edges(self):
before=len(self.http_rows)
self.call('GET','/api/v1/chats/not-a-uuid',400,actor=self.alice)
self.call('GET','/api/v1/chats?limit=101',400,actor=self.alice)
self.call('GET',self.path+'/messages?cursor=invalid',400,actor=self.alice)
self.call('GET',self.path+'/messages?limit=1&limit=2',400,actor=self.alice)
for members,title in [([self.alice['id']],' '),([self.bob['id']],'No creator'),([self.alice['id']]*2,'Duplicates')]:
self.call('POST','/api/v1/chats',400,actor=self.alice,body={'title':title,'member_ids':members})
self.call('POST',self.path+'/messages',400,actor=self.alice,body={'text':'Spoofed','sender_id':self.bob['id']})
for fields in [dict(username='UPPER',display_name='Valid',password='Valid-password-123'),
dict(username='valid_name',display_name=' ',password='Valid-password-123'),
dict(username='valid_name',display_name='Valid',password='short'),
dict(username='valid_name',display_name='Valid',password='Valid-password-123',extra=True)]:
self.call('POST','/api/v1/users',400,body=fields)
self.call('POST','/api/v1/users',400,headers={'Content-Type':'application/json'},raw='{')
self.call('POST','/api/v1/users',415,headers={'Content-Type':'text/plain'},raw='{}')
return dict(cases=len(self.http_rows)-before,invalid_uuid_status=400,unknown_fields_status=400,malformed_json_status=400,unsupported_media_status=415)
def auth_additional(self):
# Explicit checks beyond the public smoke: forged signatures and unknown user.
bad=self.alice['token'][:-8]+('A' if self.alice['token'][-8]!='A' else 'B')+self.alice['token'][-7:]
self.call('GET','/api/v1/users/me',401,headers={'Authorization':'Bearer '+bad})
self.call('POST','/api/v1/auth/sessions',401,basic='unknown_'+uuid.uuid4().hex+':wrong-password')
return dict(forged_signature=401,unknown_username=401)
def audit(self):
tracked=self.run(['git','ls-files','-z']).split('\0')
dangerous=[name for name in tracked if name and (name=='.env' or name.startswith(('certs/','secrets/','volumes/')) or name.endswith(('.pem','.key','.p12','.pfx')))]
require(not dangerous,'private state tracked in Git')
self.run(['git','diff','--exit-code','upstream/master','--','README.md','contracts','tests'])
findings=[]
for name in tracked:
path=ROOT/name
if not name or not path.is_file(): continue
try: content=path.read_text()
except (UnicodeError,OSError): continue
if re.search(r'-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----|eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+',content):
findings.append(name)
require(not findings,'credential-like material tracked: '+', '.join(findings))
return dict(private_paths_tracked=0,jwt_or_private_key_findings=0,readme_contract_tests_unchanged=True,
scope='current tracked tree; complete Git history is not certified')
def finish(self):
if not self.started: return
# Restore temporary API overrides, ensure dependencies recover, then stop only our project.
self.api_env={'SESSION_TTL_SECONDS':'3600'}
self.write_override()
self.compose('start','postgres','redis')
self.wait_db()
self.recreate_api()
self.compose('up','-d','--no-build','--wait','--wait-timeout','60')
self.transcript.append('\nFinal isolated state before shutdown:\n'+self.compose('ps','-a')+'\n')
raw=self.compose('logs','--no-color','--timestamps','api')
selected=[line for line in raw.splitlines() if any(marker in line for marker in
('postgres_pool_config','HTTP server started','redis unavailable at startup'))]
(self.out/'startup.txt').write_text(self.safe('\n'.join(selected))+'\n')
volumes=self.volumes()
self.compose('down')
require(volumes==self.volumes(),'cleanup deleted volumes')
self.summary['retained_volumes']=volumes
self.summary['isolated_stack_stopped']=True
self.summary['ended_utc']=utc()
self.flush()
def execute(self):
try:
for name,action in [('fresh_build_and_start',self.prepare),('public_check_and_smoke',self.public_checks),
('schema_kdf_and_session_randomness',self.schema),('configuration_compatibility',self.configuration),
('contract_validation_edges',self.contract_edges),('repeat_migrations',self.migration_repeat),
('full_persistence',self.persistence),('username_registration_race',self.registration_race),
('chat_creation_rollback',self.rollback),('history_20000_and_explain',self.history),
('session_expiry_seconds',self.expiry),('additional_authentication',self.auth_additional),
('redis_cache_and_failure',self.redis_failure),('postgres_failure_and_recovery',self.postgres_failure),
('pool_limit_and_sql_deadline',self.pool_and_deadline),('tracked_secrets_and_contract_audit',self.audit)]:
self.check(name,action)
self.summary['success']=True
finally:
self.finish()
self.flush()
def main():
parser=argparse.ArgumentParser(description=__doc__)
parser.add_argument('--port',type=int,default=18084)
parser.add_argument('--output',default='evidence/levels-3-4')
args=parser.parse_args()
Verification(args.port,args.output).execute()
print('PASS: levels 3/4 verification finished; isolated volumes retained; original stack unchanged.',flush=True)
if __name__=='__main__':
main()
+111
View File
@@ -0,0 +1,111 @@
package main
import (
"context"
"fmt"
"log/slog"
"os"
"os/signal"
"syscall"
"time"
"gitea.privcloud.tech/mtusi2026/internal/adapter/controller/http"
"gitea.privcloud.tech/mtusi2026/internal/adapter/repository/cache/outside"
"gitea.privcloud.tech/mtusi2026/internal/adapter/repository/storage"
"gitea.privcloud.tech/mtusi2026/internal/config"
"gitea.privcloud.tech/mtusi2026/internal/pkg/auth/jwtprovider"
"gitea.privcloud.tech/mtusi2026/internal/pkg/cache"
"gitea.privcloud.tech/mtusi2026/internal/pkg/encrypting"
"gitea.privcloud.tech/mtusi2026/internal/pkg/migrator"
"gitea.privcloud.tech/mtusi2026/internal/pkg/postgres"
"gitea.privcloud.tech/mtusi2026/internal/pkg/postgres/txmanager"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/middleware"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/router"
"gitea.privcloud.tech/mtusi2026/internal/pkg/validator"
"gitea.privcloud.tech/mtusi2026/internal/service/auth"
"gitea.privcloud.tech/mtusi2026/internal/service/chat"
"gitea.privcloud.tech/mtusi2026/internal/service/user"
)
func main() {
time.Local = time.UTC
if err := run(); err != nil {
slog.Error("application stopped", "error", err)
os.Exit(1)
}
}
func run() error {
cfg, err := config.New()
if err != nil {
return fmt.Errorf("load server config: %w", err)
}
pgx := postgres.New(cfg.Postgres)
rx := cache.New(cfg)
postgresMigrator := migrator.New(cfg)
tm := txmanager.New(pgx)
provider := jwtprovider.New(cfg)
encryptor := encrypting.New()
chatsRepo := storage.NewChatsRepo(pgx)
messageRepo := storage.NewMessagesRepo(pgx)
refreshTokensRepo := storage.NewRefreshTokensRepo(pgx)
userRepo := storage.NewUsersRepo(pgx)
chatCache := outside.NewChatCache(rx)
authSvc := auth.New(provider, tm, encryptor, userRepo, refreshTokensRepo)
userSvc := user.New(encryptor, userRepo)
chatSvc := chat.New(tm, chatsRepo, messageRepo, chatCache)
httpRouter := router.New(
middleware.NewAuthMiddleware(authSvc),
middleware.RequestIDMiddleware(),
middleware.LoggingMiddleware(),
middleware.RequestTimeout(cfg.Postgres.QueryTimeout),
)
server := http.New(cfg, httpRouter)
requestValidator := validator.NewValidatorImpl()
registerRoutes(
http.NewAuthHandler(httpRouter, authSvc),
http.NewHealthHandler(httpRouter, server, pgx),
http.NewChatHandler(httpRouter, provider, requestValidator, chatSvc),
http.NewUserHandler(httpRouter, provider, requestValidator, userSvc),
)
ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
defer stop()
if err = postgresMigrator.Start(ctx); err != nil {
return fmt.Errorf("start postgres migrator: %w", err)
}
if err = server.Start(ctx); err != nil {
return fmt.Errorf("start HTTP server: %w", err)
}
if err = rx.Start(ctx); err != nil {
slog.Warn("redis unavailable at startup; continuing without cache", "error", err)
}
slog.Info("HTTP server started", "address", cfg.Server.BindAddress())
<-ctx.Done()
shutdownCtx, cancel := context.WithTimeout(context.Background(), cfg.Server.ShutdownTimeout)
defer cancel()
if err = server.Stop(shutdownCtx); err != nil {
return fmt.Errorf("stop HTTP server: %w", err)
}
if err = postgresMigrator.Close(shutdownCtx); err != nil {
return fmt.Errorf("close postgres migrator: %w", err)
}
if err = rx.Close(); err != nil {
return fmt.Errorf("close redis: %w", err)
}
pgx.Close()
return nil
}
func registerRoutes(handlers ...http.Handler) {
for _, handler := range handlers {
handler.RegisterRoutes()
}
}
+386
View File
@@ -0,0 +1,386 @@
// Command benchmark measures the lab1 HTTP API in fresh, resource-limited containers.
package main
import (
"bytes"
"encoding/json"
"errors"
"flag"
"fmt"
"io"
"math"
"net/http"
"os"
"os/exec"
"path/filepath"
"slices"
"strconv"
"strings"
"sync"
"time"
)
const (
container = "mtusi-inmemory-benchmark"
baseURL = "http://127.0.0.1:18093"
)
type runResult struct {
History int `json:"history"`
Concurrency int `json:"concurrency"`
Repetition int `json:"repetition"`
ElapsedSeconds float64 `json:"elapsed_seconds"`
ReadSuccess int `json:"read_success"`
WriteSuccess int `json:"write_success"`
Errors int `json:"errors"`
SuccessfulRPS float64 `json:"successful_rps"`
LatencyMS map[string]float64 `json:"latency_ms"`
RSSBeforeKiB int `json:"rss_kib_before"`
RSSPeakKiB int `json:"rss_kib_peak"`
}
type report struct {
Image string `json:"image"`
Method map[string]any `json:"method"`
Runs []runResult `json:"runs"`
}
type workerResult struct {
reads int
writes int
errors int
latencies []float64
}
type memoryResult struct {
peak int
err error
}
func docker(args ...string) (string, error) {
command := exec.Command("docker", args...)
output, err := command.CombinedOutput()
if err != nil {
return "", fmt.Errorf("docker %s: %w: %s", strings.Join(args, " "), err, strings.TrimSpace(string(output)))
}
return strings.TrimSpace(string(output)), nil
}
func rssKiB() (int, error) {
status, err := docker("exec", container, "cat", "/proc/1/status")
if err != nil {
return 0, err
}
for line := range strings.SplitSeq(status, "\n") {
if strings.HasPrefix(line, "VmRSS:") {
fields := strings.Fields(line)
return strconv.Atoi(fields[1])
}
}
return 0, errors.New("VmRSS is unavailable")
}
func newClient(timeout time.Duration) *http.Client {
return &http.Client{
Timeout: timeout,
Transport: &http.Transport{
MaxConnsPerHost: 1,
MaxIdleConnsPerHost: 1,
IdleConnTimeout: 30 * time.Second,
},
}
}
func request(client *http.Client, method, path, user string, body any) (map[string]any, error) {
var data io.Reader
if body != nil {
encoded, err := json.Marshal(body)
if err != nil {
return nil, err
}
data = bytes.NewReader(encoded)
}
req, err := http.NewRequest(method, baseURL+path, data)
if err != nil {
return nil, err
}
req.Header.Set("Accept", "application/json")
if user != "" {
req.Header.Set("X-User-Id", user)
}
if body != nil {
req.Header.Set("Content-Type", "application/json")
}
response, err := client.Do(req)
if err != nil {
return nil, err
}
defer response.Body.Close()
content, err := io.ReadAll(io.LimitReader(response.Body, 1<<20))
if err != nil {
return nil, err
}
if response.StatusCode != http.StatusOK && response.StatusCode != http.StatusCreated {
return nil, fmt.Errorf("%s %s: HTTP %d: %s", method, path, response.StatusCode, content)
}
var payload map[string]any
if err := json.Unmarshal(content, &payload); err != nil {
return nil, err
}
return payload, nil
}
func stringField(payload map[string]any, key string) (string, error) {
value, ok := payload[key].(string)
if !ok || value == "" {
return "", fmt.Errorf("missing %s in API response", key)
}
return value, nil
}
func percentile(sorted []float64, proportion float64) float64 {
if len(sorted) == 0 {
return 0
}
index := int(math.Ceil(float64(len(sorted))*proportion)) - 1
if index < 0 {
index = 0
}
return round(sorted[index], 3)
}
func round(value float64, places int) float64 {
shift := math.Pow10(places)
return math.Round(value*shift) / shift
}
func sampleMemory(stop <-chan struct{}, initial int, result chan<- memoryResult) {
ticker := time.NewTicker(250 * time.Millisecond)
defer ticker.Stop()
peak := initial
for {
select {
case <-stop:
result <- memoryResult{peak: peak}
return
case <-ticker.C:
rss, err := rssKiB()
if err != nil {
result <- memoryResult{err: err}
return
}
peak = max(peak, rss)
}
}
}
func runCase(image string, history, concurrency, repetition int, duration time.Duration) (runResult, error) {
row := runResult{History: history, Concurrency: concurrency, Repetition: repetition}
if _, err := docker("run", "-d", "--name", container, "--cpus=1", "--memory=512m",
"-p", "127.0.0.1:18093:8080", image); err != nil {
return row, err
}
defer func() { _, _ = docker("rm", "-f", container) }()
setup := newClient(2 * time.Second)
defer setup.CloseIdleConnections()
readyDeadline := time.Now().Add(20 * time.Second)
for {
if _, err := request(setup, http.MethodGet, "/health/ready", "", nil); err == nil {
break
} else if time.Now().After(readyDeadline) {
return row, fmt.Errorf("server did not become ready: %w", err)
}
time.Sleep(100 * time.Millisecond)
}
userResponse, err := request(setup, http.MethodPost, "/api/v1/users", "", map[string]any{
"username": fmt.Sprintf("bench_%d_%d_%d", time.Now().UnixNano(), history, repetition),
"display_name": "Benchmark",
})
if err != nil {
return row, err
}
user, err := stringField(userResponse, "id")
if err != nil {
return row, err
}
chatResponse, err := request(setup, http.MethodPost, "/api/v1/chats", user, map[string]any{
"title": "Benchmark", "member_ids": []string{user},
})
if err != nil {
return row, err
}
chat, err := stringField(chatResponse, "id")
if err != nil {
return row, err
}
path := "/api/v1/chats/" + chat + "/messages"
for index := range history {
if _, err := request(setup, http.MethodPost, path, user, map[string]string{
"text": fmt.Sprintf("seed-%d", index),
}); err != nil {
return row, fmt.Errorf("seed message %d: %w", index, err)
}
}
row.RSSBeforeKiB, err = rssKiB()
if err != nil {
return row, err
}
start := make(chan struct{})
results := make(chan workerResult, concurrency)
stopSampling := make(chan struct{})
memory := make(chan memoryResult, 1)
go sampleMemory(stopSampling, row.RSSBeforeKiB, memory)
var group sync.WaitGroup
group.Add(concurrency)
deadline := time.Now().Add(duration)
started := time.Now()
for workerID := range concurrency {
go func() {
defer group.Done()
local := newClient(5 * time.Second)
defer local.CloseIdleConnections()
result := workerResult{}
<-start
for index := 0; time.Now().Before(deadline); index++ {
began := time.Now()
var err error
if index%10 == 0 {
_, err = request(local, http.MethodPost, path, user, map[string]string{
"text": fmt.Sprintf("load-%d-%d-%d", repetition, workerID, index),
})
if err == nil {
result.writes++
}
} else {
var page map[string]any
page, err = request(local, http.MethodGet, path+"?limit=50", user, nil)
if err == nil {
items, ok := page["items"].([]any)
if !ok || len(items) != 50 {
err = errors.New("short first page")
} else {
result.reads++
}
}
}
if err != nil {
result.errors++
} else {
result.latencies = append(result.latencies, float64(time.Since(began).Microseconds())/1000)
}
}
results <- result
}()
}
close(start)
group.Wait()
row.ElapsedSeconds = round(time.Since(started).Seconds(), 3)
close(stopSampling)
memorySample := <-memory
if memorySample.err != nil {
return row, memorySample.err
}
row.RSSPeakKiB = memorySample.peak
if finalRSS, err := rssKiB(); err == nil {
row.RSSPeakKiB = max(row.RSSPeakKiB, finalRSS)
} else {
return row, err
}
latencies := make([]float64, 0)
for range concurrency {
result := <-results
row.ReadSuccess += result.reads
row.WriteSuccess += result.writes
row.Errors += result.errors
latencies = append(latencies, result.latencies...)
}
if len(latencies) == 0 {
return row, errors.New("no successful requests")
}
slices.Sort(latencies)
row.SuccessfulRPS = round(float64(len(latencies))/row.ElapsedSeconds, 2)
row.LatencyMS = map[string]float64{
"p95": percentile(latencies, 0.95),
"p99": percentile(latencies, 0.99),
}
return row, nil
}
func parseValues(raw string, minimum int) ([]int, error) {
values := make([]int, 0)
for part := range strings.SplitSeq(raw, ",") {
value, err := strconv.Atoi(strings.TrimSpace(part))
if err != nil || value < minimum {
return nil, fmt.Errorf("invalid value %q", part)
}
values = append(values, value)
}
return values, nil
}
func save(path string, data report) error {
encoded, err := json.MarshalIndent(data, "", " ")
if err != nil {
return err
}
if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
return err
}
return os.WriteFile(path, append(encoded, '\n'), 0o644)
}
func main() {
image := flag.String("image", "", "Docker image to benchmark")
output := flag.String("output", "", "JSON output path")
historiesArg := flag.String("histories", "100,500,1500", "Comma-separated history sizes")
concurrenciesArg := flag.String("concurrencies", "1,4,10", "Comma-separated client counts")
repeats := flag.Int("repeats", 3, "Runs per combination")
duration := flag.Duration("duration", 5*time.Second, "Measured duration per run")
flag.Parse()
if *image == "" || *output == "" || *repeats < 1 || *duration <= 0 {
fmt.Fprintln(os.Stderr, "image, output, positive repeats and duration are required")
os.Exit(2)
}
histories, err := parseValues(*historiesArg, 50)
if err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(2)
}
concurrencies, err := parseValues(*concurrenciesArg, 1)
if err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(2)
}
data := report{
Image: *image,
Method: map[string]any{
"histories": histories, "concurrencies": concurrencies,
"repeats": *repeats, "duration_seconds": duration.Seconds(),
"mix": "90% first-page GET, 10% POST per client; persistent HTTP connections",
"limits": "1 CPU, 512 MiB; fresh container and history per case",
"rss": "VmRSS from /proc/1/status every 250 ms (sampled peak)",
"latency": "successful requests only; errors counted separately; closed-loop workload",
},
Runs: make([]runResult, 0, len(histories)*len(concurrencies)*(*repeats)),
}
for _, history := range histories {
for _, concurrency := range concurrencies {
for repetition := 1; repetition <= *repeats; repetition++ {
row, err := runCase(*image, history, concurrency, repetition, *duration)
if err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(1)
}
data.Runs = append(data.Runs, row)
if err := save(*output, data); err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(1)
}
encoded, _ := json.Marshal(row)
fmt.Println(string(encoded))
}
}
}
}
+57
View File
@@ -0,0 +1,57 @@
module gitea.privcloud.tech/mtusi2026
go 1.27.0
require (
github.com/go-chi/chi/v5 v5.5.0
github.com/go-playground/validator/v10 v10.30.5
github.com/golang-jwt/jwt/v5 v5.3.1
github.com/google/uuid v1.6.0
github.com/jackc/pgerrcode v0.0.0-20250907135507-afb5586c32a6
github.com/jackc/pgx/v5 v5.11.0
github.com/oapi-codegen/runtime v1.4.2
github.com/redis/go-redis/v9 v9.23.0
github.com/spf13/viper v1.21.0
go.uber.org/multierr v1.11.0
golang.org/x/crypto v0.57.0
golang.org/x/sync v0.23.0
google.golang.org/grpc v1.85.0
)
require (
dario.cat/mergo v1.0.2 // indirect
github.com/Masterminds/goutils v1.1.1 // indirect
github.com/Masterminds/semver/v3 v3.5.0 // indirect
github.com/Masterminds/sprig/v3 v3.3.0 // indirect
github.com/Masterminds/squirrel v1.5.4 // indirect
github.com/cespare/xxhash/v2 v2.3.0 // indirect
github.com/fsnotify/fsnotify v1.9.0 // indirect
github.com/gabriel-vasile/mimetype v1.4.15 // indirect
github.com/go-playground/locales v0.14.1 // indirect
github.com/go-playground/universal-translator v0.18.1 // indirect
github.com/go-viper/mapstructure/v2 v2.4.0 // indirect
github.com/huandu/xstrings v1.5.0 // indirect
github.com/jackc/pgpassfile v1.0.0 // indirect
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
github.com/jackc/puddle/v2 v2.2.2 // indirect
github.com/jackc/tern/v2 v2.4.3 // indirect
github.com/lann/builder v0.0.0-20180802200727-47ae307949d0 // indirect
github.com/lann/ps v0.0.0-20150810152359-62de8c46ede0 // indirect
github.com/leodido/go-urn v1.5.0 // indirect
github.com/mcosta74/pgx-slog v0.4.1 // indirect
github.com/mitchellh/copystructure v1.2.0 // indirect
github.com/mitchellh/reflectwalk v1.0.2 // indirect
github.com/pelletier/go-toml/v2 v2.4.3-0.20260624044523-35f78d5908f1 // indirect
github.com/sagikazarmark/locafero v0.11.0 // indirect
github.com/shopspring/decimal v1.4.0 // indirect
github.com/sourcegraph/conc v0.3.1-0.20240121214520-5f936abd7ae8 // indirect
github.com/spf13/afero v1.15.0 // indirect
github.com/spf13/cast v1.10.0 // indirect
github.com/spf13/pflag v1.0.10 // indirect
github.com/subosito/gotenv v1.6.0 // indirect
github.com/vgarvardt/pgx-google-uuid/v5 v5.6.0 // indirect
go.uber.org/atomic v1.12.0 // indirect
go.yaml.in/yaml/v3 v3.0.5 // indirect
golang.org/x/sys v0.48.0 // indirect
golang.org/x/text v0.42.0 // indirect
)
+131
View File
@@ -0,0 +1,131 @@
dario.cat/mergo v1.0.2 h1:85+piFYR1tMbRrLcDwR18y4UKJ3aH1Tbzi24VRW1TK8=
dario.cat/mergo v1.0.2/go.mod h1:E/hbnu0NxMFBjpMIE34DRGLWqDy0g5FuKDhCb31ngxA=
github.com/Masterminds/goutils v1.1.1 h1:5nUrii3FMTL5diU80unEVvNevw1nH4+ZV4DSLVJLSYI=
github.com/Masterminds/goutils v1.1.1/go.mod h1:8cTjp+g8YejhMuvIA5y2vz3BpJxksy863GQaJW2MFNU=
github.com/Masterminds/semver/v3 v3.5.0 h1:kQceYJfbupGfZOKZQg0kou0DgAKhzDg2NZPAwZ/2OOE=
github.com/Masterminds/semver/v3 v3.5.0/go.mod h1:4V+yj/TJE1HU9XfppCwVMZq3I84lprf4nC11bSS5beM=
github.com/Masterminds/sprig/v3 v3.3.0 h1:mQh0Yrg1XPo6vjYXgtf5OtijNAKJRNcTdOOGZe3tPhs=
github.com/Masterminds/sprig/v3 v3.3.0/go.mod h1:Zy1iXRYNqNLUolqCpL4uhk6SHUMAOSCzdgBfDb35Lz0=
github.com/Masterminds/squirrel v1.5.4 h1:uUcX/aBc8O7Fg9kaISIUsHXdKuqehiXAMQTYX8afzqM=
github.com/Masterminds/squirrel v1.5.4/go.mod h1:NNaOrjSoIDfDA40n7sr2tPNZRfjzjA400rg+riTZj10=
github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=
github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k=
github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0=
github.com/gabriel-vasile/mimetype v1.4.15 h1:05iP/CYtZ/w455R/KZM6rZ5ieAdh99UPtd+d3YzLmaI=
github.com/gabriel-vasile/mimetype v1.4.15/go.mod h1:azpTcoLcDZRNgFou5j+APrqQx9HqVPWa6ijYQIIVswQ=
github.com/go-chi/chi/v5 v5.5.0 h1:xdKQ1dJmVJsmgahrXSKhUx8NyVPzpwdlyrrQFpMPJgg=
github.com/go-chi/chi/v5 v5.5.0/go.mod h1:d1IG7GtKPSjPyBP365PH8sAGVHk3qfB/IhjFNRH1wWM=
github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
github.com/go-playground/validator/v10 v10.30.5 h1:YyCXvVShZbs2Sm3Mb53eNOlhRXctSOzW5QJAouCTZL4=
github.com/go-playground/validator/v10 v10.30.5/go.mod h1:wEqiaov48pXX1kjhc3Da8y0M0Dtg/BK7gurFBLgwFrQ=
github.com/go-viper/mapstructure/v2 v2.4.0 h1:EBsztssimR/CONLSZZ04E8qAkxNYq4Qp9LvH92wZUgs=
github.com/go-viper/mapstructure/v2 v2.4.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY=
github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
github.com/huandu/xstrings v1.5.0 h1:2ag3IFq9ZDANvthTwTiqSSZLjDc+BedvHPAp5tJy2TI=
github.com/huandu/xstrings v1.5.0/go.mod h1:y5/lhBue+AyNmUVz9RLU9xbLR0o4KIIExikq4ovT0aE=
github.com/jackc/pgerrcode v0.0.0-20250907135507-afb5586c32a6 h1:D/V0gu4zQ3cL2WKeVNVM4r2gLxGGf6McLwgXzRTo2RQ=
github.com/jackc/pgerrcode v0.0.0-20250907135507-afb5586c32a6/go.mod h1:a/s9Lp5W7n/DD0VrVoyJ00FbP2ytTPDVOivvn2bMlds=
github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
github.com/jackc/pgx/v5 v5.11.0 h1:IzBBtyK9AHqf98cctWFifYSci2hgQR/cd56wB4p+ogg=
github.com/jackc/pgx/v5 v5.11.0/go.mod h1:mal1tBGAFfLHvZzaYh77YS/eC6IX9OWbRV1QIIM0Jn4=
github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo=
github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
github.com/jackc/tern/v2 v2.4.3 h1:g293d3OZgW7OFEhsYXgEv0C21jea2boNr0VR4K5I7OY=
github.com/jackc/tern/v2 v2.4.3/go.mod h1:rMpMuRYcff5wWLptoTSO1qcDxJ4OodysvK17i2SVBys=
github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
github.com/lann/builder v0.0.0-20180802200727-47ae307949d0 h1:SOEGU9fKiNWd/HOJuq6+3iTQz8KNCLtVX6idSoTLdUw=
github.com/lann/builder v0.0.0-20180802200727-47ae307949d0/go.mod h1:dXGbAdH5GtBTC4WfIxhKZfyBF/HBFgRZSWwZ9g/He9o=
github.com/lann/ps v0.0.0-20150810152359-62de8c46ede0 h1:P6pPBnrTSX3DEVR4fDembhRWSsG5rVo6hYhAB/ADZrk=
github.com/lann/ps v0.0.0-20150810152359-62de8c46ede0/go.mod h1:vmVJ0l/dxyfGW6FmdpVm2joNMFikkuWg0EoCKLGUMNw=
github.com/leodido/go-urn v1.5.0 h1:pLqT2kq1zpHW/1D18QMjMpdtX7cekxqtJJjg5ANyWw0=
github.com/leodido/go-urn v1.5.0/go.mod h1:9BORnCDhdPBJNDEX+w1bJisa8yOKYi116VeO96s4ifE=
github.com/mcosta74/pgx-slog v0.4.1 h1:Rt25l/jE5tu1ioqPDrqY17Kv6REdsM0L9WCT+hFw1rw=
github.com/mcosta74/pgx-slog v0.4.1/go.mod h1:BCpubkiENkWQ8MvZ4a9LJgWuBzC5UpWoJmQ1/SOlv+M=
github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw=
github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s=
github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ=
github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw=
github.com/oapi-codegen/runtime v1.4.2 h1:GMxFVYLzoYLua+/KvzgSphkyK1lLTReQI9Vf4hvATKE=
github.com/oapi-codegen/runtime v1.4.2/go.mod h1:GwV7hC2hviaMzj+ITfHVRESK5J2W/GefVwIND/bMGvU=
github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4=
github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
github.com/pelletier/go-toml/v2 v2.4.3-0.20260624044523-35f78d5908f1 h1:gIZQQ2+wbsdQGWLPDSdJFptR25tBCjSC0KbSIQZ1rgE=
github.com/pelletier/go-toml/v2 v2.4.3-0.20260624044523-35f78d5908f1/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
github.com/redis/go-redis/v9 v9.23.0 h1:/TTVdJa8BRNsybwwGGnmiYktHNlUXtbOQxlWpHBPL3s=
github.com/redis/go-redis/v9 v9.23.0/go.mod h1:EWP2UUk+XDaI1s5nQB5mablZN6vccXlmBQTyfnF87D0=
github.com/rogpeppe/go-internal v1.9.0 h1:73kH8U+JUqXU8lRuOHeVHaa/SZPifC7BkcraZVejAe8=
github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs=
github.com/sagikazarmark/locafero v0.11.0 h1:1iurJgmM9G3PA/I+wWYIOw/5SyBtxapeHDcg+AAIFXc=
github.com/sagikazarmark/locafero v0.11.0/go.mod h1:nVIGvgyzw595SUSUE6tvCp3YYTeHs15MvlmU87WwIik=
github.com/shopspring/decimal v1.4.0 h1:bxl37RwXBklmTi0C79JfXCEBD1cqqHt0bbgBAGFp81k=
github.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME=
github.com/sourcegraph/conc v0.3.1-0.20240121214520-5f936abd7ae8 h1:+jumHNA0Wrelhe64i8F6HNlS8pkoyMv5sreGx2Ry5Rw=
github.com/sourcegraph/conc v0.3.1-0.20240121214520-5f936abd7ae8/go.mod h1:3n1Cwaq1E1/1lhQhtRK2ts/ZwZEhjcQeJQ1RuC6Q/8U=
github.com/spf13/afero v1.15.0 h1:b/YBCLWAJdFWJTN9cLhiXXcD7mzKn9Dm86dNnfyQw1I=
github.com/spf13/afero v1.15.0/go.mod h1:NC2ByUVxtQs4b3sIUphxK0NioZnmxgyCrfzeuq8lxMg=
github.com/spf13/cast v1.10.0 h1:h2x0u2shc1QuLHfxi+cTJvs30+ZAHOGRic8uyGTDWxY=
github.com/spf13/cast v1.10.0/go.mod h1:jNfB8QC9IA6ZuY2ZjDp0KtFO2LZZlg4S/7bzP6qqeHo=
github.com/spf13/pflag v1.0.10 h1:4EBh2KAYBwaONj6b2Ye1GiHfwjqyROoF4RwYO+vPwFk=
github.com/spf13/pflag v1.0.10/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
github.com/spf13/viper v1.21.0 h1:x5S+0EU27Lbphp4UKm1C+1oQO+rKx36vfCoaVebLFSU=
github.com/spf13/viper v1.21.0/go.mod h1:P0lhsswPGWD/1lZJ9ny3fYnVqxiegrlNrEmgLjbTCAY=
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8=
github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
github.com/vgarvardt/pgx-google-uuid/v5 v5.6.0 h1:EhPtK0mgrgaTMXpegE69hvoSOVC1Ahk8+QJ9B8b+OdU=
github.com/vgarvardt/pgx-google-uuid/v5 v5.6.0/go.mod h1:5LtFrNEkgzxHvXPO9eOvcXsSn9/KeKYgx9kjeI2oXQI=
go.uber.org/atomic v1.12.0 h1:BvcXdFKuviU4fTL/f+SxdQ5qJX/Jix8pAkgdUcb3XOE=
go.uber.org/atomic v1.12.0/go.mod h1:I6c4cg+6HCxRjfjSsYtApoFILnpc0CGUdGkXVqbYVNk=
go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
go.uber.org/multierr v1.11.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
go.yaml.in/yaml/v3 v3.0.5 h1:N6y/pJk8buWs9NY5ERU2HSMfm+IuD/OtfdAnq6kESPw=
go.yaml.in/yaml/v3 v3.0.5/go.mod h1:HVTZu1O7/Vkt2N+BFy8Zza+lnLsABggaTM2ZpNIGuKg=
golang.org/x/crypto v0.57.0 h1:3ZVCjf8Ggz7zneR/EHRVx68Ctf+2pmIMP2UFhh9cC6M=
golang.org/x/crypto v0.57.0/go.mod h1:Fdz0i5U6CoizGwLda9DttjSk6qlZo25zYNtR+ycvuZA=
golang.org/x/sync v0.23.0 h1:KameEIfc1IkluZyXWLn39Wd4tURc6GbCiISGiZm2bQk=
golang.org/x/sync v0.23.0/go.mod h1:sUUOizhqBxiL6pEWpqNLUiaJn1ShEbZ6BBqskPbjZm0=
golang.org/x/sys v0.48.0 h1:bbX/i/6MgT9BVLM9RT1thmxL04yeTAhbEz4SyadbXoo=
golang.org/x/sys v0.48.0/go.mod h1:hNLxWAXmnKAxqDtdwIYC4bM9oQPEecfsnNMuSxOs3og=
golang.org/x/text v0.42.0 h1:JbOZXgfeCPU9gacVtYliJqOhD+zhrEqK4LfdpmlUZqI=
golang.org/x/text v0.42.0/go.mod h1:ojzP1Z+2QtioaF8DTtO8K5q7JWVVYwZKenzujK0Zd0E=
google.golang.org/grpc v1.85.0 h1:BPBCfuVRQ1qvBhKDOq9uvQllMvO59rKsYhXpp7Dd8vw=
google.golang.org/grpc v1.85.0/go.mod h1:0rQrOD58yjal/0EaVbGBANindixsCZNQPDV3VKtaKuQ=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 h1:YR8cESwS4TdDjEe65xsg0ogRM/Nc3DYOhEAlW+xobZo=
gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
@@ -0,0 +1,88 @@
package http
import (
"net/http"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/gen/contracts"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/framework"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/router"
"gitea.privcloud.tech/mtusi2026/internal/service/auth"
)
type AuthHandler struct {
router router.Router
auth auth.API
}
func NewAuthHandler(r router.Router, api auth.API) Handler {
return &AuthHandler{
router: r,
auth: api,
}
}
func (h *AuthHandler) RegisterRoutes() {
h.router.Public(http.MethodPost, "/api/v1/auth/sessions", h.Login)
h.router.Private(http.MethodDelete, "/api/v1/auth/sessions/current", h.Logout)
}
func (h *AuthHandler) Login(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
username, password, ok := r.BasicAuth()
if !ok || username == "" || password == "" {
w.Header().Set(
"WWW-Authenticate",
`Basic realm="messenger", charset="UTF-8"`,
)
framework.JSONError(ctx, w, apperr.New(apperr.CodeUnauthorized, "invalid credentials"))
return
}
resp, err := h.auth.Login(ctx, dto.Login{
Username: username,
Password: password,
})
if err != nil {
if apperr.HTTPStatusFromError(err) == http.StatusUnauthorized {
w.Header().Set("WWW-Authenticate", `Basic realm="messenger", charset="UTF-8"`)
}
framework.JSONError(ctx, w, err)
return
}
framework.JSONResponse(w, http.StatusCreated, contracts.Session{
ExpiresAt: resp.ExpiresAt,
Token: resp.Tokens.RefreshToken.Payload,
TokenType: resp.TokenType,
User: contracts.User{
CreatedAt: resp.User.CreatedAt,
DisplayName: resp.User.DisplayName,
Id: resp.User.ID,
Username: resp.User.Username,
},
})
}
func (h *AuthHandler) Logout(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
token, exists := framework.Token(r)
if !exists {
framework.JSONError(ctx, w, apperr.New(apperr.CodeUnauthorized, "missing token in header"))
return
}
err := h.auth.Logout(ctx, dto.RefreshToken{
Payload: token,
})
if err != nil {
framework.JSONError(ctx, w, err)
return
}
framework.JSONResponse(w, http.StatusNoContent, nil)
}
@@ -0,0 +1,261 @@
package http
import (
"net/http"
"strings"
"unicode/utf8"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/gen/contracts"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/auth/jwtprovider"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/framework"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/router"
"gitea.privcloud.tech/mtusi2026/internal/pkg/validator"
"gitea.privcloud.tech/mtusi2026/internal/service/chat"
)
type ChatHandler struct {
router router.Router
provider jwtprovider.Provider
validator *validator.ValidatorImpl
chat chat.API
}
func NewChatHandler(r router.Router, provider jwtprovider.Provider, v *validator.ValidatorImpl, api chat.API) Handler {
return &ChatHandler{
router: r,
provider: provider,
validator: v,
chat: api,
}
}
func (h *ChatHandler) RegisterRoutes() {
h.router.Private(http.MethodPost, "/api/v1/chats", h.Create)
h.router.Private(http.MethodGet, "/api/v1/chats", h.Get)
h.router.Private(http.MethodGet, "/api/v1/chats/{chat_id}", h.GetByID)
h.router.Private(http.MethodPost, "/api/v1/chats/{chat_id}/messages", h.SendMessage)
h.router.Private(http.MethodGet, "/api/v1/chats/{chat_id}/messages", h.GetMessages)
}
func (h *ChatHandler) Create(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
userData, err := framework.ParseToken(r, h.provider)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
var req contracts.CreateChat
if !framework.Decode(w, r, &req) || !framework.Validate(w, r, h.validator, &req) {
return
}
if userData.UserID == uuid.Nil ||
!validText(req.Title, 100) ||
len(req.MemberIds) < 1 ||
len(req.MemberIds) > 100 {
framework.JSONError(ctx, w, apperr.New(apperr.CodeBadRequest, "invalid chat fields"))
return
}
resp, err := h.chat.CreateChat(ctx, dto.CreateChat{
CreatorID: userData.UserID,
Title: req.Title,
MemberIDs: req.MemberIds,
})
if err != nil {
framework.JSONError(ctx, w, err)
return
}
framework.JSONResponse(w, http.StatusCreated, contracts.Chat{
Id: resp.ID,
Title: resp.Title,
MemberIds: resp.MemberIDs,
CreatedAt: resp.CreatedAt,
})
}
func (h *ChatHandler) Get(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
userData, err := framework.ParseToken(r, h.provider)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
limit, afterID, ok := framework.PageParams(w, r)
if !ok {
return
}
if userData.UserID == uuid.Nil {
framework.JSONError(ctx, w, apperr.New(apperr.CodeBadRequest, "invalid user id"))
return
}
if afterID != nil && *afterID == uuid.Nil {
framework.JSONError(ctx, w, apperr.New(apperr.CodeBadRequest, "invalid cursor"))
return
}
page, err := h.chat.ListForMember(ctx, dto.ChatFilters{
UserID: userData.UserID,
Limit: limit,
AfterID: afterID,
})
if err != nil {
framework.JSONError(ctx, w, err)
return
}
items := make([]contracts.Chat, 0, len(page.Items))
for _, item := range page.Items {
items = append(items, contracts.Chat{
CreatedAt: item.CreatedAt,
Id: item.ID,
MemberIds: item.MemberIDs,
Title: item.Title,
})
}
framework.JSONResponse(w, http.StatusOK, contracts.ChatPage{
Items: items,
NextCursor: cursorString(page.NextCursorID),
})
}
func (h *ChatHandler) GetByID(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
userData, err := framework.ParseToken(r, h.provider)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
chatID, err := framework.ParseIDFromPathParam(ctx, w, r, "chat_id")
if err != nil {
return
}
resp, err := h.chat.GetForMember(ctx, dto.ChatMember{
UserID: userData.UserID,
ChatID: chatID,
})
if err != nil {
framework.JSONError(ctx, w, err)
return
}
framework.JSONResponse(w, http.StatusOK, contracts.Chat{
CreatedAt: resp.CreatedAt,
Id: resp.ID,
MemberIds: resp.MemberIDs,
Title: resp.Title,
})
}
func (h *ChatHandler) SendMessage(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
userData, err := framework.ParseToken(r, h.provider)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
chatID, err := framework.ParseIDFromPathParam(ctx, w, r, "chat_id")
if err != nil {
return
}
var req contracts.CreateMessage
if !framework.Decode(w, r, &req) || !framework.Validate(w, r, h.validator, &req) {
return
}
if !validText(req.Text, 4000) {
framework.JSONError(ctx, w, apperr.New(apperr.CodeBadRequest, "invalid message text"))
return
}
message, err := h.chat.CreateMessage(ctx, dto.CreateMessage{
ChatID: chatID,
SenderID: userData.UserID,
Text: req.Text,
})
if err != nil {
framework.JSONError(ctx, w, err)
return
}
framework.JSONResponse(w, http.StatusCreated, contracts.Message{
Id: message.ID,
ChatId: message.ChatID,
SenderId: message.SenderID,
Text: message.Text,
CreatedAt: message.CreatedAt,
})
}
func (h *ChatHandler) GetMessages(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
userData, err := framework.ParseToken(r, h.provider)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
chatID, err := framework.ParseIDFromPathParam(ctx, w, r, "chat_id")
if err != nil {
return
}
limit, afterID, ok := framework.PageParams(w, r)
if !ok {
return
}
page, err := h.chat.ListForChat(ctx, dto.MessageFilters{
ChatID: chatID,
UserID: userData.UserID,
Limit: limit,
AfterID: afterID,
})
if err != nil {
framework.JSONError(ctx, w, err)
return
}
items := make([]contracts.Message, 0, len(page.Items))
for _, message := range page.Items {
items = append(items, contracts.Message{
Id: message.ID,
ChatId: message.ChatID,
SenderId: message.SenderID,
Text: message.Text,
CreatedAt: message.CreatedAt,
})
}
framework.JSONResponse(w, http.StatusOK, contracts.MessagePage{Items: items, NextCursor: cursorString(page.NextCursorID)})
}
func cursorString(id *uuid.UUID) *string {
if id == nil {
return nil
}
value := id.String()
return &value
}
func validText(value string, maxLength int) bool {
return utf8.ValidString(value) && strings.TrimSpace(value) != "" && utf8.RuneCountInString(value) <= maxLength
}
@@ -0,0 +1,101 @@
package http
import (
"context"
"errors"
"log/slog"
"net"
"net/http"
"sync/atomic"
"gitea.privcloud.tech/mtusi2026/internal/config"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/router"
)
type Server interface {
ShouldBeRunning() bool
Ready() bool
Start(ctx context.Context) error
Stop(ctx context.Context) error
}
type server struct {
server http.Server
cfg *config.Server
ready atomic.Bool
}
func New(cfg *config.Config, router router.Router) Server {
s := server{
server: http.Server{
Addr: cfg.Server.BindAddress(),
Handler: router,
ReadTimeout: cfg.Server.ReadTimeout,
WriteTimeout: cfg.Server.WriteTimeout,
IdleTimeout: cfg.Server.IdleTimeout,
},
cfg: cfg.Server,
ready: atomic.Bool{},
}
if err := s.validate(); err != nil {
panic(err)
}
return &s
}
func (s *server) Start(_ context.Context) error {
if !s.ShouldBeRunning() {
slog.Info("server should not be running: skip starting")
return nil
}
listener, err := net.Listen("tcp", s.server.Addr)
if err != nil {
return err
}
s.ready.Store(true)
go func() {
defer s.ready.Store(false)
if err := s.server.Serve(listener); err != nil &&
!errors.Is(err, http.ErrServerClosed) {
slog.Error("rest server failed", "error", err)
}
}()
return nil
}
func (s *server) Stop(ctx context.Context) error {
if !s.ShouldBeRunning() {
slog.Info("server should not be running: skip stopping")
return nil
}
slog.Info("shutting down rest server...", "address", s.server.Addr)
s.ready.Store(false)
if err := s.server.Shutdown(ctx); err != nil {
slog.Error("rest server shutdown failed", "error", err)
return err
}
slog.Info("rest server shutdown successfully")
return nil
}
func (s *server) ShouldBeRunning() bool {
return s.cfg.Enabled
}
func (s *server) Ready() bool {
return s.ready.Load()
}
func (s *server) validate() error {
if s.cfg == nil {
slog.Error("failed to validate server: provided nil config")
return errors.New("failed to validate server: provided nil config")
}
slog.Info("server successfully validated")
return nil
}
@@ -0,0 +1,5 @@
package http
type Handler interface {
RegisterRoutes()
}
@@ -0,0 +1,51 @@
package http
import (
"context"
"net/http"
"time"
"gitea.privcloud.tech/mtusi2026/internal/gen/contracts"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/framework"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/router"
)
type databasePinger interface{ Ping(context.Context) error }
type HealthHandler struct {
router router.Router
server Server
database databasePinger
}
func NewHealthHandler(r router.Router, server Server, database databasePinger) Handler {
return &HealthHandler{
router: r,
server: server,
database: database,
}
}
func (h *HealthHandler) RegisterRoutes() {
h.router.Public(http.MethodGet, "/health/ready", h.Ready)
h.router.Public(http.MethodGet, "/health/live", h.Live)
}
func (h *HealthHandler) Live(w http.ResponseWriter, _ *http.Request) {
framework.JSONResponse(w, http.StatusOK, contracts.Health{Status: contracts.Ok})
}
func (h *HealthHandler) Ready(w http.ResponseWriter, r *http.Request) {
if !h.server.Ready() {
framework.JSONError(r.Context(), w, apperr.New(apperr.CodeUnavailable, "server is not ready"))
return
}
ctx, cancel := context.WithTimeout(r.Context(), 200*time.Millisecond)
defer cancel()
if err := h.database.Ping(ctx); err != nil {
framework.JSONError(r.Context(), w, apperr.New(apperr.CodeUnavailable, "database unavailable"))
return
}
framework.JSONResponse(w, http.StatusOK, contracts.Health{Status: contracts.Ok})
}
@@ -0,0 +1 @@
package http
@@ -0,0 +1,113 @@
package http
import (
"net/http"
"regexp"
"strings"
"unicode/utf8"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/gen/contracts"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/auth/jwtprovider"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/framework"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/router"
"gitea.privcloud.tech/mtusi2026/internal/pkg/validator"
"gitea.privcloud.tech/mtusi2026/internal/service/user"
)
type UserHandler struct {
router router.Router
provider jwtprovider.Provider
validator *validator.ValidatorImpl
user user.API
}
func NewUserHandler(r router.Router, provider jwtprovider.Provider, v *validator.ValidatorImpl, api user.API) Handler {
return &UserHandler{
router: r,
provider: provider,
validator: v,
user: api,
}
}
var usernamePattern = regexp.MustCompile(`^[a-z0-9_]{3,32}$`)
func (h *UserHandler) RegisterRoutes() {
h.router.Public(http.MethodPost, "/api/v1/users", h.Create)
h.router.Private(http.MethodGet, "/api/v1/users/me", h.GetMe)
}
func (h *UserHandler) Create(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
var req contracts.CreateUser
if !framework.Decode(w, r, &req) || !framework.Validate(w, r, h.validator, &req) {
return
}
toCreate := dto.CreateUser{
Username: req.Username,
DisplayName: req.DisplayName,
}
if req.Password != nil {
toCreate.Password = *req.Password
}
if !usernamePattern.MatchString(req.Username) || !utf8.ValidString(req.DisplayName) ||
strings.TrimSpace(req.DisplayName) == "" || utf8.RuneCountInString(req.DisplayName) > 100 {
framework.JSONError(ctx, w, apperr.New(apperr.CodeBadRequest, "invalid user fields"))
return
}
passwordLen := utf8.RuneCountInString(toCreate.Password)
if !utf8.ValidString(toCreate.Password) || strings.TrimSpace(toCreate.Password) == "" || passwordLen < 12 || passwordLen > 128 {
framework.JSONError(ctx, w, apperr.New(apperr.CodeBadRequest, "invalid password"))
return
}
resp, err := h.user.Create(ctx, toCreate)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
framework.JSONResponse(w, http.StatusCreated, contracts.User{
CreatedAt: resp.CreatedAt,
DisplayName: resp.DisplayName,
Id: resp.ID,
Username: resp.Username,
})
}
func (h *UserHandler) GetMe(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
userData, err := framework.ParseToken(r, h.provider)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
if userData.UserID == uuid.Nil {
framework.JSONError(ctx, w, apperr.New(apperr.CodeBadRequest, "invalid user id"))
return
}
resp, err := h.user.GetByID(ctx, userData.UserID)
if err != nil {
framework.JSONError(ctx, w, err)
return
}
framework.JSONResponse(w, http.StatusOK, contracts.User{
CreatedAt: resp.CreatedAt,
DisplayName: resp.DisplayName,
Id: resp.ID,
Username: resp.Username,
})
}
@@ -0,0 +1,107 @@
package inmemory
import (
"log/slog"
"sync/atomic"
"unsafe"
)
type Cache[K comparable, V any] interface {
Name() string
GetAll() map[K]V
GetList() []V
Get(key K) (value V, ok bool)
Find(predicate func(K, V) bool) []V
}
type CopyAndWriteCache[K comparable, V any] struct {
name string
data unsafe.Pointer
}
func NewCopyAndWriteCache[K comparable, V any](
name string,
) *CopyAndWriteCache[K, V] {
c := CopyAndWriteCache[K, V]{
name: name,
}
emptyMap := make(map[K]V)
atomic.StorePointer(&c.data, unsafe.Pointer(&emptyMap))
slog.Info("cache initialized", "name", name)
return &c
}
func (c *CopyAndWriteCache[K, V]) Name() string {
return c.name
}
func (c *CopyAndWriteCache[K, V]) GetAll() map[K]V {
ptr := atomic.LoadPointer(&c.data)
if ptr == nil {
return make(map[K]V)
}
m := *(*map[K]V)(ptr)
out := make(map[K]V, len(m))
for k, v := range m {
out[k] = v
}
return out
}
func (c *CopyAndWriteCache[K, V]) GetList() []V {
records := c.GetAll()
out := make([]V, 0, len(records))
for _, record := range records {
out = append(out, record)
}
return out
}
func (c *CopyAndWriteCache[K, V]) Get(key K) (value V, ok bool) {
ptr := atomic.LoadPointer(&c.data)
if ptr == nil {
var zero V
return zero, false
}
m := *(*map[K]V)(ptr)
v, ok := m[key]
return v, ok
}
func (c *CopyAndWriteCache[K, V]) Find(predicate func(K, V) bool) []V {
ptr := atomic.LoadPointer(&c.data)
if ptr == nil {
return []V{}
}
m := *(*map[K]V)(ptr)
var result []V
for key, value := range m {
if predicate(key, value) {
result = append(result, value)
}
}
return result
}
func (c *CopyAndWriteCache[K, V]) Store(key K, value V) bool {
ptr := atomic.LoadPointer(&c.data)
if ptr == nil {
return false
}
m := *(*map[K]V)(ptr)
m[key] = value
return true
}
@@ -0,0 +1,78 @@
package outside
import (
"context"
"encoding/json"
"fmt"
"time"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/cache"
)
const (
// chatRedisKey equals "chat:{chat_id}" path
chatRedisKey = "chat:%s"
)
type ChatCache struct {
client *cache.Client
}
func NewChatCache(client *cache.Client) *ChatCache {
return &ChatCache{
client: client,
}
}
type chat struct {
ID uuid.UUID `json:"id"`
Title string `json:"title"`
MemberIDs []uuid.UUID `json:"member_ids"`
CreatedAt time.Time `json:"created_at"`
}
func (r *ChatCache) Create(ctx context.Context, req dto.Chat) error {
data, err := json.Marshal(chat{
ID: req.ID,
Title: req.Title,
MemberIDs: req.MemberIDs,
CreatedAt: req.CreatedAt,
})
if err != nil {
return apperr.Wrap(err, apperr.CodeInternal, "failed to marshal chat cache")
}
ctx, cancel := context.WithTimeout(ctx, cache.OperationTimeout)
defer cancel()
err = r.client.Set(ctx, fmt.Sprintf(chatRedisKey, req.ID), data, 0).Err()
if err != nil {
return apperr.WrapRedis(err, "failed to create chat cache")
}
return nil
}
func (r *ChatCache) Get(ctx context.Context, chatID uuid.UUID) (*dto.Chat, error) {
ctx, cancel := context.WithTimeout(ctx, cache.OperationTimeout)
defer cancel()
data, err := r.client.Get(ctx, fmt.Sprintf(chatRedisKey, chatID.String())).Bytes()
if err != nil {
return nil, apperr.WrapRedis(err, "failed to read chat cache")
}
var item chat
if err = json.Unmarshal(data, &item); err != nil {
return nil, apperr.Wrap(err, apperr.CodeInternal, "failed to unmarshal chat cache")
}
return &dto.Chat{
ID: item.ID,
Title: item.Title,
MemberIDs: item.MemberIDs,
CreatedAt: item.CreatedAt,
}, nil
}
@@ -0,0 +1,91 @@
package storage
import (
"context"
"errors"
"github.com/google/uuid"
"github.com/jackc/pgerrcode"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
"github.com/jackc/pgx/v5/pgxpool"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
)
type ChatsRepo struct {
pool *pgxpool.Pool
}
func NewChatsRepo(pool *pgxpool.Pool) *ChatsRepo {
return &ChatsRepo{pool: pool}
}
func (r *ChatsRepo) CreateTx(ctx context.Context, tx pgx.Tx, req dto.Chat) error {
const insertChat = `INSERT INTO chats (id, title, created_at) VALUES ($1, $2, $3)`
if _, err := tx.Exec(ctx, insertChat, req.ID, req.Title, req.CreatedAt); err != nil {
return apperr.WrapPostgres(err, "failed to create chat")
}
const insertMembers = `INSERT INTO chat_members (chat_id, user_id)
SELECT $1, user_id FROM unnest($2::uuid[]) AS members(user_id)`
if _, err := tx.Exec(ctx, insertMembers, req.ID, req.MemberIDs); err != nil {
if pgErr, ok := errors.AsType[*pgconn.PgError](err); ok &&
pgErr.Code == pgerrcode.ForeignKeyViolation && pgErr.ConstraintName == "chat_members_user_fk" {
return apperr.Wrap(err, apperr.CodeBadRequest, "unknown chat member")
}
return apperr.WrapPostgres(err, "failed to create chat members")
}
return nil
}
func (r *ChatsRepo) GetForMember(ctx context.Context, req dto.ChatMember) (*dto.Chat, error) {
const query = `SELECT c.id, c.title, c.created_at,
ARRAY(SELECT m.user_id FROM chat_members m WHERE m.chat_id = c.id ORDER BY m.user_id)
FROM chats c
WHERE c.id = $1
AND EXISTS (SELECT 1 FROM chat_members access WHERE access.chat_id = c.id AND access.user_id = $2)`
return scanChat(r.pool.QueryRow(ctx, query, req.ChatID, req.UserID))
}
func (r *ChatsRepo) ListForMember(ctx context.Context, userID uuid.UUID, page dto.PageQuery) ([]dto.Chat, error) {
query := `WITH page AS MATERIALIZED (
SELECT c.id, c.title, c.created_at
FROM chats c JOIN chat_members access ON access.chat_id = c.id
WHERE access.user_id = $1`
args := []any{userID, page.Limit}
if page.After != nil {
query += ` AND (c.created_at, c.id) > ($3, $4)`
args = append(args, page.After.CreatedAt, page.After.ID)
}
query += ` ORDER BY c.created_at, c.id LIMIT $2
)
SELECT p.id, p.title, p.created_at,
ARRAY(SELECT m.user_id FROM chat_members m WHERE m.chat_id = p.id ORDER BY m.user_id)
FROM page p ORDER BY p.created_at, p.id`
rows, err := r.pool.Query(ctx, query, args...)
if err != nil {
return nil, apperr.WrapPostgres(err, "failed to list chats")
}
defer rows.Close()
chats := make([]dto.Chat, 0)
for rows.Next() {
chat, err := scanChat(rows)
if err != nil {
return nil, err
}
chats = append(chats, *chat)
}
if err = rows.Err(); err != nil {
return nil, apperr.WrapPostgres(err, "failed to list chats")
}
return chats, nil
}
func scanChat(row pgx.Row) (*dto.Chat, error) {
var chat dto.Chat
if err := row.Scan(&chat.ID, &chat.Title, &chat.CreatedAt, &chat.MemberIDs); err != nil {
return nil, apperr.WrapPostgres(err, "failed to get chat")
}
return &chat, nil
}
@@ -0,0 +1,75 @@
package storage
import (
"context"
"errors"
"github.com/google/uuid"
"github.com/jackc/pgerrcode"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
"github.com/jackc/pgx/v5/pgxpool"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
)
type MessagesRepo struct {
pool *pgxpool.Pool
}
func NewMessagesRepo(pool *pgxpool.Pool) *MessagesRepo {
return &MessagesRepo{pool: pool}
}
func (r *MessagesRepo) Create(ctx context.Context, req dto.Message) error {
const query = `INSERT INTO messages (id, chat_id, sender_id, text, created_at) VALUES ($1, $2, $3, $4, $5)`
if _, err := r.pool.Exec(ctx, query, req.ID, req.ChatID, req.SenderID, req.Text, req.CreatedAt); err != nil {
if pgErr, ok := errors.AsType[*pgconn.PgError](err); ok &&
pgErr.Code == pgerrcode.ForeignKeyViolation && pgErr.ConstraintName == "messages_sender_member_fk" {
return apperr.Wrap(err, apperr.CodeNotFound, "chat not found")
}
return apperr.WrapPostgres(err, "failed to create message")
}
return nil
}
func (r *MessagesRepo) GetByIDForChat(ctx context.Context, chatID, messageID uuid.UUID) (*dto.Message, error) {
const query = `SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = $1 AND id = $2`
return scanMessage(r.pool.QueryRow(ctx, query, chatID, messageID))
}
func (r *MessagesRepo) ListForChat(ctx context.Context, chatID uuid.UUID, page dto.PageQuery) ([]dto.Message, error) {
query := `SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = $1`
args := []any{chatID, page.Limit}
if page.After != nil {
query += ` AND (created_at, id) > ($3, $4)`
args = append(args, page.After.CreatedAt, page.After.ID)
}
query += ` ORDER BY created_at, id LIMIT $2`
rows, err := r.pool.Query(ctx, query, args...)
if err != nil {
return nil, apperr.WrapPostgres(err, "failed to list messages")
}
defer rows.Close()
messages := make([]dto.Message, 0)
for rows.Next() {
message, err := scanMessage(rows)
if err != nil {
return nil, err
}
messages = append(messages, *message)
}
if err = rows.Err(); err != nil {
return nil, apperr.WrapPostgres(err, "failed to list messages")
}
return messages, nil
}
func scanMessage(row pgx.Row) (*dto.Message, error) {
var message dto.Message
if err := row.Scan(&message.ID, &message.ChatID, &message.SenderID, &message.Text, &message.CreatedAt); err != nil {
return nil, apperr.WrapPostgres(err, "failed to get message")
}
return &message, nil
}
@@ -0,0 +1,193 @@
package storage
import (
"context"
"time"
"github.com/google/uuid"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgxpool"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/postgres"
)
type RefreshTokensRepo struct {
pool *pgxpool.Pool
}
func NewRefreshTokensRepo(pool *pgxpool.Pool) *RefreshTokensRepo {
return &RefreshTokensRepo{
pool: pool,
}
}
func (r *RefreshTokensRepo) Create(ctx context.Context, req dto.StoredRefreshToken) error {
return r.create(ctx, r.pool, req)
}
func (r *RefreshTokensRepo) CreateTx(ctx context.Context, tx pgx.Tx, req dto.StoredRefreshToken) error {
return r.create(ctx, tx, req)
}
func (r *RefreshTokensRepo) GetByID(ctx context.Context, id uuid.UUID) (*dto.StoredRefreshToken, error) {
return r.getByID(ctx, r.pool, id, false)
}
func (r *RefreshTokensRepo) GetByIDTx(ctx context.Context, tx pgx.Tx, id uuid.UUID) (*dto.StoredRefreshToken, error) {
return r.getByID(ctx, tx, id, false)
}
func (r *RefreshTokensRepo) GetByIDForUpdate(ctx context.Context, id uuid.UUID) (*dto.StoredRefreshToken, error) {
return r.getByID(ctx, r.pool, id, true)
}
func (r *RefreshTokensRepo) GetByIDForUpdateTx(ctx context.Context, tx pgx.Tx, id uuid.UUID) (*dto.StoredRefreshToken, error) {
return r.getByID(ctx, tx, id, true)
}
func (r *RefreshTokensRepo) Revoke(ctx context.Context, req dto.RevokeRefreshToken) error {
return r.revoke(ctx, r.pool, req)
}
func (r *RefreshTokensRepo) RevokeTx(ctx context.Context, tx pgx.Tx, req dto.RevokeRefreshToken) error {
return r.revoke(ctx, tx, req)
}
func (r *RefreshTokensRepo) RevokeAllByUserID(ctx context.Context, req dto.RevokeRefreshTokensByUserID) error {
return r.revokeAllByUserID(ctx, r.pool, req)
}
func (r *RefreshTokensRepo) RevokeAllByUserIDTx(ctx context.Context, tx pgx.Tx, req dto.RevokeRefreshTokensByUserID) error {
return r.revokeAllByUserID(ctx, tx, req)
}
func (r *RefreshTokensRepo) DeleteExpired(ctx context.Context) error {
const query = `
DELETE FROM refresh_tokens
WHERE expires_at < $1`
_, err := r.pool.Exec(ctx, query, time.Now())
if err != nil {
return apperr.WrapPostgres(err, "failed to delete expired refresh tokens")
}
return nil
}
func (r *RefreshTokensRepo) create(ctx context.Context, conn postgres.Conn, req dto.StoredRefreshToken) error {
const query = `INSERT INTO refresh_tokens (id,
user_id,
token_hash,
user_agent,
ip_address,
role,
expires_at,
created_at)
VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`
ct, err := conn.Exec(
ctx,
query,
req.ID,
req.UserID,
req.TokenHash,
req.UserAgent,
req.IPAddress,
req.Role,
req.ExpiresAt,
req.CreatedAt,
)
if err != nil {
return apperr.WrapPostgres(err, "failed to create refresh token")
}
if ct.RowsAffected() == 0 {
return apperr.New(apperr.CodeAlreadyExists, "refresh token already exists")
}
return nil
}
func (r *RefreshTokensRepo) getByID(ctx context.Context, conn postgres.Conn, id uuid.UUID, lock bool) (*dto.StoredRefreshToken, error) {
const query = `SELECT id,
user_id,
token_hash,
user_agent,
ip_address,
role,
expires_at,
revoked_at,
created_at
FROM refresh_tokens
WHERE id = $1`
const queryLock = `SELECT id,
user_id,
token_hash,
user_agent,
ip_address,
role,
expires_at,
revoked_at,
created_at
FROM refresh_tokens
WHERE id = $1 FOR UPDATE`
use := query
if lock {
use = queryLock
}
var token dto.StoredRefreshToken
err := conn.QueryRow(ctx, use, id).Scan(
&token.ID,
&token.UserID,
&token.TokenHash,
&token.UserAgent,
&token.IPAddress,
&token.Role,
&token.ExpiresAt,
&token.RevokedAt,
&token.CreatedAt,
)
if err != nil {
return nil, apperr.WrapPostgres(err, "failed to get refresh by id")
}
return &token, nil
}
func (r *RefreshTokensRepo) revoke(ctx context.Context, conn postgres.Conn, req dto.RevokeRefreshToken) error {
const query = `
UPDATE refresh_tokens
SET revoked_at = $2
WHERE id = $1
AND revoked_at IS NULL`
ct, err := conn.Exec(ctx, query, req.ID, req.RevokedAt)
if err != nil {
return apperr.WrapPostgres(err, "failed to revoke refresh token")
}
if ct.RowsAffected() == 0 {
return apperr.New(apperr.CodeNotFound, "refresh token not found")
}
return nil
}
func (r *RefreshTokensRepo) revokeAllByUserID(ctx context.Context, conn postgres.Conn, req dto.RevokeRefreshTokensByUserID) error {
const query = `
UPDATE refresh_tokens
SET revoked_at = $2
WHERE user_id = $1
AND revoked_at IS NULL`
_, err := conn.Exec(ctx, query, req.UserID, req.RevokedAt)
if err != nil {
return apperr.WrapPostgres(err, "failed to revoke refresh tokens")
}
return nil
}
@@ -0,0 +1,103 @@
package storage
import (
"context"
"errors"
"github.com/google/uuid"
"github.com/jackc/pgerrcode"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
"github.com/jackc/pgx/v5/pgxpool"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/postgres"
)
type UsersRepo struct {
pool *pgxpool.Pool
}
func NewUsersRepo(pool *pgxpool.Pool) *UsersRepo {
return &UsersRepo{pool: pool}
}
func (r *UsersRepo) Create(ctx context.Context, req dto.CreateStoredUser) error {
return r.create(ctx, r.pool, req)
}
func (r *UsersRepo) CreateTx(ctx context.Context, tx pgx.Tx, req dto.CreateStoredUser) error {
return r.create(ctx, tx, req)
}
func (r *UsersRepo) GetByID(ctx context.Context, id uuid.UUID) (*dto.User, error) {
return r.getByID(ctx, r.pool, id)
}
func (r *UsersRepo) GetByIDTx(ctx context.Context, tx pgx.Tx, id uuid.UUID) (*dto.User, error) {
return r.getByID(ctx, tx, id)
}
func (r *UsersRepo) GetByUsername(ctx context.Context, username string) (*dto.User, error) {
const query = `SELECT id, username, name, created_at FROM users WHERE username = $1`
return scanUser(r.pool.QueryRow(ctx, query, username))
}
func (r *UsersRepo) GetCredentialsByUsername(ctx context.Context, username string) (*dto.UserCredentials, error) {
const query = `SELECT id, username, name, created_at, password_hash FROM users WHERE username = $1`
var credentials dto.UserCredentials
err := r.pool.QueryRow(ctx, query, username).Scan(
&credentials.User.ID,
&credentials.User.Username,
&credentials.User.DisplayName,
&credentials.User.CreatedAt,
&credentials.PasswordHash,
)
if err != nil {
return nil, apperr.WrapPostgres(err, "failed to get user credentials")
}
return &credentials, nil
}
func (r *UsersRepo) Delete(ctx context.Context, id uuid.UUID) error {
const query = `DELETE FROM users WHERE id = $1`
ct, err := r.pool.Exec(ctx, query, id)
if err != nil {
return apperr.WrapPostgres(err, "failed to delete user")
}
if ct.RowsAffected() == 0 {
return apperr.New(apperr.CodeNotFound, "user not found")
}
return nil
}
func (r *UsersRepo) create(ctx context.Context, conn postgres.Conn, req dto.CreateStoredUser) error {
const query = `INSERT INTO users (id, username, name, password_hash, created_at, updated_at)
VALUES ($1, $2, $3, $4, $5, $6)`
_, err := conn.Exec(ctx, query, req.ID, req.Username, req.DisplayName, req.PasswordHash, req.CreatedAt, req.UpdatedAt)
if err != nil {
if pgErr, ok := errors.AsType[*pgconn.PgError](err); ok &&
pgErr.Code == pgerrcode.UniqueViolation && pgErr.ConstraintName == "users_username_unique" {
return apperr.Wrap(err, apperr.CodeConflict, "username already exists")
}
return apperr.WrapPostgres(err, "failed to create user")
}
return nil
}
func (r *UsersRepo) getByID(ctx context.Context, conn postgres.Conn, id uuid.UUID) (*dto.User, error) {
const query = `SELECT id, username, name, created_at FROM users WHERE id = $1`
return scanUser(conn.QueryRow(ctx, query, id))
}
func scanUser(row pgx.Row) (*dto.User, error) {
var user dto.User
if err := row.Scan(&user.ID, &user.Username, &user.DisplayName, &user.CreatedAt); err != nil {
return nil, apperr.WrapPostgres(err, "failed to get user")
}
return &user, nil
}
+7
View File
@@ -0,0 +1,7 @@
package config
import "github.com/spf13/viper"
type Loader interface {
loadConfig(v *viper.Viper) error
}
+63
View File
@@ -0,0 +1,63 @@
package config
import (
"errors"
"time"
"github.com/spf13/viper"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/environment"
)
type Application struct {
LogLevel string
ShutdownTimeout time.Duration
Environment environment.ApplicationEnvironment
RequestRateLimit float64
BurstRateLimit int
RateLimitTTL time.Duration
}
func (c *Application) Validate() error {
environmentErr := c.Environment.Validate()
switch {
case c.LogLevel == "":
return wrapValidationError("application", errors.New("log_level cannot be empty in application config"))
case c.ShutdownTimeout == 0:
return wrapValidationError("application", errors.New("shutdown_timeout cannot be zero in application config"))
case environmentErr != nil:
return wrapValidationError("application", environmentErr)
//case c.RequestRateLimit == 0:
// return wrapValidationError("application", errors.New("request_rate_limit cannot be zero in application config"))
//case c.BurstRateLimit == 0:
// return wrapValidationError("application", errors.New("burst_rate_limit cannot be zero in application config"))
//case c.RateLimitTTL == 0:
// return wrapValidationError("application", errors.New("rate_limit_ttl cannot be zero in application config"))
default:
return nil
}
}
func (c *Application) loadConfig(v *viper.Viper) error {
v.SetEnvPrefix("APPLICATION")
c.LogLevel = v.GetString("LOG_LEVEL")
c.ShutdownTimeout = v.GetDuration("SHUTDOWN_TIMEOUT")
c.Environment = environment.ParseEnvironment(v.GetString("ENVIRONMENT"))
// todo add cool value
c.RequestRateLimit = v.GetFloat64("REQUEST_RATE_LIMIT")
c.BurstRateLimit = v.GetInt("BURST_RATE_LIMIT")
c.RateLimitTTL = v.GetDuration("RATE_LIMIT_TTL")
return nil
}
func (c *Application) copy() *Application {
return &Application{
LogLevel: c.LogLevel,
ShutdownTimeout: c.ShutdownTimeout,
Environment: c.Environment,
RequestRateLimit: c.RequestRateLimit,
BurstRateLimit: c.BurstRateLimit,
RateLimitTTL: c.RateLimitTTL,
}
}
+110
View File
@@ -0,0 +1,110 @@
package config
import (
"strings"
"time"
"github.com/spf13/viper"
"go.uber.org/multierr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/environment"
)
var defaultConfig = &Config{
Server: &Server{
Host: "localhost",
Port: 8001,
ReadTimeout: 10 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 10 * time.Second,
ShutdownTimeout: 10 * time.Second,
Enabled: false,
},
Postgres: &Postgres{
Host: "localhost",
Port: 5432,
User: "postgres",
Password: "postgres",
Database: "postgres",
VersionTable: "versions",
RunMigrations: false,
MaxConnections: 10,
ConnectTimeout: 500 * time.Millisecond,
QueryTimeout: 2 * time.Second,
},
Redis: &Redis{
Host: "localhost",
Port: 6379,
Username: "",
Password: "",
DB: 0,
},
JWT: &JWT{
AccessTokenLifetime: 4 * time.Hour,
RefreshTokenLifetime: time.Hour,
PublicKeyPath: "certs/private.pem",
PrivateKeyPath: "certs/public.pem",
},
Application: &Application{
LogLevel: "info",
ShutdownTimeout: 10 * time.Second,
Environment: environment.ApplicationEnvironmentDev,
RequestRateLimit: 100,
},
}
type Config struct {
Server *Server
Postgres *Postgres
Redis *Redis
JWT *JWT
Application *Application
}
func New() (*Config, error) {
v := viper.New()
v.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))
v.AutomaticEnv()
cfg := defaultConfig.copy()
if err := cfg.loadConfig(v); err != nil {
return nil, err
}
if err := cfg.Validate(); err != nil {
return nil, err
}
return cfg, nil
}
func (c *Config) Validate() error {
return multierr.Combine(
c.Server.Validate(),
c.Postgres.Validate(),
c.JWT.Validate(),
c.Redis.Validate(),
c.Application.Validate(),
)
}
func (c *Config) loadConfig(v *viper.Viper) error {
return multierr.Combine(
c.Postgres.loadConfig(v),
c.Server.loadConfig(v),
c.JWT.loadConfig(v),
c.Redis.loadConfig(v),
c.Application.loadConfig(v),
)
}
func (c *Config) copy() *Config {
return &Config{
Server: c.Server.copy(),
Postgres: c.Postgres.copy(),
Redis: c.Redis.copy(),
JWT: c.JWT.copy(),
Application: c.Application.copy(),
}
}
+65
View File
@@ -0,0 +1,65 @@
package config
import (
"errors"
"net/http"
"strings"
"github.com/spf13/viper"
)
type Cookies struct {
Enabled bool
Domain string
Path string
Secure bool
SameSite http.SameSite
AllowedOrigins []string
}
func (c *Cookies) Validate() error {
switch {
case c.Domain == "":
return wrapValidationError("cookies", errors.New("domain cannot be empty"))
case c.Path == "":
return wrapValidationError("cookies", errors.New("path cannot be empty"))
case c.SameSite == http.SameSiteDefaultMode:
return wrapValidationError("cookies", errors.New("same_site_set_to_none_mode cannot be empty"))
//case c.Enabled && !c.Secure:
// return wrapValidationError("cookies", errors.New("if cookies_enabled equals true then cookies_secure must be true"))
case c.AllowedOrigins == nil || len(c.AllowedOrigins) == 0:
return wrapValidationError("cookies", errors.New("allowed_origins cannot be empty"))
default:
return nil
}
}
func (c *Cookies) loadConfig(v *viper.Viper) error {
v.SetEnvPrefix("COOKIES")
c.Enabled = v.GetBool("ENABLED")
c.Domain = v.GetString("DOMAIN")
c.Path = v.GetString("PATH")
c.Secure = v.GetBool("SECURE")
c.AllowedOrigins = v.GetStringSlice("ALLOWED_ORIGINS")
sameSite := v.GetString("SAME_SITE")
switch strings.ToLower(strings.TrimSpace(sameSite)) {
case "strict":
c.SameSite = http.SameSiteStrictMode
case "none":
c.SameSite = http.SameSiteNoneMode
default:
c.SameSite = http.SameSiteLaxMode
}
return nil
}
func (c *Cookies) copy() *Cookies {
return &Cookies{
Enabled: c.Enabled,
Domain: c.Domain,
Path: c.Path,
Secure: c.Secure,
SameSite: c.SameSite,
AllowedOrigins: c.AllowedOrigins,
}
}
+63
View File
@@ -0,0 +1,63 @@
package config
import (
"errors"
"os"
"strconv"
"time"
"github.com/spf13/viper"
)
type JWT struct {
AccessTokenLifetime time.Duration
RefreshTokenLifetime time.Duration
PublicKeyPath string
PrivateKeyPath string
}
func (c *JWT) Validate() error {
switch {
case c.AccessTokenLifetime <= 0:
return wrapValidationError("jwt", errors.New("access_token_lifetime cannot be empty"))
case c.RefreshTokenLifetime <= 0:
return wrapValidationError("jwt", errors.New("refresh_token_lifetime cannot be empty"))
case c.PrivateKeyPath == "":
return wrapValidationError("jwt", errors.New("private_key_path cannot be empty"))
case c.PublicKeyPath == "":
return wrapValidationError("jwt", errors.New("public_key_path cannot be empty"))
default:
return nil
}
}
func (c *JWT) loadConfig(v *viper.Viper) error {
v.SetEnvPrefix("JWT")
c.AccessTokenLifetime = v.GetDuration("ACCESS_TOKEN_LIFETIME")
c.RefreshTokenLifetime = time.Hour
if value := os.Getenv("SESSION_TTL_SECONDS"); value != "" {
seconds, err := strconv.ParseInt(value, 10, 64)
if err != nil || seconds <= 0 || seconds > int64((1<<63-1)/time.Second) {
return wrapValidationError("session", errors.New("SESSION_TTL_SECONDS must be a positive integer duration in seconds"))
}
c.RefreshTokenLifetime = time.Duration(seconds) * time.Second
} else if legacy := v.GetString("REFRESH_TOKEN_LIFETIME"); legacy != "" {
duration, err := time.ParseDuration(legacy)
if err != nil {
return wrapValidationError("jwt", errors.New("invalid refresh_token_lifetime"))
}
c.RefreshTokenLifetime = duration
}
c.PublicKeyPath = v.GetString("PUBLIC_KEY_PATH")
c.PrivateKeyPath = v.GetString("PRIVATE_KEY_PATH")
return nil
}
func (c *JWT) copy() *JWT {
return &JWT{
AccessTokenLifetime: c.AccessTokenLifetime,
RefreshTokenLifetime: c.RefreshTokenLifetime,
PublicKeyPath: c.PublicKeyPath,
PrivateKeyPath: c.PrivateKeyPath,
}
}
+110
View File
@@ -0,0 +1,110 @@
package config
import (
"errors"
"fmt"
"math"
"time"
"github.com/spf13/viper"
)
const (
uri = "postgres://%s:%s@%s:%d/%s?sslmode=disable"
)
type Postgres struct {
Host string
Port int
User string
Password string
Database string
VersionTable string
RunMigrations bool
MaxConnections int
ConnectTimeout time.Duration
QueryTimeout time.Duration
}
func (c *Postgres) Validate() error {
switch {
case c.Host == "":
return wrapValidationError("postgres", errors.New("host cannot be empty"))
case c.Port == 0:
return wrapValidationError("postgres", errors.New("port cannot be empty"))
case c.User == "":
return wrapValidationError("postgres", errors.New("user cannot be empty"))
case c.Password == "":
return wrapValidationError("postgres", errors.New("password cannot be empty"))
case c.Database == "":
return wrapValidationError("postgres", errors.New("database cannot be empty"))
case c.VersionTable == "":
return wrapValidationError("postgres", errors.New("version_table name cannot be empty"))
case c.MaxConnections <= 0 || int64(c.MaxConnections) > math.MaxInt32:
return wrapValidationError("postgres", errors.New("max_connections must be between 1 and 2147483647"))
case c.ConnectTimeout <= 0:
return wrapValidationError("postgres", errors.New("connect_timeout must be positive"))
case c.QueryTimeout < time.Millisecond:
return wrapValidationError("postgres", errors.New("query_timeout must be at least 1ms"))
default:
return nil
}
}
func (c *Postgres) GetMaxConnections() int32 { return int32(c.MaxConnections) }
func (c *Postgres) GetConnectTimeout() time.Duration { return c.ConnectTimeout }
func (c *Postgres) GetQueryTimeout() time.Duration { return c.QueryTimeout }
func (c *Postgres) GetVersionTableName() string {
if c == nil {
return ""
}
return c.VersionTable
}
func (c *Postgres) GetURI() string {
if c == nil {
return ""
}
return fmt.Sprintf(uri, c.User, c.Password, c.Host, c.Port, c.Database)
}
func (c *Postgres) GetRunMigrations() bool {
if c == nil {
return false
}
return c.RunMigrations
}
func (c *Postgres) loadConfig(v *viper.Viper) error {
v.SetEnvPrefix("POSTGRES")
c.Host = v.GetString("HOST")
c.Port = v.GetInt("PORT")
c.User = v.GetString("USER")
c.Password = v.GetString("PASSWORD")
c.Database = v.GetString("DATABASE")
c.VersionTable = v.GetString("VERSION_TABLE")
c.RunMigrations = v.GetBool("RUN_MIGRATIONS")
c.MaxConnections = v.GetInt("MAX_CONNECTIONS")
c.ConnectTimeout = v.GetDuration("CONNECT_TIMEOUT")
c.QueryTimeout = v.GetDuration("QUERY_TIMEOUT")
return nil
}
func (c *Postgres) copy() *Postgres {
if c == nil {
return nil
}
return &Postgres{
Host: c.Host,
Port: c.Port,
User: c.User,
Password: c.Password,
Database: c.Database,
MaxConnections: c.MaxConnections,
ConnectTimeout: c.ConnectTimeout,
QueryTimeout: c.QueryTimeout,
RunMigrations: c.RunMigrations,
VersionTable: c.VersionTable,
}
}
+72
View File
@@ -0,0 +1,72 @@
package config
import (
"errors"
"fmt"
"net"
"time"
"github.com/redis/go-redis/v9"
"github.com/spf13/viper"
)
type Redis struct {
Host string
Port int
Username string
Password string
DB int
}
func (c *Redis) Validate() error {
switch {
case c.Host == "":
return wrapValidationError("redis", errors.New("host cannot be empty"))
case c.Port == 0:
return wrapValidationError("redis", errors.New("port cannot be empty"))
default:
return nil
}
}
func (c *Redis) BuildRedisOptions() *redis.Options {
if c == nil {
return nil
}
return &redis.Options{
Addr: net.JoinHostPort(c.Host, fmt.Sprintf("%d", c.Port)),
Username: c.Username,
Password: c.Password,
DB: c.DB,
DialTimeout: 200 * time.Millisecond,
ReadTimeout: 200 * time.Millisecond,
WriteTimeout: 200 * time.Millisecond,
PoolTimeout: 200 * time.Millisecond,
MaxRetries: -1,
DialerRetries: 1,
ContextTimeoutEnabled: true,
}
}
func (c *Redis) loadConfig(v *viper.Viper) error {
v.SetEnvPrefix("REDIS")
c.Host = v.GetString("HOST")
c.Port = v.GetInt("PORT")
c.DB = v.GetInt("DB")
c.Password = v.GetString("PASSWORD")
c.Username = v.GetString("USERNAME")
return nil
}
func (c *Redis) copy() *Redis {
if c == nil {
return nil
}
return &Redis{
Host: c.Host,
Port: c.Port,
Username: c.Username,
Password: c.Password,
DB: c.DB,
}
}
+69
View File
@@ -0,0 +1,69 @@
package config
import (
"errors"
"fmt"
"time"
"github.com/spf13/viper"
)
type Server struct {
Host string
Port int
ReadTimeout time.Duration
WriteTimeout time.Duration
IdleTimeout time.Duration
ShutdownTimeout time.Duration
Enabled bool
}
func (c *Server) Validate() error {
if !c.Enabled {
return nil
}
switch {
case c.Host == "":
return wrapValidationError("server", errors.New("host cannot be empty"))
case c.Port == 0:
return wrapValidationError("server", errors.New("port cannot be empty"))
case c.ReadTimeout == 0:
return wrapValidationError("server", errors.New("read_timeout cannot be empty"))
case c.WriteTimeout == 0:
return wrapValidationError("server", errors.New("write_timeout cannot be empty"))
case c.IdleTimeout == 0:
return wrapValidationError("server", errors.New("idle_timeout cannot be empty"))
case c.ShutdownTimeout == 0:
return wrapValidationError("server", errors.New("shutdown_timeout name cannot be empty"))
default:
return nil
}
}
func (c *Server) loadConfig(v *viper.Viper) error {
v.SetEnvPrefix("APP")
c.Host = v.GetString("HOST")
c.Port = v.GetInt("PORT")
c.ReadTimeout = v.GetDuration("READ_TIMEOUT")
c.WriteTimeout = v.GetDuration("WRITE_TIMEOUT")
c.IdleTimeout = v.GetDuration("IDLE_TIMEOUT")
c.ShutdownTimeout = v.GetDuration("SHUTDOWN_TIMEOUT")
c.Enabled = v.GetBool("ENABLED")
return c.Validate()
}
func (c *Server) BindAddress() string {
return fmt.Sprintf("%s:%d", c.Host, c.Port)
}
func (c *Server) copy() *Server {
return &Server{
Host: c.Host,
Port: c.Port,
ReadTimeout: c.ReadTimeout,
WriteTimeout: c.WriteTimeout,
IdleTimeout: c.IdleTimeout,
ShutdownTimeout: c.ShutdownTimeout,
Enabled: c.Enabled,
}
}
+11
View File
@@ -0,0 +1,11 @@
package config
import "fmt"
func wrapValidationError(name string, err error) error {
if err == nil {
return nil
}
return fmt.Errorf("%s validation error: %w", name, err)
}
+126
View File
@@ -0,0 +1,126 @@
package dto
import (
"errors"
"net/netip"
"time"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/role"
)
// ---- Tokens ----
type UserDataInToken struct {
TokenID uuid.UUID
UserID uuid.UUID
Role role.Role
IsAccess bool
PhoneNumber *string
Email *string
ExpiresAt time.Time
IssuedAt time.Time
}
func (u UserDataInToken) Validate() error {
if u.TokenID == uuid.Nil {
return errors.New("invalid token id")
}
if u.UserID == uuid.Nil {
return errors.New("invalid user id")
}
if !u.Role.IsValid() {
return errors.New("invalid role")
}
if u.ExpiresAt.IsZero() {
return errors.New("invalid expiry")
}
if u.IssuedAt.IsZero() {
return errors.New("invalid issued")
}
return nil
}
type Token struct {
Payload string
}
type (
AccessToken Token
RefreshToken Token
)
type Tokens struct {
AccessToken AccessToken
RefreshToken RefreshToken
}
func (t AccessToken) Token() *Token {
return new(Token(t))
}
func (t RefreshToken) Token() *Token {
return new(Token(t))
}
type StoredRefreshToken struct {
ID uuid.UUID
UserID uuid.UUID
TokenHash string
UserAgent string
IPAddress netip.Addr
Role role.Role
ExpiresAt time.Time
RevokedAt *time.Time
CreatedAt time.Time
}
type RevokeRefreshToken struct {
ID uuid.UUID
RevokedAt time.Time
}
type RevokeRefreshTokensByUserID struct {
UserID uuid.UUID
RevokedAt time.Time
}
// ---- Auth ----
type Session struct {
ExpiresAt time.Time
Token string
TokenType string
User User
}
type Login struct {
Username string
Password string
}
type LoginResult struct {
ExpiresAt time.Time
TokenType string
User User
Tokens Tokens
}
// UserCredentials is internal authentication data, never a public user response.
type UserCredentials struct {
User User
PasswordHash string `json:"-"`
}
type Logout struct {
Token string
}
type Register struct {
Email string
Password string
RepeatPassword string
}
+31
View File
@@ -0,0 +1,31 @@
package dto
import (
"time"
"github.com/google/uuid"
)
type Chat struct {
ID uuid.UUID
Title string
MemberIDs []uuid.UUID
CreatedAt time.Time
}
type CreateChat struct {
CreatorID uuid.UUID
Title string
MemberIDs []uuid.UUID
}
type ChatMember struct {
UserID uuid.UUID
ChatID uuid.UUID
}
type ChatFilters struct {
UserID uuid.UUID
Limit *int
AfterID *uuid.UUID
}
+28
View File
@@ -0,0 +1,28 @@
package dto
import (
"time"
"github.com/google/uuid"
)
type Message struct {
ID uuid.UUID
ChatID uuid.UUID
SenderID uuid.UUID
Text string
CreatedAt time.Time
}
type CreateMessage struct {
ChatID uuid.UUID
SenderID uuid.UUID
Text string
}
type MessageFilters struct {
ChatID uuid.UUID
UserID uuid.UUID
Limit *int
AfterID *uuid.UUID
}
+25
View File
@@ -0,0 +1,25 @@
package dto
import (
"time"
"github.com/google/uuid"
)
// Page is a page of records with the ID to use for the next page.
type Page[T any] struct {
Items []T
NextCursorID *uuid.UUID
}
// PagePosition is a resolved database cursor, ordered by creation time and ID.
type PagePosition struct {
CreatedAt time.Time
ID uuid.UUID
}
// PageQuery is prepared by a service; Limit includes the lookahead row.
type PageQuery struct {
Limit int
After *PagePosition
}
+30
View File
@@ -0,0 +1,30 @@
package dto
import (
"time"
"github.com/google/uuid"
)
type User struct {
ID uuid.UUID
Username string
DisplayName string
CreatedAt time.Time
}
type CreateUser struct {
Username string
DisplayName string
Password string
}
// CreateStoredUser contains the prepared database record, never a plaintext password.
type CreateStoredUser struct {
ID uuid.UUID
Username string
DisplayName string
PasswordHash string `json:"-"`
CreatedAt time.Time
UpdatedAt time.Time
}
+137
View File
@@ -0,0 +1,137 @@
// Package contracts provides primitives to interact with the openapi HTTP API.
//
// Code generated by github.com/oapi-codegen/oapi-codegen/v2 version v2.5.1 DO NOT EDIT.
package contracts
import (
"time"
openapi_types "github.com/oapi-codegen/runtime/types"
)
const (
BasicAuthScopes = "basicAuth.Scopes"
BearerAuthScopes = "bearerAuth.Scopes"
)
// Defines values for ErrorErrorCode.
const (
Conflict ErrorErrorCode = "conflict"
InternalError ErrorErrorCode = "internal_error"
InvalidRequest ErrorErrorCode = "invalid_request"
NotFound ErrorErrorCode = "not_found"
PayloadTooLarge ErrorErrorCode = "payload_too_large"
RateLimited ErrorErrorCode = "rate_limited"
Unauthorized ErrorErrorCode = "unauthorized"
Unavailable ErrorErrorCode = "unavailable"
UnsupportedMediaType ErrorErrorCode = "unsupported_media_type"
)
// Defines values for HealthStatus.
const (
Ok HealthStatus = "ok"
)
// Chat defines model for Chat.
type Chat struct {
CreatedAt time.Time `json:"created_at"`
Id openapi_types.UUID `json:"id"`
MemberIds []openapi_types.UUID `json:"member_ids"`
Title string `json:"title"`
}
// ChatPage defines model for ChatPage.
type ChatPage struct {
Items []Chat `json:"items"`
NextCursor *string `json:"next_cursor"`
}
// CreateChat defines model for CreateChat.
type CreateChat struct {
MemberIds []openapi_types.UUID `json:"member_ids"`
Title string `json:"title"`
}
// CreateMessage defines model for CreateMessage.
type CreateMessage struct {
Text string `json:"text"`
}
// CreateUser defines model for CreateUser.
type CreateUser struct {
DisplayName string `json:"display_name"`
Password *string `json:"password,omitempty"`
Username string `json:"username"`
}
// Error defines model for Error.
type Error struct {
Error struct {
Code ErrorErrorCode `json:"code"`
Message string `json:"message"`
RequestId string `json:"request_id"`
} `json:"error"`
}
// ErrorErrorCode defines model for Error.Error.Code.
type ErrorErrorCode string
// Health defines model for Health.
type Health struct {
Status HealthStatus `json:"status"`
}
// HealthStatus defines model for Health.Status.
type HealthStatus string
// Message defines model for Message.
type Message struct {
ChatId openapi_types.UUID `json:"chat_id"`
CreatedAt time.Time `json:"created_at"`
Id openapi_types.UUID `json:"id"`
SenderId openapi_types.UUID `json:"sender_id"`
Text string `json:"text"`
}
// MessagePage defines model for MessagePage.
type MessagePage struct {
Items []Message `json:"items"`
NextCursor *string `json:"next_cursor"`
}
// Session defines model for Session.
type Session struct {
ExpiresAt time.Time `json:"expires_at"`
Token string `json:"token"`
TokenType string `json:"token_type"`
User User `json:"user"`
}
// User defines model for User.
type User struct {
CreatedAt time.Time `json:"created_at"`
DisplayName string `json:"display_name"`
Id openapi_types.UUID `json:"id"`
Username string `json:"username"`
}
// ListChatsParams defines parameters for ListChats.
type ListChatsParams struct {
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}
// ListMessagesParams defines parameters for ListMessages.
type ListMessagesParams struct {
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}
// CreateChatJSONRequestBody defines body for CreateChat for application/json ContentType.
type CreateChatJSONRequestBody = CreateChat
// CreateMessageJSONRequestBody defines body for CreateMessage for application/json ContentType.
type CreateMessageJSONRequestBody = CreateMessage
// RegisterUserJSONRequestBody defines body for RegisterUser for application/json ContentType.
type RegisterUserJSONRequestBody = CreateUser
+274
View File
@@ -0,0 +1,274 @@
package apperr
import (
"errors"
"net/http"
"github.com/jackc/pgerrcode"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
grpcCodes "google.golang.org/grpc/codes"
)
//go:generate stringer -type=Code -linecomment
type Code uint16
const (
// CodeBadRequest = {AppError: BAD_REQUEST, HTTP:400}
CodeBadRequest Code = iota
// CodePayloadTooLarge = {AppError: REQUEST_ENTITY_TOO_LARGE, HTTP:413}
CodePayloadTooLarge
// CodeValidation = {AppError: VALIDATION, HTTP:400}
CodeValidation
// CodeUnauthorized = {AppError: UNAUTHORIZED, HTTP:401}
CodeUnauthorized
// CodeForbidden = {AppError: FORBIDDEN, HTTP:403}
CodeForbidden
// CodeNotFound = {AppError: NOT_FOUND, HTTP:404}
CodeNotFound
// CodeAlreadyExists = {AppError: ALREADY_EXISTS, HTTP:409}
CodeAlreadyExists
// CodeConflict = {AppError: CONFLICT, HTTP:409}
CodeConflict
// CodeTooManyRequests = {AppError: TOO_MANY_REQUESTS, HTTP:429}
CodeTooManyRequests
// CodeTimeout = {AppError: TIMEOUT, HTTP:504}
CodeTimeout
// CodeInternal = {AppError: INTERNAL, HTTP:500}
CodeInternal
// CodeServiceUnavailable = {AppError: SERVICE_UNAVAILABLE, HTTP:503}
CodeServiceUnavailable
// CodeOK = {AppError: OK, HTTP:200}
CodeOK
// CodeLocked = {AppError: LOCKED, HTTP:423}
CodeLocked
// CodeUnsupportedMediaType = {AppError: UNSUPPORTED_MEDIA_TYPE, HTTP:415}
CodeUnsupportedMediaType
// CodeUnavailable = {AppError: SERVICE_UNAVAILABLE, HTTP: 503}
CodeUnavailable
)
func (c Code) HTTPStatus() int {
if status, ok := httpStatusByCode[c]; ok {
return status
}
return http.StatusInternalServerError
}
func (c Code) GRPCCode() grpcCodes.Code {
if code, ok := grpcCodeByCode[c]; ok {
return code
}
return grpcCodes.Internal
}
func (c Code) PostgresCodes() []string {
codes := postgresCodesByCode[c]
if len(codes) == 0 {
return nil
}
cp := make([]string, len(codes))
copy(cp, codes)
return cp
}
func (c Code) PostgresCode() string {
codes := c.PostgresCodes()
if len(codes) == 0 {
return ""
}
return codes[0]
}
func CodeFromError(err error) Code {
if err == nil {
return CodeInternal
}
var coded interface {
Code() Code
}
if errors.As(err, &coded) {
return coded.Code()
}
if code, ok := codeFromRedisError(err, false, false); ok {
return code
}
return CodeFromPostgresError(err)
}
func HTTPStatusFromError(err error) int {
return CodeFromError(err).HTTPStatus()
}
func GRPCCodeFromError(err error) grpcCodes.Code {
return CodeFromError(err).GRPCCode()
}
func CodeFromHTTPStatus(status int) Code {
if code, ok := codeByHTTPStatus[status]; ok {
return code
}
return CodeInternal
}
func CodeFromGRPC(code grpcCodes.Code) Code {
if appCode, ok := codeByGRPCCode[code]; ok {
return appCode
}
return CodeInternal
}
func CodeFromPostgres(pgCode string) Code {
if code, ok := codeByPostgresCode[pgCode]; ok {
return code
}
return CodeInternal
}
func CodeFromPostgresError(err error) Code {
if err == nil {
return CodeInternal
}
if code, ok := codeByPgxError[err]; ok {
return code
}
if pgErr, ok := errors.AsType[*pgconn.PgError](err); ok {
return CodeFromPostgres(pgErr.Code)
}
return CodeInternal
}
var (
httpStatusByCode = map[Code]int{
CodeBadRequest: http.StatusBadRequest,
CodeUnauthorized: http.StatusUnauthorized,
CodeForbidden: http.StatusForbidden,
CodeNotFound: http.StatusNotFound,
CodeAlreadyExists: http.StatusConflict,
CodeConflict: http.StatusConflict,
CodePayloadTooLarge: http.StatusRequestEntityTooLarge,
CodeTooManyRequests: http.StatusTooManyRequests,
CodeValidation: http.StatusBadRequest,
CodeTimeout: http.StatusGatewayTimeout,
CodeInternal: http.StatusInternalServerError,
CodeServiceUnavailable: http.StatusServiceUnavailable,
CodeUnsupportedMediaType: http.StatusUnsupportedMediaType,
CodeUnavailable: http.StatusServiceUnavailable,
CodeOK: http.StatusOK,
CodeLocked: http.StatusLocked,
}
codeByHTTPStatus = map[int]Code{
http.StatusBadRequest: CodeBadRequest,
http.StatusUnauthorized: CodeUnauthorized,
http.StatusForbidden: CodeForbidden,
http.StatusNotFound: CodeNotFound,
http.StatusConflict: CodeConflict,
http.StatusRequestEntityTooLarge: CodePayloadTooLarge,
http.StatusTooManyRequests: CodeTooManyRequests,
http.StatusUnprocessableEntity: CodeValidation,
http.StatusGatewayTimeout: CodeTimeout,
http.StatusInternalServerError: CodeInternal,
http.StatusServiceUnavailable: CodeServiceUnavailable,
http.StatusOK: CodeOK,
http.StatusLocked: CodeLocked,
http.StatusUnsupportedMediaType: CodeUnavailable,
}
grpcCodeByCode = map[Code]grpcCodes.Code{
CodeBadRequest: grpcCodes.InvalidArgument,
CodePayloadTooLarge: grpcCodes.ResourceExhausted,
CodeValidation: grpcCodes.InvalidArgument,
CodeUnauthorized: grpcCodes.Unauthenticated,
CodeForbidden: grpcCodes.PermissionDenied,
CodeNotFound: grpcCodes.NotFound,
CodeAlreadyExists: grpcCodes.AlreadyExists,
CodeConflict: grpcCodes.Aborted,
CodeTooManyRequests: grpcCodes.ResourceExhausted,
CodeTimeout: grpcCodes.DeadlineExceeded,
CodeInternal: grpcCodes.Internal,
CodeServiceUnavailable: grpcCodes.Unavailable,
CodeOK: grpcCodes.OK,
CodeLocked: grpcCodes.FailedPrecondition,
}
codeByGRPCCode = map[grpcCodes.Code]Code{
grpcCodes.InvalidArgument: CodeBadRequest,
grpcCodes.ResourceExhausted: CodeTooManyRequests,
grpcCodes.Unauthenticated: CodeUnauthorized,
grpcCodes.PermissionDenied: CodeForbidden,
grpcCodes.NotFound: CodeNotFound,
grpcCodes.AlreadyExists: CodeAlreadyExists,
grpcCodes.Aborted: CodeConflict,
grpcCodes.FailedPrecondition: CodeLocked,
grpcCodes.DeadlineExceeded: CodeTimeout,
grpcCodes.Internal: CodeInternal,
grpcCodes.Unimplemented: CodeInternal,
grpcCodes.Unavailable: CodeServiceUnavailable,
grpcCodes.OK: CodeOK,
}
postgresCodesByCode = map[Code][]string{
CodeBadRequest: {
pgerrcode.InvalidTextRepresentation,
pgerrcode.InvalidParameterValue,
},
CodeValidation: {
pgerrcode.NotNullViolation,
pgerrcode.CheckViolation,
pgerrcode.StringDataRightTruncationDataException,
pgerrcode.NumericValueOutOfRange,
},
CodeNotFound: {
pgerrcode.ForeignKeyViolation,
},
CodeAlreadyExists: {
pgerrcode.UniqueViolation,
},
CodeConflict: {
pgerrcode.ExclusionViolation,
pgerrcode.SerializationFailure,
pgerrcode.DeadlockDetected,
},
CodeLocked: {
pgerrcode.LockNotAvailable,
pgerrcode.ObjectInUse,
},
CodeTooManyRequests: {
pgerrcode.TooManyConnections,
},
CodeTimeout: {
pgerrcode.QueryCanceled,
},
CodeInternal: {
pgerrcode.ConnectionException,
pgerrcode.ConnectionFailure,
pgerrcode.SQLClientUnableToEstablishSQLConnection,
pgerrcode.SQLServerRejectedEstablishmentOfSQLConnection,
pgerrcode.TransactionResolutionUnknown,
},
CodeServiceUnavailable: {
pgerrcode.CannotConnectNow,
},
}
codeByPostgresCode = buildCodeByPostgresCode(postgresCodesByCode)
codeByPgxError = map[error]Code{
pgx.ErrNoRows: CodeNotFound,
pgx.ErrTxClosed: CodeInternal,
pgx.ErrTxCommitRollback: CodeConflict,
pgx.ErrTooManyRows: CodeInternal,
}
)
func buildCodeByPostgresCode(src map[Code][]string) map[string]Code {
dst := make(map[string]Code, len(src))
for code, pgCodes := range src {
for _, pgCode := range pgCodes {
dst[pgCode] = code
}
}
return dst
}
@@ -0,0 +1,37 @@
// Code generated by "stringer -type=Code -linecomment"; DO NOT EDIT.
package apperr
import "strconv"
func _() {
// An "invalid array index" compiler error signifies that the constant values have changed.
// Re-run the stringer command to generate them again.
var x [1]struct{}
_ = x[CodeBadRequest-0]
_ = x[CodePayloadTooLarge-1]
_ = x[CodeValidation-2]
_ = x[CodeUnauthorized-3]
_ = x[CodeForbidden-4]
_ = x[CodeNotFound-5]
_ = x[CodeAlreadyExists-6]
_ = x[CodeConflict-7]
_ = x[CodeTooManyRequests-8]
_ = x[CodeTimeout-9]
_ = x[CodeInternal-10]
_ = x[CodeServiceUnavailable-11]
_ = x[CodeOK-12]
_ = x[CodeLocked-13]
}
const _Code_name = "CodeBadRequestCodePayloadTooLargeCodeValidationCodeUnauthorizedCodeForbiddenCodeNotFoundCodeAlreadyExistsCodeConflictCodeTooManyRequestsCodeTimeoutCodeInternalCodeServiceUnavailableCodeOKCodeLocked"
var _Code_index = [...]uint8{0, 14, 33, 47, 63, 76, 88, 105, 117, 136, 147, 159, 181, 187, 197}
func (i Code) String() string {
idx := int(i) - 0
if i < 0 || idx >= len(_Code_index)-1 {
return "Code(" + strconv.FormatInt(int64(i), 10) + ")"
}
return _Code_name[_Code_index[idx]:_Code_index[idx+1]]
}
+123
View File
@@ -0,0 +1,123 @@
package apperr
import (
"errors"
"fmt"
grpcCodes "google.golang.org/grpc/codes"
)
type AppError struct {
err error
msg string
code Code
meta metadata
}
func New(code Code, msg string) error {
return &AppError{
msg: msg,
code: code,
meta: metadata{},
}
}
func Wrap(err error, code Code, msg string) error {
m := AppError{
err: err,
msg: msg,
code: code,
meta: metadata{},
}
return &m
}
func WrapAppError(err error, msg string) error {
m := AppError{
err: err,
msg: msg,
code: CodeInternal,
meta: metadata{},
}
if mistake := As(err); mistake != nil {
m.err = mistake
m.code = mistake.code
m.meta = mistake.meta
}
return &m
}
func As(err error) *AppError {
if mistakeErr, ok := errors.AsType[*AppError](err); ok {
return mistakeErr
}
return nil
}
func CodeIs(err error, code Code) bool {
if appErr := As(err); appErr != nil && appErr.Code() == code {
return true
}
return false
}
func (e *AppError) Error() string {
if e == nil {
return ""
}
if e.err == nil {
if e.msg != "" {
return e.msg
}
return e.code.String()
}
if e.msg == "" {
return e.err.Error()
}
return fmt.Sprintf("%s: %s", e.msg, e.err.Error())
}
func (e *AppError) Unwrap() error {
if e == nil {
return nil
}
return e.err
}
func (e *AppError) Code() Code {
if e == nil {
return CodeInternal
}
return e.code
}
func (e *AppError) Message() string {
if e == nil {
return ""
}
return e.msg
}
func (e *AppError) Cause() error {
if e == nil {
return nil
}
return e.err
}
func (e *AppError) Metadata() Metadata {
return e.meta
}
func (e *AppError) HTTPStatus() int {
return e.Code().HTTPStatus()
}
func (e *AppError) GRPCCode() grpcCodes.Code {
return e.Code().GRPCCode()
}
+42
View File
@@ -0,0 +1,42 @@
package apperr
import (
"fmt"
"maps"
"strings"
)
var _ Metadata = (*metadata)(nil)
type Metadata interface {
Get(key metakey) string
Clone() map[metakey]string
CloneToAnyMap() map[string]any
String() string
}
type metadata map[metakey]string
func (m metadata) Get(key metakey) string {
return m[key]
}
func (m metadata) Clone() map[metakey]string {
return maps.Clone(m)
}
func (m metadata) CloneToAnyMap() map[string]any {
newM := make(map[string]any, len(m))
for k, v := range m {
newM[k.String()] = v
}
return newM
}
func (m metadata) String() string {
var b strings.Builder
for k, v := range m {
b.WriteString(fmt.Sprintf("%s: %s, ", k, v))
}
return b.String()
}
+19
View File
@@ -0,0 +1,19 @@
package apperr
type metakey uint16
const (
PgErrorCode metakey = iota
RedisErrorCode
)
func (m metakey) String() string {
switch m {
case PgErrorCode:
return "pg_err_code"
case RedisErrorCode:
return "redis_err_code"
default:
return "unknown"
}
}
+81
View File
@@ -0,0 +1,81 @@
package apperr
import (
"context"
"errors"
"fmt"
"io"
"net"
"strings"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
)
func WrapPostgres(err error, msg string) error {
m := AppError{
err: err,
msg: msg,
code: CodeInternal,
meta: metadata{},
}
m.handlePostgres()
return &m
}
func (e *AppError) handlePostgres() {
if e.err == nil {
e.code = CodeOK
return
}
var networkError net.Error
var connectError *pgconn.ConnectError
if errors.Is(e.err, context.DeadlineExceeded) || errors.Is(e.err, io.EOF) ||
errors.Is(e.err, io.ErrUnexpectedEOF) || errors.As(e.err, &networkError) || errors.As(e.err, &connectError) {
e.code = CodeServiceUnavailable
e.msg = "database unavailable"
return
}
if pgErr, ok := errors.AsType[*pgconn.PgError](e.err); ok {
if strings.HasPrefix(pgErr.Code, "08") || pgErr.Code == "57014" ||
pgErr.Code == "57P01" || pgErr.Code == "57P02" || pgErr.Code == "57P03" || pgErr.Code == "53300" {
e.code = CodeServiceUnavailable
e.msg = "database unavailable"
return
}
e.meta[PgErrorCode] = pgErr.Code
e.code = CodeFromPostgres(pgErr.Code)
return
}
switch {
case errors.Is(e.err, pgx.ErrNoRows):
e.msg = fmt.Sprintf("not found: %s", e.msg)
e.code = CodeNotFound
return
case errors.Is(e.err, pgx.ErrTooManyRows):
e.msg = fmt.Sprintf("got too many rows: %s", e.msg)
e.code = CodeInternal
return
case errors.Is(e.err, pgx.ErrTxClosed):
e.msg = fmt.Sprintf("transaction is closed: %s", e.msg)
e.code = CodeInternal
return
case errors.Is(e.err, pgx.ErrTxCommitRollback):
e.msg = fmt.Sprintf("transaction commit resulted in rollback: %s", e.msg)
e.code = CodeInternal
return
}
}
func (e *AppError) PgCode() string {
if e == nil {
return ""
}
if e.meta == nil {
return ""
}
return e.meta.Get(PgErrorCode)
}
+170
View File
@@ -0,0 +1,170 @@
package apperr
import (
"context"
"errors"
"fmt"
"net"
"strings"
"github.com/redis/go-redis/v9"
)
func WrapRedis(err error, msg string) error {
m := AppError{
err: err,
msg: msg,
meta: metadata{},
}
m.handleRedis()
return &m
}
func CodeFromRedisError(err error) Code {
code, ok := codeFromRedisError(err, true, true)
if !ok {
return CodeInternal
}
return code
}
func (e *AppError) handleRedis() {
if e.err == nil {
e.code = CodeOK
return
}
if code := redisErrorCode(e.err); code != "" {
e.meta[RedisErrorCode] = code
}
if errors.Is(e.err, redis.Nil) {
e.msg = fmt.Sprintf("not found: %s", e.msg)
}
e.code = CodeFromRedisError(e.err)
}
func (e *AppError) RedisCode() string {
if e == nil {
return ""
}
if e.meta == nil {
return ""
}
return e.meta.Get(RedisErrorCode)
}
func codeFromRedisError(err error, includeTransport bool, includeProtocolString bool) (Code, bool) {
if err == nil {
return CodeInternal, false
}
switch {
case errors.Is(err, redis.Nil):
return CodeNotFound, true
case errors.Is(err, redis.TxFailedErr):
return CodeConflict, true
case errors.Is(err, redis.ErrCrossSlot):
return CodeBadRequest, true
case errors.Is(err, redis.ErrPoolTimeout):
return CodeTimeout, true
case errors.Is(err, redis.ErrPoolExhausted):
return CodeTooManyRequests, true
case errors.Is(err, redis.ErrClosed):
return CodeServiceUnavailable, true
}
if includeTransport {
if errors.Is(err, context.Canceled) ||
errors.Is(err, context.DeadlineExceeded) {
return CodeTimeout, true
}
if netErr, ok := errors.AsType[net.Error](err); ok {
if netErr.Timeout() {
return CodeTimeout, true
}
return CodeServiceUnavailable, true
}
}
hasRedisError := isRedisError(err)
if !hasRedisError && !includeProtocolString {
return CodeInternal, false
}
switch {
case redis.IsExecAbortError(err):
return CodeConflict, true
case redis.IsMaxClientsError(err):
return CodeTooManyRequests, true
case redis.IsLoadingError(err),
redis.IsReadOnlyError(err),
redis.IsClusterDownError(err),
redis.IsTryAgainError(err),
redis.IsMasterDownError(err),
redis.IsNoReplicasError(err),
redis.IsOOMError(err):
return CodeServiceUnavailable, true
case redis.IsAuthError(err),
redis.IsPermissionError(err):
return CodeInternal, true
}
if _, ok := redis.IsMovedError(err); ok {
return CodeServiceUnavailable, true
}
if _, ok := redis.IsAskError(err); ok {
return CodeServiceUnavailable, true
}
if hasRedisError {
return CodeInternal, true
}
return CodeInternal, false
}
func isRedisError(err error) bool {
if err == nil {
return false
}
var redisErr redis.Error
return errors.As(err, &redisErr)
}
func redisErrorCode(err error) string {
switch {
case err == nil:
return ""
case errors.Is(err, redis.Nil):
return "nil"
case errors.Is(err, redis.TxFailedErr):
return "tx_failed"
case errors.Is(err, redis.ErrCrossSlot):
return "CROSSSLOT"
case errors.Is(err, redis.ErrPoolTimeout):
return "pool_timeout"
case errors.Is(err, redis.ErrPoolExhausted):
return "pool_exhausted"
case errors.Is(err, redis.ErrClosed):
return "closed"
}
var redisErr redis.Error
if !errors.As(err, &redisErr) {
return ""
}
msg := strings.TrimSpace(redisErr.Error())
msg = strings.TrimPrefix(msg, "ERR ")
parts := strings.Fields(msg)
if len(parts) == 0 {
return ""
}
return parts[0]
}
@@ -0,0 +1,145 @@
package jwtprovider
import (
"fmt"
"log/slog"
"time"
"github.com/golang-jwt/jwt/v5"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/role"
)
var _ Claims = (*jwtClaims)(nil)
type Claims interface {
GetTopTokenID() (uuid.UUID, bool)
GetTopUserID() (uuid.UUID, bool)
GetTopRole() (role.Role, bool)
GetTopIsAccess() (bool, bool)
GetTopExpiresAt() (time.Time, bool)
GetTopIssuedAt() (time.Time, bool)
}
type claimsParseFunc func(token *dto.Token) (*jwtClaims, error)
type jwtClaims struct {
jwt.RegisteredClaims
Nonce string `json:"nonce,omitempty"`
IsAccess bool `json:"is_access"`
Role role.Role `json:"role"`
}
func (claims *jwtClaims) GetTopTokenID() (uuid.UUID, bool) {
parsed, err := uuid.Parse(claims.ID)
if err != nil {
return uuid.Nil, false
}
return parsed, true
}
func (claims *jwtClaims) GetTopUserID() (uuid.UUID, bool) {
parsed, err := uuid.Parse(claims.Subject)
if err != nil {
return uuid.Nil, false
}
return parsed, true
}
func (claims *jwtClaims) GetTopRole() (role.Role, bool) {
return claims.Role, true
}
func (claims *jwtClaims) GetTopIsAccess() (bool, bool) {
return claims.IsAccess, true
}
func (claims *jwtClaims) GetTopExpiresAt() (time.Time, bool) {
if claims.ExpiresAt == nil {
return time.Time{}, false
}
return claims.ExpiresAt.Time, true
}
func (claims *jwtClaims) GetTopIssuedAt() (time.Time, bool) {
if claims.IssuedAt == nil {
return time.Time{}, false
}
return claims.IssuedAt.Time, true
}
func (claims *jwtClaims) userData() (*dto.UserDataInToken, error) {
var u dto.UserDataInToken
tokenID, err := uuid.Parse(claims.ID)
if err != nil {
return nil, fmt.Errorf("failed to parse token id: %w", err)
}
u.TokenID = tokenID
userID, err := uuid.Parse(claims.Subject)
if err != nil {
return nil, fmt.Errorf("failed to parse user id from token %q: %w", claims.Subject, err)
}
u.UserID = userID
u.Role = claims.Role
u.IsAccess = claims.IsAccess
if claims.ExpiresAt != nil {
u.ExpiresAt = claims.ExpiresAt.Time
}
if claims.IssuedAt != nil {
u.IssuedAt = claims.IssuedAt.Time
}
return &u, nil
}
func (p *provider) parseClaimsFromProtectedJWT(token *dto.Token) (*jwtClaims, error) {
if token == nil {
return nil, ErrTokenIsMissing
}
claims := &jwtClaims{}
parsed, err := jwt.ParseWithClaims(
token.Payload,
claims,
p.readKeyFunc,
jwt.WithValidMethods([]string{jwt.SigningMethodRS256.Alg()}),
jwt.WithExpirationRequired(),
jwt.WithIssuedAt(),
)
if err != nil {
slog.Error("failed to parse token with claims", "error", err)
return nil, ErrInvalidToken
}
if !parsed.Valid {
slog.Error("failed to parse token: provided invalid token", "valid", parsed.Valid)
return nil, ErrInvalidToken
}
return claims, nil
}
func (p *provider) parseClaimsFromExposedJWT(token *dto.Token) (*jwtClaims, error) {
if token == nil {
return nil, ErrTokenIsMissing
}
claims := &jwtClaims{}
_, _, err := new(jwt.Parser).ParseUnverified(token.Payload, claims)
if err != nil {
slog.Error("failed to parse token: provided invalid token")
return nil, ErrInvalidToken
}
return claims, nil
}
@@ -0,0 +1,84 @@
package jwtprovider
import (
"net/http"
)
const (
accessTokenCookieKey = "auth-access-token"
refreshTokenCookieKey = "auth-refresh-token"
expiresAtCookieKey = "auth-exp"
)
type CookieBuilderFabric struct {
fabric func() http.Cookie
}
func newCookieBuilder(
domain string,
path string,
secure bool,
sameSite http.SameSite,
) *CookieBuilderFabric {
return &CookieBuilderFabric{
fabric: newCookieFabric(domain, path, secure, sameSite),
}
}
func (b *CookieBuilderFabric) Builder() *CookieBuilder {
return &CookieBuilder{
cookie: b.fabric(),
}
}
func newCookieFabric(
_ string,
path string,
secure bool,
sameSite http.SameSite) func() http.Cookie {
return func() http.Cookie {
return http.Cookie{
Path: path,
Secure: secure,
SameSite: sameSite,
}
}
}
type CookieBuilder struct {
cookie http.Cookie
}
func (b *CookieBuilder) AccessName() *CookieBuilder {
b.cookie.Name = accessTokenCookieKey
return b
}
func (b *CookieBuilder) ExpiresName() *CookieBuilder {
b.cookie.Name = expiresAtCookieKey
return b
}
func (b *CookieBuilder) RefreshName() *CookieBuilder {
b.cookie.Name = refreshTokenCookieKey
return b
}
func (b *CookieBuilder) Value(value string) *CookieBuilder {
b.cookie.Value = value
return b
}
func (b *CookieBuilder) HTTPOnly() *CookieBuilder {
b.cookie.HttpOnly = true
return b
}
func (b *CookieBuilder) MaxAge(maxAge int) *CookieBuilder {
b.cookie.MaxAge = maxAge
return b
}
func (b *CookieBuilder) Build() *http.Cookie {
return new(b.cookie)
}
@@ -0,0 +1,18 @@
package jwtprovider
import (
"errors"
)
var (
ErrDecode = errors.New("failed to decode argument")
ErrNotFound = errors.New("not found")
ErrUnexpectedAlgorithm = errors.New("unexpected signing algorithm")
ErrTokenIsMissing = errors.New("token is missing")
ErrInvalidToken = errors.New("provided invalid token")
ErrInvalidUserDataInToken = errors.New("invalid user data in token")
ErrInvalidTokenClaims = errors.New("provided invalid token claims")
ErrInvalidBirthDateFormat = errors.New("provided invalid birth date format")
ErrTokenExpired = errors.New("token is expired")
ErrFailedToSign = errors.New("failed to sign jwt")
)
@@ -0,0 +1,26 @@
package jwtprovider
import (
"net/http"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/role"
)
type Provider interface {
Parse(token *dto.Token) (*dto.UserDataInToken, error)
CreateRefreshAndAccessTokensForUser(userID uuid.UUID, role role.Role) (*dto.Tokens, error)
ParseVerified(token *dto.Token) (*dto.UserDataInToken, error)
ParseUnverified(token *dto.Token) (*dto.UserDataInToken, error)
ValidateUserDataInToken(u *dto.UserDataInToken) error
}
type Cookie interface {
Enabled() bool
Set(w http.ResponseWriter, tokens *dto.Tokens)
Clear(w http.ResponseWriter)
AccessToken(r *http.Request) *dto.AccessToken
RefreshToken(r *http.Request) *dto.RefreshToken
}
@@ -0,0 +1,199 @@
package jwtprovider
import (
"fmt"
"net/http"
"strconv"
"time"
"gitea.privcloud.tech/mtusi2026/internal/config"
"gitea.privcloud.tech/mtusi2026/internal/dto"
)
type manager struct {
enabled bool
cookieFabric *CookieBuilderFabric
prv Provider
}
func NewCookieManager(cfg *config.Config, provider Provider) Cookie {
m := &manager{
//enabled: cfg.Cookies.Enabled,
//cookieFabric: newCookieBuilder(
// cfg.Cookies.Domain,
// cfg.Cookies.Path,
// cfg.Cookies.Secure,
// cfg.Cookies.SameSite,
//),
prv: provider,
}
if !m.enabled {
return m
}
if err := m.cookieFabric.
Builder().
AccessName().
Value("test").
HTTPOnly().
MaxAge(0).
Build().
Valid(); err != nil {
panic(fmt.Errorf("cookie validation failed: %w", err))
}
return m
}
func (m *manager) Enabled() bool {
return m.enabled
}
func (m *manager) Set(w http.ResponseWriter, tokens *dto.Tokens) {
if !m.enabled || tokens == nil {
return
}
if tokens.AccessToken.Payload != "" {
m.setAccess(tokens.AccessToken, w)
}
if tokens.RefreshToken.Payload != "" {
m.setRefresh(tokens.RefreshToken, w)
}
}
func (m *manager) Clear(w http.ResponseWriter) {
if !m.enabled {
return
}
for _, name := range []string{accessTokenCookieKey, refreshTokenCookieKey, expiresAtCookieKey} {
b := m.cookieFabric.
Builder().
MaxAge(-1)
switch name {
case expiresAtCookieKey:
b.ExpiresName()
case refreshTokenCookieKey:
b.RefreshName().
HTTPOnly()
case accessTokenCookieKey:
b.AccessName().
HTTPOnly()
}
http.SetCookie(w, b.Build())
}
}
func (m *manager) AccessToken(r *http.Request) *dto.AccessToken {
if !m.enabled {
return nil
}
c, err := r.Cookie(accessTokenCookieKey)
if err != nil {
return nil
}
return &dto.AccessToken{
Payload: c.Value,
}
}
func (m *manager) RefreshToken(r *http.Request) *dto.RefreshToken {
if !m.enabled {
return nil
}
c, err := r.Cookie(refreshTokenCookieKey)
if err != nil {
return nil
}
return &dto.RefreshToken{
Payload: c.Value,
}
}
func (m *manager) setAccess(token dto.AccessToken, w http.ResponseWriter) {
accessTTL := m.tokenTTL(token.Token())
if accessTTL < 0 {
http.SetCookie(w, m.cookieFabric.
Builder().
AccessName().
HTTPOnly().
MaxAge(-1).
Build(),
)
http.SetCookie(w, m.cookieFabric.
Builder().
ExpiresName().
MaxAge(-1).
Build(),
)
} else if tokenExpiresAt := m.tokenExpiry(token.Token()); !tokenExpiresAt.IsZero() {
http.SetCookie(w, m.cookieFabric.
Builder().
AccessName().
Value(token.Payload).
HTTPOnly().
MaxAge(accessTTL).
Build(),
)
http.SetCookie(w, m.cookieFabric.
Builder().
ExpiresName().
Value(strconv.FormatInt(tokenExpiresAt.Unix(), 10)).
MaxAge(accessTTL).
Build(),
)
}
}
func (m *manager) setRefresh(token dto.RefreshToken, w http.ResponseWriter) {
refreshTTL := m.tokenTTL(token.Token())
if refreshTTL < 0 {
http.SetCookie(w, m.cookieFabric.
Builder().
RefreshName().
HTTPOnly().
MaxAge(-1).
Build(),
)
} else {
http.SetCookie(w, m.cookieFabric.
Builder().
RefreshName().
Value(token.Payload).
HTTPOnly().
MaxAge(refreshTTL).
Build(),
)
}
}
func (m *manager) tokenTTL(token *dto.Token) int {
expiresAt := m.tokenExpiry(token)
if expiresAt.IsZero() {
return -1
}
ttl := int(time.Until(expiresAt).Seconds())
if ttl <= 0 {
return -1
}
return ttl
}
func (m *manager) tokenExpiry(token *dto.Token) time.Time {
data, err := m.prv.ParseUnverified(token)
if err != nil {
return time.Time{}
}
return data.ExpiresAt
}
@@ -0,0 +1,187 @@
package jwtprovider
import (
"crypto/rand"
"crypto/rsa"
"encoding/base64"
"fmt"
"log/slog"
"time"
"github.com/golang-jwt/jwt/v5"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/config"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/environment"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/role"
)
var (
_ Provider = (*provider)(nil)
)
type provider struct {
accessLifetime time.Duration
refreshLifetime time.Duration
publicKey *rsa.PublicKey
privateKey *rsa.PrivateKey
parseFunc claimsParseFunc
}
func New(cfg *config.Config) Provider {
p := provider{
accessLifetime: cfg.JWT.AccessTokenLifetime,
refreshLifetime: cfg.JWT.RefreshTokenLifetime,
}
p.parseFunc = p.parseClaimsFromProtectedJWT
if cfg.Application.Environment == environment.ApplicationEnvironmentDev {
p.parseFunc = p.parseClaimsFromExposedJWT
}
var err error
if p.publicKey, err = readPublicKeyFromFile(cfg.JWT.PublicKeyPath); err != nil {
slog.Error("failed to read public key", "error", err)
panic(fmt.Errorf("failed to read public key: %w", err))
}
if p.privateKey, err = readPrivateKeyFromFile(cfg.JWT.PrivateKeyPath); err != nil {
slog.Error("failed to read private key", "error", err)
panic(fmt.Errorf("failed to read private key: %w", err))
}
return &p
}
func (p *provider) Parse(token *dto.Token) (*dto.UserDataInToken, error) {
claims, err := p.parseFunc(token)
if err != nil {
return nil, err
}
return claims.userData()
}
func (p *provider) ParseUnverified(t *dto.Token) (*dto.UserDataInToken, error) {
if t == nil {
return nil, ErrTokenIsMissing
}
claims, err := p.parseClaimsFromExposedJWT(t)
if err != nil {
return nil, err
}
return claims.userData()
}
func (p *provider) ParseVerified(t *dto.Token) (*dto.UserDataInToken, error) {
if t == nil {
return nil, ErrTokenIsMissing
}
claims, err := p.parseClaimsFromProtectedJWT(t)
if err != nil {
return nil, fmt.Errorf("failed to parse token: %w", err)
}
return claims.userData()
}
func (p *provider) CreateAccessTokenForUser(userID uuid.UUID, role role.Role) (*dto.AccessToken, error) {
t, err := p.createTokenForUser(userID, true, role)
if err != nil {
return nil, err
}
return &dto.AccessToken{
Payload: t.Payload,
}, nil
}
func (p *provider) CreateRefreshTokenForUser(userID uuid.UUID, role role.Role) (*dto.RefreshToken, error) {
t, err := p.createTokenForUser(userID, false, role)
if err != nil {
return nil, err
}
return &dto.RefreshToken{
Payload: t.Payload,
}, nil
}
func (p *provider) CreateRefreshAndAccessTokensForUser(userID uuid.UUID, role role.Role) (*dto.Tokens, error) {
access, err := p.CreateAccessTokenForUser(userID, role)
if err != nil {
return nil, err
}
refresh, err := p.CreateRefreshTokenForUser(userID, role)
if err != nil {
return nil, err
}
return &dto.Tokens{
AccessToken: *access,
RefreshToken: *refresh,
}, nil
}
func (p *provider) createTokenForUser(userID uuid.UUID, isAccess bool, role role.Role) (*dto.Token, error) {
now := time.Now()
var tokenExpiresAt time.Time
if isAccess {
tokenExpiresAt = now.Add(p.accessLifetime)
} else {
tokenExpiresAt = now.Add(p.refreshLifetime)
}
var nonce [32]byte
if _, err := rand.Read(nonce[:]); err != nil {
return nil, fmt.Errorf("generate token nonce: %w", err)
}
claims := &jwtClaims{
Nonce: base64.RawURLEncoding.EncodeToString(nonce[:]),
RegisteredClaims: jwt.RegisteredClaims{
Subject: userID.String(),
ExpiresAt: jwt.NewNumericDate(tokenExpiresAt),
NotBefore: jwt.NewNumericDate(now),
IssuedAt: jwt.NewNumericDate(now),
ID: uuid.NewString(),
},
IsAccess: isAccess,
Role: role,
}
t := jwt.NewWithClaims(jwt.SigningMethodRS256, claims)
payload, err := t.SignedString(p.privateKey)
if err != nil {
slog.Error("failed to sign jwt", "error", err)
return nil, ErrFailedToSign
}
return &dto.Token{Payload: payload}, nil
}
// TODO refactor maybe delete
func (p *provider) ValidateUserDataInToken(u *dto.UserDataInToken) error {
if u == nil {
return ErrInvalidUserDataInToken
}
switch {
case u.TokenID == uuid.Nil:
return fmt.Errorf("%w: unexpected nil token id", ErrInvalidUserDataInToken)
case u.UserID == uuid.Nil:
return fmt.Errorf("%w: unexpected nil user id", ErrInvalidUserDataInToken)
case u.IssuedAt.IsZero():
return fmt.Errorf("%w: unexpected zero issued at", ErrInvalidUserDataInToken)
case u.Email != nil && *u.Email == "":
return fmt.Errorf("%w: unexpected empty email", ErrInvalidUserDataInToken)
case u.PhoneNumber != nil && *u.PhoneNumber == "":
return fmt.Errorf("%w: unexpected empty phone number", ErrInvalidUserDataInToken)
case u.ExpiresAt.IsZero():
return fmt.Errorf("%w: unexpected zero expires at", ErrInvalidUserDataInToken)
}
return nil
}
func (p *provider) readKeyFunc(token *jwt.Token) (interface{}, error) {
if token.Method != jwt.SigningMethodRS256 {
return nil, fmt.Errorf("unexpected signing method: %v", token.Header["alg"])
}
return p.publicKey, nil
}
@@ -0,0 +1,35 @@
package jwtprovider
import (
"crypto/rsa"
"fmt"
"os"
"github.com/golang-jwt/jwt/v5"
)
func readPrivateKeyFromFile(path string) (*rsa.PrivateKey, error) {
key, err := os.ReadFile(path)
if err != nil {
return nil, fmt.Errorf("failed to read public key: %w", err)
}
privateKey, err := jwt.ParseRSAPrivateKeyFromPEM(key)
if err != nil {
return nil, fmt.Errorf("failed to parse private key: %w", err)
}
return privateKey, nil
}
func readPublicKeyFromFile(path string) (*rsa.PublicKey, error) {
key, err := os.ReadFile(path)
if err != nil {
return nil, fmt.Errorf("failed to read public key: %w", err)
}
privateKey, err := jwt.ParseRSAPublicKeyFromPEM(key)
if err != nil {
return nil, fmt.Errorf("failed to parse private key: %w", err)
}
return privateKey, nil
}
+43
View File
@@ -0,0 +1,43 @@
package cache
import (
"context"
"time"
"github.com/redis/go-redis/v9"
"gitea.privcloud.tech/mtusi2026/internal/config"
)
const defaultRedisPort = 6379
// OperationTimeout bounds each optional cache operation independently of the request.
const OperationTimeout = 300 * time.Millisecond
type Client struct {
*redis.Client
}
func New(cfg *config.Config) *Client {
if cfg.Redis.Port == 0 {
cfg.Redis.Port = defaultRedisPort
}
return &Client{
Client: redis.NewClient(cfg.Redis.BuildRedisOptions()),
}
}
func (c *Client) Ping(ctx context.Context) error {
ctx, cancel := context.WithTimeout(ctx, OperationTimeout)
defer cancel()
return c.Client.Ping(ctx).Err()
}
func (c *Client) Start(ctx context.Context) error {
return c.Ping(ctx)
}
func (c *Client) Stop(_ context.Context) error {
return c.Client.Close()
}
@@ -0,0 +1,71 @@
package encrypting
import (
"context"
"crypto/rand"
"crypto/subtle"
"encoding/base64"
"fmt"
"strings"
"golang.org/x/crypto/argon2"
)
const (
argon2idMemory = 64 * 1024 // KiB
argon2idTime = 3
argon2idThreads = 4
argon2idSaltLen = 16
argon2idKeyLen = 32
// Only this bounded profile is accepted; stored parameters cannot request arbitrary resources.
argon2idPrefix = "$argon2id$v=19$m=65536,t=3,p=4$"
)
func (e *encryptor) EncryptSecretUsingArgon2id(ctx context.Context, secret string) (string, error) {
if err := ctx.Err(); err != nil {
return "", err
}
var salt [argon2idSaltLen]byte
if _, err := rand.Read(salt[:]); err != nil {
return "", fmt.Errorf("%w: %w", ErrFailedToEncryptPassword, err)
}
key := argon2.IDKey([]byte(secret), salt[:], argon2idTime, argon2idMemory, argon2idThreads, argon2idKeyLen)
if err := ctx.Err(); err != nil {
return "", err
}
return argon2idPrefix + base64.RawStdEncoding.EncodeToString(salt[:]) + "$" + base64.RawStdEncoding.EncodeToString(key), nil
}
func (e *encryptor) CompareHashAndSecretUsingArgon2id(ctx context.Context, hash, secret string) error {
if err := ctx.Err(); err != nil {
return err
}
encoding := base64.RawStdEncoding.Strict()
if len(hash) != len(argon2idPrefix)+encoding.EncodedLen(argon2idSaltLen)+1+encoding.EncodedLen(argon2idKeyLen) {
return ErrFailedToComparePasswords
}
payload, ok := strings.CutPrefix(hash, argon2idPrefix)
if !ok {
return ErrFailedToComparePasswords
}
saltText, keyText, ok := strings.Cut(payload, "$")
if !ok {
return ErrFailedToComparePasswords
}
salt, err := encoding.DecodeString(saltText)
if err != nil || len(salt) != argon2idSaltLen {
return ErrFailedToComparePasswords
}
storedKey, err := encoding.DecodeString(keyText)
if err != nil || len(storedKey) != argon2idKeyLen {
return ErrFailedToComparePasswords
}
key := argon2.IDKey([]byte(secret), salt, argon2idTime, argon2idMemory, argon2idThreads, argon2idKeyLen)
if err = ctx.Err(); err != nil {
return err
}
if subtle.ConstantTimeCompare(storedKey, key) != 1 {
return ErrFailedToComparePasswords
}
return nil
}
@@ -0,0 +1,57 @@
package encrypting
import (
"context"
"crypto/sha256"
"encoding/hex"
"golang.org/x/crypto/bcrypt"
)
type encryptor struct {
cost int
generateFromPasswordFunc func([]byte, int) ([]byte, error)
compareHashAndPasswordFunc func([]byte, []byte) error
}
func New() Encryptor {
return &encryptor{
cost: bcrypt.DefaultCost,
generateFromPasswordFunc: bcrypt.GenerateFromPassword,
compareHashAndPasswordFunc: bcrypt.CompareHashAndPassword,
}
}
func (e *encryptor) EncryptSecret(_ context.Context, secret string) (string, error) {
res, err := e.generateFromPasswordFunc([]byte(secret), e.cost)
if err != nil {
return "", ErrFailedToEncryptPassword
}
return string(res), nil
}
func (e *encryptor) EncryptSecretUsingSum256(_ context.Context, secret string) (string, error) {
sum := sha256.Sum256([]byte(secret))
res, err := e.generateFromPasswordFunc([]byte(hex.EncodeToString(sum[:])), e.cost)
if err != nil {
return "", ErrFailedToEncryptPassword
}
return string(res), nil
}
func (e *encryptor) CompareHashAndSecret(_ context.Context, hash, password string) error {
err := e.compareHashAndPasswordFunc([]byte(hash), []byte(password))
if err != nil {
return ErrFailedToComparePasswords
}
return nil
}
func (e *encryptor) CompareHashAndSecretUsingSum256(_ context.Context, hash, password string) error {
sum := sha256.Sum256([]byte(password))
err := e.compareHashAndPasswordFunc([]byte(hash), []byte(hex.EncodeToString(sum[:])))
if err != nil {
return ErrFailedToComparePasswords
}
return nil
}
+8
View File
@@ -0,0 +1,8 @@
package encrypting
import "errors"
var (
ErrFailedToEncryptPassword = errors.New("failed to encrypt password")
ErrFailedToComparePasswords = errors.New("failed to compare passwords")
)
@@ -0,0 +1,12 @@
package encrypting
import "context"
type Encryptor interface {
EncryptSecretUsingArgon2id(ctx context.Context, secret string) (string, error)
CompareHashAndSecretUsingArgon2id(ctx context.Context, hash, secret string) error
EncryptSecret(ctx context.Context, secret string) (string, error)
EncryptSecretUsingSum256(_ context.Context, secret string) (string, error)
CompareHashAndSecret(ctx context.Context, hash, secret string) error
CompareHashAndSecretUsingSum256(ctx context.Context, hash, secret string) error
}
+164
View File
@@ -0,0 +1,164 @@
package migrator
import (
"context"
"io/fs"
"log/slog"
"github.com/jackc/pgx/v5"
"github.com/jackc/tern/v2/migrate"
"gitea.privcloud.tech/mtusi2026/internal/config"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/migrations"
)
type Migrator interface {
MigrateUp(ctx context.Context) error
MigrateDown(ctx context.Context) error
MigrateTo(ctx context.Context, version int32) error
GetVersion(ctx context.Context) (int32, error)
Configure(ctx context.Context) error
Close(ctx context.Context) error
Start(ctx context.Context) error
Stop(ctx context.Context) error
}
type migrator struct {
cfg *config.Config
conn *pgx.Conn
migrator *migrate.Migrator
migrations fs.FS
configured bool
closed bool
}
func New(cfg *config.Config) Migrator {
return &migrator{
cfg: cfg,
conn: nil,
migrator: nil,
migrations: migrations.Migrations,
configured: false,
closed: false,
}
}
func (m *migrator) MigrateUp(ctx context.Context) error {
if !m.configured {
return apperr.New(apperr.CodeInternal, "migrator was not configured")
}
return m.migrator.Migrate(ctx)
}
func (m *migrator) MigrateDown(ctx context.Context) error {
if !m.configured {
return apperr.New(apperr.CodeInternal, "migrator was not configured")
}
return m.migrator.MigrateTo(ctx, 0)
}
func (m *migrator) MigrateTo(ctx context.Context, version int32) error {
if !m.configured {
return apperr.New(apperr.CodeInternal, "migrator was not configured")
}
return m.migrator.MigrateTo(ctx, version)
}
func (m *migrator) GetVersion(ctx context.Context) (int32, error) {
if !m.configured {
return -1, apperr.New(apperr.CodeInternal, "migrator was not configured")
}
return m.migrator.GetCurrentVersion(ctx)
}
func (m *migrator) Configure(ctx context.Context) error {
if err := m.initConn(ctx); err != nil {
return err
}
if err := m.initMigrator(ctx); err != nil {
return err
}
if err := m.loadMigrations(); err != nil {
return err
}
m.configured = true
return nil
}
func (m *migrator) Close(ctx context.Context) error {
if m.conn == nil || m.closed {
return nil
}
if err := m.closeConn(ctx); err != nil {
return err
}
m.closed = true
return nil
}
func (m *migrator) Start(ctx context.Context) error {
if !m.cfg.Postgres.GetRunMigrations() {
slog.Info("flag run migrations is disabled: skipping migrating")
return nil
}
err := m.Configure(ctx)
if err != nil {
slog.Error("failed to configure migrator", "error", err)
return err
}
err = m.MigrateUp(ctx)
if err != nil {
slog.Error("failed to migrate database up", "error", err)
return err
}
if err = m.Close(ctx); err != nil {
slog.Error("failed close connection to database", "error", err)
return err
}
m.closed = true
return nil
}
func (m *migrator) Stop(ctx context.Context) error {
return m.Close(ctx)
}
func (m *migrator) loadMigrations() (err error) {
err = m.migrator.LoadMigrations(m.migrations)
if err != nil {
slog.Error("failed to load migrations", "error", err)
return apperr.New(apperr.CodeInternal, "failed to load migrations")
}
slog.Info("successfully loaded migrations", "error", err)
return nil
}
func (m *migrator) initConn(ctx context.Context) (err error) {
m.closed = false
m.conn, err = pgx.Connect(ctx, m.cfg.Postgres.GetURI())
if err != nil {
slog.Error("failed to create connection to database", "error", err)
return apperr.New(apperr.CodeInternal, "failed to create connection to database")
}
slog.Info("connected to database", "db", m.cfg.Postgres.Database)
return nil
}
func (m *migrator) initMigrator(ctx context.Context) (err error) {
m.migrator, err = migrate.NewMigrator(ctx, m.conn, m.cfg.Postgres.GetVersionTableName())
if err != nil {
slog.Error("failed to initialize migrator", "error", err)
return apperr.New(apperr.CodeInternal, "failed to initialize migrator")
}
slog.Info("successfully initialized migrator")
return nil
}
func (m *migrator) closeConn(ctx context.Context) error {
return m.conn.Close(ctx)
}
@@ -0,0 +1,25 @@
package postgres
import (
"context"
"github.com/jackc/pgx/v5"
pgxUUID "github.com/vgarvardt/pgx-google-uuid/v5"
)
type AfterConnect func(ctx context.Context, conn *pgx.Conn) error
func AddUUIDSupport(_ context.Context, conn *pgx.Conn) error {
pgxUUID.Register(conn.TypeMap())
return nil
}
func WithEnumTypeSupport(enumName string) AfterConnect {
return func(ctx context.Context, conn *pgx.Conn) error {
dt, err := conn.LoadType(ctx, enumName)
if err != nil {
return err
}
conn.TypeMap().RegisterType(dt)
return nil
}
}
+7
View File
@@ -0,0 +1,7 @@
package postgres
type MigrationConfig interface {
GetURI() string
GetVersionTableName() string
GetRunMigrations() bool
}
+10
View File
@@ -0,0 +1,10 @@
package postgres
import (
"errors"
)
var (
errCreatingPool = errors.New("failed to create postgres pool")
errParseConfig = errors.New("failed to parse postgres config")
)
@@ -0,0 +1,15 @@
package postgres
import (
"context"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
)
type Conn interface {
SendBatch(ctx context.Context, b *pgx.Batch) pgx.BatchResults
Exec(ctx context.Context, sql string, arguments ...any) (commandTag pgconn.CommandTag, err error)
Query(ctx context.Context, sql string, args ...any) (pgx.Rows, error)
QueryRow(ctx context.Context, sql string, args ...any) pgx.Row
}
+95
View File
@@ -0,0 +1,95 @@
package postgres
import (
"context"
"log/slog"
"strconv"
"time"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgxpool"
"github.com/jackc/pgx/v5/tracelog"
pgxslog "github.com/mcosta74/pgx-slog"
)
type ConfigWithLog interface {
GetLogLevel() string
}
type ConfigWithTimeouts interface {
GetConnectTimeout() time.Duration
GetQueryTimeout() time.Duration
}
type ConfigWithMaxConn interface {
GetMaxConnections() int32
}
func getLevelFromConfig(cfg MigrationConfig) tracelog.LogLevel {
if logCfg, ok := cfg.(ConfigWithLog); ok {
lvl, _ := tracelog.LogLevelFromString(logCfg.GetLogLevel())
return lvl
}
return tracelog.LogLevelError
}
func addMaxConnectionsToCfg(cfg any, poolCfg *pgxpool.Config) {
if connCfg, ok := cfg.(ConfigWithMaxConn); ok {
poolCfg.MaxConns = connCfg.GetMaxConnections()
}
}
func New(cfg MigrationConfig, afterConnect ...AfterConnect) *pgxpool.Pool {
lvl := getLevelFromConfig(cfg)
if len(afterConnect) == 0 {
afterConnect = []AfterConnect{AddUUIDSupport}
}
poolConfig, err := pgxpool.ParseConfig(cfg.GetURI())
if err != nil {
slog.Error("failed to parse postgres config", "error", err)
panic(err)
}
addMaxConnectionsToCfg(cfg, poolConfig)
if timeoutCfg, ok := cfg.(ConfigWithTimeouts); ok {
poolConfig.ConnConfig.ConnectTimeout = timeoutCfg.GetConnectTimeout()
poolConfig.ConnConfig.RuntimeParams["statement_timeout"] = strconv.FormatInt(timeoutCfg.GetQueryTimeout().Milliseconds(), 10)
}
poolConfig.ConnConfig.RuntimeParams["application_name"] = "mtusi-api"
slog.Info("postgres_pool_config", "max_conns", poolConfig.MaxConns,
"connect_timeout", poolConfig.ConnConfig.ConnectTimeout,
"statement_timeout_ms", poolConfig.ConnConfig.RuntimeParams["statement_timeout"])
poolConfig.ConnConfig.Tracer = &tracelog.TraceLog{
Logger: pgxslog.NewLogger(slog.Default()),
LogLevel: lvl,
Config: &tracelog.TraceLogConfig{
TimeKey: "ts",
},
}
poolConfig.AfterConnect = load(afterConnect...)
pool, err := pgxpool.NewWithConfig(context.Background(), poolConfig)
if err != nil {
slog.Error("failed to create postgres pool", "error", err)
panic(err)
}
slog.Info("successfully connected to postgres pool")
return pool
}
func load(afterConnects ...AfterConnect) func(ctx context.Context, conn *pgx.Conn) error {
return func(ctx context.Context, conn *pgx.Conn) error {
for _, afterConnect := range afterConnects {
if err := afterConnect(ctx, conn); err != nil {
return err
}
}
return nil
}
}
@@ -0,0 +1,59 @@
package txmanager
import (
"context"
"errors"
"fmt"
"log/slog"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgxpool"
)
type TransactionManager struct {
pool *pgxpool.Pool
}
func New(pool *pgxpool.Pool) *TransactionManager {
return &TransactionManager{
pool: pool,
}
}
func (tm *TransactionManager) RunInTransaction(ctx context.Context, opts *pgx.TxOptions, fn func(tx pgx.Tx) error) (err error) {
var tx pgx.Tx
if opts != nil {
tx, err = tm.pool.BeginTx(ctx, *opts)
} else {
tx, err = tm.pool.Begin(ctx)
}
if err != nil {
return fmt.Errorf("failed to begin transaction: %w", err)
}
var committed bool
defer func() {
if p := recover(); p != nil {
err = fmt.Errorf("panic in transaction: %v", p)
}
if !committed {
rollbackErr := tx.Rollback(ctx)
if rollbackErr != nil && !errors.Is(rollbackErr, pgx.ErrTxClosed) {
slog.Error("failed to rollback transaction", "error", rollbackErr)
}
}
}()
if err = fn(tx); err != nil {
return fmt.Errorf("failed to execute transaction: %w", err)
}
if err = tx.Commit(ctx); err != nil {
return fmt.Errorf("failed to commit transaction: %w", err)
}
committed = true
return nil
}
@@ -0,0 +1,248 @@
package framework
import (
"context"
"encoding/json"
"errors"
"fmt"
"io"
"log/slog"
"mime"
"net/http"
"strconv"
"strings"
"github.com/go-chi/chi/v5"
v10 "github.com/go-playground/validator/v10"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/gen/contracts"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/auth/jwtprovider"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/headers"
"gitea.privcloud.tech/mtusi2026/internal/pkg/validator"
)
func validate(ctx context.Context, v *validator.ValidatorImpl, value any) error {
err := v.ValidateCtx(ctx, value)
if err == nil {
return nil
}
var fieldErrors v10.ValidationErrors
if errors.As(err, &fieldErrors) {
return apperr.Wrap(err, apperr.CodeValidation, "invalid request fields")
}
return apperr.Wrap(err, apperr.CodeInternal, "validation failed")
}
func Validate(w http.ResponseWriter, r *http.Request, v *validator.ValidatorImpl, value any) bool {
if err := validate(r.Context(), v, value); err != nil {
JSONError(r.Context(), w, err)
return false
}
return true
}
func JSONResponse(w http.ResponseWriter, status int, body any) {
w.Header().Set(headers.HeaderContentType, "application/json")
w.WriteHeader(status)
if status == http.StatusNoContent {
return
}
if err := json.NewEncoder(w).Encode(body); err != nil {
wrapped := apperr.Wrap(err, apperr.CodeInternal, "failed json encode")
slog.Error("response", "error", wrapped)
}
}
func JSONError(ctx context.Context, w http.ResponseWriter, err error) {
if err == nil {
return
}
requestId, ok := ctx.Value(headers.HeaderRequestID).(uuid.UUID)
if !ok {
requestId = uuid.New()
}
w.Header().Set(headers.HeaderRequestID, requestId.String())
if errors.Is(err, context.DeadlineExceeded) {
err = apperr.Wrap(err, apperr.CodeServiceUnavailable, "request deadline exceeded")
}
appErr := apperr.As(err)
if appErr == nil {
appErr = apperr.As(apperr.New(apperr.CodeInternal, "internal server error"))
}
if appErr.Code().HTTPStatus() == http.StatusUnauthorized && w.Header().Get("WWW-Authenticate") == "" {
w.Header().Set("WWW-Authenticate", `Bearer realm="messenger"`)
}
slog.Error("response", "error", err, "status", appErr.Code().HTTPStatus(), "requestId", requestId.String())
var code contracts.ErrorErrorCode
switch appErr.Code() {
case apperr.CodeBadRequest, apperr.CodeValidation:
code = contracts.InvalidRequest
case apperr.CodeUnauthorized:
code = contracts.Unauthorized
case apperr.CodeNotFound:
code = contracts.NotFound
case apperr.CodeAlreadyExists, apperr.CodeConflict:
code = contracts.Conflict
case apperr.CodePayloadTooLarge:
code = contracts.PayloadTooLarge
case apperr.CodeTooManyRequests:
code = contracts.RateLimited
case apperr.CodeServiceUnavailable, apperr.CodeUnavailable:
code = contracts.Unavailable
case apperr.CodeUnsupportedMediaType:
code = contracts.UnsupportedMediaType
default:
code = contracts.InternalError
}
JSONResponse(w, appErr.Code().HTTPStatus(), contracts.Error{
Error: struct {
Code contracts.ErrorErrorCode `json:"code"`
Message string `json:"message"`
RequestId string `json:"request_id"`
}{
Code: code,
Message: appErr.Message(),
RequestId: requestId.String(),
},
})
}
func Decode(w http.ResponseWriter, r *http.Request, object any) bool {
mediaType, params, err := mime.ParseMediaType(r.Header.Get(headers.HeaderContentType))
if err != nil || mediaType != "application/json" ||
(params["charset"] != "" && !strings.EqualFold(params["charset"], "utf-8")) {
JSONError(r.Context(), w, apperr.New(apperr.CodeUnsupportedMediaType, "expected application/json"))
return false
}
decoder := json.NewDecoder(r.Body)
decoder.DisallowUnknownFields()
if err := decoder.Decode(object); err != nil {
JSONError(r.Context(), w, apperr.Wrap(err, apperr.CodeBadRequest, "failed decode"))
return false
}
var trailing any
if err := decoder.Decode(&trailing); err != io.EOF {
JSONError(r.Context(), w, apperr.New(apperr.CodeBadRequest, "expected one JSON object"))
return false
}
return true
}
func PathParam(r *http.Request, key string) string {
return chi.URLParam(r, key)
}
func QueryParam(r *http.Request, key string) string {
return r.URL.Query().Get(key)
}
func HeaderParam(r *http.Request, key string) string {
return r.Header.Get(key)
}
func ParseIDFromPathParam(ctx context.Context, w http.ResponseWriter, r *http.Request, key string) (uuid.UUID, error) {
rawID := PathParam(r, key)
id, err := uuid.Parse(rawID)
if err != nil {
JSONError(ctx, w, apperr.New(apperr.CodeValidation, fmt.Sprintf("provided invalid %s", key)))
return uuid.Nil, err
}
return id, nil
}
func ParseIDFromQueryParam(ctx context.Context, w http.ResponseWriter, r *http.Request, key string) (uuid.UUID, error) {
rawID := QueryParam(r, key)
id, err := uuid.Parse(rawID)
if err != nil {
JSONError(ctx, w, apperr.New(apperr.CodeValidation, fmt.Sprintf("provided invalid %s", key)))
return uuid.Nil, err
}
return id, nil
}
func ParseIDFromHeaderParam(ctx context.Context, w http.ResponseWriter, r *http.Request, key string) (uuid.UUID, error) {
rawID := HeaderParam(r, key)
id, err := uuid.Parse(rawID)
if err != nil {
JSONError(ctx, w, apperr.New(apperr.CodeUnauthorized, "missing or invalid user ID"))
return uuid.Nil, err
}
return id, nil
}
func Header(r *http.Request, header string) (string, bool) {
return r.Header.Get(header), r.Header.Get(header) != ""
}
func Token(r *http.Request) (string, bool) {
foundHeader := r.Header.Get(headers.HeaderAuthorization)
if foundHeader == "" {
return "", false
}
token, found := strings.CutPrefix(foundHeader, "Bearer ")
if !found {
return "", false
}
return token, true
}
func ParseToken(r *http.Request, provider jwtprovider.Provider) (*dto.UserDataInToken, error) {
foundHeader := r.Header.Get(headers.HeaderAuthorization)
if foundHeader == "" {
return nil, apperr.New(apperr.CodeUnauthorized, "missing authorization header")
}
token, found := strings.CutPrefix(foundHeader, "Bearer ")
if !found {
return nil, apperr.New(apperr.CodeUnauthorized, "invalid authorization header")
}
userData, err := provider.ParseVerified(&dto.Token{Payload: token})
if err != nil {
return nil, apperr.Wrap(err, apperr.CodeUnauthorized, "invalid token")
}
return userData, nil
}
func PageParams(w http.ResponseWriter, r *http.Request) (*int, *uuid.UUID, bool) {
query := r.URL.Query()
var limit *int
if values, exists := query["limit"]; exists {
if len(values) != 1 {
JSONError(r.Context(), w, apperr.New(apperr.CodeBadRequest, "invalid limit"))
return nil, nil, false
}
value, err := strconv.Atoi(values[0])
if err != nil || value < 1 || value > 100 {
JSONError(r.Context(), w, apperr.New(apperr.CodeBadRequest, "invalid limit"))
return nil, nil, false
}
limit = &value
}
var afterID *uuid.UUID
if values, exists := query["cursor"]; exists {
if len(values) != 1 {
JSONError(r.Context(), w, apperr.New(apperr.CodeBadRequest, "invalid cursor"))
return nil, nil, false
}
id, err := uuid.Parse(values[0])
if err != nil || id == uuid.Nil {
JSONError(r.Context(), w, apperr.New(apperr.CodeBadRequest, "invalid cursor"))
return nil, nil, false
}
afterID = &id
}
return limit, afterID, true
}
@@ -0,0 +1,8 @@
package headers
const (
HeaderContentType = "Content-Type"
HeaderRequestID = "X-Request-Id"
HeaderUserID = "X-User-Id"
HeaderAuthorization = "Authorization"
)
@@ -0,0 +1,74 @@
package middleware
import (
"context"
"net/http"
"gitea.privcloud.tech/mtusi2026/internal/dto"
"gitea.privcloud.tech/mtusi2026/internal/pkg/apperr"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/framework"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types/role"
)
var _ AuthMiddleware = (*authMiddleware)(nil)
type AuthMiddleware interface {
WithPrivateAccess(next http.Handler) http.Handler
WithAdminAccess(next http.Handler) http.Handler
}
type SessionVerifier interface {
VerifySession(ctx context.Context, token dto.Token) (*dto.UserDataInToken, error)
}
type authMiddleware struct {
verifier SessionVerifier
}
func NewAuthMiddleware(verifier SessionVerifier) AuthMiddleware {
return &authMiddleware{verifier: verifier}
}
func (a *authMiddleware) WithPrivateAccess(next http.Handler) http.Handler {
return a.privateAccessCheckCallback(next)
}
func (a *authMiddleware) WithAdminAccess(next http.Handler) http.Handler {
return a.operatorAccessCheckCallback(role.Admin, next)
}
func (a *authMiddleware) privateAccessCheckCallback(next http.Handler) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if _, err := a.verifySession(r); err != nil {
framework.JSONError(r.Context(), w, err)
return
}
next.ServeHTTP(w, r)
}
}
func (a *authMiddleware) operatorAccessCheckCallback(expectedRole role.Role, next http.Handler) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
u, err := a.verifySession(r)
if err != nil {
framework.JSONError(r.Context(), w, err)
return
}
if u.Role != role.Admin && u.Role != expectedRole {
framework.JSONError(r.Context(), w, apperr.New(apperr.CodeForbidden, "insufficient permissions"))
return
}
next.ServeHTTP(w, r)
}
}
func (a *authMiddleware) verifySession(r *http.Request) (*dto.UserDataInToken, error) {
token, found := framework.Token(r)
if !found || token == "" {
return nil, apperr.New(apperr.CodeUnauthorized, "missing or invalid bearer token")
}
return a.verifier.VerifySession(r.Context(), dto.Token{Payload: token})
}
@@ -0,0 +1,34 @@
package middleware
import (
"log/slog"
"net/http"
"time"
"github.com/go-chi/chi/v5/middleware"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/headers"
)
func LoggingMiddleware() Middleware {
return func(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
started := time.Now()
wrapped := middleware.NewWrapResponseWriter(w, r.ProtoMajor)
next.ServeHTTP(wrapped, r)
status := wrapped.Status()
if status == 0 {
status = http.StatusOK
}
slog.InfoContext(r.Context(), "http request",
"method", r.Method,
"path", r.URL.Path,
"status", status,
"duration", time.Since(started),
"bytes", wrapped.BytesWritten(),
"request_id", w.Header().Get(headers.HeaderRequestID),
)
})
}
}
@@ -0,0 +1,5 @@
package middleware
import "net/http"
type Middleware = func(http.Handler) http.Handler
@@ -0,0 +1,22 @@
package middleware
import (
"context"
"net/http"
"github.com/google/uuid"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/headers"
)
func RequestIDMiddleware() Middleware {
return func(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
requestID := uuid.New()
w.Header().Set(headers.HeaderRequestID, requestID.String())
ctx = context.WithValue(ctx, headers.HeaderRequestID, requestID)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
}
@@ -0,0 +1,18 @@
package middleware
import (
"context"
"net/http"
"time"
)
// RequestTimeout bounds database work and waiting for a pooled connection.
func RequestTimeout(timeout time.Duration) Middleware {
return func(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
ctx, cancel := context.WithTimeout(r.Context(), timeout)
defer cancel()
next.ServeHTTP(w, r.WithContext(ctx))
})
}
}
+131
View File
@@ -0,0 +1,131 @@
package router
import (
"net/http"
"github.com/go-chi/chi/v5"
"gitea.privcloud.tech/mtusi2026/internal/pkg/rest/middleware"
)
type Router interface {
Private(method, pattern string, handler http.HandlerFunc, mw ...func(http.Handler) http.Handler)
Public(method, pattern string, handler http.HandlerFunc, mw ...func(http.Handler) http.Handler)
Admin(method, pattern string, handler http.HandlerFunc, mw ...func(http.Handler) http.Handler)
ServeHTTP(w http.ResponseWriter, r *http.Request)
With(mw ...func(http.Handler) http.Handler) Router
Use(mw ...func(http.Handler) http.Handler) Router
Handle(pattern string, handler http.Handler)
Get(pattern string, handler http.HandlerFunc)
Head(pattern string, handler http.HandlerFunc)
Options(pattern string, handler http.HandlerFunc)
Post(pattern string, handler http.HandlerFunc)
Put(pattern string, handler http.HandlerFunc)
Patch(pattern string, handler http.HandlerFunc)
Delete(pattern string, handler http.HandlerFunc)
Connect(pattern string, handler http.HandlerFunc)
Trace(pattern string, handler http.HandlerFunc)
}
type router struct {
r chi.Router
jwtMw middleware.AuthMiddleware
}
func New(jwtMw middleware.AuthMiddleware, mw ...middleware.Middleware) Router {
r := chi.NewRouter()
r.Use(mw...)
return &router{
r: r,
jwtMw: jwtMw,
}
}
func (c *router) Group(pattern string) Router {
sub := &router{
r: chi.NewRouter(),
jwtMw: c.jwtMw,
}
c.r.Mount(pattern, sub.r)
return sub
}
func (c *router) Public(method, pattern string, handler http.HandlerFunc, mw ...func(http.Handler) http.Handler) {
next := c.applyMiddlewares(handler, mw...)
c.r.MethodFunc(method, pattern, next.ServeHTTP)
}
func (c *router) Private(method, pattern string, handler http.HandlerFunc, mw ...func(http.Handler) http.Handler) {
next := c.applyMiddlewares(handler, mw...)
c.r.MethodFunc(method, pattern, (c.jwtMw.WithPrivateAccess(next)).ServeHTTP)
}
func (c *router) Admin(method, pattern string, handler http.HandlerFunc, mw ...func(http.Handler) http.Handler) {
next := c.applyMiddlewares(handler, mw...)
c.r.MethodFunc(method, pattern, (c.jwtMw.WithAdminAccess(next)).ServeHTTP)
}
func (c *router) ServeHTTP(w http.ResponseWriter, r *http.Request) {
c.r.ServeHTTP(w, r)
}
func (c *router) With(mw ...func(http.Handler) http.Handler) Router {
sub := &router{
r: c.r.With(mw...),
jwtMw: c.jwtMw,
}
return sub
}
func (c *router) Use(mw ...func(http.Handler) http.Handler) Router {
c.r.Use(mw...)
return c
}
func (c *router) Handle(pattern string, handler http.Handler) {
c.r.Handle(pattern, handler)
}
func (c *router) Get(pattern string, handler http.HandlerFunc) {
c.r.Get(pattern, handler)
}
func (c *router) Head(pattern string, handler http.HandlerFunc) {
c.r.Head(pattern, handler)
}
func (c *router) Options(pattern string, handler http.HandlerFunc) {
c.r.Options(pattern, handler)
}
func (c *router) Post(pattern string, handler http.HandlerFunc) {
c.r.Post(pattern, handler)
}
func (c *router) Put(pattern string, handler http.HandlerFunc) {
c.r.Put(pattern, handler)
}
func (c *router) Patch(pattern string, handler http.HandlerFunc) {
c.r.Patch(pattern, handler)
}
func (c *router) Delete(pattern string, handler http.HandlerFunc) {
c.r.Delete(pattern, handler)
}
func (c *router) Connect(pattern string, handler http.HandlerFunc) {
c.r.Connect(pattern, handler)
}
func (c *router) Trace(pattern string, handler http.HandlerFunc) {
c.r.Trace(pattern, handler)
}
func (c *router) applyMiddlewares(handler http.HandlerFunc, mw ...func(http.Handler) http.Handler) http.Handler {
next := http.Handler(handler)
for _, mwFunc := range mw {
next = mwFunc(next)
}
return next
}
@@ -0,0 +1,82 @@
package authprovider
import (
"encoding/json"
"strings"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types"
)
type Type string
const (
TypeUndefined Type = "undefined"
TypePassword Type = "password"
TypeEmail Type = "email"
TypePhone Type = "phone"
TypeGoogle Type = "google"
TypeTelegram Type = "telegram"
)
var allowedTypes = map[Type]struct{}{
TypePassword: {},
TypeEmail: {},
TypePhone: {},
TypeGoogle: {},
TypeTelegram: {},
}
func ParseType(value string) Type {
t := Type(strings.ToLower(value))
if !t.IsValid() {
return TypeUndefined
}
return t
}
func ParseAndValidateType(value string) (Type, error) {
parsed := ParseType(value)
if _, ok := allowedTypes[parsed]; ok {
return parsed, nil
}
return TypeUndefined, types.ErrUnsupportedOTPStatus
}
func (t Type) String() string {
return string(t)
}
func (t Type) Validate() error {
if _, ok := allowedTypes[t]; ok {
return nil
}
return types.ErrUnsupportedAuthProviderType
}
func (t Type) IsValid() bool {
_, ok := allowedTypes[t]
return ok
}
func (t Type) MarshalJSON() ([]byte, error) {
if err := t.Validate(); err != nil {
return nil, err
}
return json.Marshal(t.String())
}
func (t *Type) UnmarshalJSON(data []byte) error {
if t == nil {
return types.ErrUnmarshalAuthProviderTypeIntoNilPointer
}
var value string
if err := json.Unmarshal(data, &value); err != nil {
return err
}
parsed := ParseType(value)
if err := parsed.Validate(); err != nil {
return err
}
*t = parsed
return nil
}
@@ -0,0 +1,77 @@
package environment
import (
"encoding/json"
"strings"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types"
)
type ApplicationEnvironment string
const (
ApplicationEnvironmentUndefined ApplicationEnvironment = "undefined"
ApplicationEnvironmentDev ApplicationEnvironment = "dev"
ApplicationEnvironmentProd ApplicationEnvironment = "prod"
)
var allowedEnvironments = map[ApplicationEnvironment]struct{}{
ApplicationEnvironmentUndefined: {},
ApplicationEnvironmentDev: {},
ApplicationEnvironmentProd: {},
}
func ParseEnvironment(value string) ApplicationEnvironment {
s := ApplicationEnvironment(strings.ToLower(value))
if !s.IsValid() {
return ApplicationEnvironmentUndefined
}
return s
}
func ParseAndValidateEnvironment(status string) (ApplicationEnvironment, error) {
parsed := ParseEnvironment(status)
if _, ok := allowedEnvironments[parsed]; ok {
return parsed, nil
}
return ApplicationEnvironmentUndefined, types.ErrUnsupportedApplicationEnvironment
}
func (t ApplicationEnvironment) String() string {
return string(t)
}
func (t ApplicationEnvironment) Validate() error {
if _, ok := allowedEnvironments[t]; ok {
return nil
}
return types.ErrUnsupportedApplicationEnvironment
}
func (t ApplicationEnvironment) IsValid() bool {
_, ok := allowedEnvironments[t]
return ok
}
func (t ApplicationEnvironment) MarshalJSON() ([]byte, error) {
if err := t.Validate(); err != nil {
return nil, err
}
return json.Marshal(t.String())
}
func (t *ApplicationEnvironment) UnmarshalJSON(data []byte) error {
if t == nil {
return types.ErrUnmarshalApplicationEnvironmentIntoNilPointer
}
var value string
if err := json.Unmarshal(data, &value); err != nil {
return err
}
parsed := ParseEnvironment(value)
if err := parsed.Validate(); err != nil {
return err
}
*t = parsed
return nil
}
+25
View File
@@ -0,0 +1,25 @@
package types
import "errors"
var (
ErrUnsupportedRole = errors.New("unsupported role")
ErrUnsupportedOTPType = errors.New("unsupported OTP type")
ErrUnsupportedAuthProviderType = errors.New("unsupported auth provider type")
ErrUnsupportedContactType = errors.New("unsupported contact type")
ErrUnsupportedOTPStatus = errors.New("unsupported OTP status")
ErrUnsupportedOTPResult = errors.New("unsupported OTP result")
ErrUnsupportedFormStatus = errors.New("unsupported form status")
ErrUnsupportedAuthIdentityStatus = errors.New("unsupported auth identity status")
ErrUnsupportedApplicationEnvironment = errors.New("unsupported application environment")
ErrUnmarshalRoleIntoNilPointer = errors.New("unmarshal role into nil pointer")
ErrUnmarshalOTPTypeIntoNilPointer = errors.New("unmarshal OTP type into nil pointer")
ErrUnmarshalAuthProviderTypeIntoNilPointer = errors.New("unmarshal auth provider into nil pointer")
ErrUnmarshalContactTypeIntoNilPointer = errors.New("unmarshal contact into nil pointer")
ErrUnmarshalOTPStatusIntoNilPointer = errors.New("unmarshal OTP status into nil pointer")
ErrUnmarshalOTPResultIntoNilPointer = errors.New("unmarshal OTP result into nil pointer")
ErrUnmarshalFormStatusIntoNilPointer = errors.New("unmarshal form status into nil pointer")
ErrUnmarshalAuthIdentityStatusIntoNilPointer = errors.New("unmarshal auth identity status into nil pointer")
ErrUnmarshalApplicationEnvironmentIntoNilPointer = errors.New("unmarshal application environment into nil pointer")
)
+105
View File
@@ -0,0 +1,105 @@
package role
import (
"encoding/json"
"strings"
"gitea.privcloud.tech/mtusi2026/internal/pkg/types"
)
type Role string
const (
Undefined Role = "undefined"
User Role = "user"
Doctor Role = "doctor"
Manager Role = "manager"
Admin Role = "admin"
)
var allowedRoles = map[Role]struct{}{
User: {},
Doctor: {},
Manager: {},
Admin: {},
}
func ParseRole(s string) Role {
r := Role(strings.ToLower(s))
if !r.IsValid() {
return Undefined
}
return r
}
func ParseAndValidateRole(s string) (Role, error) {
parsed := ParseRole(s)
if _, ok := allowedRoles[parsed]; ok {
return parsed, nil
}
return Undefined, types.ErrUnsupportedRole
}
func (t Role) String() string {
return string(t)
}
func (t Role) Validate() error {
if _, ok := allowedRoles[t]; ok {
return nil
}
return types.ErrUnsupportedRole
}
func (t Role) IsValid() bool {
_, ok := allowedRoles[t]
return ok
}
func (t Role) MarshalJSON() ([]byte, error) {
if err := t.Validate(); err != nil {
return nil, err
}
return json.Marshal(t.String())
}
func (t *Role) UnmarshalJSON(data []byte) error {
if t == nil {
return types.ErrUnmarshalRoleIntoNilPointer
}
var value string
if err := json.Unmarshal(data, &value); err != nil {
return err
}
parsed := ParseRole(value)
if err := parsed.Validate(); err != nil {
return err
}
*t = parsed
return nil
}
func (t Role) IsAdmin() bool {
return t == Admin
}
func (t Role) IsManager() bool {
return t == Manager
}
func (t Role) IsDoctor() bool {
return t == Doctor
}
func (t Role) IsUser() bool {
return t == User
}
func (t Role) IsPrivileged() bool {
switch t {
case Doctor, Manager, Admin:
return true
default:
return false
}
}

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