docs: add comprehensive documentation
- Add README.md with project overview, features, quick start guide, project structure, environment variables, and scripts - Add docs/API.md with complete API reference for all endpoints - Add docs/DEPLOYMENT.md with production deployment guide covering PM2, Nginx, SSL, and Docker options - Add docker-compose.yml for containerized deployment - Add Dockerfile with multi-stage build for optimized production image - Add .dockerignore for efficient Docker builds Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Ivan
44
.dockerignore
Normal file
44
.dockerignore
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
# Dependencies
|
||||||
|
node_modules
|
||||||
|
**/node_modules
|
||||||
|
|
||||||
|
# Build outputs
|
||||||
|
.next
|
||||||
|
**/dist
|
||||||
|
**/.turbo
|
||||||
|
|
||||||
|
# Development files
|
||||||
|
.env
|
||||||
|
.env.local
|
||||||
|
.env.*.local
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
|
||||||
|
# IDE
|
||||||
|
.vscode
|
||||||
|
.idea
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
|
||||||
|
# Git
|
||||||
|
.git
|
||||||
|
.gitignore
|
||||||
|
|
||||||
|
# Docker
|
||||||
|
Dockerfile
|
||||||
|
docker-compose*.yml
|
||||||
|
.dockerignore
|
||||||
|
|
||||||
|
# Documentation (not needed in image)
|
||||||
|
docs
|
||||||
|
*.md
|
||||||
|
!README.md
|
||||||
|
|
||||||
|
# Tests
|
||||||
|
**/*.test.*
|
||||||
|
**/*.spec.*
|
||||||
|
coverage
|
||||||
|
|
||||||
|
# Misc
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
86
Dockerfile
Normal file
86
Dockerfile
Normal file
@@ -0,0 +1,86 @@
|
|||||||
|
# Dockerfile para Padel Pro
|
||||||
|
# Multi-stage build para optimizar el tamano de la imagen
|
||||||
|
|
||||||
|
# ============================================
|
||||||
|
# Stage 1: Dependencias
|
||||||
|
# ============================================
|
||||||
|
FROM node:20-alpine AS deps
|
||||||
|
RUN apk add --no-cache libc6-compat
|
||||||
|
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
|
# Instalar pnpm
|
||||||
|
RUN corepack enable && corepack prepare pnpm@8.15.0 --activate
|
||||||
|
|
||||||
|
# Copiar archivos de configuracion de dependencias
|
||||||
|
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
|
||||||
|
COPY apps/web/package.json ./apps/web/
|
||||||
|
COPY packages/shared/package.json ./packages/shared/
|
||||||
|
|
||||||
|
# Instalar dependencias
|
||||||
|
RUN pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
# ============================================
|
||||||
|
# Stage 2: Builder
|
||||||
|
# ============================================
|
||||||
|
FROM node:20-alpine AS builder
|
||||||
|
RUN apk add --no-cache libc6-compat
|
||||||
|
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
|
# Instalar pnpm
|
||||||
|
RUN corepack enable && corepack prepare pnpm@8.15.0 --activate
|
||||||
|
|
||||||
|
# Copiar dependencias instaladas
|
||||||
|
COPY --from=deps /app/node_modules ./node_modules
|
||||||
|
COPY --from=deps /app/apps/web/node_modules ./apps/web/node_modules
|
||||||
|
COPY --from=deps /app/packages/shared/node_modules ./packages/shared/node_modules
|
||||||
|
|
||||||
|
# Copiar codigo fuente
|
||||||
|
COPY . .
|
||||||
|
|
||||||
|
# Generar cliente Prisma
|
||||||
|
RUN cd apps/web && pnpm db:generate
|
||||||
|
|
||||||
|
# Construir la aplicacion
|
||||||
|
ENV NEXT_TELEMETRY_DISABLED 1
|
||||||
|
RUN pnpm build
|
||||||
|
|
||||||
|
# ============================================
|
||||||
|
# Stage 3: Runner (Produccion)
|
||||||
|
# ============================================
|
||||||
|
FROM node:20-alpine AS runner
|
||||||
|
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
|
# Configurar entorno de produccion
|
||||||
|
ENV NODE_ENV production
|
||||||
|
ENV NEXT_TELEMETRY_DISABLED 1
|
||||||
|
|
||||||
|
# Crear usuario no-root
|
||||||
|
RUN addgroup --system --gid 1001 nodejs
|
||||||
|
RUN adduser --system --uid 1001 nextjs
|
||||||
|
|
||||||
|
# Copiar archivos necesarios para produccion
|
||||||
|
COPY --from=builder /app/apps/web/public ./apps/web/public
|
||||||
|
|
||||||
|
# Copiar archivos de Next.js standalone
|
||||||
|
COPY --from=builder --chown=nextjs:nodejs /app/apps/web/.next/standalone ./
|
||||||
|
COPY --from=builder --chown=nextjs:nodejs /app/apps/web/.next/static ./apps/web/.next/static
|
||||||
|
|
||||||
|
# Copiar schema de Prisma para migraciones
|
||||||
|
COPY --from=builder /app/apps/web/prisma ./apps/web/prisma
|
||||||
|
COPY --from=builder /app/apps/web/node_modules/.prisma ./apps/web/node_modules/.prisma
|
||||||
|
COPY --from=builder /app/apps/web/node_modules/@prisma ./apps/web/node_modules/@prisma
|
||||||
|
|
||||||
|
# Cambiar a usuario no-root
|
||||||
|
USER nextjs
|
||||||
|
|
||||||
|
# Exponer puerto
|
||||||
|
EXPOSE 3000
|
||||||
|
|
||||||
|
ENV PORT 3000
|
||||||
|
ENV HOSTNAME "0.0.0.0"
|
||||||
|
|
||||||
|
# Comando de inicio
|
||||||
|
CMD ["node", "apps/web/server.js"]
|
||||||
276
README.md
Normal file
276
README.md
Normal file
@@ -0,0 +1,276 @@
|
|||||||
|
# Padel Pro
|
||||||
|
|
||||||
|
Sistema integral de gestion para clubes de padel. Una solucion moderna y completa para administrar reservas, ventas, torneos, membresias y multiples sedes.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Caracteristicas Principales
|
||||||
|
|
||||||
|
### Sistema de Reservas
|
||||||
|
- Calendario visual con vista diaria/semanal
|
||||||
|
- Gestion de disponibilidad por cancha
|
||||||
|
- Precios dinamicos (horario regular vs premium)
|
||||||
|
- Integracion automatica con membresias
|
||||||
|
- Reservas recurrentes
|
||||||
|
|
||||||
|
### Punto de Venta (POS)
|
||||||
|
- Gestion de productos y categorias
|
||||||
|
- Control de inventario con alertas de stock bajo
|
||||||
|
- Multiples metodos de pago
|
||||||
|
- Caja registradora con apertura/cierre
|
||||||
|
- Historial de ventas detallado
|
||||||
|
|
||||||
|
### Torneos
|
||||||
|
- Formatos: Eliminacion simple/doble, Round Robin, Liga
|
||||||
|
- Inscripciones online
|
||||||
|
- Generacion automatica de brackets
|
||||||
|
- Seguimiento de partidos y resultados
|
||||||
|
|
||||||
|
### Membresias
|
||||||
|
- Planes personalizables
|
||||||
|
- Horas de cancha incluidas
|
||||||
|
- Descuentos en reservas y tienda
|
||||||
|
- Renovacion automatica opcional
|
||||||
|
- Alertas de vencimiento
|
||||||
|
|
||||||
|
### Multi-Sede
|
||||||
|
- Gestion centralizada de multiples ubicaciones
|
||||||
|
- Usuarios con acceso por sede
|
||||||
|
- Reportes por sede o consolidados
|
||||||
|
- Configuracion independiente por sede
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Capturas de Pantalla
|
||||||
|
|
||||||
|
<!-- TODO: Agregar capturas de pantalla del sistema -->
|
||||||
|
```
|
||||||
|
[Dashboard] [Reservas] [POS]
|
||||||
|
[Torneos] [Membresias] [Clientes]
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Inicio Rapido
|
||||||
|
|
||||||
|
### Requisitos Previos
|
||||||
|
|
||||||
|
- Node.js 20.x o superior
|
||||||
|
- PostgreSQL 16.x
|
||||||
|
- pnpm 8.15.0 o superior
|
||||||
|
|
||||||
|
### Instalacion
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clonar el repositorio
|
||||||
|
git clone https://github.com/tu-organizacion/padel-pro.git
|
||||||
|
cd padel-pro
|
||||||
|
|
||||||
|
# Instalar dependencias
|
||||||
|
pnpm install
|
||||||
|
|
||||||
|
# Configurar variables de entorno
|
||||||
|
cp apps/web/.env.example apps/web/.env
|
||||||
|
# Editar .env con tus credenciales
|
||||||
|
|
||||||
|
# Generar cliente Prisma
|
||||||
|
pnpm db:generate
|
||||||
|
|
||||||
|
# Crear tablas en la base de datos
|
||||||
|
pnpm db:push
|
||||||
|
|
||||||
|
# Sembrar datos iniciales (opcional)
|
||||||
|
cd apps/web && pnpm db:seed && cd ../..
|
||||||
|
|
||||||
|
# Iniciar en modo desarrollo
|
||||||
|
pnpm dev
|
||||||
|
```
|
||||||
|
|
||||||
|
La aplicacion estara disponible en `http://localhost:3000`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Estructura del Proyecto
|
||||||
|
|
||||||
|
```
|
||||||
|
padel-pro/
|
||||||
|
├── apps/
|
||||||
|
│ └── web/ # Aplicacion Next.js principal
|
||||||
|
│ ├── app/
|
||||||
|
│ │ ├── api/ # API Routes
|
||||||
|
│ │ │ ├── auth/ # Autenticacion (NextAuth)
|
||||||
|
│ │ │ ├── bookings/ # Reservas
|
||||||
|
│ │ │ ├── cash-register/ # Caja registradora
|
||||||
|
│ │ │ ├── clients/ # Clientes
|
||||||
|
│ │ │ ├── courts/ # Canchas
|
||||||
|
│ │ │ ├── dashboard/ # Estadisticas
|
||||||
|
│ │ │ ├── membership-plans/ # Planes de membresia
|
||||||
|
│ │ │ ├── memberships/# Membresias
|
||||||
|
│ │ │ ├── products/ # Productos
|
||||||
|
│ │ │ ├── sales/ # Ventas
|
||||||
|
│ │ │ ├── sites/ # Sedes
|
||||||
|
│ │ │ └── tournaments/# Torneos
|
||||||
|
│ │ └── (admin)/ # Paginas del panel de administracion
|
||||||
|
│ ├── components/ # Componentes React reutilizables
|
||||||
|
│ ├── lib/ # Utilidades y configuraciones
|
||||||
|
│ ├── prisma/ # Schema y migraciones
|
||||||
|
│ └── types/ # Definiciones de tipos TypeScript
|
||||||
|
├── packages/
|
||||||
|
│ └── shared/ # Codigo compartido (tipos, validaciones)
|
||||||
|
├── docs/ # Documentacion
|
||||||
|
├── package.json
|
||||||
|
├── pnpm-workspace.yaml
|
||||||
|
└── turbo.json
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Variables de Entorno
|
||||||
|
|
||||||
|
Crear un archivo `.env` en `apps/web/` con las siguientes variables:
|
||||||
|
|
||||||
|
```env
|
||||||
|
# Base de datos
|
||||||
|
DATABASE_URL="postgresql://usuario:password@localhost:5432/padel_pro?schema=public"
|
||||||
|
|
||||||
|
# NextAuth
|
||||||
|
NEXTAUTH_SECRET="tu-clave-secreta-aqui"
|
||||||
|
NEXTAUTH_URL="http://localhost:3000"
|
||||||
|
|
||||||
|
# Aplicacion
|
||||||
|
NEXT_PUBLIC_APP_URL="http://localhost:3000"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Variables Requeridas
|
||||||
|
|
||||||
|
| Variable | Descripcion | Ejemplo |
|
||||||
|
|----------|-------------|---------|
|
||||||
|
| `DATABASE_URL` | URL de conexion a PostgreSQL | `postgresql://user:pass@localhost:5432/db` |
|
||||||
|
| `NEXTAUTH_SECRET` | Clave secreta para JWT (min 32 caracteres) | Generar con `openssl rand -base64 32` |
|
||||||
|
| `NEXTAUTH_URL` | URL base de la aplicacion | `http://localhost:3000` |
|
||||||
|
| `NEXT_PUBLIC_APP_URL` | URL publica de la aplicacion | `http://localhost:3000` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Scripts Disponibles
|
||||||
|
|
||||||
|
### Desarrollo
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm dev # Iniciar servidor de desarrollo
|
||||||
|
pnpm build # Construir para produccion
|
||||||
|
pnpm lint # Ejecutar ESLint
|
||||||
|
pnpm type-check # Verificar tipos TypeScript
|
||||||
|
```
|
||||||
|
|
||||||
|
### Base de Datos
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm db:generate # Generar cliente Prisma
|
||||||
|
pnpm db:push # Sincronizar schema con DB
|
||||||
|
pnpm db:studio # Abrir Prisma Studio (UI para DB)
|
||||||
|
pnpm db:seed # Sembrar datos iniciales
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Resumen de API
|
||||||
|
|
||||||
|
La API REST sigue convenciones estandar. Todas las rutas requieren autenticacion excepto las indicadas.
|
||||||
|
|
||||||
|
### Endpoints Principales
|
||||||
|
|
||||||
|
| Recurso | Ruta Base | Descripcion |
|
||||||
|
|---------|-----------|-------------|
|
||||||
|
| Auth | `/api/auth/*` | Autenticacion NextAuth |
|
||||||
|
| Courts | `/api/courts` | Gestion de canchas |
|
||||||
|
| Bookings | `/api/bookings` | Reservas |
|
||||||
|
| Clients | `/api/clients` | Clientes |
|
||||||
|
| Products | `/api/products` | Productos del POS |
|
||||||
|
| Sales | `/api/sales` | Ventas |
|
||||||
|
| Cash Register | `/api/cash-register` | Caja registradora |
|
||||||
|
| Tournaments | `/api/tournaments` | Torneos |
|
||||||
|
| Memberships | `/api/memberships` | Membresias |
|
||||||
|
| Membership Plans | `/api/membership-plans` | Planes de membresia |
|
||||||
|
| Sites | `/api/sites` | Sedes |
|
||||||
|
| Dashboard | `/api/dashboard/stats` | Estadisticas |
|
||||||
|
|
||||||
|
Ver documentacion completa en [docs/API.md](docs/API.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Credenciales por Defecto
|
||||||
|
|
||||||
|
Despues de ejecutar el seed, puedes acceder con:
|
||||||
|
|
||||||
|
| Usuario | Password | Rol |
|
||||||
|
|---------|----------|-----|
|
||||||
|
| `admin@padelpro.com` | `admin123` | Super Admin |
|
||||||
|
| `recepcion@padelpro.com` | `recepcion123` | Recepcionista |
|
||||||
|
|
||||||
|
> **IMPORTANTE:** Cambiar estas credenciales inmediatamente en entornos de produccion.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Contribuir
|
||||||
|
|
||||||
|
1. Fork el repositorio
|
||||||
|
2. Crear una rama para tu feature (`git checkout -b feature/nueva-funcionalidad`)
|
||||||
|
3. Commit tus cambios (`git commit -m 'feat: agregar nueva funcionalidad'`)
|
||||||
|
4. Push a la rama (`git push origin feature/nueva-funcionalidad`)
|
||||||
|
5. Abrir un Pull Request
|
||||||
|
|
||||||
|
### Convenciones de Commits
|
||||||
|
|
||||||
|
Usamos [Conventional Commits](https://www.conventionalcommits.org/):
|
||||||
|
|
||||||
|
- `feat:` Nueva funcionalidad
|
||||||
|
- `fix:` Correccion de bug
|
||||||
|
- `docs:` Cambios en documentacion
|
||||||
|
- `style:` Cambios de formato (no afectan codigo)
|
||||||
|
- `refactor:` Refactorizacion de codigo
|
||||||
|
- `test:` Agregar o modificar tests
|
||||||
|
- `chore:` Tareas de mantenimiento
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Documentacion Adicional
|
||||||
|
|
||||||
|
- [API Reference](docs/API.md) - Documentacion completa de endpoints
|
||||||
|
- [Deployment Guide](docs/DEPLOYMENT.md) - Guia de despliegue
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Licencia
|
||||||
|
|
||||||
|
Este proyecto esta bajo la Licencia MIT. Ver el archivo [LICENSE](LICENSE) para mas detalles.
|
||||||
|
|
||||||
|
```
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2024 Padel Pro
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
|
```
|
||||||
61
docker-compose.yml
Normal file
61
docker-compose.yml
Normal file
@@ -0,0 +1,61 @@
|
|||||||
|
version: '3.8'
|
||||||
|
|
||||||
|
services:
|
||||||
|
# Base de datos PostgreSQL
|
||||||
|
db:
|
||||||
|
image: postgres:16-alpine
|
||||||
|
container_name: padel-pro-db
|
||||||
|
restart: unless-stopped
|
||||||
|
environment:
|
||||||
|
POSTGRES_USER: ${POSTGRES_USER:-padel_user}
|
||||||
|
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-padel_password}
|
||||||
|
POSTGRES_DB: ${POSTGRES_DB:-padel_pro}
|
||||||
|
volumes:
|
||||||
|
- postgres_data:/var/lib/postgresql/data
|
||||||
|
- ./scripts/init-db.sql:/docker-entrypoint-initdb.d/init.sql:ro
|
||||||
|
ports:
|
||||||
|
- "5432:5432"
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-padel_user} -d ${POSTGRES_DB:-padel_pro}"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 5s
|
||||||
|
retries: 5
|
||||||
|
networks:
|
||||||
|
- padel-network
|
||||||
|
|
||||||
|
# Aplicacion Web Next.js
|
||||||
|
web:
|
||||||
|
build:
|
||||||
|
context: .
|
||||||
|
dockerfile: Dockerfile
|
||||||
|
container_name: padel-pro-web
|
||||||
|
restart: unless-stopped
|
||||||
|
depends_on:
|
||||||
|
db:
|
||||||
|
condition: service_healthy
|
||||||
|
environment:
|
||||||
|
NODE_ENV: production
|
||||||
|
DATABASE_URL: postgresql://${POSTGRES_USER:-padel_user}:${POSTGRES_PASSWORD:-padel_password}@db:5432/${POSTGRES_DB:-padel_pro}?schema=public
|
||||||
|
NEXTAUTH_SECRET: ${NEXTAUTH_SECRET}
|
||||||
|
NEXTAUTH_URL: ${NEXTAUTH_URL:-http://localhost:3000}
|
||||||
|
NEXT_PUBLIC_APP_URL: ${NEXT_PUBLIC_APP_URL:-http://localhost:3000}
|
||||||
|
ports:
|
||||||
|
- "3000:3000"
|
||||||
|
volumes:
|
||||||
|
- ./apps/web/public:/app/apps/web/public:ro
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "curl", "-f", "http://localhost:3000/api/auth/session"]
|
||||||
|
interval: 30s
|
||||||
|
timeout: 10s
|
||||||
|
retries: 3
|
||||||
|
start_period: 40s
|
||||||
|
networks:
|
||||||
|
- padel-network
|
||||||
|
|
||||||
|
networks:
|
||||||
|
padel-network:
|
||||||
|
driver: bridge
|
||||||
|
|
||||||
|
volumes:
|
||||||
|
postgres_data:
|
||||||
|
driver: local
|
||||||
1271
docs/API.md
Normal file
1271
docs/API.md
Normal file
File diff suppressed because it is too large
Load Diff
663
docs/DEPLOYMENT.md
Normal file
663
docs/DEPLOYMENT.md
Normal file
@@ -0,0 +1,663 @@
|
|||||||
|
# Guia de Despliegue - Padel Pro
|
||||||
|
|
||||||
|
Esta guia cubre el proceso completo para desplegar Padel Pro en un entorno de produccion.
|
||||||
|
|
||||||
|
## Tabla de Contenidos
|
||||||
|
|
||||||
|
1. [Requisitos Previos](#requisitos-previos)
|
||||||
|
2. [Configuracion del Entorno](#configuracion-del-entorno)
|
||||||
|
3. [Configuracion de Base de Datos](#configuracion-de-base-de-datos)
|
||||||
|
4. [Despliegue con PM2](#despliegue-con-pm2)
|
||||||
|
5. [Configuracion de Nginx](#configuracion-de-nginx)
|
||||||
|
6. [SSL con Lets Encrypt](#ssl-con-lets-encrypt)
|
||||||
|
7. [Despliegue con Docker](#despliegue-con-docker)
|
||||||
|
8. [Monitoreo y Mantenimiento](#monitoreo-y-mantenimiento)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Requisitos Previos
|
||||||
|
|
||||||
|
### Software Requerido
|
||||||
|
|
||||||
|
| Software | Version | Proposito |
|
||||||
|
|----------|---------|-----------|
|
||||||
|
| Node.js | 20.x LTS | Runtime de JavaScript |
|
||||||
|
| PostgreSQL | 16.x | Base de datos |
|
||||||
|
| pnpm | 8.15.0+ | Gestor de paquetes |
|
||||||
|
| Git | 2.x | Control de versiones |
|
||||||
|
| Nginx | 1.24+ | Servidor web / Proxy inverso |
|
||||||
|
| PM2 | 5.x | Gestor de procesos (opcional) |
|
||||||
|
| Docker | 24.x | Contenedores (opcional) |
|
||||||
|
|
||||||
|
### Recursos del Servidor
|
||||||
|
|
||||||
|
**Minimos:**
|
||||||
|
- CPU: 2 cores
|
||||||
|
- RAM: 4 GB
|
||||||
|
- Disco: 20 GB SSD
|
||||||
|
|
||||||
|
**Recomendados:**
|
||||||
|
- CPU: 4 cores
|
||||||
|
- RAM: 8 GB
|
||||||
|
- Disco: 50 GB SSD
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuracion del Entorno
|
||||||
|
|
||||||
|
### 1. Instalar Node.js 20
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Usando nvm (recomendado)
|
||||||
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
|
||||||
|
source ~/.bashrc
|
||||||
|
nvm install 20
|
||||||
|
nvm use 20
|
||||||
|
nvm alias default 20
|
||||||
|
|
||||||
|
# Verificar instalacion
|
||||||
|
node --version # v20.x.x
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Instalar pnpm
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g pnpm
|
||||||
|
pnpm --version # 8.x.x
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Clonar el Repositorio
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /var/www
|
||||||
|
git clone https://github.com/tu-organizacion/padel-pro.git
|
||||||
|
cd padel-pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Configurar Variables de Entorno
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp apps/web/.env.example apps/web/.env
|
||||||
|
```
|
||||||
|
|
||||||
|
Editar el archivo `.env`:
|
||||||
|
|
||||||
|
```env
|
||||||
|
# Base de datos - Produccion
|
||||||
|
DATABASE_URL="postgresql://padel_user:PASSWORD_SEGURO@localhost:5432/padel_pro?schema=public"
|
||||||
|
|
||||||
|
# NextAuth - IMPORTANTE: Generar clave unica
|
||||||
|
NEXTAUTH_SECRET="$(openssl rand -base64 32)"
|
||||||
|
NEXTAUTH_URL="https://tudominio.com"
|
||||||
|
|
||||||
|
# Aplicacion
|
||||||
|
NEXT_PUBLIC_APP_URL="https://tudominio.com"
|
||||||
|
NODE_ENV="production"
|
||||||
|
```
|
||||||
|
|
||||||
|
> **IMPORTANTE:** Nunca usar las credenciales de ejemplo en produccion. Generar una clave secreta unica con `openssl rand -base64 32`.
|
||||||
|
|
||||||
|
### 5. Instalar Dependencias
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install --frozen-lockfile
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. Construir la Aplicacion
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm build
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuracion de Base de Datos
|
||||||
|
|
||||||
|
### 1. Instalar PostgreSQL 16
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Ubuntu/Debian
|
||||||
|
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
|
||||||
|
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
|
||||||
|
sudo apt update
|
||||||
|
sudo apt install postgresql-16
|
||||||
|
|
||||||
|
# Iniciar servicio
|
||||||
|
sudo systemctl start postgresql
|
||||||
|
sudo systemctl enable postgresql
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Crear Base de Datos y Usuario
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo -u postgres psql
|
||||||
|
```
|
||||||
|
|
||||||
|
```sql
|
||||||
|
-- Crear usuario
|
||||||
|
CREATE USER padel_user WITH PASSWORD 'PASSWORD_SEGURO';
|
||||||
|
|
||||||
|
-- Crear base de datos
|
||||||
|
CREATE DATABASE padel_pro OWNER padel_user;
|
||||||
|
|
||||||
|
-- Otorgar permisos
|
||||||
|
GRANT ALL PRIVILEGES ON DATABASE padel_pro TO padel_user;
|
||||||
|
|
||||||
|
-- Salir
|
||||||
|
\q
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Configurar Conexion Remota (si es necesario)
|
||||||
|
|
||||||
|
Editar `/etc/postgresql/16/main/postgresql.conf`:
|
||||||
|
|
||||||
|
```conf
|
||||||
|
listen_addresses = 'localhost' # o '*' para conexiones remotas
|
||||||
|
```
|
||||||
|
|
||||||
|
Editar `/etc/postgresql/16/main/pg_hba.conf`:
|
||||||
|
|
||||||
|
```conf
|
||||||
|
# Conexion local
|
||||||
|
local all padel_user md5
|
||||||
|
|
||||||
|
# Conexion remota (si es necesario)
|
||||||
|
host padel_pro padel_user 192.168.1.0/24 md5
|
||||||
|
```
|
||||||
|
|
||||||
|
Reiniciar PostgreSQL:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo systemctl restart postgresql
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Ejecutar Migraciones
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /var/www/padel-pro
|
||||||
|
pnpm db:generate
|
||||||
|
pnpm db:push
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Sembrar Datos Iniciales (Opcional)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd apps/web
|
||||||
|
pnpm db:seed
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Despliegue con PM2
|
||||||
|
|
||||||
|
### 1. Instalar PM2
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g pm2
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Crear Archivo de Configuracion
|
||||||
|
|
||||||
|
Crear `ecosystem.config.js` en la raiz del proyecto:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
module.exports = {
|
||||||
|
apps: [
|
||||||
|
{
|
||||||
|
name: 'padel-pro',
|
||||||
|
cwd: '/var/www/padel-pro/apps/web',
|
||||||
|
script: 'node_modules/next/dist/bin/next',
|
||||||
|
args: 'start',
|
||||||
|
instances: 'max',
|
||||||
|
exec_mode: 'cluster',
|
||||||
|
env: {
|
||||||
|
NODE_ENV: 'production',
|
||||||
|
PORT: 3000
|
||||||
|
},
|
||||||
|
env_production: {
|
||||||
|
NODE_ENV: 'production',
|
||||||
|
PORT: 3000
|
||||||
|
},
|
||||||
|
// Configuracion de logs
|
||||||
|
log_date_format: 'YYYY-MM-DD HH:mm:ss Z',
|
||||||
|
error_file: '/var/log/padel-pro/error.log',
|
||||||
|
out_file: '/var/log/padel-pro/out.log',
|
||||||
|
merge_logs: true,
|
||||||
|
// Reinicio automatico
|
||||||
|
max_memory_restart: '1G',
|
||||||
|
exp_backoff_restart_delay: 100
|
||||||
|
}
|
||||||
|
]
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Crear Directorio de Logs
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo mkdir -p /var/log/padel-pro
|
||||||
|
sudo chown $USER:$USER /var/log/padel-pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Iniciar la Aplicacion
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pm2 start ecosystem.config.js --env production
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Configurar Inicio Automatico
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pm2 startup
|
||||||
|
pm2 save
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. Comandos Utiles de PM2
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Ver estado
|
||||||
|
pm2 status
|
||||||
|
|
||||||
|
# Ver logs
|
||||||
|
pm2 logs padel-pro
|
||||||
|
|
||||||
|
# Reiniciar
|
||||||
|
pm2 restart padel-pro
|
||||||
|
|
||||||
|
# Recargar sin downtime
|
||||||
|
pm2 reload padel-pro
|
||||||
|
|
||||||
|
# Detener
|
||||||
|
pm2 stop padel-pro
|
||||||
|
|
||||||
|
# Monitoreo
|
||||||
|
pm2 monit
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuracion de Nginx
|
||||||
|
|
||||||
|
### 1. Instalar Nginx
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt install nginx
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Crear Configuracion del Sitio
|
||||||
|
|
||||||
|
Crear `/etc/nginx/sites-available/padel-pro`:
|
||||||
|
|
||||||
|
```nginx
|
||||||
|
# Redirigir HTTP a HTTPS
|
||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
listen [::]:80;
|
||||||
|
server_name tudominio.com www.tudominio.com;
|
||||||
|
|
||||||
|
location / {
|
||||||
|
return 301 https://$host$request_uri;
|
||||||
|
}
|
||||||
|
|
||||||
|
# Let's Encrypt challenge
|
||||||
|
location /.well-known/acme-challenge/ {
|
||||||
|
root /var/www/certbot;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Configuracion HTTPS
|
||||||
|
server {
|
||||||
|
listen 443 ssl http2;
|
||||||
|
listen [::]:443 ssl http2;
|
||||||
|
server_name tudominio.com www.tudominio.com;
|
||||||
|
|
||||||
|
# SSL (sera configurado por Certbot)
|
||||||
|
ssl_certificate /etc/letsencrypt/live/tudominio.com/fullchain.pem;
|
||||||
|
ssl_certificate_key /etc/letsencrypt/live/tudominio.com/privkey.pem;
|
||||||
|
ssl_session_timeout 1d;
|
||||||
|
ssl_session_cache shared:SSL:50m;
|
||||||
|
ssl_session_tickets off;
|
||||||
|
|
||||||
|
# Configuracion SSL moderna
|
||||||
|
ssl_protocols TLSv1.2 TLSv1.3;
|
||||||
|
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
|
||||||
|
ssl_prefer_server_ciphers off;
|
||||||
|
|
||||||
|
# HSTS
|
||||||
|
add_header Strict-Transport-Security "max-age=63072000" always;
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
access_log /var/log/nginx/padel-pro.access.log;
|
||||||
|
error_log /var/log/nginx/padel-pro.error.log;
|
||||||
|
|
||||||
|
# Tamano maximo de subida
|
||||||
|
client_max_body_size 10M;
|
||||||
|
|
||||||
|
# Gzip
|
||||||
|
gzip on;
|
||||||
|
gzip_vary on;
|
||||||
|
gzip_proxied any;
|
||||||
|
gzip_comp_level 6;
|
||||||
|
gzip_types text/plain text/css text/xml application/json application/javascript application/rss+xml application/atom+xml image/svg+xml;
|
||||||
|
|
||||||
|
# Proxy a Next.js
|
||||||
|
location / {
|
||||||
|
proxy_pass http://127.0.0.1:3000;
|
||||||
|
proxy_http_version 1.1;
|
||||||
|
proxy_set_header Upgrade $http_upgrade;
|
||||||
|
proxy_set_header Connection 'upgrade';
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Real-IP $remote_addr;
|
||||||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||||
|
proxy_set_header X-Forwarded-Proto $scheme;
|
||||||
|
proxy_cache_bypass $http_upgrade;
|
||||||
|
proxy_read_timeout 86400;
|
||||||
|
}
|
||||||
|
|
||||||
|
# Cache para assets estaticos
|
||||||
|
location /_next/static {
|
||||||
|
proxy_pass http://127.0.0.1:3000;
|
||||||
|
proxy_cache_valid 60m;
|
||||||
|
add_header Cache-Control "public, immutable";
|
||||||
|
}
|
||||||
|
|
||||||
|
# Archivos estaticos
|
||||||
|
location /static {
|
||||||
|
alias /var/www/padel-pro/apps/web/public;
|
||||||
|
expires 30d;
|
||||||
|
add_header Cache-Control "public, immutable";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Habilitar el Sitio
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ln -s /etc/nginx/sites-available/padel-pro /etc/nginx/sites-enabled/
|
||||||
|
|
||||||
|
# Verificar configuracion
|
||||||
|
sudo nginx -t
|
||||||
|
|
||||||
|
# Recargar Nginx
|
||||||
|
sudo systemctl reload nginx
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## SSL con Lets Encrypt
|
||||||
|
|
||||||
|
### 1. Instalar Certbot
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt install certbot python3-certbot-nginx
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Obtener Certificado
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo certbot --nginx -d tudominio.com -d www.tudominio.com
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Renovacion Automatica
|
||||||
|
|
||||||
|
Certbot configura automaticamente la renovacion. Verificar:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo certbot renew --dry-run
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Configurar Cron (si es necesario)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo crontab -e
|
||||||
|
```
|
||||||
|
|
||||||
|
Agregar:
|
||||||
|
|
||||||
|
```cron
|
||||||
|
0 12 * * * /usr/bin/certbot renew --quiet
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Despliegue con Docker
|
||||||
|
|
||||||
|
### 1. Archivo docker-compose.yml
|
||||||
|
|
||||||
|
El archivo `docker-compose.yml` ya esta incluido en el proyecto. Ubicado en `/root/Padel/docker-compose.yml`.
|
||||||
|
|
||||||
|
### 2. Configurar Variables
|
||||||
|
|
||||||
|
Crear `.env` en la raiz del proyecto:
|
||||||
|
|
||||||
|
```env
|
||||||
|
POSTGRES_USER=padel_user
|
||||||
|
POSTGRES_PASSWORD=PASSWORD_SEGURO
|
||||||
|
POSTGRES_DB=padel_pro
|
||||||
|
DATABASE_URL=postgresql://padel_user:PASSWORD_SEGURO@db:5432/padel_pro?schema=public
|
||||||
|
NEXTAUTH_SECRET=tu-clave-secreta-generada
|
||||||
|
NEXTAUTH_URL=https://tudominio.com
|
||||||
|
NEXT_PUBLIC_APP_URL=https://tudominio.com
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Construir e Iniciar
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Construir imagenes
|
||||||
|
docker compose build
|
||||||
|
|
||||||
|
# Iniciar servicios
|
||||||
|
docker compose up -d
|
||||||
|
|
||||||
|
# Ver logs
|
||||||
|
docker compose logs -f
|
||||||
|
|
||||||
|
# Ejecutar migraciones
|
||||||
|
docker compose exec web pnpm db:push
|
||||||
|
|
||||||
|
# Sembrar datos (opcional)
|
||||||
|
docker compose exec web pnpm db:seed
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Comandos Utiles
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Detener servicios
|
||||||
|
docker compose down
|
||||||
|
|
||||||
|
# Reiniciar
|
||||||
|
docker compose restart
|
||||||
|
|
||||||
|
# Ver estado
|
||||||
|
docker compose ps
|
||||||
|
|
||||||
|
# Acceder al contenedor
|
||||||
|
docker compose exec web sh
|
||||||
|
|
||||||
|
# Backup de base de datos
|
||||||
|
docker compose exec db pg_dump -U padel_user padel_pro > backup.sql
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Monitoreo y Mantenimiento
|
||||||
|
|
||||||
|
### Monitoreo con PM2
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Dashboard en tiempo real
|
||||||
|
pm2 monit
|
||||||
|
|
||||||
|
# Metricas web (opcional)
|
||||||
|
pm2 install pm2-server-monit
|
||||||
|
```
|
||||||
|
|
||||||
|
### Backup de Base de Datos
|
||||||
|
|
||||||
|
Crear script `/opt/scripts/backup-padel.sh`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
BACKUP_DIR="/var/backups/padel-pro"
|
||||||
|
DATE=$(date +%Y%m%d_%H%M%S)
|
||||||
|
FILENAME="padel_pro_$DATE.sql.gz"
|
||||||
|
|
||||||
|
mkdir -p $BACKUP_DIR
|
||||||
|
|
||||||
|
# Crear backup
|
||||||
|
pg_dump -U padel_user padel_pro | gzip > "$BACKUP_DIR/$FILENAME"
|
||||||
|
|
||||||
|
# Eliminar backups antiguos (mantener 7 dias)
|
||||||
|
find $BACKUP_DIR -name "*.sql.gz" -mtime +7 -delete
|
||||||
|
|
||||||
|
echo "Backup completado: $FILENAME"
|
||||||
|
```
|
||||||
|
|
||||||
|
Configurar cron:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x /opt/scripts/backup-padel.sh
|
||||||
|
crontab -e
|
||||||
|
```
|
||||||
|
|
||||||
|
```cron
|
||||||
|
0 2 * * * /opt/scripts/backup-padel.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### Actualizaciones
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /var/www/padel-pro
|
||||||
|
|
||||||
|
# Obtener cambios
|
||||||
|
git pull origin main
|
||||||
|
|
||||||
|
# Instalar dependencias
|
||||||
|
pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
# Construir
|
||||||
|
pnpm build
|
||||||
|
|
||||||
|
# Ejecutar migraciones (si hay)
|
||||||
|
pnpm db:push
|
||||||
|
|
||||||
|
# Reiniciar aplicacion
|
||||||
|
pm2 reload padel-pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### Logs
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Logs de la aplicacion
|
||||||
|
pm2 logs padel-pro --lines 100
|
||||||
|
|
||||||
|
# Logs de Nginx
|
||||||
|
tail -f /var/log/nginx/padel-pro.error.log
|
||||||
|
|
||||||
|
# Logs de PostgreSQL
|
||||||
|
tail -f /var/log/postgresql/postgresql-16-main.log
|
||||||
|
```
|
||||||
|
|
||||||
|
### Health Check
|
||||||
|
|
||||||
|
Crear script `/opt/scripts/health-check.sh`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
HEALTH_URL="https://tudominio.com/api/health"
|
||||||
|
RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" $HEALTH_URL)
|
||||||
|
|
||||||
|
if [ $RESPONSE != "200" ]; then
|
||||||
|
echo "ERROR: Health check failed with status $RESPONSE"
|
||||||
|
# Enviar alerta (email, Slack, etc.)
|
||||||
|
pm2 restart padel-pro
|
||||||
|
fi
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Seguridad
|
||||||
|
|
||||||
|
### Firewall (UFW)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ufw allow ssh
|
||||||
|
sudo ufw allow 'Nginx Full'
|
||||||
|
sudo ufw enable
|
||||||
|
```
|
||||||
|
|
||||||
|
### Fail2ban
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt install fail2ban
|
||||||
|
sudo systemctl enable fail2ban
|
||||||
|
```
|
||||||
|
|
||||||
|
### Headers de Seguridad
|
||||||
|
|
||||||
|
Agregar a la configuracion de Nginx:
|
||||||
|
|
||||||
|
```nginx
|
||||||
|
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||||
|
add_header X-Content-Type-Options "nosniff" always;
|
||||||
|
add_header X-XSS-Protection "1; mode=block" always;
|
||||||
|
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Solucion de Problemas
|
||||||
|
|
||||||
|
### La aplicacion no inicia
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Verificar logs
|
||||||
|
pm2 logs padel-pro --err
|
||||||
|
|
||||||
|
# Verificar puertos
|
||||||
|
netstat -tlnp | grep 3000
|
||||||
|
|
||||||
|
# Verificar conexion a DB
|
||||||
|
psql -U padel_user -h localhost padel_pro -c "SELECT 1"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Error de conexion a base de datos
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Verificar servicio
|
||||||
|
sudo systemctl status postgresql
|
||||||
|
|
||||||
|
# Verificar logs
|
||||||
|
tail -f /var/log/postgresql/postgresql-16-main.log
|
||||||
|
|
||||||
|
# Probar conexion
|
||||||
|
psql "postgresql://padel_user:PASSWORD@localhost:5432/padel_pro"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Nginx devuelve 502
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Verificar que la app este corriendo
|
||||||
|
pm2 status
|
||||||
|
|
||||||
|
# Verificar configuracion
|
||||||
|
sudo nginx -t
|
||||||
|
|
||||||
|
# Ver logs
|
||||||
|
tail -f /var/log/nginx/padel-pro.error.log
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Checklist de Produccion
|
||||||
|
|
||||||
|
- [ ] Variables de entorno configuradas correctamente
|
||||||
|
- [ ] Base de datos con password seguro
|
||||||
|
- [ ] NEXTAUTH_SECRET generado de forma segura
|
||||||
|
- [ ] SSL/HTTPS configurado
|
||||||
|
- [ ] Firewall configurado
|
||||||
|
- [ ] Backups automaticos
|
||||||
|
- [ ] Monitoreo configurado
|
||||||
|
- [ ] Logs rotados
|
||||||
|
- [ ] Credenciales por defecto cambiadas
|
||||||
|
- [ ] Rate limiting configurado
|
||||||
|
- [ ] Health checks implementados
|
||||||
Reference in New Issue
Block a user