feat(web): перевести браузерные URL курсов на courseNo

- teacher/admin course pages, content, gradebook, profile, downloads - courseNo -> UUID только на границе REST API - обновлены e2e, шаблоны, тесты и docs - LDD-UI-002; baseline 59 claims / 385 тестов
2026-10-29 19:51:03 +03:00
parent b57a5ffbce
commit 65ed08f5c2
45 changed files with 1058 additions and 352 deletions
--- a/docs/08-groups-courses-plan.md
+++ b/docs/08-groups-courses-plan.md
@@ -336,10 +336,10 @@ identity V13, **academic V12**, progress V13.
 - **Этап 6 — выполнен.** Права преподавателя на запись (лабораторные,
  ведомость, группы, материалы), центральный аудит `identity.audit_events`
  с `/admin/audit`, CI merge gate и полный hardening. Проверены прогон
-  тестов/линтеров (**368**, 0 failures), upgrade миграций с master-схемы
+  тестов/линтеров (**385**, 0 failures), upgrade миграций с master-схемы
  (identity `V4–V13`, academic `V6–V12`, progress `V13`), security-матрица,
-  gateway, видимость активов и deploy-runbook. LDD baseline: **58 claims
-  (27 P0 / 31 P1), P0 gaps = 0**, browser E2E 18/18 (3 браузера). Отчёт:
+  gateway, видимость активов и deploy-runbook. LDD baseline: **59 claims
+  (27 P0 / 32 P1), P0 gaps = 0**, browser E2E 18/18 (3 браузера). Отчёт:
  [16-stage6-report.md](16-stage6-report.md).

 ### 9.1. Известные пробелы после этапа 6
--- a/docs/12-stage2-report.md
+++ b/docs/12-stage2-report.md
@@ -1,5 +1,7 @@
 # 12. Отчёт этапа 2: academic (курсы и лабораторные)

+> **Историческая справка:** в этом отчёте браузерные URL показаны с UUID курса. После перехода 2026-10-29 текущие URL используют `courseNo`; REST API по-прежнему принимает UUID.
+
 **Дата:** 2026-10-27.
 **Статус:** этап 2 выполнен; этап 3 (доступ и профиль студента курса) — следующий.

--- a/docs/13-stage3-report.md
+++ b/docs/13-stage3-report.md
@@ -1,5 +1,7 @@
 # 13. Отчёт этапа 3: доступ и профиль студента курса

+> **Историческая справка:** в этом отчёте браузерные URL показаны с UUID курса. После перехода 2026-10-29 текущие URL используют `courseNo`; REST API по-прежнему принимает UUID.
+
 **Дата:** 2026-10-27.
 **Статус:** этап 3 выполнен; этап 4 (повышение и жизненный цикл) — следующий.

--- a/docs/15-stage5-course-materials.md
+++ b/docs/15-stage5-course-materials.md
@@ -64,7 +64,7 @@
 ## Авторство материалов преподавателем (добавлено на этапе 6)

 Преподаватель своего курса редактирует главы, разделы и статьи на
-`/teacher/courses/{id}/content`: создание/переименование/удаление, markdown-
+`/teacher/courses/{courseNo}/content`: создание/переименование/удаление, markdown-
 редактор с предпросмотром, публикация/снятие с публикации. API —
 `/api/v1/courses/{courseId}/content/**`; любая изменяемая сущность проверяется
 на принадлежность курсу. Глобальные материалы (`course_id IS NULL`,
--- a/docs/16-stage6-report.md
+++ b/docs/16-stage6-report.md
@@ -68,12 +68,12 @@
 | identity-service | 105 | 0 | 0 | 0 |
 | academic-service | 106 | 0 | 0 | 0 |
 | progress-service | 38 | 0 | 0 | 0 |
-| web | 112 | 0 | 0 | 0 |
+| web | 129 | 0 | 0 | 0 |
 | gateway | 2 | 0 | 0 | 0 |
 | markdown | 5 | 0 | 0 | 0 |
-| **Итого на момент этапа 6** | **368** | **0** | **0** | **0** |
+| **Итого на момент этапа 6** | **385** | **0** | **0** | **0** |

-После закрытия рисков актуальный LDD-baseline — **368 тестов, 0 failures**
+После закрытия рисков актуальный LDD-baseline — **385 тестов, 0 failures**
 (см. раздел 7). `ktlintCheck` и `detekt` прошли без замечаний. У gateway теперь есть unit-тесты публичных auth-путей и 401; маршрутизация
 gateway дополнительно проверена конфигурацией и security-матрицей ниже.
 Тот же набор команд выполняет `.woodpecker/` (Gitea + Woodpecker 3.x); на
@@ -133,7 +133,7 @@ gateway дополнительно проверена конфигурацией

 ### 2.3. Security-проверки

-Проверено автоматическими тестами (актуальный прогон — 368 тестов, 0 failures)
+Проверено автоматическими тестами (актуальный прогон — 385 тестов, 0 failures)
 и разбором конфигурации gateway. Запись преподавателя дополнительно покрыта
 negative-тестами «свой/чужой курс».

@@ -252,10 +252,10 @@ legacy-активов на production, сдачи по выбранной лаб
  `/admin/labs`, `/admin/teachers`, `/admin/promotion`.
 - [ ] **Преподаватель:** вход, `/teacher`, карточка своего курса (имена групп,
  привязка/отвязка группы по `available-groups`), ведомость
-  `/admin/groups/{groupId}?courseId=...` без админских контролов, оценка и
+  `/admin/groups/{groupId}?courseNo=...` без админских контролов, оценка и
  публикация, уровень/вариант и раздача, защита (код/reset), профиль студента,
  скачивание попытки и ZIP группы, авторство материалов
-  `/teacher/courses/{id}/content`.
+  `/teacher/courses/{courseNo}/content`.
 - [ ] **Студент:** вход, дашборд, лабораторная, сдача/история, курсовые
  материалы; видны только опубликованные оценки и комментарии.
 - [ ] **Материалы курса:** админ и преподаватель видят скрытые статьи, студент —
@@ -347,10 +347,10 @@ web-сессия с отзывом и абсолютным потолком, key
 ## 7. LDD baseline

 После этапа 6 и закрытия рисков текущая функциональность проверена через
-LDD-контур: реестр `docs/evidence/claims.json` (**58 claims, 27 P0 / 31 P1**),
+LDD-контур: реестр `docs/evidence/claims.json` (**59 claims, 27 P0 / 32 P1**),
 gate `./gradlew evidenceCheck`, upgrade-скрипт, runtime-smoke, smoke-workflow,
 mutation testing и браузерный Playwright E2E. Результат:
-**58/58 claims proven, P0 gaps = 0, 368 тестов, 0 failures**; mutation strength
+**59/59 claims proven, P0 gaps = 0, 385 тестов, 0 failures**; mutation strength
 `CourseAccessService` 75%, `PromotionPlanner` 69%; browser E2E 18/18 (6 сценариев × Chromium/Firefox/WebKit);
 конкурентные apply/rollback и масштабный нагрузочный smoke (100 групп /
 1000 студентов, 125 параллельных чтений, 0 ошибок, p95 < 1 с) зелёные.
--- a/docs/17-handoff.md
+++ b/docs/17-handoff.md
@@ -116,8 +116,8 @@
 ### 1.8. LDD и проверки

 - Реестр: `docs/evidence/claims.json`.
- **58 claims**: 27 P0 + 31 P1; **58/58 proven, P0 gaps = 0**.
- **368 автотестов**, 0 failures/errors/skipped.
+- **59 claims**: 27 P0 + 32 P1; **59/59 proven, P0 gaps = 0**.
+- **385 автотестов**, 0 failures/errors/skipped.
 - Mutation testing:
  - `CourseAccessService` — 75% test strength;
  - `PromotionPlanner` — 69%.
@@ -194,8 +194,8 @@ cat build/reports/evidence/index.md
 ```

 Последний подтверждённый результат:
- `368` тестов, 0 failures;
- `58/58` claims, P0 gaps = 0;
+- `385` тестов, 0 failures;
+- `59/59` claims, P0 gaps = 0;
 - `ldd-release.sh` — PASS;
 - smoke — PASS;
 - browser E2E — 18/18 (Chromium/Firefox/WebKit);
@@ -275,8 +275,8 @@ cat build/reports/evidence/index.md
   `feature/groups-courses`.
 2. Прочитать этот файл, затем `docs/16-stage6-report.md` §7 и
   `docs/evidence/baseline-2026-10-27.md`.
-3. `./gradlew test ktlintCheck detekt evidenceCheck` — должно быть 368 тестов
-   и 58 claims, 58/58 proven.
+3. `./gradlew test ktlintCheck detekt evidenceCheck` — должно быть 385 тестов
+   и 59 claims, 59/59 proven.
 4. Для release-проверки: `./scripts/ldd-release.sh`.
 5. Для быстрой проверки: `./scripts/ldd-smoke.sh` и `./scripts/ci-preflight.sh`.
 6. Продолжать backlog из §3, начиная с инвентаризации legacy-активов и
--- a/docs/18-goal-audit.md
+++ b/docs/18-goal-audit.md
@@ -20,13 +20,13 @@
 | Импорт v2 | partial | Есть флаг восстановления неактивных; row-level отчёт для DB-конфликтов неполный; legacy-группы с NULL-полями |
 | Курсы, преподаватели, группы курса | implemented | — |
 | Материалы и активы | implemented | Глобальные `STUDENTS`/`TEACHERS` теперь работают; импорт глобальных глав всё ещё создаёт только `ALL` |
-| Профиль студента | partial | Браузерный URL использует UUID вместо `courseNo`; часть полей контракта 09 отличается; нет лимита/пагинации попыток; нет SQL-теста «без N+1» |
+| Профиль студента | partial | URL уже `courseNo`; часть полей контракта 09 отличается; нет лимита/пагинации попыток; нет SQL-теста «без N+1» |
 | Повышение | partial | Догон при старте ищет только текущий год, не предыдущий; нет теста apply-конфликта |
 | Аудит | partial | Добавлены `GROUP_CREATE`, `STUDENT_CREATE`, `GROUP_IMPORT`, `GROUP_ENROLL`; отдельных тестов на эти события пока нет |
 | Backup/deploy | partial | `deploy.sh` теперь проверяет последний backup; restore на staging не подтверждён; первый деплой без backup — документированное исключение |
 | CI | partial | Конфигурация Woodpecker и локальные прогоны есть; первый реальный pipeline на VM не подтверждён |
 | Производительность | partial | Keyset-аудит, пакетные лабы и группы курса есть; списки материалов/групп без пагинации; сдачи в ведомости по выбранной лабе |
-| LDD | implemented | 58 claims (27 P0 / 31 P1), 58/58 proven после release; `check` доказывает P0/unit, runtime P1 — release |
+| LDD | implemented | 59 claims (27 P0 / 32 P1), 59/59 proven после release; `check` доказывает P0/unit, runtime P1 — release |
 | Legacy-активы | partial | Код и UI готовы; инвентаризация на production/staging не выполнена |
 | «Контингент» | out of scope | Исключён решением 2026-10-28 |

@@ -79,7 +79,11 @@
   - Старые комментарии без автора показывают «автор не указан».
   - Студенческий профиль не показывает черновики лабораторных.

-10. **Импорт: ошибки до записи.**
+10. **Браузерные URL курсов — `courseNo`.**
+    Страницы преподавателя, админа, материалы и профиль студента принимают
+    человеческий номер курса; REST API продолжает работать с UUID.
+
+11. **Импорт: ошибки до записи.**
    - Занятый логин и неактивная целевая группа возвращают `applied=false`
      с номером строки и не создают частичных записей.
    - Тесты: `GroupServiceIntegrationTest#import reports occupied login...`,
@@ -89,9 +93,9 @@

 ### P1

- **Профиль: контракт.** Браузерные маршруты используют UUID курса, а docs/09
-  обещает `courseNo`; часть полей `variant/level/grade` отличается от контракта.
-  Нужно либо привести код к контракту, либо официально обновить контракт.
+- **Профиль: поля контракта.** URL уже используют `courseNo`, но часть полей
+  `variant/level/grade` и авторы комментариев отличаются от docs/09; нужен
+  либо код к контракту, либо официальное обновление контракта.
 - **Backup restore на staging** не подтверждён артефактом/логом.
 - **Первый реальный CI pipeline** на Woodpecker VM не подтверждён.

@@ -138,9 +142,9 @@

 ## 5. LDD

- Реестр: `docs/evidence/claims.json`, **58 claims** (27 P0 / 31 P1).
+- Реестр: `docs/evidence/claims.json`, **59 claims** (27 P0 / 32 P1).
 - `./gradlew test ktlintCheck detekt evidenceCheck` — зелёный; P0 gaps = 0.
- `./scripts/ldd-release.sh` — PASS: **58/58 claims**, 368 тестов, mutation
+- `./scripts/ldd-release.sh` — PASS: **59/59 claims**, 385 тестов, mutation
  `CourseAccessService` 75%, `PromotionPlanner` 69%, browser E2E 18/18,
  runtime/load p95 < 1 с.

--- a/docs/README.md
+++ b/docs/README.md
@@ -27,7 +27,7 @@ Preview Mermaid Support) и в IntelliJ IDEA (плагин Mermaid).
 | [17-handoff.md](17-handoff.md) | Handoff: что уже внесено, что осталось, как восстановить контекст и прогнать проверки |
 | [18-goal-audit.md](18-goal-audit.md) | Сверка целевой модели из docs/07–09 с фактическим кодом: статусы, остаточные отличия, решения |
 | [evidence/README.md](evidence/README.md) | LDD: реестр утверждений, evidence gate, runtime- и migration-проверки |
-| [evidence/baseline-2026-10-27.md](evidence/baseline-2026-10-27.md) | LDD-baseline: 58 claims, 368 тестов, upgrade, runtime/scale, mutation и browser E2E |
+| [evidence/baseline-2026-10-27.md](evidence/baseline-2026-10-27.md) | LDD-baseline: 59 claims, 385 тестов, upgrade, runtime/scale, mutation и browser E2E |
 | [ADR 0001](adr/0001-groups-courses-foundation.md) | Ключевые архитектурные решения: курс C, миграции, доступ, статусы, повышение |

 ## Кратко о системе
--- a/docs/evidence/README.md
+++ b/docs/evidence/README.md
@@ -87,8 +87,8 @@ Platform 6 из Spring Boot 4.
 LDD-циклы выполнены 2026-10-27/28; последний — после закрытия продуктовых
 рисков:

- **368 автоматических тестов**, 0 failures/errors;
- **58 claims**: 27 P0 + 31 P1, **58/58 proven, P0 gaps = 0**. P0 — доступы,
+- **385 автоматических тестов**, 0 failures/errors;
+- **59 claims**: 27 P0 + 32 P1, **59/59 proven, P0 gaps = 0**. P0 — доступы,
  повышение, жизненный цикл, профиль/скачивание, материалы/активы
  (включая secure-by-default legacy-файлы), миграции V11–V13, аудит,
  refresh-токены и их отзыв; P1 — группы, авторство, UI, контракты, импорт,
--- a/docs/evidence/baseline-2026-10-27.md
+++ b/docs/evidence/baseline-2026-10-27.md
@@ -40,7 +40,7 @@ Playwright. В ходе проверки найден и исправлен ре
 ./gradlew test --rerun-tasks
 ```

-Результат: **368 тестов, 0 failures, 0 errors, 0 skipped**.
+Результат: **385 тестов, 0 failures, 0 errors, 0 skipped**.
 `ktlintCheck` и `detekt` — зелёные.

 ### 2.2. LDD gate
@@ -49,7 +49,7 @@ Playwright. В ходе проверки найден и исправлен ре
 ./gradlew evidenceCheck
 ```

-Результат: **58/58 claims proven, P0 gaps = 0**.
+Результат: **59/59 claims proven, P0 gaps = 0**.
 Отчёт: `build/reports/evidence/index.md`.

 Gate устроен так:
@@ -306,8 +306,8 @@ optional json fields`.

 ## 5. Вывод

-Текущая функциональность прошла LDD-контур: **58/58 claims proven, P0 gaps = 0**,
-**368 тестов**, upgrade, mutation baseline, 18/18 browser E2E, smoke и
+Текущая функциональность прошла LDD-контур: **59/59 claims proven, P0 gaps = 0**,
+**385 тестов**, upgrade, mutation baseline, 18/18 browser E2E, smoke и
 масштабный load зелёные. Это достаточное основание продолжать доработки, но не
 «формальное доказательство всей системы».

--- a/docs/evidence/claims.json
+++ b/docs/evidence/claims.json
@@ -854,6 +854,24 @@
        "ru.ysu.lms.identity.roster.GroupServiceIntegrationTest#import reports inactive target group and writes nothing()"
      ],
      "limitations": "Неожиданные ошибки БД вне известных preflight-проверок всё ещё откатывают транзакцию без построчного отчёта."
+    },
+    {
+      "id": "LDD-UI-002",
+      "title": "Браузерные URL курсов используют courseNo",
+      "criticality": "P1",
+      "status": "active",
+      "requirement": "docs/07-groups-courses.md, §0.2; docs/09 §8",
+      "claim": "Страницы преподавателя, админа, материалы и профиль строят URL по courseNo, а REST API вызывают с UUID курса.",
+      "oracle": "Ссылки/redirects шаблонов и контроллеров содержат courseNo, API получает UUID",
+      "evidence": [
+        "ru.ysu.lms.web.teacher.TeacherCourseTemplateTest#course links use human course number instead of uuid()",
+        "ru.ysu.lms.web.teacher.TeacherCourseContentControllerTest#content page resolves course by human number and keeps uuid for api()",
+        "ru.ysu.lms.web.admin.AdminCourseControllerTest#detail page resolves course by number and calls api with uuid()",
+        "ru.ysu.lms.web.admin.AdminCourseTemplateTest#course page forms and actions use human number()",
+        "ru.ysu.lms.web.admin.AdminGroupControllerTest#teacher gradebook resolves course number and scopes api calls by uuid()",
+        "ru.ysu.lms.web.profile.StudentProfileTemplateTest#renders student profile with labs, comments and downloads()"
+      ],
+      "limitations": "Внутренние REST-контракты остаются UUID; form payload создания/копирования лабораторной тоже использует UUID."
    }
  ]
 }