Files
AWatch-rus/docs/PILOT_V1_EVIDENCE_RU.md
T

6.2 KiB

Pilot v1.0 Evidence

Базовый контур

Базовый commit Pilot v1.0: 067ad0939c3b8c34df8af9ff55bb219277d08341.

Назначение evidence-документа: показать, какие артефакты подтверждают готовность AWatch-rus Pilot v1.0 к демонстрации и приемке по ролям, API contracts, UEBA Score v1 и pfSense readiness.

Product boundary evidence

Область Артефакт Что подтверждает
Позиционирование PILOT_V1_RU.md Workforce Analytics + Security Analytics + Forensics
Роли ROLES_RU.md executive, manager, security, forensics, admin
UEBA UEBA_SCORE_RU.md rule-based scoring без ML/LLM
pfSense PFSENSE_INTEGRATION_RU.md readiness=contract_only, без SIEM/ingestion claims
Demo сценарий CUSTOMER_DEMO_SCENARIO_RU.md 10-минутный показ заказчику
Pilot v1 demo PILOT_DEMO_SCENARIO_RU.md воспроизводимый demo-pack по ролям
Demo Executive demo/DEMO_SCENARIO_EXECUTIVE_RU.md сценарий руководителя
Demo Security demo/DEMO_SCENARIO_SECURITY_RU.md сценарий ИБ
Demo Forensics demo/DEMO_SCENARIO_FORENSICS_RU.md сценарий расследований
Demo report DEMO_REPORT_EXAMPLE_RU.md пример итогового Markdown-отчета
Pilot value PILOT_VALUE_PROPOSITION_RU.md ценность пилота для заказчика
Преддемо DEMO_RUNBOOK_RU.md прогрев и порядок проверки перед показом
Gap analysis PILOT_GAP_ANALYSIS_RU.md известные риски и остаточные ограничения

API evidence

Endpoint Evidence Приемочный смысл
/api/reports smoke + OpenAPI общий отчет, role-filtered payload
/api/executive OpenAPI + role gate smoke Executive Dashboard
/api/workforce OpenAPI + role gate smoke Workforce Portal
/api/security OpenAPI + role gate smoke Security Portal
/api/forensics OpenAPI + role gate smoke Forensics Portal
/api/ueba OpenAPI + tests UEBA Score v1
/api/pfsense OpenAPI + fixture pfSense readiness contract_only
/api/contracts/openapi.json repository contract стабильный OpenAPI contract
/api/contracts/typescript.d.ts repository contract стабильные TypeScript declarations

Контрактные файлы:

  • adk-rust/crates/detmir-portal/src/contracts/openapi.json;
  • adk-rust/crates/detmir-portal/src/contracts/typescript.d.ts.

Demo data evidence

Демонстрационные материалы:

  • docs/screenshots/01-executive-overview.png;
  • docs/screenshots/02-risk-heatmap.png;
  • docs/screenshots/03-security-view.png;
  • docs/screenshots/04-operations-view.png;
  • docs/screenshots/05-investigation-pack.png;
  • docs/screenshots/06-markdown-report.png;
  • docs/screenshots/07-product-architecture.png;
  • docs/fixtures/pfsense-demo-events.json;
  • docs/fixtures/pilot-v1-demo/demo-seed-data.json;
  • docs/fixtures/pilot-v1-demo/evidence-pack/executive-summary.md;
  • docs/fixtures/pilot-v1-demo/evidence-pack/security-technical-summary.md;
  • docs/fixtures/pilot-v1-demo/evidence-pack/investigation-report.md;
  • docs/fixtures/pilot-v1-demo/evidence-pack/investigation-contract.json;
  • docs/demo/DEMO_SCENARIO_EXECUTIVE_RU.md;
  • docs/demo/DEMO_SCENARIO_SECURITY_RU.md;
  • docs/demo/DEMO_SCENARIO_FORENSICS_RU.md;
  • docs/demo/DEMO_PACK_ACCEPTANCE_CHECKLIST_RU.md;
  • docs/DEMO_REPORT_EXAMPLE_RU.md;
  • docs/PILOT_VALUE_PROPOSITION_RU.md.

Требования:

  • не использовать реальные IP-адреса;
  • не использовать реальные hostname;
  • не использовать реальные логины;
  • не использовать ФИО сотрудников;
  • не использовать реальные подразделения заказчика;
  • не использовать реальные события безопасности.

Для сетевых примеров допустимы только RFC 5737 диапазоны:

  • 192.0.2.0/24;
  • 198.51.100.0/24;
  • 203.0.113.0/24.

Verification evidence

Обязательный набор команд:

cd adk-rust
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo build --workspace --release
cd ..
git diff --check
node scripts/detmir-portal-tabs-smoke.mjs
node scripts/detmir-pilot-demo-smoke.mjs

Что подтверждают команды:

  • cargo fmt --all --check - Rust-код форматирован.
  • cargo clippy --workspace --all-targets -- -D warnings - нет warnings в workspace.
  • cargo test --workspace - unit/integration tests проходят.
  • cargo build --workspace --release - release-сборка workspace проходит.
  • git diff --check - нет whitespace-ошибок в diff.
  • node scripts/detmir-portal-tabs-smoke.mjs - портал, вкладки, роли и server-side role gates проходят smoke.
  • node scripts/detmir-pilot-demo-smoke.mjs - demo-навигация, API contracts и role-filtering для Pilot v1 demo проходят smoke.

Приемочный вывод

Pilot v1.0 готов к демонстрации, если:

  • все команды verification evidence прошли успешно;
  • role gates подтверждены smoke-тестом;
  • UEBA Score v1 остается rule-based;
  • pfSense readiness остается contract_only;
  • документация не содержит обещаний SIEM, классического DLP, ML/LLM или реального pfSense ingestion.