# 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
```bash
# 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

```bash
# 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