User Story: Xem danh sách gợi ý AI matching phân loại theo confident score¶

1. Description¶

Là Manager, tôi muốn xem danh sách gợi ý AI matching được phân loại theo confident score (vượt ngưỡng, dưới ngưỡng, chưa xử lý), để có cái nhìn tổng quan và ưu tiên rà soát các field cần xử lý thủ công.

2. Acceptance Criteria¶

2.1 Happy Path¶

GIVEN quá trình matching đã hoàn tất và có kết quả
WHEN Manager truy cập màn hình Danh sách gợi ý AI mapping (SCR-MAP-20)
THEN hệ thống hiển thị danh sách kết quả matching được phân loại thành 3 nhóm:
Suggested-high (score >= 0.90): các field có confidence cao — giai đoạn này vẫn cần Manager review
Pending-review (0.60 <= score < 0.90): các field cần Manager rà soát
No-match (score < 0.60): các field không tìm thấy Data Element tương ứng
GIVEN danh sách gợi ý matching đang hiển thị
WHEN Manager muốn lọc theo nhóm kết quả
THEN hệ thống cho phép lọc theo: vượt ngưỡng (auto-matched), dưới ngưỡng (pending-review), không match (no-match), chưa xử lý
GIVEN Manager xem chi tiết một gợi ý matching
WHEN Manager nhấn vào một kết quả cụ thể
THEN hệ thống hiển thị chi tiết: tên field gốc, tên bảng gốc, đơn vị, Data Element được gợi ý, confident score, phương pháp matching (rule-based/AI/combined), lý do gợi ý (reasoning), các gợi ý thay thế (alternatives) nếu có

2.2 Alternative Paths¶

GIVEN Manager muốn xem kết quả matching của một đơn vị cụ thể
WHEN Manager chọn bộ lọc theo đơn vị
THEN hệ thống chỉ hiển thị kết quả matching thuộc đơn vị đã chọn
GIVEN Manager muốn sắp xếp kết quả theo confident score
WHEN Manager chọn sắp xếp theo score (tăng dần hoặc giảm dần)
THEN hệ thống hiển thị danh sách kết quả theo thứ tự confident score được chọn
GIVEN kết quả matching có cả rule-based và AI
WHEN Manager muốn lọc theo phương pháp matching
THEN hệ thống cho phép lọc kết quả theo phương pháp: rule-based, AI, combined

2.3 Error Cases¶

GIVEN chưa có quá trình matching nào được chạy
WHEN Manager truy cập màn hình Danh sách gợi ý AI mapping
THEN hệ thống hiển thị thông báo "Chưa có kết quả matching nào. Vui lòng khởi động matching trước"
GIVEN kết quả matching đã có nhưng Matching Microservice trả về lỗi cho một số field
WHEN Manager xem danh sách gợi ý
THEN hệ thống hiển thị các field bị lỗi trong một nhóm riêng "Lỗi xử lý" kèm nguyên nhân

3. Business Rules¶

Chỉ Manager có quyền xem danh sách gợi ý AI matching
Kết quả matching được phân loại theo confident score:
Score >= 0.90: suggested-high — giai đoạn này vẫn cần human review
0.60 <= Score < 0.90: pending-review -- chờ Manager rà soát
Score < 0.60: no-match -- ghi nhận, chờ Manager quyết định
Giá trị T1, T2 là cấu hình hệ thống (chưa được chốt, cần calibrate qua POC)
Mỗi kết quả matching hiển thị: field gốc, Data Element gợi ý, confident score, phương pháp matching, lý do gợi ý
Decision tree trong Matching Microservice:
Tầng 1 (Rule-based): exact match, pattern match, alias lookup, data type inference
Tầng 2 (AI): gửi field + context tới AI provider khi rule-based không đạt ngưỡng T1
Tầng 3 (Fallback): khi cả rule-based và AI không đạt -- trả về pending-review
Một Extracted Field có thể có nhiều Matching Result (top-N gợi ý), nhưng chỉ 1 được ACCEPTED

4. Traceability¶

Feature: Matching Tự động (Rule-based + AI)

Screens: - SCR-MAP-20: Danh sách gợi ý AI mapping

Business Flows: - BPF-01: Vòng đời Quy hoạch Dữ liệu Thành phố

Business Entities: - Matching Result - Extracted Field - Data Element

Role Matrix: - RM-001: Manager – Quản trị dữ liệu kỹ thuật

Third-Party Integrations: - INT-003: Matching Microservice (Rule-based + AI)

5. Out of Scope¶

Rà soát và override kết quả matching bởi Manager (thuộc EP-03-005)
Xem bản đồ dữ liệu hiện trạng (thuộc EP-03-006)
Cấu hình giá trị threshold T1, T2
Xử lý dữ liệu thực tế -- chỉ xử lý metadata cấu trúc