Developer Portal Service — Sync Contract
Version: 1.0 Status: Draft Owner: Product + Developer Relations (DevRel) Last Updated: 2026-04-20
1. Intent
Per-aggregate conflict policy for offline / multi-device portal usage and cross-region replication. Most portal aggregates are server-authoritative; Verify sessions are append-only to attempts.
2. Per-Aggregate Policy
| Aggregate | Policy | Notes |
|---|---|---|
| DeveloperAccount | server_authoritative | TBD |
| ApiKey (metadata) | server_authoritative | secret never replicated client-side |
| SandboxSession | server_authoritative | TBD |
| VerifySession | append_only (attempts) + server_authoritative (state) | TBD |
| VerifyTemplate | server_authoritative | sourced from compliance-engine |
| SdkRelease | server_authoritative | immutable per version |
| DocsArticle | lww+diff | TBD (Markdown source-of-truth in Git) |
3. Replication Topology
- TBD
4. Conflict Resolution Examples
- TBD