stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
4e07f7bd722a1b89f6ba32567c697d2553bc8300
git.stella-ops.org/docs/features/checked/platform/platform-setup-wizard-backend-api.md
master 5bca406787 save checkpoint: save features
2026-02-12 10:27:23 +02:00

2.5 KiB
Raw Blame History

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