Preparación del Entorno de Desarrollo

node --version      # Debe ser v24.x (CI)
npm --version       # Debe ser 9.x o superior
git --version
psql --version      # Debe ser PostgreSQL 14+

git clone --branch develop git@github.com:cortex-ia-com-co/unosportclub.git
cd unosportclub

# Instalar dependencias del proyecto principal
npm install

# Instalar dependencias de Functions
cd functions
npm install
cd ..

sudo dnf install postgresql postgresql-server postgresql-contrib
sudo postgresql-setup --initdb
sudo systemctl enable postgresql
sudo systemctl start postgresql

sudo apt update
sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresql
sudo systemctl enable postgresql

brew install postgresql@14
brew services start postgresql@14

# Obtener la ruta del archivo de configuración
sudo -u postgres psql -t -c "SHOW hba_file;"

# Hacer backup del archivo
sudo cp /var/lib/pgsql/data/pg_hba.conf /var/lib/pgsql/data/pg_hba.conf.backup

# Cambiar ident por md5 para conexiones locales
sudo sed -i 's/^host.*all.*all.*127.0.0.1\/32.*ident$/host    all             all             127.0.0.1\/32            md5/' /var/lib/pgsql/data/pg_hba.conf
sudo sed -i 's/^host.*all.*all.*::1\/128.*ident$/host    all             all             ::1\/128                 md5/' /var/lib/pgsql/data/pg_hba.conf

# Recargar PostgreSQL
sudo systemctl reload postgresql

# Conectar como usuario postgres
sudo -u postgres psql

# Crear usuario con contraseña
CREATE USER unosportclub WITH PASSWORD 'unosportclub_password';

# Crear bases de datos (desarrollo y test)
CREATE DATABASE unosportclub OWNER unosportclub;
CREATE DATABASE unosportclub_test OWNER unosportclub;

# Otorgar permisos
GRANT ALL PRIVILEGES ON DATABASE unosportclub TO unosportclub;
GRANT ALL PRIVILEGES ON DATABASE unosportclub_test TO unosportclub;

# Salir
\q

# Fedora/RHEL: Instalar paquete contrib
sudo dnf install postgresql-contrib

# Crear extensión en ambas bases de datos
sudo -u postgres psql -d unosportclub -c "CREATE EXTENSION IF NOT EXISTS btree_gist;"
sudo -u postgres psql -d unosportclub_test -c "CREATE EXTENSION IF NOT EXISTS btree_gist;"

cd functions
cp .env.example .env

# Base de datos de desarrollo
DB_HOST=localhost
DB_PORT=5432
DB_NAME=unosportclub
DB_USER=unosportclub
DB_PASSWORD=unosportclub_password

# Base de datos de test
DB_TEST_HOST=localhost
DB_TEST_PORT=5432
DB_TEST_NAME=unosportclub_test
DB_TEST_USER=unosportclub
DB_TEST_PASSWORD=unosportclub_password

# SSL (false para desarrollo local)
DB_SSL=false

# Alternativa: Usar DATABASE_URL
# DATABASE_URL=postgresql://unosportclub:unosportclub_password@localhost:5432/unosportclub
# DATABASE_TEST_URL=postgresql://unosportclub:unosportclub_password@localhost:5432/unosportclub_test

# Desde la raíz del proyecto
npm run db:migrate

# Verificar conexión
PGPASSWORD=unosportclub_password psql -h localhost -U unosportclub -d unosportclub -c "SELECT version();"

# Ver tablas creadas
PGPASSWORD=unosportclub_password psql -h localhost -U unosportclub -d unosportclub -c "\dt"

# O usando el script de prueba del proyecto
npm run db:test

MCP_OAUTH_CLIENT_ID=unosport-mcp
MCP_OAUTH_REDIRECT_URIS=http://localhost:*,http://localhost:*/callback,https://vscode.dev/redirect
UNOSPORT_PANEL_URL=http://localhost:6101

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  },
  "typescript.preferences.importModuleSpecifier": "relative",
  "files.exclude": {
    "**/.git": true,
    "**/.DS_Store": true,
    "**/node_modules": true,
    "**/dist": true
  },
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/.angular": true
  }
}

unosportclub/
├── src/                    # App cliente (6100)
├── projects/
│   ├── panel/              # Panel operador (6101)
│   ├── trainer/            # Panel entrenador (6102)
│   ├── sudo/               # Panel sudo (6103)
│   ├── accounting/         # Contabilidad NIIF (6104)
│   └── common/             # @cortex-ia-com-co/common
├── functions/              # API Express (6000)
│   ├── server.js
│   ├── routes/
│   ├── db/
│   └── utils/
├── docs/                   # Antora
├── docker/                 # Imagen unificada
└── Dockerfile

npm run dev:serve          # API + 5 SPAs (recomendado)
npm start                  # Solo app cliente
npm run start:panel        # Solo panel
npm test                   # Suite completa (common + functions + Angular)
npm run build:production:all
npm run db:migrate         # Migraciones + seeders

cd functions

# Desarrollo
node server.js            # API en :6000 (o server_wrapper.js con --watch)
npm run lint              # Verificar código con ESLint

# Testing
npm test                  # Ejecutar tests
npm run test:watch        # Tests en modo watch
npm run test:coverage     # Tests con cobertura

# Base de datos
DATABASE_URL=postgresql://usuario:password@host:puerto/database

# Redis (opcional, para escalado horizontal del Relay)
REDIS_URL=redis://localhost:6379

# Sistema Relay (opcional)
REALTIME_ENABLED=true

# Puerto del servidor (opcional, default: 6000)
PORT=6000

AWS_ACCESS_KEY_ID=your-key-id
AWS_SECRET_ACCESS_KEY=your-secret-access-key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-bucket-name
AWS_ENDPOINT=https://your-account.r2.cloudflarestorage.com
AWS_USE_PATH_STYLE_ENDPOINT=true
AWS_PUBLIC_BASE_URL=

cd functions
node server.js

cd functions
pm2 start server.js --name unosportclub-api
pm2 logs unosportclub-api

git checkout -b feature/nombre-de-la-feature

# Terminal 1: Servidor Angular
npm start

# Terminal 2: Servidor Backend (Express)
cd functions
node server.js

# Terminal 3: Base de datos (si es necesario)
psql -U unosportclub -d unosportclub

# Opcional: Redis (si usas escalado horizontal del Relay)
redis-server

# Tests de Angular
npm test

# Tests de Functions
cd functions
npm test

# Lint de Functions
cd functions
npm run lint

# Build para verificar errores de TypeScript
npm run build

git add .
git commit -m "feat: descripción del cambio"
git push origin feature/nombre-de-la-feature

# Encontrar proceso usando el puerto
lsof -i :4200
lsof -i :6000

# Matar el proceso
kill -9 <PID>

# O cambiar el puerto del backend
cd functions
PORT=3001 node server.js

# Ejecutar manualmente
npm run db:migrate

# Ver estado de migraciones
psql -U unosportclub -d unosportclub -c "SELECT * FROM schema_migrations;"

# Limpiar cache
rm -rf node_modules .angular dist
npm install
npm run build