forked from mtusi2026/mtusi2026lab2
146 lines
3.9 KiB
Markdown
146 lines
3.9 KiB
Markdown
# Доказательства уровня 3
|
||
|
||
Состояние: commit уровня 3 `158fed1` (`реализован уровень 3`).
|
||
|
||
## Окружение
|
||
|
||
```text
|
||
Ubuntu 26.04 LTS, WSL2
|
||
Go 1.27.1 linux/amd64
|
||
Python 3.14.4
|
||
Docker Engine 29.7.2
|
||
Docker Compose 5.5.0
|
||
PostgreSQL 16.15
|
||
8 логических CPU
|
||
MemTotal: 3905144 kB
|
||
```
|
||
|
||
Использованы локальные синтетические пользователи и сообщения. Session tokens,
|
||
пароли, database URL и содержимое secret-файлов в evidence не сохранялись.
|
||
|
||
## Статические и Go-проверки
|
||
|
||
```sh
|
||
make go-check
|
||
make check
|
||
make validate PYTHON=.venv/bin/python
|
||
make compose-config
|
||
git diff --check
|
||
```
|
||
|
||
Результат:
|
||
|
||
```text
|
||
go test ./... PASS
|
||
go test -race ./... PASS
|
||
go vet ./... PASS
|
||
check_contract.py PASS
|
||
validate_openapi.py PASS
|
||
docker compose config PASS
|
||
git diff --check PASS
|
||
```
|
||
|
||
## Публичный smoke
|
||
|
||
```sh
|
||
make test
|
||
```
|
||
|
||
```text
|
||
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
|
||
```
|
||
|
||
Проверены регистрация, Basic login, Bearer authentication, запрет одного
|
||
`X-User-Id`, защита чужого чата, создание/чтение сообщений, cursor pagination,
|
||
ошибки входных данных и logout.
|
||
|
||
## Миграции
|
||
|
||
Повторный запуск:
|
||
|
||
```sh
|
||
docker compose run --rm migrate
|
||
```
|
||
|
||
```text
|
||
no change
|
||
```
|
||
|
||
Состояние `schema_migrations`:
|
||
|
||
```text
|
||
version = 1
|
||
dirty = false
|
||
```
|
||
|
||
Фактически созданы прикладные таблицы `users`, `chats`, `chat_members`,
|
||
`messages`, `sessions`, а также служебная `schema_migrations`.
|
||
|
||
Каталог PostgreSQL подтвердил 12 индексов и 23 ограничения, включая:
|
||
|
||
- `users_username_unique`;
|
||
- `chat_members_primary_key`;
|
||
- `chat_members_position_unique`;
|
||
- `messages_sender_membership_foreign_key`;
|
||
- `messages_chat_created_at_id_idx`;
|
||
- `sessions_token_hash_length`;
|
||
- `sessions_expiry_after_creation`;
|
||
- `sessions_expires_at_idx`.
|
||
|
||
## Persistence
|
||
|
||
```sh
|
||
make test-persistence ACTION_SCRIPT=scripts/restart.sh
|
||
```
|
||
|
||
```text
|
||
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
|
||
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
|
||
```
|
||
|
||
В commit `158fed1` hook последовательно перезапускал `postgres`, ждал его
|
||
healthcheck и перезапускал `api`; Redis был добавлен следующим этапом.
|
||
`docker compose ps` после сценария показывал оба сервиса в
|
||
состоянии `healthy`. Named volume:
|
||
|
||
```text
|
||
mtusi2026lab2_postgres_data
|
||
```
|
||
|
||
После повторных smoke/persistence-проверок в volume находились только
|
||
синтетические данные:
|
||
|
||
```text
|
||
users=18 chats=6 memberships=12 messages=9 sessions=15
|
||
```
|
||
|
||
## Образы
|
||
|
||
```text
|
||
golang:1.27.1-alpine
|
||
sha256:8a5910f31396cd4d89662f56c68b3ae31d374308270a1c3bd96672ee5ed43414
|
||
alpine:3.24
|
||
sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6
|
||
postgres:16.15-alpine3.24
|
||
sha256:721873c34ceb9f8d8fc265984940dc982404c105f19ad51be9fdc5970a6080ea
|
||
migrate/migrate:v4.20.1
|
||
sha256:76cc2074cb6642631f34a898ced71e6aeaa6b1a4d78c4daa743275a22e0c5be7
|
||
```
|
||
|
||
В Dockerfile и Compose используются ссылки `tag@digest`.
|
||
|
||
## Секреты и Git
|
||
|
||
`git check-ignore` подтвердил исключение:
|
||
|
||
```text
|
||
.env
|
||
.venv/
|
||
secrets/postgres_password.txt
|
||
secrets/database_url.txt
|
||
```
|
||
|
||
`git ls-files` не обнаружил среди tracked-файлов `.env`, `.venv/`, `secrets/`
|
||
или временный `CONTEXT.md`. Поиск credential-паттернов нашёл только явно
|
||
обозначенный placeholder в `examples/requests.http`.
|