michangarrito/orchestration/analisis/ANALISIS-INTEGRACION-ARQUITECTURA-DATABASE-2026-01-10.md

ANALISIS DE INTEGRACION: ARQUITECTURA-DATABASE.md

Fecha: 2026-01-10 Proposito: Analisis detallado antes de integrar/eliminar archivos duplicados

---

1. ARCHIVOS ANALIZADOS

Archivo	Ubicacion	Lineas	Fecha
ARQUITECTURA-DATABASE.md (RESUMEN)	docs/90-transversal/arquitectura/	163	2026-01-05
ARQUITECTURA-DATABASE.md (COMPLETO)	docs/02-especificaciones/	1182	2026-01-04

---

2. COMPARACION DETALLADA DE CONTENIDO

2.1 Archivo RESUMEN (90-transversal/arquitectura/) - 163 lineas

Seccion	Lineas	Contenido
Resumen	7-15	Metricas: Motor, Schemas, Tablas, Extensiones
Schemas	18-31	Tabla con 9 schemas y descripcion
Estructura por Schema	34-97	Nombres de tablas por schema (SIN SQL)
Extensiones	100-107	Lista de 4 extensiones
Multi-tenancy	110-116	Descripcion breve (tenant_id, indices, trigger)
Convenciones	119-136	CONTENIDO UNICO - Columnas comunes, indices, triggers
Conexion	139-146	Host, puerto, database, usuario
Scripts	150-156	Referencias a scripts
Referencias	159-162	Links a otros documentos

2.2 Archivo COMPLETO (02-especificaciones/) - 1182 lineas

Seccion	Lineas	Contenido
Resumen	3-9	Motor, puerto, BD, usuario, arquitectura
Schemas	13-26	Tabla con 9 schemas
Schema public	29-123	SQL COMPLETO: tenants, tenant_configs
Schema auth	127-217	SQL COMPLETO: users, sessions, otp_codes
Schema catalog	221-336	SQL COMPLETO: categories, products, product_templates + RLS
Schema sales	340-518	SQL COMPLETO: sales, sale_items, payments, daily_closures
Schema inventory	522-586	SQL COMPLETO: inventory_movements, stock_alerts
Schema customers	590-698	SQL COMPLETO: customers, fiados, fiado_payments + RLS
Schema orders	702-785	SQL COMPLETO: orders, order_items
Schema subscriptions	789-952	SQL COMPLETO: plans, subscriptions, token_packages, token_usage, tenant_token_balance
Schema messaging	957-1065	SQL COMPLETO: conversations, messages, notifications
Funciones Utiles	1069-1139	generate_ticket_number, update_updated_at, update_customer_fiado_balance
Indices Performance	1143-1158	Indices adicionales para reportes
Row Level Security	1163-1176	Configuracion RLS general

---

3. CONTENIDO UNICO POR ARCHIVO

3.1 Contenido UNICO en RESUMEN (a preservar)

Seccion "Convenciones" (lineas 119-136):

## Convenciones

### Columnas Comunes
- `id`: UUID PRIMARY KEY
- `tenant_id`: UUID NOT NULL (multi-tenant)
- `created_at`: TIMESTAMPTZ DEFAULT NOW()
- `updated_at`: TIMESTAMPTZ DEFAULT NOW()
- `is_active`: BOOLEAN DEFAULT TRUE

### Indices
- PK en `id`
- Indice en `tenant_id`
- Indices en FKs
- Indices en columnas de busqueda frecuente

### Triggers
- `set_updated_at`: Actualiza `updated_at` automaticamente

Seccion "Conexion" (lineas 139-146):

## Conexion

Host:     localhost (dev)
Puerto:   5432
Database: michangarrito_dev
Usuario:  michangarrito_dev

Seccion "Scripts" (lineas 150-156):

## Scripts

| Script | Descripcion |
|--------|-------------|
| `database/scripts/create-database.sh` | Crear BD desde cero |
| `database/scripts/recreate-database.sh` | Recrear BD (destructivo) |

Seccion "Referencias" (lineas 159-162):

## Referencias

- [Environment Inventory](../../orchestration/environment/ENVIRONMENT-INVENTORY.yml)
- [Contexto del Proyecto](../../orchestration/00-guidelines/CONTEXTO-PROYECTO.md)

3.2 Contenido UNICO en COMPLETO (ya presente)

• SQL completo de todas las tablas (CREATE TABLE)
• Politicas RLS implementadas
• Funciones PostgreSQL
• Triggers implementados
• Indices de performance
• INSERT de datos seed (plans, token_packages)

---

4. CONTENIDO DUPLICADO (85%)

Tema	En RESUMEN	En COMPLETO	Veredicto
Lista de schemas	Si (tabla)	Si (tabla)	DUPLICADO - Mantener COMPLETO
Nombres de tablas	Si (lista)	Si (con SQL)	DUPLICADO - Mantener COMPLETO
Extensiones	Si (lista)	No	UNICO RESUMEN - Integrar
Multi-tenancy	Si (breve)	Si (RLS completo)	DUPLICADO - Mantener COMPLETO

---

5. REFERENCIAS A ACTUALIZAR

5.1 Referencias Activas al Archivo RESUMEN

Archivo	Linea	Referencia Actual	Nueva Referencia
orchestration/PLAN-IMPLEMENTACION.md	329	../docs/90-transversal/arquitectura/ARQUITECTURA-DATABASE.md	../docs/02-especificaciones/ARQUITECTURA-DATABASE.md
docs/02-especificaciones/ESPECIFICACION-COMPONENTES.md	?	../90-transversal/arquitectura/ARQUITECTURA-DATABASE.md	./ARQUITECTURA-DATABASE.md

---

6. PLAN DE INTEGRACION

Paso 1: Integrar contenido unico al archivo COMPLETO

Agregar al final de 02-especificaciones/ARQUITECTURA-DATABASE.md:

1. Seccion "Extensiones" (si no existe)
2. Seccion "Convenciones"
3. Seccion "Conexion"
4. Seccion "Scripts"
5. Seccion "Referencias"

Paso 2: Actualizar referencias

1. PLAN-IMPLEMENTACION.md: Cambiar ruta
2. ESPECIFICACION-COMPONENTES.md: Cambiar ruta

Paso 3: Eliminar archivo duplicado

1. Eliminar: docs/90-transversal/arquitectura/ARQUITECTURA-DATABASE.md
2. Eliminar carpeta si queda vacia: docs/90-transversal/arquitectura/

---

7. VALIDACION PRE-INTEGRACION

Checklist

• Identificado contenido unico a preservar
• Identificadas referencias a actualizar (2 archivos)
• Plan de integracion definido
• Ejecutar integracion de contenido
• Actualizar referencias
• Validar que no hay referencias rotas
• Eliminar duplicado

---

8. IMPACTO EN FUNCIONALIDADES

Funcionalidad	Impacto	Mitigacion
Documentacion BD	NINGUNO	Contenido se preserva completo
Links en docs	BAJO	Se actualizan 2 referencias
Navegacion	MEJORA	Una sola fuente de verdad

---

Estado: LISTO PARA EJECUTAR INTEGRACION Aprobacion requerida: Si