80 lines
9.1 KiB
Markdown
80 lines
9.1 KiB
Markdown
# План: пайплайн-workspace
|
|
|
|
> Статус: план к выполнению.
|
|
|
|
## 1. Что получается
|
|
|
|
Страница `/workspace`: одна картинка-исходник слева, справа результат всей цепочки; между ними — список шагов, где каждый шаг это инструмент из реестра со своими параметрами. Результат каждого шага становится входом следующего. Шаги можно добавлять, удалять, перемещать, выбирать для просмотра промежуточного результата и правки параметров. Цепочка переживает перезагрузку страницы и переносится файлом JSON.
|
|
|
|
## 2. Модель данных
|
|
|
|
```ts
|
|
type PipelineStep = { id: string; toolId: string; values: Record<string, unknown> };
|
|
type PipelineDocument = { version: 1; steps: PipelineStep[] };
|
|
```
|
|
|
|
- Значения параметров сериализуемы по определению (числа/строки/логические).
|
|
- Загрузка из хранилища или файла проходит валидацию: версия, массив шагов, каждый `toolId` существует в реестре, значения прогнаны через санитизацию — мусор отбрасывается, а не ломает страницу.
|
|
|
|
## 3. Исполнение цепочки
|
|
|
|
- Один прогон = свёртка по шагам: текущее изображение пропускается через `run` каждого инструмента; попутно собираются все промежуточные результаты — они и есть превью шагов.
|
|
- Тот же механизм надёжности, что на страницах инструментов: токен запусков (устаревший ответ отбрасывается) и задержка ~300 мс после последнего изменения исходника или шагов.
|
|
- Ошибка любого шага — баннер с именем инструмента; предыдущие промежуточные результаты остаются видимыми.
|
|
|
|
## 4. Переиспользование и точечные доработки
|
|
|
|
Готовое берётся целиком: `SourceCard` (загрузка/замена/Ctrl+V), `Preview`, `ParamForm` (форма шага), `DownloadButton`, `EmptyState`, карточка результата собирается из этих примитивов — `ResultCard` намеренно не переделывается, он специфичен для одиночного инструмента.
|
|
|
|
Три небольшие доработки ради отсутствия повторов:
|
|
|
|
- **Общий авто-раннер**: текущий паттерн «токен + таймер + очистка» выносится из страницы инструмента в небольшой модуль и используется обеими страницами — единственное место, где трогается работающий код.
|
|
- **Константа PNG-формата** экспортируется из реестра: рабочему пространству нужно то же имя файла и формат вывода, что и кнопке скачивания.
|
|
- **`DropZone` получает опциональный проп типа принимаемых файлов** — им же импортируется JSON-файл цепочки; валидация переключается на этот тип.
|
|
|
|
Пипетка и маски в параметрах шагов сознательно выключены (колбэки `ParamForm` опциональны, так что просто не прокидываются) — они остаются фичей одиночных инструментов.
|
|
|
|
## 5. Новые компоненты
|
|
|
|
- **`StepList.svelte`** — список шагов: порядковый номер, название инструмента, кнопки выше/ниже/удалить; клик выбирает шаг.
|
|
- **`StepEditor.svelte`** — карточка выбранного шага: имя инструмента и его `ParamForm`.
|
|
- **`StepPicker.svelte`** — добавление шага: выпадающий список инструментов, сгруппированный по категориям, и кнопка «Добавить».
|
|
- Страница `routes/workspace/+page.svelte` — оркестратор: состояние исходника, шагов, выбранного шага, промежуточных результатов; вызов общего раннера; сборка сцены из готовых карточек.
|
|
|
|
Хранение: автосохранение документа цепочки (без картинок) в localStorage при каждом изменении; восстановление при открытии страницы; кнопки экспорта и импорта JSON рядом со списком шагов.
|
|
|
|
## 6. Этапы и проверки
|
|
|
|
- **A. Механизмы** — модуль модели и валидации, общий авто-раннер, перевод страницы инструмента на него, экспорт PNG-константы. Проверка: полный регресс старых страниц, `test/check/build`.
|
|
- **B. Каркас** — маршрут и три компонента, прогон цепочки, превью выбранного шага, скачивание результата. Проверка: смоук §8 пп. 1–5.
|
|
- **C. Сохранение** — автосохранение, восстановление, экспорт/импорт JSON через доработанную зону перетаскивания. Проверка: смоук §8 пп. 6–9.
|
|
- **D. Итог** — полный прогон и регресс всего каталога.
|
|
|
|
## 7. Критерии готовности
|
|
|
|
- Цепочка из нескольких инструментов даёт корректно составленный эффект; порядок шагов влияет на результат.
|
|
- Промежуточное превью соответствует выбранному шагу; скачивается итог.
|
|
- Цепочка восстанавливается после перезагрузки и переносится файлом; битые файлы не ломают страницу.
|
|
- Ни одного дублирования паттерна запуска; старые инструменты работают без изменений поведения.
|
|
- `test/check/build` зелёные, смоук §8 пройден.
|
|
|
|
## 8. Смоук-чеклист
|
|
|
|
1. Исходник → добавить «чёрно-белый по порогу», затем «поля», затем «изменить прозрачность» — результат составленный, скачивается.
|
|
2. Клик по среднему шагу показывает его промежуточный результат; правка его порога пересчитывает всю цепочку.
|
|
3. Перестановка шагов местами меняет итог; удаление шага убирает его эффект.
|
|
4. Замена исходника перезапускает всю цепочку; чип занятости виден на тяжёлых прогонах.
|
|
5. Инструмент с ошибкой параметров подсвечивается баннером с его именем, прежний итог не исчезает.
|
|
6. Перезагрузка страницы восстанавливает цепочку шагов (без картинки).
|
|
7. Экспорт сохраняет JSON; импорт того же файла восстанавливает шаги.
|
|
8. Импорт повреждённого JSON — баннер ошибки, текущая цепочка цела.
|
|
9. Быстрые правки подряд дают один финальный пересчёт.
|
|
10. Все страницы одиночных инструментов ведут себя как раньше после перевода на общий раннер.
|
|
|
|
## 9. Что сознательно не делаем
|
|
|
|
- Пер-шаговые маски и пипетка в параметрах шагов.
|
|
- Ленивые инкрементальные пересчёты длинных цепочек — полный прогон, операции уровня EASY быстрые.
|
|
- Ветвления, несколько исходников, смешивание картинок.
|
|
- Перетаскивание шагов мышью — только кнопки порядка.
|