Deployment Precheck

[Wiesenwischer]

Goal

Pre-flight checks before deployment: verify image availability, port conflicts, variable validation, network/volume status, and existing deployments — before containers are removed (Point of No Return).

Applies to both single-stack and product deployments.

Specification

See PLAN-deployment-precheck.md

Key Decisions

• UI Trigger: Hybrid — auto-run on entering deploy flow + manual Re-Check button
• Hooks API: Always automatic — every hook deploy runs precheck, errors abort deployment
• 6 Rules: Image Availability, Port Conflicts, Variable Validation, Network Availability, Volume Status, Existing Deployment Detection
• Product Precheck: Dedicated backend endpoint, orchestrates per-stack prechecks in parallel

Tasks — Stack Precheck (done)

• Feature 1: Domain Model (PrecheckResult, PrecheckItem, PrecheckSeverity)
• Feature 2: Rule Interface + 6 Rule Implementations
• Feature 3: MediatR Query Handler (RunDeploymentPrecheckQuery)
• Feature 4: API Endpoint (POST /api/environments/{envId}/stacks/{stackId}/precheck)
• Feature 5: Hooks API Integration (automatic precheck + dryRun parameter)
• Feature 6: UI — PrecheckPanel + DeployStack flow integration
• Feature 7: Tests (Unit + Integration + E2E)

Tasks — Product Precheck

• Feature 8: Product Precheck Backend (ProductPrecheckEndpoint + RunProductPrecheckQuery)
• Feature 9: Product Precheck UI (useProductPrecheck + DeployProduct.tsx integration)
• Feature 10: Product Precheck Tests (Unit + Integration + E2E)
• Documentation & Website