Bỏ qua

User Story: Chỉnh sửa thông tin đơn vị

1. Description

Là Admin, tôi muốn chỉnh sửa thông tin của một đơn vị đã có trong cây tổ chức (tên, mã, thông tin liên hệ, trạng thái hoạt động), để cập nhật thông tin chính xác và quản lý trạng thái hoạt động của đơn vị.

2. Acceptance Criteria

2.1 Happy Path

AC-001: Chỉnh sửa tên và thông tin liên hệ của đơn vị - GIVEN Admin đang ở màn hình Quản lý cây tổ chức (SCR-SYS-30) và chọn một đơn vị hiện có - WHEN Admin nhấn nút "Sửa", thay đổi tên đơn vị và thông tin liên hệ trong Popup Sửa đơn vị (SCR-SYS-31), rồi nhấn "Lưu" - THEN Hệ thống cập nhật thông tin đơn vị, hiển thị tên mới trên cây tổ chức và thông báo "Cập nhật đơn vị thành công"

AC-002: Chỉnh sửa mã định danh đơn vị - GIVEN Admin đang chỉnh sửa thông tin đơn vị trong Popup Sửa đơn vị (SCR-SYS-31) - WHEN Admin thay đổi mã định danh thành một mã mới chưa tồn tại trong hệ thống và nhấn "Lưu" - THEN Hệ thống cập nhật mã định danh mới cho đơn vị

AC-003: Vô hiệu hóa đơn vị - GIVEN Admin đang chỉnh sửa thông tin một đơn vị đang hoạt động (is_active = true) - WHEN Admin chuyển trạng thái sang vô hiệu hóa (is_active = false) và nhấn "Lưu" - THEN Hệ thống hiển thị cảnh báo danh sách người dùng thuộc đơn vị này cần được xem xét, yêu cầu Admin xác nhận trước khi lưu

AC-004: Kích hoạt lại đơn vị - GIVEN Admin đang chỉnh sửa thông tin một đơn vị đã vô hiệu hóa (is_active = false) - WHEN Admin chuyển trạng thái sang hoạt động (is_active = true) và nhấn "Lưu" - THEN Hệ thống kích hoạt lại đơn vị và hiển thị thông báo "Kích hoạt đơn vị thành công"

2.2 Alternative Paths

AC-005: Hủy thao tác chỉnh sửa - GIVEN Admin đã thay đổi thông tin trong Popup Sửa đơn vị - WHEN Admin nhấn nút "Hủy" hoặc đóng popup - THEN Hệ thống đóng popup, không lưu thay đổi, thông tin đơn vị giữ nguyên trạng thái trước đó

AC-006: Admin xác nhận cảnh báo khi vô hiệu hóa đơn vị - GIVEN Hệ thống đang hiển thị cảnh báo về người dùng thuộc đơn vị sắp bị vô hiệu hóa - WHEN Admin nhấn "Xác nhận" - THEN Hệ thống lưu trạng thái vô hiệu hóa cho đơn vị

AC-007: Admin hủy cảnh báo khi vô hiệu hóa đơn vị - GIVEN Hệ thống đang hiển thị cảnh báo về người dùng thuộc đơn vị sắp bị vô hiệu hóa - WHEN Admin nhấn "Hủy" - THEN Hệ thống quay lại Popup Sửa đơn vị, trạng thái đơn vị không thay đổi

2.3 Error Cases

AC-008: Mã đơn vị trùng lặp khi chỉnh sửa - GIVEN Trong hệ thống đã tồn tại đơn vị khác có mã "STTTT" - WHEN Admin thay đổi mã định danh của đơn vị hiện tại thành "STTTT" và nhấn "Lưu" - THEN Hệ thống hiển thị lỗi "Mã đơn vị đã tồn tại trong hệ thống"

AC-009: Tên đơn vị không hợp lệ khi chỉnh sửa - GIVEN Admin đang chỉnh sửa tên đơn vị - WHEN Admin nhập tên dưới 2 ký tự hoặc trên 200 ký tự và nhấn "Lưu" - THEN Hệ thống hiển thị lỗi "Tên đơn vị phải từ 2 đến 200 ký tự"

AC-010: Bỏ trống trường bắt buộc khi chỉnh sửa - GIVEN Admin đang chỉnh sửa thông tin đơn vị - WHEN Admin xóa trắng tên đơn vị hoặc mã định danh và nhấn "Lưu" - THEN Hệ thống hiển thị thông báo lỗi chỉ rõ các trường bắt buộc chưa được điền

3. Business Rules

  • Mã đơn vị (code) phải duy nhất trong toàn hệ thống
  • Tên đơn vị từ 2 đến 200 ký tự
  • Khi vô hiệu hóa đơn vị (is_active = false), hệ thống cảnh báo Admin về danh sách người dùng thuộc đơn vị đó cần được xem xét
  • Không thể thay đổi cấp tổ chức (level) nếu việc thay đổi vi phạm cấu trúc phân cấp hiện tại của 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 - SCR-SYS-31: Popup Thêm/Sửa đơn vị

Business Entities: - Organization Unit (Đơn vị tổ chức) - User (Người dùng)

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

5. Out of Scope

  • Thay đổi vị trí đơn vị trong cây phân cấp (đã có Story riêng: Story-005)
  • Lịch sử thay đổi thông tin đơn vị (versioning)
  • Tự động vô hiệu hóa người dùng khi đơn vị bị vô hiệu hóa