User Story: Tạo mới Data Element trong một Sub Domain¶

1. Description¶

Là Manager, tôi muốn tạo mới một Data Element (đơn vị metadata nhỏ nhất) với đầy đủ thông tin tên, mô tả, kiểu dữ liệu và mã định danh trong một Sub Domain cụ thể, để khai báo các trường dữ liệu cần quản lý trong khung dữ liệu chuẩn của Thành phố.

2. Acceptance Criteria¶

2.1 Happy Path¶

GIVEN Manager đã đăng nhập và đang ở màn hình Dữ liệu định vị (SCR-ANCHOR-10), Sub Domain "DM1.1 - Định danh" đã tồn tại
WHEN Manager click nút "Thêm Data Element" trong context của Sub Domain "DM1.1", nhập tên (VD: "Số CCCD"), mô tả (VD: "Số căn cước công dân 12 số"), kiểu dữ liệu (VD: "Text"), mã định danh (VD: "DE001-DM1.1") trong popup (SCR-ANCHOR-13) và nhấn "Lưu"
THEN Hệ thống lưu Data Element mới với trạng thái DRAFT, hiển thị Data Element dưới Sub Domain cha trên tree table và hiển thị thông báo thành công
GIVEN Manager vừa tạo thành công một Data Element mới
WHEN Hệ thống cập nhật tree table
THEN Data Element mới hiển thị dưới Sub Domain cha với indent sâu hơn và bullet, hiển thị đúng tên và mã định danh

2.2 Alternative Paths¶

GIVEN Manager đang ở popup Thêm Data Element (SCR-ANCHOR-13)
WHEN Manager nhấn nút "Hủy" hoặc đóng popup
THEN Hệ thống đóng popup, không lưu dữ liệu, quay về tree table

2.3 Error Cases¶

GIVEN Mã Data Element "DE001-DM1.1" đã tồn tại trong hệ thống
WHEN Manager nhập mã "DE001-DM1.1" cho Data Element mới và nhấn "Lưu"
THEN Hệ thống hiển thị thông báo lỗi "Mã định danh đã tồn tại trong hệ thống"
GIVEN Manager đang ở popup Thêm Data Element
WHEN Manager nhập mã không đúng format DE[số]-DM[x].[y] (VD: "ABC", "DE001", "DM1.1-DE001")
THEN Hệ thống hiển thị thông báo lỗi "Mã định danh phải theo format DE[số]-DM[x].[y]"
GIVEN Manager đang ở popup Thêm Data Element
WHEN Manager nhập tên dưới 2 ký tự hoặc vượt quá 200 ký tự
THEN Hệ thống hiển thị thông báo lỗi về độ dài tên không hợp lệ
GIVEN Manager đang ở popup Thêm Data Element
WHEN Manager để trống trường mô tả hoặc nhập mô tả dưới 10 ký tự
THEN Hệ thống hiển thị thông báo lỗi "Mô tả là bắt buộc, tối thiểu 10 ký tự"
GIVEN Manager đang ở popup Thêm Data Element
WHEN Manager nhập mô tả vượt quá 2000 ký tự
THEN Hệ thống hiển thị thông báo lỗi "Mô tả tối đa 2000 ký tự"
GIVEN Manager đang ở popup Thêm Data Element
WHEN Manager không chọn kiểu dữ liệu và nhấn "Lưu"
THEN Hệ thống hiển thị thông báo lỗi "Kiểu dữ liệu là bắt buộc"
GIVEN Người dùng đăng nhập với vai trò không phải Manager
WHEN Người dùng cố gắng truy cập chức năng tạo Data Element
THEN Hệ thống không hiển thị nút "Thêm Data Element" trên giao diện

3. Business Rules¶

BR-001: Mã Data Element phải duy nhất trong toàn hệ thống, theo format DE[số]-DM[x].[y] (VD: DE001-DM1.1)
BR-002: Mỗi Data Element phải thuộc đúng một Sub Domain — không thể tồn tại Data Element không gắn với Sub Domain nào
BR-003: Trạng thái khởi tạo mặc định khi tạo mới là DRAFT
BR-004: Tên Data Element tối thiểu 2 ký tự, tối đa 200 ký tự
BR-005: Mô tả Data Element là bắt buộc, tối thiểu 10 ký tự, tối đa 2000 ký tự
BR-006: Kiểu dữ liệu là bắt buộc, chỉ chấp nhận giá trị: Text, Number, Date, Boolean, Enum, Other
BR-008: Chỉ vai trò Manager mới có quyền tạo Data Element
BR-009: Đơn vị chủ quản có thể null khi status = DRAFT
Hệ thống ghi audit log khi tạo Data Element mới

4. Traceability¶

Feature: Quản lý Data Element

Related Use Cases:

UC-ANCHOR-002: Quản lý Data Element

Screens:

Business Entities:

Role Matrix:

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

5. Out of Scope¶

Quản lý Domain và Sub Domain (thuộc Feature EP-02-001)
Thay đổi trạng thái Data Element (DRAFT sang IN_REVIEW, APPROVED, PUBLISHED — thuộc EP-03, EP-04)
Gán đơn vị chủ quản cho Data Element (thuộc quy trình matching)
Import Data Element từ file
Quản lý cơ sở pháp lý (legal_basis)