save checkpoint: save features
This commit is contained in:
@@ -0,0 +1,36 @@
|
||||
# Platform Setup Wizard Backend API
|
||||
|
||||
## Module
|
||||
Platform
|
||||
|
||||
## Status
|
||||
VERIFIED
|
||||
|
||||
## Description
|
||||
Real /api/v1/setup/* endpoints replacing UI mocks with deterministic session state (create, resume, execute, skip, finalize), tenant scoping, and offline-first "data as of" metadata.
|
||||
|
||||
## Implementation Details
|
||||
- **SetupEndpoints**: `src/Platform/StellaOps.Platform.WebService/Endpoints/SetupEndpoints.cs` -- REST API at `/api/v1/setup` with 3 endpoint groups: sessions (GET current, POST create, POST resume, POST finalize), steps (POST execute, POST skip), definitions (GET step definitions); AllowAnonymous during initial setup, requires auth after completion
|
||||
- **SetupStateDetector**: detects setup completion state from storage/DB settings; routes between bootstrap context and authenticated context
|
||||
- **PlatformSetupService**: service layer for setup wizard operations (CreateSessionAsync, ResumeOrCreateSessionAsync, ExecuteStepAsync, SkipStepAsync, FinalizeSessionAsync, GetStepDefinitionsAsync)
|
||||
- **SetupWizardModels**: `src/Platform/StellaOps.Platform.WebService/Contracts/SetupWizardModels.cs` -- request/response models (CreateSetupSessionRequest, SetupSessionResponse, ExecuteSetupStepRequest, SkipSetupStepRequest, FinalizeSetupSessionRequest, FinalizeSetupSessionResponse, SetupStepDefinitionsResponse)
|
||||
- **Problem+JSON errors**: all endpoints return RFC 7807 ProblemDetails on errors
|
||||
- **Source**: SPRINT_20260112_004_PLATFORM_setup_wizard_backend.md
|
||||
|
||||
## E2E Test Plan
|
||||
- [ ] Verify setup session creates with bootstrap context when auth is unavailable
|
||||
- [ ] Test session resume returns existing session or creates new one
|
||||
- [ ] Verify step execution updates session state correctly
|
||||
- [ ] Test step skip marks step as skipped and advances session
|
||||
- [ ] Verify finalize completes setup and subsequent requests require authentication
|
||||
- [ ] Test step definitions endpoint returns all available setup steps
|
||||
|
||||
## Verification
|
||||
- Verified on 2026-02-11 with run-001 Tier 0/1/2 evidence.
|
||||
- Tier 1 build/test pass: platform webservice + platform webservice tests (100/100).
|
||||
- Tier 2 setup API behavior checks pass (7/7 setup-focused class tests) covering create/resume/execute/skip/finalize/definitions and required-step skip negative path.
|
||||
- Evidence:
|
||||
- `docs/qa/feature-checks/runs/platform/platform-setup-wizard-backend-api/run-001/tier0-source-check.json`
|
||||
- `docs/qa/feature-checks/runs/platform/platform-setup-wizard-backend-api/run-001/tier1-build-check.json`
|
||||
- `docs/qa/feature-checks/runs/platform/platform-setup-wizard-backend-api/run-001/tier2-api-check.json`
|
||||
|
||||
Reference in New Issue
Block a user