[TODO Import][Server][Backlog] Infrastructure, hardening, and docs debt

[ferneediaz]

Imported from server/TODO.md.

Kanban

• Column: Backlog
• Area: Server

📦 Infrastructure TODOs

Docker Compose Setup (Optional)

• Add PostgreSQL service
• Add Redis for queue management
• Production-ready docker-compose.yml

Environment & Config

• Document all environment variables
• Add .env.example file (including STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, VAPID keys)
• Validate environment on startup
• Add health check endpoints

Deployment

• Production build optimization
• Database migrations strategy
• CI/CD pipeline setup
• Monitoring & logging setup

---

🐛 Known Issues & Tech Debt

Current Issues:

• JWT validation could be more robust (add token expiration checks)
• Error messages could be more user-friendly
• No rate limiting on APIs
• No request logging/monitoring

Tech Debt:

• jest.config.js shows deprecation warnings (ts-jest globals config)
• Some test output is verbose (could silence non-critical logs)

---

📝 Documentation TODOs

• Implementation status document (DONE - IMPLEMENTATION_STATUS.md)
• TODO list (DONE - this file)
• API documentation improvements
  • Add usage examples
  • Add authentication flow guide
  • Add error code reference
• Architecture documentation
  • System design diagrams
  • Database ER diagram
  • WebSocket event flow (including skills, chat, BR rounds)
• Developer onboarding guide
  • Local setup instructions
  • Testing guide
  • Contributing guidelines (for problem contributions)