stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
6e00a48e00da3b2cfbd976a53254275fa63583a6
git.stella-ops.org/docs/features/checked/platform/platform-service-aggregation-layer.md
master 5bca406787 save checkpoint: save features
2026-02-12 10:27:23 +02:00

2.9 KiB
Raw Blame History

Platform Service Aggregation Layer

Module

Platform

Status

VERIFIED

Description

Backend Platform Service acting as aggregation layer for health status, quotas, onboarding progress, user preferences, and global search across all modules.

Implementation Details

  • PlatformEndpoints: src/Platform/StellaOps.Platform.WebService/Endpoints/PlatformEndpoints.cs -- REST API at /api/v1/platform with 6 endpoint groups: health (summary/dependencies/incidents/metrics), quotas (summary/tenants/alerts), onboarding (status/complete/skip), preferences (dashboard/profiles), search, metadata; all with tenant-scoped authorization policies
  • PlatformHealthService: src/Platform/StellaOps.Platform.WebService/Services/PlatformHealthService.cs -- aggregates health status from all platform services
  • PlatformQuotaService: service for quota tracking with alert management (create alert thresholds per tenant)
  • PlatformOnboardingService: src/Platform/StellaOps.Platform.WebService/Services/PlatformOnboardingService.cs -- tracks onboarding progress with step completion and skip support
  • PlatformPreferencesService: src/Platform/StellaOps.Platform.WebService/Services/PlatformPreferencesService.cs -- user dashboard preferences with profile management (CRUD)
  • PlatformSearchService: global search across all modules with source filtering, pagination
  • PlatformMetadataService: src/Platform/StellaOps.Platform.WebService/Services/PlatformMetadataService.cs -- platform metadata retrieval
  • PlatformCache: src/Platform/StellaOps.Platform.WebService/Services/PlatformCache.cs -- caching layer with TTL and data-as-of timestamps
  • Source: SPRINT_20251229_043_PLATFORM_platform_service_foundation

E2E Test Plan

  • Verify health summary endpoint aggregates all service statuses
  • Test quota alerts are created and returned with proper authorization
  • Verify onboarding step completion transitions correctly
  • Test global search returns results from multiple sources with pagination
  • Verify dashboard preferences persist and load per tenant/user

Verification

  • Verified on 2026-02-11 with run-001.
  • Tier 0 source checks confirmed aggregation endpoint + service/cache implementation parity.
  • Tier 1 build and endpoint test suite passed (98/98) after adding quota alert and search pagination/filter coverage.
  • Tier 2 API behavior checks passed for health, quota (positive + negative), onboarding, preferences, and search routes using live HTTP request/response transactions against http://127.0.0.1:10011.
  • Evidence:
    • docs/qa/feature-checks/runs/platform/platform-service-aggregation-layer/run-001/tier0-source-check.json
    • docs/qa/feature-checks/runs/platform/platform-service-aggregation-layer/run-001/tier1-build-check.json
    • docs/qa/feature-checks/runs/platform/platform-service-aggregation-layer/run-001/tier2-api-check.json