67/plan.md

План задач для Fable

Источник требований: ТЗ_единый.md.

Визуальный референс: https://donstu.ru/.

Назначение системы по ТЗ: единая централизованная цифровая платформа университета для хранения, систематизации, управления и распространения медиаконтента.

Важно: не добавлять реальные данные, людей, подразделения, интеграции, юридические сведения, брендовые материалы или функциональность, которых нет в ТЗ или в явно подтвержденных требованиях. Если нужен контент для макетов, использовать явно помеченные демо-заглушки.

0. Ограничения и продуктовые правила

• Строить платформу управления медиаконтентом университета, а не общий сайт университета.
• Реализовать два контура: публичный доступ и персонифицированный доступ после аутентификации.
• Использовать русский язык интерфейса.
• Учитывать группы пользователей из ТЗ: студенты, преподаватели, сотрудники редакций, приглашенные спикеры, администраторы.
• Использовать начальную ролевую модель из ТЗ: администратор, редактор, менеджер, пользователь.
• Не копировать логотипы, фотографии, тексты и брендовые материалы donstu.ru, если они не предоставлены отдельно.
• Использовать donstu.ru только как референс по структуре, визуальному языку и UX-паттернам.
• Все спорные пункты выносить в список вопросов, а не додумывать самостоятельно.

1. Дизайн и UI-система

• Сделать адаптивную UI-систему в официальном университетском стиле по мотивам donstu.ru.
• Использовать визуальные признаки референса: крупная типографика, официальный синий акцент, светлые секции, контрастные кнопки, карточная сетка, большие отступы.
• Использовать синий акцент, близкий к #11519c, как у donstu.ru, если заказчик не предоставит другую палитру.
• Использовать современный гротеск в духе Golos, как на референсе, либо доступный аналог.
• Реализовать переключатель светлой и темной темы.
• Реализовать панель доступности: размер текста, цветовая схема, включение/отключение изображений.
• Реализовать переиспользуемые компоненты: шапка, полноэкранное меню, поиск, вкладки, карточки, кнопки, формы, фильтры, таблицы, модальные окна, предпросмотр медиа.
• Проверить все ключевые экраны на desktop и mobile.
• Не делать визуальный клон donstu.ru; задача — использовать референс как направление.

2. Публичный контур

• Создать публичную главную страницу платформы.
• Добавить верхнюю шапку с меню, поиском, переключателем темы, кнопкой доступности и входом в личный кабинет.
• Добавить полноэкранное меню по примеру donstu.ru.
• В меню использовать только разделы, относящиеся к платформе: новости, медиа, мероприятия, спикеры, категории, вход.
• Добавить hero-блок для избранного публичного контента.
• Добавить популярные поисковые запросы или быстрые фильтры, если для них есть данные; иначе показать демо-заглушки.
• Добавить публичный блок новостей и статей с вкладками категорий.
• Добавить публичный блок медиаматериалов: аудио, видео, текстовые и графические материалы.
• Добавить публичный блок мероприятий, так как просмотр мероприятий указан в ТЗ.
• Добавить публичный блок спикеров, так как поиск спикеров указан в ТЗ.
• Добавить футер с навигацией по платформе и сервисными ссылками в пределах подтвержденного объема.

3. Каталоги, поиск и просмотр материалов

• Реализовать глобальный полнотекстовый поиск по всем типам контента.
• Добавить фильтрацию по категориям, авторам, тегам, типам контента и дате.
• Добавить сортировку результатов.
• Добавить страницу результатов поиска.
• Добавить состояния загрузки, ошибки и пустой выдачи.
• Создать публичный каталог публикаций.
• Создать публичный каталог медиаматериалов.
• Создать публичный каталог мероприятий.
• Создать публичный каталог спикеров.
• Создать страницу детального просмотра публикации или медиаматериала.
• Создать страницу детального просмотра спикера.
• Уточнить, является ли мероприятие отдельной сущностью или типом публикации/медиаматериала, потому что в ТЗ мероприятия есть в функциях, но отсутствуют в таблице информационных объектов.

4. Аутентификация и доступ

• Реализовать регистрацию пользователя.
• Реализовать вход по логину и паролю.
• Реализовать token-based authentication.
• Реализовать выход из системы.
• Реализовать смену пароля.
• Хранить пароли только в защищенном хэшированном виде.
• Связывать действия пользователя с его учетной записью.
• Защитить маршруты персонифицированного контура.
• Добавить обработку истекшей или некорректной сессии.

5. Профиль пользователя

• Создать страницу профиля пользователя.
• Реализовать редактирование профиля.
• Показывать роль и уровень доступа пользователя.
• Показывать подписки пользователя.
• Показывать уведомления пользователя.
• Показывать действия пользователя там, где это разрешено ролью.

6. Управление контентом

• Реализовать создание публикаций.
• Реализовать редактирование публикаций.
• Реализовать удаление публикаций с учетом прав доступа.
• Реализовать публикацию и архивирование материалов.
• Реализовать загрузку медиаматериалов: аудио, видео, текстовые и графические файлы.
• Реализовать назначение категорий.
• Реализовать назначение тегов.
• Реализовать метаданные автора.
• Реализовать управление видимостью материала с учетом роли.
• Реализовать жизненный цикл контента: создание, модерация, проверка, публикация, архивирование.
• Показывать статус модерации материала.
• Реализовать сохранение черновика.

7. Подписки и уведомления

• Реализовать подписку на категории.
• Реализовать подписку на спикеров.
• Реализовать подписку на темы или теги, если они утверждены как направления/темы.
• Реализовать подписку на мероприятия, если мероприятие утверждено как отдельная сущность.
• Создать персональную ленту по подпискам.
• Создавать уведомления о новом контенте по подпискам.
• Реализовать центр уведомлений.
• Реализовать статусы уведомлений: прочитано и не прочитано.

8. Комментарии и взаимодействие

• Реализовать комментарии для авторизованных пользователей.
• Реализовать создание комментария.
• Реализовать редактирование и удаление комментария с учетом прав доступа.
• Добавить модерацию комментариев, если это требуется ролевой моделью.
• Показывать комментарии на странице детального просмотра материала.
• Добавить состояния загрузки и пустого списка комментариев.

9. Административная панель

• Создать административный dashboard.
• Реализовать управление пользователями.
• Реализовать управление ролями.
• Реализовать управление правами доступа.
• Реализовать очередь модерации контента.
• Реализовать управление медиатекой.
• Реализовать управление категориями.
• Реализовать управление тегами.
• Реализовать управление спикерами.
• Реализовать управление уведомлениями.
• Реализовать просмотр журнала действий.
• Реализовать аналитический dashboard.

10. Аналитика

• Считать просмотры публикаций.
• Считать активность пользователей.
• Считать количество подписчиков.
• Показывать популярность публикаций.
• Показывать показатели эффективности контента, если формула показателей согласована.
• Формировать аналитические отчеты или экран отчетов.
• Ограничить доступ к аналитике ролями.

11. Модель данных

• Спроектировать сущность User.
• Спроектировать сущность Role.
• Спроектировать сущность Permission.
• Спроектировать связь UserRole.
• Спроектировать сущность Speaker.
• Спроектировать сущность MediaMaterial.
• Спроектировать сущность Category.
• Спроектировать сущность Tag.
• Спроектировать сущность Subscription.
• Спроектировать связь подписки на спикера.
• Спроектировать связь подписки на категорию.
• Спроектировать сущность Comment.
• Спроектировать сущность Notification.
• Спроектировать сущность ActionLog.
• Уточнить и при необходимости спроектировать сущность Event.

12. Backend-архитектура

• Реализовать backend business logic на Go.
• Разделить backend на Go-микросервисы.
• Использовать Elysia.js как API gateway/router layer.
• Запускать gateway на выбранном JS runtime: Bun, Node.js или Deno.
• Для Elysia.js считать Bun предпочтительным вариантом, если совместимость Node.js/Deno не подтверждена отдельно.
• Пропускать все frontend API-запросы через Elysia gateway.
• Держать Go-сервисы внутренними, за gateway.
• Использовать PostgreSQL как основную реляционную БД.
• Использовать CDN или media storage для загруженных медиафайлов.
• Обеспечить единые auth, RBAC, request context, logging и error handling через gateway и сервисы.

13. Go-микросервисы

• Auth service: регистрация, вход, токены, смена пароля.
• User service: профили, пользователи, роли, права доступа.
• Content service: публикации, медиаматериалы, черновики, публикация, архивирование.
• Taxonomy service: категории и теги.
• Speaker service: профили спикеров и подписки на спикеров.
• Subscription service: подписки на категории, темы/теги и спикеров.
• Notification service: создание уведомлений, статусы прочитано/не прочитано.
• Comment service: комментарии авторизованных пользователей и hooks для модерации.
• Search service: полнотекстовый поиск, фильтры, сортировка.
• Analytics service: просмотры, активность, подписчики, отчеты.
• Audit service: журнал действий пользователей и администраторов.
• Media service: валидация загрузок, метаданные файлов, ссылки на CDN/media storage.
• Event service добавлять только после подтверждения отдельной сущности мероприятий.

14. Elysia Gateway

• Создать маршруты /api/auth/* к Auth service.
• Создать маршруты /api/users/* к User service.
• Создать маршруты /api/content/* к Content service.
• Создать маршруты /api/media/* к Media service.
• Создать маршруты /api/categories/* и /api/tags/* к Taxonomy service.
• Создать маршруты /api/speakers/* к Speaker service.
• Создать маршруты /api/subscriptions/* к Subscription service.
• Создать маршруты /api/notifications/* к Notification service.
• Создать маршруты /api/comments/* к Comment service.
• Создать маршруты /api/search/* к Search service.
• Создать маршруты /api/analytics/* к Analytics service.
• Создать маршруты /api/admin/* для admin-only операций.
• Валидировать входящие запросы на gateway.
• Передавать authenticated user context во внутренние Go-сервисы.
• Централизовать CORS на gateway.
• Централизовать rate limiting на gateway.
• Централизовать auth middleware на gateway.
• Централизовать формат ошибок на gateway.
• Добавить health checks для gateway и каждого Go-сервиса.

15. Взаимодействие микросервисов

• Начать с HTTP/JSON между Elysia gateway и Go-сервисами, если не появится подтвержденная причина использовать другой транспорт.
• Описать OpenAPI-контракты для каждого сервиса.
• Сделать внутренние URL сервисов настраиваемыми через environment variables.
• Использовать единый формат error response.
• Добавить request ID для трассировки через gateway и сервисы.
• Добавить structured logs.
• Добавить базовые метрики состояния сервисов.

16. API и хранение данных

• Создать миграции PostgreSQL.
• Создать API для аутентификации.
• Создать API для пользователей, ролей и прав.
• Создать API для публикаций и медиаматериалов.
• Создать API для категорий и тегов.
• Создать API для спикеров.
• Создать API для подписок.
• Создать API для комментариев.
• Создать API для уведомлений.
• Создать API для поиска.
• Создать API для аналитики.
• Создать API для журнала действий.
• Создать abstraction layer для CDN/media storage.

17. Безопасность

• Требовать аутентификацию для функций персонифицированного контура.
• Реализовать role-based access control.
• Разграничить доступ к данным по ролям.
• Проверять права доступа на каждом защищенном API endpoint.
• Защитить персональные данные согласно требованиям законодательства РФ, указанным в ТЗ.
• Валидировать загружаемые файлы.
• Ограничить типы и размеры загружаемых файлов.
• Журналировать действия пользователей и администраторов.
• Не раскрывать внутренние URL Go-сервисов наружу.

18. Frontend

• Использовать React и TailwindCSS, как указано в ТЗ.
• Построить публичный контур.
• Построить персонифицированный контур.
• Построить административную панель.
• Подключить frontend к Elysia gateway.
• Реализовать protected routes.
• Реализовать role-based UI states.
• Реализовать адаптивность для мобильных устройств.
• Реализовать кроссбраузерную совместимость.

19. Тестирование

• Добавить unit tests.
• Добавить integration tests.
• Добавить system tests.
• Добавить security tests.
• Добавить load tests.
• Протестировать публичный контур без авторизации.
• Протестировать персонифицированный контур с авторизацией.
• Протестировать ролевые ограничения.
• Протестировать загрузку медиафайлов.
• Протестировать поиск, фильтры и сортировку.
• Протестировать уведомления по подпискам.
• Протестировать административные сценарии.
• Протестировать responsive layout.
• Протестировать доступность базовых UI controls.

20. Развертывание и инфраструктура

• Подготовить Docker setup.
• Подготовить окружение для Elysia gateway.
• Подготовить окружение для Go-сервисов.
• Подготовить PostgreSQL.
• Подготовить CDN/media storage.
• Настроить резервное копирование.
• Настроить восстановление из резервной копии.
• Подготовить тестовое развертывание.
• Подготовить checklist промышленного ввода.
• Добавить health checks.
• Добавить базовый мониторинг и логи.

21. Миграция и подготовка данных

• Проанализировать существующие каналы хранения и распространения: мессенджеры, облака, архивы, сайты, соцсети.
• Привести данные по спикерам, публикациям, медиа и пользователям к структурированному виду.
• Удалить дубликаты.
• Нормализовать форматы.
• Проверить метаданные.
• Категоризировать материалы.
• Подготовить план миграции данных.
• Назначить ответственных со стороны заказчика.

22. Документация

• Подготовить руководство пользователя.
• Подготовить руководство администратора.
• Подготовить программу и методику испытаний.
• Подготовить эксплуатационную документацию по согласованию с заказчиком.
• Подготовить приемочный checklist.
• Подготовить материалы для обучения пользователей и администраторов.

23. Приемка

• Провести промежуточные демонстрации модулей.
• Провести тестовое развертывание.
• Провести опытную эксплуатацию.
• Собрать замечания.
• Устранить замечания.
• Подготовить финальную передачу после тестирования.
• Подготовить акт сдачи-приемки.

24. Вопросы, которые нужно подтвердить

• Финальное название платформы.
• Логотип и разрешенные брендовые материалы.
• Источник реальных данных для миграции.
• Точная матрица ролей и прав доступа.
• Являются ли мероприятия отдельной сущностью или частью контента.
• Точный runtime для Elysia gateway: Bun, Node.js или Deno.
• Допустимо ли использовать дизайн только как вдохновение или требуется максимально близкая визуальная стилизация без копирования защищенных материалов.
• Формулы показателей эффективности контента для аналитики.