n8n-nodes-semble/README.md

n8n community node for Semble practice management system - automate bookings, patients, and product/service catalog management

# n8n-nodes-semble

A comprehensive community node for n8n that integrates with Semble practice management system. Version 2.0 features a complete architectural rewrite with enterprise-grade reliability, comprehensive testing, and professional documentation.

## 🚀 Version 2.0 - Complete Rewrite

**New in v2.0 - Major Breaking Changes:**
- ✅ **Service-oriented Architecture** - Complete refactor with dependency injection and service container  
- ✅ **Enhanced Resources** - `appointment` → `booking`, removed `staff`, added comprehensive `products`
- ✅ **Enterprise Testing** - 86.31% test coverage with 1,312+ automated tests and quality gates
- ✅ **Professional Documentation** - Complete MkDocs documentation with examples and API reference
- ✅ **Advanced Error Handling** - Sophisticated error mapping, field permissions, and validation
- ✅ **Performance Optimisations** - Intelligent caching, schema registry, and query optimisation

## For End Users

Want to use the Semble nodes in your n8n workflows?

📖 **[Getting Started Guide](docs/getting-started/installation.md)** - Installation and setup instructions for v2.0

📚 **[Full Documentation](https://mikehatcher.github.io/n8n-nodes-semble/)** - Complete user guide with migration information

!!! warning "Breaking Changes in v2.0"
    Version 2.0 includes breaking changes from v1.x. Please review the migration guide in the documentation.

## For Developers

Built with enterprise-grade architecture, comprehensive testing, and modern development practices. The v2.0 rewrite features service-oriented design, dependency injection, and 86.31% test coverage.

🛠️ **[Development Guide](docs/development/contributing.md)** - Setup, contribution guidelines, and development workflow

🏗️ **[Architecture Documentation](docs/development/architecture.md)** - Service-oriented architecture and implementation details

## Quick Links

- [Semble API Documentation](https://docs.semble.io/)
- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
- [Issues & Support](https://github.com/mikehatcher/n8n-nodes-semble/issues)

## License

MIT License - see [LICENSE](LICENSE) file for details.