# Дата (UTC): 2026-10-23 10:18:23
# Commit: 65003b6
# Команда: python scripts/storage_demo.py --mode down


==============================================================================
1. Как устроено приложение
==============================================================================
Приложение -- мессенджер: HTTP API (FastAPI), PostgreSQL и Redis (кэш сессий).
* Сам API состояния не хранит: пользователи, чаты, участники, сообщения и сессии
  лежат в PostgreSQL (таблицы users, chats, chat_members, messages, sessions).
* Файлы PostgreSQL лежат не в контейнере, а в именованном томе Docker (pgdata).
  Контейнеры api и db временные, том постоянный.
* Пароль хранится как scrypt-хеш, у сессии в БД лежит только SHA-256 токена,
  срок сессии считает сама БД -- перезапуск его не продлевает и не сбрасывает.
* Redis только кэширует проверку токена (без persistence): после перезапуска
  кэш пуст, и сессии читаются из PostgreSQL.
Ожидание: пока том не удалён (команда down -v здесь НЕ используется), после
  удаления и повторного создания контейнеров (docker compose down, затем up -d)
те же пользователи, чат, сообщение и тот же токен продолжают работать.
План: (1) создать данные через API, (2) показать их в БД, (3) выключить,
(4) включить, (5) проверить, что данные и токены прежние.


==============================================================================
2. Состояние до начала
==============================================================================
$ docker compose --env-file .env ps
NAME              IMAGE                    COMMAND                  SERVICE   CREATED              STATUS                        PORTS
messenger-api     mtusi-messenger:lab2     "python -m app"          api       About a minute ago   Up 59 seconds (healthy)       127.0.0.1:8080->8080/tcp
messenger-db      postgres:16.6-bookworm   "docker-entrypoint.s…"   db        About a minute ago   Up About a minute (healthy)   127.0.0.1:5433->5432/tcp
messenger-redis   redis:7.4.1-bookworm     "docker-entrypoint.s…"   redis     About a minute ago   Up About a minute (healthy)   6379/tcp
$ docker volume ls --filter name=pgdata --format {{.Name}}
mtusi-messenger_pgdata
$ docker volume inspect mtusi-messenger_pgdata --format "{{.Name}}  создан: {{.CreatedAt}}"
mtusi-messenger_pgdata  создан: 2026-10-23T13:16:41+03:00

==============================================================================
3. Запись данных через API (создаём пользователей, чат, сообщение)
==============================================================================
$ POST /api/v1/users    # регистрация Алисы
  тело запроса: {"username": "demo_a_7681083c", "display_name": "Алиса", "password": "***"}
  ответ: 201 {"id": "a0fce947-1cb5-4780-ba66-daddb74fadea", "username": "demo_a_7681083c", "display_name": "Алиса", "created_at": "2026-10-23T10:18:12.849116Z"}
$ POST /api/v1/users    # регистрация Боба
  тело запроса: {"username": "demo_b_7681083c", "display_name": "Боб", "password": "***"}
  ответ: 201 {"id": "2c34c828-f3c2-46ae-8055-bfaa49de3789", "username": "demo_b_7681083c", "display_name": "Боб", "created_at": "2026-10-23T10:18:12.903720Z"}
$ POST /api/v1/auth/sessions    # вход Алисы (Basic)
  ответ: 201 {"token": "<скрыт, 43 симв.>", "token_type": "Bearer", "expires_at": "2026-10-23T11:18:12.910850Z", "user": {"id": "a0fce947-1cb5-4780-ba66-daddb74fadea", "username": "demo_a_7681083c", "display_name": "Алиса", "created_at": "2026-10-23T10:18:12.849116Z"}}
$ POST /api/v1/auth/sessions    # вход Боба (Basic)
  ответ: 201 {"token": "<скрыт, 43 симв.>", "token_type": "Bearer", "expires_at": "2026-10-23T11:18:12.961660Z", "user": {"id": "2c34c828-f3c2-46ae-8055-bfaa49de3789", "username": "demo_b_7681083c", "display_name": "Боб", "created_at": "2026-10-23T10:18:12.903720Z"}}
$ POST /api/v1/chats    # чат Алисы и Боба (Bearer)
  тело запроса: {"title": "Проверка сохранности 7681083c", "member_ids": ["a0fce947-1cb5-4780-ba66-daddb74fadea", "2c34c828-f3c2-46ae-8055-bfaa49de3789"]}
  ответ: 201 {"id": "051a293a-c75d-45f5-b4ab-7e24ef0833f4", "title": "Проверка сохранности 7681083c", "member_ids": ["2c34c828-f3c2-46ae-8055-bfaa49de3789", "a0fce947-1cb5-4780-ba66-daddb74fadea"], "created_at": "2026-10-23T10:18:13.013118Z"}
$ POST /api/v1/chats/051a293a-c75d-45f5-b4ab-7e24ef0833f4/messages    # сообщение Алисы
  тело запроса: {"text": "Это сообщение должно пережить перезапуск 7681083c"}
  ответ: 201 {"id": "8d7c0e89-8043-413d-b3f0-d6bca0062b3e", "chat_id": "051a293a-c75d-45f5-b4ab-7e24ef0833f4", "sender_id": "a0fce947-1cb5-4780-ba66-daddb74fadea", "text": "Это сообщение должно пережить перезапуск 7681083c", "created_at": "2026-10-23T10:18:13.025076Z"}

==============================================================================
4. Что лежит в PostgreSQL ДО выключения (SELECT внутри контейнера db)
==============================================================================
-- пользователи (пароль -- только префикс хеша)
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT username, display_name, left(password_hash, 7) AS password_prefix, created_at FROM users WHERE username IN ('demo_a_7681083c', 'demo_b_7681083c') ORDER BY username"
username     | display_name | password_prefix |          created_at           
-----------------+--------------+-----------------+-------------------------------
 demo_a_7681083c | Алиса        | scrypt$         | 2026-10-23 10:18:12.849116+00
 demo_b_7681083c | Боб          | scrypt$         | 2026-10-23 10:18:12.90372+00
(2 rows)
-- чат и число участников
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT c.title, count(m.user_id) AS members FROM chats c JOIN chat_members m ON m.chat_id = c.id WHERE c.id = '051a293a-c75d-45f5-b4ab-7e24ef0833f4' GROUP BY c.title"
title             | members 
-------------------------------+---------
 Проверка сохранности 7681083c |       2
(1 row)
-- сообщение
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT id, sender_id, text, created_at FROM messages WHERE chat_id = '051a293a-c75d-45f5-b4ab-7e24ef0833f4'"
id                  |              sender_id               |                       text                        |          created_at           
--------------------------------------+--------------------------------------+---------------------------------------------------+-------------------------------
 8d7c0e89-8043-413d-b3f0-d6bca0062b3e | a0fce947-1cb5-4780-ba66-daddb74fadea | Это сообщение должно пережить перезапуск 7681083c | 2026-10-23 10:18:13.025076+00
(1 row)
-- действующие сессии (токены не показываем)
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT count(*) AS live_sessions FROM sessions s JOIN users u ON u.id = s.user_id WHERE u.username IN ('demo_a_7681083c', 'demo_b_7681083c') AND s.expires_at > now()"
live_sessions 
---------------
             2
(1 row)

==============================================================================
5. Выключаем приложение (контейнеры УДАЛЯЮТСЯ, том остаётся)
==============================================================================
$ docker compose --env-file .env down
Container messenger-api Stopping 
 Container messenger-api Stopped 
 Container messenger-api Removing 
 Container messenger-api Removed 
 Container messenger-db Stopping 
 Container messenger-redis Stopping 
 Container messenger-redis Stopped 
 Container messenger-redis Removing 
 Container messenger-redis Removed 
 Container messenger-db Stopped 
 Container messenger-db Removing 
 Container messenger-db Removed 
 Network mtusi-messenger_default Removing 
 Network mtusi-messenger_default Removed
$ docker compose --env-file .env ps -a
NAME      IMAGE     COMMAND   SERVICE   CREATED   STATUS    PORTS
API на http://localhost:8080 не отвечает -- приложение выключено (так и должно быть).
-- том с данными на месте:
$ docker volume ls --filter name=pgdata
DRIVER    VOLUME NAME
local     mtusi-messenger_pgdata

==============================================================================
6. Включаем снова
==============================================================================
$ docker compose --env-file .env up -d
Network mtusi-messenger_default Creating 
 Network mtusi-messenger_default Creating 
 Network mtusi-messenger_default Created 
 Network mtusi-messenger_default Created 
 Container messenger-db Creating 
 Container messenger-redis Creating 
 Container messenger-redis Created 
 Container messenger-db Created 
 Container messenger-api Creating 
 Container messenger-api Created 
 Container messenger-db Starting 
 Container messenger-redis Starting 
 Container messenger-db Started 
 Container messenger-redis Started 
 Container messenger-db Waiting 
 Container messenger-db Healthy 
 Container messenger-api Starting 
 Container messenger-api Started
API снова готов (/health/ready = 200) через 2 с.
$ docker compose --env-file .env ps
NAME              IMAGE                    COMMAND                  SERVICE   CREATED         STATUS                            PORTS
messenger-api     mtusi-messenger:lab2     "python -m app"          api       7 seconds ago   Up 2 seconds (health: starting)   127.0.0.1:8080->8080/tcp
messenger-db      postgres:16.6-bookworm   "docker-entrypoint.s…"   db        7 seconds ago   Up 7 seconds (healthy)            127.0.0.1:5433->5432/tcp
messenger-redis   redis:7.4.1-bookworm     "docker-entrypoint.s…"   redis     7 seconds ago   Up 7 seconds (healthy)            6379/tcp

==============================================================================
7. Проверка ПОСЛЕ перезапуска: те же данные и те же токены
==============================================================================
$ GET /api/v1/users/me    # старый токен Алисы, повторный вход НЕ делали
  ответ: 200 {"id": "a0fce947-1cb5-4780-ba66-daddb74fadea", "username": "demo_a_7681083c", "display_name": "Алиса", "created_at": "2026-10-23T10:18:12.849116Z"}
  OK: тот же пользователь (id, username, created_at совпали).
$ GET /api/v1/chats/051a293a-c75d-45f5-b4ab-7e24ef0833f4/messages    # старый токен Боба читает историю чата
  ответ: 200 {"items": [{"id": "8d7c0e89-8043-413d-b3f0-d6bca0062b3e", "chat_id": "051a293a-c75d-45f5-b4ab-7e24ef0833f4", "sender_id": "a0fce947-1cb5-4780-ba66-daddb74fadea", "text": "Это сообщение должно пережить перезапуск 7681083c", "created_at": "2026-10-23T10:18:13.025076Z"}], "next_cursor": null}
  OK: то же сообщение (id, text, created_at совпали).
$ GET /api/v1/chats?limit=100    # список чатов Алисы
  ответ: 200 {"items": [{"id": "051a293a-c75d-45f5-b4ab-7e24ef0833f4", "title": "Проверка сохранности 7681083c", "member_ids": ["2c34c828-f3c2-46ae-8055-bfaa49de3789", "a0fce947-1cb5-4780-ba66-daddb74fadea"], "created_at": "2026-10-23T10:18:13.013118Z"}], "next_cursor": null}
  OK: чат в списке.

Те же SELECT после перезапуска (сравниваем с выводом из пункта 4):
-- пользователи (пароль -- только префикс хеша)
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT username, display_name, left(password_hash, 7) AS password_prefix, created_at FROM users WHERE username IN ('demo_a_7681083c', 'demo_b_7681083c') ORDER BY username"
username     | display_name | password_prefix |          created_at           
-----------------+--------------+-----------------+-------------------------------
 demo_a_7681083c | Алиса        | scrypt$         | 2026-10-23 10:18:12.849116+00
 demo_b_7681083c | Боб          | scrypt$         | 2026-10-23 10:18:12.90372+00
(2 rows)
  OK: вывод идентичен выводу до перезапуска.
-- чат и число участников
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT c.title, count(m.user_id) AS members FROM chats c JOIN chat_members m ON m.chat_id = c.id WHERE c.id = '051a293a-c75d-45f5-b4ab-7e24ef0833f4' GROUP BY c.title"
title             | members 
-------------------------------+---------
 Проверка сохранности 7681083c |       2
(1 row)
  OK: вывод идентичен выводу до перезапуска.
-- сообщение
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT id, sender_id, text, created_at FROM messages WHERE chat_id = '051a293a-c75d-45f5-b4ab-7e24ef0833f4'"
id                  |              sender_id               |                       text                        |          created_at           
--------------------------------------+--------------------------------------+---------------------------------------------------+-------------------------------
 8d7c0e89-8043-413d-b3f0-d6bca0062b3e | a0fce947-1cb5-4780-ba66-daddb74fadea | Это сообщение должно пережить перезапуск 7681083c | 2026-10-23 10:18:13.025076+00
(1 row)
  OK: вывод идентичен выводу до перезапуска.
-- действующие сессии (токены не показываем)
$ docker compose --env-file .env exec -T db psql -U messenger -d messenger -c "SELECT count(*) AS live_sessions FROM sessions s JOIN users u ON u.id = s.user_id WHERE u.username IN ('demo_a_7681083c', 'demo_b_7681083c') AND s.expires_at > now()"
live_sessions 
---------------
             2
(1 row)
  OK: вывод идентичен выводу до перезапуска.

-- том тот же (дата создания не изменилась):
$ docker volume inspect mtusi-messenger_pgdata --format "{{.Name}}  создан: {{.CreatedAt}}"
mtusi-messenger_pgdata  создан: 2026-10-23T13:16:41+03:00
  OK: том не пересоздавался.

==============================================================================
ИТОГ
==============================================================================
ИТОГ: PASS -- пользователи, чат, сообщение и действующие сессии сохранились после удаления и повторного создания контейнеров (docker compose down, затем up -d).
