Тесткейс — как проверить результат

Что это такое

Тесткейс — это артефакт вида test_case в artifacts-service: формальное описание, как понять, что задача сделана. Он входит в пакет задачи и в спеку (ТЗ), которую пишет SPEC-AGENT.

Простая аналогия: тесткейс — это «как проверить» к задаче. Без тесткейса непонятно, когда работа закончена: «сделал» — не проверяемо, «проходит тесткейс» — проверяемо.

Место в дереве

Тесткейс — ребёнок задачи. Одна задача может иметь несколько тесткейсов:

user_story "Сделать фичу X"
└─ task     "Задача 1: …"
│    ├─ subtask "Подзадача …"
│    └─ test_case "Как проверить условие 1"   ← вот эта страница
│        └─ test_case "Как проверить условие 2"
└─ task     "Задача 2: …"
     └─ test_case "Как проверить …"

Регистрация пакета (стори + задачи + тесткейсы) одной командой — задача CH-1.

Что входит в тело тесткейса

Тело тесткейса хранится в body_json и описывает проверку в форме «дано / когда / тогда»:

Поле	Что это
`given`	дано — исходное условие
`when`	когда — действие
`then`	тогда — ожидаемый результат
`tc_id`	идентификатор тесткейса в реестре

Эту структуру SPEC-AGENT переносит в спеку (ТЗ), а DEV-AGENT и CI опираются на неё при проверке.

Как тесткейс используется

Тесткейс попадает в пакет задачи → SPEC-AGENT включает его в спеку (ТЗ).
ЧЕЛОВЕК одобряет спеку (ТЗ) на Gate.
DEV-AGENT делает код и проверяет его по тесткейсам.
CI / верификация подтверждает, что тесткейсы проходят.

Тесткейсы — это способ сделать «сделано» проверяемым, а не декларативным.

Связи

Вход

тесткейс заводится в пакете стори (CH-1) под задачей.

Выход

тесткейс «прошёл» — проверяемое подтверждение, что задача сделана.

Внутри

входит в спеку (ТЗ) через SPEC-AGENT, проверяется DEV-AGENT и CI.

Дальше

реестр тесткейсов привязан к срезам и гейтам (лист «Тесткейсы»).