PadelPress Manager

Plugin WordPress profesional para la gestión de clubes deportivos (pádel, tenis, pickleball, squash). Alternativa self-hosted a Playtomic Manager sin comisiones por reserva.

🌟 Características Principales

• 📅 Calendario y reservas inteligente en tiempo real
• 💳 Pagos integrados con Stripe y soporte para efectivo
• 👥 Gestión de clientes con sistema de niveles
• 🎾 Gestión de pistas múltiples deportes
• 💰 Motor de precios dinámicos por horario y temporada
• 📊 Facturación automática en PDF
• 📈 Dashboard de métricas y KPIs
• 🔐 Sistema de roles y permisos

🎯 MVP mínimo - 3 meses (Diciembre 2024 - Febrero 2025)

Épicas incluidas

• ✅ EPIC-001: Sistema de Calendario y Reservas Core
• ✅ EPIC-002: Gestión de Clientes (niveles manuales)
• ✅ EPIC-003: Gestión de Pistas y Disponibilidad
• ✅ EPIC-004: Motor de Precios Dinámicos (básico)
• ✅ EPIC-005: Integración de Pagos (Stripe + efectivo)
• ✅ EPIC-006: Facturación Automática y PDF
• ✅ EPIC-007: Dashboard y KPIs (básico)
• ✅ EPIC-008: Configuración General

Timeline: 7 sprints de 2 semanas = 14 semanas = 3 meses

🚀 Stack Tecnológico

Backend

• PHP 8.2+ con tipado estricto
• WordPress 6.4+ (Plugin architecture)
• Doctrine ORM 3.0+ (Database abstraction)
• MySQL 8.0+ / MariaDB 11+
• Stripe SDK 13.0+ (Pagos)
• Freemius (Monetización)

Frontend

• React 18+ con TypeScript 5.0+
• WordPress REST API
• SCSS / CSS Modules
• Webpack 5+ (Build system)

Herramientas

• PHPUnit (Testing backend)
• Jest + React Testing Library (Testing frontend)
• Composer (PHP dependencies)
• npm/yarn (JS dependencies)

📁 Estructura del Proyecto

padelpress-manager/
├── docs/                          # Documentación
│   ├── sprint-artifacts/          # Backlog y especificaciones
│   ├── design/                    # Mockups y wireframes
│   └── sql/                       # Scripts SQL
│
├── src/                           # Código fuente
│   ├──
│   │   ├── Controllers/           # REST API controllers
│   │   ├── Models/                # Doctrine entities
│   │   ├── Services/              # Business logic
│   │   └── Database/              # Migrations
│   │
│   └── frontend/                  # React app
│       ├── components/            # React components
│       ├── hooks/                 # Custom hooks
│       └── utils/                 # Utilities
│
├── tests/                         # Test files
├── vendor/                        # Composer deps
├── node_modules/                  # npm deps
└── dist/                          # Compiled assets

🛠️ Instalación para Desarrollo

Requisitos

• PHP 8.2+
• Node.js 20+
• MySQL 8.0+ o MariaDB 11+
• WordPress 6.4+

Setup Local

1. Clonar repositorio

   git clone https://github.com/tu-usuario/padelpress-manager.git
   cd padelpress-manager

2. Instalar dependencias PHP

   composer install

3. Instalar dependencias JavaScript

   npm install

4. Compilar assets

   npm run dev        # Para desarrollo
   # o
   npm run build      # Para producción

5. Activar plugin en WordPress

   • Ve a Plugins → Installed Plugins
   • Busca "PadelPress Manager"
   • Click "Activate"

6. Configurar

   • Ve a PadelPress → Settings
   • Configura Stripe keys (test/live)
   • Añade información del club

Ver SETUP-GUIDE.md para instrucciones detalladas.

📚 Documentación

Backlog y Planificación

• 📋 Índice de Documentación - EMPIEZA AQUÍ
• 🎯 MVP Mínimo
• 📈 Épicas y Roadmap
• 👥 Historias de Usuario

Especificaciones Técnicas

• TS-001.1: Vista Calendario Semanal
• TS-001.2: Crear Reserva Rápida
• TS-002.5: Algoritmo Glicko2
• TS-003.1: CRUD Pistas
• TS-005.3: Cobro en Efectivo

Arquitectura

• 🏗️ Arquitectura Técnica

🧪 Testing

# Backend tests
composer test

# Frontend tests
npm test

# Coverage
composer test-coverage
npm run test:coverage

🎯 Próximos Pasos

Ver ROADMAP.md para el plan de lanzamiento y versiones futuras.

🤝 Contribuyendo

1. Crea un fork del proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a tu rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

Ver CONTRIBUTING.md para detalles.

📄 Licencia

Este proyecto está licenciado bajo GPL v3 - ver archivo LICENSE para detalles.

👥 Equipo

• Product Owner: [Tu Nombre]
• Tech Lead: [Nombre]
• Backend Developer: [Nombre]
• Frontend Developer: [Nombre]

📞 Soporte

• Email: support@padelpress.com
• Issues: GitHub Issues
• Docs: Wiki

---

(back to top)

---

PadelPress Manager - La alternativa open-source para la gestión de clubes deportivos 🇪🇸