User Story: Chỉnh sửa thông tin field đã khai báo thủ công¶

1. Description¶

Là Manager, tôi muốn chỉnh sửa hoặc xóa thông tin field đã khai báo thủ công trước khi chạy matching, để đảm bảo metadata chính xác và đầy đủ trước khi tiến hành đối chiếu với Anchored Data.

2. Acceptance Criteria¶

2.1 Happy Path¶

GIVEN Manager đã khai báo thủ công danh sách field cho một đơn vị và các field đang ở trạng thái matching_status = PENDING
WHEN Manager mở chi tiết nguồn metadata thủ công và chọn chỉnh sửa một field
THEN hệ thống cho phép Manager sửa tên field, kiểu dữ liệu, mô tả và tên bảng gốc
GIVEN Manager đã chỉnh sửa thông tin field
WHEN Manager xác nhận lưu thay đổi
THEN hệ thống cập nhật thông tin Extracted Field tương ứng và giữ nguyên matching_status = PENDING
GIVEN Manager muốn xóa một field đã khai báo thủ công đang ở trạng thái PENDING
WHEN Manager chọn xóa field và xác nhận
THEN hệ thống xóa bản ghi Extracted Field tương ứng và cập nhật tổng số field trong Metadata Source

2.2 Alternative Paths¶

GIVEN Manager muốn thêm field mới vào nguồn metadata thủ công đã tạo trước đó
WHEN Manager mở chi tiết nguồn metadata và chọn "Thêm field"
THEN hệ thống cho phép thêm field mới với matching_status = PENDING vào cùng nguồn metadata
GIVEN Manager muốn xóa nhiều field cùng lúc
WHEN Manager chọn nhiều field và xác nhận xóa
THEN hệ thống xóa tất cả các field đã chọn và cập nhật tổng số field

2.3 Error Cases¶

GIVEN field đã khai báo thủ công đang ở trạng thái matching_status = MATCHED (đã được chấp nhận matching)
WHEN Manager cố gắng chỉnh sửa hoặc xóa field đó
THEN hệ thống từ chối thao tác và hiển thị thông báo "Không thể chỉnh sửa field đã ở trạng thái MATCHED. Vui lòng hủy matching trước khi chỉnh sửa"
GIVEN Manager đang chỉnh sửa field và xóa tên field (để trống)
WHEN Manager xác nhận lưu
THEN hệ thống hiển thị thông báo lỗi "Tên field là trường bắt buộc" và không lưu thay đổi

3. Business Rules¶

Chỉ Manager có quyền chỉnh sửa hoặc xóa field đã khai báo thủ công
Manager có thể chỉnh sửa hoặc xóa field bất cứ lúc nào trước khi chạy matching (matching_status = PENDING)
Không cho phép chỉnh sửa field đã ở trạng thái MATCHED -- cần hủy matching trước khi chỉnh sửa
Tên field là bắt buộc khi chỉnh sửa, kiểu dữ liệu và mô tả là tùy chọn
Khi xóa field, hệ thống cập nhật lại tổng số field (field_count) trong Metadata Source

4. Traceability¶

Feature: Khai báo Metadata Thủ công

Screens: - SCR-DISC-11: Popup Nhập 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¶

Chỉnh sửa field đã trích xuất từ upload file (thuộc EP-03-003)
Matching field với Anchored Data (thuộc EP-03-004)
Hủy matching để chuyển field về trạng thái PENDING (thuộc EP-03-005)