miinventario-v2/orchestration/inventarios/DATABASE_INVENTORY.yml

# MiInventario - Database Inventory
# Version: 2.0.0
# Actualizado: 2026-01-10

metadata:
  proyecto: miinventario
  componente: database
  motor: PostgreSQL
  version_motor: "15"
  orm: TypeORM
  version: "2.0.0"
  estado: implementado
  creado: 2026-01-10
  actualizado: 2026-01-10
  actualizado_por: "Agente Orquestador"

# ===========================================
# CONEXION
# ===========================================
conexion:
  host: localhost
  puerto: 5433
  nombre: miinventario_dev
  usuario: postgres
  ssl: false

# ===========================================
# RESUMEN
# ===========================================
resumen:
  schemas_implementados: 1
  tablas_implementadas: 13
  enums_implementados: 10
  indices_implementados: 17
  foreign_keys_implementados: 13
  migraciones_ejecutadas: 1
  rls_habilitado: false
  nota: "El proyecto usa TypeORM con schema 'public' en lugar de schemas separados"

# ===========================================
# TABLAS IMPLEMENTADAS
# ===========================================
tablas:
  - nombre: users
    descripcion: "Usuarios del sistema"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: phone, tipo: varchar(20), unique: true, nullable: true }
      - { nombre: email, tipo: varchar(255), unique: true, nullable: true }
      - { nombre: passwordHash, tipo: varchar(255), nullable: true }
      - { nombre: name, tipo: varchar(100), nullable: true }
      - { nombre: businessName, tipo: varchar(100), nullable: true }
      - { nombre: location, tipo: varchar(255), nullable: true }
      - { nombre: giro, tipo: varchar(50), nullable: true }
      - { nombre: role, tipo: "users_role_enum", default: "USER" }
      - { nombre: isActive, tipo: boolean, default: true }
      - { nombre: fcmToken, tipo: varchar(255), nullable: true }
      - { nombre: stripeCustomerId, tipo: varchar(100), nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }

  - nombre: stores
    descripcion: "Tiendas de usuarios"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: ownerId, tipo: uuid, fk: "users.id" }
      - { nombre: name, tipo: varchar(100), required: true }
      - { nombre: giro, tipo: varchar(50), nullable: true }
      - { nombre: address, tipo: varchar(255), nullable: true }
      - { nombre: phone, tipo: varchar(20), nullable: true }
      - { nombre: logoUrl, tipo: varchar(500), nullable: true }
      - { nombre: settings, tipo: jsonb, default: "{}" }
      - { nombre: isActive, tipo: boolean, default: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }

  - nombre: store_users
    descripcion: "Relacion usuarios-tiendas"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: store_id, tipo: uuid, fk: "stores.id" }
      - { nombre: user_id, tipo: uuid, fk: "users.id" }
      - { nombre: role, tipo: "store_users_role_enum" }
      - { nombre: isActive, tipo: boolean, default: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }

  - nombre: videos
    descripcion: "Videos subidos para procesamiento"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: storeId, tipo: uuid, fk: "stores.id" }
      - { nombre: uploadedById, tipo: uuid, fk: "users.id" }
      - { nombre: fileName, tipo: varchar(255), required: true }
      - { nombre: s3Key, tipo: varchar(500), nullable: true }
      - { nombre: fileSize, tipo: bigint, nullable: true }
      - { nombre: durationSeconds, tipo: integer, nullable: true }
      - { nombre: status, tipo: "videos_status_enum", default: "PENDING" }
      - { nombre: processingProgress, tipo: integer, default: 0 }
      - { nombre: itemsDetected, tipo: integer, default: 0 }
      - { nombre: creditsUsed, tipo: integer, default: 0 }
      - { nombre: errorMessage, tipo: text, nullable: true }
      - { nombre: metadata, tipo: jsonb, nullable: true }
      - { nombre: processedAt, tipo: timestamp, nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }

  - nombre: inventory_items
    descripcion: "Items de inventario detectados"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: storeId, tipo: uuid, fk: "stores.id" }
      - { nombre: detectedByVideoId, tipo: uuid, fk: "videos.id", nullable: true }
      - { nombre: name, tipo: varchar(255), required: true }
      - { nombre: category, tipo: varchar(100), nullable: true }
      - { nombre: subcategory, tipo: varchar(100), nullable: true }
      - { nombre: barcode, tipo: varchar(50), nullable: true }
      - { nombre: quantity, tipo: integer, default: 0 }
      - { nombre: minStock, tipo: integer, nullable: true }
      - { nombre: price, tipo: "decimal(10,2)", nullable: true }
      - { nombre: cost, tipo: "decimal(10,2)", nullable: true }
      - { nombre: imageUrl, tipo: varchar(500), nullable: true }
      - { nombre: detectionConfidence, tipo: "decimal(5,2)", nullable: true }
      - { nombre: isManuallyEdited, tipo: boolean, default: false }
      - { nombre: metadata, tipo: jsonb, nullable: true }
      - { nombre: lastCountedAt, tipo: timestamp, nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }
    indices:
      - { columnas: [storeId, name] }
      - { columnas: [storeId, category] }
      - { columnas: [storeId, barcode] }

  - nombre: credit_balances
    descripcion: "Saldos de creditos por usuario"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: userId, tipo: uuid, fk: "users.id", unique: true }
      - { nombre: balance, tipo: integer, default: 0 }
      - { nombre: totalPurchased, tipo: integer, default: 0 }
      - { nombre: totalConsumed, tipo: integer, default: 0 }
      - { nombre: totalFromReferrals, tipo: integer, default: 0 }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }

  - nombre: credit_packages
    descripcion: "Paquetes de creditos disponibles"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: name, tipo: varchar(100), required: true }
      - { nombre: description, tipo: varchar(255), nullable: true }
      - { nombre: credits, tipo: integer, required: true }
      - { nombre: priceMXN, tipo: "decimal(10,2)", required: true }
      - { nombre: isPopular, tipo: boolean, default: false }
      - { nombre: isActive, tipo: boolean, default: true }
      - { nombre: sortOrder, tipo: integer, default: 0 }
      - { nombre: stripePriceId, tipo: varchar(100), nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }

  - nombre: credit_transactions
    descripcion: "Transacciones de creditos"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: userId, tipo: uuid, fk: "users.id" }
      - { nombre: type, tipo: "credit_transactions_type_enum" }
      - { nombre: amount, tipo: integer, required: true }
      - { nombre: balanceAfter, tipo: integer, required: true }
      - { nombre: description, tipo: varchar(255), nullable: true }
      - { nombre: referenceId, tipo: uuid, nullable: true }
      - { nombre: referenceType, tipo: varchar(50), nullable: true }
      - { nombre: metadata, tipo: jsonb, nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
    indices:
      - { columnas: [userId, createdAt] }
      - { columnas: [type, createdAt] }

  - nombre: payments
    descripcion: "Pagos de usuarios"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: userId, tipo: uuid, fk: "users.id" }
      - { nombre: packageId, tipo: uuid, fk: "credit_packages.id", nullable: true }
      - { nombre: amountMXN, tipo: "decimal(10,2)", required: true }
      - { nombre: creditsGranted, tipo: integer, required: true }
      - { nombre: method, tipo: "payments_method_enum" }
      - { nombre: status, tipo: "payments_status_enum", default: "PENDING" }
      - { nombre: externalId, tipo: varchar(255), nullable: true }
      - { nombre: provider, tipo: varchar(50), nullable: true }
      - { nombre: voucherUrl, tipo: varchar(500), nullable: true }
      - { nombre: voucherCode, tipo: varchar(100), nullable: true }
      - { nombre: expiresAt, tipo: timestamp, nullable: true }
      - { nombre: completedAt, tipo: timestamp, nullable: true }
      - { nombre: errorMessage, tipo: text, nullable: true }
      - { nombre: metadata, tipo: jsonb, nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }
    indices:
      - { columnas: [userId, createdAt] }
      - { columnas: [status, createdAt] }
      - { columnas: [externalId] }

  - nombre: referrals
    descripcion: "Sistema de referidos"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: referrerId, tipo: uuid, fk: "users.id" }
      - { nombre: referredId, tipo: uuid, fk: "users.id", nullable: true }
      - { nombre: referralCode, tipo: varchar(20), unique: true }
      - { nombre: status, tipo: "referrals_status_enum", default: "PENDING" }
      - { nombre: referrerBonusCredits, tipo: integer, default: 0 }
      - { nombre: referredBonusCredits, tipo: integer, default: 0 }
      - { nombre: registeredAt, tipo: timestamp, nullable: true }
      - { nombre: qualifiedAt, tipo: timestamp, nullable: true }
      - { nombre: rewardedAt, tipo: timestamp, nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
      - { nombre: updatedAt, tipo: timestamp, default: now() }
    indices:
      - { columnas: [referrerId] }
      - { columnas: [referredId] }
      - { columnas: [referralCode] }

  - nombre: notifications
    descripcion: "Notificaciones de usuarios"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: userId, tipo: uuid, fk: "users.id" }
      - { nombre: type, tipo: "notifications_type_enum" }
      - { nombre: title, tipo: varchar(255), required: true }
      - { nombre: body, tipo: text, nullable: true }
      - { nombre: isRead, tipo: boolean, default: false }
      - { nombre: isPushSent, tipo: boolean, default: false }
      - { nombre: data, tipo: jsonb, nullable: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
    indices:
      - { columnas: [userId, isRead] }
      - { columnas: [userId, createdAt] }

  - nombre: otps
    descripcion: "Codigos OTP para verificacion"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: phone, tipo: varchar(20), required: true }
      - { nombre: code, tipo: varchar(6), required: true }
      - { nombre: purpose, tipo: "otps_purpose_enum" }
      - { nombre: attempts, tipo: integer, default: 0 }
      - { nombre: isUsed, tipo: boolean, default: false }
      - { nombre: expiresAt, tipo: timestamp, required: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
    indices:
      - { columnas: [phone, purpose] }
      - { columnas: [expiresAt] }

  - nombre: refresh_tokens
    descripcion: "Tokens de refresco JWT"
    estado: implementado
    campos:
      - { nombre: id, tipo: uuid, pk: true, default: uuid_generate_v4() }
      - { nombre: userId, tipo: uuid, fk: "users.id" }
      - { nombre: token, tipo: varchar(500), required: true }
      - { nombre: deviceInfo, tipo: varchar(100), nullable: true }
      - { nombre: ipAddress, tipo: varchar(50), nullable: true }
      - { nombre: isRevoked, tipo: boolean, default: false }
      - { nombre: expiresAt, tipo: timestamp, required: true }
      - { nombre: createdAt, tipo: timestamp, default: now() }
    indices:
      - { columnas: [userId] }
      - { columnas: [token] }
      - { columnas: [expiresAt] }

# ===========================================
# ENUMS
# ===========================================
enums:
  - nombre: users_role_enum
    valores: [USER, ADMIN]

  - nombre: videos_status_enum
    valores: [PENDING, UPLOADING, UPLOADED, PROCESSING, COMPLETED, FAILED]

  - nombre: store_users_role_enum
    valores: [OWNER, OPERATOR]

  - nombre: referrals_status_enum
    valores: [PENDING, REGISTERED, QUALIFIED, REWARDED]

  - nombre: payments_method_enum
    valores: [CARD, OXXO, 7ELEVEN]

  - nombre: payments_status_enum
    valores: [PENDING, PROCESSING, COMPLETED, FAILED, REFUNDED, EXPIRED]

  - nombre: notifications_type_enum
    valores: [VIDEO_PROCESSING_COMPLETE, VIDEO_PROCESSING_FAILED, LOW_CREDITS, PAYMENT_COMPLETE, PAYMENT_FAILED, REFERRAL_BONUS, PROMO, SYSTEM]

  - nombre: credit_transactions_type_enum
    valores: [PURCHASE, CONSUMPTION, REFERRAL_BONUS, PROMO, REFUND]

  - nombre: otps_purpose_enum
    valores: [REGISTRATION, LOGIN, PASSWORD_RESET]

# ===========================================
# MIGRACIONES
# ===========================================
migraciones:
  ultima_migracion: "1768099560565-Init"
  total_ejecutadas: 1
  historial:
    - nombre: Init1768099560565
      fecha: 2026-01-10
      descripcion: "Creacion inicial de todas las tablas"
      archivo: "src/migrations/1768099560565-Init.ts"
      tablas_creadas: 13
      enums_creados: 10
      indices_creados: 17
      foreign_keys: 13

# ===========================================
# SEEDS
# ===========================================
seeds:
  - archivo: "src/database/seed.ts"
    descripcion: "Seed para paquetes de creditos"
    estado: implementado
    datos:
      - credit_packages (4 paquetes: Basico, Popular, Premium, Empresarial)

# ===========================================
# CHANGELOG
# ===========================================
changelog:
  - version: "1.0.0"
    fecha: 2026-01-10
    cambios:
      - "Creacion inicial del inventario de base de datos"
      - "Definicion de 9 schemas planificados"
      - "Definicion de 30 tablas planificadas"

  - version: "2.0.0"
    fecha: 2026-01-10
    cambios:
      - "Actualizacion completa con estado real implementado"
      - "13 tablas implementadas con TypeORM"
      - "10 ENUMs creados"
      - "17 indices configurados"
      - "13 foreign keys establecidos"
      - "Migracion Init ejecutada exitosamente"
      - "Cambio de arquitectura: schema unico (public) vs multiples"