User Story: Xem tiến trình và kết quả matching tự động¶

1. Description¶

Là Manager, tôi muốn theo dõi tiến trình matching đang chạy nền và xem kết quả tổng hợp sau khi hoàn tất, để nắm bắt tình trạng đối chiếu metadata của đơn vị và biết bao nhiêu field đã được auto-match, bao nhiêu cần rà soát.

2. Acceptance Criteria¶

2.1 Happy Path¶

GIVEN quá trình matching đang chạy ở chế độ background job cho một batch metadata
WHEN Manager xem trạng thái matching
THEN hệ thống hiển thị tiến trình xử lý: số field đã xử lý / tổng số field, phần trăm hoàn thành, thời gian đã chạy
GIVEN quá trình matching đã hoàn tất
WHEN Manager xem kết quả matching
THEN hệ thống hiển thị tổng hợp kết quả:
Tổng số field đã xử lý
Số field suggested-high (score >= T1, cần Manager review)
Số field pending-review (T2 <= score < T1)
Số field no-match (score < T2)
Thời gian xử lý tổng cộng
GIVEN kết quả matching hiển thị cho Manager
WHEN Manager xem danh sách kết quả chi tiết
THEN mỗi kết quả matching hiển thị: tên field gốc, Data Element được gợi ý (nếu có), confident score, phương pháp matching (rule-based/AI/combined), trạng thái (suggested-high/pending-review/no-match), lý do gợi ý

2.2 Alternative Paths¶

GIVEN quá trình matching đã hoàn tất nhưng AI service không khả dụng trong quá trình xử lý
WHEN Manager xem kết quả
THEN hệ thống hiển thị thông báo "AI matching không khả dụng, chỉ sử dụng rule-based matching" kèm theo kết quả từ rule-based
GIVEN Manager muốn xem kết quả matching của lần chạy trước
WHEN Manager truy cập lịch sử matching cho đơn vị
THEN hệ thống cho phép xem kết quả các lần matching trước đó

2.3 Error Cases¶

GIVEN quá trình matching gặp lỗi giữa chừng (ví dụ: Matching Microservice bị gián đoạn)
WHEN Manager xem trạng thái
THEN hệ thống hiển thị thông báo lỗi "Quá trình matching bị gián đoạn" kèm số field đã xử lý thành công và cho phép Manager khởi động lại matching cho các field chưa xử lý
GIVEN quá trình matching hoàn tất nhưng một số field bị lỗi trong quá trình xử lý
WHEN Manager xem kết quả
THEN hệ thống hiển thị danh sách field bị lỗi kèm nguyên nhân, cho phép Manager khởi động matching lại cho các field lỗi

3. Business Rules¶

Chỉ Manager có quyền xem tiến trình và kết quả matching
Matching chạy ở chế độ background job, hiển thị tiến trình cho Manager theo dõi
Kết quả matching được phân loại thành 3 nhóm: suggested-high, pending-review, no-match
Mỗi kết quả matching bao gồm: Data Element ID gợi ý, confident score, phương pháp matching, trạng thái, lý do gợi ý
Khi AI không khả dụng: graceful degradation -- rule-based matching vẫn chạy, field không xử lý được chuyển sang pending-review
Kết quả matching tạo ra các bản ghi Matching Result lưu trong hệ thống

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 (thuộc EP-03-005)
Cấu hình thời gian tự động retry khi matching thất bại
Gửi email thông báo kết quả matching cho Manager