awatch-rus/AWatch-rus
1
0
Fork 0
Code Issues Pull Requests Actions 100 Packages Projects Releases Wiki Activity
Files
cfeaf772ea208ffce293ab3c0286cda650be80c4
AWatch-rus/docs/roadmap/TASK_011_DETMIR_ROADMAP_CONFORMANCE_AUDIT.md
T

10 KiB
Raw Blame History

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:

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

Проверить файлы:

docs/roadmap/

Для каждой задачи проверить:

  • есть ли статус выполнения;
  • соответствует ли статус реальному состоянию;
  • есть ли ссылка на commit, если она уже добавлялась;
  • нет ли задач со статусом done, но без реализации;
  • нет ли реализованного функционала, который не отражен в roadmap.

Результат оформить в:

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:

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:

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:

awatch-agent-rs

Убедиться, что документация честно различает:

  • current runtime;
  • new baseline core.

7. Optional Integrations Audit

Проверить документы и README.

Убедиться, что pfSense описан только как:

optional addon / contract_only / optional integration

Не как обязательная часть ядра.

Проверить также 1C, AD/LDAP, SIEM/syslog, external storage — только как optional/future/where configured.

8. Demo Pack Audit

Проверить:

docs/demo/
docs/screenshots/

Проверить:

  • все demo docs существуют;
  • screenshots существуют;
  • screenshots не заглушки;
  • links валидны;
  • нет реальных IP/ФИО/логинов/данных заказчика;
  • используются только demo/test/example данные.

9. Registry Readiness Audit

Проверить:

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 не содержит неподтвержденных маркетинговых обещаний.

Что создать

Создать итоговый отчет:

docs/ROADMAP_CONFORMANCE_AUDIT_RU.md

Структура отчета:

# 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.
Reference in New Issue View Git Blame Copy Permalink