galaxy-game/mail/docs/README.md

Mail 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
• Configuration and contract examples
• Operator runbook
• PostgreSQL migration decisions (Stage 4 of PG_PLAN.md)

Primary references:

• ../README.md for stable service scope, contracts, data model, Redis layout, and retry policy
• ../api/internal-openapi.yaml for the trusted internal REST contract
• ../api/delivery-commands-asyncapi.yaml for the trusted async generic command contract
• ../../ARCHITECTURE.md for system-level service boundaries and transport rules
• ../../TESTING.md for the cross-service testing matrix