dashbord-roznichnyh-prodazh-4/design-system/docs/GOAL.md

Цель: KT AI как фабрика прототипов

Северная звезда дизайн-системы KT AI. Этот документ отвечает на вопрос «зачем всё это» и задаёт критерий, по которому проверяется любое решение по системе. DESIGN.md — чем строить, PRINCIPLES.md — почему так, GOAL.md — ради чего.

Standing instruction (/goal)

Строить из дизайн-системы KT AI фабрику прототипов, где бизнес-аналитик за один рабочий день превращает паспорт агента и интервью Төре в правдивый кликабельный прототип процесса владельца, итерирует с владельцем в течение часов, а на выходе отдаёт команде разработки репозиторий с продакшн-готовым фронтендом без дизайн-долга. Главное уравнение системы: прототип === фронтенд продакшна. Каждое улучшение приближает это уравнение к истине; что не приближает — не приоритет.

Делать по одному, проверять, улучшать. Систему держать маленькой и честной (правило двух продуктов).

Конечный образ результата

БА садится с владельцем процесса — на руках паспорт агента и 25-минутное интервью Төре. К концу того же дня владелец кликает прототип своего процесса: его колонки, его статусы, его рабочее действие, AI-ассистент отвечает по его данным. Не макет с выдуманными строками — правдивый первый срез. Владелец оставляет комментарии прямо на экране. БА правит конфиг, не код, — следующая версия готова в тот же день.

После одобрения БА отдаёт разработчикам git-репозиторий, фронтенд которого уже продакшн-готов: те же токены, те же компоненты, тот же код. Разработчики добавляют только то, что умеют только они: авторизацию, роли, реальные интеграции, бэкенд. Фронтенда они почти не пишут. Дизайн-долга на handoff нет, потому что прототип и продукт никогда не были разными вещами.

Определение готовности (Definition of Done системы)

1. Один контракт. Единый типизированный продуктовый контракт (product.config) — общий язык: Төре его выдаёт, превью рендерит, React-стартер из него собирается, валидатор проверяет, handoff-док из него читает. Четырёх копий одной идеи больше нет.
2. Один рантайм. Кликабельный прототип БА и стартовый репозиторий разработчика — один и тот же код. HTML-превью без сборки — быстрое окно в тот же контракт, а не параллельная вселенная.
3. Правда по построению. У каждого поля, которое видит владелец, объявлены тип, допустимые значения, владелец данных и признак редактируемости — это собирается в паспорте/интервью. Никакой выдумки перед владельцем процесса.
4. Канон через проверку, не через память. kt-ai-lint валит сборку на сырых hex, отступах вне шкалы, втором primary, debug-языке в копирайте, запрещённых ROI/FTE на операционном дашборде. 12-пунктовый чек-лист становится машиной, которая говорит да или нет.
5. Архетипы, не одна форма. БА выбирает архетип экрана (Операционная очередь / Документ-сравнение / Разговорный агент / Кабинет-решение); у каждого свой пресет контракта, свой эталонный клонируемый прототип и свои правила.
6. Замкнутая петля обратной связи. Прототип несёт режим комментирования в контексте; обратная связь владельца возвращается структурными заметками, а не скриншотами и памятью о созвоне.
7. Маленькая и честная. Правило двух продуктов держится; система растёт, только когда второй продукт это заслужил; дрейф между ДС, копией в Төре и стартером — структурно ноль.

Метрики (как поймём, что дошли)

Метрика	Цель
Время до первого прототипа (интервью → кликабельный)	< 1 рабочего дня
Цикл итерации (фидбэк → новая версия)	часы, не спринт
Переиспользование фронтенда на handoff	≥ 80% уходит в прод без изменений
Дизайн-долг на handoff	ноль переверстки
Дрейф ДС / Төре / стартер	ноль (один источник, CI)
Пропускная способность одного БА	3–4 прототипа в месяц без дизайнера в цикле

Последовательность строительства (по одному)

P0 — общий хребет (это и есть цель, остальное — полировка):

1. Единая схема продуктового контракта (Zod/JSON Schema): Төре выдаёт, превью и стартер потребляют, валидатор проверяет.
2. Один рантайм: shadcn-стартер рендерит из типизированного контракта; HTML app-shell демотирован до превью того же контракта без сборки.
3. Field-level data contract в паспорте и интервью Төре (тип, значения, владелец, редактируемость).

P1 — быстро и честно на масштабе: 4. kt-ai-lint — исполняемые правила на сгенерированном выводе, в CI. 5. Пресеты архетипов + эталонные клонируемые прототипы. 6. Режим обратной связи в прототипе (комментарии в контексте → markdown).

P2 — гигиена: 7. Убрать дубликат ДС из репозитория Төре (submodule/пакет/CI-проверка). 8. Одностраничный runbook старта + один машинный свод правил; глубокие доки — справочник. 9. visual_check.mjs в CI без ручного запуска.

Решающий критерий

Перед любой работой по системе спросить: приближает ли это уравнение «прототип === фронтенд продакшна»? Если да — делаем. Если нет — это не приоритет, как бы красиво ни выглядело.