feat(#swarm): Add Docker Swarm deployment with AI provider configuration

- Add setup-wizard.sh for interactive configuration
- Add docker-compose.swarm.yml optimized for swarm deployment
- Make CLAUDE_API_KEY optional based on AI_PROVIDER setting
- Support multiple AI providers: Ollama, Claude API, OpenAI
- Add BETTER_AUTH_SECRET to .env.example
- Update deploy-swarm.sh to validate AI provider config
- Add comprehensive documentation (DOCKER-SWARM.md, SWARM-QUICKREF.md)

Changes:
- AI_PROVIDER env var controls which AI backend to use
- Ollama is default (no API key required)
- Claude API and OpenAI require respective API keys
- Deployment script validates based on selected provider
- Removed Authentik services from swarm compose (using external)
- Configured for upstream Traefik integration

README.md

@@ -117,6 +117,46 @@ docker compose down
 
 See [Docker Deployment Guide](docs/1-getting-started/4-docker-deployment/) for complete documentation.
 
+### Docker Swarm Deployment (Production)
+
+**Recommended for production deployments with high availability and auto-scaling.**
+
+Deploy to a Docker Swarm cluster with integrated Traefik reverse proxy:
+
+```bash
+# 1. Initialize swarm (if not already done)
+docker swarm init
+
+# 2. Create Traefik network
+docker network create --driver=overlay traefik-public
+
+# 3. Configure environment for swarm
+cp .env.swarm.example .env
+nano .env  # Configure domains, passwords, API keys
+
+# 4. Deploy stack
+./deploy-swarm.sh mosaic
+
+# 5. Check deployment status
+docker stack services mosaic
+docker stack ps mosaic
+
+# Access services via Traefik
+# Web:  http://mosaic.mosaicstack.dev
+# API:  http://api.mosaicstack.dev
+# Auth: http://auth.mosaicstack.dev
+```
+
+**Key features:**
+
+- Automatic Traefik integration for routing
+- Overlay networking for multi-host deployments
+- Built-in health checks and rolling updates
+- Horizontal scaling for web and API services
+- Zero-downtime deployments
+
+See [Docker Swarm Deployment Guide](DOCKER-SWARM.md) and [Quick Reference](SWARM-QUICKREF.md) for complete documentation.
+
 ## Project Structure
 
 ```