User Story: Xem chi tiết nguồn metadata và danh sách field¶

1. Description¶

Là Manager, tôi muốn xem chi tiết một nguồn metadata bao gồm danh sách bảng, cột và kiểu dữ liệu đã trích xuất, để nắm bắt toàn bộ cấu trúc metadata của đơn vị và chuẩn bị cho bước matching.

2. Acceptance Criteria¶

2.1 Happy Path¶

GIVEN Manager đang ở màn hình Danh sách nguồn metadata (SCR-DISC-10)
WHEN Manager nhấn vào một nguồn metadata cụ thể
THEN hệ thống điều hướng đến màn hình Chi tiết nguồn metadata (SCR-DISC-20), hiển thị thông tin tổng quan: tên file, loại file, đơn vị, ngày upload, trạng thái parse, tổng số field
GIVEN Manager đang xem chi tiết nguồn metadata có parse_status = COMPLETED
WHEN Manager xem danh sách field đã trích xuất
THEN hệ thống hiển thị danh sách field bao gồm: tên field, kiểu dữ liệu (nếu có), tên bảng gốc (nếu có), trạng thái matching (PENDING/MATCHED/UNMATCHED/REJECTED)
GIVEN nguồn metadata từ file SQL DDL chứa nhiều bảng
WHEN Manager xem danh sách field
THEN hệ thống nhóm field theo bảng, mỗi nhóm hiển thị tên bảng và danh sách field thuộc bảng đó

2.2 Alternative Paths¶

GIVEN nguồn metadata có parse_status = PROCESSING (đang parse)
WHEN Manager xem chi tiết nguồn metadata
THEN hệ thống hiển thị trạng thái đang xử lý và thông báo "Đang parse file, vui lòng chờ"
GIVEN nguồn metadata có parse_status = FAILED
WHEN Manager xem chi tiết nguồn metadata
THEN hệ thống hiển thị trạng thái lỗi kèm thông báo lỗi chi tiết và nút "Upload lại"
GIVEN nguồn metadata từ file CSV (không có thông tin tên bảng)
WHEN Manager xem danh sách field
THEN hệ thống hiển thị danh sách field không nhóm theo bảng (hoặc nhóm trong một nhóm mặc định)

2.3 Error Cases¶

GIVEN nguồn metadata đã bị xóa hoặc không tồn tại
WHEN Manager truy cập đường dẫn chi tiết nguồn metadata
THEN hệ thống hiển thị thông báo "Nguồn metadata không tồn tại" và điều hướng về màn hình Danh sách nguồn metadata

3. Business Rules¶

Chỉ Manager có quyền xem chi tiết nguồn metadata
Hiển thị đầy đủ thông tin nguồn metadata: tên file, loại file (CSV/DDL/MANUAL), đơn vị, ngày upload, trạng thái parse, số field trích xuất
Field từ file DDL được nhóm theo bảng
Từ màn hình chi tiết, Manager có thể chỉnh sửa field (nếu matching_status cho phép)
Hỗ trợ phân trang và sắp xếp khi danh sách field lớn

4. Traceability¶

Feature: Quản lý Metadata đã Trích xuất

Screens: - SCR-DISC-10: Danh sách nguồn metadata - SCR-DISC-20: Chi tiết nguồn metadata

Business Flows: Không áp dụng

Business Entities: - Metadata Source - Extracted Field

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

Third-Party Integrations: Không áp dụng

5. Out of Scope¶

Upload file hoặc khai báo thủ công (thuộc EP-03-001 và EP-03-002)
Matching field với Anchored Data (thuộc EP-03-004)
Xuất danh sách field ra file