Novels

# Пользовательские требования

> Требования сформулированы с позиции заказчика (пользователя продукта).

> Формат: User Story + статус реализации.

> Источники: frontend-issues.md, backend-issues.md, narrator-ai-issues.md, feature-roadmap.md, architecture-review.md

---

## Сводка по доменам

| Домен | Реализовано | Открыто | Всего |

|-------|-------------|---------|-------|

| Story Management | 14 | 2 | 16 |

| AI Narrator | 17 | 2 | 19 |

| Characters & World | 8 | 1 | 9 |

| Auth & Accounts | 5 | 4 | 9 |

| Export & Analytics | 3 | 0 | 3 |

| Collaboration | 0 | 2 | 2 |

| Quality (NFR) | 22 | 6 | 28 |

| **Итого** | **69** | **17** | **86** |

---

## 1. Story Management (Управление историей)

### Реализованные

- **REQ-SM-01** ✅ Как писатель, я хочу создавать проекты с главами и блоками текста, чтобы структурировать историю.

- **REQ-SM-02** ✅ Как писатель, я хочу перетаскивать блоки (drag-and-drop) для изменения порядка.

  *FR5, F5*

- **REQ-SM-03** ✅ Как писатель, я хочу редактировать текст блоков inline и сохранять по Ctrl+S.

- **REQ-SM-04** ✅ Как писатель, я хочу видеть подтверждение перед удалением блока.

  *F11*

- **REQ-SM-05** ✅ Как писатель, я хочу вставлять блоки в середину главы, а не только в конец.

  *Narrator issue #28*

- **REQ-SM-06** ✅ Как писатель, я хочу разделять блоки (split) и объединять (merge).

  *Narrator issue #23, #28*

- **REQ-SM-07** ✅ Как писатель, я хочу видеть историю версий блока и восстанавливать предыдущие.

  *FR12*

- **REQ-SM-08** ✅ Как писатель, я хочу мягкое удаление проектов/глав с возможностью восстановления.

  *Architecture D3*

- **REQ-SM-09** ✅ Как писатель, я хочу изменять размер панели чата (drag-to-resize).

  *FR6, F24*

- **REQ-SM-10** ✅ Как писатель, я хочу управлять сессиями чата: переключать, создавать, удалять.

  *FR7, F25, F26*

- **REQ-SM-11** ✅ Как писатель, я хочу видеть количество слов при наведении на блок.

  *F30*

- **REQ-SM-12** ✅ Как писатель, я хочу видеть подсветку блоков, изменённых AI.

  *F34, F35*

- **REQ-SM-13** ✅ Как писатель, я хочу видеть табы чатов (как в Cursor/браузере) для быстрого переключения.

  *F33*

- **REQ-SM-14** ✅ Как писатель, я хочу кликабельные quick-action кнопки в пустом чате.

  *F32*

### Открытые

- **REQ-SM-15** 🔴 Как писатель, я хочу видеть diff-отображение AI-правок в стиле Git с возможностью частичного принятия.

  *F36, NAI-7*

- **REQ-SM-16** 🔴 Как писатель, я хочу экспорт в EPUB и PDF (помимо TXT/DOCX).

  *FR10 follow-up*

---

## 2. AI Narrator (AI-ассистент)

### Реализованные

- **REQ-AI-01** ✅ Как писатель, я хочу чтобы AI писал прозу по моему запросу, создавая блоки текста 800-2000 слов.

  *Narrator #12, #13*

- **REQ-AI-02** ✅ Как писатель, я хочу чтобы AI автоматически создавал персонажей, лор и события при генерации прозы.

  *Narrator #21*

- **REQ-AI-03** ✅ Как писатель, я хочу чтобы AI НЕ изобретал детали мира, а спрашивал меня.

  *Narrator #20*

- **REQ-AI-04** ✅ Как писатель, я хочу видеть процесс работы AI в реальном времени (стриминг).

  *Narrator #1, #22, #27*

- **REQ-AI-05** ✅ Как писатель, я хочу останавливать AI в любой момент (Stop button).

  *Narrator #4*

- **REQ-AI-06** ✅ Как писатель, я хочу чтобы AI привязывал события к таймлайну.

  *Narrator #29, F41*

- **REQ-AI-07** ✅ Как писатель, я хочу чтобы AI соблюдал причинно-следственную связь (персонаж не реагирует на неизвестное).

  *Narrator #30, NAI-9*

- **REQ-AI-08** ✅ Как писатель, я хочу чтобы AI отслеживал местоположение персонажей.

  *Narrator #26*

- **REQ-AI-09** ✅ Как писатель, я хочу чтобы AI расширял слишком короткие блоки (auto-expand).

  *Narrator #12*

- **REQ-AI-10** ✅ Как писатель, я хочу давать AI пользовательские инструкции (стиль, правила).

  *FR9*

- **REQ-AI-11** ✅ Как писатель, я хочу получать AI-подсказки для улучшения блоков (improve, expand, alternatives, plot hooks).

  *FR13*

- **REQ-AI-12** ✅ Как писатель, я хочу чтобы AI не дублировал себя и не зацикливался.

  *Narrator #16, #17*

- **REQ-AI-13** ✅ Как писатель, я хочу чтобы AI знал, какую главу я сейчас редактирую.

  *Narrator #24*

- **REQ-AI-14** ✅ Как писатель, я хочу чтобы AI не создавал дубликатов персонажей при опечатках (fuzzy matching).

  *Narrator #15, NAI-11*

- **REQ-AI-15** ✅ Как писатель, я хочу чтобы AI извлекал упомянутые сущности из моего запроса для контекста.

  *F37*

- **REQ-AI-16** ✅ Как писатель, я хочу чтобы AI обновлял сущности напрямую, а не создавал новые блоки.

  *F40*

- **REQ-AI-17** ✅ Как писатель, я хочу чтобы AI учился на моих правках (Project Style Memory).

  *NAI-3*

### Открытые

- **REQ-AI-18** 🔴 Как писатель, я хочу выбирать между разными AI-моделями (GPT vs Claude) и сравнивать результаты.

  *F38*

- **REQ-AI-19** 🔴 Как писатель, я хочу чтобы AI использовал multi-agent orchestrator для сложных задач.

  *NAI-12*

---

## 3. Characters & World (Персонажи и мир)

### Реализованные

- **REQ-CW-01** ✅ Как писатель, я хочу создавать/редактировать/удалять персонажей с трейтами и фрагментами.

  *FR4*

- **REQ-CW-02** ✅ Как писатель, я хочу создавать/редактировать/удалять события на таймлайне.

  *FR4*

- **REQ-CW-03** ✅ Как писатель, я хочу создавать/редактировать/удалять лор-записи с категориями и тегами.

  *FR4*

- **REQ-CW-04** ✅ Как писатель, я хочу видеть локации как страницу проекта.

  *F29*

- **REQ-CW-05** ✅ Как писатель, я хочу чтобы сущности имели темпоральные рамки (что когда действительно).

- **REQ-CW-06** ✅ Как писатель, я хочу чтобы AI использовал лор с учётом таймлайна.

  *Narrator #25*

- **REQ-CW-07** ✅ Как писатель, я хочу inline-редактирование на страницах сущностей.

  *FR4, F28*

- **REQ-CW-08** ✅ Как писатель, я хочу видеть health-отчёт по персонажам без фрагментов, блокам без событий и т.д.

  *NAI-1*

### Открытые

- **REQ-CW-09** 🔴 Как писатель, я хочу задавать правила для книги (Book Rules) в структурированном виде, которые AI обязан соблюдать.

  *FR17*

---

## 4. Auth & Accounts (Авторизация и аккаунты)

### Реализованные

- **REQ-AU-01** ✅ Как пользователь, я хочу регистрироваться и входить по email + пароль.

  *FR1*

- **REQ-AU-02** ✅ Как пользователь, я хочу подписки с лимитами (Free / Pro / Enterprise).

  *FR2*

- **REQ-AU-03** ✅ Как пользователь, я хочу настройки профиля, темы и языка.

  *FR3*

- **REQ-AU-04** ✅ Как пользователь, я хочу сброс пароля.

  *AUTH3*

- **REQ-AU-05** ✅ Как пользователь, я хочу чтобы мои данные были защищены (авторизация на все endpoints).

  *B1, B2, S1*

### Открытые

- **REQ-AU-06** 🔴 Как пользователь, я хочу входить через Google OAuth.

  *AUTH1*

- **REQ-AU-07** 🔴 Как пользователь, я хочу подтверждение email при регистрации.

  *AUTH2*

- **REQ-AU-08** 🔴 Как пользователь, я хочу видеть пользовательское соглашение и политику конфиденциальности.

  *AUTH4 — Critical для продакшена*

- **REQ-AU-09** 🔴 Как пользователь, я хочу лендинг-страницу продукта.

  *PROD1*

---

## 5. Export & Analytics (Экспорт и аналитика)

### Реализованные

- **REQ-EA-01** ✅ Как писатель, я хочу экспортировать историю в TXT и DOCX.

  *FR10*

- **REQ-EA-02** ✅ Как писатель, я хочу видеть статистику: слова, главы, персонажи, прогресс по дням.

  *FR14*

- **REQ-EA-03** ✅ Как писатель, я хочу видеть мини-статистику прямо на канвасе.

  *FR14*

---

## 6. Collaboration (Совместная работа)

### Открытые

- **REQ-CO-01** 🔴 Как писатель, я хочу делиться проектами с другими пользователями (роли: owner, editor, viewer).

  *FR11*

- **REQ-CO-02** 🔴 Как писатель, я хочу видеть присутствие других пользователей в проекте в реальном времени.

  *FR16*

---

## 7. Quality — Non-Functional Requirements (Нефункциональные)

### Реализованные

- **REQ-NF-01** ✅ Система должна обрабатывать ошибки API с уведомлением пользователя.

  *F4, F5, FE8*

- **REQ-NF-02** ✅ WebSocket должен автоматически переподключаться.

  *F10*

- **REQ-NF-03** ✅ Система должна работать на мобильных устройствах (responsive layout).

  *FR15*

- **REQ-NF-04** ✅ Стримы должны иметь timeout (5 минут).

  *F7*

- **REQ-NF-05** ✅ Должна быть защита от race condition при быстрой отправке команд.

  *F3*

- **REQ-NF-06** ✅ Должна быть защита от дублирования запросов.

  *Narrator #17*

- **REQ-NF-07** ✅ API endpoints должны валидировать UUID.

  *S3, A4*

- **REQ-NF-08** ✅ API должно иметь rate limiting (60 req/min global, 10 req/min AI).

  *S2*

- **REQ-NF-09** ✅ Ошибки OpenAI не должны раскрывать API ключ.

  *S4*

- **REQ-NF-10** ✅ Должна быть единая CORS конфигурация.

  *S5*

- **REQ-NF-11** ✅ Должен быть health check endpoint.

  *B6*

- **REQ-NF-12** ✅ Должны быть индексы на FK в PostgreSQL.

  *D1, D2*

- **REQ-NF-13** ✅ Должна быть Error Boundary в React.

  *F2*

- **REQ-NF-14** ✅ Должно быть структурированное логирование запросов.

  *B10*

- **REQ-NF-15** ✅ Должен быть graceful shutdown.

  *R1*

- **REQ-NF-16** ✅ Ретраи при ошибках OpenAI (429, 500, 502, 503).

  *R2*

- **REQ-NF-17** ✅ Stores должны очищаться при смене проекта.

  *FE2*

- **REQ-NF-18** ✅ mergeBlocks/splitBlock должны сохранять junction-связи.

  *R3*

- **REQ-NF-19** ✅ ARIA labels для доступности.

  *F16*

- **REQ-NF-20** ✅ Мемоизация компонентов (React.memo).

  *F19*

- **REQ-NF-21** ✅ Чат не должен зависать при недоступном сервере (10с timeout).

  *F31*

- **REQ-NF-22** ✅ Валидация temporal данных (validFrom <= validUntil).

  *A5*

### Открытые

- **REQ-NF-23** 🔴 Мобильный UI требует глубокой доработки: hover→touch, bottom-sheet NarratorPanel, touch targets >=48px.

  *F39*

- **REQ-NF-24** 🔴 N+1 запросы в CharactersService требуют оптимизации.

  *A3*

- **REQ-NF-25** 🔴 Temporal data consistency: блоки могут ссылаться на невалидные трейты.

  *Backend D1*

- **REQ-NF-26** 🔴 fullStory endpoint загружает весь граф проекта — нужна пагинация/lazy loading.

  *Architecture P2*

- **REQ-NF-27** 🔴 Abort mid-tool может оставлять orphaned entities.

  *Architecture B1*

- **REQ-NF-28** 🔴 Нет shared types между frontend и backend.

  *Architecture A1*

---

## Фичи для будущих версий (Backlog)

- **REQ-BL-01** 🔮 Аудио-ввод через Whisper API. *FEAT1*

- **REQ-BL-02** 🔮 Story Health Report в контексте AI. *NAI-1 (реализовано backend, можно расширять)*

- **REQ-BL-03** 🔮 Project metadata: жанр, формат, целевой объём, акты. *NAI-8*

---

*Последнее обновление: 2026-02-16*