rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
workspace-v1/projects/erp-construccion/docs/97-adr/ADR-008-api-design.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4 
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

1.7 KiB
Raw Permalink Blame History

ADR-008: API Design RESTful

Estado: Aceptada Fecha: 2025-11-24 Responsable: Architecture-Analyst Proyecto: ERP Construccion

Contexto

APIs deben soportar:

  • Operaciones CRUD para todos los modulos
  • Integraciones con INFONAVIT
  • App movil para asistencias
  • Portal de derechohabientes

Decision

API RESTful con:

  • Versionado: /api/v1/
  • JSON como formato de datos
  • Autenticacion JWT
  • Rate limiting para integraciones externas
/api/v1/
+-- /auth/              # Autenticacion
+-- /projects/          # Proyectos de construccion
+-- /phases/            # Etapas de fraccionamiento
+-- /lots/              # Lotes/viviendas
+-- /estimates/         # Estimaciones
+-- /infonavit/         # Endpoints INFONAVIT
+-- /portal/            # Portal derechohabientes

Justificacion

Referencia a Odoo

  • Odoo usa JSON-RPC, pero REST es mas estandar
  • Endpoints similares a Odoo models

Especifico para Construccion

  • /portal/* para derechohabientes (read-only)
  • /infonavit/* para reportes regulatorios
  • /mobile/* para app de asistencias GPS

Consecuencias

Positivas

  • API estandar y documentada (OpenAPI)
  • Facil integracion con terceros
  • Compatible con app movil

Negativas

  • No tan flexible como GraphQL
  • Mitigacion: Endpoints especificos para reportes complejos

Implementacion

Acciones Requeridas

  • Setup Express con versionado
  • Documentar con OpenAPI/Swagger
  • Implementar rate limiting
  • Endpoints especificos para INFONAVIT

Criterios de Aceptacion

  • Documentacion OpenAPI completa
  • Rate limiting funcional
  • Integracion INFONAVIT probada

Referencias