Bỏ qua nội dung
VNexus VNexus Requirement

Nâng cấp user lên broker

Feature URL
Module
auth
Status
draft
Priority
P1
Platforms
fe · be
AC progress
0 / 4
Last reviewed
2026-05-30

Mục tiêu

Cho phép user thường nâng cấp tài khoản lên broker để có thể sử dụng các quyền và trải nghiệm dành cho môi giới. Thông tin tỉnh và phường giúp hệ thống xác định khu vực hoạt động cơ bản của broker.

Phạm vi

Trong phạm vi (In scope):

  • User đã đăng nhập có thể gửi yêu cầu nâng cấp lên broker.
  • Khi nâng cấp, user bắt buộc nhập tỉnh.
  • Khi nâng cấp, user bắt buộc nhập phường.
  • Hệ thống ghi nhận trạng thái tài khoản sau khi user hoàn tất yêu cầu nâng cấp hợp lệ.

Ngoài phạm vi (Out of scope):

  • Xác minh giấy tờ pháp lý của broker.
  • Quy trình duyệt thủ công bởi admin.
  • Thiết lập gói broker, thanh toán hoặc phân bổ listing sau khi nâng cấp.
  • Thu thập giá mong muốn của broker.

User Stories

  • Là user đã đăng nhập, tôi muốn nâng cấp tài khoản lên broker để sử dụng các chức năng dành cho môi giới.
  • Là user muốn trở thành broker, tôi muốn khai báo tỉnh và phường hoạt động để hệ thống ghi nhận khu vực môi giới của tôi.

Luồng chức năng

sequenceDiagram
    actor User
    User->>App: Chọn nâng cấp lên broker
    App-->>User: Hiển thị form chọn tỉnh và phường
    User->>App: Chọn tỉnh và phường
    App->>App: Kiểm tra dữ liệu bắt buộc
    App->>BE: Gửi yêu cầu nâng cấp hợp lệ
    BE-->>App: Ghi nhận tài khoản broker
    App-->>User: Hiển thị kết quả nâng cấp thành công

Acceptance Criteria

  • AC-1: Khi user mở luồng nâng cấp lên broker, hệ thống hiển thị form chọn tỉnh và phường.
  • AC-2: Khi user chưa chọn tỉnh, hệ thống không cho hoàn tất nâng cấp và hiển thị lỗi phù hợp.
  • AC-3: Khi user chưa chọn phường, hệ thống không cho hoàn tất nâng cấp và hiển thị lỗi phù hợp.
  • AC-4: Khi nâng cấp thành công, user được ghi nhận là broker và nhìn thấy trạng thái/kết quả nâng cấp thành công.

Quy tắc nghiệp vụ

  • Chỉ user đã đăng nhập mới được nâng cấp lên broker.
  • Tỉnh là thông tin bắt buộc khi nâng cấp lên broker.
  • Phường là thông tin bắt buộc khi nâng cấp lên broker.
  • Danh sách phường hiển thị theo tỉnh đã chọn.
  • User đã là broker không cần thực hiện lại luồng nâng cấp cơ bản.

Dữ liệu & Trạng thái

Entity nghiệp vụ:

  • BrokerUpgradeRequest: user, tỉnh, phường, trạng thái xử lý.
  • BrokerProfile: user, tỉnh hoạt động, phường hoạt động.

Trạng thái user-facing:

  • not_broker — user chưa nâng cấp lên broker.
  • broker_upgrade_form — user đang nhập thông tin nâng cấp.
  • broker — user đã được ghi nhận là broker.
  • validation_error — thông tin bắt buộc còn thiếu hoặc không hợp lệ.

Liên quan