History

rckrdmrd a9703b2727 Initial commit - erp-construccion		2026-01-04 06:12:06 -06:00
..
README.md	Initial commit - erp-construccion	2026-01-04 06:12:06 -06:00

README.md

Patrones de Gamilit - ERP Construccion

Fecha: 2025-11-24 Responsable: Architecture-Analyst

Proposito

Documentar los patrones arquitectonicos de Gamilit adoptados para el ERP de Construccion.

Patrones Adoptados

1. Database Multi-Schema

Referencia: ADR-007

Schemas propuestos para Construccion:
+-- auth_management       # Autenticacion (GENERICO)
+-- core                  # Catalogos (GENERICO)
+-- financial_management  # Financiero (GENERICO)
+-- inventory_management  # Inventarios (GENERICO)
+-- purchasing_management # Compras (GENERICO)
+-- construction_mgmt     # ESPECIFICO: Obras, lotes, prototipos
+-- infonavit_compliance  # ESPECIFICO: INFONAVIT
+-- estimates_mgmt        # ESPECIFICO: Estimaciones

Estado: Adoptado - Pendiente implementacion

2. Sistema SSOT (Single Source of Truth)

Referencia: ADR-004

Backend como fuente de verdad
Script sync-enums.ts para sincronizar
Validacion pre-commit

Estado: Adoptado - Pendiente implementacion

3. Feature-Sliced Design (Frontend)

Referencia: ADR-009

frontend/src/
+-- shared/           # Componentes reutilizables
+-- features/
|   +-- director/     # Dashboard director
|   +-- residente/    # Vistas residente
|   +-- almacenista/  # Inventarios
|   +-- portal/       # Derechohabientes
+-- pages/
+-- app/

Estado: Adoptado - Pendiente migracion

4. Path Aliases

Referencia: ADR-005

@shared - Componentes compartidos
@modules - Modulos de negocio
@construccion - Especificos de construccion

Estado: Adoptado - Pendiente configuracion

5. RLS Policies

Referencia: ADR-006

Row-Level Security en PostgreSQL
Policies por tenant y rol
159+ policies planeadas

Estado: Parcialmente implementado (~20 policies)

Patrones NO Adoptados (Gaps de Gamilit)

Patron	Razon	Alternativa
Sin Docker	Gamilit no tiene Docker	Implementar Docker (ADR recomendado)
Sin CI/CD	Gamilit deployment manual	Implementar GitHub Actions
14% Test Coverage	Inaceptable	Objetivo 70%+ (ADR-010)

Referencias

Estado: Patrones documentados y adoptados via ADRs