first commit 2

plan.md

@@ -0,0 +1,333 @@
+# План задач для 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.
+- [ ] Допустимо ли использовать дизайн только как вдохновение или требуется максимально близкая визуальная стилизация без копирования защищенных материалов.
+- [ ] Формулы показателей эффективности контента для аналитики.