refactor: split the services to multiple service classes (#202)

2026-02-17 21:30:31 +00:00 · 2023-08-10 20:29:39 +02:00
parent ffef627dc3
commit 26c6ca9e36
150 changed files with 7188 additions and 5007 deletions
--- a/packages/server/src/services/Sales/Receipts/CreateSaleReceipt.ts
+++ b/packages/server/src/services/Sales/Receipts/CreateSaleReceipt.ts
@@ -0,0 +1,106 @@
+import { Service, Inject } from 'typedi';
+import { Knex } from 'knex';
+import {
+  ISaleReceipt,
+  ISaleReceiptCreatedPayload,
+  ISaleReceiptCreatingPayload,
+} from '@/interfaces';
+import events from '@/subscribers/events';
+import TenancyService from '@/services/Tenancy/TenancyService';
+import ItemsEntriesService from '@/services/Items/ItemsEntriesService';
+import UnitOfWork from '@/services/UnitOfWork';
+import { EventPublisher } from '@/lib/EventPublisher/EventPublisher';
+import { SaleReceiptDTOTransformer } from './SaleReceiptDTOTransformer';
+import { SaleReceiptValidators } from './SaleReceiptValidators';
+
+@Service()
+export class CreateSaleReceipt {
+  @Inject()
+  private tenancy: TenancyService;
+
+  @Inject()
+  private itemsEntriesService: ItemsEntriesService;
+
+  @Inject()
+  private eventPublisher: EventPublisher;
+
+  @Inject()
+  private uow: UnitOfWork;
+
+  @Inject()
+  private transformer: SaleReceiptDTOTransformer;
+
+  @Inject()
+  private validators: SaleReceiptValidators;
+
+  /**
+   * Creates a new sale receipt with associated entries.
+   * @async
+   * @param {ISaleReceipt} saleReceipt
+   * @return {Object}
+   */
+  public async createSaleReceipt(
+    tenantId: number,
+    saleReceiptDTO: any
+  ): Promise<ISaleReceipt> {
+    const { SaleReceipt, Contact } = this.tenancy.models(tenantId);
+
+    // Retireves the payment customer model.
+    const paymentCustomer = await Contact.query()
+      .modify('customer')
+      .findById(saleReceiptDTO.customerId)
+      .throwIfNotFound();
+
+    // Transform sale receipt DTO to model.
+    const saleReceiptObj = await this.transformer.transformDTOToModel(
+      tenantId,
+      saleReceiptDTO,
+      paymentCustomer
+    );
+    // Validate receipt deposit account existance and type.
+    await this.validators.validateReceiptDepositAccountExistance(
+      tenantId,
+      saleReceiptDTO.depositAccountId
+    );
+    // Validate items IDs existance on the storage.
+    await this.itemsEntriesService.validateItemsIdsExistance(
+      tenantId,
+      saleReceiptDTO.entries
+    );
+    // Validate the sellable items.
+    await this.itemsEntriesService.validateNonSellableEntriesItems(
+      tenantId,
+      saleReceiptDTO.entries
+    );
+    // Validate sale receipt number uniuqiness.
+    if (saleReceiptDTO.receiptNumber) {
+      await this.validators.validateReceiptNumberUnique(
+        tenantId,
+        saleReceiptDTO.receiptNumber
+      );
+    }
+    // Creates a sale receipt transaction and associated transactions under UOW env.
+    return this.uow.withTransaction(tenantId, async (trx: Knex.Transaction) => {
+      // Triggers `onSaleReceiptCreating` event.
+      await this.eventPublisher.emitAsync(events.saleReceipt.onCreating, {
+        saleReceiptDTO,
+        tenantId,
+        trx,
+      } as ISaleReceiptCreatingPayload);
+
+      // Inserts the sale receipt graph to the storage.
+      const saleReceipt = await SaleReceipt.query().upsertGraph({
+        ...saleReceiptObj,
+      });
+      // Triggers `onSaleReceiptCreated` event.
+      await this.eventPublisher.emitAsync(events.saleReceipt.onCreated, {
+        tenantId,
+        saleReceipt,
+        saleReceiptId: saleReceipt.id,
+        trx,
+      } as ISaleReceiptCreatedPayload);
+
+      return saleReceipt;
+    });
+  }
+}