# TextMachine — документация

Проект: бэкенд (позже — фронтенд-IDE) художественного перевода крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en/ru во все стороны) через мультиагентный пайплайн поверх LLM API. Стартовый бриф: [../START_PROMT.MD](../START_PROMT.MD).

Ключевые цели:
1. Максимальное художественное качество — победить «нехудожественность» AI-переводов.
2. Низкая себестоимость: пайплайн из дешёвых моделей + редкие вызовы дорогих (судья/селектор).
3. Банк памяти / глоссарий на всю книгу — консистентность имён, терминов, стиля.
4. Обработка 18+/жёсткого контента с учётом цензуры провайдеров (мультипровайдерность).
5. Телеметрия токенов/стоимости/качества с первого дня.
6. Высокая маржа; целевой рынок — ru/en переводчики, редакторы, копирайтеры.

## Структура

- `research/` — результаты исследований:
  - `01-market.md` — рынок и спрос; `02-competitors.md` — конкуренты; `03-academic-agentic-mt.md` — наука (agentic MT, метрики); `04-api-providers.md` — цены/качество/цензура API; `05-memory-glossary.md` — банк памяти и глоссарий; `06-local-models.md` — локальные модели (8GB VRAM); `07-translation-methodology.md` — методология худперевода; `08-legal.md` — право; `09-cost-model.md` — модель стоимости; `10-vojo-ai-bot-review.md` — ревью переиспользуемого Go-кода;
  - `11-gap-1…5.md` — добор пробелов критиком: RU-платежи/санкции, 18+ политики провайдеров (уточнение), валидация ядра пайплайна на zh→ru/ja→ru, российская конкурентная экосистема, платёжеспособный спрос.
- `architecture/` — синтез: `01-decisions.md` (10 решений), `02-mvp-plan.md` (фазы и приёмка), `components.puml`/`pipeline.puml`. Диаграммы владелец смотрит PlantUML-расширением VS Code — **рендерить .svg вручную не нужно** (лежащие рядом .svg — разовые превью от 04.07, при правках .puml их не обновлять, а удалить).
- `experiments/` — результаты «Полигона» (параллельная сессия, см. `PARALLEL_SESSION_PROMPT.md`).
- `PROGRESS.md` — журнал прогресса и принятых решений.

## Статус

См. [PROGRESS.md](PROGRESS.md). Исследовательская фаза завершена 04.07.2026; следующий шаг — Фаза 0 бэкенда (Go).