Skip to content

Latest commit

 

History

History
180 lines (153 loc) · 6.59 KB

File metadata and controls

180 lines (153 loc) · 6.59 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Planned

  • Custom Docker Compose support
  • Dark theme for interface
  • Basic plugin system
  • Performance improvements in initial load

[0.0.2] - 2024-12-XX

Added

  • PHP Container Host Management: Automatic addition of development environment URLs to Windows hosts file
  • Enhanced PHP Version Support: Updated containers for PHP 5.6, 7.2, 7.4, 8.1, 8.2, 8.3, 8.4
  • Operating System Information: Added OS details display in each PHP container
  • Development URLs: Automatic setup of php{version}.wsdd.dock, cron{version}.wsdd.dock, wm{version}.wsdd.dock

Changed

  • PHP 5.6 Container:
    • Updated Dockerfile to connect to Debian archive files
    • Disabled obsolete GPG key with standalone implementation
    • Updated to Apache raw version and PHP 5.6.40
    • Added Xdebug support
  • PHP 7.2 Container:
    • Updated Dockerfile to connect to Debian archive files
    • Disabled obsolete GPG key with standalone implementation
    • Updated to Apache raw version and PHP 7.2.34
    • Added Xdebug support
  • PHP 7.4 Container:
    • Updated Dockerfile to connect to Debian archive files
    • Disabled obsolete GPG key with standalone implementation
    • Updated to Apache raw version and PHP 7.4.33
    • Added Xdebug support
  • PHP 8.1 Container:
    • Updated to Apache raw version and PHP 8.1.33
    • Added Xdebug support
  • PHP 8.2 Container:
    • Updated to Apache raw version and PHP 8.2.29
    • Added Xdebug support
  • PHP 8.3 Container:
    • Updated to Apache raw version and PHP 8.3.23
    • Added Xdebug support
  • PHP 8.4 Container:
    • Updated to Apache raw version and PHP 8.4.10
    • Added Xdebug support

Fixed

  • Hosts File Management: Fixed issue where PHP container base URLs were not automatically added to Windows hosts file
  • Container Deployment: Improved reliability of PHP container deployment process

[0.0.1] - 2024-01-XX

Added

  • Main application with Windows Forms interface
  • Automatic Docker Desktop management (detection, installation, configuration)
  • Web project system with predefined templates
  • Complete MKCert integration for local SSL certificates
  • Automatic system hosts file management
  • Integrated terminal with real-time output
  • Initial configuration wizard (Welcome wizard)
  • Multi-screen support with automatic selector
  • Docker container management (start, stop, monitoring)
  • Automated PowerShell scripts for system tasks
  • Windows Subsystem for Linux (WSL) configuration
  • Chocolatey integration for package management
  • Persistent configuration system
  • Integrated development tools (ToolBox)
  • Container log viewer
  • Integrated help system
  • "About" window with project information

Core Functionalities

  • HandlerWSDD: Main controller with privilege verification
  • HandlerDocker: Complete Docker and container management
  • HandlerProject: Web project creation and deployment
  • HandlerMKCert: SSL certificate management for development
  • HandlerHosts: Automatic hosts file modification
  • HandlerSetting: User configuration persistence
  • PSScript: Integrated PowerShell script executor

User Interfaces

  • Main Form: Main dashboard with project management
  • Welcome Form: First-time configuration wizard
  • AddNewProject Form: New project creation
  • Settings Form: General configurations
  • About Form: Application information
  • Help Form: Integrated help system
  • Loader Form: Loading screens for long operations
  • DisplaySelector Form: Screen selector for multiple monitors
  • ToolBox Forms: Specialized tools for projects and containers
  • WSLGeneralSetting Form: WSL configuration

Technical Features

  • Modular architecture with separation of concerns
  • Robust error handling with automatic recovery
  • Integrated terminal logging with different levels
  • Administrator privilege management
  • Windows 10 and 11 support
  • Responsive interface adaptable to different resolutions
  • Asynchronous operations for better user experience
  • Automatic system requirements validation

Security

  • Automatic administrator privilege verification
  • Secure SSL certificate management
  • Critical system operation validation
  • Secure configuration file handling

Automation

  • Automatic Docker Desktop installation if not present
  • Automatic Docker network configuration (wsdd-network)
  • Automatic SSL certificate generation for projects
  • Automatic hosts file modification for local development
  • Automatic WSL configuration if needed

Documentation

  • Complete README.md with usage instructions
  • structure.md with detailed project architecture
  • features.md with complete functionality listing
  • task_pending.md with future improvements roadmap
  • CONTRIBUTING.md with contributor guidelines
  • Inline documentation in critical code

Project Configuration

  • .NET 8.0 project with Windows Forms
  • Optimized compilation configuration
  • Application manifest for administrator privileges
  • Embedded resources for help files
  • Custom application icon (WSDD-64.ico)

Version Notes

Compatibility

  • Operating Systems: Windows 10 (1903+), Windows 11
  • Framework: .NET 8.0 Runtime required
  • Privileges: Administrator mandatory
  • Dependencies: Docker Desktop (installed automatically)

Known Limitations

  • Requires administrator privileges for all functionalities
  • Windows-only compatibility (by design)
  • Requires internet connection to download Docker Desktop
  • WSL must be enabled on the system

Performance

  • Startup time: < 3 seconds on modern hardware
  • Memory usage: ~50-100 MB in normal operation
  • CPU usage: Minimal when idle, moderate during deployments
  • Disk space: ~200 MB for application + space for Docker

Development Notes

  • Fully documented source code
  • Modular architecture for easy maintenance
  • Implemented design patterns (Handler, Factory, Observer)
  • Clear separation between UI and business logic
  • Extensive manual testing on multiple Windows configurations

Version Format

This project uses Semantic Versioning:

  • MAJOR: Incompatible API changes
  • MINOR: New backward-compatible functionalities
  • PATCH: Backward-compatible bug fixes

Types of Changes

  • Added: For new functionalities
  • Changed: For changes in existing functionalities
  • Deprecated: For functionalities that will be removed
  • Removed: For removed functionalities
  • Fixed: For bug fixes
  • Security: For security vulnerabilities