Skip to content

Release-History.md

Latest commit

 

History

History
342 lines (339 loc) · 22.2 KB

Release-History.md

File metadata and controls

342 lines (339 loc) · 22.2 KB

Release History

Complete release history for ReadyStackGo. For current planning, see the GitHub Project Board.

Released

  • v0.1 – Container View + Start/Stop
  • v0.2 – Local Admin + Hardcoded Stack
  • v0.3 – Wizard + TLS Bootstrap + Manifest Deploy (2025-01-19)
  • v0.4 – Multi-Environment + Docker Compose Deployment (2025-01-28)
    • Polymorphic Environment Types (Docker Socket)
    • Docker Compose Stack Deployment (Portainer-style)
    • Automatic Environment Variable Detection
    • Stack Sources System with Recursive Discovery
    • 404 Page, 4-Step Wizard, Environment Management UI
    • Registry Authentication for Image Pulls
    • Deployment Warnings for Local Image Fallback
  • v0.5 – Environment Setup Flow + PublicWeb (2025-11-30)
    • Environment Creation as Optional Wizard Step
    • EnvironmentGuard for Environment-Dependent Pages
    • SetupEnvironment Page When No Environment Exists
    • PublicWeb Landing Page (DE/EN) with Astro/Starlight
    • ams.project Showcase, Legal Notice, Privacy Policy
    • Install Script with Docker Hub Image
  • v0.6 – DDD Architecture + Security Hardening (2025-12-01)
    • SQLite Database for Persistent Storage
    • Domain-Driven Design with Bounded Contexts
    • Clean Architecture Implementation
    • MediatR for Command/Query Separation
    • RBAC (Role-Based Access Control)
    • Wizard Timeout (5-Minute Time Window for Admin Creation After Server Start)
    • API Lockdown After Timeout Expiration (like Portainer)
  • v0.7 – Automated Release Workflow (2025-12-03)
    • Fully Automated Release Workflow with GitHub Actions
    • PublicWeb Deployment on Every Release
  • v0.8 – Simplified Release Management (2025-12-03)
    • Simplified Release Workflow
    • GitHub-based Release Notes Integration
  • v0.9 – Dev Builds + Example Stacks (2025-12-03)
    • Draft-only Releases with Manual Publish
    • Docker Dev Builds on ghcr.io
    • Example Stacks Included in Docker Image
  • v0.10 – RSGo Manifest Format (2025-12-07)
    • Native Stack Definition Format for ReadyStackGo
    • 17 Variable Types (String, Number, Boolean, Select, Password, Port, Url, Email, etc.)
    • Docker Compose Import with Automatic Conversion
    • Multi-Stack Products with Shared Variables and Fragments
    • Regex Validation for Input Fields
    • Complete Manifest Specification and Schema Reference
  • v0.11 – Domain Refactoring & REST API (2025-12-11)
    • DeployStack REST Endpoint for Stack Deployment via API
    • SignalR DeploymentHub for Real-time Progress Updates
    • StackValidationInfo for Pre-deployment Validation
    • Maintenance Observer Integration
    • Bounded Contexts Documentation
    • Domain Events for Deployment context (DeploymentStarted, DeploymentCompleted, etc.)
    • RuntimeStackConfig Entity in Deployment Context
    • Structured ServiceTemplate, VolumeDefinition, NetworkDefinition
    • ProductId navigation from Stack detail to Catalog
    • Deployment API uses stackId instead of raw YAML
  • v0.12 – Domain Refactoring (DDD) - Phase 2 (2025-12-13)
    • Removed MaintenanceObserver from StackDefinition (belongs to ProductDefinition)
    • Infrastructure services don't publish domain events (Application layer responsibility)
    • IStackSourceProvider.LoadStacksAsync returns StackDefinition directly
    • Infrastructure reorganization by technical concerns (DataAccess, Docker, Security assemblies)
    • Removed obsolete StackVariable class - use Variable instead
    • Removed unused StackDefinitionLoaded and StackSourceSynced events
    • Variable record with comprehensive UI metadata (Type, Pattern, Options, Min/Max, Group, Order)
    • Built-in Validate() method for type-specific validation
    • Clean build with 0 warnings (fixed CS0105, CS8602, CS8604)
  • v0.13 – Health Monitoring (2025-12-15)
    • Load Health Check Configuration from RSGO Manifest
    • ServiceHealthCheck extended with HTTP/TCP fields (type, path, port, expectedStatusCodes, https)
    • HealthCheckConfigs collection in Deployment aggregate
    • Health configs extracted during deployment and persisted to database
    • HealthCollectorService uses health configs for HTTP/TCP checks
    • 41 unit tests + 15 integration tests with TestContainers
  • v0.14 – Health Dashboard, Upgrade & Rollback (2025-12-19)
    • Stack Health Dashboard (UI for health status visualization)
    • Health History with 24h retention and configurable intervals
    • Stack Upgrade (Update deployed stacks to newer catalog versions)
    • SemVer-based version comparison
    • Environment-level operation locking (one operation per environment)
    • Pre-upgrade snapshot for recovery
    • Deployment Rollback (Manual recovery after failed upgrades)
    • Only available after failed upgrade (not for downgrades)
    • Single snapshot per deployment (previous version only)
    • Product authors can disable via metadata.rollback.enabled: false
  • v0.15 – Multi-Version Catalog, Registry Management & Git Stack Sources (2025-01-12)
    • Settings Page with Registry Management UI
    • CRUD for Docker Registries (Name, URL, Username, Password)
    • Image Patterns for automatic credential matching (glob-style: library/*, ghcr.io/**)
    • Default registry support
    • Database-first credential resolution during deployment
    • 64 integration tests (Endpoints + Repository)
    • Multi-Version Catalog Support
    • Multiple versions per product in catalog
    • New metadata.productId field for grouping versions across sources
    • ProductDefinition.GroupId for version grouping (uses productId or falls back to sourceId:name)
    • IProductCache extended with version-aware methods (GetProductVersions, GetAvailableUpgrades, etc.)
    • Cross-source upgrade support (e.g., local → git repository)
    • Version dropdown in deployment UI for selecting specific version
    • Upgrade detection shows all available higher versions
    • Git Repository Stack Source Provider (Load Stacks from Git Repos)
    • Stack Sources Management UI (Add/Edit/Delete sources, credentials for private repos)
  • v0.16 – Remove Deployment + Progress Notifications (2026-01-20)
    • Remove Deployment page with SignalR progress notifications
    • DDD Redesign and Rollback Progress Notifications
  • v0.17 – TLS & Certificate Management + Release Info (2026-01-22)
    • Settings UI refactoring with tab navigation (General, TLS, Registries, Stack Sources)
    • TLS Certificate Management
      • Self-signed certificate (auto-generated on first start)
      • Custom certificate upload (PFX and PEM formats)
      • Certificate info display (subject, issuer, expiry, thumbprint)
    • Let's Encrypt Integration
      • HTTP-01 Challenge (port 80 validation)
      • DNS-01 Challenge with Manual and Cloudflare provider
      • Automatic certificate renewal (30 days before expiry)
      • Staging mode for testing
    • Reverse Proxy Support
      • SSL Termination mode (proxy handles HTTPS, backend receives HTTP)
      • SSL Passthrough mode (proxy forwards encrypted traffic)
      • Re-Encryption mode (proxy terminates and re-encrypts)
      • ForwardedHeaders middleware configuration
      • X-Forwarded-For/Proto/Host header processing
    • Release Info in Sidebar
      • Version display (current server version)
      • Update notification banner (when new version available)
      • Link to GitHub release notes
      • Dismissable notification with localStorage persistence
    • Public Website TLS Documentation (DE/EN)
    • Stack Sources Git Credentials Support
    • Registry Management improvements
  • v0.18 – Init Container UI/UX Improvements (2026-02-10)
    • Separate Init Container Counting in Deployment Progress
    • Real-time Init Container Log Streaming via SignalR
    • Init Containers Excluded from Health Monitoring
    • Automatic Init Container Cleanup After Successful Init Phase
  • v0.19 – CI/CD Integration (2026-02-11)
    • API Key Domain Model with SHA-256 Hashed Key Storage
    • API Key Authentication Handler with Multi-Scheme Auth (PolicyScheme)
    • API Key Management CRUD Endpoints and Settings UI
    • Redeploy Webhook (POST /api/hooks/redeploy) for Fresh Image Deployments
    • Upgrade Webhook (POST /api/hooks/upgrade) with Catalog Version Resolution
    • Catalog Sync Webhook (POST /api/hooks/sync-sources)
    • Fine-grained Permission System per API Key (Redeploy, Upgrade, SyncSources)
    • Optional Environment-Scope for API Keys
    • Pipeline Examples for curl, GitHub Actions, and Azure DevOps
  • v0.20 – Deploy Hook Improvements & Bugfixes (2026-02-12)
    • Idempotent Deploy Hook with Variable Default Value Fixes
    • Deploy Permission Option in API Key Creation UI
    • WebUI Headless Refactoring Specification
  • v0.21 – UX Improvements (2026-02-12)
    • Copy-to-Clipboard Stack ID Button on Catalog StackCard
  • v0.22 – Self-Update (2026-02-13)
    • UI-Triggered Self-Update via Helper Container Pattern
    • Version Detection via GitHub Releases API
    • Assembly Version Baking in Dockerfile (GIT_SEMVER Build Arg)
    • Helper Container (rsgo-updater) for Zero-Downtime Container Swap
    • Maintenance Page Served by Helper During Container Restart
    • Self-Update Documentation (DE/EN) and Landing Page Highlight
  • v0.23 – Self-Update UX (2026-02-13)
    • Dedicated Full-Page Update Status Screen with Progress Display
    • Version Transition Badge (Current → Target Version)
    • Error State with Retry and Back-to-Dashboard Options
    • Helper Container Maintenance Page Restyled with RSGO Branding
  • v0.24 – Preconfigured Sources, Registry Wizard & Setup Flow Redesign (2026-02-15)
    • Curated Source Registry (Embedded JSON Catalog of Known Git/Local Sources)
    • Wizard Stack Source Selection (Opt-in Instead of Auto-Creation)
    • Add From Catalog in Stack Source Settings (One-Click Add from Registry)
    • Image Reference Extraction from Synced Stack Manifests (Auto-Detect Host + Namespace)
    • Container Registry Detection Endpoint (Grouped by Host + Pattern)
    • Wizard Step for Container Registries (Two-Column Verified/Action-Required Layout)
    • Credential Verification via Docker Registry v2 API Token Flow
    • Two-Phase Setup: Secure Admin Creation (Phase 1) + Guided Onboarding (Phase 2)
    • Auto-Login After Admin Creation (JWT in CreateAdmin Response)
    • Wizard Simplified to Single Step (Admin Only, 5-Min Timeout)
    • Mandatory Onboarding Flow: Organization → Environment → Sources → Registries
    • Onboarding Status API (Authenticated, No Timeout Dependency)
  • v0.25 – Docker Volumes Management (2026-02-16)
    • Docker Volumes View (List All Volumes per Environment)
    • Volume Details (Size, Mount Points, Labels, Container References)
    • Create/Delete Volumes with Driver Selection
    • Orphaned Volume Detection and Bulk Cleanup
  • v0.26 – Container Management, Notifications & System Info (2026-02-17)
    • Container Remove Action with Force Flag and Safety Checks
    • Container Context Endpoint (Stack/Product/Deployment Resolution)
    • Three Container Views (List, Stack-Grouped, Product-Grouped)
    • Orphaned Container Detection (RSGO-Labeled Without Active Deployment)
    • Unmanaged Container Group (External Containers Without RSGO Labels)
    • Dedicated Delete Confirmation Pages (Stack Sources, Environments)
    • ams.project Stack Source in Curated Registry
    • External Network Auto-Creation for Multi-Stack Products
    • In-Memory Notification Store (Max 50, FIFO Eviction, Singleton — Transient Pre-v1.0)
    • Notification API Endpoints (List, Unread-Count, Mark-Read, Mark-All-Read, Dismiss)
    • NotificationDropdown (Bell Icon with Animated Badge, 60s Polling)
    • Update Available Notification (Deduplicated Per Version)
    • Source Sync Result Notification (Success/Warning/Error with Detail Rollup)
    • Deployment Result Notification (Deploy, Upgrade, Rollback, Remove — Stack & Product)
    • Settings > System Tab (Version Info, Build Info, "Check for Updates" Button)
    • User-Dropdown Version Badge (Version Display + Update Indicator)
    • Shared useVersionInfo Hook (SidebarWidget, UserDropdown, SystemInfo)
    • forceCheck Query Parameter on Version Endpoint (Bypass 24h Cache)
  • v0.27 – Product Deployment & Orphaned Container Recovery (2026-02-21)
    • ProductDeployment Aggregate Root with ProductStackDeployment Child Entities
    • Product-Level State Machine (Deploying → Running / PartiallyRunning / Failed → Removing → Removed)
    • Deploy Product Flow (Orchestrated N-Stack Deployment with Shared Variable Wizard)
    • Upgrade Product Flow (Cross-Stack Version Upgrade with Variable Merging)
    • Check Upgrade Availability (Catalog Version Comparison with New/Removed Stack Detection)
    • Remove Product Flow (Reverse-Order Multi-Stack Removal)
    • Product Deployment Status in Catalog (Per-Stack Deploy State on ProductDetail)
    • SignalR Multi-Stack Progress (Per-Stack + Overall Progress Events)
    • Health-Sync Background Service (Eventual Consistency Between Product and Stack Status)
    • ContinueOnError Flag for Partial Failure Tolerance
    • Three-Tier Variable System (Stack Defaults → Shared Variables → Per-Stack Overrides)
    • Split-View Deployment Progress (Per-Stack Progress Bar, Service Counters, Init Container Logs)
    • Shared DeploymentProgressPanel Component (Extracted from Single-Stack Deployment)
    • Product Deployment E2E Tests with Multi-Stack Test Product
    • Step-by-Step Documentation with Screenshots (DE/EN)
    • Repair Orphaned Stacks (Reconcile Running Containers with Fresh Database via Catalog Matching)
    • Bulk Remove Orphaned Stacks (Delete All Containers of an Orphaned Stack Group)
    • Repair All Orphaned Stacks (Batch Repair with Per-Stack Error Handling)
    • Orphaned Stack UI Actions (Repair/Remove Buttons with Confirmation Dialogs in All Container Views)
  • v0.28 – Deployments Overview with Product Info (2026-02-25)
    • Product Deployments Section in Deployments Overview (Above Stack Deployments)
    • Product Deployment Cards (Name, Version, Status, Stack Progress, Actions)
    • Frontend listProductDeployments() API Function (Missing in v0.27)
    • Product-Level DeploymentName Refactoring (Single Name Instead of Per-Stack)
  • v0.29 – Health Check Details (2026-02-26)
    • Full ASP.NET Core HealthReport Parsing (entries with status, description, duration, data, tags, exception)
    • Health Check Entry Domain Model (HealthCheckEntry Value Object)
    • Data Pipeline: HttpChecker → Domain → DTO → SignalR/API
    • Inline Health Check Detail in Dashboard (expandable service rows)
    • Dedicated Service Health Detail Page (/health/:deploymentId/:serviceName)
    • Dedicated Service Health Detail API Endpoint
    • Service Response Time Tracking
    • EF Core Persistence for Health Check Entries (JSON serialization)
  • v0.30 – Container Logs, Retry & Hook Improvements (2026-02-26)
    • Container Log Viewer with Live Streaming via SignalR
    • REST Endpoint for Historical Logs (GET /api/containers/{id}/logs)
    • SignalR ContainerHub for Real-Time Log Tailing (/hubs/container)
    • Terminal-Style Fullscreen Log Page with Auto-Scroll and Tail Selector
    • Retry Failed Product Deployment (Resume From Last Failed Stack)
    • Deploy Hook Resolution by ProductId (Stable CI/CD Without Instance-Specific SourceId)
    • Optional productId, version, stackDefinitionName Fields on /api/hooks/deploy
    • Backward-Compatible: Existing stackId-Based Requests Still Supported
  • v0.31 – Product Container Control (2026-03-03)
    • Stop All Containers of a Product Deployment (Graceful Shutdown)
    • Restart All Containers of a Product Deployment (Stop + Start Sequentially)
    • Per-Stack Stop/Restart Within a Product Deployment (Selective Control)
    • Stop/Restart UI with Dedicated Pages and Confirmation Dialogs
    • Stopped Status in Product and Stack Deployment State Machines
    • Hook Support for Stop/Restart (/api/hooks/stop-containers, /api/hooks/restart-containers)
    • API Key Permissions for StopContainers and RestartContainers
  • v0.32 – Notifications Phase 2 (2026-03-03)
    • Container Health Change Notification (Unhealthy/Degraded/Recovery with Configurable Throttling)
    • Health Notification Cooldown Setting on System Settings Page (1–60 Minutes)
    • API Key First-Use Notification (Info-Level on First API Key Usage)
    • TLS Certificate Expiry Notification (Staged Warnings at 30d, 14d, 7d, 3d, 1d, 0d)
    • CertificateExpiryCheckService Background Service (12h Interval)
    • HealthChangeTracker Singleton (Per-Service Status Tracking with ConcurrentDictionary Cooldown)
    • 3 New NotificationType Enum Values: HealthChange, ApiKeyFirstUse, CertificateExpiry
  • v0.33 – Redeploy Product Deployment (2026-03-03)
    • Redeploy All Stacks of a Running Product Deployment (Same Version, Fresh Pull)
    • Redeploy Single Stack Within a Product Deployment (Selective Stack Redeploy)
    • New Redeploying Status in Product Deployment State Machine
    • Variable Override Support During Redeploy (Stored Base + Webhook Overrides)
    • Redeploy Product UI (Stack Selection, Confirmation, Progress Panel)
    • Hook Support for Product Redeploy (/api/hooks/redeploy with productId)
  • v0.34 – Distribution Architecture (2026-03-04)
    • pnpm Workspaces Monorepo (packages/core, packages/ui-generic, apps/rsgo-generic)
    • @rsgo/core Package (TypeScript types, API clients, ViewModel hooks, SignalR services)
    • @rsgo/ui-generic Package (React components, pages, layouts, thin contexts)
    • ViewModel Hooks for All Pages (Settings, Deployments, Catalog, Health, Wizard)
    • SignalR Service Classes with Thin React Hook Wrappers
    • Auth/Environment Services Extracted from React Contexts
    • Build Pipeline Adjustment (pnpm in Dockerfile)
    • ISetupWizardDefinitionProvider + GenericSetupWizardDefinitionProvider (Data-Driven Wizard Steps)
    • IBootstrapper + GenericBootstrapper (Distribution-Specific Initialization on First Start)
    • NuGet Meta-Package ReadyStackGo.Core (Domain + Application + Infrastructure)
    • Multi-Assembly FastEndpoints Endpoint Discovery
    • Distribution Architecture Documentation
  • v0.39 – Documentation & PublicWeb Updates (2026-03-12)
    • Cancel image pull after 3 minutes without progress
    • Product Redeploy documentation with E2E tests and landing page highlight
    • Container Management documentation with E2E tests and landing page highlight
    • Remove Product documentation with E2E tests
    • Container Control documentation with E2E tests and landing page highlight
    • Custom Distributions documentation and landing page highlight
    • DevStatus banner updated to "v1.0 Release in Vorbereitung / Coming Soon"
    • AMS distribution planning: skills, plan files, independent versioning concept
  • v0.40 – Maintenance & Cleanup (2026-03-12)
    • Delete obsolete spec files superseded by completed PLAN files
    • Add spec cleanup step to plan-feature skill
  • v0.41 – PublicWeb Polish (2026-03-12)
    • DevStatus banner updated from early-dev warning to v1.0 coming soon (brand blue, checkmarks)
    • Remove AMS Distribution example from distributions documentation
  • v0.42 – Bugfix: Redeploy Premature Completion (2026-03-12)
    • Fix redeploy showing success after first stack due to SuppressNotification: false sending DeploymentCompleted per stack
  • v0.43 – Bugfix: Container List Stale Health (2026-03-13)
    • Fix container list showing stale unhealthy status from removed deployments by filtering to active deployments only
  • v0.44 – Bugfix: Self-Update Progress Jumping (2026-03-13)
    • Fix progress bar jumping back and forth during self-update by enforcing monotonic progress percentage
  • v0.45 – Third-Party Licenses UI, Documentation Link & CI Fix (2026-03-13)
    • Settings > Licenses page listing all bundled npm and .NET packages with license types and links
    • License JSON files (npm-webui, npm-publicweb, dotnet) bundled into Docker image via Dockerfile
    • Search and filter by license type, category badges with package counts
    • Sidebar "Documentation" link opening online docs in new tab
    • Fix CI license generation workflow (migrate from deprecated dotnet-project-licenses to nuget-license)
  • v0.46 – Health History Transition Chart (2026-03-13)
    • Replace snapshot-based health history with status transition step chart
    • GetHealthTransitions endpoint using LAG() window function to detect status changes
    • Recharts stepAfter line chart showing health transitions over time
  • v0.47 – Health Chart v2: Per-Service Visibility & Visual Redesign (2026-03-13)
    • Replace percentage-based step line chart with categorical status band visualization
    • Per-service swim lane timeline showing individual service health over time
    • Uptime donut chart with percentage distribution by status
    • Maintenance mode shown in blue, excluded from uptime calculation
    • Enriched HealthTransitionDto with per-service data and operation mode
    • Bilingual health monitoring documentation (DE/EN) with E2E-generated screenshots
    • AMS UI impact check step added to implement-feature skill
  • v0.48 – Maintenance Mode Redesign (2026-03-14)
    • MaintenanceTrigger value object with ownership rules (Manual/Observer sources)
    • Trigger-based exit blocking: observer can't exit manual maintenance and vice versa
    • Product-level maintenance: OperationMode, MaintenanceTrigger on ProductDeployment aggregate
    • Observer service refactored to iterate ProductDeployments (one check per product, not N per stack)
    • Product operation mode API endpoint with 409 Conflict for ownership-blocked transitions
    • Product detail page: enter/exit maintenance buttons, operation mode badge, trigger info panel
    • 23 new handler unit tests, 22 domain unit tests, 11 value object unit tests
    • Fix: Maintenance mode propagation to child stacks (OperationMode + status badge override)
    • Dedicated Enter/Exit Maintenance pages with confirmation flow
    • Remove stack-level maintenance API (product-level only)
    • Reduce sidebar logo spacing
  • v0.49 – SSH Tunnel Environment (2026-03-15)
    • Polymorphic ConnectionConfig (JSON Column, DockerSocketConfig + SshTunnelConfig subtypes)
    • SSH Credential Storage (AES-encrypted private keys/passwords)
    • SshTunnelManager (SSH.NET, local port forwarding, tunnel pool, auto-reconnect)
    • DockerService SSH-Routing (transparent tunnel for all Docker operations)
    • SSH Environment API + UI (type selector, dynamic form, test connection)
    • Bilingual documentation (DE/EN) with E2E test screenshots
    • Landing page highlight feature tile
    • Environment Type Selector: split Add Environment into type selection + type-specific sub-pages