Rodax_Software/FactuGES_ERP
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
92b17ba307
FactuGES_ERP/docs
History
david 92b17ba307 refactor: eliminar mapeadores, repositorios y servicios heredados de proformas 
* Se eliminaron `SequelizeProformaTaxesDomainMapper` y los archivos relacionados.
* Se eliminaron `SequelizeInvoiceRecipientSummaryMapper` y `SequelizeProformaSummaryMapper`.
* Se eliminó `ProformaRepository` y sus métodos asociados.
* Se limpiaron los servicios sin uso, incluido `SequelizeProformaNumberGenerator`.
* Se actualizaron las importaciones y exportaciones de los módulos relacionados para reflejar la eliminación del código heredado.
* Se ajustaron las plantillas para eliminar las referencias a `is_proforma`.
* Se modificó el DTO de la solicitud para excluir el campo `is_proforma`.
2026-08-04 12:09:19 +02:00
..
architecture Docs 2026-07-06 17:47:05 +02:00
customer-invoices refactor: eliminar mapeadores, repositorios y servicios heredados de proformas 2026-08-04 12:09:19 +02:00
dev Actualización de documentación 2026-07-29 11:24:06 +02:00
document-series Característica: Mejora de los modelos de facturas proforma y emitidas con atributos de serie de documentos 2026-08-04 11:05:02 +02:00
factuges Refactor FactuGES Proforma Integration: Update Data Mapping and Add Documentation 2026-08-03 14:26:51 +02:00
frontend Docs 2026-07-06 17:47:05 +02:00
API.md . 2025-04-22 17:09:57 +02:00
CONVENCION NOMBRADO DE ESQUEMAS DTO.md Facturas de cliente y clientes 2025-08-11 19:49:52 +02:00
DsRegistroVeriFactu.xlsx . 2025-04-22 17:09:57 +02:00
DTOS - GUÍA DE DISEÑO.md Muchos cambios 2026-04-20 19:20:42 +02:00
FACTURAS DE CLIENTE.md Facturas de cliente 2025-07-16 17:47:45 +02:00
prompt-auth.md . 2025-06-17 18:18:25 +02:00
prompt-customer-invoices.md Facturas de cliente y Veri*Factu 2025-10-08 18:41:42 +02:00
README.md . 2026-08-03 13:36:29 +02:00
REQUISITOS CLIENTES.md . 2025-04-22 17:09:57 +02:00
REQUISITOS GENERALES.md . 2025-04-22 17:09:57 +02:00
TEMPLATE.md Plantilla para módulos 2025-09-27 21:28:50 +02:00

README.md

ERP Docs

Este directorio reúne la documentación operativa y arquitectónica del ERP.

Contexto técnico

Monorepo con:

  • Node.js >= 22
  • TypeScript
  • PNPM
  • Turborepo
  • ExpressJS
  • MariaDB
  • Sequelize v6
  • Vitest

Arquitectura:

  • DDD pragmático
  • Clean Architecture
  • Separación Domain / Application / Infrastructure
  • SOLID, DRY, KISS, YAGNI, SSOT
  • Fail Fast
  • Defensive Programming
  • Cambios incrementales
  • Evitar sobreingeniería

Documentación vigente

Arquitectura general

Document series

Customer-invoices / proformas

SQL operativos / runbooks vigentes

Referencias de módulos

Histórico / migraciones transicionales

Estado actual resumido

  • El backend nuevo usa modules/identity para autenticación, sesión y control de acceso a companies.
  • modules/companies es la fuente de verdad de la ficha operativa de empresa.
  • El frontend ERP ya usa @erp/identity/client como runtime de autenticación.
  • El flujo actual resuelve sesión, companies disponibles, auto-selección de empresa única y refresh automático sobre 401.

Reglas de lectura rápida

  • modules/auth debe considerarse legacy/deprecated para backend nuevo.
  • GET /companies/available es el endpoint vigente para cargar companies accesibles.
  • GET /identity/companies no es un endpoint válido del diseño actual.
  • GET /account/companies tampoco es un endpoint válido del diseño actual.
  • Las rutas tenant-scoped deben usar Authorization + X-Company-Id.
  • /document-series es la API canónica de series documentales.
  • /catalogs/invoice-series no es un endpoint activo.