Mermutef/LMS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
685916c4bd0948e309483b28db9e793fee769825
LMS/docs/11-stage1-report.md

5.3 KiB
Raw Blame History

11. Отчёт этапа 1: identity

Дата: 2026-10-23. Статус: этап 1 выполнен; этап 2 (academic) — следующий.

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

Роли и аккаунты

  • Добавлена роль TEACHER в LmsRole; БД уже допускает её миграцией V4.
  • Account получил status (ACTIVE/ARCHIVED) и archivedAt.
  • Вход запрещён для архивных аккаунтов и студентов в статусах EXPELLED/GRADUATED/ARCHIVED.

Группы-когорты

  • GroupEntity: stream, course, number, degree, enrollmentYear, status (ACTIVE/GRADUATED/ARCHIVED).
  • name больше не уникально; уникальность — по кортежу когорты.
  • GroupNameParser разбирает ПИ-11БО, ИВТ-ТОП-12БО и т.п.
  • GroupCohortResolver валидирует степень, курс, номер и год набора, вычисляет год набора по умолчанию.
  • Создание группы через админку — по полям, имя собирается автоматически.

Студенты и история

  • Student: status и enrollmentYear.
  • MembershipHistory: ENROLL, TRANSFER, IMPORT, EXPELL и остальные действия; записи создаются при зачислении, переводе, импорте и отчислении.
  • При отчислении студент получает EXPELLED, аккаунт и данные сохраняются.
  • Повторное зачисление возвращает ACTIVE и пишет TRANSFER.

Импорт Excel/CSV v2

Шаблон:

поток | курс | номер | степень | год набора | ФИО | № | база
  • Поддерживаются .xls, .xlsx, .csv, разделители ;, ,, tab.
  • ФИО можно одной колонкой или отдельными Фамилия/Имя/Отчество.
  • Все строки должны быть одной группой.
  • Проверяются степень, диапазон курса, год набора, пустые поля, дубли № внутри файла.
  • Импорт атомарный: при ошибках данные не меняются, возвращается отчёт с номерами строк.
  • Ключ слияния — student_no; группа ищется по кортежу, при отсутствии создаётся.
  • Новые студенты получают временный пароль; пароли показываются один раз.

UI

  • Страница групп: год набора, статус, создание по полям, описание нового импорта.
  • Страница группы: год набора, статус группы, статус студента.
  • Страница пользователей: статус студента.
  • При ошибке импорта показывается таблица «строка — ошибка».

2. Тесты

Добавлены:

  • GroupNameParserTest — разбор имени, диапазоны курсов;
  • StudentImportParserTest — валидный шаблон, дубли, разные группы, недопустимый курс, неизвестная шапка;
  • GroupServiceIntegrationTest — создание когорты, дубликат, импорт, атомарность ошибок, перевод, отчисление, запрет входа после отчисления.

Проверки:

  • ./gradlew :services:identity-service:test :web:test — успешно;
  • ktlintCheck и detekt для identity/web — успешно.

3. Ограничения этапа

  • Импорт поддерживает одну группу на файл; мультигрупповой файл — позже.
  • Номер группы числовой (01 и 1 — одно значение). Отдельный строковый номер и различие ПИ-11БО/ПИ-101БО как разных когорт не требуются; имя группы по-прежнему строится из полей.
  • Роль TEACHER уже есть в домене, но кабинет преподавателя и назначения на курс — этапы 2–3.
  • ACADEMIC_LEAVE пока может входить; режим «только чтение» — этап 3.
  • Отчисление пока простое; причины, подтверждение и аудит — этап 4.
  • Старый формат импорта (только студенческие колонки) больше не поддерживается.

4. Следующий этап

Этап 2 — academic:

  • курсы, course_teachers, course_groups;
  • course_no и /learn/course/{course_no}/...;
  • labs.course_id и перенос лаб в курс C;
  • chapters.course_id/audience, перенос материалов;
  • активы и копирование лабораторных;
  • админ-UI курсов.