feat: complete task breakdown and checklist
- 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>
This commit is contained in:
106
README.md
Normal file
106
README.md
Normal file
@@ -0,0 +1,106 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user