10. Отчёт этапа 0: схема, контракты, preflight

Дата: 2026-10-23. Статус: этап 0 выполнен на локальной копии БД; перед production нужен повторный preflight на свежей копии.

1. Что сделано

ADR с ключевыми решениями: adr/0001-groups-courses-foundation.md.
Контракт API профиля студента: 09-teacher-student-profile.md.
Миграции:
- identity V4–V11: роли, группы-когорты, статусы студентов, повышение, история членства, статусы аккаунтов; V10 (audit_events) добавлена позже, на этапе 6; V11 (refresh_tokens) — при закрытии рисков аутентификации, тоже после этого отчёта;
- academic V6–V12: курсы, преподаватели, группы курса, labs.course_id, материалы курса/аудитории, индексы активов; V10 (уникальный индекс lower(title) по курсам) добавлена на этапе 2, после этого отчёта; V11 backfill-ом проставляет audience='ALL' глобальным главам; V12 backfill-ом восстанавливает связи article_assets из markdown-ссылок;
- progress V13: автор комментария и последнего изменения оценки.
Preflight-скрипты:
- deploy/preflight/groups-courses.sql — до миграций;
- deploy/preflight/groups-courses-post.sql — после миграций/bootstrap;
- deploy/preflight/progress-v10-v13.sql — переход старой feature-миграции progress V10 на V13.
UI: статус защиты в ведомости различает «готова» и «кончилось время».
Резервное копирование:
- deploy/backup.sh — БД + решения + материалы, checksums, retention, list, verify, restore;
- deploy/deploy.sh up делает обязательный backup перед обновлением;
- systemd timer для ежедневного backup;
- инструкция deploy/BACKUP.md.

2. Проверка на пустой БД

Все миграции identity, academic и progress применены последовательно на чистой БД PostgreSQL 18. Ошибок нет. Тесты сервисов на Testcontainers проходят.

3. Проверка на копии локальной БД

Скопирована локальная БД lms (41 аккаунт, 40 студентов, 2 группы, 1 лаба, 3 главы, 16 разделов, 35 статей, 6 комментариев).

Preflight до миграций:

групп, не подходящих под шаблон, нет;
конфликтующих кортежей когорт нет;
дублей номеров лабораторных нет;
дублей slug глав нет;
студентов без группы нет.

Миграции применены успешно.

После миграций:

labs_without_course = 1 — ожидаемо до bootstrap;
chapters_without_course = 3 — ожидаемо до bootstrap;
courses = 0 — ожидаемо до bootstrap;
comments_without_author = 6 — ожидаемо для старых комментариев;
группы разобраны полностью, enrollment_year заполнен.

4. Симуляция bootstrap

На копии вручную выполнено то, что будет делать bootstrap-сервис:

Создан курс C с владельцем-админом, course_no = 1.
Админ назначен преподавателем курса.
Обе активные группы привязаны к курсу.
Все лабы и главы получили course_id.
Выполнено ALTER TABLE labs ALTER COLUMN course_id SET NOT NULL.

Postflight:

labs_without_course = 0;
chapters_without_course = 0;
курс C ровно один;
comments_without_author = 6 — старые данные, ожидаемо;
группы без полного разбора отсутствуют.

5. Тесты и линтеры

./gradlew :services:identity-service:test :services:academic-service:test :services:progress-service:test :web:test — успешно.
./gradlew ktlintCheck detekt — успешно.
node --check web/src/main/resources/static/js/admin-group.js — успешно.
bash -n deploy/backup.sh deploy/deploy.sh — успешно.
./deploy/backup.sh backup на локальной БД — успешно; verify проверил db.dump, submissions.tar.gz, assets.tar.gz по SHA256.
git diff --check — успешно.

6. Что осталось на этап 2

Реализовать bootstrap-сервис курса C (создание курса, привязка групп, назначение админа, перенос лаб/глав).
Выбрать механизм post-bootstrap SET NOT NULL (CLI, admin endpoint или отдельная Flyway-локация).
Связать существующие активы со статьями при миграции контента.
Повторить preflight на свежей копии production-БД перед деплоем.

5.6 KiB Raw Blame History Unescape Escape