galaxy-game/user/docs/README.md

User Service Docs

This directory keeps service-local documentation that is more operational or more example-heavy than ../README.md.

Sections:

• Runtime and components
• Main flows and boundaries
• Operator runbook
• Contract examples

Decision records:

• PostgreSQL migration — schema and storage decisions landed by PG_PLAN.md §3
• Stage 21 — user_name + display_name refactor
• Stage 22 — permanent_block + DeleteUser soft-delete

Primary references:

• ../README.md for stable service scope and business rules
• ../openapi.yaml for the trusted internal REST contract
• ../../ARCHITECTURE.md for system-level transport and ownership rules
• ../../TESTING.md for the cross-service testing matrix