Sổ tay Vận hành PhimFlix

1 Tổng quan hệ thống

PhimFlix là nền tảng bán tài khoản Netflix chia sẻ (mỗi tài khoản gốc chia thành nhiều slot / profile bán cho nhiều khách). Nguồn tài khoản gồm SELF (công ty tự mua thẻ gia hạn) và CTV (cộng tác viên góp tài khoản, được hoàn tiền theo chu kỳ).

1.1 Các bên tham gia

1.2 Luồng cốt lõi

1.3 Địa chỉ & kênh vận hành

2 Vai trò & phân quyền nội bộ (RBAC)

Khu Admin → Cài đặt → Phân Quyền & Quyền. Máy chủ chặn truy cập theo vai trò — không chỉ ẩn menu. Mỗi thay đổi đều có hộp xác nhận.

2.1 Bốn vai trò mặc định

2.2 Vai trò tùy biến

SUPER_ADMIN bấm “＋ Thêm vai trò tùy biến” → đặt tên + chọn mức truy cập cho từng trong 14 hạng mục (Không / Chỉ xem / Toàn quyền) → dùng lại cho nhiều người. Sửa vai trò tùy biến ảnh hưởng ngay tới mọi người đang giữ nó. Không xoá được vai trò đang có người dùng.

2.3 Tùy chỉnh quyền cho một người

Trong danh sách quản trị viên, bấm “Tùy chỉnh quyền” ở dòng của người đó. Panel cho:

• Đổi vai trò — chọn vai trò khác → bấm “Đổi vai trò” (xoá mọi tùy chỉnh riêng cũ).
• Tinh chỉnh từng hạng mục — chọn mức riêng cho người này; danh sách này đè lên vai trò, có hiệu lực ngay ở request kế tiếp.

3 Tính năng phía khách hàng

Nắm rõ phần này để trả lời khách và tự thao tác kiểm tra khi cần.

3.1 Đăng nhập & tài khoản

• Magic link: khách nhập email → nhận mail có link → bấm vào là đăng nhập. Email chưa có sẽ được tạo tài khoản mới.
• Google: đăng nhập bằng Google. Nếu email đã dùng magic link thì không tạo tài khoản trùng.
• Phiên đăng nhập kéo dài 7 ngày. Thu hồi quyền / xoá tài khoản có hiệu lực ngay ở request kế tiếp (đọc thẳng từ CSDL).
• 2FA: khách tự bật trong Tài khoản → Bảo mật, quét mã bằng app Authenticator. Nhập sai mã 5 lần → khoá tạm ~15 phút.
• Tự yêu cầu xoá tài khoản: khách nhập mã 6 số gửi về email. Tài khoản bị ẩn danh hoá (không xoá cứng) — đơn hàng, đánh giá, giao dịch ví vẫn giữ cho kế toán. Sau khi xoá, không đăng nhập lại được. Tài khoản admin / CTV không tự xoá được.

3.2 Bảng giá & mã giảm giá

• Bảng giá lấy trực tiếp từ cấu hình Gói cước (mục 5.3). Gói bị admin tắt sẽ biến mất và không mua được.
• Mã giảm giá có thể ràng buộc: đơn tối thiểu, chỉ đơn đầu tiên. Mã sai / hết hạn / chưa đạt điều kiện → báo lỗi, không làm hỏng trang.

3.3 Thanh toán mua gói

3.4 Ví tiền & nạp tiền

• Nạp qua MoMo / VietQR. Có mức tối thiểu / tối đa — nhập ngoài khoảng thì khoá nút.
• Lệnh nạp không thanh toán trong 15 phút → tự chuyển “Đã huỷ (quá hạn)”. Nếu tiền về muộn vẫn được cộng lại.
• Màu & nhãn trạng thái: Đang xử lý = cam · Thành công = xanh lá · Thưởng = xanh dương.
• Loại giao dịch: DEPOSIT (nạp) · PURCHASE (mua, số âm) · REFUND (hoàn) · REWARD (thưởng).

3.5 Gói của tôi & lấy mã Netflix

• Danh sách gói + lọc theo tab. Mở rộng thẻ để xem email Netflix, tên profile, PIN, ngày hết hạn.
• Lấy mã OTP đăng nhập Netflix (Request Gate): khách bấm “Lấy mã” → hệ thống khoá (mỗi tài khoản chỉ 1 yêu cầu chờ tại một thời điểm) → khi khách đăng nhập Netflix, Netflix gửi email mã → hệ thống đọc qua Gmail API + bóc tách → trả mã 6 số. Khách đóng modal mà chưa lấy được → khoá tự nhả.
• Xác nhận hộ gia đình (Smart TV): tab riêng. Khách gửi yêu cầu → nhận link xác nhận từ Netflix.
• Lịch sử yêu cầu: xem lại thời gian / loại / trạng thái các lần lấy mã.
• Yêu cầu đổi tài khoản: khách gửi kèm lý do → tự tạo ticket hỗ trợ (playbook 7.3 / SOP-8).
• Gia hạn gói: cộng thêm số ngày của gói, KHÔNG đổi tài khoản Netflix khách đang dùng.

3.6 Đánh giá & chương trình thưởng

• Khách gửi đánh giá — có bộ đếm ký tự và ngưỡng thưởng hiển thị theo cấu hình.
• Đánh giá “sạch” được đăng ngay. Đánh giá có link / số điện thoại / từ khoá cấm → vào hàng chờ duyệt.
• Sau thời gian giữ, thưởng cộng vào ví khách + gửi thông báo & email. Số tiền thưởng tính trên giá trị đơn sau khi trừ mã giảm.

3.7 Live chat, thông báo

• Live chat (khung “Cần hỗ trợ” góc dưới phải) — tự xây, có AI chatbot. CSKH trực và trả lời các hội thoại vượt khả năng bot.
• Trung tâm thông báo — lọc theo nhóm, đánh dấu đã đọc / tất cả.
• Web push — khách bật trong Cài đặt, nhận thông báo khi có mã OTP hoặc giao dịch (iOS cần cài PWA vào màn hình chính).

4 Tính năng phía CTV

CTV là “người thứ 6” trên tài khoản Netflix — đi qua đúng cơ chế Request Gate như khách.

• Bảng điều khiển CTV: hồ sơ nhận tiền (mã hoá), danh sách tài khoản đang quản lý, lịch sử hoàn tiền.
• Xác nhận đã thanh toán Netflix: CTV tải ảnh bill + gửi → chờ Admin duyệt (SOP-3) → được hoàn tiền theo chu kỳ.
• Lấy mã / xác nhận hộ gia đình cho CTV: 2 tab (mã đăng nhập / hộ gia đình); hiển thị danh sách PIN các profile của CTV.

5 Tính năng phía Admin

5.1 Đơn hàng & đối soát INVENTORY ACCOUNTANT (xem)

• Danh sách đơn: lọc theo trạng thái / ngày / từ khoá, xem chi tiết, xuất Excel.
• Đối soát MoMo: với đơn đã trả tiền thật nhưng còn “chờ”, mở chi tiết đơn → bấm “Đối soát MoMo”. Ngoài ra có bộ quét tự động mỗi 5 phút cho đơn/nạp ví MoMo tuổi 3 phút – 6 giờ.
• Đơn qua cổng khác (Pay2S/Stripe/…) treo > 30 phút → hệ thống cảnh báo để đối soát thủ công.

5.2 Kho tài khoản Netflix INVENTORY

• Thẻ tài khoản: ruy-băng chéo tình trạng góc trên trái, tag Nguồn CTV / SELF, dòng “Còn trống X/Y”, email Netflix đầy đủ.
• Thêm tài khoản: nhập thông tin, chọn Nguồn = SELF hoặc CTV; nếu CTV thì chọn CTV cụ thể (tự tạo cộng tác).
• Import hàng loạt: theo cú pháp có giải thích sẵn; tự tạo User nếu email chưa tồn tại.
• Xem chi tiết → Chỉnh sửa: mở ở chế độ xem (khoá sửa), có dòng “Nguồn: CTV [tên] / SELF” và tình trạng tô màu. Bấm “Chỉnh sửa” mới sửa được.
• Đổi CTV A → B: hộp thoại xác nhận rõ. Xác nhận xong: kết thúc cộng tác cũ, tạo cộng tác mới.
• Gia hạn tài khoản + ghi giá vốn: modal gia hạn có ô “Số tiền trả Netflix chu kỳ này” → nhập vào tạo một dòng giá vốn (mục 5.5).

5.3 Gói cước · Khuyến mãi · Đánh giá · Cổng thanh toán SUPER

• Gói cước: tạo / sửa / bật / tắt. Gói tắt biến mất khỏi bảng giá khách.
• Mã giảm giá: tạo (điều kiện đơn tối thiểu, đơn đầu tiên), sửa, tắt.
• Duyệt đánh giá & thưởng SUPPORT: duyệt / từ chối đánh giá, duyệt / trả / từ chối thưởng, trả lời đánh giá. Trả thưởng = cộng ví khách.
• Auto-duyệt đánh giá: có tuỳ chọn “Tất cả (1–5★)” — vẫn chặn nếu chứa link / số điện thoại / từ khoá cấm.
• Cổng thanh toán: 5 tab (MoMo, Pay2S, VTCPay, Alepay, Stripe). Mỗi cổng có công tắc + nút Lưu riêng; khoá bí mật hiển thị dạng ẩn; nút “Kiểm tra kết nối” gọi thật.
• Mẫu email: sửa nội dung, gửi thử.

5.4 Thông báo vận hành & nội dung

• Định tuyến Telegram: 4 ô Chat ID theo nhóm (Đơn hàng / Cảnh báo / Hỗ trợ / CTV). Nhập dạng chatId hoặc chatId:threadId. Ô trống → tin loại đó về nhóm mặc định. Có nút kiểm tra bắn tin thật.
• Blog / Hướng dẫn: thêm / sửa / xoá. Nội dung soạn trên Airtable (Blog · Guide · FAQ · Kịch bản CSKH) rồi bấm “Kéo từ Airtable”. FAQ & kịch bản CSKH đã xuất bản được trợ lý AI dùng để trả lời.

5.5 Tài chính — Lợi nhuận gộp ACCOUNTANT

Admin → Tài chính. Chọn kỳ (tháng này / tháng trước / 30 ngày / tuỳ chọn). Báo cáo: Doanh thu · Giá vốn (tách CTV / SELF) · Chi phí tồn kho nhàn rỗi · Lợi nhuận gộp · biên %.

• Bảng lãi/lỗ theo từng tài khoản: tài khoản lỗ nặng xếp lên đầu — ưu tiên xem để quyết định tiếp tục hay không.
• Cảnh báo thiếu dữ liệu giá vốn: liệt kê tài khoản có doanh thu nhưng chưa ghi giá vốn. Còn cảnh báo → lợi nhuận đang bị tính cao hơn thực tế. Kế toán phải nhắc Vận hành kho nhập giá vốn khi gia hạn.

5.6 CTV · Người dùng · Hỗ trợ

• Duyệt bill & hoàn tiền CTV INVENTORY: xác minh bill → “Hoàn tiền” (hiện VietQR) → “Xác nhận đã chuyển”. Hệ thống tự: cộng 1 tháng hạn cho tài khoản + thông báo CTV + sinh dòng giá vốn.
• Hồ sơ CTV & tài khoản gắn: chỉ hiện cộng tác đang hoạt động; bấm 1 tài khoản mở được thông tin đầy đủ.
• Ticket hỗ trợ SUPPORT: xem / trả lời / đóng. Loại đặc biệt: “Yêu cầu đổi tài khoản”, “Yêu cầu xoá tài khoản”.
• Người dùng & phân quyền SUPER: tìm người dùng, cấp / thu quyền admin, chỉnh số dư ví (thận trọng — có ghi audit).
• Nhật ký hoạt động (Audit log): ghi lại các thao tác quan trọng — đổi CTV, ghi giá vốn, đổi vai trò admin, khách tự xoá tài khoản… Dùng để truy vết khi có sự cố hoặc tranh chấp.

6 Quy trình nghiệp vụ chuẩn (SOP)

Mỗi quy trình: mục tiêu → các bước (kèm vai trò) → lưu ý. Ký hiệu vai trò: SUPER Vận hành kho Kế toán CSKH

SOP-1 · Xử lý đơn hàng mới

Mục tiêu: khách trả tiền xong nhận được tài khoản trong vài phút, không sót đơn.

1. Đơn tự kích hoạt khi cổng thanh toán báo thành công — không cần thao tác tay trong trường hợp bình thường.
2. Vận hành kho mỗi ca mở Admin → Đơn hàng, lọc PENDING tuổi > 15 phút. Đơn MoMo: bấm “Đối soát MoMo”. Đơn chuyển khoản: đối chiếu sao kê (SOP-7).
3. Đơn FAILED / OUT_OF_INVENTORY → bổ sung kho (SOP-2) rồi kích hoạt lại; báo khách thời gian dự kiến.
4. Đơn đã PAID: kiểm tra khách đã nhận email biên nhận + thông tin tài khoản. Chưa nhận → gửi lại từ chi tiết đơn.

SOP-2 · Nạp / bổ sung kho tài khoản Netflix

1. Vận hành kho xác định nguồn: SELF (công ty vừa mua thẻ) hay CTV (CTV vừa xác nhận bill).
2. Admin → Kho tài khoản → “Thêm tài khoản”. Nhập email/mật khẩu Netflix, số slot (Y), chọn Nguồn. Nếu CTV: chọn đúng CTV.
3. Tài khoản SELF vừa gia hạn: mở modal gia hạn, nhập “Số tiền trả Netflix chu kỳ này” → tạo dòng giá vốn.
4. Kiểm tra thẻ mới hiện “Còn trống Y/Y” và tình trạng xanh (Active).
5. Nhiều tài khoản một lúc → dùng Import hàng loạt.

SOP-3 · Duyệt bill & hoàn tiền CTV

1. CTV gửi bill gia hạn Netflix qua Cổng CTV → tin về topic CTV trên Telegram.
2. Vận hành kho mở Admin → CTV → bill chờ duyệt, đối chiếu: đúng tài khoản, đúng chu kỳ, số tiền hợp lý, ảnh bill rõ.
3. Hợp lệ → bấm “Hoàn tiền” (hiện VietQR của CTV) → chuyển khoản → bấm “Xác nhận đã chuyển”.
4. Hệ thống tự: cộng 1 tháng hạn cho tài khoản, thông báo CTV, sinh dòng giá vốn CTV_REFUND.
5. Bill sai / mờ / nghi ngờ → bấm “Từ chối” kèm lý do; nhắn CTV gửi lại.

SOP-4 · Đối soát thanh toán cuối ngày Kế toán

1. Cuối ngày mở Admin → Đơn hàng, lọc theo ngày. Đối chiếu tổng doanh thu với báo cáo cổng MoMo và sao kê ngân hàng.
2. Chạy kiểm tra toàn vẹn dữ liệu tiền (SOP-11) — không phát sinh dòng lệch mới.
3. Đơn PENDING còn sót → chuyển Vận hành kho; đơn FAILED → xác định lý do.
4. Ghi nhận chênh lệch (nếu có) vào sổ theo dõi.

SOP-5 · Xử lý ticket hỗ trợ CSKH

1. Ticket mới → tin về topic Hỗ trợ. Mở Admin → Hỗ trợ & Khiếu nại.
2. Phân loại: Kỹ thuật · Yêu cầu đổi tài khoản · Yêu cầu xoá tài khoản · Thanh toán · Khác.
3. Trả lời trong SLA: phản hồi đầu ≤ [điền] phút giờ hành chính; giải quyết ≤ [điền] giờ với vấn đề thường, ≤ [điền] giờ với vấn đề cần đổi tài khoản.
4. Vấn đề vượt quyền CSKH (đổi tài khoản, hoàn tiền, lỗi hệ thống) → chuyển đúng bộ phận, ghi chú rõ, không đóng ticket khi chưa xong.
5. Xử lý xong → tóm tắt cách giải quyết trong ticket → đóng.

SOP-6 · Duyệt đánh giá & trả thưởng CSKH

1. Admin → Đánh giá dịch vụ, xem hàng chờ duyệt.
2. Duyệt nếu: đúng khách có đơn thật, nội dung không spam / không chèn link liên hệ ngoài / không xúc phạm.
3. Từ chối kèm lý do nếu vi phạm. Nghi nhiều đánh giá từ một người / một mẫu câu → playbook 7.10.
4. Thưởng đến hạn trả → kiểm tra rồi bấm trả (cộng ví khách). Từ chối thưởng nếu đánh giá bị gỡ sau đó.

SOP-7 · Đối soát chuyển khoản sai nội dung Vận hành kho

1. Khách báo đã chuyển khoản nhưng đơn chưa lên → xin ảnh biên lai + 4 số cuối tài khoản gửi + thời gian chuyển.
2. Đối chiếu sao kê ngân hàng công ty: tìm giao dịch đúng số tiền + thời gian.
3. Khớp được → mở chi tiết đơn của khách → đối soát / kích hoạt thủ công.
4. Không khớp (chuyển nhầm số tài khoản / chưa chuyển) → hướng dẫn khách và ghi ticket.

SOP-8 · Yêu cầu đổi tài khoản CSKH + Vận hành kho

1. Ticket “Yêu cầu đổi tài khoản” — xác minh lý do (tài khoản lỗi Netflix, bị đăng xuất liên tục, sai gói…).
2. Lý do chính đáng → Vận hành kho cấp 1 profile trống khác cùng nhóm gói, cập nhật thông tin trong gói của khách.
3. Ghi rõ tài khoản cũ có vấn đề gì để cách ly / kiểm tra lại.
4. Báo khách thông tin mới, đóng ticket.

SOP-9 · Yêu cầu xoá tài khoản khách CSKH

1. Khách tự xoá được qua trang Tài khoản (nhập mã email). CSKH chỉ hỗ trợ khi khách gặp trục trặc thao tác.
2. Giải thích trước: dữ liệu bị ẩn danh, mất gói đang dùng và số dư ví, không hoàn lại.
3. Không tự ý xoá hộ khách trừ khi có yêu cầu bằng văn bản/email từ chính khách. Ghi lại trong ticket.

SOP-10 · Onboard / offboard nhân sự admin SUPER

1. Vào: nhân sự tạo tài khoản PhimFlix bằng email công ty → SUPER vào Phân Quyền & Quyền → Thêm nhân sự → nhập email, chọn vai trò tối thiểu đủ việc → xác nhận.
2. Bàn giao tài liệu này + kèm 1–2 ca đầu có người hướng dẫn thực tế.
3. Ra: ngay ngày cuối làm việc, SUPER bấm “Thu hồi” ở dòng của người đó. Kiểm tra người đó biến mất khỏi danh sách.
4. Nghi tài khoản bị lộ: thu hồi + đổi các khoá bí mật liên quan (playbook 7.14).

SOP-11 · Kiểm tra toàn vẹn dữ liệu tiền Kế toán + kỹ thuật

1. Định kỳ (hằng tuần) chạy script kiểm tra: mọi đơn PAID qua cổng phải có WalletTransaction loại PURCHASE khớp số tiền.
2. Lệnh: npx tsx scripts/check-order-wallet-integrity.ts --all (chạy trên máy chủ, trong thư mục backend).
3. Chỉ quan tâm dòng lệch mới phát sinh (bỏ qua dữ liệu test cũ đã biết). Có dòng lệch mới → dựng lại nguyên nhân với kỹ thuật trước khi backfill.

7 Sổ tay xử lý tình huống (Playbook)

Mỗi thẻ: Dấu hiệu → Chẩn đoán nhanh → Xử lý → Khi nào chuyển cấp. Mức độ: P1 Khẩn P2 Cao P3 Thường

8 Cảnh báo hệ thống & cách phản ứng

Thông báo Telegram được định tuyến theo 4 nhóm. Ai trực nhóm nào, phản ứng ra sao.

9 Vận hành kỹ thuật

9.1 Deploy

SSH vào máy chủ rồi chạy:

• bash ~/scripts/deploy.sh api — backend (migrate CSDL → build → khởi động lại PM2 → healthcheck → tự rollback nếu fail).
• bash ~/scripts/deploy.sh web — frontend.

Deploy tự lấy code mới nhất từ nhánh main. Commit & push trước, rồi mới deploy.

9.2 Rollback

Xem playbook 7.12. Tóm tắt: healthcheck fail → tự rollback; lỗi phát hiện sau → git revert + push + deploy lại.

9.3 Tiến trình chạy nền (scheduler)

9.4 Script kiểm tra

• npx tsx scripts/check-order-wallet-integrity.ts --all — đối chiếu đơn ↔ giao dịch ví (SOP-11).

9.5 Biến môi trường quan trọng (backend .env)

9.6 Sao lưu

CSDL được sao lưu định kỳ trên máy chủ. Cần diễn tập phục hồi định kỳ để chắc chắn file backup đọc được. Giữ tối thiểu 7 bản gần nhất.

10 Phụ lục

10.1 Bảng trạng thái

10.2 Thuật ngữ