# Platform Module Implementation Plan

## Purpose
Provide a lightweight, living plan for platform-level capabilities, with the Platform Service as the primary delivery vehicle for cross-service aggregation needed by the Console UI and CLI.

## Active work
- `docs/implplan/SPRINT_20251229_043_PLATFORM_platform_service_foundation.md` (Platform Service foundation).

## Near-term deliverables
- `StellaOps.Platform.WebService` skeleton with health endpoint and auth wiring.
- Aggregation endpoints for health, quotas, onboarding, preferences, and global search.
- Deterministic caching behavior with "data as of" metadata for offline display.
- Platform metadata endpoint and capability listing for UI bootstrapping.
- Gateway registration and scoped access policies.
- Unit + integration tests for ordering, caching, and error handling.
- Postgres schema stub for platform state (`docs/db/schemas/platform.sql`).

## Dependencies
- Authority (identity, scopes, tenant claims).
- Gateway/Router (route registration, auth headers, rate limits).
- Orchestrator, Notifier, and storage services for aggregation inputs.

## Evidence of completion
- Service project under `src/Platform/StellaOps.Platform.WebService`.
- Updated platform documentation and runbooks.
- Postgres schema spec at `docs/db/schemas/platform.sql`.
- Passing deterministic aggregation tests.

## Reference docs
- `docs/modules/platform/platform-service.md`
- `docs/modules/platform/architecture.md`
- `docs/modules/platform/architecture-overview.md`