Care Book Block Ultimate

Plugin WordPress avançado para controlo de appointment no KiviCare com funcionalidades de restrição de médicos e serviços.

🎯 Objetivo

Sistema de gestão de appointments que permite:

• Controlo granular de disponibilidade de médicos
• Restrições por serviços específicos
• Interface administrativa intuitiva
• Integração transparente com KiviCare

⚡ Stack Tecnológico

• Backend: PHP 7.4+ + WordPress 5.0+
• Plugin Base: KiviCare 3.0.0+
• Database: MySQL 5.7+ com WordPress $wpdb API
• Frontend: WordPress Admin + AJAX + CSS-first approach
• Cache: WordPress Transients API

🏗️ Arquitetura

care-booking-block/           # Plugin WordPress principal
├── src/                      # Código fonte
│   ├── models/              # Modelos de dados
│   ├── services/            # Lógica de negócio
│   ├── admin/              # Interface administrativa
│   └── integrations/        # Hooks KiviCare
├── tests/                   # Testes PHPUnit
│   ├── contract/           # Testes de contrato API
│   ├── integration/        # Testes WordPress+KiviCare
│   └── unit/               # Testes unitários
└── docs/                   # Documentação

🚀 Quick Start

Desenvolvimento

# Ativar plugin
wp plugin activate care-booking-block

# Executar testes
vendor/bin/phpunit tests/

# Operações database
wp db query "SELECT * FROM wp_care_booking_restrictions"

Funcionalidades Core

• ✅ CSS-first filtering: Performance otimizada
• ✅ Hook-based integration: Sem modificações do core
• ✅ Custom database table: Indexação apropriada
• ✅ Transient caching: Invalidação seletiva
• ✅ Security-first: Nonces, capabilities, sanitization

📊 Performance Requirements

• Page Loading: <5% overhead
• Admin AJAX: <200ms response time
• Restriction Toggles: <300ms (including cache invalidation)
• Scalability: Suporte para milhares de médicos/serviços

🧪 Testing Strategy

Ciclo RED-GREEN-Refactor obrigatório:

1. Testes de contrato falhando
2. Testes de integração falhando
3. Testes unitários falhando
4. Implementar código para passar testes
5. Refatorar mantendo testes verdes

📋 Standards

• PHP: WordPress Coding Standards + PSR-4
• JavaScript: WordPress JS Standards
• CSS: WordPress Admin Styling
• Database: Prepared statements obrigatório
• Security: Input sanitization + output escaping

🔧 Comandos Disponíveis

# Plugin management
wp plugin activate/deactivate/uninstall care-booking-block

# Database operations
wp transient delete care_booking_doctors_blocked

# Testing
wp eval-file tests/integration/test-kivicare-hooks.php

📝 Convenções

• Snippets WP Code em vez de functions.php
• SSH server.descomplicar.pt porta 9443
• Editar ficheiros existentes vs criar novos
• Documentação apenas quando explicitamente solicitada

---

Desenvolvido com: Template Descomplicar® v2.0 Repositório: https://git.descomplicar.pt/care-book-block-ultimate Última atualização: 2025-09-12