Phase 06 Tier 1: Complete Backend Implementation - Recovery Tracking & Swap System

COMPLETED TASKS:
✅ 06-01: Workout Swap System
   - Added swapped_from_id to workout_logs
   - Created workout_swaps table for history
   - POST /api/workouts/:id/swap endpoint
   - GET /api/workouts/available endpoint
   - Reversible swaps with audit trail

✅ 06-02: Muscle Group Recovery Tracking
   - Created muscle_group_recovery table
   - Implemented calculateRecoveryScore() function
   - GET /api/recovery/muscle-groups endpoint
   - GET /api/recovery/most-recovered endpoint
   - Auto-tracking on workout log completion

✅ 06-03: Smart Workout Recommendations
   - GET /api/recommendations/smart-workout endpoint
   - 7-day workout analysis algorithm
   - Recovery-based filtering (>30% threshold)
   - Top 3 recommendations with context
   - Context-aware reasoning messages

DATABASE CHANGES:
- Added 4 new tables: muscle_group_recovery, workout_swaps, custom_workouts, custom_workout_exercises
- Extended workout_logs with: swapped_from_id, source_type, custom_workout_id, custom_workout_exercise_id
- Created 7 new indexes for performance

IMPLEMENTATION:
- Recovery service with 4 core functions
- 2 new route handlers (recovery, smartRecommendations)
- Updated workouts router with swap endpoints
- Integrated recovery tracking into POST /api/logs
- Full error handling and logging

TESTING:
- Test file created: /backend/test/phase-06-tests.js
- Ready for E2E and staging validation

STATUS: Ready for frontend integration and production review
Branch: feature/06-phase-06

scripts/deploy-staging.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# scripts/deploy-staging.sh
+# Gravl Staging Deployment Script
+# Phase 10-07: Task 2 — Deploy All Services to Staging
+#
+# USAGE:
+#   ./scripts/deploy-staging.sh [--context <kubectl-context>] [--dry-run]
+#
+# PREREQUISITES:
+#   - kubectl installed and reachable
+#   - kubeconfig with staging cluster context
+#   - Staging namespace already configured (see setup-staging.sh)
+#   - Docker images available (pushed to registry or local)
+
+set -euo pipefail
+
+CONTEXT="${KUBECTL_CONTEXT:-}"
+DRY_RUN=false
+K8S_DEPLOYMENTS_DIR="$(dirname "$0")/../k8s/deployments"
+NAMESPACE="gravl-staging"
+
+KUBECTL="kubectl"
+[[ -n "$CONTEXT" ]] && KUBECTL="kubectl --context=$CONTEXT"
+[[ "$DRY_RUN" == "true" ]] && KUBECTL="$KUBECTL --dry-run=client -o yaml"
+
+echo "[INFO] Deploying Gravl services to ${NAMESPACE}..."
+
+# Deploy PostgreSQL StatefulSet
+echo "[INFO] Deploying PostgreSQL..."
+sed "s/namespace: gravl-prod/namespace: ${NAMESPACE}/g" \
+  "${K8S_DEPLOYMENTS_DIR}/postgresql.yaml" | \
+  $KUBECTL apply -f -
+
+# Deploy Backend Deployment (1 replica for staging)
+echo "[INFO] Deploying backend..."
+sed "s/namespace: gravl-prod/namespace: ${NAMESPACE}/g; s/replicas: 3/replicas: 1/g" \
+  "${K8S_DEPLOYMENTS_DIR}/gravl-backend.yaml" | \
+  $KUBECTL apply -f -
+
+# Deploy Frontend Deployment (1 replica for staging)
+echo "[INFO] Deploying frontend..."
+sed "s/namespace: gravl-prod/namespace: ${NAMESPACE}/g; s/replicas: 3/replicas: 1/g" \
+  "${K8S_DEPLOYMENTS_DIR}/gravl-frontend.yaml" | \
+  $KUBECTL apply -f -
+
+# Deploy Ingress
+echo "[INFO] Deploying Ingress..."
+grep -A 30 "namespace: gravl-staging" "${K8S_DEPLOYMENTS_DIR}/ingress-nginx.yaml" | \
+  $KUBECTL apply -f -
+
+echo "[OK] Staging deployment initiated"
+echo "[INFO] Wait for pods: kubectl get pods -n ${NAMESPACE}"
+echo "[INFO] View logs: kubectl logs -f -n ${NAMESPACE} -l app=gravl"