Enhance pagination and ordering capabilities in API responses

- Updated pagination-response and read-write-controllers documentation to include `orderBy` and `orderType` parameters for sorting results.
- Introduced new `order-clause` module to handle ordering logic, including validation for order types and columns.
- Enhanced `PaginationQueryDto` to support ordering fields in API requests.
- Updated various repository and service classes to implement ordering in database queries.
- Added unit tests for new ordering functionality and ensured existing tests cover the updated behavior.
- Refactored related DTOs to include user and code relations for better data representation in responses.

src/modules/configuration/divisions/divisions.service.ts

@@ -4,7 +4,7 @@ import {
   NotFoundException,
 } from '@nestjs/common';
 import type { PaginationResponse } from '../../../common/http/response';
-import { toListPage } from '../../../common/http/response';
+import { pickUserRelation, toListPage } from '../../../common/http/response';
 import { Status } from '../../../common/value-objects/status/status';
 import type {
   CreateDivisionInput,
@@ -19,6 +19,8 @@ export type ListDivisionsQuery = {
   readonly code?: string;
   readonly status?: string;
   readonly search?: string;
+  readonly orderBy?: string;
+  readonly orderType?: string;
   readonly page?: number;
   readonly limit?: number;
   readonly offset?: number;
@@ -48,6 +50,8 @@ export class DivisionsService {
       code: query.code,
       status: query.status,
       search: query.search,
+      orderBy: query.orderBy,
+      orderType: query.orderType,
       limit: page.limit,
       offset: page.offset,
     });
@@ -221,8 +225,8 @@ export class DivisionsService {
       status: division.status.value,
       createdAt: division.createdAt.value,
       updatedAt: division.updatedAt.value,
-      createdBy: division.createdBy,
-      updatedBy: division.updatedBy,
+      createdBy: pickUserRelation(division.createdByUser),
+      updatedBy: pickUserRelation(division.updatedByUser),
     };
   }