DOL English - Validation & Error Handling (UX Supporting)

Positioning Note

• File này là guideline UX cho thông báo lỗi và validation.
• Không mô tả chi tiết kỹ thuật backend.

Purpose

• Giúp user hiểu lỗi nhanh và biết bước tiếp theo ngay lập tức.
• Giảm cảm giác “bị chặn” trong flow đăng nhập.

UX Principles

• Clear:
  • nói đúng vấn đề đang xảy ra.
• Actionable:
  • luôn có CTA hoặc hướng xử lý tiếp theo.
• Calm:
  • giọng điệu ngắn, trung tính, không đổ lỗi user.
• Consistent:
  • cùng loại lỗi dùng cùng cấu trúc câu.

Message Pattern

• Mẫu chuẩn:
  • Vấn đề + Bạn có thể làm gì tiếp.
• Ví dụ:
  • Mã đã hết hạn. Bạn có thể gửi lại mã mới.

Validation Priorities

1. Email

• Báo lỗi format rõ ràng.
• Nếu email không có tài khoản ở login, gợi ý đăng ký ngay.

2. Password

• Báo lỗi ngắn khi sai thông tin.
• Luôn có lối vào Quên mật khẩu.

3. OTP

• Nếu sai/hết hạn, hiển thị CTA gửi lại mã.
• Không để user ở trạng thái bế tắc.

High-impact Error Cases

• Email đã tồn tại ở signup -> chuyển login, giữ email.
• Link reset không hợp lệ -> fallback về OTP.
• Auth thành công nhưng context cũ không hợp lệ -> đưa user đến route gần nhất hợp lệ.

UI Rules

• Ưu tiên inline error gần field gây lỗi.
• Lỗi tổng thể chỉ dùng khi user cần biết trạng thái toàn flow.
• Không dồn nhiều thông báo cùng lúc trên một màn.

Review Checklist (Error UX)

• Lỗi có dễ hiểu trong 1 lần đọc không?
• User có biết bước tiếp theo không?
• Có giữ được nhịp flow thay vì bắt làm lại từ đầu không?

References

• REG_Login_UX_Blueprint.md
• REG_Login_Scenario_Catalog.md
• REG_Login_UX_Review_Checklist.md
• REG_Forgot_Password_Flow_Spec.md

Change log

• 2026-03-05: Rút gọn validation/error docs theo hướng UX supporting, loại bỏ phần kỹ thuật dư thừa.