refactor

docs/architecture/USECASES.md

@@ -168,6 +168,90 @@ export class SponsorsController {
 }
 
 
+⸻
+
+Payments Example
+
+Application Layer
+
+Use Case
+
+@Injectable()
+export class CreatePaymentUseCase {
+  constructor(
+    private readonly paymentRepository: IPaymentRepository,
+    private readonly output: UseCaseOutputPort<CreatePaymentResult>,
+  ) {}
+
+  async execute(input: CreatePaymentInput): Promise<Result<void, ApplicationErrorCode<CreatePaymentErrorCode>>> {
+    // business logic
+    const payment = await this.paymentRepository.create(payment);
+
+    this.output.present({ payment });
+
+    return Result.ok(undefined);
+  }
+}
+
+Result Model
+
+type CreatePaymentResult = {
+  payment: Payment;
+};
+
+API Layer
+
+Presenter
+
+@Injectable()
+export class CreatePaymentPresenter
+  implements UseCaseOutputPort<CreatePaymentResult>
+{
+  private viewModel: CreatePaymentViewModel | null = null;
+
+  present(result: CreatePaymentResult): void {
+    this.viewModel = {
+      payment: this.mapPaymentToDto(result.payment),
+    };
+  }
+
+  getViewModel(): CreatePaymentViewModel | null {
+    return this.viewModel;
+  }
+
+  reset(): void {
+    this.viewModel = null;
+  }
+
+  private mapPaymentToDto(payment: Payment): PaymentDto {
+    return {
+      id: payment.id,
+      // ... other fields
+    };
+  }
+}
+
+Controller
+
+@Controller('/payments')
+export class PaymentsController {
+  constructor(
+    private readonly useCase: CreatePaymentUseCase,
+    private readonly presenter: CreatePaymentPresenter,
+  ) {}
+
+  @Post()
+  async createPayment(@Body() input: CreatePaymentInput) {
+    const result = await this.useCase.execute(input);
+
+    if (result.isErr()) {
+      throw mapApplicationError(result.unwrapErr());
+    }
+
+    return this.presenter.getViewModel();
+  }
+}
+
 ⸻
 
 4. Module Wiring (Composition Root)