Operations Portal (Deploy / Run / Observe)

Deploy docs

The docs site is a Swarm service named docs and routed by Traefik:

• Service definition: docker-compose.swarm.yml (search for docs:)
• Service code: services/docs

Docs deployment guide:

• docs/DEPLOYMENT.md

Deploy the backend stack

• Main entry: docker-compose.swarm.yml
• “how to deploy + verify”: docs/guides/DEPLOYMENT-GUIDE.md

Monitoring / alerting

• Prometheus config: monitoring/prometheus.yml
• Grafana dashboards: monitoring/grafana/
• Alerts: monitoring/alerts/ and monitoring/GRAFANA_ALERTS_SETUP.md

Runbooks / troubleshooting

• Current production checklist / gaps: docs/PRODUCTION_READY_CHECKLIST.md
• Testing/deployment playbooks: docs/TESTING_AND_DEPLOYMENT_GUIDE.md