# Исходный подробный контракт этапа 6 Снимок локального плана `_bmad-output/planning-artifacts/epics.md`. Исходная ревизия: `78dc060b8a5086b1cc7a1bec77385a0f2471fbf3`. Дата переноса: 2026-10-04. Технический текст ниже сохранён дословно, чтобы перенос не изменял обязательные критерии. Основные описания этапов и задач в Gitea написаны на русском языке. ## Epic 6: Встроенная проверка производительности Оператор задаёт RPS, VU или модель DAU, безопасно запускает и останавливает Load Run, наблюдает live statistics и получает immutable сравнительный отчёт. ### Story 6.1: Создавать versioned Load Scenarios **Depends on:** Story 5.13 **Work type:** implementation **Deliverable:** Создавать versioned Load Scenarios. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор производительности, I want собрать воспроизводимый сценарий из Published Tools, So that одинаковая нагрузка повторяется между releases. **Requirements:** FR-36 **Acceptance Criteria:** **Given** Agent catalog **When** создаётся Load Scenario **Then** можно выбрать только точные Published Tool Versions и задать weighted mix, bounded input data, RPS или VU, duration, ramp и thresholds **And** Draft, archived/unpublished либо чужая capability не принимается. **Given** выбранные Tools **When** Scenario сохраняется **Then** pinned Agent revision, Tool versions, input schema digests, parameter generator contract и credentials refs фиксируются immutable version **And** raw credentials и secret-bearing samples не сохраняются. **Given** target Tool **When** он не объявлен `load-test-safe` либо является write **Then** публикация Scenario блокируется до явной safety classification и требуемых sandbox controls **And** UI объясняет причину без раскрытия policy metadata чужого объекта. **Given** Scenario edit **When** уже существует использованная version **Then** создаётся новая version, предыдущая остаётся доступной для report reproduction **And** import/export roundtrip сохраняет весь bounded contract. **Given** Scenario UI **When** пользователь создаёт, preview-ит, version-ит или архивирует его **Then** реализованы loading/empty/validation/error/conflict/stale-response states и RU/EN localization **And** computed request count, ceilings и expected data sources видны до сохранения. **Given** contract/API/Playwright suite **When** проверяются mixed Tools, invalid weights, oversized data, stale catalog и roundtrip **Then** validation детерминирована, никакой Run не стартует **And** `just verify` проходит. ### Story 6.2: Преобразовывать DAU в прозрачный arrival profile **Depends on:** Story 6.1 **Work type:** implementation **Deliverable:** Преобразовывать DAU в прозрачный arrival profile. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want задавать понятную модель DAU вместо ручного расчёта RPS, So that могу приблизить реальную пользовательскую активность. **Requirements:** FR-37 **Acceptance Criteria:** **Given** DAU mode **When** оператор задаёт DAU, actions/session, sessions/user/day, activity window, think time и Tool mix **Then** все assumptions обязательны, имеют units/bounds и не выводятся из скрытых defaults **And** UI показывает формулы и предупреждает о неоднозначных сочетаниях. **Given** валидная модель **When** выполняется preview **Then** строится deterministic time-bucketed arrival/RPS curve, peak/average RPS, expected iterations и VU estimate **And** rounding, timezone и seed зафиксированы в Scenario version. **Given** вычисленный профиль превышает capability/ceiling **When** preview завершается **Then** UI показывает exact limiting constraint и не разрешает Start **And** оператор может изменить inputs без потери остальных полей. **Given** zero/very large values, short windows либо long think time **When** модель валидируется **Then** divide-by-zero, overflow, NaN и unbounded schedule невозможны **And** сообщение локализовано и указывает поле/допустимый диапазон. **Given** одинаковые inputs и seed **When** модель вычисляется backend и frontend preview **Then** fingerprints и curves совпадают в установленной tolerance **And** golden fixtures и Playwright charts проходят. ### Story 6.3: Авторизовать Load Run явным safety plan **Depends on:** Story 6.2 **Work type:** implementation **Deliverable:** Авторизовать Load Run явным safety plan. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an оператор установки, I want проверять и подтверждать blast radius до запуска, So that встроенный load test не повреждает production или внешние системы. **Requirements:** FR-38 **Acceptance Criteria:** **Given** опубликованный Scenario **When** запрашивается preflight **Then** сервер повторно pin-ит capability versions, effective auth scope, targets, DNS/IPs, estimated iterations/RPS/VU/duration и installation capacity **And** формирует immutable LoadAuthorizationPlan с expiry и config/release fingerprint. **Given** target endpoints **When** policy проверяется после DNS resolution **Then** каждый destination входит в dedicated load allowlist, redirects/system proxy запрещены по умолчанию **And** private/production target требует соответствующего явного operator policy. **Given** write Tools **When** создаётся plan **Then** обязательны sandbox/test credential refs, quotas и documented cleanup/verification contract **And** production write load дополнительно требует global operator flag и отдельного typed confirmation. **Given** requested load **When** она превышает local capability либо hard ceiling 1000 RPS, 512 VU, 2 часа или 10 000 000 iterations **Then** plan отклоняется без override path **And** UI показывает requested/effective limits. **Given** valid plan **When** уполномоченный admin подтверждает exact fingerprint **Then** server подписывает short-lived plan, audit сохраняет actor/reason/scope **And** изменение Scenario, credentials, target resolution, release или config инвалидирует plan. **Given** authorization negative suite **When** проверяются forged/expired/replayed plans, DNS rebinding, revoked refs, cross-workspace access и writes without cleanup **Then** Start fail closed до dispatch **And** security evidence связано с Scenario fingerprint. ### Story 6.4: Исполнять нагрузку в изолированном Load Runner **Depends on:** Story 6.3 **Work type:** implementation **Deliverable:** Исполнять нагрузку в изолированном Load Runner. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an оператор, I want запускать нагрузку отдельно от control plane, So that генератор не лишает меня возможности наблюдать или остановить тест. **Requirements:** FR-38 **Acceptance Criteria:** **Given** dispatch context и public MCP call отдельного load-runner **When** Run/iteration проходит cross-process boundary **Then** canonical Request ID/Trace ID распространяются и сохраняются согласно Story 5.1; integration evidence связывает runner, MCP и execution без high-cardinality labels **And** spec фиксирует telemetry producer/ownership: при собственном exporter runner проходит применимые per-process spool/restart/redaction tests Story 5.5, при делегировании — проверяется существующий владелец delivery; наличие short-lived credential само по себе не требует нового spool. **Given** valid signed LoadAuthorizationPlan **When** Start принимается атомарно **Then** PostgreSQL создаёт durable Load Run/dispatch intent с scoped ID и immutable plan fingerprint **And** повторный Start idempotent, иной fingerprint конфликтует. **Given** dispatched Run **When** отдельный `load-runner` принимает его **Then** он проверяет signature/expiry/release/config, вызывает только public MCP endpoint и не имеет прямого доступа к domain tables/secrets **And** raw credentials разрешаются через scoped short-lived mechanism. **Given** active Run **When** генерируется load **Then** RPS/VU/ramp/mix/seed соблюдаются в documented tolerance, inputs bounded, responses streaming-aggregated **And** per-iteration raw payloads по умолчанию не сохраняются. **Given** installation under test **When** load-runner работает **Then** control traffic использует reserved runtime/connection capacity, runner отправляет heartbeat **And** отсутствие heartbeat переводит Run в visible failed/interrupted state и прекращает новые dispatches. **Given** independent emergency path **When** API/UI/DB перегружены **Then** локальный Unix kill socket/host command останавливает generators без зависимости от control plane **And** endpoint permission restricted, action записывается после восстановления. **Given** runner crash/restart/dependency fault suite **When** faults вводятся на start, ramp, steady и stop stages **Then** одновременно не работают два generation owner, ceilings не превышаются, state converges **And** isolation/resource-limit evidence проходит. ### Story 6.5: Показывать live statistics и безопасно останавливать Run **Depends on:** Story 6.4 **Work type:** implementation **Deliverable:** Показывать live statistics и безопасно останавливать Run. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an оператор, I want в реальном времени видеть качество нагрузки и гарантированно остановить её, So that могу быстро реагировать на деградацию. **Requirements:** FR-39 **Acceptance Criteria:** **Given** queued/running/stopping Load Run **When** UI открывает live view **Then** видны generation, completed/failed, latency p50/p95/p99, active workers/VU, current RPS, dropped iterations, queue wait и saturation **And** данные содержат freshness timestamp и bounded update rate. **Given** thresholds Scenario **When** новые aggregates поступают **Then** UI показывает pass/warn/fail по каждому threshold без объявления terminal pass до завершения **And** product-caused, upstream и generator errors классифицированы раздельно. **Given** оператор нажимает Stop и подтверждает action **When** command принят через reserved control path **Then** новые dispatches прекращаются в bounded time, in-flight обрабатываются по pinned drain/cancel policy **And** repeated Stop idempotent, terminal Run не меняется. **Given** обычный control plane недоступен **When** используется emergency stop **Then** runner прекращает generation независимо, local status подтверждает stop **And** UI после recovery reconciles observed state вместо ложного success. **Given** browser disconnect, смена Run или out-of-order updates **When** live view reconnects **Then** authoritative snapshot восстанавливается, stale events отбрасываются identity/revision guard **And** loading/empty/paused/error/stale states локализованы RU/EN. **Given** live/stop E2E under saturation **When** Run достигает configured ceiling и UI/API испытывают нагрузку **Then** statistics остаются доступны, Stop проходит через reserved capacity **And** Playwright, protocol и fault tests подтверждают отсутствие listener leaks/duplicate actions. ### Story 6.6: Формировать immutable отчёты и сравнивать releases **Depends on:** Story 6.5 **Work type:** implementation **Deliverable:** Формировать immutable отчёты и сравнивать releases. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an оператор производительности, I want получить воспроизводимый отчёт и сравнить одинаковые Scenarios, So that release decision основан на доказательствах. **Requirements:** FR-40 **Acceptance Criteria:** **Given** terminal Load Run **When** aggregates финализируются **Then** content-addressed immutable report содержит Scenario/plan fingerprint, release/image/config, timing, achieved load, outcomes, percentiles, saturation и threshold verdicts **And** incomplete/interrupted Run обозначен явно и не может быть pass. **Given** human-readable report **When** он открыт в UI **Then** доступны bounded graphs, summary, assumptions, warnings и validated Grafana/trace links **And** loading/error/missing-artifact states и RU/EN text реализованы. **Given** machine-readable report **When** он экспортируется **Then** JSON соответствует versioned schema, остаётся valid UTF-8/JSON при malformed/oversized upstream data **And** raw secrets/payloads redacted, artifact digest проверяется. **Given** два Runs **When** оператор выбирает Compare **Then** сравнение разрешено только для совместимого Scenario fingerprint либо явно показывает semantic differences **And** delta по throughput, success, latency, queue/saturation и thresholds вычисляется детерминированно. **Given** history на production-size dataset **When** фильтруют по Scenario, release, period и outcome **Then** API использует bounded opaque pagination, UI защищён от stale responses **And** retention не удаляет artifact, связанный с release evidence. **Given** Reference Workload validation **When** выполняются 100 RPS 30 минут и 250 RPS burst 5 минут **Then** report проверяет NFR-P1/P1a/P1b/P4 с minute-level success/saturation и platform overhead **And** результаты связаны с metrics/traces и одним build/config fingerprint. **Given** завершение Epic 6 **When** RPS, VU и DAU flows проходят API/UI/runner tests **Then** FR-36…FR-40 имеют reproducible evidence **And** Capability Inventory и Load Runs Grafana dashboard обновлены; панели Story 5.11 проверены с реальными series, links и bounded queries этого Run, а не только с empty/provisioned состоянием. **Given** сохранённый Scenario и разрешённый оператор **When** пользователь проходит полный Load Run workflow **Then** единая навигация ведёт через `Scenario → load model → preflight → confirmation → live run → report` **And** каждый шаг показывает pinned fingerprint/status, не допускает скрытого Start и позволяет безопасно вернуться к authoritative state после refresh/disconnect. **Given** сквозной UI flow **When** меняется Scenario revision, authorization expires либо Run становится terminal вне текущего экрана **Then** stale локальные данные инвалидируются, следующий допустимый action пересчитывается сервером **And** Playwright проверяет полный маршрут, back/refresh/reconnect и RU/EN states как один interaction contract.