Uecko_ERP/modules/companies/README.md

modules/companies

companies es el módulo independiente y fuente de verdad de la ficha operativa de empresa.

Responsabilidades

Gestiona la entidad Company funcional del ERP:

• datos legales
• datos operativos básicos
• slug
• status

Separación arquitectónica:

• modules/identity: autenticación, cuentas, memberships, acceso account-company
• modules/companies: ficha real de empresa y validación de company activa

Tabla companies

Campos actuales:

id
legal_name
trade_name
tin
slug
email
phone
website
status
created_at
updated_at

Índices esperados:

UNIQUE(slug)
INDEX(status)
INDEX(tin)

Servicios públicos

El módulo expone:

companies:general

Responsabilidad:

• validar existencia y estado activo de la company
• devolver datos públicos/operativos de empresa

No debe asumir:

• memberships
• autenticación por cuenta
• roles/permisos de identity

Dependencias

modules/companies depende de identity.

Uso actual:

• sus endpoints usan requireIdentityAuthenticated(params)
• GET /companies/available no usa requireIdentityTenant(params)

Reglas

• CompanyMembership vive en identity.
• No mover memberships a companies.
• No usar customers para representar la empresa tenant.
• companySlug no debe venir de token, X-Company-Slug ni req.user.companySlug.