# MiInventario - Environment Inventory
# Version: 1.0.0
# Actualizado: 2026-01-10

metadata:
  proyecto: miinventario
  version: "1.0.0"
  estado: configurado
  creado: 2026-01-10
  actualizado: 2026-01-10
  actualizado_por: "Agente Orquestador"

# ===========================================
# HERRAMIENTAS DE DESARROLLO
# ===========================================
herramientas:
  runtime:
    - nombre: Node.js
      version: "18.x"
      requerido: true

    - nombre: npm
      version: "9.x"
      requerido: true

    - nombre: Docker
      version: "24.x"
      requerido: true

    - nombre: Docker Compose
      version: "2.x"
      requerido: true

  cli:
    - nombre: nest
      comando: "npm install -g @nestjs/cli"
      version: "10.x"

    - nombre: expo
      comando: "npm install -g expo-cli"
      version: "latest"

  editores:
    - nombre: VS Code
      extensiones:
        - ESLint
        - Prettier
        - TypeScript
        - Expo Tools
        - Thunder Client

# ===========================================
# SERVICIOS DOCKER
# ===========================================
servicios:
  - nombre: postgres
    imagen: postgres:15-alpine
    puerto_host: 5433
    puerto_container: 5432
    estado: configurado
    notas: "Base de datos principal"

  - nombre: redis
    imagen: redis:7-alpine
    puerto_host: 6380
    puerto_container: 6379
    estado: configurado
    notas: "Cache y cola de trabajos"

  - nombre: minio
    imagen: minio/minio:latest
    puerto_api: 9002
    puerto_console: 9003
    estado: configurado
    notas: "Almacenamiento S3 compatible"

# ===========================================
# PUERTOS ASIGNADOS
# ===========================================
puertos:
  postgres: 5433
  redis: 6380
  minio_api: 9002
  minio_console: 9003
  backend: 3150
  mobile: 8082

# ===========================================
# VARIABLES DE ENTORNO
# ===========================================
variables:
  # Database
  DATABASE_URL:
    valor: "postgresql://postgres:postgres@localhost:5433/miinventario_dev"
    requerido: true
    secreto: false

  REDIS_URL:
    valor: "redis://localhost:6380"
    requerido: true
    secreto: false

  # Backend
  BACKEND_PORT:
    valor: "3150"
    requerido: true
    secreto: false

  NODE_ENV:
    valor: "development"
    requerido: true
    secreto: false

  JWT_SECRET:
    valor: null
    requerido: true
    secreto: true
    notas: "Generar con: openssl rand -base64 32"

  # Stripe
  STRIPE_SECRET_KEY:
    valor: null
    requerido: true
    secreto: true

  STRIPE_WEBHOOK_SECRET:
    valor: null
    requerido: false
    secreto: true

  # S3/MinIO
  S3_ENDPOINT:
    valor: "http://localhost:9002"
    requerido: true
    secreto: false

  S3_ACCESS_KEY:
    valor: "minioadmin"
    requerido: true
    secreto: true

  S3_SECRET_KEY:
    valor: "minioadmin"
    requerido: true
    secreto: true

  S3_BUCKET:
    valor: "miinventario"
    requerido: true
    secreto: false

  # IA
  AI_PROVIDER:
    valor: "openai"
    requerido: true
    secreto: false

  AI_API_KEY:
    valor: null
    requerido: true
    secreto: true

  # Firebase
  FIREBASE_PROJECT_ID:
    valor: null
    requerido: false
    secreto: false

  FIREBASE_PRIVATE_KEY:
    valor: null
    requerido: false
    secreto: true

# ===========================================
# COMANDOS FRECUENTES
# ===========================================
comandos:
  desarrollo:
    iniciar_servicios: "docker-compose up -d"
    detener_servicios: "docker-compose down"
    logs_postgres: "docker-compose logs -f postgres"
    psql: "docker exec -it miinventario-postgres psql -U postgres -d miinventario_dev"
    redis_cli: "docker exec -it miinventario-redis redis-cli"

  backend:
    desarrollo: "npm run dev:backend"
    build: "npm run build:backend"
    test: "npm run test --workspace=apps/backend"

  mobile:
    desarrollo: "npm run dev:mobile"
    ios: "npx expo run:ios"
    android: "npx expo run:android"

  database:
    recrear: "./database/scripts/recreate-db.sh"
    migrar: "npm run db:migrate"
    seed: "npm run db:seed"

# ===========================================
# ESTRUCTURA DE CARPETAS
# ===========================================
estructura:
  apps:
    backend:
      src:
        modules: "Modulos de negocio"
        shared: "Guards, decorators, pipes"
      test: "Tests"

    mobile:
      src:
        screens: "Pantallas"
        components: "Componentes"
        hooks: "Custom hooks"
        stores: "Estado global"
        services: "Servicios API"
      assets: "Imagenes, fuentes"

  database:
    schemas: "DDL PostgreSQL"
    seeds: "Datos iniciales"

  docs: "Documentacion SIMCO"
  orchestration: "Orquestacion del proyecto"
  deploy: "Configuracion de despliegue"

# ===========================================
# CHANGELOG
# ===========================================
changelog:
  - version: "1.0.0"
    fecha: 2026-01-10
    cambios:
      - "Configuracion inicial del entorno"
      - "Docker Compose con PostgreSQL, Redis, MinIO"
      - "Variables de entorno definidas"