workspace/projects/gamilit/apps/backend/migrations/README.md
rckrdmrd ea1879f4ad feat: Initial workspace structure with multi-level Git configuration
- Configure workspace Git repository with comprehensive .gitignore
- Add Odoo as submodule for ERP reference code
- Include documentation: SETUP.md, GIT-STRUCTURE.md
- Add gitignore templates for projects (backend, frontend, database)
- Structure supports independent repos per project/subproject level

Workspace includes:
- core/ - Reusable patterns, modules, orchestration system
- projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.)
- knowledge-base/ - Reference code and patterns (includes Odoo submodule)
- devtools/ - Development tools and templates
- customers/ - Client implementations template

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-08 10:44:23 -06:00

2.5 KiB

Migraciones de Base de Datos - Gamilit Backend

⚠️ NOTA IMPORTANTE (2025-11-29)

Los archivos de migración P0-001 han sido DEPRECADOS y movidos a: apps/backend/_deprecated/migrations-maya-rank-2025-11-29/

Las funciones helper fueron INTEGRADAS AL DDL en: apps/database/ddl/schemas/gamification_system/functions/calculate_maya_rank_helpers.sql

Para nuevas instalaciones: Usar recreación limpia de BD. Para datos legacy: Ver archivos en _deprecated/ solo si es necesario migrar datos existentes.


Estado Actual

Este directorio está VACÍO (excepto este README) porque:

  1. Política de Carga Limpia: No usamos migraciones activas
  2. DDL como Fuente de Verdad: Toda la estructura de BD está en /apps/database/ddl/
  3. Recreación Limpia: Usamos create-database.sh para recrear BD desde cero

Historial de Migraciones Deprecadas

P0-001: Migración de MayaRank Legacy (DEPRECADO 2025-11-29)

Ubicación: apps/backend/_deprecated/migrations-maya-rank-2025-11-29/

Problema Original:

  • Valores legacy incorrectos: NACOM, BATAB, HOLCATTE, etc.
  • Valores correctos: Ajaw, Nacom, Ah K'in, Halach Uinic, K'uk'ulkan

Solución Implementada:

  • Funciones helper integradas al DDL permanentemente
  • Datos legacy solo necesitan corrección en BD existentes (no nuevas)

Funciones Ahora en DDL

Las siguientes funciones fueron integradas al DDL y ya NO están en migraciones:

Función Ubicación DDL Descripción
calculate_maya_rank_from_xp(INTEGER) calculate_maya_rank_helpers.sql Calcula rango desde XP
calculate_rank_progress_percentage(INTEGER, TEXT) calculate_maya_rank_helpers.sql Calcula % progreso dentro del rango

Uso:

SELECT gamification_system.calculate_maya_rank_from_xp(5000);
-- Resultado: 'Ah K'in'

SELECT gamification_system.calculate_rank_progress_percentage(1500, 'Nacom');
-- Resultado: 25.00

Referencias

  • Deprecación: apps/backend/_deprecated/migrations-maya-rank-2025-11-29/README.md
  • DDL Actual: apps/database/ddl/schemas/gamification_system/functions/
  • Plan de Validación: orchestration/agentes/architecture-analyst/PLAN-VALIDACION-CLEAN-CREATION-2025-11-29.md
  • Fecha de Actualización: 2025-11-29

Política: Este directorio debe permanecer vacío. Cualquier nueva corrección de datos debe documentarse y deprecarse apropiadamente.