Một logic không rõ ràng sẽ dẫn đến gì?
- Dev hiểu sai → làm sai
- QA hiểu khác → test lệch
- Khách đọc không hiểu → yêu cầu lại
👉 Một logic xử lý không rõ ràng là gốc rễ của rất nhiều vòng lặp sai sót
Mô tả logic – không cần dài dòng, nhưng phải đủ
Cấu trúc cơ bản:
Trigger / Điều kiện bắt đầu
“Khi user nhấn nút ‘Lưu’”
Xử lý chính
“Nếu trường A không null → lưu DB A
Nếu null nhưng B có dữ liệu → insert vào B”Kết quả đầu ra
“Hiển thị message ‘Lưu thành công’ nếu không lỗi”
Nguyên tắc mô tả logic tốt
1. Dùng cấu trúc IF – THEN – ELSE rõ ràng
Đừng lẫn lộn nhiều điều kiện trong 1 câu
2. Tránh từ mơ hồ: xử lý, hiển thị, thực hiện
Thay vào: “Gửi API”, “Hiển thị toast message màu đỏ”, “Lưu vào bảng xxx”
3. Có sơ đồ flow hoặc bảng nếu logic nhiều bước
Dev hiểu bằng luồng – không chỉ chữ
Mình thường dùng cách nào?
Bắt đầu bằng bảng:
Trường hợp Điều kiện Xử lý Kết quả Case A A ≠ null Insert A Show OK Case B A = null, B ≠ null Insert B Show OK Sau đó thêm đoạn mô tả tóm tắt:
“Ưu tiên xử lý A. Nếu không có A thì xử lý B.”
Kết luận
Logic rõ ràng = tiết kiệm thời gian cho cả dev, QA và chính bạn.
Là BrSE, hãy luôn viết logic theo hướng người đọc không cần đoán.
👉 Bài tiếp theo: “Tài liệu càng chi tiết càng tốt? Khi nào nên dừng lại?”