# Process Studio — описание продукта

## Что это

**Process Studio** — студия разработки и отладки бизнес-процессов.

Продукт помогает процессным офисам, аналитикам и владельцам процессов:

1. собрать **живую модель** AS-IS (шаги, роли, документы, схема);
2. проверить **готовность** модели;
3. провести **хронометраж** на рабочем месте и утвердить нормы;
4. вести процесс через этапы **проектирование → аудит → утверждение**;
5. менять утверждённый процесс только через **заявку на изменение** с журналом;
6. подготовить **кейс автоматизации**: скоринг шагов, ТЗ, roadmap, ROI.

**Не является:** BPMS (не раздаёт задачи сотрудникам как process engine), MES, HR-таймтрекинг, системой автотестов ПО.

**One-liner:** отладка процессов и обоснование автоматизации — до внедрения BPMS.

---

## Для кого

| Роль в организации | Зачем продукт |
|--------------------|---------------|
| Процессный офис / аналитик | Модель, схемы, готовность, изменения |
| Владелец процесса / COO | Утверждение, контроль изменений, lead time |
| Инженер по нормированию / ОТиЗ | Кампании хронометража, нормы work/wait |
| Исполнитель на месте | Форма старт/стоп по своему шагу |
| Администратор | Участники, роли доступа, обзор этапов |

Отрасли: банк, страхование, shared services, логистика, производство — везде, где процессы нужно проектировать и отлаживать.

---

## Ценность относительно альтернатив

| Альтернатива | Что даёт | Чего не хватает | Роль Process Studio |
|--------------|----------|-----------------|---------------------|
| Miro / Visio / Excel | Быстрые схемы | Lifecycle, нормы, журнал | Единая модель + контроль |
| BPMS (ELMA, Comindware) | Исполнение задач | Дорого; фокус на runtime | Студия **до** / рядом с BPMS |
| ASCII/BPMN-рендереры | Текст схемы для LLM/CI | Нет AS-IS замеров | Опциональный канал вывода |
| QA-системы | Отладка софта | Другой объект | Не конкурент |

---

## Основные функции

### 1. Модель процесса
- Шаги: название, роль, вход/выход, система, описание, тип узла (`task` / `start` / `gateway` / `end`)
- Подшаги (`parent_id`), ветвления gateway («Да» / «Нет»)
- **Объединённый вид:** корень с `call`/`linked_process_id` + дети каталога → одна таблица и одна схема (стык sequential I/O или parallel lanes)
- **Стыки детей (`flow_links`):** sequence / parallel / branch / fan-out от `__start__`; DnD в дереве + панель у родителя; compose строит граф (gateway при ветвлении)
- Порядок шагов (↑↓), копирование шага
- Роли процесса (исполнители на схеме)
- Связи с соседними процессами
- DocLink: формы, регламенты, ОИ/ДО, шпаргалки, обучение, отчёты
- **Документы из модели:** черновик правок НРД по diff версий + содержательные ОИ/ДО из шагов (исходный Word регламента не перезаписывается)

### 2. Представления и экспорт
- Таблица шагов (пресеты шапки: basic / full / bpm / **plant**)
- Схема: flowchart, swimlane, BPMN-lite, VSM-lite, org
- Редактор отображения: `diagram_theme` (типы узлов, типографика, стрелки, chrome) + точечный override шага (`diagram_shape` / `diagram_fill` / `diagram_stroke`); classic — перенос текста и антиколлизия подписей стрелок
- Режимы документов на схеме: labeled / compact / artifacts
- Экспорт: Excel, Drawio, ZIP (Freeze без повторных токенов LLM)

### 3. Импорт и ИИ
- Мастер Word → модель (правила и/или LLM)
- Импорт Excel (в т.ч. эталон plant)
- ИИ-extract из текста и AI-patch инструкции (OpenRouter, опционально)

### 4. Готовность (readiness) и доводка
- Чек-лист по ценностным задачам анализа → BPM
- Оценка заполненности ролей, документов, шлюзов, соседей, версии/статуса
- **Мастер доводки** на вкладке Готовность: пошаговая очередь readiness + audit + deep-audit с **Принять / Отклонить / Вручную**, пересчётом и порогом «на аудит»
- **Ценность шага / чужой процесс:** эвристики «есть ли изменение состояния», доменная чужеродность — в глубоком анализе и очереди Доводки
- **Дубли:** названия/описания по всей модели, повтор документа без смены статуса, усиленные соседние шаги (`duplicate_detect`)
- **Ветвление / решение:** эвристики шлюзов (Да/Нет, варианты, после контроля) + подписи веток в Доводке; параллель — через Реконструкцию потока
- **Отработка «Вопросов»:** классификация колонки «Вопросы в проработку» → конкретное действие (частота/роль/шлюз/НРД/форма) + снятие вопроса из Доводки; ИИ-фолбэк по кнопке, если эвристика не знает что делать

### 5. Хронометраж
- Work / wait на шаге, Lead / Process time, узкие места
- Кампании: инициатор, роли участников, цель
- Floor-формы `/floor/...`: старт/стоп циклов на планшете
- Для утверждённого процесса: замеры **pending** → утверждение / отклонение нормы

### 6. Жизненный цикл и изменения
Статусы модели:

| Статус | Смысл |
|--------|--------|
| `design` | Проектирование, свободные правки |
| `audit` | Аудит; структура ограничена |
| `approved` | Утверждён; правки только через заявку |
| `change` | Открыта заявка на изменение |
| `archived` | Только чтение |

- Журнал `change_log` (кто, основание, kind, версии)
- Заявка `ChangeRequest`: инициатор, участники и их роли в заявке
- **MVP:** счётчик версии + журнал + заявка; откат модели — вручную (копия Excel / JSON)

### 7. Доступ
Системные роли (не путать с ролями шага):  
`admin` · `process_owner` · `analyst` · `change_initiator` · `auditor` · `operator` · `viewer`

MVP: справочник участников + «войти как» (без SSO). Страницы `/admin` и `/change/...`.

### 8. Кейс автоматизации
Мост от утверждённого AS-IS к решению «пилот / подождать / без BPMS»:

| Артефакт | Содержание |
|----------|------------|
| Скоринг шагов | Score 0–100; путь: вручную / полуавто / RPA / BPMS / интеграция (правила: wait≥15→BPMS; система+docs+work→интеграция; без системы+work≥8→RPA) |
| Кандидаты | Топ шагов по score и work/wait |
| Вердикт | go_pilot / pilot_cautious / stabilize_asis / collect_data / optimize_manual |
| ТЗ | Черновик Markdown: цель, scope, системы, KPI, приёмка |
| Roadmap | Стабилизация → ТЗ → пилот → масштаб → контроль эффекта |
| ROI | Ставка ₽/час, объём кейсов, внедрение, лицензии, payback, net |

Допущения хранятся в `automation_assumptions` модели. Вкладка Studio **«Автоматизация»**.

---

## Стандарты (ориентация)

- **BPMN 2.0 (ISO/IEC 19510)** — язык схем и обмена; в продукте BPMN-lite + Drawio  
- **IDEF0** — логика Input / Control / Output / Mechanism (близко к plant-шапке)  
- **IDEF3** — последовательность и ветвления шагов  
- **ASCII** — текстовый вид схем (канал документации/LLM), не отдельный «стандарт ASCI»

---

## Архитектура (кратко)

- Backend: Python, FastAPI  
- Модель: JSON в `workspace/processes/`  
- Участники: `workspace/people.json`  
- Журнал хронометража: `workspace/timing/`  
- UI: Studio `/`, Справка `/help`, Admin `/admin`, Change desk `/change/{source}/{file}`, Floor `/floor/...`  
- Маркетинг (не в навигации продукта): `/landing`, `/pitch`, `/pitch-exec`, PPTX в `docs/`

---

## Что не входит (намеренно)

- Исполнение задач как в BPMS  
- SSO / биллинг SaaS  
- Полный BPMN DI engine  
- Email-workflow согласований  

---

## Следующий шаг (после MVP)

**Контроль сохранения версий модели** — не только `version` + `change_log`, а восстанавливаемые снимки:

- автоснимок перед импортом Excel / AI-patch и при утверждении / закрытии заявки;
- список снимков в Studio (версия, дата, причина);
- «Вернуть» → восстановление JSON в `design` или через заявку на изменение;
- хранение: `workspace/snapshots/{process_id}/`, лимит последних N.

Сейчас при повторном импорте Excel с тем же `id` файл модели перезаписывается без отката.

См. также: [Справочное руководство](USER_GUIDE.md).