Trang chủ 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:

Đặt dịch vụ từng bước

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

Đặt dịch vụ trong 6 bước

Bước 1 — Chọn dịch vụ

Mở ứng dụng → ở Trang chủ chọn nhóm dịch vụ bạn cần (Dọn nhà, Chăm sóc em bé, Chăm sóc người cao tuổi, Vệ sinh máy lạnh, Chăm sóc thú cưng).

Bước 2 — Tùy chỉnh công việc

Kéo thanh số giờ để chọn thời lượng (ví dụ 3 giờ).
Chọn số phòng, số thú cưng (với Petcare), hoặc công việc thêm như ủi đồ.
Muốn một helper cụ thể? Bật chọn helper đặc biệt và chọn người bạn muốn.

Giá sẽ hiển thị ngay khi bạn thay đổi lựa chọn.

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.

Màn hình — Tab chính

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

Tab chính (Bottom Bar)

Container: Main/BottomBar — bottom tab 4 mục, badge số thông báo chưa đọc trên tab Inbox.

Home — Trang chủ

Tệp: Main/Home.tsx · FR: FR-HOME-01
Thành phần: header (tên + điểm + chọn ngôn ngữ), banner carousel, hàng dịch vụ yêu thích, lưới 5 nhóm dịch vụ (+3 mục sắp ra mắt), mục Cập nhật & khuyến mãi.
Vào/Đi: từ đăng nhập hoặc tab; đi tới Service (chọn dịch vụ), Promotion/Detail (chạm banner), AllService, Favourite/Service.
Trạng thái: pull-to-refresh làm mới; token rỗng → replace sang Auth/Login; lỗi API → Alert và giữ giao diện.
Hành động: chạm dịch vụ → mở cấu hình; chạm mục khuyến mãi → chi tiết.

Booking — Danh sách đơn

Tệp: Main/Booking.tsx · FR: FR-BOOK-05
Thành phần: header với icon lịch (→ Booking/Calendar), hai tab sắp tới / lịch sử, danh sách thẻ đơn.
Hành động: chạm đơn sắp tới → Booking/BookingDetail; chạm đơn lịch sử → Booking/DetailHistory; kéo-cuối tải thêm trang; kéo-tải làm mới (xóa list rồi tải trang 1).

Inbox — Hộp thông báo

Tệp: Main/Inbox.tsx · FR: FR-NOTI-01..03
Thành phần: header (đọc tất cả, xóa), hai tab Thông báo / Khuyến mãi, danh sách dòng (chấm vàng = chưa đọc), checkbox chế độ xóa.
Hành động: chạm mục → đánh dấu đã đọc + mở chi tiết; icon trống → xóa mục đã chọn; “Tất cả” → xóa toàn bộ tab; đọc tất cả → POST read-all rồi refresh.

Account — Tài khoản

Tệp: Main/Account.tsx · FR: FR-PRO-01
Thành phần: khối hồ sơ (ảnh, tên, điểm), danh sách menu (Hồ sơ, Thanh toán, Yêu thích, My Booking, Về chúng tôi, Giới thiệu…), mục đăng xuất.
Hành động: chạm menu → điều hướng màn tương ứng; đăng xuất → hộp xác nhận → xóa token → về Auth/Login.

Bảng thông điệp i18n

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

Bảng thông điệp i18n dùng khi kiểm thử

Tester đối chiếu thông báo trên UI với catalog dưới đây (nguồn: apps/src/shared/I18n/en.ts|vi.ts|th.ts — 3 ngôn ngữ phải đồng bộ về tập khóa).

Xác thực

Khóa	Tiếng Anh (hiển thị)	Khi nào xuất hiện
`auth.register_success`	Account registered successfully	Đăng ký thành công
`auth.token_expired`	Token expired	JWT hết hạn → tự đăng xuất (FR-ACC-05)
`auth.error`	Something wrong	Tiêu đề hộp lỗi chung
`home.error_400`	Request failed with status code 400	Lỗi 400 từ API (dữ liệu không hợp lệ)

Dịch vụ & đặt lịch

Khóa	Tiếng Anh	Khi nào xuất hiện
`home.date_not_min`	You can not select day and time in past	Chọn ngày/giờ trong quá khứ (FR-BOOK-01)
`home.select_your_helper`	Select your helper	Xác nhận khi chưa chọn helper
`home.specify_helper`	Specific helper (if you have)	Nhãn phần helper đặc biệt
`home.suggest_for_you`	Suggest for you	Nhãn danh sách gợi ý
`home.select_age`	(chọn độ tuổi)	Nany: chưa chọn độ tuổi bé

Thanh toán & thẻ

Khóa	Tiếng Anh	Khi nào xuất hiện
`home.add_card_success`	Add card success	Thêm thẻ thành công (FR-PAY-01)
`home.confirm_delete_card`	Confirm delete this card ?	Xác nhận xóa thẻ
`home.permission_camera`	(yêu cầu quyền)	Chụp ảnh thẻ/hồ sơ chưa cấp quyền

Thông báo & danh sách

Khóa	Tiếng Anh	Khi nào xuất hiện
`home.data_empty`	Data empty	Trạng thái trống chung
`home.notification_empty`	Notification is empty	Tab Thông báo rỗng
`home.promotion_empty`	Promotion is empty	Tab Khuyến mãi rỗng
`home.confirm_delete` / `home.yes` / `home.no`	Confirm delete / Yes / No	Hộp xóa thông báo
`home.delete_successfully`	Delete successfully	Xóa thành công
`home.send_review_successfully`	Send review successfully	Gửi đánh giá (FR-HIST-01)
`home.copy_success`	Copy to clipboard success	Copy mã/thông tin

Quy tắc kiểm thử i18n

Mỗi thông báo trên UI phải có khóa tương ứng — không chấp nhận chuỗi cứng (hard-coded) mới.
Đổi ngôn ngữ → mọi khóa ở trên phải đổi theo; khóa thiếu bản dịch là bug (NFR-04).
Thông báo lỗi không được lộ chi tiết kỹ thuật (stack, SQL, đường dẫn).

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₫.

Câu hỏi thường gặp (FAQ)

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

Câu hỏi thường gặp

Tôi phải đăng ký mới đặt được dịch vụ không? Có. Bạn có thể xem dịch vụ khi chưa có tài khoản, nhưng để đặt lịch cần đăng ký và đăng nhập.

App có tính phí sử dụng không? Không. Bạn chỉ trả tiền cho dịch vụ đã đặt (và các phí liên quan hiển thị trước khi xác nhận).

Tôi đặt nhầm giờ, có sửa được không? Được, khi đơn chưa bắt đầu. Vào chi tiết đơn và chọn sửa; sau khi helper bắt đầu làm việc, hãy liên hệ hỗ trợ.

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.

Màn hình — Xác thực

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

Màn hình xác thực

Chỉ hiển thị khi chưa có token. Sau đăng nhập/đăng ký thành công, nhóm này rời khỏi ngăn xếp.

Auth/Login — Đăng nhập

Tệp: Auth/Login.tsx · FR: FR-ACC-02
Thành phần: ô email + mật khẩu, nút Sign In, đăng nhập Google, quên mật khẩu, liên kết sang Đăng ký.
Hành động: đăng nhập thành công → lưu token → Trang chủ → đăng ký token FCM + gọi cập nhật ngôn ngữ.
Lỗi: sai thông tin (thông báo chung), hủy Google (quay lại màn hình), lỗi 400 (thông báo dịch i18n home.error_400).

Auth/Signup — Đăng ký

Tệp: Auth/Signup.tsx · FR: FR-ACC-01
Thành phần: tên, họ, email, số điện thoại, mật khẩu, giới tính, nhà tài trợ (tùy chọn), đồng ý điều khoản.
Hành động: submit hợp lệ → tạo tài khoản → đăng nhập → tới Trang chủ. Lỗi trùng email/biếu thuật → nhãn lỗi tại ô.

Auth/ForgotPassword — Quên mật khẩu

Tệp: Auth/ForgotPassword.tsx · FR: FR-ACC-03
Thành phần: nhập email/SĐT → nhận OTP → nhập OTP + mật khẩu mới.
Lỗi: OTP sai/hết hạn → cho nhập lại; đặt lại xong → về Login.

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₫).

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.

Màn hình — Dịch vụ & đặt lịch

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

Màn hình dịch vụ & đặt lịch

Service — Cấu hình dịch vụ (wizard)

Tệp: ServiceScreen/Service.tsx · FR: FR-SVC-02/03
Thành phần: 3 bước — (1) tùy chọn dịch vụ (giờ, phòng/thú, extra services), (2) ngày giờ + helper + địa chỉ, (3) thanh toán & xác nhận.
Trạng thái: giá cập nhật realtime; khối slider giờ ép khoảng cách tối thiểu 2h; nút bấm qua các bước có validate.
Đi: tạo đơn thành công → thông báo + về danh sách đơn; thanh toán thẻ qua Omise.

AllService — Tất cả dịch vụ

Tệp: ServiceScreen/AllService.tsx · FR: FR-SVC-01
Hành động: chạm một dịch vụ → Service (wizard). Dùng để xem trọn danh mục khi Trang chủ chỉ hiển thị 5 mục.

EditAndReOrderAndEditService — Sửa / đặt lại

Tệp: EditAndReOrderServiceScreen/EditAndReOrderService.tsx
Mục đích: cùng wizard bước 1–3 nhưng chạy chế độ sửa (điền sẵn dữ liệu đơn) hoặc đặt lại dịch vụ cho đơn cũ; bước 3 gọi API sửa đơn thay vì tạo mới.
Vào: từ chi tiết đơn có hành động “Sửa/Đặt lại”.

PaymentPetcare — Thanh toán Petcare / tiền mặt

Tệp: Other/PaymentPetcare.tsx · FR: FR-PAY-03
Mục đích: màn thanh toán riêng cho luồng petcare/đơn tiền mặt, hiển thị thời gian đã chọn và xác nhận thanh toán.

Booking/Calendar — Lịch

Tệp: Booking/Calendar.tsx · FR: FR-BOOK-01
Thành phần: lịch tháng (đổi tháng qua mũi tên, ô hôm nay tô lime), dải khung giờ 06:00–21:00, job đã đặt hiển thị dạng khối trên lưới giờ.
Hành động: chọn khung giờ hợp lệ → truyền ngày giờ về wizard; quá khứ bị chặn.

Booking/BookingDetail — Chi tiết đơn

Tệp: Booking/BookingDetail.tsx · FR: FR-BOOK-04/06/07
Thành phần: bảng thông tin dịch vụ/giờ/địa chỉ, helper, giá & khuyến mãi, nút theo trạng thái (hủy, yêu cầu đặc biệt, xác nhận).
Lỗi: hủy ở trạng thái không cho phép → Alert; thiếu dữ liệu → trạng thái trống.

Booking/DetailHistory — Chi tiết đơn lịch sử

Tệp: Booking/DetailHistory.tsx · FR: FR-HIST-01
Giống BookingDetail nhưng chỉ đọc, cho đơn COMPLETED/CANCEL.

History/List & History/Detail — Lịch sử có lọc ngày

Tệp: History/HistoryList.tsx, History/HistoryDetail.tsx · FR: FR-HIST-01
Thành phần: bộ chọn khoảng ngày (DateTimePicker) + danh sách đơn; chi tiết hiển thị số giờ dịch vụ (duration).

MyBooking/List & MyBooking/Detail — Việc đã đặt

Tệp: MyBooking/ListMyBooking.tsx (Detail tái dùng BookingDetail) · FR: FR-BOOK-05
Mục đích: danh sách việc đã đặt để truy cập nhanh/hủy; hỗ trợ pull-to-refresh và xóa việc.

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).

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.

Màn hình — Kế hoạch & ưu đãi

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

Màn hình kế hoạch (plan) & ưu đãi

FixPlan — Gói cố định

FixPlan/AddFixPlan (Other/FixPlan/AddFixPlan.tsx): tạo gói Fix — chọn dịch vụ, số giờ mỗi buổi, ngày trong tuần (lặp), helper; nút giảm giờ phản hồi giá tức thời (BL-SUB-01).
FixPlan/PickAddress (Other/FixPlan/PickAddress.tsx): chọn địa chỉ + thời gian từng buổi, gợi ý thêm 3 buổi kế tiếp (cùng khung giờ tuần kế); xác nhận gói kèm điểm/khuyến mãi (charges-plan).
FixPlan/ResultPayment (Other/FixPlan/ResultPayment.tsx): trang kết quả sau thanh toán gói — tổng tiền, danh sách buổi đã đặt; nút về trang chủ.

FexiblePlan — Gói linh hoạt

FexiblePlan/ListPlan (Other/FexiblePlan/ListPlan.tsx): danh sách gói Flexible đang bán + gói hiện tại; vào chi tiết để mua/đồng ý.
FexiblePlan/Detail (Other/FexiblePlan/Detail.tsx): chi tiết gói — giá, ưu đãi, công tắc tự động gia hạn (BL-SUB-03), nút mua (Agree) và hủy gói có lý do.
FexiblePlan/Agree (Other/FexiblePlan/Agree.tsx): xác nhận điều khoản và chốt mua gói.

Subscription — Quản lý gói

AllSubscriptionPlan (Subscription/AllSubscriptionPlan.tsx): toàn bộ gói theo nhóm (Flexible/Fix), trạng thái hủy của từng mục.
Subscription/Detail (Subscription/SubscriptionDetail.tsx): gói hiện tại; phần nội dung booking đang vô hiệu hóa (dead code giữ lại) — chỉ hiển thị hai nhãn dẫn tới gói.

Promotion — Khuyến mãi

Promotion/List (Promotion/PromotionList.tsx): danh sách khuyến mãi/news đang chạy.
Promotion/Detail (Promotion/PromotionDetail.tsx): chi tiết khuyến mãi — gallery ảnh, nội dung HTML, điều kiện; là đích deep link của thông báo loại 1/2.

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.

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ý.

Màn hình — Tài khoản & tiện ích

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

Màn hình tài khoản & tiện ích

EditProfile — Sửa hồ sơ

Tệp: Other/EditProfile.tsx · FR: FR-PRO-01
Thành phần: ảnh đại diện (chụp/chọn thư viện), họ tên, giới tính, email, số điện thoại (validate), địa chỉ.
Lỗi: số điện thoại/email sai định dạng → nhãn lỗi; lưu xong → hồ sơ trên Trang chủ cập nhật.

Payment/List — Quản lý thẻ

Tệp: Payment/PaymentList.tsx · FR: FR-PAY-01
Thành phần: danh sách thẻ (4 số cuối, tên, hạn), radio thẻ mặc định, nút xóa có xác nhận, nút Add mở modal Omise (AddCardPayment).
Trạng thái: rỗng → nhãn “chưa có thẻ” + nút thanh toán vô hiệu.

Address & Address/Pick — Sổ địa chỉ

Tệp: Address/Address.tsx, Address/PickAddress.tsx · FR: FR-PRO-02
Address: danh sách địa chỉ đã lưu — thêm/sửa/xóa, đặt mặc định.
Pick: nhập tìm gợi ý hoặc chọn điểm trên bản đồ → trả tọa độ + địa chỉ về màn gọi.

Favourite — Yêu thích

Favourite/Menu (Favourite/Menu.tsx): hai lựa chọn — Dịch vụ yêu thích / Helper yêu thích.
Favourite/Service (Favourite/Service.tsx): danh sách dịch vụ đã thích; chạm → mở dịch vụ; trái tim → bỏ thích.
Favourite/ServiceProvider (Favourite/ServiceProvider.tsx): danh sách helper đã thích; hỗ trợ xóa hàng loạt (checkbox).

InboxDetail — Chi tiết thông báo

Tệp: Other/InboxDetail.tsx · FR: FR-NOTI-01
Hiển thị tiêu đề, thời gian (đổi múi giờ về Việt Nam), nội dung; thông báo đơn hàng kèm chi tiết giờ làm (đổi ra số giờ).

PreferToFriend — Giới thiệu bạn bè

Tệp: Other/PreferToFriend.tsx · FR: FR-REF-01
Danh sách người được giới thiệu (không trùng theo userId), nút chia sẻ; phân trang khi tải thêm.

AboutUs (+ AboutUs/View) — Về chúng tôi

Tệp: Other/AboutUs.tsx
AboutUs nhận url từ route params và mở trong WebView; AboutUs/View là biến thể xem nội dung tĩnh (điều khoản, chính sách).

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.

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ợ).

Giới thiệu

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

Giới thiệu AKAIUNSAN

1. Nền tảng là gì?

AKAIUNSAN là nền tảng trung gian kết nối Khách hàng có nhu cầu chăm sóc nhà cửa với các Người trợ giúp (Helper) đã được xác minh. Khách hàng đặt lịch theo giờ, hệ thống gợi ý helper phù hợp, theo dõi tiến trình đơn hàng, thanh toán bằng thẻ hoặc tiền mặt và đánh giá sau dịch vụ.

2. Các bề mặt sản phẩm

Bề mặt	Công nghệ	Đối tượng	Mục đích
Ứng dụng di động (`apps/`)	React Native + Expo	Khách hàng	Đặt lịch, thanh toán, theo dõi, đánh giá
Trang web (`frontend/`)	Web	Khách hàng / Tiếp thị	Giới thiệu, landing page dịch vụ
Trang quản trị (`admin/`)	React + Vite	Quản trị viên	Quản lý dịch vụ, helper, đơn hàng, khuyến mãi
API (`backend/`)	Express 5 + Sequelize + MariaDB	Hệ thống	Toàn bộ logic dữ liệu và nghiệp vụ

3. Ai nên đọc tài liệu này?

Ban lãnh đạo / Sản phẩm: mục Tổng quan hệ thống, Danh sách tính năng, Yêu cầu chức năng.
Lập trình viên: toàn bộ mục Nghiệp vụ hệ thống — mỗi quy tắc BL- là hợp đồng hành vi cần triển khai đúng.
Kiểm thử viên: Yêu cầu chức năng (tiêu chí chấp nhận) + Hướng dẫn kiểm thử.
Người dùng cuối: Hướng dẫn sử dụng — ngôn ngữ đời thường, không thuật ngữ kỹ thuật.

4. Nguyên tắc ngôn ngữ

Ứng dụng hỗ trợ đa ngôn ngữ (Tiếng Việt, Tiếng Anh, Tiếng Thái). Tài liệu này viết bằng tiếng Việt là ngôn ngữ chuẩn; thuật ngữ kỹ thuật giữ nguyên tiếng Anh kèm giải thích ở Bảng thuật ngữ.

Tổng quan hệ thống

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

Tổng quan hệ thống

1. Sơ đồ kiến trúc mức cao

┌──────────────────┐   ┌──────────────────┐   ┌──────────────────┐
│  Ứng dụng khách  │   │   Trang quản trị │   │    Trang web     │
│  hàng (iOS/      │   │   (admin/)       │   │    (frontend/)   │
│  Android apps/)  │   │                  │   │                  │
└────────┬─────────┘   └────────┬─────────┘   └────────┬─────────┘
         │        HTTPS + JWT│              │
         └──────────────┬────────┴──────────────────────┘
                        ▼
              ┌───────────────────┐        ┌──────────────┐
              │  Backend API      │◄──────►│  MariaDB     │
              │  (Express 5)      │        │  (Dữ liệu)   │
              └─────┬───────┬─────┘        └──────────────┘
                    │       │
        ┌───────────▼──┐  ┌─▼──────────────────────┐
        │ Omise (thẻ)  │  │ Firebase FCM (thông báo)│
        └──────────────┘  └────────────────────────┘

2. Thành phần chính

Thành phần	Vai trò	Ghi chú
API Backend	Mọi nghiệp vụ: tài khoản, đơn hàng, giá, khuyến mãi, thông báo	Bảo vệ bằng JWT
Ứng dụng khách hàng	Điểm chạm chính của khách hàng	Hỗ trợ iOS & Android, đa ngôn ngữ
Trang quản trị	Quản lý nội dung, helper, đơn, khuyến mãi	Dành cho nhân viên vận hành
Omise	Cổng thanh toán thẻ tín dụng/ghi nợ	Lưu thẻ an toàn theo chuẩn PCI
Firebase FCM	Thông báo đẩy realtime	Kèm badge số lượng chưa đọc

3. Môi trường

Môi trường	Dùng để	Dữ liệu
Dev	Phát triển tính năng mới	Dữ liệu giả lập
Staging	Kiểm thử chấp nhận (UAT)	Dữ liệu giống production, đã ẩn danh
Production	Khách hàng thật	Dữ liệu thật — chỉ vận hành mới được vào

4. Vai trò người dùng

Vai trò	Mô tả	Hành động chính
Khách hàng (Customer)	Người đặt dịch vụ	Đăng ký, đặt lịch, thanh toán, đánh giá
Helper (Người trợ giúp)	Người thực hiện dịch vụ	Nhận việc, cập nhật tiến trình
Quản trị viên (Admin)	Nhân viên vận hành nền tảng	Quản lý helper, giá, khuyến mãi, xử lý khiếu nại
Khách (Guest)	Chưa đăng nhập	Xem trang giới thiệu, dịch vụ; phải đăng ký để đặt lịch

API tổng quan

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

API tổng quan

Backend Express 5 tổ chức API thành 5 nhóm route theo tầng truy cập. Số liệu dưới đây lấy trực tiếp từ backend/routes/ (thay đổi khi backend phát triển — đây là bức tranh định hướng, không phải hợp đồng endpoint chi tiết).

1. Các nhóm route

Nhóm	Tệp	Số endpoint	Xác thực	Dùng bởi
Public	`public.route.ts`	25	Không (công khai)	Đăng ký/đăng nhập, quên mật khẩu, banner, danh mục dịch vụ công khai
Client	`client.route.ts`	43	JWT khách hàng	Đơn hàng, địa chỉ, thẻ, thông báo, hồ sơ, gói, yêu thích
Back-office	`backoffice.route.ts`	127	JWT quản trị + phân quyền	Toàn bộ vận hành: dịch vụ, giá, helper, đơn, khuyến mãi
Agency	`agency.route.ts`	8	JWT đối tác	Tích hợp đối tác
Bot	`bot.route.ts`	3	Khóa riêng	Tích hợp chatbot

2. Quy ước bảo mật chung

/client/* yêu cầu Authorization: Bearer <JWT> (clientValidator) — JWT hết hạn → 401 → ứng dụng tự đăng xuất (FR-ACC-05).
/back-office/* yêu cầu JWT quản trị, middleware recordHistory và kiểm tra quyền checkPermission theo từng phân hệ.

3. Nhóm endpoint client hay dùng nhất

Đường dẫn	Phương thức	Mục đích	FR liên quan
`/auth/signin`, `/auth/signup`, `/auth/forget-password`, `/auth/reset-password`	POST	Xác thực	FR-ACC-01..03
`/client/user`, `/client/user/language`	GET / PUT	Hồ sơ, ngôn ngữ	FR-PRO-01, FR-ACC-06
`/client/addresses`	GET / POST / PUT / DELETE	Sổ địa chỉ	FR-PRO-02
`/client/jobs`	GET	Danh sách đơn (lọc `orderStatus`, `page`)	FR-BOOK-05
`/booking/detail`, `/booking/detail/edit`	GET / PUT	Chi tiết / sửa đơn	FR-BOOK-04/06
`/orders/*`	POST	Tạo đơn từng loại dịch vụ, hủy, đánh giá	FR-BOOK-04/06
`/client/credit-cards`	GET / POST / PUT / DELETE	Thẻ thanh toán	FR-PAY-01/02
`/charges`, `/charges-card`, `/charges-plan`	POST	Thực hiện thanh toán	FR-PAY-02/03
`/promotion/*`	GET / POST	Khuyến mãi (áp mã, chi tiết)	FR-PAY-04
`/client/subscriptions`	GET / PUT	Gói dịch vụ	FR-SUB-01..04
`/client/notifications`	GET / POST / DELETE	Thông báo (danh sách, đọc tất cả, xóa)	FR-NOTI-01
`/favourite/services`, `/favourite/service-providers`	GET / POST	Yêu thích	FR-FAV-01
`/services-management*`, `/config-price`, `/config-point`	GET	Dịch vụ, bảng giá, điểm	FR-SVC-02/03

Quản trị & vận hành

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

Trang quản trị & vận hành

1. Trang quản trị (admin)

Xây bằng React 19 + Vite + TanStack Router, chia theo phân hệ:

Phân hệ	Nội dung chính
Dashboard	Tổng quan hoạt động
Apps	Quản lý ứng dụng/dịch vụ hiển thị cho khách
Tasks	Công việc/việc theo dõi
Users	Quản lý người dùng và helper
Chats	Trao đổi/hỗ trợ
Settings	Cấu hình hệ thống, phân quyền

Mọi thao tác quản trị đi qua /back-office/* với JWT + recordHistory (ghi vết) + checkPermission (phân quyền theo phân hệ).

Bảng thuật ngữ

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

Bảng thuật ngữ

Thuật ngữ	Giải thích
AKAIUNSAN	Nền tảng trung gian dịch vụ chăm sóc nhà cửa
Helper	Người trợ giúp thực hiện dịch vụ cho khách hàng
Đơn (Order/Job)	Một lần đặt dịch vụ của khách hàng, có trạng thái riêng
PENDING / MATCH / …	Các mã trạng thái đơn — xem BL-ORD-01
Maid / Nany / Elder / AC / Petcare	Năm nhóm dịch vụ: dọn nhà, chăm bé, chăm người cao tuổi, vệ sinh máy lạnh, chăm thú cưng
Extra service	Dịch vụ thêm mua kèm (ủi đồ, dắt chó đi dạo…)
Flexible plan	Gói linh hoạt: mua giờ dùng dần cho một loại dịch vụ
Fix plan	Gói cố định: lịch lặp theo tuần, ưu đãi giá
Giờ còn lại (hour remain)	Số giờ của gói chưa được sử dụng
Điểm (Point)	Điểm thưởng tích từ đơn thành công, quy đổi được thành tiền giảm giá
Khuyến mãi (Promotion)	Mã giảm giá: giảm tiền mặt hoặc giảm phần trăm
Helper yêu thích	Helper được khách đánh dấu để đặt lại nhanh
Helper đặc biệt	Yêu cầu chỉ định một helper cụ thể cho đơn
Badge	Số chưa đọc hiển thị trên tab thông báo
Deep link	Chạm thông báo mở thẳng màn hình chi tiết tương ứng
JWT	Phiên đăng nhập dạng token, kèm mọi gọi API
Omise	Cổng thanh toán thẻ tín dụng/ghi nợ mà nền tảng sử dụng
FCM	Dịch vụ thông báo đẩy của Google (Firebase Cloud Messaging)
UAT	Kiểm thử chấp nhận trên môi trường staging trước khi ra mắt

Chỉ số tra cứu

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

Chỉ số tra cứu mã định danh

Một trang duy nhất để tra mọi mã yêu cầu/quy tắc đã dùng trong tài liệu. Chọn mã để nhảy tới trang định nghĩa.

Tính năng (F)

Mã	Tên	Trang
`F-ACC-01..06`	Đăng ký, đăng nhập, quên mật khẩu, đổi mật khẩu, phiên, đa ngôn ngữ	Tính năng — Tài khoản
`F-HOME-01`	Trang chủ	Tính năng — Khám phá
`F-SVC-01..03`	Danh mục, tùy chọn, bảng giá động	Tính năng — Khám phá
`F-BOOK-01..07`	Chọn ngày giờ, helper, địa chỉ, tạo đơn, theo dõi, hủy, yêu cầu đặc biệt	Tính năng — Đặt lịch
`F-PAY-01..05`	Thẻ, thanh toán thẻ/tiền mặt, khuyến mãi, điểm	Tính năng — Thanh toán
`F-NOTI-01..03`	Inbox, badge, deep link	Tính năng — Thông báo
`F-PRO-01..02`	Hồ sơ, sổ địa chỉ	Tính năng — Hồ sơ
`F-FAV-01` / `F-HIST-01` / `F-SUB-01` / `F-REF-01`	Yêu thích / Lịch sử & đánh giá / Gói dịch vụ / Giới thiệu	Tính năng — Hồ sơ
`F-ADM-01..04`	Quản trị: dịch vụ & giá, helper, đơn, khuyến mãi	Tính năng — Quản trị

Yêu cầu chức năng (FR)

Nhóm	Các mã	Trang chi tiết
Tài khoản & xác thực	`FR-ACC-01` → `FR-ACC-06`	FR-ACC
Trang chủ	`FR-HOME-01`	FR-HOME/SVC
Dịch vụ	`FR-SVC-01` → `FR-SVC-03`	FR-HOME/SVC
Đặt lịch & đơn	`FR-BOOK-01` → `FR-BOOK-07`	FR-BOOK
Thanh toán	`FR-PAY-01` → `FR-PAY-05`	FR-PAY
Thông báo	`FR-NOTI-01` → `FR-NOTI-03`	FR-NOTI
Hồ sơ & tiện ích	`FR-PRO-01/02`, `FR-FAV-01`, `FR-HIST-01`, `FR-SUB-01`, `FR-REF-01`	FR-PRO & tiện ích

Yêu cầu phi chức năng (NFR)

NFR-01 Hiệu năng · NFR-02 Bảo mật · NFR-03 Sẵn sàng · NFR-04 Đa ngôn ngữ · NFR-05 Giao diện nhất quán · NFR-06 Tương thích · NFR-07 Khả năng kiểm thử · NFR-08 Quan sát · NFR-09 Khả năng truy cập · NFR-10 Dữ liệu cá nhân

Trang chủ 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

Đặt dịch vụ từng bước

Đặt dịch vụ trong 6 bước

Bước 1 — Chọn dịch vụ

Bước 2 — Tùy chỉnh công việc

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

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

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

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

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

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

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

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

Màn hình — Tab chính

Tab chính (Bottom Bar)

Home — Trang chủ

Booking — Danh sách đơn

Inbox — Hộp thông báo

Account — Tài khoản

Bảng thông điệp i18n

Bảng thông điệp i18n dùng khi kiểm thử

Xác thực

Dịch vụ & đặt lịch

Thanh toán & thẻ

Thông báo & danh sách

Quy tắc kiểm thử i18n

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ố

Câu hỏi thường gặp (FAQ)

Câu hỏi thường gặp

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

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

FR-HOME-01 · Trang chủ · C

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

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

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

Màn hình — Xác thực

Màn hình xác thực

Auth/Login — Đăng nhập

Auth/Signup — Đăng ký

Auth/ForgotPassword — Quên mật khẩu

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

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

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

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

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

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

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

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

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

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

Màn hình — Dịch vụ & đặt lịch

Màn hình dịch vụ & đặt lịch

Service — Cấu hình dịch vụ (wizard)

AllService — Tất cả dịch vụ

EditAndReOrderAndEditService — Sửa / đặt lại

PaymentPetcare — Thanh toán Petcare / tiền mặt

Booking/Calendar — Lịch

Booking/BookingDetail — Chi tiết đơn

Booking/DetailHistory — Chi tiết đơn lịch sử

History/List & History/Detail — Lịch sử có lọc ngày

MyBooking/List & MyBooking/Detail — Việc đã đặt

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)