# docs/roadmap/TASK_011_DETMIR_ROADMAP_CONFORMANCE_AUDIT.md ## Рекомендуемые параметры Mode: xhigh Reasoning: maximum Task type: conformance audit / product verification Quality bar: production-ready Breaking changes: forbidden Architecture changes: forbidden New features: forbidden Code changes: discouraged unless fixing broken checks Simplifications: forbidden Required checks: ```bash cargo fmt --all --check cargo clippy --all-targets --all-features -- -D warnings cargo test --all cargo build --release node scripts/deployment-readiness-smoke.mjs node scripts/pilot-validation-smoke.mjs AWATCH_PORTAL_SMOKE_URL=http://127.0.0.1:8720 node scripts/awatch-production-hardening-smoke.mjs ``` ## Цель Проверить, что фактически работающий AWatch-rus соответствует текущему roadmap, документации, заявленным контрактам и демо-сценариям. Не добавлять новую функциональность. Главная задача — найти расхождения между: * тем, что заявлено в roadmap; * тем, что заявлено в README/docs; * тем, что реально работает в API/портале/отчетах/агенте; * тем, что проверяют smoke tests. --- ## Область проверки Проверить соответствие следующих блоков: 1. Production hardening 2. Explainable KPI 3. Risk Narrative 4. Executive Action Center 5. Rust Agent Baseline 6. Demo Pack 7. Registry Readiness 8. Enterprise Deployment Guide 9. Pilot Validation readiness 10. Optional integrations positioning --- ## Что проверить ### 1. Roadmap Status Audit Проверить файлы: ```text docs/roadmap/ ``` Для каждой задачи проверить: * есть ли статус выполнения; * соответствует ли статус реальному состоянию; * есть ли ссылка на commit, если она уже добавлялась; * нет ли задач со статусом done, но без реализации; * нет ли реализованного функционала, который не отражен в roadmap. Результат оформить в: ```text docs/ROADMAP_CONFORMANCE_AUDIT_RU.md ``` --- ### 2. README Claims Audit Проверить README.md. Найти: * claims, которые подтверждаются кодом; * claims, которые подтверждаются только документацией; * claims, которые требуют уточнения; * claims, которые нужно убрать или смягчить. Особенно проверить, что README не заявляет: * полноценную DLP; * полноценную SIEM; * EDR/XDR; * ML/LLM scoring; * обязательный pfSense; * готовый React/Tauri UI; * auto-remediation. --- ### 3. API Conformance Audit Проверить, что реально существуют и работают endpoints: ```http GET /healthz GET /readyz GET /version GET /metrics GET /api/reports GET /api/workforce/kpi/explain GET /api/risk/narrative GET /api/actions ``` Проверить: * JSON response shape; * наличие request id / correlation id headers; * role gates; * query limits; * report range limits; * Prometheus metrics format. --- ### 4. Portal Conformance Audit Проверить UI/portal routes. Убедиться, что доступны и отображаются: * Executive Dashboard; * Workforce KPI; * Explainable KPI block; * Risk Narrative block; * Recommended Actions block; * Security view; * Forensics view; * reports view. Если какой-то блок есть в API, но не виден в UI — зафиксировать как gap. --- ### 5. Markdown Report Audit Проверить, что markdown reports содержат: * Workforce KPI; * Explainable KPI; * Risk Narrative; * Recommended Actions; * limitations; * no false DLP/SIEM/EDR claims. --- ### 6. Rust Agent Baseline Audit Проверить новый crate: ```text adk-rust/crates/awatch-agent/ ``` Проверить наличие: * config loader; * telemetry envelope; * heartbeat; * local spool; * retry/dead-letter; * /healthz; * /metrics; * structured JSON logging; * tests/smoke. Проверить, что он не делает: * keylogger; * screenshot capture; * clipboard capture; * packet interception; * kernel driver; * EDR; * DLP; * ML/LLM. Также проверить статус legacy/current runtime: ```text awatch-agent-rs ``` Убедиться, что документация честно различает: * current runtime; * new baseline core. --- ### 7. Optional Integrations Audit Проверить документы и README. Убедиться, что pfSense описан только как: ```text optional addon / contract_only / optional integration ``` Не как обязательная часть ядра. Проверить также 1C, AD/LDAP, SIEM/syslog, external storage — только как optional/future/where configured. --- ### 8. Demo Pack Audit Проверить: ```text docs/demo/ docs/screenshots/ ``` Проверить: * все demo docs существуют; * screenshots существуют; * screenshots не заглушки; * links валидны; * нет реальных IP/ФИО/логинов/данных заказчика; * используются только demo/test/example данные. --- ### 9. Registry Readiness Audit Проверить: ```text docs/REGISTRY_*.md ``` Проверить: * core/optional/not claimed разделены корректно; * нет юридических гарантий; * нет заявления "готово к реестру" без оговорок; * есть список remaining gaps; * есть честное описание open-source dependencies/SBOM. --- ### 10. Enterprise Deployment Audit Проверить: * deployment guide; * topologies; * sizing; * backup/recovery; * operations runbook; * security hardening; * acceptance checklist. Убедиться, что sizing не содержит неподтвержденных маркетинговых обещаний. --- ## Что создать Создать итоговый отчет: ```text docs/ROADMAP_CONFORMANCE_AUDIT_RU.md ``` Структура отчета: ```text # Roadmap Conformance Audit ## Executive Summary ## Overall Status ## Confirmed Implemented Items ## Partially Implemented Items ## Documentation-Only Items ## Gaps ## False Claims Found ## API Verification ## Portal Verification ## Agent Verification ## Demo Pack Verification ## Registry Readiness Verification ## Deployment Readiness Verification ## Recommended Fixes ## Next Roadmap Corrections ``` --- ## Допустимые изменения Разрешено: * исправлять документацию; * исправлять markdown links; * уточнять README claims; * добавлять smoke checks; * исправлять мелкие несоответствия, если они очевидны и не меняют архитектуру; * обновлять roadmap status. Нежелательно: * добавлять новую функциональность; * менять API; * менять UI; * менять agent behavior. Если обнаружена серьезная проблема в коде — не исправлять молча, а зафиксировать как gap и предложить отдельную задачу. --- ## Запрещено Не делать: * новые API; * новые UI-блоки; * новые agent collectors; * ML; * LLM; * DLP claims; * SIEM claims; * EDR claims; * auto-remediation; * обязательный pfSense; * переписывание архитектуры. --- ## Критерии приемки Задача выполнена, если: * создан `docs/ROADMAP_CONFORMANCE_AUDIT_RU.md`; * проверены roadmap/README/docs/API/portal/reports/agent/demo/registry/deployment; * smoke checks проходят; * ложные claims отсутствуют или исправлены; * найденные gaps зафиксированы; * предложены следующие корректировки roadmap. --- ## Финальный отчет Codex должен содержать 1. Краткое резюме аудита. 2. Подтвержденные реализованные блоки. 3. Частично реализованные блоки. 4. Documentation-only блоки. 5. Найденные gaps. 6. Исправленные claims/links, если были. 7. Результаты проверок. 8. Рекомендованные следующие задачи. --- ## Выполнение Статус: выполнено. Создан итоговый аудит: - `docs/ROADMAP_CONFORMANCE_AUDIT_RU.md` Исправлен найденный claim: - человеко-читаемый runtime output приведен к публичному названию `AWatch-rus`: заголовок Markdown-отчета, headline, KPI label и CLI help. Обновлен README: - добавлена ссылка на `docs/ROADMAP_CONFORMANCE_AUDIT_RU.md`. Подтвержденные блоки: - Production hardening; - Explainable KPI; - Risk Narrative; - Executive Action Center; - Rust Agent Baseline; - Demo Pack; - Registry Readiness; - Enterprise Deployment Guide; - Pilot Validation readiness. Выявленные gaps: - TASK_001-TASK_004 не имеют явной секции `Выполнение`; - для Risk Narrative нет отдельного `docs/RISK_NARRATIVE_RU.md`; - нужен отдельный visual/browser conformance smoke перед customer-facing freeze; - live customer-stand validation остается отдельным acceptance шагом; - старые GitHub-facing документы требуют отдельной naming hygiene cleanup. Проверки: - `cargo fmt --all --check` - OK; - `cargo clippy --all-targets --all-features -- -D warnings` - OK; - `cargo test --all` - OK; - `cargo build --release` - OK; - `node scripts/deployment-readiness-smoke.mjs` - OK; - `node scripts/pilot-validation-smoke.mjs` - OK; - `AWATCH_PORTAL_SMOKE_URL=http://127.0.0.1:8720 node scripts/awatch-production-hardening-smoke.mjs` - OK; - `git diff --check` - OK.