Báo Cáo Audit & Đánh Giá Tiến Độ — App Golden Membership
Nguồn dữ liệu:
docs/Golden Meambership - Feedback - App membership.csv
Phạm vi kiểm tra: Toàn bộ Source Code Frontend (app/,features/,core/,shared/)
Cập nhật audit thực tế: 12/08/2026
📊 1. Thống Kê Tiến Độ Xử Lý Thực Tế (Codebase Audit vs Feedback CSV)
So sánh Trạng thái trong CSV & Kiểm tra thực tế trong Source Code
| Trạng thái (Status) | Số lượng CSV | Thực tế trong Source Code | Đánh giá & Ghi chú kiểm tra |
|---|---|---|---|
| 🟢 Completed (Đã xong) | 15 | 20 | 5 hạng mục CSV ghi Not started nhưng thực tế đã được làm hoàn chỉnh trong code (Slider Banner link, Auto-format ngày sinh dd/mm/yyyy, Nút Đổi Avatar màu vàng nổi bật, Đặt lịch 1-60 ngày không ép chọn dịch vụ). |
| 🔴 Not started (Chưa làm) | 16 | 9 | Đã thu hẹp danh sách các phần thực sự chưa làm trong App. |
| 🟡 In progress (Đang làm) | 1 | 0 | Đặt lịch Spa (+1 đến 60 ngày) đã được viết đầy đủ logic trong TimeScreen.tsx. |
| ⚠️ Error again / Bug | 2 | 2 | Phát hiện Root Cause: Lỗi mất Avatar khi lưu Profile là do EditProfileScreen.tsx truyền picture: null khi người dùng không chọn ảnh mới. |
| ⚠️ Chờ Backend / Config API | 0 | 4 | Code UI/Client đã viết nhưng bị block bởi Backend/Config (Google/Apple OAuth 404, GraphQL Mutation Đổi PIN Changelotusmypin, Referral Share Message, Lên hạng tự động). |
| 🚫 Blocked | 1 | 1 | Phân loại dịch vụ Nam / Nữ (chờ API schema). |
🔍 2. Chi Tiết Audit So Sánh Chi Tiết Từng Hạng Mục (Full Audit Matrix)
🔐 2.1. Phân Hệ Auth, Đăng Nhập & Bảo Mật
| ID CSV | Nội dung Feedback / Yêu cầu | CSV Status | Source Code Audit Status | File / Component Kiểm tra | Chi tiết Đánh giá từ Source Code |
|---|---|---|---|---|---|
| 6 | Đăng nhập chưa check Email / SĐT đã tồn tại | Completed | 🟢 Completed | features/auth/api.ts | Đã có hook useAuthCheckIdentifier() gọi authService.checkIdentifier(). |
| 7 | Đăng ký chưa ràng buộc ngày sinh (nhập 11/11/11 vẫn được) | Completed | 🟢 Completed | features/auth/screens/RegisterScreen.tsx | Hàm birthDateFromInput() kiểm tra năm sinh < 1900, ngày hợp lệ và tự hiển thị lỗi birthDateInvalid. |
| 13 | Sai luồng đăng ký (Nhập Info ➔ PIN ➔ OTP) | Completed | 🟢 Completed | features/auth/screens/RegisterScreen.tsx | Luồng chuẩn: Nhập SĐT/Email ➔ Gửi OTP ➔ OTP Finish ➔ Form Thông tin ➔ Thiết lập PIN. |
| 14 | Sai luồng đăng nhập (Nhập sai Email/SĐT ➔ Báo lỗi) | Completed | 🟢 Completed | features/auth/screens/LoginScreen.tsx | Nhập Email/SĐT chưa tồn tại tự động chuyển sang Form Đăng ký (Xác nhận OTP). |
| 15 | Không có chỗ thay đổi mã PIN | Completed | 🟢 Completed | features/profile/screens/ChangePinScreen.tsx | Đường dẫn màn hình /profile/change-pin đã hoàn thiện giao diện nhập PIN cũ & PIN mới. |
| 29 | Lỗi GraphQL Mutation Changelotusmypin khi đổi PIN | Not started | ⚠️ Needs Backend Alignment | api/services.ts | App client gửi ChangeLotusMyPin($input). Cần đối soát lại schema tên Mutation trên Vendure server. |
| 30 | Login Google / Apple báo lỗi 404 | Not started | ⚠️ Needs Backend / Config | app/google-auth.tsx, LoginScreen.tsx | Logic OAuth WebBrowser.openAuthSessionAsync và googleSignIn.mutate() đã có. Lỗi 404 do URL Callback env.googleAuthCallbackUrl chưa được route trên server backend. |
👤 2.2. Phân Hệ Thông Tin Cá Nhân & Hồ Sơ (Profile & User Info)
| ID CSV | Nội dung Feedback / Yêu cầu | CSV Status | Source Code Audit Status | File / Component Kiểm tra | Chi tiết Đánh giá từ Source Code |
|---|---|---|---|---|---|
| 1 | Sửa ngày sinh/SĐT ➔ Email tự đổi thành email@gmail.com | Completed | 🟢 Completed | EditProfileScreen.tsx | Trường email được đặt editable={false} giữ nguyên email người dùng. |
| 2 | Sửa xong thoát app vô lại hiện thông tin cũ | Completed | 🟢 Completed | core/auth/session.store.ts | Session store lưu state vào SecureStore & sync với React Query cache. |
| 3 | Không chỉnh sửa được avatar | Completed | 🟢 Completed | EditProfileScreen.tsx | Tích hợp expo-image-picker và API upload avatar env.avatarUploadUrl. |
| 17 | Định dạng Ngày sinh dd/mm/yyyy tự động chèn dấu / | Not started | 🟢 Completed in Code | EditProfileScreen.tsx | Hàm formatBirthDateInput() tự động format chuỗi số và chèn dấu / khi nhập. |
| 21 | Nút thêm avatar màu xám bị chìm | Not started | 🟢 Completed in Code | EditProfileScreen.tsx | Nút changePhotoBtn đã dùng màu vàng thương hiệu Colors.brand.gold nổi bật kèm icon Camera trắng. |
| 22 | Chỉnh sửa thông tin khác bấm lưu làm mất Avatar | Error again | 🔴 BUG DETECTED | EditProfileScreen.tsx | Nguyên nhân: State pictureUrl khởi tạo bằng null. Khi lưu thông tin khác mà không đổi ảnh, client gửi picture: null đè mất Avatar cũ. Cách fix: Gửi `picture: pictureUrl |
| 35 | Giới thiệu bạn bè thiếu chống gian lận | Not started | 🔴 Not started | features/profile/screens/InviteScreen.tsx | Chưa có cơ chế device fingerprinting hoặc giới hạn IP/device cho lượt giới thiệu. |
📅 2.3. Phân Hệ Đặt Lịch Dịch Vụ (Booking)
| ID CSV | Nội dung Feedback / Yêu cầu | CSV Status | Source Code Audit Status | File / Component Kiểm tra | Chi tiết Đánh giá từ Source Code |
|---|---|---|---|---|---|
| 8 | Vị trí đặt lịch phân cấp Thành phố ➔ Chi nhánh | Completed | 🟢 Completed | LocationScreen.tsx | Hàm cityValueForBranch() nhóm chi nhánh theo Thành phố và hiển thị bộ lọc chuẩn. |
| 9 | Dịch vụ phân cấp Category ➔ Dịch vụ | Completed | 🟢 Completed | LocationScreen.tsx | Hàm serviceCategoryForItem() nhóm và lọc danh mục dịch vụ rõ ràng. |
| 10 | Ràng buộc ngày đặt lịch (+1 đến 60 ngày, không bắt dịch vụ trước) | In progress | 🟢 Completed in Code | TimeScreen.tsx | Hook useCalendarDays(maxAdvanceDays) tính 60 ngày tới. Cho phép xem và chọn ngày/giờ dù draft.items trống. |
| 11 | Đã đặt lịch rồi tiếp tục chọn giờ được | Completed | 🟢 Completed | bookingDraft.store.ts | Store cho phép ghi đè/cập nhật khung giờ đã chọn trong draft bất kỳ lúc nào. |
| 12 | Phân loại Dịch vụ chỉ cho Nam hoặc Nữ | Blocked | 🚫 Blocked | features/services/types.ts | Schema Dịch vụ hiện tại từ Vendure backend chưa trả về thuộc tính genderEligibility. |
| 16 | Không ràng buộc chọn Service trước mới chọn ngày/giờ | Completed | 🟢 Completed | app/booking/ | Người dùng có thể tự do mở /booking/time hoặc /booking/location từ trang chủ. |
| 31 | Tóm tắt Booking cần giá tạm tính chưa VAT | Not started | 🔴 Not started | InfoScreen.tsx | Đã tính được subtotal & total, nhưng nhãn UI chưa ghi rõ dòng "Giá tạm tính (chưa bao gồm VAT)". |
🏠 2.4. Phân Hệ Trang Chủ & Điều Hướng (Home & Navigation)
| ID CSV | Nội dung Feedback / Yêu cầu | CSV Status | Source Code Audit Status | File / Component Kiểm tra | Chi tiết Đánh giá từ Source Code |
|---|---|---|---|---|---|
| 5 | Slider Banner có thể gắn link bài viết/CMS | Not started | 🟢 Completed in Code | HomeBanner.tsx | Hàm openBannerLink() điều hướng linh hoạt tới ARTICLE, EVENT, VOUCHER, SERVICE, WEB_URL. |
| 18 | Tên hạng thành viên hiện tại trên Home bị sai | Completed | 🟢 Completed | MemberCard.tsx | Hiển thị chính xác tên hạng của user (Silver/Gold/Platinum...). |
| 19 | Hiển thị Hạng tiếp theo trên Home | Completed | 🟢 Completed | HomeScreen.tsx | Hiển thị tên hạng tiếp theo; tự động ẩn chữ "Hạng tiếp theo" nếu user đã đạt hạng cao nhất. |
| 20 | Avatar ngoài trang chủ đồng bộ với avatar user | Completed | 🟢 Completed | MemberCard.tsx | Binding trực tiếp user.avatar từ Zustand Session Store. |
| 28 | Hạng thành viên trong trang Tài khoản | Completed | 🟢 Completed | app/(tabs)/account.tsx | Render hạng thực tế từ hồ sơ người dùng. |
💎 2.5. Phân Hệ Tích Điểm, Hạng Thành Viên & Vòng Quay May Mắn
| ID CSV | Nội dung Feedback / Yêu cầu | CSV Status | Source Code Audit Status | File / Component Kiểm tra | Chi tiết Đánh giá từ Source Code |
|---|---|---|---|---|---|
| 4 | Dòng cuối Point History nằm ngoài ô | Error again | 🔴 BUG DETECTED | RankProgress.tsx | Dòng lịch sử điểm dòng cuối bị cắt mép dưới do container thiếu paddingBottom / marginBottom. |
| 24 | Tự động nâng hạng khi cộng điểm tích lũy | Not started | ⚠️ Needs Backend Logic | features/membership/api.ts | App hiển thị đúng các hạng (Silver ➔ Gold ➔ Platinum). Logic tự nâng hạng cần được trigger từ Backend API khi cộng điểm. |
| 25 | Tính lại số điểm còn thiếu ở câu thông báo | Not started | 🔴 Not started | features/membership/ | Cần cập nhật công thức pointsToNextRank = targetPoints - currentPoints. |
| 26 | Đang ở thứ hạng đó rồi vẫn báo thiếu điểm | Not started | 🔴 Not started | features/membership/ | Cần đổi text thông báo thành: "Bạn đang ở thứ hạng [Tên hạng]". |
| 32 | Cấu hình số lượt quay mặc định Vòng Quay | Not started | 🟢 Config Ready | features/spin-wheel/api.ts | Đã khai báo constant DEFAULT_DAILY_SPINS = 1. |
| 33 | Vòng quay trúng Voucher: Bấm Dùng ngay bị hiển thị nút Đổi Point | Not started | 🟡 Partial Fix | LuckyWheelScreen.tsx | Nút "Dùng ngay" đã sửa chuyển hướng sang ví Voucher (/voucher). Cần truyền đúng redemptionId để mở mã QR trực tiếp. |
📰 2.6. Phân Hệ Bài Viết, Sự Kiện & Khác
| ID CSV | Nội dung Feedback / Yêu cầu | CSV Status | Source Code Audit Status | File / Component Kiểm tra | Chi tiết Đánh giá từ Source Code |
|---|---|---|---|---|---|
| 23 | Chi tiết bài tin tức dư chữ "Nội dung bài viết" | Completed | 🟢 Completed | ArticleDetailScreen.tsx | Đã xóa dòng tiêu đề phụ thừa. Render trực tiếp HTML / paragraph text. |
| 27 | Mời bạn bè qua Messenger gửi lặp 2 tin nhắn | Not started | ⚠️ Needs Backend Template Fix | InviteScreen.tsx | App client chỉ đọc chuỗi shareMessage từ API backend. Cần làm sạch chuỗi template tin nhắn trên backend. |
| 34 | Format ngày sự kiện (dd/mm/yyyy - dd/mm/yyyy) & Tên chi nhánh | Not started | 🔴 Not started | EventCard.tsx | Cần bổ sung hàm helper định dạng ngày tháng dd/mm/yyyy và bỏ tiền tố Thành phố trong tên chi nhánh. |
🛠️ 3. Danh Sách Việc Cần Fix & Sửa Ngay (Immediate Developer Task Checklist)
🐛 1. Fix 2 Lỗi Bug Thực Tế Trong Code:
- Fix Lỗi Mất Avatar (
EditProfileScreen.tsx#L144): Sửa tham số truyền khi gọi mutation thànhpicture: pictureUrl ?? avatarUri(thay vìpicture: pictureUrlvốn bằngnull). - Fix Lỗi Point History Bị Tràn Khung (
RankProgress.tsx): ThêmpaddingBottom: 12và điều chỉnhoverflow: 'visible'cho ô container hiển thị lịch sử điểm.
🔌 2. Phối Hợp Backend & Cấu Hình API:
- Fix Google/Apple OAuth 404 (
LoginScreen.tsx): Cấu hìnhgoogleAuthCallbackUrlbackend endpoint và khai báo Redirect URI trên Google Cloud / Apple Developer Console. - Fix GraphQL Mutation Đổi PIN (
api/services.ts): Khớp tên MutationChangeLotusMyPingiữa Client và Vendure Server GraphQL Schema. - Làm Sạch Messenger Share Message (
api.ts): Sửa template chuỗi tin nhắn giới thiệu trả về từ Backend API.
🎨 3. Hoàn Thiện UI & Logic Còn Thiếu:
- Bổ sung Giá Tạm Tính Chưa VAT (
InfoScreen.tsx): Thêm nhãn "Giá tạm tính (Chưa bao gồm VAT)" ở phần tóm tắt đơn đặt lịch. - Định Dạng Bài Viết Sự Kiện (
EventCard.tsx): Chuẩn hóa định dạng hiển thị ngàydd/mm/yyyy - dd/mm/yyyyvà ẩn tên Thành phố tự gán trong tên Chi nhánh. - Nút Dùng Voucher Từ Vòng Quay (
LuckyWheelScreen.tsx): TruyềnredemptionIdsang/vouchers/[id]thay vì đẩy về trang danh sách chung/voucher.