Проектированиесистемы
Вопрос спринта
Как будем решать?
Превратить понимание проблемы в чертежи: проживаемые use cases, C4-архитектура, прошедшая aact, контракты API и evals, написанные до кода.
МАРШРУТ ТВОЕЙ РОЛИ
Выбери роль — она запомнится и откроется сразу в следующих лабах. Клик по номеру шага отмечает его сделанным, прогресс сохраняется. Часы у шагов — твоё время на решения и проверку; генерацию агентом мы в них не считаем.
Use cases по правилам, роадмап и живой словарь
~8–12 часов на спринт
Ответственность
Отвечает за то, что проектируем то, что нужно сегменту, — и что это записано так, что понимают люди и агенты.
Use cases по правилам
3–4 часаUC — единственный артефакт, из которого выводится всё остальное: код, тесты, evals.
- UC по шаблону: актёр, цель, контекст, шаги, результат
- Use-case UML-диаграмма в PlantUML
- Тест «проживаемости»: человек не из команды разыгрывает UC без вопросов
- UC, который нельзя прожить, — не UC
- Не-скоуп важнее скоупа
- Новый термин без словаря — будущий баг согласования
- Принимай по DoD, а не по красоте
- Use cases as-codedocs/use-cases/
- Роадмап с не-скоупомdocs/roadmap.md
- Глоссарий: термины архитектуры и пайплайнаdocs/glossary.md
- Принятые ADR архитектурыdocs/adr/
- Схема AI-пайплайнаdocs/ai-pipeline.md
- Решение по модели: обоснование и ценаdocs/model-candidates.md — раздел «решение»
- Записка: какие допущения проверили и что выяснилиdocs/experiments/lab2.md + ноутбук приложением
- Контракт AI-APIapi/openapi.yaml
- C4-диаграммы, aact-конфиг и ADR архитектурыdocs/architecture/ + docs/adr/
- Прототип UI: код + скриныfrontend/prototype/
- Схема БД + ERDdatabase/schema.sql
- Compose-скелетcompose.dev.yml
- DoD артефактовdocs/quality/dod.md
- Golden dataset v1docs/quality/golden-dataset/
- Тест-планdocs/quality/test-plan.md
- Модель угрозdocs/quality/threat-model.md
ГОТОВО — ЭТО КОГДА
Чек-лист — твой рабочий прогресс. DoD — те же критерии, которые видит автопроверка.
МАТЕРИАЛЫ К ЛАБЕ
Что понадобится по ходу спринта. Полный справочник курса — в разделе «Материалы».
СПРИНТ 2 ГОТОВ К ЗАПУСКУ
К концу спринта у команды чертежи, которым можно верить: use cases проживаются, C4 проходит aact, evals написаны до кода. Строить — по чертежам.