68 lines
3.5 KiB
Markdown
68 lines
3.5 KiB
Markdown
# A/B Deploy Diff Panel
|
|
|
|
## Module
|
|
Web
|
|
|
|
## Status
|
|
VERIFIED
|
|
|
|
## Description
|
|
Deploy diff UI provides deterministic A/B SBOM comparison with policy-hit context, loading/error states, and inline release action controls.
|
|
|
|
As of 2026-03-09 the panel is no longer wired to the dead `/api/v1/sbom/diff` route. The canonical comparison source is SbomService lineage compare, and the surrounding Releases workspace now degrades to an actionable `No Comparison Selected` state instead of a hard route failure when no digests are present.
|
|
|
|
## Implementation Details
|
|
- **Feature directory**: `src/Web/StellaOps.Web/src/app/features/deploy-diff/`
|
|
- **Route module**: `src/Web/StellaOps.Web/src/app/features/deploy-diff/deploy-diff.routes.ts`
|
|
- **Core files**:
|
|
- `src/Web/StellaOps.Web/src/app/features/deploy-diff/pages/deploy-diff.page.ts`
|
|
- `src/Web/StellaOps.Web/src/app/features/deploy-diff/components/deploy-diff-panel/deploy-diff-panel.component.ts`
|
|
- `src/Web/StellaOps.Web/src/app/features/deploy-diff/services/deploy-diff.service.ts`
|
|
- **Canonical backend dependency**:
|
|
- `GET /api/v1/lineage/compare?a=<fromDigest>&b=<toDigest>&tenant=<tenantId>`
|
|
- **Focused tests**:
|
|
- `src/Web/StellaOps.Web/src/app/features/deploy-diff/services/deploy-diff.service.spec.ts`
|
|
- `src/Web/StellaOps.Web/src/app/features/deploy-diff/components/deploy-diff-panel/deploy-diff-panel.component.spec.ts`
|
|
- `src/Web/StellaOps.Web/src/app/features/deploy-diff/pages/deploy-diff.page.spec.ts`
|
|
|
|
## Follow-up Notes
|
|
- Primary Releases shell mounts the canonical workspace at `/releases/investigation/deploy-diff`.
|
|
- Direct shell navigation without digests is a supported workspace state, not an error path.
|
|
|
|
## Verification
|
|
- Date: 2026-02-10
|
|
- Run artifacts: `docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-001/`
|
|
- Tier results:
|
|
- `tier0-source-check.json`: pass
|
|
- `tier1-build-check.json`: pass
|
|
- `tier2-e2e-check.json`: pass
|
|
|
|
## Recheck (run-003)
|
|
- Date (UTC): 2026-02-10
|
|
- Status: VERIFIED (replayed)
|
|
- Tier 1 evidence: Angular build passed and checked-web suite passed 145/145.
|
|
- Tier 2 evidence: docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-003/tier2-e2e-check.json.
|
|
|
|
## Recheck (run-004)
|
|
- Date (UTC): 2026-02-10
|
|
- Status: VERIFIED (replayed)
|
|
- Tier 1 evidence: Angular build passed and checked-web suite passed 145/145 across 47 files.
|
|
- Tier 2 evidence: docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-004/tier2-e2e-check.json.
|
|
|
|
## Recheck (run-006)
|
|
- Date (UTC): 2026-02-11T07:13:55Z
|
|
- Status: VERIFIED (strict Tier 2 UI replay)
|
|
- Tier 1 evidence: `docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-006/tier1-build-check.json`
|
|
- Tier 2 evidence: `docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-006/tier2-ui-check.json`
|
|
- Notes: Playwright now covers positive deploy-diff rendering plus missing-parameter and API-error user paths; route is mounted in the primary shell map.
|
|
|
|
## Recheck (2026-03-09)
|
|
- Status: VERIFIED (lineage compare contract repair)
|
|
- Tier 1 evidence:
|
|
- `npx ng test --watch=false --ts-config tsconfig.spec.features.json --include=src/app/features/deploy-diff/services/deploy-diff.service.spec.ts --include=src/app/features/deploy-diff/components/deploy-diff-panel/deploy-diff-panel.component.spec.ts --include=src/app/features/deploy-diff/pages/deploy-diff.page.spec.ts`
|
|
- Tier 2 target:
|
|
- live `https://stella-ops.local/releases/investigation/deploy-diff`
|
|
- Notes:
|
|
- direct route loads an actionable workspace when digests are missing
|
|
- loaded comparisons are normalized from lineage compare into the deploy-diff UI model
|