Проекты
Что такое проект
Проект — это одна задача, которую вы хотите проработать: от идеи, описанной своими словами, до структурированного плана и готовой спецификации. Вы пишете, что нужно сделать, — Spec Builder разбирает задачу на блоки работ (отдельные подзадачи), назначает каждому специальность (роль в команде) и связывает блоки зависимостями. Результат — интерактивный граф: видно, из чего состоит задача, кто за что отвечает и что от чего зависит.
Зачем это. Возьмём задачу «распознавать дефекты на конвейере по фото». На словах она умещается в одно предложение, а на деле в ней десятки решений: какие данные собирать, как мерить качество, кто готовит выборку, где проходит граница между моделью и интеграцией. Обычно эти решения всплывают по ходу работы — и двигают сроки. Проект в Spec Builder поднимает их наверх сразу: граф показывает полный состав работ и пробелы в зонах ответственности до того, как команда начала строить.
Генерация идёт в три стадии, и все они видны на экране: сначала выбираются блоки под задачу, затем каждый блок получает описание, роли и артефакты, в конце строятся зависимости. Масштаб подстраивается под размер задачи — S для проверки идеи (4–7 блоков), M для командной фичи, L для платформы (15–25 блоков): маленькой задаче не навязывается процесс большой.
Попробовать за три шага. Регистрация не обязательна: по публичной коллекции доступен гостевой режим — пробный проект привязывается к вашему браузеру, а при регистрации переедет в личный спейс. В командной работе проект создаётся в спейсе вашей организации.
- Создайте проект на экране создания: опишите задачу обычным текстом и выберите размер.
- Наблюдайте, как строится граф, — стадии генерации идут потоком прямо на экране.
- Откройте готовый граф: двигайте блоки, смотрите зоны ответственности, правьте то, с чем не согласны.
Следующий шаг после графа — дизайн-документ: пояснительный текст проекта, разложенный по блокам. Проект живёт в спейсе — рабочем пространстве команды, а состав блоков и специальностей задаёт коллекция — шаблон вашей предметной области. Как читать сам граф — гид по графу.
Домен: Проекты
Проект — основная единица работы в Spec Builder: из текстового описания задачи продукт строит граф блоков и связей, а затем генерирует дизайн-документ. Этот домен покрывает весь жизненный цикл проекта: создание и генерацию графа, редактирование, корзину (мягкое удаление и восстановление), передачу проекта в организацию и смену владельца, публичные share-ссылки.
Стартовый экран — Список проектов; создание идёт с экрана Создание проекта, удалённое лежит в Корзине. Права доступа определяет матрица RP и роли; агентам доступны те же действия, что и их роли в UI, по токену (см. Конвенции).
Ниже — методы API и экраны домена.
Методы API
| Метод | Эндпоинт | Статус |
|---|---|---|
| Список проектов | GET /api/projects | done |
| Создать проект | POST /api/projects | done |
| Удалить проект (в корзину) | DELETE /api/projects/:id | done |
| Получить проект | GET /api/projects/:id | done |
| Обновить проект | PUT /api/projects/:id | done |
| Лента изменений проекта (для агента) | GET /api/projects/:id/activity | done |
| Сгенерировать граф (SSE) | POST /api/projects/:id/generate | done |
| Граф проекта (для агента) | GET /api/projects/:id/graph | done |
| Статус async-генерации (poll) | GET /api/projects/:id/jobs/:jobId | done |
| Отменить async-генерацию | POST /api/projects/:id/jobs/:jobId/cancel | done |
| Удалить безвозвратно | DELETE /api/projects/:id/permanent | done |
| Восстановить проект | POST /api/projects/:id/restore | done |
| Создать share-ссылку | POST /api/projects/:id/share | done |
| Передать проект в организацию | POST /api/projects/:id/transfer | done |
| Сменить владельца проекта | POST /api/projects/:id/transfer-owner | done |
Экраны
| Экран | Элементов |
|---|---|
| Список проектов | 13 |
| Создание проекта | 5 |
| Корзина | 8 |
| Supervisor обзор | 2 |
| Промпты-модал | 3 |
| LeftNav | 3 |
| Header | 2 |
| Проект — Дизайн-док | 1 |