Frontend gaps fill work. Testing fixes work. Auditing in progress.
This commit is contained in:
36
src/Platform/AGENTS.md
Normal file
36
src/Platform/AGENTS.md
Normal file
@@ -0,0 +1,36 @@
|
||||
# Platform Service (StellaOps.Platform)
|
||||
|
||||
## Mission
|
||||
Define and deliver the Platform Service that aggregates cross-service views for the Console UI and CLI (health, quotas, onboarding, preferences, global search).
|
||||
|
||||
## Roles
|
||||
- Backend engineer: service APIs, aggregation, caching, and contracts.
|
||||
- QA automation engineer: deterministic tests, offline cache coverage, integration harness.
|
||||
- Docs maintainer: platform service architecture, API contracts, and runbooks.
|
||||
|
||||
## Operating principles
|
||||
- Aggregation-only: never mutate raw evidence or policy results.
|
||||
- Deterministic outputs: stable ordering, UTC timestamps, content-addressed cache keys.
|
||||
- Offline-first: cache last-known snapshots and surface "data as of" metadata.
|
||||
- Tenancy-aware: enforce Authority claims and scope filters on every request.
|
||||
|
||||
## Required reading
|
||||
- `docs/modules/platform/architecture-overview.md`
|
||||
- `docs/modules/platform/architecture.md`
|
||||
- `docs/modules/platform/platform-service.md`
|
||||
- `docs/07_HIGH_LEVEL_ARCHITECTURE.md`
|
||||
- `docs/modules/gateway/architecture.md`
|
||||
- `docs/modules/authority/architecture.md`
|
||||
|
||||
## Working directory
|
||||
- `src/Platform/StellaOps.Platform.WebService` (to be created)
|
||||
|
||||
## Testing expectations
|
||||
- Unit tests for aggregation ordering and error handling.
|
||||
- Integration tests for fan-out to downstream services with deterministic fixtures.
|
||||
- Offline cache tests that validate "data as of" metadata and read-only behavior.
|
||||
|
||||
## Working agreement
|
||||
- Update sprint status in `docs/implplan/SPRINT_*.md` when starting/stopping work.
|
||||
- Document cross-module contract changes in sprint Decisions & Risks.
|
||||
- Avoid non-deterministic data ordering or timestamps in responses.
|
||||
Reference in New Issue
Block a user