stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

feat(ui): ship quota health aoc operations cutover

Browse Source
This commit is contained in:
master
2026-03-08 08:18:51 +02:00
parent c9484c33ee
commit ac22ee3ce2
31 changed files with 1241 additions and 93 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
docs/features/checked/web/quota-health-aoc-operations-ui.md Normal file
View File

@@ -0,0 +1,71 @@
# Quota Health AOC Operations UI
## Module
Web
## Status
VERIFIED
## Description
Shipped the canonical `Ops > Operations` cutover for `Quotas & Limits`, `Health & SLO`, and `AOC Compliance`. The work repaired stale `/ops/*` and `platform-ops` deep links, completed quota actions that still stopped at placeholder behavior, and kept health and AOC drill-ins inside the mounted operations shell with usable route-backed filter state.
## Implementation Details
- **Feature directories**:
- `src/Web/StellaOps.Web/src/app/features/quota-dashboard/`
- `src/Web.StellaOps.Web/src/app/features/platform-health/`
- `src/Web.StellaOps.Web/src/app/features/aoc-compliance/`
- `src/Web.StellaOps.Web/src/app/features/platform/ops/`
- **Primary routes**:
- `/ops/operations/quotas`
- `/ops/operations/quotas/tenants`
- `/ops/operations/quotas/forecast`
- `/ops/operations/quotas/alerts`
- `/ops/operations/quotas/reports`
- `/ops/operations/health-slo`
- `/ops/operations/health-slo/services/:serviceName`
- `/ops/operations/health-slo/incidents`
- `/ops/operations/aoc`
- `/ops/operations/aoc/violations`
- `/ops/operations/aoc/provenance`
- `/ops/operations/aoc/ingestion`
- `/ops/operations/aoc/report`
- **Legacy aliases**:
- `/ops/quotas/*`
- `/ops/aoc/*`
- `/ops/health-slo/*`
- `/platform-ops/*`
- `/platform/ops/*`
- **Notable repaired behaviors**:
- quota dashboard query-driven category loading
- quota forecast action routing into alerts or reports
- tenant-detail CSV export and audit-log handoff
- quota alert test-payload generation
- route-backed AOC provenance validation
- AOC guard-violation request filtering
## E2E Test Plan
- **Setup**:
- [x] Start the local Angular test server with `npm run serve:test`.
- [x] Use a test session with Ops and admin scopes.
- **Core verification**:
- [x] Verify old quota alert deep links land on the canonical Operations route.
- [x] Verify stale platform health detail bookmarks land on canonical health service detail.
- [x] Verify old AOC provenance links keep query intent and still render a successful validation result.
- **Cutover verification**:
- [x] Verify the Angular unit suite covers route alias inventory, quota query actions, and AOC violation filter behavior.
- [x] Verify the production build still completes after the cutover.
## Verification
- Run:
- `npm test -- --watch=false --include src/tests/platform-ops/platform-ops-routes.spec.ts --include src/tests/quotas/quota-operations-cutover.spec.ts --include src/tests/aoc_verification/guard-violations-list.component.spec.ts --include src/tests/platform_health/platform-health-dashboard.spec.ts`
- `npm run serve:test`
- `PLAYWRIGHT_BASE_URL=https://127.0.0.1:4400 npx playwright test tests/e2e/quota-health-aoc-operations.spec.ts --workers=1`
- `npm run build`
- Tier 0 (source): pass
- Tier 1 (build/tests): pass
- Tier 2 (behavior): pass
- Notes:
- Angular targeted tests passed: `4` files, `13` tests.
- Playwright passed: `3` scenarios.
- Production build passed; existing bundle-budget warnings remain unchanged from the baseline.
- Verified on (UTC): 2026-03-08T06:10:00Z

3
docs/modules/ui/README.md
View File

@@ -24,6 +24,8 @@ The Console presents operator dashboards for scans, policies, VEX evidence, runt
- Added checked-feature verification for operations consolidation at `../../features/checked/web/operations-consolidation-ui.md`.
- Shipped the canonical offline and air-gap operations flow under `Ops > Operations`, including repaired stale `/ops/*` and `/platform-ops/*` deep links, usable Offline Kit actions, and Evidence or Trust handoffs.
- Added checked-feature verification for offline operations at `../../features/checked/web/offline-operations-ui.md`.
- Shipped the canonical `Quotas & Limits`, `Health & SLO`, and `AOC Compliance` cutover under `Ops > Operations`, including repaired legacy aliases, usable quota exports and payload generation, and route-backed AOC filtering or provenance validation.
- Added checked-feature verification for quota, health, and AOC operations at `../../features/checked/web/quota-health-aoc-operations-ui.md`.
- Shipped the shared contextual placement primitives for tabs, submenu pills, route-aware drawers, list-detail shells, grouped overview cards, and return-to-context headers under `src/Web/StellaOps.Web/src/app/shared/ui/`.
- Added checked-feature verification for the contextual primitives and their first adopted surfaces at `../../features/checked/web/contextual-actions-patterns-ui.md`.
@@ -72,6 +74,7 @@ The Console presents operator dashboards for scans, policies, VEX evidence, runt
- ./reachability-witnessing/README.md
- ./platform-ops-consolidation/README.md
- ./offline-operations/README.md
- ./quota-health-aoc-operations/README.md
- ./triage-explainability-workspace/README.md
- ./workflow-visualization-replay/README.md
- ./contextual-actions-patterns/README.md

4
docs/modules/ui/TASKS.md
View File

@@ -92,6 +92,10 @@
- [DONE] FE-OFF-003 Complete supporting export, verification, and trust workflows
- [DONE] FE-OFF-004 Verify canonical offline operations journeys
- [DONE] FE-OFF-005 Sync docs, archive the sprint, and record the shipped feature
- [DONE] FE-QHA-001 Freeze canonical route and alias contract
- [DONE] FE-QHA-002 Complete quota operator workflows
- [DONE] FE-QHA-003 Complete health and AOC operator workflows
- [DONE] FE-QHA-004 Verify cutover, sync docs, and archive
- [DONE] FE-PO-001 Freeze Operations overview taxonomy and submenu structure
- [DONE] FE-PO-002 Overview page regrouping and blocking-card contract
- [DONE] FE-PO-003 Legacy widget absorption matrix for Platform Ops

4
docs/modules/ui/component-preservation-map/RESTORATION_PRIORITIES.md
View File

@@ -140,7 +140,7 @@ These are mostly not dropped products. They are current or near-current capabili
- consolidated ops operations subtree
### 10. Quota, Platform Health, And AOC Operations
- Type: `wire-in / preserve`
- Type: `shipped`
- Confidence: `high`
- Branches:
- `Quota Dashboard`
@@ -149,6 +149,8 @@ These are mostly not dropped products. They are current or near-current capabili
- `Platform`
- Target:
- `/ops/operations/*`
- Status:
- shipped on 2026-03-08 as the canonical Operations child-route cutover
### 11. Topology And Trust Administration
- Type: `wire-in / preserve`

2
docs/modules/ui/implementation_plan.md
View File

@@ -29,9 +29,11 @@ Provide a living plan for UI deliverables, dependencies, and evidence.
- `docs/features/checked/web/contextual-actions-patterns-ui.md` - shipped verification note for the shared contextual route-state, headers, drawers, list-detail shells, grouped overview cards, and first adopted restoration surfaces.
- `docs/features/checked/web/unified-audit-surfaces-ui.md` - shipped verification note for the Evidence-owned audit shell, admin bookmark redirects, repaired audit subview links, and secondary handoff entry points.
- `docs/features/checked/web/offline-operations-ui.md` - shipped verification note for the canonical Offline Kit and Feeds & Airgap owner routes, repaired stale aliases, and completed offline shell actions.
- `docs/features/checked/web/quota-health-aoc-operations-ui.md` - shipped verification note for canonical quota, health, and AOC owner routes, repaired deep links, route-backed filters, and completed operator actions.
- `docs/modules/ui/reachability-witnessing/README.md` - detailed witness and proof UX dossier plus cross-shell deep-link contract.
- `docs/modules/ui/platform-ops-consolidation/README.md` - detailed Operations overview taxonomy and legacy absorption plan.
- `docs/modules/ui/offline-operations/README.md` - detailed owner-shell contract for Offline Kit, Feeds & Airgap, Evidence handoffs, and stale alias policy.
- `docs/modules/ui/quota-health-aoc-operations/README.md` - canonical owner-shell contract for quota, health, and AOC operations cutover plus alias and action rules.
- `docs/modules/ui/triage-explainability-workspace/README.md` - detailed artifact workspace and audit-bundle UX dossier.
- `docs/modules/ui/workflow-visualization-replay/README.md` - detailed run-detail graph, timeline, replay, and evidence UX dossier.
- `docs/modules/ui/contextual-actions-patterns/README.md` - shared placement contract for stray actions, pages, drawers, and tabs.

65
docs/modules/ui/quota-health-aoc-operations/README.md Normal file
View File

@@ -0,0 +1,65 @@
# Quota Health AOC Operations
## Purpose
- Finish the `Ops > Operations` cutover for `Quotas & Limits`, `Health & SLO`, and `AOC Compliance`.
- Replace stale route fragments and half-wired actions with one usable operator flow under the mounted Operations shell.
## Canonical Owner
- Owner shell: `Ops > Operations`
- Primary routes:
- `/ops/operations/quotas`
- `/ops/operations/quotas/tenants`
- `/ops/operations/quotas/forecast`
- `/ops/operations/quotas/alerts`
- `/ops/operations/quotas/reports`
- `/ops/operations/health-slo`
- `/ops/operations/health-slo/services/:serviceName`
- `/ops/operations/health-slo/incidents`
- `/ops/operations/aoc`
- `/ops/operations/aoc/violations`
- `/ops/operations/aoc/provenance`
- `/ops/operations/aoc/ingestion`
- `/ops/operations/aoc/report`
## Legacy Alias Policy
- Preserve shorthand and stale bookmarks by redirecting:
- `/ops/quotas/*`
- `/ops/aoc/*`
- `/ops/health-slo/*`
- `/platform-ops/quotas/*`
- `/platform-ops/aoc/*`
- `/platform-ops/health-slo/*`
- `/platform/ops/quotas/*`
- `/platform/ops/aoc/*`
- `/platform/ops/health-slo/*`
- Redirects must preserve query params and fragments because these pages use route-backed filter or drill-in state.
## UX Rules
- `Quotas & Limits` owns quota drill-ins, forecast routing, alert thresholds, and report export.
- `Health & SLO` owns service detail and incident history; service tiles must not deep-link into stale `platform` paths.
- `AOC Compliance` owns provenance validation, violation triage, ingestion monitoring, and compliance export.
- Cross-shell actions should stay contextual:
- quota tenant detail can hand off into `Evidence > Audit Log`
- critical quota forecasts can hand off into quota reports with prefilled category intent
- AOC provenance validation must stay bookmarkable through query params
## Shipped In This Cut
- Added canonical route helpers and alias coverage for quota, health, and AOC old bookmarks.
- Rewired the Operations navigation tree so AOC no longer points at stale `/ops/aoc` paths.
- Made quota dashboard category chips drive real history and forecast loading through the URL.
- Repaired quota forecast, alert, tenant-detail, and report flows so they use canonical routes and usable local export or payload generation instead of dead links or console placeholders.
- Repaired health breadcrumbs and service drill-ins to stay inside the mounted `Health & SLO` subtree.
- Repaired AOC provenance navigation and made guard-violation filters affect the actual request payload.
## Preserved Value
- Keep:
- quota capacity planning and threshold tuning
- service-level health drill-ins and incident export
- AOC provenance explanation and guard-violation triage
- Why:
- these are not abandoned product ideas; they are real operator surfaces that had route and workflow drift after the Operations shell consolidation
## Related Docs
- `docs/modules/ui/platform-ops-consolidation/README.md`
- `docs/features/checked/web/quota-health-aoc-operations-ui.md`
- `docs/modules/ui/component-preservation-map/RESTORATION_PRIORITIES.md`