ЛР2 – БПИ2303 – Поликарпов – На 5 #155
+52
-8
@@ -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
|
||||
|
||||
@@ -0,0 +1 @@
|
||||
*.csv text eol=lf
|
||||
@@ -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
@@ -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"]
|
||||
@@ -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
|
||||
|
||||
@@ -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 и контракт не изменялись.
|
||||
|
||||
@@ -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:
|
||||
@@ -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 и отказы зависимостей.
|
||||
|
||||
@@ -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
@@ -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 сохранены как исторический эксперимент отдельной сборки и не пересчитывались.
|
||||
@@ -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
|
||||
@@ -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
|
||||
}
|
||||
]
|
||||
@@ -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
|
||||
@@ -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
|
||||
}
|
||||
]
|
||||
@@ -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
|
||||
@@ -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
|
||||
|
@@ -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)
|
||||
@@ -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
|
||||
@@ -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"
|
||||
}
|
||||
@@ -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
|
||||
@@ -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
|
||||
|
@@ -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
@@ -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): реализация, соответствие критериям, запуск и границы проведённых проверок.
|
||||
|
||||
Эта инструкция основана на текущих конфигурационных файлах и сохранённых результатах. При её оформлении сервисы не
|
||||
запускались и не перезапускались, новые тесты не добавлялись.
|
||||
|
||||
@@ -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()
|
||||
Executable
+22
@@ -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
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
}
|
||||
}
|
||||
@@ -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))
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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
@@ -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
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
package config
|
||||
|
||||
import "github.com/spf13/viper"
|
||||
|
||||
type Loader interface {
|
||||
loadConfig(v *viper.Viper) error
|
||||
}
|
||||
@@ -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,
|
||||
}
|
||||
}
|
||||
@@ -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(),
|
||||
}
|
||||
}
|
||||
@@ -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,
|
||||
}
|
||||
}
|
||||
@@ -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,
|
||||
}
|
||||
}
|
||||
@@ -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,
|
||||
}
|
||||
}
|
||||
@@ -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,
|
||||
}
|
||||
}
|
||||
@@ -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,
|
||||
}
|
||||
}
|
||||
@@ -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)
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
@@ -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]]
|
||||
}
|
||||
@@ -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()
|
||||
}
|
||||
@@ -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()
|
||||
}
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
@@ -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)
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
Vendored
+43
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
package postgres
|
||||
|
||||
type MigrationConfig interface {
|
||||
GetURI() string
|
||||
GetVersionTableName() string
|
||||
GetRunMigrations() bool
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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))
|
||||
})
|
||||
}
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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")
|
||||
)
|
||||
@@ -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
Reference in New Issue
Block a user