- 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>
72 lines
2.5 KiB
Markdown
72 lines
2.5 KiB
Markdown
# 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:**
|
|
```sql
|
|
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.
|