bd6cb7923d
- Generated comprehensive tasks.md with 16 major tasks and 94+ subtasks - Created interactive CHECKLIST.md with progress tracking and dashboard - Updated implementation plan with security-validated tech stack - Added phase-by-phase breakdown with dependencies and success criteria - Ready for Phase 0: Security Foundation & Environment Setup 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
106 lines
3.1 KiB
Markdown
106 lines
3.1 KiB
Markdown
# 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 |