Техническое задание

Описание проекта

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

Основной функционал приложения

1. Система авторизации и управления пользователями

• Открытая регистрация пользователей с подтверждением email
• Авторизация пользователей через логин/пароль
• Система ролей: администратор (admin) и пользователь (user)
• Управление профилем пользователя
• Восстановление пароля через email
• Разграничение доступа между публичной зоной и панелью управления

2. Панель управления (для авторизованных пользователей)

2.1 Аналитическая панель

• Статистика просмотров историй пользователя
• Аналитика оценок и рейтингов
• Статистика комментариев и взаимодействий
• Графики активности по датам
• Сравнительная аналитика по различным историям

2.2 Управление историями

• Список всех созданных историй пользователя
• Создание новой истории с выбором параметров:
  • Историческая эпоха
  • Тип сюжета (приключения, драма, фэнтези, детектив и др.)
  • Особенности и предпочтения
  • Тип истории (рассказ, книга, книга с иллюстрациями, комикс, манга)
• Генерация вариантов сюжета с помощью ИИ
• Выбор и утверждение сюжета
• Редактирование и удаление историй
• Публикация/снятие с публикации историй

2.3 Редактор истории

Общие разделы для всех типов:

• Персонажи: создание и редактирование персонажей с ИИ-генерацией описаний
• Мир: описание мира, локаций, исторического контекста
• Контекст: общие настройки истории, временные рамки, основной конфликт
• Главы: структурированное создание и редактирование глав

Дополнительные разделы для иллюстрированных работ:

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

Специфичные функции по типам:

• Рассказ/Книга: текстовый редактор с ИИ-помощником
• Книга с иллюстрациями: интеграция текста и генерация иллюстраций
• Комикс/Манга: редактор панелей, диалогов и визуальных элементов

3. Административная панель (только для администраторов)

• Управление пользователями (просмотр, блокировка, удаление)
• Системные конфигурации ИИ-моделей
• Настройки интеграции с LangChain и LangSmith
• Модерация контента
• Системная аналитика и мониторинг

4. Публичная зона сайта

4.1 Главная страница

• Витрина популярных историй
• Поиск по историям
• Фильтрация по эпохам, жанрам, типам
• Рекомендации для пользователей

4.2 Страница историй

• Каталог всех опубликованных историй
• Расширенные фильтры и сортировка
• Система тегов и категорий

4.3 Просмотр истории

• Адаптивное отображение в зависимости от типа истории
• Система оценок и комментариев
• Счетчик просмотров
• Возможность добавления в избранное
• Социальные функции (поделиться, рекомендовать)

Интеграция с ИИ-системами

LangChain Integration

• Создание цепочек для генерации сюжетов
• Генерация персонажей и их характеристик
• Создание описаний миров и локаций
• Генерация текстового контента глав
• Адаптация стиля под выбранную эпоху

LangSmith Integration

• Мониторинг производительности ИИ-генерации
• Отслеживание качества генерируемого контента
• A/B тестирование различных промптов
• Аналитика использования ИИ-функций

Технологический стек

• Фронтенд: Vue.js 3 с Composition API
• Стилизация: TailwindCSS
• Бэкенд: FastAPI (Python)
• ИИ-интеграция: LangChain, LangSmith
• База данных: PostgreSQL
• Типизация: TypeScript (фронтенд), Python type hints (бэкенд)
• Контроль качества кода: ESLint, Prettier (фронтенд), Black, Flake8 (бэкенд)
• Контейнеризация: Docker
• Веб-сервер: Nginx
• Кеширование: Redis

Структура базы данных

Основные таблицы

• users — Пользователи (id, email, password_hash, role, created_at, updated_at)
• stories — Истории (id, user_id, title, description, story_type, era, genre, is_published, created_at, updated_at)
• story_content — Контент историй (id, story_id, content_type, content_data, version)
• characters — Персонажи (id, story_id, name, description, characteristics)
• worlds — Миры (id, story_id, name, description, locations)
• chapters — Главы (id, story_id, title, content, order_index)
• references — Референсы (id, story_id, file_path, description)
• story_views — Просмотры (id, story_id, user_ip, viewed_at)
• story_ratings — Оценки (id, story_id, user_id, rating, created_at)
• comments — Комментарии (id, story_id, user_id, content, created_at)
• ai_generations — История ИИ-генераций (id, user_id, prompt, response, model_used, created_at)

Пользовательские сценарии

Сценарий создания истории

1. Пользователь авторизуется и переходит в панель управления
2. Выбирает "Создать новую историю"
3. Заполняет базовые параметры: эпоха, тип сюжета, особенности
4. Выбирает тип истории (рассказ, книга, комикс и т.д.)
5. ИИ генерирует несколько вариантов сюжета
6. Пользователь выбирает понравившийся сюжет
7. Переходит в редактор истории для детальной проработки

Сценарий редактирования истории

1. Пользователь открывает редактор существующей истории
2. Работает с разделами: персонажи, мир, контекст, главы
3. Использует ИИ-помощники для генерации контента
4. Для иллюстрированных работ загружает референсы
5. Просматривает предварительный результат
6. Публикует историю или сохраняет как черновик

Сценарий просмотра истории (публичная зона)

1. Пользователь заходит на главную страницу или в каталог
2. Находит интересную историю через поиск или рекомендации
3. Открывает страницу истории
4. Читает/просматривает контент в адаптивном формате
5. Оставляет оценку и комментарий
6. Добавляет в избранное или делится с друзьями

Дополнительные требования

Функциональные требования

• Адаптивный дизайн для корректной работы на всех устройствах
• Система уведомлений о новых комментариях и оценках
• Экспорт историй в различные форматы (PDF, EPUB, HTML)
• Система резервного копирования пользовательского контента
• Многоязычная поддержка интерфейса

Технические требования

• Все компоненты должны быть упакованы в Docker-контейнеры
• Код должен быть покрыт типизацией и соответствовать стандартам качества
• Обязательное логирование всех ИИ-операций для мониторинга
• Система кеширования для оптимизации производительности
• Backup-стратегия для базы данных и пользовательских файлов

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

• Хеширование паролей с использованием современных алгоритмов
• Защита от SQL-инъекций и XSS-атак
• Валидация всех пользовательских данных
• Rate limiting для ИИ-запросов
• Система модерации контента для предотвращения нарушений

Производительность

• Оптимизированные запросы к базе данных с индексами
• Асинхронная обработка ИИ-запросов
• CDN для статических файлов и изображений
• Система очередей для тяжелых операций
• Мониторинг производительности и автоматическое масштабирование