How polyphony-chat/symfonia works
Main System Components
a) API Layer (HTTP API Server)
• Authentication services (/src/api/routes/auth)
• User management (/src/api/routes/users)
• Guild/Server management (/src/api/routes/guilds)
• Channel management (/src/api/routes/channels)
• Policy management (/src/api/routes/policies)
b) WebSocket Gateway
• Connection handling (/src/gateway/establish_connection.rs)
• Event dispatching (/src/gateway/types/dispatchevent.rs)
• Heartbeat management (/src/gateway/heartbeat.rs)
c) CDN Server
• File storage and delivery system (/src/cdn)
d) Database Layer
• PostgreSQL database
• Entity models (/src/database/entities)
• Migration management (/migrations)
Component Relationships
Client Layer (External)
• ↕
┌──────────────────────────────┐
• Load Balancer/Proxy │
• ┘
• ↕
┌──────────────────────────────┐
• API Server │ Gateway │
• (HTTP/REST) │ (WebSocket)│
• ┘
• ↕ ↕
┌──────────────────────────────┐
• Database Layer (PostgreSQL)│
• ┘
• ↕
┌──────────────────────────────┐
• CDN Server │
• ┘
Detailed Component Breakdown
API Server:
• Authentication middleware
• Route handlers
• Permission guards
• Current user context
Gateway:
• Connection establishment
• Event handling
• Heartbeat mechanism
• Session management
Database:
• Entity relationships
• Migration flow
• Data models
• Foreign key constraints
Technical Stack Indicators
Following technologies:
• Rust (primary language)
• PostgreSQL (database)
• SQLx (database toolkit)
• WebSocket protocol
• HTTP/REST APIs