RequestDto & ResponseDto

Backend API body နှင့် response တိုင်းတွင် RequestDto<T> / ResponseDto<T> ကို အသုံးပြုရပါမည်။ Raw payload ပြန်ခြင်း သို့မဟုတ် unwrapped @Body မလုပ်ရပါ။

ခြုံငုံသုံးသပ်ချက်

Envelope တစ်ခုတည်း — payload + status + message + referenceId။ Controller သည် body.payload ကို ဖတ်ပြီး ResponseDto.ok / okWithEmpty / error ပြန်ပေးရပါသည်။

Backend — @quan-erp/shared-backend-core
Frontend — @quan-erp/shared-frontend-core (simplified)
Raw entity / bare DTO မပြန်ရပါ

1. ResponseDto<T>

Success နှင့် error တို့သည် envelope တူညီပါသည်။

ResponseDto.ok — success + payload
ResponseDto.okWithEmpty — success + null payload
ResponseDto.error — error envelope

Field	Type	မှတ်ချက်
timestamp	string	ISO အချိန်
status	"success" \| "error"	ရလဒ်
message	string?	အသုံးပြုသူမြင်ရသော စာသား
code	HttpStatus?	Error HTTP status (optional)
referenceId	string	Log / support tracing UUID
payload	T	အမှန်တကယ်သော data

TSXcontroller responses

import {
  Delete,
  Get,
  HttpStatus,
  Post,
  ResponseDto,
} from "@quan-erp/shared-backend-core";

@Get("/profile")
async getProfile() {
  const profile = await this.service.getProfile();
  return ResponseDto.ok(profile);
}

@Delete("/history/:id")
async deleteHistory() {
  await this.service.delete(/* … */);
  return ResponseDto.okWithEmpty();
}

@Post("/update")
async update() {
  try {
    return ResponseDto.ok(
      { success: true },
      { message: "Profile updated successfully" },
    );
  } catch {
    return ResponseDto.error(
      "Failed to update profile",
      HttpStatus.INTERNAL_SERVER_ERROR,
    );
  }
}

2. RequestDto<T>

@Body() သည် RequestDto<T> မျှော်လင့်ပါသည် — data ကို body.payload မှ ယူရပါသည်။

TSXrequest body

import { Body, Post, RequestDto } from "@quan-erp/shared-backend-core";

@Post("/calculate")
async calculate(@Body() body: RequestDto<LoanCalculationDto>) {
  const data = body.payload;
  return ResponseDto.ok(await this.service.calculate(data));
}

3. Frontend pairing

Client တွင် new RequestDto(dto)၊ ResponseDto<T> cast၊ status စစ်ဆေးပြီး payload ပြန်ပေးရပါသည်။

POST/PUT — RequestDto ဖြင့် wrap လုပ်ရပါသည်
status === "error" ဆိုပါက throw လုပ်ရပါသည်
GET fetchFn — payload သာ
Frontend → Platform APIs → RequestDto & ResponseDto