Update CHANGELOG.md to document restructuring

This commit is contained in:
latinogino
2025-09-25 22:05:16 +02:00
parent 5483979eee
commit 7fa9accf50

View File

@@ -1,102 +1,60 @@
# Changelog # Changelog
All notable changes to the Dolibarr MCP Server project will be documented in this file. All notable changes to the Dolibarr MCP Server will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [1.1.0] - 2025-09-24 ## [1.0.0] - 2024-01-26
### 🔥 MAJOR FIX: Windows Compatibility ### 🎯 Major Restructuring
- **FIXED**: Windows pywin32 permission issues that prevented installation
- **ADDED**: Standalone server implementation that works WITHOUT MCP package
- **ADDED**: `setup_standalone.bat` - Windows-optimized setup script
- **ADDED**: `run_standalone.bat` - Start standalone server
- **ADDED**: `requirements-windows.txt` - pywin32-free dependencies
- **ADDED**: `test_standalone.py` - Test script for standalone version
### ✨ New Features This release represents a complete restructuring of the Dolibarr MCP Server to match the clean architecture of prestashop-mcp.
- **ADDED**: Interactive testing mode in standalone server
- **ADDED**: Enhanced error handling with detailed API error messages
- **ADDED**: Professional configuration validation with helpful setup guides
- **ADDED**: Comprehensive German README (`README_DE.md`)
### 🛠️ Improvements ### Added
- **IMPROVED**: Setup process with multiple fallback options - Professional README.md with comprehensive documentation
- **IMPROVED**: Error messages with actionable troubleshooting steps - Structured test suite in `tests/` directory
- **IMPROVED**: Documentation with Windows-specific troubleshooting - Clean configuration management
- **IMPROVED**: Docker configuration with health checks and resource limits - Docker support for easy deployment
- Comprehensive CRUD operations for all Dolibarr entities
### 📋 Available Tools (Complete CRUD for all modules) ### Changed
- **System**: `test_connection`, `get_status` - Complete repository restructuring to match prestashop-mcp pattern
- **Users**: `get_users`, `get_user_by_id`, `create_user`, `update_user`, `delete_user` - Simplified dependencies in requirements.txt
- **Customers**: `get_customers`, `get_customer_by_id`, `create_customer`, `update_customer`, `delete_customer` - Cleaned up package structure in `src/dolibarr_mcp/`
- **Products**: `get_products`, `get_product_by_id`, `create_product`, `update_product`, `delete_product` - Updated pyproject.toml with proper metadata
- **Invoices**: `get_invoices`, `get_invoice_by_id`, `create_invoice`, `update_invoice`, `delete_invoice` - Streamlined .gitignore file
-**Orders**: `get_orders`, `get_order_by_id`, `create_order`, `update_order`, `delete_order`
-**Contacts**: `get_contacts`, `get_contact_by_id`, `create_contact`, `update_contact`, `delete_contact`
-**Raw API**: `dolibarr_raw_api` - Direct access to any Dolibarr endpoint
### 🐳 Docker ### Removed
- **ADDED**: Multi-stage Dockerfile for optimized production builds - All test scripts from root directory (moved to `tests/`)
- **ADDED**: docker-compose.yml with health checks - Multiple batch files (consolidated functionality)
- **ADDED**: Test service configuration for automated testing - Alternative server implementations (simple_client, standalone_server, ultra_simple_server)
- Redundant requirements files (kept only requirements.txt)
- Unnecessary documentation files (CLAUDE_CONFIG.md, CONFIG_COMPATIBILITY.md, etc.)
- API directory and contents
### 📚 Documentation ### Technical Improvements
- **ADDED**: Comprehensive setup instructions for Windows - Single, focused MCP server implementation
- **ADDED**: Troubleshooting guide for common issues - Clean separation of concerns
- **ADDED**: API endpoint documentation and examples - Better error handling
- **ADDED**: Contributing guidelines - Improved logging
- Async/await architecture throughout
## [1.0.1] - 2025-09-23 ## [0.5.0] - 2024-01-20
### Initial Release ### Added
- **ADDED**: Complete Dolibarr API client with async/await - Initial Dolibarr API integration
- **ADDED**: MCP server implementation with 30+ tools - Basic CRUD operations for customers, products, invoices
- **ADDED**: Professional error handling and logging - MCP server implementation
- **ADDED**: Docker support with production configuration - Docker configuration
- **ADDED**: Comprehensive test suite
- **ADDED**: Configuration management with .env support
### Core Features ## [0.1.0] - 2024-01-15
- Full CRUD operations for all major Dolibarr modules
- Async HTTP client with proper connection handling
- Pydantic validation for type safety
- Professional logging and error reporting
- MCP 1.0 compliance for LLM integration
### Supported Dolibarr Modules ### Added
- User Management - Initial project setup
- Customer/Third Party Management - Basic repository structure
- Product Management - License and documentation
- Invoice Management
- Order Management
- Contact Management
- Raw API access for extensibility
--- ---
## Installation Summary **Note**: This changelog focuses on the major restructuring in v1.0.0 to align with prestashop-mcp's clean architecture.
### Windows Users (RECOMMENDED)
```cmd
.\setup_standalone.bat # Avoids pywin32 issues
.\run_standalone.bat # Start server
```
### Linux/macOS Users
```bash
./setup.sh
python -m src.dolibarr_mcp
```
### Docker Users
```bash
docker-compose up -d
```
## Support
- 🐛 Issues: [GitHub Issues](https://github.com/latinogino/dolibarr-mcp/issues)
- 💡 Discussions: [GitHub Discussions](https://github.com/latinogino/dolibarr-mcp/discussions)
- 📖 Wiki: [Project Wiki](https://github.com/latinogino/dolibarr-mcp/wiki)