workspace-v1/projects/erp-suite/apps/verticales/construccion/docs/01-analisis-referencias/gamilit
Adrian Flores Cortes 967ab360bb Initial commit: Workspace v1 with 3-layer architecture
Structure:
- control-plane/: Registries, SIMCO directives, CI/CD templates
- projects/: Gamilit, ERP-Suite, Trading-Platform, Betting-Analytics
- shared/: Libs catalog, knowledge-base

Key features:
- Centralized port, domain, database, and service registries
- 23 SIMCO directives + 6 fundamental principles
- NEXUS agent profiles with delegation rules
- Validation scripts for workspace integrity
- Dockerfiles for all services
- Path aliases for quick reference

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-23 00:35:19 -06:00
..
README.md Initial commit: Workspace v1 with 3-layer architecture 2025-12-23 00:35:19 -06:00

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