# 📚 Documentación - App Canchas de Pádel

Bienvenido a la documentación oficial de App Canchas de Pádel.

---

## 📖 Índice de Documentos

### 📘 Documentación Principal

| Documento | Descripción |
|-----------|-------------|
| [API.md](./API.md) | Documentación completa de la API REST con todos los endpoints, autenticación, y ejemplos |
| [SETUP.md](./SETUP.md) | Guía paso a paso para configurar el entorno de desarrollo |
| [DEPLOY.md](./DEPLOY.md) | Guía completa para deployar en producción (VPS, PM2, Nginx, SSL) |
| [ARCHITECTURE.md](./ARCHITECTURE.md) | Arquitectura del sistema, diagramas y patrones de diseño |

### 📱 Documentación Comercial

| Documento | Descripción |
|-----------|-------------|
| [APP_STORE.md](./APP_STORE.md) | Material para publicación en App Store y Google Play |

### 📋 Otros Documentos

| Documento | Descripción |
|-----------|-------------|
| [CHANGELOG.md](./CHANGELOG.md) | Historial de cambios y versiones |
| [postman-collection.json](./postman-collection.json) | Colección de Postman con todos los endpoints |

---

## 🚀 Empezar Rápidamente

### Para Desarrolladores

1. **Configurar entorno local:**
   ```bash
   # Ver guía completa en SETUP.md
   cd backend && npm install && npm run dev
   ```

2. **Explorar la API:**
   ```bash
   # Documentación en API.md
   # Importar postman-collection.json en Postman
   ```

3. **Entender la arquitectura:**
   ```bash
   # Leer ARCHITECTURE.md
   ```

### Para DevOps

1. **Deployar en producción:**
   ```bash
   # Ver guía completa en DEPLOY.md
   ./scripts/deploy.sh production
   ```

2. **Configurar monitoreo:**
   ```bash
   pm2 monit
   ```

---

## 📊 Resumen de la API

- **Base URL:** `https://api.tudominio.com/api/v1`
- **Autenticación:** JWT (JSON Web Tokens)
- **Formato:** JSON
- **Total Endpoints:** 150+

### Módulos Principales

| Módulo | Endpoints | Descripción |
|--------|-----------|-------------|
| Auth | 5 | Registro, login, tokens |
| Users | 6 | Gestión de usuarios |
| Courts | 6 | Canchas y disponibilidad |
| Bookings | 8 | Reservas de canchas |
| Matches | 5 | Registro de partidos |
| Tournaments | 11 | Torneos e inscripciones |
| Leagues | 12 | Ligas por equipos |
| Ranking | 5 | Sistema de rankings |
| Payments | 8 | Pagos con MercadoPago |
| Subscriptions | 14 | Suscripciones/membresías |
| Friends | 7 | Sistema social |
| Notifications | 7 | Notificaciones push |
| Analytics | 18 | Reportes y dashboard |
| Extras | 20+ | Logros, Wall of Fame, etc. |

---

## 🏗️ Stack Tecnológico

### Backend
- **Runtime:** Node.js 20.x
- **Framework:** Express.js 4.x
- **Lenguaje:** TypeScript 5.x
- **ORM:** Prisma 5.x
- **Base de Datos:** PostgreSQL 16.x
- **Autenticación:** JWT (jsonwebtoken)
- **Validación:** Zod
- **Logs:** Winston
- **Procesos:** PM2

### Frontend
- **Framework:** React 18.x
- **Build Tool:** Vite
- **Estilos:** Tailwind CSS

### Mobile
- **Framework:** React Native
- **Navigation:** React Navigation

### Infraestructura
- **Servidor:** Ubuntu 24.04 LTS
- **Web Server:** Nginx
- **SSL:** Let's Encrypt
- **Container:** Docker (opcional)

---

## 🔗 Enlaces Útiles

- **Repositorio:** https://github.com/tu-usuario/app-padel
- **API Documentation:** https://api.tudominio.com/api/v1/health
- **Status Page:** https://status.tudominio.com
- **Soporte:** soporte@tudominio.com

---

## 📞 Soporte

¿Necesitas ayuda?

1. Revisa la documentación específica del módulo
2. Consulta los ejemplos en [API.md](./API.md)
3. Contacta al equipo: soporte@tudominio.com

---

*Última actualización: Enero 2026*