Yêu cầu chức năng on AKAIUNSAN — Tài liệu nghiệp vụ

FR — Tài khoản & xác thực

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

FR-ACC — Tài khoản & xác thực

FR-ACC-01 · Đăng ký tài khoản · Ưu tiên C

Mô tả: Khách tạo tài khoản bằng email/số điện thoại và mật khẩu, sau đó bổ sung họ tên, giới tính, địa chỉ.
Điều kiện kích hoạt: Chạm “Đăng ký” trên màn đăng nhập.
Luồng chính: Nhập email + mật khẩu → hệ thống kiểm tra trùng lặp → tạo tài khoản → đăng nhập tự động → chuyển tới màn hồ sơ.
Tiêu chí chấp nhận:
- Email/số điện thoại đã tồn tại → báo lỗi “Tài khoản đã tồn tại”, không tạo tài khoản.
- Mật khẩu dưới độ dài tối thiểu → báo lỗi tại ô nhập, không gửi yêu cầu.
- Đăng ký thành công → token lưu lại, mở app lần sau không cần đăng nhập lại.

FR-ACC-02 · Đăng nhập · C

Mô tả: Đăng nhập bằng email/mật khẩu hoặc tài khoản Google.
Luồng chính: Nhập thông tin → xác thực → về Trang chủ; thông báo đẩy đăng ký thiết bị sau đăng nhập.
Tiêu chí chấp nhận:
- Sai mật khẩu → báo lỗi chung “Email hoặc mật khẩu không đúng”, không tiết lộ trường nào sai.
- Đăng nhập thành công → token hợp lệ được dùng cho mọi request cần xác thực.
- Đăng nhập Google bị hủy giữa chừng → quay về màn đăng nhập, không crash, không tạo phiên.

FR-ACC-03 · Quên mật khẩu · H

Mô tả: Người dùng nhận mã OTP để đặt lại mật khẩu.
Tiêu chí chấp nhận: OTP sai/hết hạn → báo lỗi, cho nhập lại; đặt lại thành công → đăng nhập được bằng mật khẩu mới, mật khẩu cũ hết hiệu lực.

FR-ACC-04 · Đổi mật khẩu · H

Tiêu chí chấp nhận: Phải nhập mật khẩu hiện tại đúng; sau đổi, các phiên khác có thể bị yêu cầu đăng nhập lại.

FR-ACC-05 · Phiên đăng nhập hết hạn · C

Mô tả: Token hết hạn (mọi API trả 401) → ứng dụng tự đăng xuất.
Tiêu chí chấp nhận:
- Khi token hết hạn, thao tác bất kỳ → hiện cảnh báo “Phiên đăng nhập hết hạn” → về màn Đăng nhập.
- Dữ liệu nháp ở màn hình không giữ lại.

FR-ACC-06 · Đa ngôn ngữ · H

Tiêu chí chấp nhận:
- Đổi ngôn ngữ → toàn bộ nhãn màn hình đổi ngay, gọi API cập nhật ngôn ngữ lên server.
- Ngôn ngữ được khôi phục sau khi đăng nhập lại. Tiếng Việt hiển thị dấu đầy đủ, không lỗi font.

FR — Khám phá dịch vụ

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

FR-HOME / FR-SVC — Trang chủ & khám phá dịch vụ

FR-HOME-01 · Trang chủ · C

Mô tả: Trang chủ gồm: banner khuyến mãi (carousel), dịch vụ nổi bật theo loại, dịch vụ yêu thích, cập nhật & khuyến mãi.
Tiêu chí chấp nhận:
- Vào Trang chủ tải đủ: banner, danh mục dịch vụ, badge số thông báo chưa đọc.
- Kéo-tải (pull-to-refresh) làm mới toàn bộ dữ liệu.
- Chưa đăng nhập (token rỗng) → tự chuyển tới màn Đăng nhập.

FR-SVC-01 · Danh mục dịch vụ · C

Mô tả: 5 nhóm dịch vụ: Maid (dọn nhà), Nany (chăm sóc em bé), Elder (chăm sóc người cao tuổi), AC (vệ sinh máy lạnh), Petcare (chăm sóc thú cưng). Mỗi nhóm hiển thị tên song ngữ và ảnh.
Tiêu chí chấp nhận: Chạm dịch vụ → mở trang cấu hình dịch vụ; dịch vụ chưa mở bán có thể hiển thị trạng thái “sắp ra mắt”.

FR-SVC-02 · Tùy chọn dịch vụ · C

Mô tả: Khách cấu hình số giờ, số phòng/người/thú, dịch vụ thêm (extra services: ủi đồ, dắt chó đi dạo…), chọn helper đặc biệt, nhập ghi chú.
Tiêu chí chấp nhận:
- Giá cập nhật tức thời khi đổi tùy chọn (theo bảng giá BL-PRICE-01).
- Số giờ ngoài khoảng cho phép → không cho tiếp tục, hiển thị nhãn lỗi.

FR-SVC-03 · Bảng giá động · C

Tiêu chí chấp nhận:
- Giá = đơn giá theo giờ × số giờ, cộng giá dịch vụ thêm, trừ ưu đãi gói (xem BL-PRICE-02, BL-SUB-02).
- Khách hàng có gói dịch vụ còn giờ → thấy giá ưu đãi so với khách thường.

FR — Đặt lịch & đơn hàng

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

FR-BOOK — Đặt lịch & đơn hàng

FR-BOOK-01 · Chọn ngày giờ · C

Luồng chính: Mở lịch → chọn ngày → chọn khung giờ bắt đầu (danh sách giờ từ ~06:00–21:00) → giờ kết thúc tự tính theo số giờ dịch vụ.
Tiêu chí chấp nhận:
- Chỉ được chọn ngày hôm nay trở đi; khung giờ đã quá hôm nay không chọn được.
- Với đơn đặt cho ngày mai, giờ bắt đầu phải cách hiện tại tối thiểu theo quy định (BL-BOOK-02).
- Chọn thời lượng lẻ 0.5 giờ (ví dụ 2.5h) hệ thống tự chỉnh về bước 2h nếu vi phạm khoảng cách tối thiểu giữa hai đầu slider.

FR-BOOK-02 · Chọn helper · C

Luồng chính: Hệ thống gọi gợi ý helper phù hợp (theo dịch vụ, địa chỉ, ngôn ngữ, thời gian) → hiển thị danh sách gợi ý và toàn bộ helper → chọn helper hoặc bỏ trống (để hệ thống ghép).
Tiêu chí chấp nhận:
- Danh sách gợi ý trống → vẫn cho tiếp tục, gửi danh sách helper rỗng.
- Helper yêu thích hiển thị đánh dấu; helper được chọn hiển thị tên + ảnh + số sao.

FR-BOOK-03 · Chọn địa chỉ · C

Tiêu chí chấp nhận: Dùng địa chỉ đã lưu hoặc thêm mới (kể cả chọn điểm trên bản đồ); đơn phải có địa chỉ mới tạo được.

FR-BOOK-04 · Tạo đơn · C

Luồng chính: Xem lại (ngày giờ, địa chỉ, helper, tùy chọn, giá) → áp khuyến mãi/điểm (tùy chọn) → chọn phương thức thanh toán → xác nhận.
Tiêu chí chấp nhận:
- Tạo đơn thành công → đơn xuất hiện ở tab “Đang tới” với trạng thái PENDING, nhận thông báo.
- Thanh toán thẻ thất bại → đơn không được tạo ở trạng thái hoàn tất; hiện cảnh báo lỗi.
- Thiếu thông tin bắt buộc (ngày giờ, địa chỉ) → chặn xác nhận và nhấn mạnh ô thiếu.

FR-BOOK-05 · Theo dõi đơn · C

Tiêu chí chấp nhận:
- Tab “Đang tới” liệt kê đơn theo trạng thái PENDING → MATCH → ON_PROCESS → WAITING_CONFIRM → RECEIVED; tab “Lịch sử” liệt kê COMPLETED/CANCEL kèm sao đánh giá và helper.
- Kéo-tải làm mới; kéo xuống cuối tải trang tiếp theo (phân trang).
- Chạm đơn → mở chi tiết với đầy đủ thông tin BL-ORD-01.

FR-BOOK-06 · Hủy đơn · H

Tiêu chí chấp nhận:
- Chỉ hủy được ở trạng thái cho phép (tham chiếu BL-ORD-02); sau hủy, đơn chuyển CANCEL và rời khỏi “Đang tới”.
- Mỗi hủy phải qua hộp xác nhận; hủy lý do được ghi nhận.

FR-BOOK-07 · Yêu cầu đặc biệt · M

Tiêu chí chấp nhận: Đơn ở trạng thái MATCH cho phép gửi yêu cầu đặc biệt cho helper; gửi xong hiện xác nhận.

FR — Thanh toán

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

FR-PAY — Thanh toán

FR-PAY-01 · Quản lý thẻ · C

Luồng chính: Màn Thanh toán → “Thêm” → nhập thông tin thẻ (form Omise) → thẻ được lưu an toàn, chỉ hiển thị 4 số cuối.
Tiêu chí chấp nhận:
- Thêm thẻ thành công → thẻ xuất hiện trong danh sách, có thể đặt làm mặc định (vòng tròn chọn).
- Xóa thẻ phải qua xác nhận; xóa thẻ mặc định → danh sách cập nhật, không còn thẻ mặc định.
- Số thẻ đầy đủ không bao giờ hiển thị trong ứng dụng.

FR-PAY-02 · Thanh toán bằng thẻ · C

Tiêu chí chấp nhận: Tạo đơn với thẻ mặc định → hệ thống trừ tiền; đơn hiển thị đã thanh toán bằng thẻ.

FR-PAY-03 · Thanh toán tiền mặt · H

Tiêu chí chấp nhận: Chọn tiền mặt → đơn tạo thành công không trừ thẻ; helper/admin đối soát khi hoàn thành.

FR-PAY-04 · Khuyến mãi · H

Tiêu chí chấp nhận:
- Mã hợp lệ → giảm tiền (GIFT_MONEY) hoặc giảm phần trăm (GIFT_PERCENT) theo BL-PROMO-01; hiển thị nhãn xác nhận và số tiền giảm.
- Mã sai/hết hạn/không đạt điều kiện → báo lỗi rõ ràng, không giảm giá.

FR-PAY-05 · Điểm thưởng · M

Tiêu chí chấp nhận: Nhập điểm sử dụng → giá giảm theo tỷ lệ quy đổi BL-POINT-01; điểm không đủ hoặc vượt số dư → chặn và báo lỗi; điểm tương ứng bị trừ khi đơn hoàn tất.

FR — Thông báo

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

FR-NOTI — Thông báo

FR-NOTI-01 · Hộp thông báo · C

Luồng chính: Tab Inbox → hai tab con: Thông báo (đơn hàng, loại 0/3) và Khuyến mãi (loại 1/2). Mỗi dòng hiển thị tiêu đề, thời gian (múi giờ Việt Nam), chấm vàng nếu chưa đọc.
Tiêu chí chấp nhận:
- Chạm thông báo đơn hàng → đánh dấu đã đọc, badge giảm 1, mở chi tiết đơn.
- Chạm thông báo khuyến mãi → mở chi tiết khuyến mãi/news tương ứng.
- Chạm “đọc tất cả” → mọi mục tab hiện tại thành đã đọc, badge cập nhật.
- Chế độ xóa: chọn từng mục hoặc “tất cả” → xác nhận → các mục bị xóa, danh sách tải lại.
- Kéo xuống cuối → tải trang tiếp theo (phân trang); kéo xuống đầu → làm mới về trang 1.

FR-NOTI-02 · Badge chưa đọc · C

Tiêu chí chấp nhận: Badge trên tab hiển thị đúng totalUnRead từ server; sau đọc/xóa, badge giảm tương ứng; khi 0 thì ẩn badge.

FR-NOTI-03 · Thông báo đẩy & deep link · C

Tiêu chí chấp nhận:
- Nhận đẩy khi app đang mở và khi app bị đóng (notification đã được ghi nhận hệ thống).
- Mở app từ thông báo → điều hướng đúng màn hình theo loại: đơn hàng → chi tiết đơn; khuyến mãi/news → chi tiết khuyến mãi.
- Đăng ký token thiết bị diễn ra sau đăng nhập; token đổi không mất đăng ký.

FR — Hồ sơ & tiện ích

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

FR-PRO / FR-FAV / FR-HIST / FR-SUB / FR-REF — Hồ sơ & tiện ích

FR-PRO-01 · Hồ sơ cá nhân · H

Tiêu chí chấp nhận: Xem/sửa họ tên, giới tính, ngày sinh; chọn ảnh đại diện từ thư viện/chụp máy; lưu xong dữ liệu mới hiển thị ngay ở Trang chủ (tên, điểm).

FR-PRO-02 · Sổ địa chỉ · C

Tiêu chí chấp nhận: Thêm địa chỉ (gõ tìm gợi ý hoặc chọn trên bản đồ), sửa, xóa (có xác nhận); địa chỉ dùng cho đơn mới; xóa địa chỉ đang dùng không làm lỗi màn khác.

FR-FAV-01 · Yêu thích · M

Tiêu chí chấp nhận: Đánh dấu dịch vụ/helper yêu thích → xuất hiện ở Trang chủ và trong màn chọn helper; bỏ yêu thích → rời khỏi danh sách.

FR-HIST-01 · Lịch sử & đánh giá · H

Tiêu chí chấp nhận:
- Đơn COMPLETED hiển thị đầy đủ: dịch vụ, helper (ảnh, sao), thời gian, địa chỉ, tổng tiền.
- Đánh giá sao (1–5) gửi thành công và hiển thị ở danh sách lịch sử.

FR-SUB-01 · Gói dịch vụ · H

Tiêu chí chấp nhận:
- Xem gói hiện tại (Flexible/Fix) và danh sách gói đang bán.
- Bật/tắt tự động gia hạn — trạng thái công tắc phản ánh đúng server.
- Hủy gói qua xác nhận; sau khi hủy, ưu đãi giá của gói ngừng áp dụng cho đơn mới.

FR-REF-01 · Giới thiệu bạn bè · M

Tiêu chí chấp nhận: Xem danh sách lời giới thiệu; chia sẻ thông tin tới bạn bè; trạng thái được ghi nhận trong danh sách.