Nghiệp vụ — Post

Bối cảnh nghiệp vụ

Module này xử lý vòng đời bài viết: tạo post, reply, quote, repost, like, hide, report, update, delete, feed và semantic search.

Ví dụ thực tế: client gọi endpoint của post, server kiểm tra token nếu route yêu cầu, validate dữ liệu, gọi service đúng domain, rồi ghi DB/cache hoặc enqueue job theo đúng nhánh trong code.

Luồng chính — Happy Path

src/modules/post/post.routes.ts

Request vào route. Bước này chuyển dữ liệu sang lớp tiếp theo theo pattern hiện có.

src/modules/post/controller/post.controller.ts

Middleware auth/validate chạy. Bước này chuyển dữ liệu sang lớp tiếp theo theo pattern hiện có.

src/modules/post/service/post.service.ts

Controller gọi service. Bước này chuyển dữ liệu sang lớp tiếp theo theo pattern hiện có.

src/modules/post/dto/post.dto.ts

Service áp dụng rule nghiệp vụ. Đây là bước quan trọng nhất vì service quyết định request có được ghi dữ liệu, enqueue job hoặc bị trả lỗi.

src/modules/post/repository/post.repository.ts

Repository/worker/provider thực thi. Bước này chuyển dữ liệu sang lớp tiếp theo theo pattern hiện có.

src/modules/post/repository/like.repository.ts

Response trả về client. Bước này chuyển dữ liệu sang lớp tiếp theo theo pattern hiện có.

Business Rules — Quy tắc nghiệp vụ

Rule ID	Tên rule	Điều kiện kích hoạt	Hành động	Ví dụ minh họa	File kiểm tra
BR-POST-001	Content bắt buộc 1..5000 ký tự	Create/update	Zod reject request sai format	Post rỗng không vào service	post.dto.ts
BR-POST-002	Mention tối đa 5 và không trùng user	Create/reply/quote	DTO + service kiểm tra duplicate và user tồn tại	Mention trùng bị từ chối	post.dto.ts + post.service.ts
BR-POST-003	Visibility/replyPermission chuẩn hóa enum	Create/update	Sai enum trả BadRequest	public được normalize thành PUBLIC	post.dto.ts
BR-POST-004	Update/delete chỉ owner được làm	PATCH/DELETE	So sánh post.userId với req.user.sub	User A không sửa post B	post.service.ts
BR-POST-005	Like ghi nóng ở Redis trước	POST like	Set Redis + list likes_add/likes_remove, worker sync DB sau	Client thấy count nhanh hơn DB	post.service.ts + like.worker.ts
BR-POST-006	Report không cho tự report	POST report	Target owner là reporter thì Forbidden	Không tự report post của mình	post.service.ts
BR-POST-007	Post report và circle report không dùng lẫn type	POST report	Non-circle dùng POST, circle post dùng CIRCLE	Sai type bị BadRequest	post.service.ts

Các rule trên được rút từ route/service/DTO/worker đã đọc. Nếu một rule ghi [CẦN XÁC NHẬN], phần code hiện tại là stub, TODO hoặc trả dữ liệu mock.

Validations — Kiểm tra dữ liệu đầu vào

Input Validation

Field	Kiểu	Required	Rule	Lỗi nếu vi phạm	Ví dụ hợp lệ	Ví dụ không hợp lệ
Authorization	header	Có với route protected	Bearer access token nếu cần	401	Bearer eyJ...	missing
params	string	Tùy endpoint	Không rỗng theo DTO route	400	publicId/code
query.take	number	Không	int dương, thường max 100 nếu DTO có	400	20	1000
body	object	Tùy endpoint	Theo DTO tương ứng	400	{"content":"Hello"}	{} thiếu field

Business Validation

Điều kiện kiểm tra	Khi nào chạy	Lỗi trả về	Lý do rule này tồn tại
Content bắt buộc 1..5000 ký tự	Create/update	Zod reject request sai format	Ngăn dữ liệu sai đi sâu vào DB hoặc worker.
Mention tối đa 5 và không trùng user	Create/reply/quote	DTO + service kiểm tra duplicate và user tồn tại	Ngăn dữ liệu sai đi sâu vào DB hoặc worker.
Visibility/replyPermission chuẩn hóa enum	Create/update	Sai enum trả BadRequest	Ngăn dữ liệu sai đi sâu vào DB hoặc worker.
Update/delete chỉ owner được làm	PATCH/DELETE	So sánh post.userId với req.user.sub	Ngăn dữ liệu sai đi sâu vào DB hoặc worker.
Like ghi nóng ở Redis trước	POST like	Set Redis + list likes_add/likes_remove, worker sync DB sau	Ngăn dữ liệu sai đi sâu vào DB hoặc worker.