Nghiệp vụ hệ thống on AKAIUNSAN — Tài liệu nghiệp vụ

BL — Trạng thái đơn hàng

Mon, 01 Jan 0001 00:00:00 +0000

BL-ORD — Trạng thái đơn hàng

BL-ORD-01 · Các trạng thái

Mã trạng thái dùng thống nhất trong API, ứng dụng và quản trị:

Giá trị	Tên	Ý nghĩa	Ai chuyển đến
`0`	`PENDING` — Chờ xử lý	Khách vừa tạo đơn, chưa ghép helper	Khách hàng (khi tạo đơn)
`1`	`MATCH` — Đã ghép	Đã có helper nhận việc	Hệ thống / Quản trị viên
`2`	`COMPLETED` — Hoàn thành	Dịch vụ đã thực hiện xong	Hệ thống / Helper
`3`	`CANCEL` — Đã hủy	Đơn bị hủy	Khách hàng / Quản trị viên
`4`	`ON_PROCESS` — Đang làm	Helper đang thực hiện dịch vụ	Helper
`5`	`WAITING_CONFIRM` — Chờ xác nhận	Helper xong việc, chờ khách xác nhận	Helper
`6`	`RECEIVED` — Đã nghiệm thu	Khách xác nhận nhận kết quả	Khách hàng

BL-ORD-02 · Luật chuyển trạng thái

Từ	Được phép sang	Điều kiện	Hệ quả
`PENDING`	`MATCH`, `CANCEL`	Có helper nhận / khách hủy	`MATCH` tạo thông báo cho khách; `CANCEL` rời danh sách đang tới
`MATCH`	`ON_PROCESS`, `CANCEL`	Đến giờ làm / khách hủy	`ON_PROCESS` khóa một số sửa đổi trên đơn
`ON_PROCESS`	`WAITING_CONFIRM`	Helper hoàn thành	Không cho hủy thông thường
`WAITING_CONFIRM`	`RECEIVED`	Khách xác nhận	Sinh điểm thưởng, cho phép đánh giá
`RECEIVED`	`COMPLETED`	Chốt sau nghiệm thu/đối soát	Đơn vào lịch sử vĩnh viễn

Hệ quả liên quan:

BL — Giá & điểm

Mon, 01 Jan 0001 00:00:00 +0000

BL-PRICE / BL-POINT — Giá và điểm thưởng

BL-PRICE-01 · Thành giá cơ bản

Giá gốc = Đơn giá theo dịch vụ × Số giờ
        + Giá dịch vụ thêm (ủi, dắt chó…)
        + Phụ phí theo tùy chọn (số phòng / số thú / số người)

Bảng giá theo từng loại dịch vụ do Quản trị viên cấu hình (config-price).
Số giờ cho phép bước lẻ 0.5 giờ; hai đầu khoảng thời gian phải cách nhau tối thiểu 2 giờ.

BL-PRICE-02 · Ưu đãi theo gói dịch vụ

Khách có gói còn giờ được áp bảng giá ưu đãi riêng cho dịch vụ cùng loại (ví dụ gói dọn nhà ưu đãi cho đơn dọn nhà).
Số giờ còn lại của gói giảm dần theo từng đơn áp gói; hết giờ thì về giá gốc.

BL-POINT-01 · Quy đổi điểm

Điểm quy đổi thành tiền theo tỷ lệ cấu hình hệ thống (POINT.MONEY_CONVERT_POINT).
Khách chỉ dùng được điểm ≤ số dư hiện có; điểm dùng ghi giảm ngay khi tạo đơn.

BL-POINT-02 · Tích điểm

Đơn kết thúc thành công (RECEIVED/COMPLETED) sinh điểm thưởng cho khách.
Đơn hủy không sinh điểm; điểm đã dùng cho đơn hủy được hoàn lại theo chính sách hoàn.

Ví dụ bằng số

Dọn nhà 3 giờ, đơn giá 150.000₫/giờ, dịch vụ thêm ủi đồ 50.000₫, có gói giảm 10%, dùng mã giảm 50.000₫: Giá gốc = 450.000 + 50.000 = 500.000₫ → sau gói (−10%) = 450.000₫ → sau mã (−50.000₫) = 400.000₫.

BL — Khuyến mãi

Mon, 01 Jan 0001 00:00:00 +0000

Loại	Tên	Cách giảm
`GIFT_MONEY`	Tặng tiền	Trừ trực tiếp số tiền cấu hình khỏi giá đơn
`GIFT_PERCENT`	Tặng phần trăm	Trừ `%` trên giá đơn (tính trên thành giá trước khuyến mãi)

Mã còn trong thời hạn hiệu lực.
Giá đơn đạt mức tối thiểu (nếu cấu hình).
Một đơn chỉ áp một mã khuyến mãi.
Khuyến mãi áp trước khi tính điểm thưởng (giảm giá làm thay đổi phần điểm quy đổi).

Thành tiền = Giá gốc (BL-PRICE-01)
           − Ưu đãi gói dịch vụ (BL-PRICE-02)
           − Khuyến mãi (BL-PROMO-01)
           − Điểm quy đổi (BL-POINT-01)

Khuyến mãi không hoàn thành tiền mặt; giá trị giảm không vượt thành tiền (tối đa về 0₫).

BL — Gói dịch vụ

Mon, 01 Jan 0001 00:00:00 +0000

BL-SUB — Gói dịch vụ (Subscription)

BL-SUB-01 · Hai loại gói

Loại	Tên	Bản chất
Flexible	Gói linh hoạt	Mua một lượng giờ dùng dần cho một loại dịch vụ; đặt lịch nào cũng trừ giờ
Fix	Gói cố định	Lịch lặp cố định theo tuần (ví dụ 3 buổi/tuần), thường kèm helper cố định

BL-SUB-02 · Ưu đãi giá theo gói

Đơn cùng loại dịch vụ với gói đang hiệu lực được áp bảng giá ưu đãi của gói.
Ưu đãi chỉ áp cho phần giờ còn của gói; phần vượt giới hạn về giá gốc.
Số giờ còn lại hiển thị cho khách khi cấu hình dịch vụ.

BL-SUB-03 · Gia hạn tự động (toggle renew)

Mỗi gói có công tắc tự động gia hạn: bật → khi chu kỳ kết thúc hệ thống gia hạn; tắt → gói kết thúc tự nhiên.
Công tắc trong ứng dụng phải phản ánh đúng trạng thái server sau mỗi lần đổi (gọi API riêng cho flexible và fix).

BL-SUB-04 · Hủy gói

Hủy gói phải qua xác nhận; sau hủy, ưu đãi ngừng áp dụng cho đơn mới (đơn đã tạo không đổi giá).
Hủy không hoàn lại phần giờ đã dùng.

BL-SUB-05 · Quy tắc kết hợp

Một khách có thể có nhiều gói cho nhiều loại dịch vụ, nhưng một đơn chỉ áp ưu đãi của một gói cùng loại dịch vụ.
Gói và khuyến mãi có thể cùng áp cho một đơn (theo BL-PROMO-03).

BL — Ghép helper

Mon, 01 Jan 0001 00:00:00 +0000

BL-HELP — Ghép helper

BL-HELP-01 · Gợi ý helper

Khi khách tới bước chọn helper, hệ thống gọi API gợi ý với: loại dịch vụ, địa chỉ, ngôn ngữ ưu tiên, khung thời gian.
Danh sách gợi ý có thể rỗng — khách vẫn tiếp tục được (hệ thống ghép sau).
Khách có thể chọn helper từ gợi ý, từ toàn bộ helper, hoặc từ helper yêu thích.

BL-HELP-02 · Helper đặc biệt

Khách có thể yêu cầu helper cụ thể (special helper) khi cấu hình dịch vụ; yêu cầu này đi kèm đơn để vận hành ưu tiên ghép.

BL-HELP-03 · Ngôn ngữ & sở thích

Gợi ý ưu tiên helper đúng ngôn ngữ khách chọn trong tùy chọn dịch vụ (khả năng ngôn ngữ của helper).
Helper ở trạng thái hoạt động (ACTIVE) mới xuất hiện trong gợi ý.

BL-HELP-04 · Helper yêu thích

Khách đánh dấu helper yêu thích ở trang chi tiết/sau đánh giá; danh sách hiển thị tại Trang chủ và bước chọn helper.
Chọn helper yêu thích không đảm bảo chắc chắn — vẫn phụ thuộc lịch rảnh của helper.

Quy trình dịch vụ đầu–cuối

Mon, 01 Jan 0001 00:00:00 +0000

Quy trình dịch vụ đầu–cuối

Đăng ký/Đăng nhập
      │
      ▼
Chọn dịch vụ & tùy chọn ──► Giá hiển thị tức thời (BL-PRICE-01)
      │
      ▼
Chọn ngày giờ (FR-BOOK-01) ──► Chọn/gợi ý helper (FR-BOOK-02, BL-HELP-01)
      │
      ▼
Chọn địa chỉ (FR-BOOK-03) ──► Xem lại & áp Khuyến mãi/Điểm (BL-PROMO-03)
      │
      ▼
Tạo đơn → trạng thái PENDING (BL-ORD-01) ──► Thanh toán thẻ/tiền mặt (FR-PAY)
      │
      ▼
Ghép helper → MATCH ──► (có thể gửi Yêu cầu đặc biệt, BL-ORD-04)
      │
      ▼
ON_PROCESS ──► WAITING_CONFIRM ──► Khách xác nhận → RECEIVED
      │
      ▼
Đánh giá sao (BL-ORD-03) + Tích điểm (BL-POINT-02) ──► COMPLETED

Điểm chạm thông báo

Sự kiện	Khách hàng nhận
Đơn được ghép helper (`MATCH`)	Thông báo đẩy + mục trong Inbox
Helper bắt đầu làm (`ON_PROCESS`)	Thông báo đẩy
Helper hoàn thành (`WAITING_CONFIRM`)	Thông báo yêu cầu xác nhận
Khuyến mãi / tin mới	Mục trong tab Khuyến mãi

Hủy & rủi ro

Khách hủy ở PENDING/MATCH theo BL-ORD-02; chính sách phí hoàn do vận hành quyết định trên quản trị.
Sau ON_PROCESS, hủy cần xử lý thủ công qua quản trị viên (liên hệ hỗ trợ).

Nghiệp vụ hệ thống on AKAIUNSAN — Tài liệu nghiệp vụ

BL — Trạng thái đơn hàng

BL-ORD — Trạng thái đơn hàng

BL-ORD-01 · Các trạng thái

BL-ORD-02 · Luật chuyển trạng thái

BL — Giá & điểm

BL-PRICE / BL-POINT — Giá và điểm thưởng

BL-PRICE-01 · Thành giá cơ bản

BL-PRICE-02 · Ưu đãi theo gói dịch vụ

BL-POINT-01 · Quy đổi điểm

BL-POINT-02 · Tích điểm

Ví dụ bằng số

BL — Khuyến mãi

BL-PROMO — Khuyến mãi

BL-PROMO-01 · Loại khuyến mãi

BL-PROMO-02 · Điều kiện áp dụng

BL-PROMO-03 · Thứ tự tính tiền

BL — Gói dịch vụ

BL-SUB — Gói dịch vụ (Subscription)

BL-SUB-01 · Hai loại gói

BL-SUB-02 · Ưu đãi giá theo gói

BL-SUB-03 · Gia hạn tự động (toggle renew)

BL-SUB-04 · Hủy gói

BL-SUB-05 · Quy tắc kết hợp

BL — Ghép helper

BL-HELP — Ghép helper

BL-HELP-01 · Gợi ý helper

BL-HELP-02 · Helper đặc biệt

BL-HELP-03 · Ngôn ngữ & sở thích

BL-HELP-04 · Helper yêu thích

Quy trình dịch vụ đầu–cuối

Quy trình dịch vụ đầu–cuối

Điểm chạm thông báo

Hủy & rủi ro