feat(ldd): реестр утверждений, evidence gate и runtime-проверки

docs/evidence/baseline-2026-10-27.md

@@ -0,0 +1,142 @@
+# LDD baseline: 2026-10-27
+
+Первый прогон доказательной проверки текущей функциональности LMS.
+Код приложения в этом прогоне не менялся; добавлены реестр claims, gate
+`evidenceCheck`, runtime- и migration-скрипты.
+
+## 1. Что проверялось
+
+Реестр: `docs/evidence/claims.json`, 31 утверждение.
+
+| Критичность | Claims | Proven | Gaps |
+|---|---:|---:|---:|
+| P0 | 19 | 19 | 0 |
+| P1 | 12 | 12 | 0 |
+| **Итого** | **31** | **31** | **0** |
+
+Домены:
+
+- доступы: аноним/студент/преподаватель/админ, чужие курс/лаба/студент/группа,
+  внутренние API identity;
+- повышение: dry-run, apply, идемпотентность, rollback, cancel;
+- жизненный цикл: академ, возврат, отчисление, архив, восстановление, вход;
+- профиль студента и скачивание сдач;
+- материалы и активы;
+- миграция V13 и полный upgrade с master-схемы;
+- аудит: токен, admin-only, сохранность после удаления, representative-хуки;
+- группы курса, авторство материалов, ведомость, UI/контракты, импорт, копирование лаб;
+- runtime-smoke полного стека.
+
+## 2. Команды и результаты
+
+### 2.1. Автоматические тесты
+
+```bash
+./gradlew test --rerun-tasks
+```
+
+Результат: **267 тестов, 0 failures, 0 errors, 0 skipped**.
+`ktlintCheck` и `detekt` — зелёные.
+
+### 2.2. LDD gate
+
+```bash
+./gradlew evidenceCheck
+```
+
+Результат: **31/31 claims proven, P0 gaps = 0**.
+Отчёт: `build/reports/evidence/index.md`.
+
+Gate устроен так:
+
+- каждый claim ссылается на конкретный JUnit-тест `Class#method`;
+- P0 без зелёного теста валит сборку;
+- P1-пробел показывается в отчёте;
+- runtime-проверки читаются из `build/evidence/*.json` и тоже должны быть
+  `passed`, если claim на них ссылается.
+
+### 2.3. Upgrade с master-схемы
+
+```bash
+./scripts/ldd-migration-upgrade.sh
+```
+
+Сценарий: одноразовая PostgreSQL 18, master identity `V1–V3`, academic
+`V1–V5`, progress `V1–V9,V11,V12`, синтетические данные, затем ветка:
+identity `V4–V10`, academic `V6–V12`, progress `V13`.
+
+Проверено:
+
+- `identity.audit_events` создана;
+- `students`, `groups`, `membership_history` сохранились;
+- `labs.course_id`, `chapters.course_id`, `article_assets` созданы;
+- `grade_comments.author_account_id`, `lab_grades.updated_by_account_id` созданы;
+- оценки и комментарии сохранились;
+- повторное применение `V13` идемпотентно.
+
+Результат: **PASS**, evidence: `build/evidence/migration.json`.
+
+### 2.4. Runtime-smoke полного стека
+
+```bash
+./scripts/ldd-runtime.sh
+```
+
+Сценарий: одноразовая БД, `bootJar`, запуск identity/academic/progress/gateway/web,
+реальные HTTP-вызовы через gateway.
+
+Проверено:
+
+- health всех пяти сервисов = `UP`;
+- `adminExists=false` до setup, создание админа, `/auth/me` = `ADMIN`;
+- создание группы, курса, преподавателя, привязка группы, создание лабы;
+- преподаватель входит и видит свой курс, лабу и состав группы;
+- чужой преподаватель получает `403` на курс, лабу и аудит;
+- админ видит audit-события `COURSE_CREATE`, `TEACHER_CREATE`,
+  `COURSE_TEACHER_ASSIGN`, `COURSE_GROUP_ATTACH`, `LAB_CREATE`;
+- web `/login` отдаёт `200`, публичное дерево материалов доступно, курсовая
+  материалы анонимно — `401`.
+
+Результат: **PASS**, evidence: `build/evidence/runtime.json`.
+Стек и одноразовая БД после прогона остановлены/удалены.
+
+## 3. Что это доказывает
+
+- Критичные P0-инварианты доступа, повышения, жизненного цикла, профиля,
+  материалов, миграции и аудита имеют зелёные автоматические свидетельства.
+- Приложение собирается, мигрируется с master-схемы и поднимается полным
+  стеком на чистой БД.
+- Ключевой доменный поток «админ → группа → курс → преподаватель → лаба»
+  проходит через реальные HTTP/gateway/БД, а не только через mock.
+- Чужой преподаватель не получает доступ к курсу/лабе/аудиту на реальном стеке.
+- Аудит пишется и читается; upgrade не теряет синтетические данные.
+
+## 4. Чего это не доказывает
+
+1. **Нет браузерного E2E.** Thymeleaf-тесты проверяют HTML, но не реальные
+   клики/JS/CSRF/редиректы в браузере.
+2. **Нет нагрузочных и конкурентных испытаний.** Advisory locks и гонки
+   проверены кодом и unit/integration-тестами, но не под нагрузкой.
+3. **Нет mutation testing.** Сила тестов измерена косвенно; следующий шаг —
+   PIT на `CourseAccessService`, `PromotionService`, `StudentProfileService`.
+4. **Нет property-based/model-based проверки повышения.** Один сценарный тест
+   не покрывает все комбинации курсов, степеней и академ-переходов.
+5. **Legacy-активы без `article_assets` остаются публичными.**
+6. **JWT живёт до 30 дней.** Web перепроверяет статус, прямой API — нет.
+7. **Ведущие нули номера группы нормализуются** (`01` → `1`).
+8. **Нет пагинации/keyset** для части списков и N+1 в отдельных экранах.
+9. **Runtime-smoke не входит в unit-CI**; он запускается отдельным скриптом
+   перед релизом.
+
+## 5. Вывод
+
+Текущая функциональность прошла первый LDD-контур: **P0 gaps = 0**,
+полный стек и upgrade работают. Это достаточное основание продолжать
+доработки, но не «формальное доказательство всей системы». Следующий цикл
+LDD должен добавить:
+
+1. mutation testing для критичных пакетов;
+2. property-based тесты повышения и матрицы доступа;
+3. браузерный E2E (Playwright) для ведомости, профиля и материалов;
+4. нагрузочный smoke на чтение ведомости/профиля;
+5. автоматический runtime-smoke в release-пайплайне.