Game Platform Documentation

This repository is the canonical source of truth for the game platform.

All architectural decisions, system design, and service boundaries are defined here. Implementation repositories MUST align with the documentation in this repo.

Scope

This repository contains:

• System architecture overview
• Technical Solution Design (TSD)
• Architecture Decision Records (ADR)
• Service boundaries and governance rules

Authoritative Rules

• One game = one service
• Firebase is the single source of truth for authentication
• Authentication tokens are never cached
• Payment integration is isolated in the payment service
• Game services never contain payment or auth logic

Repository Types (Referenced)

• game-orchestrator
• game-*-service
• payment-service
• game-contracts
• platform-infra-templates

All other repositories MUST reference this repository when making architectural changes.

Change Policy

• Architecture changes require an ADR
• New services require a TSD before implementation
• Breaking changes must be documented before merge