erp-core/orchestration/trazas/TRAZA-TAREAS-DATABASE.md

Traza de Tareas - Database Agent

Registro de Tareas Ejecutadas

Este archivo mantiene el historial de todas las tareas ejecutadas por agentes de base de datos en el proyecto ERP Core.

---

Historial de Tareas

2026-01-07 - DDL-004 - COMPLETADO

Agente: Database-Agent Sprint: Sprint 8 - Reports & Dashboards Descripción: Implementación DDL de schema reports completo Specs cubiertas:

• RF-REPORT-001: Reportes Predefinidos
• RF-REPORT-002: Dashboards
• RF-REPORT-003: Report Builder
• RF-REPORT-004: Reportes Programados

Archivos creados:

• database/ddl/14-reports.sql

Contenido implementado:

tablas_nuevas: 12
  reportes:
    - reports.report_definitions
    - reports.report_executions
    - reports.report_schedules
    - reports.report_recipients
    - reports.schedule_executions
    - reports.custom_reports
  dashboards:
    - reports.dashboards
    - reports.dashboard_widgets
    - reports.widget_queries
  data_model:
    - reports.data_model_entities
    - reports.data_model_fields
    - reports.data_model_relationships

enums_nuevos: 7
  - reports.report_type
  - reports.execution_status
  - reports.export_format
  - reports.delivery_method
  - reports.widget_type (15 tipos)
  - reports.param_type
  - reports.filter_operator

rls_policies: 7
  - Todas las tablas con tenant_isolation

Archivos modificados:

• database/scripts/create-database.sh (agregado 14-reports.sql al array DDL_FILES)

Resultado: Éxito Validación: Base de datos recreada exitosamente con ./recreate-database.sh --force

---

2025-12-08 - DDL-002 - COMPLETADO

Agente: Database-Agent Descripción: Implementación DDL de extensiones de inventario (SVL, Lotes, Conteos) Specs cubiertas:

• SPEC-VALORACION-INVENTARIO.md
• SPEC-TRAZABILIDAD-LOTES-SERIES.md
• SPEC-INVENTARIOS-CICLICOS.md

Archivos creados:

• database/ddl/05-inventory-extensions.sql

Contenido implementado:

tablas_nuevas: 10
  valoracion_svl:
    - inventory.stock_valuation_layers
    - inventory.category_stock_accounts
    - inventory.valuation_settings
  lotes_series:
    - inventory.lots
    - inventory.move_line_consume_rel
    - inventory.removal_strategies
  conteos_ciclicos:
    - inventory.inventory_count_sessions
    - inventory.inventory_count_lines
    - inventory.abc_classification_rules
    - inventory.product_abc_classification

funciones_nuevas: 7
  - inventory.run_fifo()
  - inventory.calculate_abc_classification()
  - inventory.get_pending_counts()
  - inventory.mark_quants_outdated()
  - inventory.compute_lot_expiration_dates()
  - inventory.refresh_product_valuation_summary()
  - inventory.update_session_stats()

vistas_nuevas: 3
  - inventory.product_valuation_summary (materialized)
  - inventory.expiring_lots_view
  - inventory.location_count_summary_view

columnas_extendidas: 30+
  - products: tracking, expiration_time, use_time, removal_time, etc.
  - product_categories: cost_method, valuation_method, removal_strategy
  - quants: lot_id, in_date, inventory_quantity, etc.
  - locations: cyclic_inventory_frequency, abc_classification
  - stock_move_lines: lot_id, lot_name, tracking
  - stock_moves: is_inventory, inventory_session_id

Resultado: Éxito Validación: Pendiente ejecución de carga limpia

---

2025-12-08 - DDL-001 - COMPLETADO

Agente: Database-Agent Descripción: Implementación DDL de extensiones de autenticación (2FA, API Keys, OAuth2, ACL) Specs cubiertas:

• SPEC-TWO-FACTOR-AUTHENTICATION.md
• SPEC-SEGURIDAD-API-KEYS-PERMISOS.md
• SPEC-OAUTH2-SOCIAL-LOGIN.md

Archivos creados:

• database/ddl/01-auth-extensions.sql

Contenido implementado:

tablas_nuevas: 16
  groups_herencia:
    - auth.groups
    - auth.group_implied
    - auth.user_groups
  acl_model_access:
    - auth.models
    - auth.model_access
    - auth.record_rules
    - auth.rule_groups
    - auth.model_fields
    - auth.field_permissions
  api_keys:
    - auth.api_keys
  two_factor_auth:
    - auth.trusted_devices
    - auth.verification_codes
    - auth.mfa_audit_log
  oauth2:
    - auth.oauth_providers
    - auth.oauth_user_links
    - auth.oauth_states

funciones_nuevas: 6
  - auth.get_user_effective_groups()
  - auth.check_model_access()
  - auth.cleanup_expired_oauth_states()
  - auth.cleanup_expired_verification_codes()
  - auth.cleanup_expired_trusted_devices()
  - auth.cleanup_expired_api_keys()

vistas_nuevas: 2
  - auth.users_oauth_summary
  - auth.user_model_access_view

columnas_extendidas_users: 9
  - mfa_enabled, mfa_method, mfa_secret
  - backup_codes, backup_codes_count
  - mfa_setup_at, last_2fa_verification
  - oauth_only, primary_oauth_provider_id

Archivos modificados:

• database/scripts/create-database.sh (agregados DDL faltantes al orden de ejecución)

Resultado: Éxito Validación: Pendiente ejecución de carga limpia

---

2025-12-05 - INIT-001 - COMPLETADO

Agente: Migración Descripción: Migración inicial de database desde workspace-erp-inmobiliaria Archivos creados:

• database/ddl/*
• database/migrations/*
• database/seeds/*

Resultado: Éxito Notas: Estructura de BD migrada desde erp-generic.

---

Próximas Tareas Asignadas

ID	Descripción	Agente	Prioridad	Specs
DB-003	Ejecutar carga limpia para validar DDL nuevos	Database-Agent	P0	N/A
DB-004	Implementar DDL para secuencias (ir.sequence)	Database-Agent	P1	SPEC-SISTEMA-SECUENCIAS.md
DB-005	Implementar DDL para reportes financieros	Database-Agent	P1	SPEC-REPORTES-FINANCIEROS.md
DB-006	Implementar seeds de roles/permisos	Database-Agent	P2	N/A

---

Validación de Carga Limpia

Checklist (Pendiente)

- [ ] Recreación completa ejecuta sin errores
- [ ] Todas las tablas se crean correctamente (144 total)
- [ ] Todos los índices se crean
- [ ] Todas las funciones y triggers se crean
- [ ] Todas las RLS policies se aplican
- [ ] Seeds se cargan sin errores
- [ ] No hay warnings en el log

Comando de Validación

cd projects/erp-suite/apps/erp-core/database
./scripts/reset-database.sh              # DDL + seeds dev (por defecto)
./scripts/reset-database.sh --force      # Sin confirmación (CI/CD)
./scripts/reset-database.sh --no-seeds   # Solo DDL, sin seeds
./scripts/reset-database.sh --env prod   # Seeds de producción

---

Política de Carga Limpia

Directiva: core/orchestration/directivas/legacy/DIRECTIVA-POLITICA-CARGA-LIMPIA.md

Principios:

1. DDL-First: Los archivos DDL son la fuente de verdad
2. NUNCA ejecutar ALTER/CREATE directo en BD
3. SIEMPRE validar con recreación completa
4. La BD debe poder recrearse 100% desde DDL

Prohibiciones:

• Ejecutar ALTER TABLE directo sin actualizar DDL
• Crear carpeta migrations/
• Crear archivos fix-.sql, patch-.sql, hotfix-*.sql
• Dejar BD y DDL desincronizados

---

Última actualización: 2025-12-08