workspace-v1/projects/erp-core/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

761 B

ADR-008: API Design RESTful

Estado: Aceptada | Fecha: 2025-11-23 | Responsable: Architecture-Analyst

Decisión

RESTful APIs con:

  • Versionado: /api/v1/
  • OpenAPI 3.0 documentation
  • Consistent error responses
  • HATEOAS links (opcional)

Justificación

Referencia a Gamilit

  • REST es estándar industria
  • OpenAPI auto-documentation
  • Versionado permite cambios sin breaking

Referencia a Odoo

  • Odoo usa XML-RPC (legacy), REST es más moderno

Consecuencias

Positivas: Estándar industria, fácil consumir por clientes, documentación auto-generada Negativas: No es tan performante como GraphQL (aceptable para ERP)

Referencias