Files
care-book-block-ultimate/README.md
Emanuel Almeida bd6cb7923d 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>
2025-09-12 22:58:25 +01:00

3.1 KiB

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