Bỏ qua

User Story: Xem cấu trúc phân cấp cây tổ chức

1. Description

Là Admin, tôi muốn xem toàn bộ cấu trúc phân cấp cây tổ chức theo dạng cây (tree view), để nắm bắt tổng quan các đơn vị Sở/Ban/Ngành/Phòng và mối quan hệ phân cấp giữa chúng.

2. Acceptance Criteria

2.1 Happy Path

AC-001: Xem toàn bộ cây tổ chức dạng phân cấp - GIVEN Admin đã đăng nhập và truy cập màn hình Quản lý cây tổ chức (SCR-SYS-30) - WHEN Màn hình được tải - THEN Hệ thống hiển thị toàn bộ cây tổ chức theo cấu trúc phân cấp dạng cây (tree view): Tỉnh/Thành phố → Sở/Ban/Ngành → Ban/Cục trực thuộc → Phòng, với mỗi đơn vị hiển thị tên, mã định danh và trạng thái hoạt động

AC-002: Mở rộng/thu gọn nhánh cây tổ chức - GIVEN Admin đang xem cây tổ chức với các đơn vị có đơn vị con - WHEN Admin nhấn vào biểu tượng expand/collapse bên cạnh một đơn vị - THEN Hệ thống mở rộng (hiển thị đơn vị con) hoặc thu gọn (ẩn đơn vị con) nhánh tương ứng

AC-003: Tìm kiếm đơn vị trong cây tổ chức - GIVEN Admin đang ở màn hình Quản lý cây tổ chức - WHEN Admin nhập từ khóa vào ô tìm kiếm (tên đơn vị hoặc mã định danh) - THEN Hệ thống lọc và hiển thị các đơn vị phù hợp với từ khóa, đồng thời tự động mở rộng các nhánh cha chứa đơn vị tìm thấy

AC-004: Phân biệt trạng thái hoạt động của đơn vị - GIVEN Admin đang xem cây tổ chức có chứa đơn vị đã vô hiệu hóa (is_active = false) - WHEN Cây tổ chức hiển thị - THEN Các đơn vị đã vô hiệu hóa được hiển thị với dấu hiệu phân biệt rõ ràng (VD: màu xám, biểu tượng khác biệt) so với đơn vị đang hoạt động

2.2 Alternative Paths

AC-005: Cây tổ chức rỗng - GIVEN Hệ thống chưa có đơn vị nào trong cây tổ chức - WHEN Admin truy cập màn hình Quản lý cây tổ chức - THEN Hệ thống hiển thị thông báo "Chưa có đơn vị nào trong cây tổ chức" và nút "Thêm đơn vị" để bắt đầu tạo

AC-006: Tìm kiếm không có kết quả - GIVEN Admin đang ở màn hình Quản lý cây tổ chức - WHEN Admin nhập từ khóa tìm kiếm không khớp với bất kỳ đơn vị nào - THEN Hệ thống hiển thị thông báo "Không tìm thấy đơn vị phù hợp"

2.3 Error Cases

AC-007: Lỗi tải dữ liệu cây tổ chức - GIVEN Admin truy cập màn hình Quản lý cây tổ chức - WHEN Hệ thống gặp lỗi khi tải dữ liệu cây tổ chức - THEN Hệ thống hiển thị thông báo lỗi "Không thể tải dữ liệu cây tổ chức. Vui lòng thử lại." và nút "Tải lại"

3. Business Rules

  • Cây tổ chức hiển thị theo 4 cấp phân cấp: Tỉnh/Thành phố (TINH) → Sở/Ban/Ngành (SO) → Ban/Cục trực thuộc (BAN) → Phòng (PHONG)
  • Mỗi đơn vị hiển thị tên đơn vị, mã định danh và trạng thái hoạt động
  • Quy mô dự kiến: vài trăm đơn vị, hiệu suất hiển thị phải đảm bảo mượt mà
  • Tìm kiếm hỗ trợ theo tên đơn vị và mã định danh
  • Chỉ Admin mới có quyền truy cập màn hình Quản lý cây tổ chức

4. Traceability

Feature: Quản lý cây tổ chức

Related Use Cases: - UC-SYS-003: Quản lý cây tổ chức

Screens: - SCR-SYS-30: Quản lý cây tổ chức

Business Entities: - Organization Unit (Đơn vị tổ chức)

Role Matrix: - RM-005: Admin – Quản trị hệ thống

5. Out of Scope

  • Xuất cây tổ chức ra file (PDF, Excel)
  • Hiển thị số lượng người dùng thuộc mỗi đơn vị trên tree view
  • Hiển thị số lượng Data Element chủ quản trên tree view