Review & confirm

Ngữ cảnh & mục tiêu

Dùng khi hành động cần sự đồng ý có chủ đích: duyệt đề xuất của Human AI, xác nhận thay đổi dữ liệu hoặc chấp thuận một yêu cầu. Người dùng phải biết ai đề xuất, điều gì thay đổi, đối tượng nào chịu tác động và kết quả sẽ được xác nhận thế nào.

Thử một quyết định

Human Sale đề xuất giảm giá cho một báo giá. Toàn bộ tình huống bên dưới dùng dữ liệu mẫu và không gửi yêu cầu ra hệ thống thật.

Để thử nhánh khác, chọn “Đặt lại mẫu” rồi đổi kết quả mô phỏng. Nhánh lỗi thử lại vẫn giữ kết quả lỗi đã chọn; đổi kịch bản bằng cách đặt lại.

Anatomy của quyết định

State model & phục hồi

Hợp đồng triển khai

Pattern nhận đối tượng và các hành động đã được dịch vụ kiểm tra quyền. Backend phải kiểm tra lại quyền, phiên bản dữ liệu và idempotency khi ghi nhận quyết định.

type ReviewRequest = {
  objectId: string;          // đối tượng bất biến trong phiên review
  revision: string;          // ngăn duyệt dữ liệu đã cũ
  changes: { before: unknown; after: unknown };
  evidence: Evidence[];
  allowedActions: ('approve' | 'reject')[];
};

type Decision = {
  objectId: string;
  revision: string;
  action: 'approve' | 'reject';
  reason?: string;           // bắt buộc khi reject
  idempotencyKey: string;    // giữ nguyên khi retry cùng quyết định
};

type DecisionResult =
  | { status: 'confirmed'; decisionId: string }
  | { status: 'not_applied'; message: string; retryable: boolean }
  | { status: 'unknown'; requestId: string };

Responsive, accessibility & nội dung

Pattern tái sử dụng Button, surface, border, spacing, typography và status token. Màu status nhất quán giữa các brand; không đổi màu thành công theo màu thương hiệu.

Quy chuẩn cho pattern tiếp theo