AI Tutor provenance visibility depth policy

DEC-0091 - AI Tutor provenance visibility depth policy

Context

Provenance class đã được khóa nhưng chưa có độ sâu hiển thị theo segment, dẫn đến nguy cơ quá tải thông tin hoặc thiếu minh bạch.

Decision

• Chuẩn hóa 3 mức hiển thị provenance:
  • compact: source chip ngắn, ưu tiên dễ đọc.
  • standard: chip + danh sách nguồn tóm tắt.
  • detailed: metadata mở rộng (nguồn, freshness, confidence context).
• Segment default:
  • new learner -> compact.
  • active self-study/course/high-attention -> standard.
  • detailed luôn mở được theo on-demand action (không ép hiển thị mặc định).
• Bất kể mức nào, nếu response dùng general_fallback:
  • luôn hiển thị disclosure giới hạn dữ liệu.

Decision Value

• Cân bằng minh bạch nguồn với tải nhận thức của từng nhóm user.
• Tăng trust mà không làm UI nặng mặc định.

Rationale

Minh bạch không đồng nghĩa hiển thị tối đa mọi lúc; cần depth phù hợp theo segment và mục tiêu tác vụ.

Implications

• Product/UX impact:
  • UI cần hỗ trợ switch hoặc expand provenance depth.
• Data/logic impact:
  • response envelope cần metadata đủ để render nhiều depth.
• Operational impact:
  • QA có thể test trust/disclosure theo depth mode.

Alternatives considered

• Option A: một mức hiển thị cố định cho tất cả user.
• Option B: depth-tier + on-demand detailed expansion (selected).

Open follow-ups

• Tối ưu microcopy disclosure theo ngôn ngữ/segment.

Decision quality check

Decision quality check: DEC-0091

• Score: 10/12
• Weak dimensions: Decision testability (1), Scale risk (1)
• Action: Promoted with acceptance-scenario and microcopy follow-up.