Refactor/modules

[Toksi86]

Что изменено

• Создана базовая структура документации проекта:

  • обновлён корневой README.md;
  • добавлены разделы docs/development.md, docs/architecture.md, docs/api.md, docs/devops-state.md;
  • добавлена структура docs/modules/ для описания доменных модулей;
  • документация по чатам перенесена в docs/modules/chats.md.

• Улучшен модуль курсов:

  • file_ids в ответах теперь могут ссылаться только на файлы текущего пользователя;
  • после ручной проверки ответа через Django admin пересчитывается прогресс урока, модуля и курса;
  • для read API курсов добавлен явный helper сериализации response payload;
  • добавлены regression-тесты на прикрепление чужого файла и пересчёт прогресса после admin review;
  • добавлен TODO по техническому долгу вокруг admin upload flow.

• Расширено тестовое покрытие модуля курсов:

  • добавлены model validation тесты для UserTaskAnswer, UserTaskAnswerOption, UserTaskAnswerFile;
  • добавлены model validation тесты для CourseModule, CourseTask, CourseTaskOption;
  • расширены тесты доступности курса, модуля и урока;
  • расширены тесты расчёта прогресса и обновления progress-записей;
  • добавлен сложный regression-сценарий: несколько модулей, несколько уроков, 5+ заданий, частичный прогресс и задание с ручной проверкой;
  • повторяющийся setup тестов вынесен в create_course_context().

• Заполнена и дополнена документация модуля курсов в docs/modules/courses.md:

  • назначение модуля;
  • основные возможности;
  • архитектура;
  • ключевые сущности;
  • API;
  • основные пользовательские сценарии;
  • ограничения;
  • структура и критичные сценарии тестового покрытия.