5.0 KiB
docs/roadmap/TASK_009_ENTERPRISE_DEPLOYMENT_GUIDE.md
Рекомендуемые параметры
Mode: xhigh Reasoning: maximum Task type: deployment readiness Quality bar: production-ready Breaking changes: forbidden Architecture changes: forbidden Simplifications: forbidden
Цель
Подготовить полный комплект документации и проверок для внедрения AWatch-rus в инфраструктуре заказчика.
Не добавлять новый функционал.
Использовать существующие возможности.
Что реализовать
- Deployment Guide
Создать:
docs/ENTERPRISE_DEPLOYMENT_GUIDE_RU.md
Описать:
- архитектуру развертывания;
- минимальную инсталляцию;
- пилотную инсталляцию;
- рекомендуемую инсталляцию;
- ограничения.
- Topology Examples
Создать:
docs/DEPLOYMENT_TOPOLOGIES_RU.md
Сценарии:
- standalone;
- pilot;
- small company;
- medium company;
- enterprise.
Для каждого сценария:
- компоненты;
- размещение;
- пример потоков данных.
- Sizing Guide
Создать:
docs/SIZING_GUIDE_RU.md
Минимум:
- до 50 пользователей;
- до 250 пользователей;
- до 1000 пользователей;
- более 1000 пользователей.
Без маркетинговых обещаний.
Указать, что оценки требуют валидации.
- Backup and Recovery
Создать:
docs/BACKUP_AND_RECOVERY_RU.md
Описать:
- резервирование конфигурации;
- резервирование отчетов;
- восстановление;
- ограничения.
- Operations Runbook
Создать:
docs/OPERATIONS_RUNBOOK_RU.md
Описать:
- healthz;
- readyz;
- metrics;
- smoke;
- журналирование;
- типовые сбои;
- диагностику.
- Security Hardening Guide
Создать:
docs/SECURITY_HARDENING_RU.md
Описать:
- TLS;
- reverse proxy;
- firewall;
- учетные записи;
- права доступа;
- журналирование.
Без ложных security claims.
- Acceptance Checklist
Создать:
docs/ENTERPRISE_ACCEPTANCE_CHECKLIST_RU.md
Пункты:
- установка;
- запуск;
- доступность API;
- портал;
- smoke;
- документация;
- резервирование.
- Deployment Smoke
Создать:
scripts/deployment-readiness-smoke.*
Проверять:
- наличие документации;
- наличие screenshots;
- наличие roadmap;
- наличие registry docs;
- наличие demo docs.
Запрещено
Не делать:
- новый код продукта;
- новые API;
- новые агенты;
- новые UI;
- новые claims;
- ML;
- LLM.
Критерии приемки
- документы созданы;
- ссылки валидны;
- smoke проходит;
- README обновлен при необходимости;
- deployment сценарии описаны;
- sizing описан;
- backup описан;
- runbook описан.
Финальный отчет
- Список документов.
- Список обновлений.
- Deployment scenarios.
- Sizing assumptions.
- Backup model.
- Runbook.
- Acceptance checklist.
- Проверки.
- Ограничения.
Выполнение
Статус: done.
Созданные документы:
docs/ENTERPRISE_DEPLOYMENT_GUIDE_RU.md;docs/DEPLOYMENT_TOPOLOGIES_RU.md;docs/SIZING_GUIDE_RU.md;docs/BACKUP_AND_RECOVERY_RU.md;docs/OPERATIONS_RUNBOOK_RU.md;docs/SECURITY_HARDENING_RU.md;docs/ENTERPRISE_ACCEPTANCE_CHECKLIST_RU.md.
Созданный smoke:
scripts/deployment-readiness-smoke.mjs.
Обновленные документы:
README.md;docs/roadmap/TASK_009_ENTERPRISE_DEPLOYMENT_GUIDE.md.
Deployment scenarios:
- standalone;
- pilot;
- small company;
- medium company;
- enterprise.
Sizing assumptions:
- до 50 пользователей;
- до 250 пользователей;
- до 1000 пользователей;
- более 1000 пользователей;
- все оценки требуют проверки на инфраструктуре заказчика.
Backup model:
- config backup;
- reports/state backup;
- evidence metadata backup where used;
- restore test;
- rollback after upgrade.
Runbook:
/healthz;/readyz;/metrics;- smoke;
- logs;
- типовые сбои;
- диагностика.
Ограничения:
- новый продуктовый код, API, агенты и UI не добавлялись;
- ML/LLM не добавлялись;
- новые security claims не добавлялись;
- sizing не заявлен как гарантия без валидации.