# =============================================================================
# ENVIRONMENT-INVENTORY.yml - CLINICA-VETERINARIA
# =============================================================================
# Inventario Completo de Entorno de Desarrollo y Produccion
# Generado por: @PERFIL_DEVENV
# Basado en: orchestration/templates/TEMPLATE-ENVIRONMENT-INVENTORY.yml
# =============================================================================

version: "1.1.0"
fecha_creacion: "2026-01-04"
fecha_actualizacion: "2026-01-04"
responsable: "@PERFIL_DEVENV"

# -----------------------------------------------------------------------------
# IDENTIFICACION DEL PROYECTO
# -----------------------------------------------------------------------------

proyecto:
  nombre: "Clinica Veterinaria"
  alias: "clinica-veterinaria"
  codigo: "CV"
  nivel: "NIVEL_2B.3"
  tipo: "vertical-especializada"
  estado: "desarrollo"
  descripcion: "Sistema de gestion para clinicas veterinarias"
  parent: "erp-clinicas"
  herencia:
    - erp-core
    - erp-clinicas

# -----------------------------------------------------------------------------
# HERRAMIENTAS Y RUNTIME
# -----------------------------------------------------------------------------

herramientas:
  runtime:
    node:
      version: "20.x"
      version_minima: "18.x"
      requerido: true
      notas: "LTS recomendado para NestJS y React"
    python:
      version: ""
      requerido: false
      notas: "No requerido para este proyecto"

  package_managers:
    npm:
      version: "10.x"
      requerido: true
    pnpm:
      version: "8.x"
      requerido: false
      notas: "Alternativa opcional"

  build_tools:
    - nombre: "Vite"
      version: "5.x"
      uso: "Frontend build y dev server"
    - nombre: "TypeScript"
      version: "5.x"
      uso: "Compilacion de codigo"
    - nombre: "NestJS CLI"
      version: "10.x"
      uso: "Backend scaffolding y build"

  linters:
    - nombre: "ESLint"
      version: "8.x"
      config: ".eslintrc.js"
    - nombre: "Prettier"
      version: "3.x"
      config: ".prettierrc"

  testing:
    - nombre: "Jest"
      version: "29.x"
      tipo: "unit backend"
      config: "jest.config.js"
    - nombre: "Vitest"
      version: "1.x"
      tipo: "unit frontend"
      config: "vitest.config.ts"
    - nombre: "Supertest"
      version: "6.x"
      tipo: "e2e"
      config: "jest-e2e.config.js"

# -----------------------------------------------------------------------------
# SERVICIOS Y PUERTOS
# -----------------------------------------------------------------------------

servicios:
  frontend:
    nombre: "clinica-veterinaria-frontend"
    framework: "React"
    version: "18.x"
    puerto: 3120
    comando_dev: "npm run dev"
    comando_build: "npm run build"
    comando_preview: "npm run preview"
    ubicacion: "apps/frontend/"
    url_local: "http://localhost:3120"
    build_output: "dist/"

  backend:
    nombre: "clinica-veterinaria-backend"
    framework: "NestJS"
    version: "10.x"
    puerto: 3121
    comando_dev: "npm run start:dev"
    comando_build: "npm run build"
    comando_prod: "npm run start:prod"
    ubicacion: "apps/backend/"
    url_local: "http://localhost:3121"
    api_prefix: "/api/v1"
    swagger_url: "http://localhost:3121/api/docs"

# -----------------------------------------------------------------------------
# BASE DE DATOS - CONFIGURACION COMPLETA
# -----------------------------------------------------------------------------

base_de_datos:
  principal:
    engine: "PostgreSQL"
    version: "15"
    host_variable: "DB_HOST"
    puerto_variable: "DB_PORT"

    ambientes:
      development:
        host: "localhost"
        puerto: 5440
        nombre: "clinica_veterinaria_dev"
        usuario: "veterinaria_dev"
        password_ref: "DB_PASSWORD en .env"
        ssl: false
        pool_size: 10
        conexion: "postgresql://veterinaria_dev:{password}@localhost:5440/clinica_veterinaria_dev"

      test:
        host: "localhost"
        puerto: 5440
        nombre: "clinica_veterinaria_test"
        usuario: "veterinaria_dev"
        password_ref: "DB_PASSWORD en .env"
        ssl: false
        pool_size: 5
        conexion: "postgresql://veterinaria_dev:{password}@localhost:5440/clinica_veterinaria_test"

      staging:
        host: "${DB_HOST}"
        puerto: 5432
        nombre: "clinica_veterinaria_staging"
        usuario: "veterinaria_staging"
        password_ref: "DB_PASSWORD en variables de CI/CD"
        ssl: true
        pool_size: 20
        conexion: "postgresql://veterinaria_staging:{password}@${DB_HOST}:5432/clinica_veterinaria_staging?sslmode=require"

      production:
        host: "${DB_HOST}"
        puerto: 5432
        nombre: "clinica_veterinaria_prod"
        usuario: "veterinaria_prod"
        password_ref: "DB_PASSWORD en secrets manager"
        ssl: true
        pool_size: 50
        conexion: "postgresql://veterinaria_prod:{password}@${DB_HOST}:5432/clinica_veterinaria_prod?sslmode=require"

    schemas:
      - nombre: "public"
        descripcion: "Schema principal PostgreSQL"
      - nombre: "veterinaria"
        descripcion: "Entidades especificas veterinarias (especies, razas, mascotas, vacunas)"
      - nombre: "clinical"
        descripcion: "Heredado de erp-clinicas (consultorios, citas, historiales)"
      - nombre: "financial"
        descripcion: "Heredado de erp-core (pagos, facturacion)"
      - nombre: "hr"
        descripcion: "Heredado de erp-core (empleados, nomina)"
      - nombre: "inventory"
        descripcion: "Heredado de erp-core (medicamentos, insumos)"

    scripts_inicializacion:
      orden:
        - "database/init/00-extensions.sql"
        - "database/init/01-schemas.sql"
        - "database/schemas/01-veterinaria-schema-ddl.sql"
        - "database/seeds/fase8/01-veterinaria-catalogos.sql"

  redis:
    host_variable: "REDIS_HOST"
    puerto_variable: "REDIS_PORT"

    ambientes:
      development:
        host: "localhost"
        puerto: 6387
        database: 0
        password: ""
        conexion: "redis://localhost:6387/0"

      production:
        host: "${REDIS_HOST}"
        puerto: 6379
        database: 0
        password_ref: "REDIS_PASSWORD en secrets"
        conexion: "redis://:${REDIS_PASSWORD}@${REDIS_HOST}:6379/0"

    uso:
      - "Cache de sesiones"
      - "Cache de consultas frecuentes"
      - "Rate limiting"
      - "Queue de tareas (Bull)"

# -----------------------------------------------------------------------------
# VARIABLES DE ENTORNO - DESARROLLO
# -----------------------------------------------------------------------------

variables_entorno:
  archivos:
    ejemplo: ".env.example"
    desarrollo: ".env"
    test: ".env.test"
    produccion: ".env.production"

  development:
    - nombre: "NODE_ENV"
      valor: "development"
      descripcion: "Ambiente de ejecucion"
      requerido: true
      sensible: false

    - nombre: "APP_NAME"
      valor: "clinica-veterinaria"
      descripcion: "Nombre de la aplicacion"
      requerido: true
      sensible: false

    - nombre: "APP_VERSION"
      valor: "1.0.0"
      descripcion: "Version de la aplicacion"
      requerido: false
      sensible: false

    # Puertos
    - nombre: "FRONTEND_PORT"
      valor: "3120"
      descripcion: "Puerto del frontend React"
      requerido: true
      sensible: false

    - nombre: "BACKEND_PORT"
      valor: "3121"
      descripcion: "Puerto del backend NestJS"
      requerido: true
      sensible: false

    # Base de datos
    - nombre: "DB_HOST"
      valor: "localhost"
      descripcion: "Host de PostgreSQL"
      requerido: true
      sensible: false

    - nombre: "DB_PORT"
      valor: "5440"
      descripcion: "Puerto de PostgreSQL"
      requerido: true
      sensible: false

    - nombre: "DB_NAME"
      valor: "clinica_veterinaria_dev"
      descripcion: "Nombre de la base de datos"
      requerido: true
      sensible: false

    - nombre: "DB_USER"
      valor: "veterinaria_dev"
      descripcion: "Usuario de PostgreSQL"
      requerido: true
      sensible: false

    - nombre: "DB_PASSWORD"
      valor: ""
      descripcion: "Password de PostgreSQL"
      requerido: true
      sensible: true
      generacion: "openssl rand -base64 32"

    - nombre: "DATABASE_URL"
      valor: "postgresql://veterinaria_dev:${DB_PASSWORD}@localhost:5440/clinica_veterinaria_dev"
      descripcion: "Connection string completo"
      requerido: true
      sensible: true

    # Redis
    - nombre: "REDIS_HOST"
      valor: "localhost"
      descripcion: "Host de Redis"
      requerido: true
      sensible: false

    - nombre: "REDIS_PORT"
      valor: "6387"
      descripcion: "Puerto de Redis"
      requerido: true
      sensible: false

    - nombre: "REDIS_URL"
      valor: "redis://localhost:6387/0"
      descripcion: "Connection string de Redis"
      requerido: true
      sensible: false

    # Autenticacion
    - nombre: "JWT_SECRET"
      valor: ""
      descripcion: "Secreto para firmar JWT (min 32 caracteres)"
      requerido: true
      sensible: true
      generacion: "openssl rand -base64 64"

    - nombre: "JWT_EXPIRES_IN"
      valor: "24h"
      descripcion: "Tiempo de expiracion del access token"
      requerido: true
      sensible: false

    - nombre: "JWT_REFRESH_EXPIRES_IN"
      valor: "7d"
      descripcion: "Tiempo de expiracion del refresh token"
      requerido: true
      sensible: false

    # CORS
    - nombre: "FRONTEND_URL"
      valor: "http://localhost:3120"
      descripcion: "URL del frontend para CORS"
      requerido: true
      sensible: false

    - nombre: "ALLOWED_ORIGINS"
      valor: "http://localhost:3120,http://localhost:3121"
      descripcion: "Origenes permitidos (comma separated)"
      requerido: true
      sensible: false

    # Logging
    - nombre: "LOG_LEVEL"
      valor: "debug"
      descripcion: "Nivel de logging (debug, info, warn, error)"
      requerido: false
      sensible: false

    - nombre: "LOG_FORMAT"
      valor: "pretty"
      descripcion: "Formato de logs (pretty, json)"
      requerido: false
      sensible: false

    # File Storage
    - nombre: "STORAGE_TYPE"
      valor: "local"
      descripcion: "Tipo de storage (local, s3, minio)"
      requerido: false
      sensible: false

    - nombre: "STORAGE_PATH"
      valor: "./uploads"
      descripcion: "Path para almacenamiento local"
      requerido: false
      sensible: false

    - nombre: "MAX_FILE_SIZE"
      valor: "10485760"
      descripcion: "Tamano maximo de archivo en bytes (10MB)"
      requerido: false
      sensible: false

    # Email (opcional)
    - nombre: "SMTP_HOST"
      valor: "localhost"
      descripcion: "Host SMTP para emails"
      requerido: false
      sensible: false

    - nombre: "SMTP_PORT"
      valor: "1025"
      descripcion: "Puerto SMTP (1025 para MailHog)"
      requerido: false
      sensible: false

  production:
    notas: |
      En produccion, las siguientes variables deben configurarse
      via secrets manager o variables de CI/CD:
      - DB_PASSWORD (secreto)
      - JWT_SECRET (secreto)
      - REDIS_PASSWORD (secreto)
      - AWS_ACCESS_KEY_ID (si usa S3)
      - AWS_SECRET_ACCESS_KEY (si usa S3)

    diferencias:
      - nombre: "NODE_ENV"
        valor: "production"
      - nombre: "LOG_LEVEL"
        valor: "info"
      - nombre: "LOG_FORMAT"
        valor: "json"
      - nombre: "DB_PORT"
        valor: "5432"
      - nombre: "REDIS_PORT"
        valor: "6379"
      - nombre: "STORAGE_TYPE"
        valor: "s3"

# -----------------------------------------------------------------------------
# CONTENEDORES DOCKER
# -----------------------------------------------------------------------------

docker:
  compose_file: "docker-compose.yml"
  compose_dev: "docker-compose.dev.yml"
  compose_prod: "docker-compose.prod.yml"

  services:
    - nombre: "db"
      imagen: "postgres:15-alpine"
      puerto_host: 5440
      puerto_container: 5432
      variables:
        POSTGRES_DB: "clinica_veterinaria_dev"
        POSTGRES_USER: "veterinaria_dev"
        POSTGRES_PASSWORD: "${DB_PASSWORD}"
      volumes:
        - "postgres_data:/var/lib/postgresql/data"
      healthcheck: "pg_isready -U veterinaria_dev"

    - nombre: "redis"
      imagen: "redis:7-alpine"
      puerto_host: 6387
      puerto_container: 6379
      volumes:
        - "redis_data:/data"
      healthcheck: "redis-cli ping"

    - nombre: "mailhog"
      imagen: "mailhog/mailhog"
      puerto_smtp: 1025
      puerto_web: 8025
      uso: "Testing de emails en desarrollo"

  volumes:
    - nombre: "postgres_data"
      descripcion: "Datos persistentes de PostgreSQL"
    - nombre: "redis_data"
      descripcion: "Datos persistentes de Redis"

  networks:
    - nombre: "clinica_veterinaria_network"
      driver: "bridge"

# -----------------------------------------------------------------------------
# MIGRACIONES Y SEEDS
# -----------------------------------------------------------------------------

migraciones:
  herramienta: "TypeORM"
  directorio: "apps/backend/src/database/migrations"

  comandos:
    generar: "npm run migration:generate -- -n NombreMigracion"
    ejecutar: "npm run migration:run"
    revertir: "npm run migration:revert"
    mostrar: "npm run migration:show"

seeds:
  directorio: "database/seeds"
  orden:
    - "fase8/01-veterinaria-catalogos.sql"

  comandos:
    ejecutar: "npm run seed"
    desarrollo: "npm run seed:dev"

# -----------------------------------------------------------------------------
# SCRIPTS DE DESARROLLO
# -----------------------------------------------------------------------------

scripts:
  setup:
    descripcion: "Configurar entorno desde cero"
    pasos:
      - comando: "npm install"
        descripcion: "Instalar dependencias"
      - comando: "cp .env.example .env"
        descripcion: "Crear archivo de configuracion"
      - comando: "docker-compose up -d db redis"
        descripcion: "Levantar servicios de infraestructura"
      - comando: "npm run db:create"
        descripcion: "Crear base de datos"
      - comando: "npm run migration:run"
        descripcion: "Ejecutar migraciones"
      - comando: "npm run seed"
        descripcion: "Cargar datos iniciales"

  desarrollo:
    frontend: "cd apps/frontend && npm run dev"
    backend: "cd apps/backend && npm run start:dev"
    ambos: "npm run dev:all"
    docker: "docker-compose up -d"

  testing:
    unit: "npm run test"
    unit_watch: "npm run test:watch"
    e2e: "npm run test:e2e"
    coverage: "npm run test:cov"

  build:
    frontend: "cd apps/frontend && npm run build"
    backend: "cd apps/backend && npm run build"
    docker: "docker-compose -f docker-compose.prod.yml build"

  database:
    create: "npm run db:create"
    drop: "npm run db:drop"
    reset: "npm run db:reset"
    migrations_run: "npm run migration:run"
    migrations_revert: "npm run migration:revert"
    seed: "npm run seed"

  linting:
    lint: "npm run lint"
    lint_fix: "npm run lint:fix"
    format: "npm run format"

# -----------------------------------------------------------------------------
# INSTRUCCIONES DE SETUP
# -----------------------------------------------------------------------------

setup_instrucciones: |
  ## Setup del Entorno de Desarrollo - Clinica Veterinaria

  ### Prerequisitos
  - Node.js 20.x (LTS)
  - PostgreSQL 15 (o Docker)
  - Redis 7 (o Docker)
  - npm 10.x
  - Git

  ### Opcion 1: Setup con Docker (Recomendado)

  ```bash
  # 1. Clonar repositorio
  git clone <url_repo>
  cd clinica-veterinaria

  # 2. Instalar dependencias
  npm install

  # 3. Configurar variables de entorno
  cp .env.example .env
  # Editar .env - generar passwords seguros:
  # openssl rand -base64 32  # para DB_PASSWORD
  # openssl rand -base64 64  # para JWT_SECRET

  # 4. Levantar infraestructura
  docker-compose up -d db redis

  # 5. Crear base de datos y ejecutar migraciones
  npm run db:create
  npm run migration:run
  npm run seed

  # 6. Iniciar desarrollo
  npm run dev:all
  ```

  ### Opcion 2: Setup con PostgreSQL Local

  ```bash
  # 1-3. Igual que arriba

  # 4. Crear usuario y base de datos en PostgreSQL
  sudo -u postgres psql
  CREATE USER veterinaria_dev WITH PASSWORD 'tu_password';
  CREATE DATABASE clinica_veterinaria_dev OWNER veterinaria_dev;
  GRANT ALL PRIVILEGES ON DATABASE clinica_veterinaria_dev TO veterinaria_dev;
  \q

  # 5. Configurar Redis local o Docker
  docker run -d --name redis-veterinaria -p 6387:6379 redis:7-alpine

  # 6-7. Continuar con migraciones y seeds
  ```

  ### Verificar Instalacion
  - Frontend: http://localhost:3120
  - Backend API: http://localhost:3121/api/v1
  - Swagger Docs: http://localhost:3121/api/docs
  - Health Check: http://localhost:3121/health

  ### Usuarios de Prueba (despues de seed)
  - Admin: admin@clinica-vet.local / Admin123!
  - Veterinario: vet@clinica-vet.local / Vet123!
  - Recepcion: recepcion@clinica-vet.local / Recep123!

# -----------------------------------------------------------------------------
# TROUBLESHOOTING
# -----------------------------------------------------------------------------

troubleshooting:
  - problema: "Puerto 3120 o 3121 en uso"
    solucion: |
      Verificar con: lsof -i :3120
      Terminar proceso: kill -9 <PID>
      O cambiar puertos en .env

  - problema: "Error de conexion a PostgreSQL"
    solucion: |
      1. Verificar que PostgreSQL esta corriendo:
         docker-compose ps
         # o: systemctl status postgresql
      2. Verificar credenciales en .env
      3. Verificar que la BD existe:
         psql -h localhost -p 5440 -U veterinaria_dev -l

  - problema: "Error de conexion a Redis"
    solucion: |
      1. Verificar que Redis esta corriendo:
         docker-compose ps
         # o: redis-cli -p 6387 ping
      2. Verificar puerto en .env

  - problema: "Migraciones fallan"
    solucion: |
      1. Verificar que la BD existe
      2. Verificar permisos del usuario
      3. Revisar logs: npm run migration:run --verbose
      4. Si es necesario, resetear: npm run db:reset

  - problema: "JWT errors"
    solucion: |
      Verificar que JWT_SECRET esta configurado (min 32 caracteres)
      Generar nuevo: openssl rand -base64 64

  - problema: "CORS errors en frontend"
    solucion: |
      Verificar FRONTEND_URL y ALLOWED_ORIGINS en .env
      Deben coincidir con la URL del frontend

# -----------------------------------------------------------------------------
# CONFIGURACION DE PRODUCCION
# -----------------------------------------------------------------------------

produccion:
  checklist:
    - item: "Variables de entorno configuradas via secrets manager"
    - item: "SSL/TLS habilitado para BD y Redis"
    - item: "Backups automaticos configurados"
    - item: "Monitoreo y alertas activas"
    - item: "Rate limiting configurado"
    - item: "CORS restringido a dominios autorizados"
    - item: "Logs en formato JSON para agregacion"

  infraestructura_recomendada:
    base_de_datos: "AWS RDS PostgreSQL 15 o equivalente"
    cache: "AWS ElastiCache Redis o equivalente"
    storage: "AWS S3 o equivalente"
    cdn: "CloudFront o equivalente"
    ci_cd: "GitHub Actions / GitLab CI"

  escalado:
    backend_replicas: 2
    pool_db_size: 50
    redis_maxmemory: "256mb"

# -----------------------------------------------------------------------------
# REFERENCIAS
# -----------------------------------------------------------------------------

referencias:
  perfil_devenv: "orchestration/agents/perfiles/PERFIL-DEVENV.md"
  inventario_master: "orchestration/inventarios/DEVENV-MASTER-INVENTORY.yml"
  inventario_puertos: "orchestration/inventarios/DEVENV-PORTS-INVENTORY.yml"
  contexto_proyecto: "orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
  parent_clinicas: "../erp-clinicas/orchestration/environment/ENVIRONMENT-INVENTORY.yml"
  schema_veterinaria: "database/schemas/01-veterinaria-schema-ddl.sql"

# =============================================================================
# FIN DE INVENTARIO
# =============================================================================