ai-flow-dev 2.7.0 → 2.8.0

package/templates/desktop/docs/docs/operations.template.md

@@ -1,720 +1,720 @@
-# Operations Guide
-
-> Deployment, monitoring, and operational procedures for {{PROJECT_NAME}}
-
----
-
-## 🚀 Deployment
-
-### Platform
-
-**Environment:** {{DEPLOYMENT_PLATFORM}}
-
-**Regions:** {{DEPLOYMENT_REGIONS}}
-
-**Container:** {{#IF_DOCKER}}Yes - Docker{{ELSE}}No{{/IF_DOCKER}}
-
-### Deployment Strategy
-
-**Strategy:** {{DEPLOYMENT_STRATEGY}}
-
-{{#IF BLUE_GREEN}}
-**Blue-Green Deployment:**
-
-- Active environment: {{ACTIVE_ENVIRONMENT}}
-- Standby environment: {{STANDBY_ENVIRONMENT}}
-- Switch mechanism: {{SWITCH_MECHANISM}}
-- Rollback time: < {{ROLLBACK_TIME}} seconds
-  {{/IF}}
-
-{{#IF CANARY}}
-**Canary Deployment:**
-
-- Initial canary percentage: {{CANARY_INITIAL_PERCENTAGE}}%
-- Rollout increments: {{CANARY_INCREMENTS}}
-- Success criteria: {{CANARY_SUCCESS_CRITERIA}}
-- Automatic rollback: {{CANARY_AUTO_ROLLBACK}}
-  {{/IF}}
-
-{{#IF ROLLING}}
-**Rolling Deployment:**
-
-- Max unavailable: {{ROLLING_MAX_UNAVAILABLE}}
-- Max surge: {{ROLLING_MAX_SURGE}}
-- Health check: {{ROLLING_HEALTH_CHECK}}
-  {{/IF}}
-
-### Rollback Plan
-
-**Trigger:** {{ROLLBACK_TRIGGER}}
-
-**Process:**
-{{#EACH ROLLBACK_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-{{/EACH}}
-
-## **Rollback Time:** < {{ROLLBACK_TARGET_TIME}} minutes
-
-## 🌍 Environments
-
-{{#EACH ENVIRONMENT}}
-
-### {{ENV_NAME}}
-
-**Purpose:** {{ENV_PURPOSE}}
-
-**URL:** {{ENV_URL}}
-
-**Database:** {{ENV_DATABASE}}
-
-**Auto-deploy:** {{ENV_AUTO_DEPLOY}}
-
-**Configuration:**
-
-```bash
-{{ENV_CONFIG}}
-```
-
-## {{/EACH}}
-
-## 📦 Build & Deploy
-
-### Build Process
-
-```bash
-{{BUILD_COMMAND}}
-```
-
-**Build Output:** `{{BUILD_OUTPUT_DIR}}`
-
-### Deployment Steps
-
-{{#EACH DEPLOYMENT_STEP}}
-{{STEP_NUMBER}}. **{{STEP_TITLE}}**
-
-```bash
-{{STEP_COMMAND}}
-```
-
-{{STEP_DESCRIPTION}}
-
-{{/EACH}}
-
-{{#IF_DOCKER}}
-
-### Docker
-
-**Dockerfile:** `{{DOCKERFILE_PATH}}`
-
-```dockerfile
-{{DOCKERFILE_EXAMPLE}}
-```
-
-**Build Image:**
-
-```bash
-{{DOCKER_BUILD_COMMAND}}
-```
-
-**Run Container:**
-
-```bash
-{{DOCKER_RUN_COMMAND}}
-```
-
-**Docker Compose:**
-
-```yaml
-{ { DOCKER_COMPOSE_EXAMPLE } }
-```
-
-## {{/IF_DOCKER}}
-
-## 🔄 CI/CD Pipeline
-
-**Platform:** {{CICD_PLATFORM}}
-
-**Configuration:** `{{CICD_CONFIG_FILE}}`
-
-### Pipeline Stages
-
-{{#EACH PIPELINE_STAGE}}
-{{STAGE_NUMBER}}. **{{STAGE_NAME}}**
-
-- {{STAGE_DESCRIPTION}}
-- Duration: ~{{STAGE_DURATION}}
-- Fails if: {{STAGE_FAILURE_CONDITION}}
-
-{{/EACH}}
-
-### Pipeline Configuration
-
-```yaml
-{ { CICD_CONFIG_EXAMPLE } }
-```
-
----
-
-## 📊 Monitoring
-
-### APM (Application Performance Monitoring)
-
-**Tool:** {{APM_TOOL}}
-
-**Metrics Tracked:**
-{{#EACH METRIC}}
-
-- **{{METRIC_NAME}}**: {{METRIC_DESCRIPTION}} (threshold: {{METRIC_THRESHOLD}})
-  {{/EACH}}
-
-**Dashboard:** {{APM_DASHBOARD_URL}}
-
-### Logging
-
-**Tool:** {{LOGGING_TOOL}}
-
-**Log Format:** {{LOG_FORMAT}}
-
-**Log Levels:**
-{{#EACH LOG_LEVEL}}
-
-- **{{LEVEL_NAME}}**: {{LEVEL_USAGE}}
-  {{/EACH}}
-
-**Example Log Entry:**
-
-```json
-{{LOG_ENTRY_EXAMPLE}}
-```
-
-**Viewing Logs:**
-
-```bash
-{{VIEW_LOGS_COMMAND}}
-```
-
-### Metrics
-
-{{#EACH TRACKED_METRIC}}
-
-#### {{METRIC_NAME}}
-
-**Description:** {{METRIC_DESCRIPTION}}
-
-**Threshold:** {{METRIC_THRESHOLD}}
-
-**Alert:** {{METRIC_ALERT_CONDITION}}
-
-## {{/EACH}}
-
-## 🚨 Alerting
-
-### Alert Channels
-
-{{#EACH ALERT_CHANNEL}}
-
-- **{{CHANNEL_NAME}}**: {{CHANNEL_PURPOSE}}
-  {{/EACH}}
-
-### Alert Rules
-
-{{#EACH ALERT_RULE}}
-
-#### {{ALERT_NAME}}
-
-**Condition:** {{ALERT_CONDITION}}
-
-**Severity:** {{ALERT_SEVERITY}}
-
-**Notify:** {{ALERT_RECIPIENTS}}
-
-**Action:** {{ALERT_ACTION}}
-
-## {{/EACH}}
-
-## 🔧 Configuration
-
-### Environment Variables
-
-**Required:**
-{{#EACH REQUIRED_ENV_VAR}}
-
-- `{{VAR_NAME}}` - {{VAR_DESCRIPTION}}
-  {{/EACH}}
-
-**Optional:**
-{{#EACH OPTIONAL_ENV_VAR}}
-
-- `{{VAR_NAME}}` - {{VAR_DESCRIPTION}} (default: {{VAR_DEFAULT}})
-  {{/EACH}}
-
-**Per Environment:**
-
-```bash
-# Development
-{{DEV_ENV_VARS}}
-
-# Staging
-{{STAGING_ENV_VARS}}
-
-# Production
-{{PROD_ENV_VARS}}
-```
-
----
-
-## 💾 Database Operations
-
-### Migrations
-
-```bash
-# Run migrations
-{{MIGRATION_RUN_COMMAND}}
-
-# Rollback
-{{MIGRATION_ROLLBACK_COMMAND}}
-
-# Status
-{{MIGRATION_STATUS_COMMAND}}
-```
-
-### Database Migrations in Production
-
-**Strategy:** {{PRODUCTION_MIGRATION_STRATEGY}}
-
-{{#IF ZERO_DOWNTIME_MIGRATIONS}}
-**Zero-Downtime Migrations:** Enabled
-
-**Approach:**
-{{#EACH ZERO_DOWNTIME_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-{{/EACH}}
-
-**Rollback Plan:**
-{{#EACH ROLLBACK_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-{{/EACH}}
-{{ELSE}}
-**Zero-Downtime Migrations:** Not implemented (requires maintenance window)
-{{/IF}}
-
-**Migration Windows:**
-
-- Preferred time: {{MIGRATION_WINDOW_TIME}}
-- Duration: {{MIGRATION_WINDOW_DURATION}}
-- Notification: {{MIGRATION_NOTIFICATION}}
-
-### Database Connection Pooling
-
-**Pool Configuration:**
-
-**Tool:** {{CONNECTION_POOL_TOOL}}
-
-**Settings:**
-
-- Min connections: {{POOL_MIN_CONNECTIONS}}
-- Max connections: {{POOL_MAX_CONNECTIONS}}
-- Connection timeout: {{POOL_CONNECTION_TIMEOUT}}ms
-- Idle timeout: {{POOL_IDLE_TIMEOUT}}ms
-- Max lifetime: {{POOL_MAX_LIFETIME}}ms
-
-**Configuration:**
-
-```{{LANGUAGE}}
-{{CONNECTION_POOL_CONFIG_EXAMPLE}}
-```
-
-**Monitoring:**
-
-- Active connections: {{POOL_MONITORING_ACTIVE}}
-- Idle connections: {{POOL_MONITORING_IDLE}}
-- Wait time: {{POOL_MONITORING_WAIT}}
-- Connection errors: {{POOL_MONITORING_ERRORS}}
-
-### Backups
-
-**Frequency:** {{BACKUP_FREQUENCY}}
-
-**Retention:** {{BACKUP_RETENTION}}
-
-**Location:** {{BACKUP_LOCATION}}
-
-**Backup Command:**
-
-```bash
-{{BACKUP_COMMAND}}
-```
-
-**Restore Command:**
-
-```bash
-{{RESTORE_COMMAND}}
-```
-
-### Disaster Recovery
-
-**RTO (Recovery Time Objective):** {{RTO}}
-
-**RPO (Recovery Point Objective):** {{RPO}}
-
-**Recovery Steps:**
-{{#EACH RECOVERY_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-{{/EACH}}
-
----
-
-## ⚡ Scaling
-
-### Horizontal Scaling
-
-{{HORIZONTAL_SCALING_DESCRIPTION}}
-
-**Auto-scaling:**
-{{#IF AUTO_SCALING}}
-
-- Enabled: Yes
-- Min instances: {{SCALING_MIN}}
-- Max instances: {{SCALING_MAX}}
-- Target CPU: {{SCALING_TARGET_CPU}}%
-- Target Memory: {{SCALING_TARGET_MEMORY}}%
-  {{ELSE}}
-- Enabled: No - Manual scaling
-  {{/IF}}
-
-### Vertical Scaling
-
-{{VERTICAL_SCALING_DESCRIPTION}}
-
-**Current Resources:**
-
-- CPU: {{CURRENT_CPU}}
-- Memory: {{CURRENT_MEMORY}}
-- Disk: {{CURRENT_DISK}}
-
----
-
-## 🏥 Health Checks
-
-### Endpoints
-
-```
-GET /health          - Basic health check
-GET /health/ready    - Readiness check
-GET /health/live     - Liveness check
-```
-
-### Response Format
-
-```json
-{{HEALTH_CHECK_RESPONSE_EXAMPLE}}
-```
-
-### Health Check Configuration
-
-```{{LANGUAGE}}
-{{HEALTH_CHECK_CODE_EXAMPLE}}
-```
-
----
-
-## 🔐 Security Operations
-
-### SSL/TLS
-
-**Certificate:** {{SSL_CERTIFICATE_PROVIDER}}
-
-**Renewal:** {{SSL_RENEWAL_PROCESS}}
-
-**Expiry Monitoring:** {{SSL_MONITORING}}
-
-### Secrets Management
-
-**Tool:** {{SECRETS_MANAGER}}
-
-**Rotation:** {{SECRETS_ROTATION_POLICY}}
-
-## **Access:** {{SECRETS_ACCESS_POLICY}}
-
-## 📝 Runbooks
-
-{{#EACH RUNBOOK}}
-
-### {{RUNBOOK_TITLE}}
-
-**Trigger:** {{RUNBOOK_TRIGGER}}
-
-**Steps:**
-{{#EACH RUNBOOK_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-
-```bash
-{{STEP_COMMAND}}
-```
-
-{{/EACH}}
-
-## {{/EACH}}
-
-## 🐛 Troubleshooting
-
-{{#EACH TROUBLESHOOTING_GUIDE}}
-
-### {{ISSUE_TITLE}}
-
-**Symptoms:**
-{{#EACH SYMPTOM}}
-
-- {{SYMPTOM_DESCRIPTION}}
-  {{/EACH}}
-
-**Diagnosis:**
-
-```bash
-{{DIAGNOSIS_COMMAND}}
-```
-
-**Resolution:**
-{{#EACH RESOLUTION_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-{{/EACH}}
-
-## {{/EACH}}
-
-## 📈 Performance Optimization
-
-{{#EACH OPTIMIZATION}}
-
-### {{OPTIMIZATION_NAME}}
-
-**Current:** {{CURRENT_STATE}}
-
-**Target:** {{TARGET_STATE}}
-
-**Implementation:** {{OPTIMIZATION_IMPLEMENTATION}}
-
-## {{/EACH}}
-
-## 🔄 Rollback Procedures
-
-### When to Rollback
-
-{{#EACH ROLLBACK_TRIGGER}}
-
-- {{TRIGGER_DESCRIPTION}}
-  {{/EACH}}
-
-### Rollback Steps
-
-```bash
-{{ROLLBACK_COMMAND}}
-```
-
-**Manual Rollback:**
-{{#EACH ROLLBACK_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-{{/EACH}}
-
----
-
-## 🎯 Deployment Strategies
-
-### Blue-Green Deployment
-
-{{#IF BLUE_GREEN_DEPLOYMENT}}
-**Enabled:** Yes
-
-**Strategy:**
-{{#EACH BLUE_GREEN_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
-{{/EACH}}
-
-**Rollback:** {{BLUE_GREEN_ROLLBACK}}
-
-**Benefits:**
-
-- Zero-downtime deployments
-- Instant rollback capability
-- Easy A/B testing
-
-{{ELSE}}
-**Enabled:** No - Using standard deployment
-{{/IF}}
-
-### Canary Deployment
-
-{{#IF CANARY_DEPLOYMENT}}
-**Enabled:** Yes
-
-**Strategy:**
-
-- Initial traffic: {{CANARY_INITIAL_TRAFFIC}}%
-- Gradual increase: {{CANARY_GRADUAL_INCREASE}}% per {{CANARY_INCREASE_INTERVAL}}
-- Success criteria: {{CANARY_SUCCESS_CRITERIA}}
-- Rollback trigger: {{CANARY_ROLLBACK_TRIGGER}}
-
-{{ELSE}}
-**Enabled:** No
-{{/IF}}
-
----
-
-## 🛡️ Resilience Patterns
-
-### Graceful Shutdown
-
-**Enabled:** {{#IF GRACEFUL_SHUTDOWN}}Yes{{ELSE}}No{{/IF}}
-
-{{#IF GRACEFUL_SHUTDOWN}}
-**Shutdown Sequence:**
-{{#EACH SHUTDOWN_STEP}}
-{{STEP_NUMBER}}. {{STEP_DESCRIPTION}} (timeout: {{STEP_TIMEOUT}}s)
-{{/EACH}}
-
-**Implementation:**
-
-```{{LANGUAGE}}
-{{GRACEFUL_SHUTDOWN_EXAMPLE}}
-```
-
-**Configuration:**
-
-- Shutdown timeout: {{SHUTDOWN_TIMEOUT}}s
-- Health check grace period: {{HEALTH_CHECK_GRACE_PERIOD}}s
-- Connection drain timeout: {{CONNECTION_DRAIN_TIMEOUT}}s
-  {{/IF}}
-
-### Circuit Breakers
-
-{{#IF CIRCUIT_BREAKERS}}
-**Enabled:** Yes
-
-**Tool:** {{CIRCUIT_BREAKER_TOOL}}
-
-**Configuration:**
-{{#EACH CIRCUIT_BREAKER}}
-
-#### {{SERVICE_NAME}}
-
-- Failure threshold: {{FAILURE_THRESHOLD}}%
-- Success threshold: {{SUCCESS_THRESHOLD}}%
-- Timeout: {{TIMEOUT}}ms
-- Half-open retries: {{HALF_OPEN_RETRIES}}
-- Reset timeout: {{RESET_TIMEOUT}}s
-
-**Fallback Strategy:** {{FALLBACK_STRATEGY}}
-
-**Implementation:**
-
-```{{LANGUAGE}}
-{{CIRCUIT_BREAKER_EXAMPLE}}
-```
-
-{{/EACH}}
-
-{{ELSE}}
-**Enabled:** No - Direct service calls without circuit breaking
-{{/IF}}
-
-### Retry Policies
-
-{{#IF RETRY_POLICIES}}
-**Retry Strategy:** {{RETRY_STRATEGY}}
-
-{{#EACH RETRY_POLICY}}
-
-#### {{SERVICE_NAME}}
-
-- Max attempts: {{MAX_ATTEMPTS}}
-- Backoff strategy: {{BACKOFF_STRATEGY}}
-- Initial delay: {{INITIAL_DELAY}}ms
-- Max delay: {{MAX_DELAY}}ms
-- Retryable errors: {{RETRYABLE_ERRORS}}
-
-{{/EACH}}
-
-{{ELSE}}
-
-- Retry policies to be configured per service.
-  {{/IF}}
-
-### Timeout & Retry Matrix
-
-| Service/Dependency | Timeout | Retries | Backoff | Notes |
-| ------------------ | ------- | ------- | ------- | ----- |
-
-{{#EACH TIMEOUT_POLICY}}
-| {{SERVICE_NAME}} | {{TIMEOUT}}ms | {{RETRIES}} | {{BACKOFF}} | {{NOTES}} |
-{{/EACH}}
-
-**Global Defaults:**
-
-- Default HTTP timeout: {{DEFAULT_HTTP_TIMEOUT}}ms
-- Default retries: {{DEFAULT_RETRIES}}
-- Default backoff: {{DEFAULT_BACKOFF}}
-
-**Non-Retryable Errors:**
-{{#EACH NON_RETRYABLE_ERROR}}
-
-- `{{ERROR_CODE}}`: {{REASON}}
-  {{/EACH}}
-
----
-
-## 📋 Request/Response Logging
-
-### Log Strategy by Environment
-
-| Environment | Level | Body Logging | Performance Logging |
-| ----------- | ----- | ------------ | ------------------- |
-
-{{#EACH LOGGING_STRATEGY}}
-| {{ENVIRONMENT}} | {{LEVEL}} | {{BODY_LOGGING}} | {{PERFORMANCE_LOGGING}} |
-{{/EACH}}
-
-### Request Logging
-
-**Fields Logged:**
-{{#EACH REQUEST_LOG_FIELD}}
-
-- {{#IF ENABLED}}✅{{ELSE}}❌{{/IF}} `{{FIELD_NAME}}` - {{DESCRIPTION}}
-  {{/EACH}}
-
-### Response Logging
-
-**Fields Logged:**
-{{#EACH RESPONSE_LOG_FIELD}}
-
-- {{#IF ENABLED}}✅{{ELSE}}❌{{/IF}} `{{FIELD_NAME}}` - {{DESCRIPTION}}
-  {{/EACH}}
-
-### Sensitive Data Masking
-
-| Field Pattern | Masking Strategy |
-| ------------- | ---------------- |
-
-{{#EACH MASKING_RULE}}
-| `{{PATTERN}}` | {{STRATEGY}} |
-{{/EACH}}
-
-**Implementation Example:**
-
-```{{LANGUAGE}}
-{{MASKING_EXAMPLE}}
-```
-
----
-
-## 📅 Maintenance Windows
-
-**Frequency:** {{MAINTENANCE_FREQUENCY}}
-
-**Duration:** {{MAINTENANCE_DURATION}}
-
-## **Notification:** {{MAINTENANCE_NOTIFICATION}}
-
-**Document Version:** 1.0
-
-**Last Updated:** {{GENERATION_DATE}}
-
-**Generated by:** AI Flow v1.0.0
+# Operations Guide
+
+> Deployment, monitoring, and operational procedures for {{PROJECT_NAME}}
+
+---
+
+## 🚀 Deployment
+
+### Platform
+
+**Environment:** {{DEPLOYMENT_PLATFORM}}
+
+**Regions:** {{DEPLOYMENT_REGIONS}}
+
+**Container:** {{#IF_DOCKER}}Yes - Docker{{ELSE}}No{{/IF_DOCKER}}
+
+### Deployment Strategy
+
+**Strategy:** {{DEPLOYMENT_STRATEGY}}
+
+{{#IF BLUE_GREEN}}
+**Blue-Green Deployment:**
+
+- Active environment: {{ACTIVE_ENVIRONMENT}}
+- Standby environment: {{STANDBY_ENVIRONMENT}}
+- Switch mechanism: {{SWITCH_MECHANISM}}
+- Rollback time: < {{ROLLBACK_TIME}} seconds
+  {{/IF}}
+
+{{#IF CANARY}}
+**Canary Deployment:**
+
+- Initial canary percentage: {{CANARY_INITIAL_PERCENTAGE}}%
+- Rollout increments: {{CANARY_INCREMENTS}}
+- Success criteria: {{CANARY_SUCCESS_CRITERIA}}
+- Automatic rollback: {{CANARY_AUTO_ROLLBACK}}
+  {{/IF}}
+
+{{#IF ROLLING}}
+**Rolling Deployment:**
+
+- Max unavailable: {{ROLLING_MAX_UNAVAILABLE}}
+- Max surge: {{ROLLING_MAX_SURGE}}
+- Health check: {{ROLLING_HEALTH_CHECK}}
+  {{/IF}}
+
+### Rollback Plan
+
+**Trigger:** {{ROLLBACK_TRIGGER}}
+
+**Process:**
+{{#EACH ROLLBACK_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+{{/EACH}}
+
+## **Rollback Time:** < {{ROLLBACK_TARGET_TIME}} minutes
+
+## 🌍 Environments
+
+{{#EACH ENVIRONMENT}}
+
+### {{ENV_NAME}}
+
+**Purpose:** {{ENV_PURPOSE}}
+
+**URL:** {{ENV_URL}}
+
+**Database:** {{ENV_DATABASE}}
+
+**Auto-deploy:** {{ENV_AUTO_DEPLOY}}
+
+**Configuration:**
+
+```bash
+{{ENV_CONFIG}}
+```
+
+## {{/EACH}}
+
+## 📦 Build & Deploy
+
+### Build Process
+
+```bash
+{{BUILD_COMMAND}}
+```
+
+**Build Output:** `{{BUILD_OUTPUT_DIR}}`
+
+### Deployment Steps
+
+{{#EACH DEPLOYMENT_STEP}}
+{{STEP_NUMBER}}. **{{STEP_TITLE}}**
+
+```bash
+{{STEP_COMMAND}}
+```
+
+{{STEP_DESCRIPTION}}
+
+{{/EACH}}
+
+{{#IF_DOCKER}}
+
+### Docker
+
+**Dockerfile:** `{{DOCKERFILE_PATH}}`
+
+```dockerfile
+{{DOCKERFILE_EXAMPLE}}
+```
+
+**Build Image:**
+
+```bash
+{{DOCKER_BUILD_COMMAND}}
+```
+
+**Run Container:**
+
+```bash
+{{DOCKER_RUN_COMMAND}}
+```
+
+**Docker Compose:**
+
+```yaml
+{ { DOCKER_COMPOSE_EXAMPLE } }
+```
+
+## {{/IF_DOCKER}}
+
+## 🔄 CI/CD Pipeline
+
+**Platform:** {{CICD_PLATFORM}}
+
+**Configuration:** `{{CICD_CONFIG_FILE}}`
+
+### Pipeline Stages
+
+{{#EACH PIPELINE_STAGE}}
+{{STAGE_NUMBER}}. **{{STAGE_NAME}}**
+
+- {{STAGE_DESCRIPTION}}
+- Duration: ~{{STAGE_DURATION}}
+- Fails if: {{STAGE_FAILURE_CONDITION}}
+
+{{/EACH}}
+
+### Pipeline Configuration
+
+```yaml
+{ { CICD_CONFIG_EXAMPLE } }
+```
+
+---
+
+## 📊 Monitoring
+
+### APM (Application Performance Monitoring)
+
+**Tool:** {{APM_TOOL}}
+
+**Metrics Tracked:**
+{{#EACH METRIC}}
+
+- **{{METRIC_NAME}}**: {{METRIC_DESCRIPTION}} (threshold: {{METRIC_THRESHOLD}})
+  {{/EACH}}
+
+**Dashboard:** {{APM_DASHBOARD_URL}}
+
+### Logging
+
+**Tool:** {{LOGGING_TOOL}}
+
+**Log Format:** {{LOG_FORMAT}}
+
+**Log Levels:**
+{{#EACH LOG_LEVEL}}
+
+- **{{LEVEL_NAME}}**: {{LEVEL_USAGE}}
+  {{/EACH}}
+
+**Example Log Entry:**
+
+```json
+{{LOG_ENTRY_EXAMPLE}}
+```
+
+**Viewing Logs:**
+
+```bash
+{{VIEW_LOGS_COMMAND}}
+```
+
+### Metrics
+
+{{#EACH TRACKED_METRIC}}
+
+#### {{METRIC_NAME}}
+
+**Description:** {{METRIC_DESCRIPTION}}
+
+**Threshold:** {{METRIC_THRESHOLD}}
+
+**Alert:** {{METRIC_ALERT_CONDITION}}
+
+## {{/EACH}}
+
+## 🚨 Alerting
+
+### Alert Channels
+
+{{#EACH ALERT_CHANNEL}}
+
+- **{{CHANNEL_NAME}}**: {{CHANNEL_PURPOSE}}
+  {{/EACH}}
+
+### Alert Rules
+
+{{#EACH ALERT_RULE}}
+
+#### {{ALERT_NAME}}
+
+**Condition:** {{ALERT_CONDITION}}
+
+**Severity:** {{ALERT_SEVERITY}}
+
+**Notify:** {{ALERT_RECIPIENTS}}
+
+**Action:** {{ALERT_ACTION}}
+
+## {{/EACH}}
+
+## 🔧 Configuration
+
+### Environment Variables
+
+**Required:**
+{{#EACH REQUIRED_ENV_VAR}}
+
+- `{{VAR_NAME}}` - {{VAR_DESCRIPTION}}
+  {{/EACH}}
+
+**Optional:**
+{{#EACH OPTIONAL_ENV_VAR}}
+
+- `{{VAR_NAME}}` - {{VAR_DESCRIPTION}} (default: {{VAR_DEFAULT}})
+  {{/EACH}}
+
+**Per Environment:**
+
+```bash
+# Development
+{{DEV_ENV_VARS}}
+
+# Staging
+{{STAGING_ENV_VARS}}
+
+# Production
+{{PROD_ENV_VARS}}
+```
+
+---
+
+## 💾 Database Operations
+
+### Migrations
+
+```bash
+# Run migrations
+{{MIGRATION_RUN_COMMAND}}
+
+# Rollback
+{{MIGRATION_ROLLBACK_COMMAND}}
+
+# Status
+{{MIGRATION_STATUS_COMMAND}}
+```
+
+### Database Migrations in Production
+
+**Strategy:** {{PRODUCTION_MIGRATION_STRATEGY}}
+
+{{#IF ZERO_DOWNTIME_MIGRATIONS}}
+**Zero-Downtime Migrations:** Enabled
+
+**Approach:**
+{{#EACH ZERO_DOWNTIME_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+{{/EACH}}
+
+**Rollback Plan:**
+{{#EACH ROLLBACK_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+{{/EACH}}
+{{ELSE}}
+**Zero-Downtime Migrations:** Not implemented (requires maintenance window)
+{{/IF}}
+
+**Migration Windows:**
+
+- Preferred time: {{MIGRATION_WINDOW_TIME}}
+- Duration: {{MIGRATION_WINDOW_DURATION}}
+- Notification: {{MIGRATION_NOTIFICATION}}
+
+### Database Connection Pooling
+
+**Pool Configuration:**
+
+**Tool:** {{CONNECTION_POOL_TOOL}}
+
+**Settings:**
+
+- Min connections: {{POOL_MIN_CONNECTIONS}}
+- Max connections: {{POOL_MAX_CONNECTIONS}}
+- Connection timeout: {{POOL_CONNECTION_TIMEOUT}}ms
+- Idle timeout: {{POOL_IDLE_TIMEOUT}}ms
+- Max lifetime: {{POOL_MAX_LIFETIME}}ms
+
+**Configuration:**
+
+```{{LANGUAGE}}
+{{CONNECTION_POOL_CONFIG_EXAMPLE}}
+```
+
+**Monitoring:**
+
+- Active connections: {{POOL_MONITORING_ACTIVE}}
+- Idle connections: {{POOL_MONITORING_IDLE}}
+- Wait time: {{POOL_MONITORING_WAIT}}
+- Connection errors: {{POOL_MONITORING_ERRORS}}
+
+### Backups
+
+**Frequency:** {{BACKUP_FREQUENCY}}
+
+**Retention:** {{BACKUP_RETENTION}}
+
+**Location:** {{BACKUP_LOCATION}}
+
+**Backup Command:**
+
+```bash
+{{BACKUP_COMMAND}}
+```
+
+**Restore Command:**
+
+```bash
+{{RESTORE_COMMAND}}
+```
+
+### Disaster Recovery
+
+**RTO (Recovery Time Objective):** {{RTO}}
+
+**RPO (Recovery Point Objective):** {{RPO}}
+
+**Recovery Steps:**
+{{#EACH RECOVERY_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+{{/EACH}}
+
+---
+
+## ⚡ Scaling
+
+### Horizontal Scaling
+
+{{HORIZONTAL_SCALING_DESCRIPTION}}
+
+**Auto-scaling:**
+{{#IF AUTO_SCALING}}
+
+- Enabled: Yes
+- Min instances: {{SCALING_MIN}}
+- Max instances: {{SCALING_MAX}}
+- Target CPU: {{SCALING_TARGET_CPU}}%
+- Target Memory: {{SCALING_TARGET_MEMORY}}%
+  {{ELSE}}
+- Enabled: No - Manual scaling
+  {{/IF}}
+
+### Vertical Scaling
+
+{{VERTICAL_SCALING_DESCRIPTION}}
+
+**Current Resources:**
+
+- CPU: {{CURRENT_CPU}}
+- Memory: {{CURRENT_MEMORY}}
+- Disk: {{CURRENT_DISK}}
+
+---
+
+## 🏥 Health Checks
+
+### Endpoints
+
+```
+GET /health          - Basic health check
+GET /health/ready    - Readiness check
+GET /health/live     - Liveness check
+```
+
+### Response Format
+
+```json
+{{HEALTH_CHECK_RESPONSE_EXAMPLE}}
+```
+
+### Health Check Configuration
+
+```{{LANGUAGE}}
+{{HEALTH_CHECK_CODE_EXAMPLE}}
+```
+
+---
+
+## 🔐 Security Operations
+
+### SSL/TLS
+
+**Certificate:** {{SSL_CERTIFICATE_PROVIDER}}
+
+**Renewal:** {{SSL_RENEWAL_PROCESS}}
+
+**Expiry Monitoring:** {{SSL_MONITORING}}
+
+### Secrets Management
+
+**Tool:** {{SECRETS_MANAGER}}
+
+**Rotation:** {{SECRETS_ROTATION_POLICY}}
+
+## **Access:** {{SECRETS_ACCESS_POLICY}}
+
+## 📝 Runbooks
+
+{{#EACH RUNBOOK}}
+
+### {{RUNBOOK_TITLE}}
+
+**Trigger:** {{RUNBOOK_TRIGGER}}
+
+**Steps:**
+{{#EACH RUNBOOK_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+
+```bash
+{{STEP_COMMAND}}
+```
+
+{{/EACH}}
+
+## {{/EACH}}
+
+## 🐛 Troubleshooting
+
+{{#EACH TROUBLESHOOTING_GUIDE}}
+
+### {{ISSUE_TITLE}}
+
+**Symptoms:**
+{{#EACH SYMPTOM}}
+
+- {{SYMPTOM_DESCRIPTION}}
+  {{/EACH}}
+
+**Diagnosis:**
+
+```bash
+{{DIAGNOSIS_COMMAND}}
+```
+
+**Resolution:**
+{{#EACH RESOLUTION_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+{{/EACH}}
+
+## {{/EACH}}
+
+## 📈 Performance Optimization
+
+{{#EACH OPTIMIZATION}}
+
+### {{OPTIMIZATION_NAME}}
+
+**Current:** {{CURRENT_STATE}}
+
+**Target:** {{TARGET_STATE}}
+
+**Implementation:** {{OPTIMIZATION_IMPLEMENTATION}}
+
+## {{/EACH}}
+
+## 🔄 Rollback Procedures
+
+### When to Rollback
+
+{{#EACH ROLLBACK_TRIGGER}}
+
+- {{TRIGGER_DESCRIPTION}}
+  {{/EACH}}
+
+### Rollback Steps
+
+```bash
+{{ROLLBACK_COMMAND}}
+```
+
+**Manual Rollback:**
+{{#EACH ROLLBACK_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+{{/EACH}}
+
+---
+
+## 🎯 Deployment Strategies
+
+### Blue-Green Deployment
+
+{{#IF BLUE_GREEN_DEPLOYMENT}}
+**Enabled:** Yes
+
+**Strategy:**
+{{#EACH BLUE_GREEN_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
+{{/EACH}}
+
+**Rollback:** {{BLUE_GREEN_ROLLBACK}}
+
+**Benefits:**
+
+- Zero-downtime deployments
+- Instant rollback capability
+- Easy A/B testing
+
+{{ELSE}}
+**Enabled:** No - Using standard deployment
+{{/IF}}
+
+### Canary Deployment
+
+{{#IF CANARY_DEPLOYMENT}}
+**Enabled:** Yes
+
+**Strategy:**
+
+- Initial traffic: {{CANARY_INITIAL_TRAFFIC}}%
+- Gradual increase: {{CANARY_GRADUAL_INCREASE}}% per {{CANARY_INCREASE_INTERVAL}}
+- Success criteria: {{CANARY_SUCCESS_CRITERIA}}
+- Rollback trigger: {{CANARY_ROLLBACK_TRIGGER}}
+
+{{ELSE}}
+**Enabled:** No
+{{/IF}}
+
+---
+
+## 🛡️ Resilience Patterns
+
+### Graceful Shutdown
+
+**Enabled:** {{#IF GRACEFUL_SHUTDOWN}}Yes{{ELSE}}No{{/IF}}
+
+{{#IF GRACEFUL_SHUTDOWN}}
+**Shutdown Sequence:**
+{{#EACH SHUTDOWN_STEP}}
+{{STEP_NUMBER}}. {{STEP_DESCRIPTION}} (timeout: {{STEP_TIMEOUT}}s)
+{{/EACH}}
+
+**Implementation:**
+
+```{{LANGUAGE}}
+{{GRACEFUL_SHUTDOWN_EXAMPLE}}
+```
+
+**Configuration:**
+
+- Shutdown timeout: {{SHUTDOWN_TIMEOUT}}s
+- Health check grace period: {{HEALTH_CHECK_GRACE_PERIOD}}s
+- Connection drain timeout: {{CONNECTION_DRAIN_TIMEOUT}}s
+  {{/IF}}
+
+### Circuit Breakers
+
+{{#IF CIRCUIT_BREAKERS}}
+**Enabled:** Yes
+
+**Tool:** {{CIRCUIT_BREAKER_TOOL}}
+
+**Configuration:**
+{{#EACH CIRCUIT_BREAKER}}
+
+#### {{SERVICE_NAME}}
+
+- Failure threshold: {{FAILURE_THRESHOLD}}%
+- Success threshold: {{SUCCESS_THRESHOLD}}%
+- Timeout: {{TIMEOUT}}ms
+- Half-open retries: {{HALF_OPEN_RETRIES}}
+- Reset timeout: {{RESET_TIMEOUT}}s
+
+**Fallback Strategy:** {{FALLBACK_STRATEGY}}
+
+**Implementation:**
+
+```{{LANGUAGE}}
+{{CIRCUIT_BREAKER_EXAMPLE}}
+```
+
+{{/EACH}}
+
+{{ELSE}}
+**Enabled:** No - Direct service calls without circuit breaking
+{{/IF}}
+
+### Retry Policies
+
+{{#IF RETRY_POLICIES}}
+**Retry Strategy:** {{RETRY_STRATEGY}}
+
+{{#EACH RETRY_POLICY}}
+
+#### {{SERVICE_NAME}}
+
+- Max attempts: {{MAX_ATTEMPTS}}
+- Backoff strategy: {{BACKOFF_STRATEGY}}
+- Initial delay: {{INITIAL_DELAY}}ms
+- Max delay: {{MAX_DELAY}}ms
+- Retryable errors: {{RETRYABLE_ERRORS}}
+
+{{/EACH}}
+
+{{ELSE}}
+
+- Retry policies to be configured per service.
+  {{/IF}}
+
+### Timeout & Retry Matrix
+
+| Service/Dependency | Timeout | Retries | Backoff | Notes |
+| ------------------ | ------- | ------- | ------- | ----- |
+
+{{#EACH TIMEOUT_POLICY}}
+| {{SERVICE_NAME}} | {{TIMEOUT}}ms | {{RETRIES}} | {{BACKOFF}} | {{NOTES}} |
+{{/EACH}}
+
+**Global Defaults:**
+
+- Default HTTP timeout: {{DEFAULT_HTTP_TIMEOUT}}ms
+- Default retries: {{DEFAULT_RETRIES}}
+- Default backoff: {{DEFAULT_BACKOFF}}
+
+**Non-Retryable Errors:**
+{{#EACH NON_RETRYABLE_ERROR}}
+
+- `{{ERROR_CODE}}`: {{REASON}}
+  {{/EACH}}
+
+---
+
+## 📋 Request/Response Logging
+
+### Log Strategy by Environment
+
+| Environment | Level | Body Logging | Performance Logging |
+| ----------- | ----- | ------------ | ------------------- |
+
+{{#EACH LOGGING_STRATEGY}}
+| {{ENVIRONMENT}} | {{LEVEL}} | {{BODY_LOGGING}} | {{PERFORMANCE_LOGGING}} |
+{{/EACH}}
+
+### Request Logging
+
+**Fields Logged:**
+{{#EACH REQUEST_LOG_FIELD}}
+
+- {{#IF ENABLED}}✅{{ELSE}}❌{{/IF}} `{{FIELD_NAME}}` - {{DESCRIPTION}}
+  {{/EACH}}
+
+### Response Logging
+
+**Fields Logged:**
+{{#EACH RESPONSE_LOG_FIELD}}
+
+- {{#IF ENABLED}}✅{{ELSE}}❌{{/IF}} `{{FIELD_NAME}}` - {{DESCRIPTION}}
+  {{/EACH}}
+
+### Sensitive Data Masking
+
+| Field Pattern | Masking Strategy |
+| ------------- | ---------------- |
+
+{{#EACH MASKING_RULE}}
+| `{{PATTERN}}` | {{STRATEGY}} |
+{{/EACH}}
+
+**Implementation Example:**
+
+```{{LANGUAGE}}
+{{MASKING_EXAMPLE}}
+```
+
+---
+
+## 📅 Maintenance Windows
+
+**Frequency:** {{MAINTENANCE_FREQUENCY}}
+
+**Duration:** {{MAINTENANCE_DURATION}}
+
+## **Notification:** {{MAINTENANCE_NOTIFICATION}}
+
+**Document Version:** 1.0
+
+**Last Updated:** {{GENERATION_DATE}}
+
+**Generated by:** AI Flow v1.0.0