Bỏ qua

API Conventions

Tài liệu chi tiết endpoints xem docs/requirements/04-API-SPECIFICATIONS.md.

Versioning

  • Public API nên được version hoá theo prefix: /api/v1/...
  • API Gateway chịu trách nhiệm routing/proxy tới các services.

Response envelope

Repo đang có BaseResponseDto<T> trong libs/shared/src/dto/base-response.dto.ts.

Khuyến nghị (dần áp dụng, không bắt buộc ngay):

  • Thống nhất response wrapper cho các controller.
  • Chuẩn hoá error object (code/message/details/requestId/traceId) để observability tốt hơn.

Error handling

Repo đã có HttpExceptionFilter trong libs/shared/src/exceptions/http-exception.filter.ts.

Khuyến nghị:

  • Không lộ stack trace ở production.
  • Map lỗi nghiệp vụ về error code rõ ràng.