Rodax_Software/FactuGES_ERP
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ee040b8335
FactuGES_ERP/docs
History
david ee040b8335 Característica: Mejora de los modelos de facturas proforma y emitidas con atributos de serie de documentos 
- Se han añadido `document_series_id`, `invoice_series_code` e `invoice_reference` a los modelos y instantáneas de facturas emitidas.
- Se han introducido `proforma_series_code` y `proforma_number`, y se han actualizado las referencias en los modelos y instantáneas de las facturas proforma.
- Se han actualizado los esquemas de la base de datos y los scripts SQL para dar cabida a los nuevos campos y garantizar la integridad de los datos.
- Se ha elaborado la documentación correspondiente a las nuevas series de documentos «contrato de instantánea» y «contrato de serie de facturas emitidas».
- Se han implementado scripts SQL de rellenado para completar los registros existentes con los nuevos campos.
2026-08-04 11:05:02 +02:00
..
architecture Docs 2026-07-06 17:47:05 +02:00
customer-invoices 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
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.