Luồng xử lý — Circle

Luồng xử lý chính

Luồng này mô tả điều gì xảy ra khi request đi qua module circle: server kiểm tra token, validate input, áp rule nghiệp vụ, rồi ghi DB/Redis hoặc enqueue job.

Happy path đi thẳng xuống; nhánh đỏ bên phải là nơi request dừng sớm.

Điểm quyết định	Điều kiện	Nhánh True →	Nhánh False →	Code kiểm tra ở đâu
Token hợp lệ	Route có authorization và bearer token verify được	Đi tiếp validate/controller	Trả 401/403	src/middlewares/auth.ts
Input hợp lệ	Route có validate(schema) và Zod pass	Gọi controller/service	Trả 400 validation failed	src/modules/circle/circle.routes.ts
Business rule pass	Service tìm thấy resource và quyền hợp lệ	Ghi DB/queue/provider	Throw exception hoặc Error	src/modules/circle/service/circle.service.ts

src/modules/circle/circle.routes.ts

Kiểm tra auth trước khi đọc userId. Bước này tồn tại để lỗi được phát hiện trước khi dữ liệu sai vào DB hoặc worker.

src/modules/circle/controller/circle.controller.ts

Validate DTO để tránh payload sai vào service. Bước này tồn tại để lỗi được phát hiện trước khi dữ liệu sai vào DB hoặc worker.

src/modules/circle/service/circle.service.ts

Service kiểm tra rule domain trước khi mutate. Bước này tồn tại để lỗi được phát hiện trước khi dữ liệu sai vào DB hoặc worker.

src/modules/circle/service/circle-enery.service.ts

Repository/provider thực thi side effect. Bước này tồn tại để lỗi được phát hiện trước khi dữ liệu sai vào DB hoặc worker.