feat: reword phase to epic, update mkdocs

docs/content/stories/epic6/README.md

@@ -0,0 +1,55 @@
+# Epic 6: Observability & Production Readiness
+
+## Overview
+Enhance observability with full OpenTelemetry integration, add comprehensive error reporting (Sentry), create Grafana dashboards, improve logging with request correlation, add rate limiting and security hardening, and optimize performance.
+
+## Stories
+
+### 6.1 Enhanced Observability
+- [Story: 6.1 - Enhanced Observability](./6.1-enhanced-observability.md)
+- **Goal:** Enhance observability with full OpenTelemetry integration, comprehensive Prometheus metrics, and improved logging.
+- **Deliverables:** Complete OpenTelemetry integration, expanded metrics, enhanced logging
+
+### 6.2 Error Reporting (Sentry)
+- [Story: 6.2 - Error Reporting](./6.2-error-reporting.md)
+- **Goal:** Add comprehensive error reporting with Sentry integration.
+- **Deliverables:** Sentry integration, error context enhancement
+
+### 6.3 Grafana Dashboards
+- [Story: 6.3 - Grafana Dashboards](./6.3-grafana-dashboards.md)
+- **Goal:** Create comprehensive Grafana dashboards for monitoring.
+- **Deliverables:** Grafana dashboard JSON files, documentation
+
+### 6.4 Rate Limiting
+- [Story: 6.4 - Rate Limiting](./6.4-rate-limiting.md)
+- **Goal:** Implement rate limiting to prevent API abuse.
+- **Deliverables:** Rate limiting middleware, configuration
+
+### 6.5 Security Hardening
+- [Story: 6.5 - Security Hardening](./6.5-security-hardening.md)
+- **Goal:** Add comprehensive security hardening.
+- **Deliverables:** Security headers, input validation, request limits
+
+### 6.6 Performance Optimization
+- [Story: 6.6 - Performance Optimization](./6.6-performance-optimization.md)
+- **Goal:** Optimize platform performance.
+- **Deliverables:** Connection pooling, query optimization, compression, caching
+
+## Deliverables Checklist
+- [ ] Full OpenTelemetry integration
+- [ ] Sentry error reporting
+- [ ] Enhanced logging with correlation
+- [ ] Comprehensive Prometheus metrics
+- [ ] Grafana dashboards
+- [ ] Rate limiting
+- [ ] Security hardening
+- [ ] Performance optimizations
+
+## Acceptance Criteria
+- Traces are exported and visible in Jaeger
+- Errors are reported to Sentry with context
+- Logs include request IDs and trace IDs
+- Metrics are exposed and scraped by Prometheus
+- Rate limiting prevents abuse
+- Security headers are present
+- Performance meets SLA (< 100ms p95 for auth endpoints)