.

modules/customer-invoices/src/api/domain/issued-invoices/aggregates/issued-invoice.aggregate.ts

@@ -96,14 +96,10 @@ export class IssuedInvoice
   }
 
   static create(props: IIssuedInvoiceCreateProps, id?: UniqueID): Result<IssuedInvoice, Error> {
-    if (!props.recipient) {
-      return Result.fail(
-        new DomainValidationError(
-          "MISSING_RECIPIENT",
-          "recipient",
-          "Issued invoice requires recipient"
-        )
-      );
+    const validationResult = IssuedInvoice.validateCreateProps(props);
+
+    if (validationResult.isFailure) {
+      return Result.fail(validationResult.error);
     }
 
     const internalItems = IssuedInvoiceItems.create({
@@ -132,6 +128,20 @@ export class IssuedInvoice
     return Result.ok(issuedInvoice);
   }
 
+  private static validateCreateProps(props: IIssuedInvoiceCreateProps): Result<void, Error> {
+    if (!props.recipient) {
+      return Result.fail(
+        new DomainValidationError(
+          "MISSING_RECIPIENT",
+          "recipient",
+          "Issued invoice requires recipient"
+        )
+      );
+    }
+
+    return Result.ok();
+  }
+
   // Rehidratación desde persistencia
   static rehydrate(
     props: InternalIssuedInvoiceProps,

modules/customer-invoices/src/api/domain/issued-invoices/entities/issued-invoice-items/issued-invoice-items.collection.ts

@@ -11,15 +11,15 @@ export type IssuedInvoiceItemsProps = {
 };
 
 export class IssuedInvoiceItems extends Collection<IssuedInvoiceItem> {
-  private _languageCode!: LanguageCode;
-  private _currencyCode!: CurrencyCode;
-  private _globalDiscountPercentage!: Percentage;
+  private languageCode!: LanguageCode;
+  private currencyCode!: CurrencyCode;
+  private globalDiscountPercentage!: Percentage;
 
   constructor(props: IssuedInvoiceItemsProps) {
     super(props.items ?? []);
-    this._languageCode = props.languageCode;
-    this._currencyCode = props.currencyCode;
-    this._globalDiscountPercentage = props.globalDiscountPercentage;
+    this.languageCode = props.languageCode;
+    this.currencyCode = props.currencyCode;
+    this.globalDiscountPercentage = props.globalDiscountPercentage;
   }
 
   public static create(props: IssuedInvoiceItemsProps): IssuedInvoiceItems {
@@ -40,9 +40,9 @@ export class IssuedInvoiceItems extends Collection<IssuedInvoiceItem> {
     // tiene el mismo "currencyCode" y "languageCode" que la colección de items.
     if (
       !(
-        this._languageCode.equals(item.languageCode) &&
-        this._currencyCode.equals(item.currencyCode) &&
-        this._globalDiscountPercentage.equals(item.globalDiscountPercentage)
+        this.languageCode.equals(item.languageCode) &&
+        this.currencyCode.equals(item.currencyCode) &&
+        this.globalDiscountPercentage.equals(item.globalDiscountPercentage)
       )
     )
       return false;

modules/customer-invoices/src/api/domain/issued-invoices/entities/issued-invoice-taxes/issued-invoice-taxes.collection.ts

@@ -1,6 +1,8 @@
 import type { CurrencyCode, LanguageCode } from "@repo/rdx-ddd";
 import { Collection } from "@repo/rdx-utils";
 
+import { InvoiceAmount } from "../../../common";
+
 import type { IssuedInvoiceTax } from "./issued-invoice-tax.entity";
 
 export type IssuedInvoiceTaxesProps = {
@@ -10,16 +12,59 @@ export type IssuedInvoiceTaxesProps = {
 };
 
 export class IssuedInvoiceTaxes extends Collection<IssuedInvoiceTax> {
-  private _languageCode!: LanguageCode;
-  private _currencyCode!: CurrencyCode;
+  private languageCode!: LanguageCode;
+  private currencyCode!: CurrencyCode;
 
   constructor(props: IssuedInvoiceTaxesProps) {
     super(props.taxes ?? []);
-    this._languageCode = props.languageCode;
-    this._currencyCode = props.currencyCode;
+    this.languageCode = props.languageCode;
+    this.currencyCode = props.currencyCode;
   }
 
   public static create(props: IssuedInvoiceTaxesProps): IssuedInvoiceTaxes {
     return new IssuedInvoiceTaxes(props);
   }
+
+  public getTaxableAmount(): InvoiceAmount {
+    return this.items.reduce(
+      (acc, tax) => acc.add(tax.taxableAmount),
+      InvoiceAmount.zero(this.currencyCode.toString())
+    );
+  }
+
+  public getIvaAmount(): InvoiceAmount {
+    return this.items.reduce(
+      (acc, tax) => acc.add(tax.ivaAmount),
+      InvoiceAmount.zero(this.currencyCode.toString())
+    );
+  }
+
+  public getRecAmount(): InvoiceAmount {
+    return this.items.reduce(
+      (acc, tax) => acc.add(tax.recAmount),
+      InvoiceAmount.zero(this.currencyCode.toString())
+    );
+  }
+
+  public getRetentionAmount(): InvoiceAmount {
+    return this.items.reduce(
+      (acc, tax) => acc.add(tax.retentionAmount),
+      InvoiceAmount.zero(this.currencyCode.toString())
+    );
+  }
+
+  public getTaxesAmount(): InvoiceAmount {
+    return this.items.reduce(
+      (acc, tax) => acc.add(tax.taxesAmount),
+      InvoiceAmount.zero(this.currencyCode.toString())
+    );
+  }
+
+  public getTransferredTaxesAmount(): InvoiceAmount {
+    return this.getIvaAmount().add(this.getRecAmount());
+  }
+
+  public getNetTaxesAmount(): InvoiceAmount {
+    return this.getTransferredTaxesAmount().subtract(this.getRetentionAmount());
+  }
 }

modules/customer-invoices/src/api/domain/proformas/aggregates/proforma.aggregate.ts

@@ -116,6 +116,12 @@ export class Proforma extends AggregateRoot<InternalProformaProps> implements IP
 
   // Creación funcional
   static create(props: IProformaCreateProps, id?: UniqueID): Result<Proforma, Error> {
+    const validationResult = Proforma.validateCreateProps(props);
+
+    if (validationResult.isFailure) {
+      return Result.fail(validationResult.error);
+    }
+
     const internalItems = ProformaItems.create({
       items: [],
       languageCode: props.languageCode,
@@ -141,6 +147,10 @@ export class Proforma extends AggregateRoot<InternalProformaProps> implements IP
     return Result.ok(proforma);
   }
 
+  private static validateCreateProps(props: IProformaCreateProps): Result<void, Error> {
+    return Result.ok();
+  }
+
   // Rehidratación desde persistencia
   static rehydrate(props: InternalProformaProps, items: ProformaItems, id: UniqueID): Proforma {
     return new Proforma(props, items, id);
@@ -237,15 +247,17 @@ export class Proforma extends AggregateRoot<InternalProformaProps> implements IP
   }
 
   // Mutabilidad
-  public update(
-    partialProforma: Partial<Omit<IProformaCreateProps, "companyId">>
-  ): Result<Proforma, Error> {
-    const updatedProps = {
+  public update(patch: ProformaPatchProps): Result<Proforma, Error> {
+    const candidateProps: InternalProformaProps = {
       ...this.props,
-      ...partialProforma,
-    } as IProformaCreateProps;
+      ...patch,
+    };
 
-    return Proforma.create(updatedProps, this.id);
+    // Validacciones
+
+    Object.assign(this.props, candidateProps);
+
+    return Result.ok();
   }
 
   public issue(): Result<void, Error> {

modules/customers/src/api/domain/aggregates/customer.aggregate.ts

@@ -99,6 +99,12 @@ type CustomerInternalProps = Omit<ICustomerCreateProps, "address" | "defaultTaxe
 
 export class Customer extends AggregateRoot<CustomerInternalProps> implements ICustomer {
   static create(props: ICustomerCreateProps, id?: UniqueID): Result<Customer, Error> {
+    const validationResult = Customer.validateCreateProps(props);
+
+    if (validationResult.isFailure) {
+      return Result.fail(validationResult.error);
+    }
+
     const { address, defaultTaxes, ...internalProps } = props;
 
     const postalAddressResult = PostalAddress.create(address);
@@ -132,6 +138,10 @@ export class Customer extends AggregateRoot<CustomerInternalProps> implements IC
     return Result.ok(contact);
   }
 
+  private static validateCreateProps(props: ICustomerCreateProps): Result<void, Error> {
+    return Result.ok();
+  }
+
   // Rehidratación desde persistencia
   static rehydrate(props: CustomerInternalProps, id: UniqueID): Customer {
     return new Customer(props, id);

modules/customers/src/api/index.ts

@@ -1,16 +1,11 @@
 import type { IModuleServer } from "@erp/core/api";
 
-import { type CustomerPublicServices, customersRouter, models } from "./infrastructure";
-import {
-  type CustomersInternalDeps,
-  buildCustomerPublicServices,
-  buildCustomersDependencies,
-} from "./infrastructure/di";
+import type { ICustomerPublicServices } from "./application";
+import { customersRouter, models } from "./infrastructure";
+import { buildCustomerPublicServices, buildCustomersDependencies } from "./infrastructure/di";
 
 export * from "./infrastructure/sequelize";
 
-export type { CustomerPublicServices };
-
 export const customersAPIModule: IModuleServer = {
   name: "customers",
   version: "1.0.0",
@@ -30,7 +25,10 @@ export const customersAPIModule: IModuleServer = {
     const internal = buildCustomersDependencies(params);
 
     // 2) Servicios públicos (Application Services)
-    const customersServices: CustomerPublicServices = buildCustomerPublicServices(params, internal);
+    const customersServices: ICustomerPublicServices = buildCustomerPublicServices(
+      params,
+      internal
+    );
 
     logger.info("🚀 Customers module dependencies registered", {
       label: this.name,
@@ -60,11 +58,8 @@ export const customersAPIModule: IModuleServer = {
   async start(params) {
     const { app, baseRoutePath, logger, getInternal } = params;
 
-    // Recuperamos el dominio interno del módulo
-    const customersInternalDeps = getInternal<CustomersInternalDeps>("customers");
-
     // Registro de rutas HTTP
-    customersRouter(params, customersInternalDeps);
+    customersRouter(params);
 
     logger.info("🚀 Customers module started", {
       label: this.name,

modules/customers/src/api/infrastructure/express/customers.routes.ts

@@ -1,5 +1,5 @@
 import { mockUser, requireAuthenticated, requireCompanyContext } from "@erp/auth/api";
-import { type ModuleParams, type RequestWithAuth, validateRequest } from "@erp/core/api";
+import { type RequestWithAuth, type StartParams, validateRequest } from "@erp/core/api";
 import { type NextFunction, type Request, type Response, Router } from "express";
 
 import {
@@ -18,11 +18,16 @@ import {
   UpdateCustomerController,
 } from "./controllers";
 
-export const customersRouter = (params: ModuleParams, deps: CustomersInternalDeps) => {
-  const { app, config } = params;
+export const customersRouter = (params: StartParams) => {
+  const { app, config, getInternal } = params;
+
+  // Recuperamos el dominio interno del módulo
+  const deps = getInternal<CustomersInternalDeps>("customers");
 
   const router: Router = Router({ mergeParams: true });
 
+  // ----------------------------------------------
+
   // 🔐 Autenticación + Tenancy para TODO el router
   if (process.env.NODE_ENV === "development" || process.env.NODE_ENV === "production") {
     router.use(

modules/factuges/src/api/index.ts

@@ -46,7 +46,7 @@ export const factugesAPIModule: IModuleServer = {
    * - NO construye dominio
    */
   async start(params) {
-    const { app, baseRoutePath, logger, getInternal, getService, listServices } = params;
+    const { logger } = params;
 
     // Registro de rutas HTTP
     factugesRouter(params);