FactuGES_ERP/modules/customers/src/api/domain/aggregates/customer.aggregate.ts
2026-03-29 21:00:07 +02:00

252 lines
5.7 KiB
TypeScript

import {
AggregateRoot,
type CurrencyCode,
type EmailAddress,
type LanguageCode,
type Name,
type PhoneNumber,
PostalAddress,
type PostalAddressPatchProps,
type PostalAddressProps,
type TINNumber,
type TextValue,
type URLAddress,
type UniqueID,
} from "@repo/rdx-ddd";
import { type Maybe, Result } from "@repo/rdx-utils";
import { type CustomerStatus, CustomerTaxes } from "../value-objects";
export interface ICustomerCreateProps {
companyId: UniqueID;
status: CustomerStatus;
reference: Maybe<Name>;
isCompany: boolean;
name: Name;
tradeName: Maybe<Name>;
tin: Maybe<TINNumber>;
address: PostalAddressProps;
emailPrimary: Maybe<EmailAddress>;
emailSecondary: Maybe<EmailAddress>;
phonePrimary: Maybe<PhoneNumber>;
phoneSecondary: Maybe<PhoneNumber>;
mobilePrimary: Maybe<PhoneNumber>;
mobileSecondary: Maybe<PhoneNumber>;
fax: Maybe<PhoneNumber>;
website: Maybe<URLAddress>;
legalRecord: Maybe<TextValue>;
defaultTaxes: CustomerTaxes;
languageCode: LanguageCode;
currencyCode: CurrencyCode;
}
export type CustomerPatchProps = Partial<
Omit<ICustomerCreateProps, "companyId" | "address" | "status">
> & {
address?: PostalAddressPatchProps;
};
// Customer
export interface ICustomer {
// comportamiento
update(partialCustomer: CustomerPatchProps): Result<Customer, Error>;
// propiedades (getters)
readonly isIndividual: boolean;
readonly isCompany: boolean;
readonly isActive: boolean;
readonly companyId: UniqueID;
readonly reference: Maybe<Name>;
readonly name: Name;
readonly tradeName: Maybe<Name>;
readonly tin: Maybe<TINNumber>;
readonly address: PostalAddress;
readonly emailPrimary: Maybe<EmailAddress>;
readonly emailSecondary: Maybe<EmailAddress>;
readonly phonePrimary: Maybe<PhoneNumber>;
readonly phoneSecondary: Maybe<PhoneNumber>;
readonly mobilePrimary: Maybe<PhoneNumber>;
readonly mobileSecondary: Maybe<PhoneNumber>;
readonly fax: Maybe<PhoneNumber>;
readonly website: Maybe<URLAddress>;
readonly legalRecord: Maybe<TextValue>;
readonly defaultTaxes: CustomerTaxes;
readonly languageCode: LanguageCode;
readonly currencyCode: CurrencyCode;
}
type CustomerInternalProps = Omit<ICustomerCreateProps, "address" | "defaultTaxes"> & {
readonly address: PostalAddress;
readonly defaultTaxes: CustomerTaxes;
};
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);
if (postalAddressResult.isFailure) {
return Result.fail(postalAddressResult.error);
}
const taxes = CustomerTaxes.create(defaultTaxes);
if (taxes.isFailure) {
return Result.fail(taxes.error);
}
const contact = new Customer(
{
...internalProps,
defaultTaxes: taxes.data,
address: postalAddressResult.data,
},
id
);
// Reglas de negocio / validaciones
// ...
// ...
// Disparar eventos de dominio
// ...
// ...
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);
}
public update(partialCustomer: CustomerPatchProps): Result<Customer, Error> {
const { address: partialAddress, ...rest } = partialCustomer;
Object.assign(this.props, rest);
if (partialAddress) {
const addressResult = this.address.update(partialAddress);
if (addressResult.isFailure) {
return Result.fail(addressResult.error);
}
}
return Result.ok();
}
// Getters
public get isIndividual(): boolean {
return !this.props.isCompany;
}
public get isCompany(): boolean {
return this.props.isCompany;
}
public get isActive(): boolean {
return this.props.status.isActive();
}
public get companyId(): UniqueID {
return this.props.companyId;
}
public get reference(): Maybe<Name> {
return this.props.reference;
}
public get name(): Name {
return this.props.name;
}
public get tradeName(): Maybe<Name> {
return this.props.tradeName;
}
public get tin(): Maybe<TINNumber> {
return this.props.tin;
}
public get address(): PostalAddress {
return this.props.address;
}
public get emailPrimary(): Maybe<EmailAddress> {
return this.props.emailPrimary;
}
public get emailSecondary(): Maybe<EmailAddress> {
return this.props.emailSecondary;
}
public get phonePrimary(): Maybe<PhoneNumber> {
return this.props.phonePrimary;
}
public get phoneSecondary(): Maybe<PhoneNumber> {
return this.props.phoneSecondary;
}
public get mobilePrimary(): Maybe<PhoneNumber> {
return this.props.mobilePrimary;
}
public get mobileSecondary(): Maybe<PhoneNumber> {
return this.props.mobileSecondary;
}
public get fax(): Maybe<PhoneNumber> {
return this.props.fax;
}
public get website(): Maybe<URLAddress> {
return this.props.website;
}
public get legalRecord(): Maybe<TextValue> {
return this.props.legalRecord;
}
public get defaultTaxes(): CustomerTaxes {
return this.props.defaultTaxes;
}
public get languageCode(): LanguageCode {
return this.props.languageCode;
}
public get currencyCode(): CurrencyCode {
return this.props.currencyCode;
}
}