2.6 KiB
2.6 KiB
Pack 23 - Platform Global Ops/Integrations/Setup Advisory Delta
Status: Active high-precedence authority for Platform IA and ownership
Date: 2026-02-20
Precedence: Overrides pack-22.md and lower packs for overlapping Platform navigation, ownership, and operator workflow behavior.
1) Intent
- Make
Platforma global root and consolidate operability into one module shell. - Keep three explicit Platform subdomains:
Ops,Integrations,Setup.
- Reduce cognitive load by consolidating operations surfaces around decision impact.
2) Canonical Platform model
2.1 Platform as global root
Platformis a top-level module.IntegrationsandSetupare no longer separate top-level roots.- Canonical IA under Platform:
/platform/ops/*/platform/integrations/*/platform/setup/*
2.2 Ops workflow priority
Ops primary workflows:
Data IntegrityJobs & QueuesHealth & SLO
Ops secondary tools:
Feeds & AirgapQuotas & LimitsDiagnostics
2.3 Ownership boundaries
Topologyowns hosts/targets/agents management.Platform Integrationsowns external systems only:- Registries,
- SCM,
- CI/CD,
- Runtimes / Hosts (connectors only),
- Advisory sources,
- VEX sources,
- Secrets.
Platform Setupowns inventory and orchestration setup:- Regions & Environments,
- Promotion Paths,
- Workflows & Gates,
- Gate Profiles,
- Release Templates.
- Feed Policy,
- Defaults & Guardrails.
3) Degraded/offline UX contract
Platform operator views must provide:
- explicit decision impact label (
BLOCKING,DEGRADED,INFO), - retry controls,
- copyable correlation ID,
- last-known-good/read-only context when live dependencies degrade.
4) Route mapping directives
- Keep legacy aliases for migration safety:
/integrations/*->/platform/integrations/*/platform-ops/*and/operations/*->/platform/ops/*
- Legacy hosts/targets integration links must redirect to Topology:
/platform/integrations/hosts->/topology/hosts/platform/integrations/targets*->/topology/targets
5) Planning and QA gates
- Platform nav and submenus reflect the Ops/Integrations/Setup split.
- Integrations screens do not present hosts/targets/agents as managed integration categories.
- Integrations include
Runtimes / Hostsas connector category while inventory ownership remains in Topology. - Setup routes render setup-owned pages, including
Feed Policy,Gate Profiles, andDefaults & Guardrails. - Focused FE route/nav/platform tests pass for changed surfaces before sprint closure.