diff --git a/.gitignore b/.gitignore index 3a4873ad..f61b0edf 100644 --- a/.gitignore +++ b/.gitignore @@ -66,6 +66,8 @@ packages/*/.env .cursor/ memory-bank/ mcp.json +!apps/web/src/app/.well-known/mcp.json/ +!apps/web/src/app/.well-known/mcp.json/** .cache .strapi-updater.json diff --git a/Docs/Proposals/2026-11-22-de-xuat-tinh-nang-moi-phase-8.html b/Docs/Proposals/2026-11-22-de-xuat-tinh-nang-moi-phase-8.html new file mode 100644 index 00000000..ad3e79bb --- /dev/null +++ b/Docs/Proposals/2026-11-22-de-xuat-tinh-nang-moi-phase-8.html @@ -0,0 +1,1351 @@ + + +
+ + + +
+ Ngày 22/11/2026 - Người soạn: Brand (Rate Core), theo yêu cầu trực tiếp của JOY trong phiên PO ("Brainstorm research tính năng mới?").
+ Tài liệu này đối chiếu các mô hình kiểm chứng giá và đánh giá thành công nhất tại châu Âu / Séc (Hlídač shopů, Heureka.cz, Idealo, Prisjakt), Mỹ / Toàn cầu (RTINGS.com, Keepa, Model Context Protocol) với nỗi đau thực tế của người mua đồ công nghệ tại Việt Nam trên 22 hệ thống bán lẻ và sàn TMĐT vừa hợp nhất.
+ Chưa tạo bất kỳ issue backlog nào và chưa chạm tới code runtime hay database.
+
#1859)vi, en, cs)k=3, mu=4.2), tách rủi ro DOSafe và SeedingwithRateDataCache, DOS ID SSO, Extension Shadow DOM
+ Sau khi hoàn tất nền tảng bảo mật, chuẩn hóa dữ liệu và mở rộng lên 22 chuỗi bán lẻ ở Phase 6-7, khoảng trống lớn nhất của rate.vn hiện nay không còn nằm ở tầng cào dữ liệu thô, mà nằm ở 3 điểm bùng nổ phía người dùng cuối:
+ (1) vũ khí vạch trần giảm giá ảo mùa cao điểm (Black Friday, 12.12, Tết),
+ (2) cá nhân hóa quyết định mua + kênh lan truyền tự nhiên qua mạng xã hội và AI Agents, và
+ (3) vòng lặp giữ chân người dùng quay lại tự động.
+
Triển khai ngay trên dữ liệu đã có sẵn trong DOS/Rate, không cần chờ PR migration bên DOS-Me, chi phí hạ tầng tăng thêm gần bằng 0.
Hlídač shopů + Keepa).RTINGS.com Custom Ratings).Dynamic OG Image + xuất ảnh 1 chạm cho Zalo, Threads, TikTok, VOZ).Rate Shopping MCP Server (/api/mcp + @dos/rate-mcp + /llms.txt) đón lưu lượng trích dẫn từ AI.Biến khách vãng lai tra cứu 1 lần thành người dùng gắn bó lâu dài qua tài khoản DOS ID và tiện ích trình duyệt MV3.
ATL) & có hàng lại đa kênh (Email xác minh sẵn có, mở rộng Web Push / Telegram, có bộ lọc "Chỉ shop Chính hãng").Checkout Guard), ghim cảnh báo giá 1 chạm trong Side Panel và đồng bộ M2 đủ 22 sàn (#1762).Giải quyết nỗi đau đặc thù nhất của bán lẻ công nghệ Việt Nam mà các công cụ quốc tế không thể sao chép.
+VN/A vs Nhập khẩu & Kiểm chứng thực tế "Thu Cũ Đổi Mới" trên 22 chuỗi.Basket Optimizer) kết hợp Huy hiệu Chuỗi Uy Tín 180 ngày (Heureka Ověřeno).DOS-Me; song song chuẩn bị thiết kế chi tiết cho F5 (Gói 8B).
+ vi / en / cs)
+ Điểm độc đáo của rate.vn là hỗ trợ gốc 3 ngôn ngữ vi, en, cs (1.971 khóa dịch lá trên 21 namespace mỗi ngôn ngữ). Cộng đồng người Việt tại CH Séc và châu Âu vốn rất quen thuộc với Hlídač shopů và Heureka.cz, trong khi thị trường Việt Nam đang thiếu hoàn toàn một công cụ minh bạch tương đương trên 22 chuỗi lớn (Thế Giới Di Động, CellphoneS, FPT Shop, ShopDunk, TopZone, Di Động Việt, Hoàng Hà, Viettel Store, GearVN, HACOM, An Phát, Phong Vũ, MemoryZone, Shopee, Lazada, TikTok Shop...).
+
| Benchmark & Nguồn gốc (tra cứu 22/11/2026) | +Cơ chế gốc đã kiểm chứng | +Nỗi đau tương ứng tại Việt Nam (2026) | +Chuyển hóa đề xuất riêng cho Rate.vn Phase 8 | +
|---|---|---|---|
| Hlídač shopů (hlidacshopu.cz) & Chỉ thị EU Omnibus Điều 6a (Directive 2019/2161) | +Luật EU quy định giá trước giảm phải là mức giá thấp nhất nhà bán áp dụng trong tối thiểu 30 ngày liền trước; Hlídač shopů đối chiếu lịch sử giá thực của các e-shop Séc để vạch trần mức giảm ảo dịp Black Friday. |
+ Trước 11.11, 12.12, Black Friday và cận Tết, nhiều gian hàng đẩy "giá gạch ngang" lên bằng giá MSRP lúc mới ra mắt cách đây 1 năm để treo biển giảm 30-45%, dù giá thực bán suốt tháng trước không đổi. | +Bản địa hóa F1: Hiển thị trực diện con số Đáy 30 ngày trước sale và % Giảm giá thực tế chuẩn Omnibus (chỉ khi đủ chuỗi 30 ngày) ngay cạnh giá gạch ngang của nhà bán. |
+
| RTINGS.com (rtings.com - Custom Ratings & Compare) | +Tài liệu phương pháp chấm điểm của RTINGS tách điểm theo ngữ cảnh dùng (Use-Case Subscores) và cung cấp công cụ Custom Ratings cho phép người đọc tự gán trọng số từng phép đo để xếp lại bảng. |
+ Người chạy xe công nghệ cần Pin + Màn sáng + Độ bền, sinh viên cần Đáng tiền + Hiệu năng, người làm nội dung cần Camera + Mic. Một điểm trung bình cứng làm chìm các máy chuyên biệt rất tốt. | +Bản địa hóa F2: Gắn bộ Preset 1 chạm và thanh trượt 0% - 100% trực tiếp lên bộ tiêu chí getRatingCriteria (rating-criteria.ts) của 5 ngành hàng trên /leaderboard và /compare. |
+
| Keepa (keepa.com) & Prisjakt (prisjakt.nu) | +Keepa vẽ lịch sử giá dài hạn theo phân nhóm hàng mới/cũ kèm cảnh báo ngưỡng giá mục tiêu đa kênh; Prisjakt theo dõi biến động giá đa cửa hàng độc lập có lọc chi phí giao hàng và cảnh báo khi giảm giá / có hàng lại. |
+ Người mua điện thoại/laptop 15-40 triệu VND luôn phân vân "Mua hôm nay hay đợi ngày đôi / cận Tết rẻ hơn 1-2 triệu?", dẫn tới trì hoãn hoặc mua đúng đỉnh giá. | +Bản địa hóa F1 + F5: Nhãn phân vị lịch sử 90 ngày Mua ngay / Giá bình thường / Đang neo cao (thuật toán đề xuất của Rate) kèm nút nhận thông báo DOS ID khi chạm đáy. |
+
| Heureka.cz (Ověřeno zákazníky & heureka.cz) | +Chương trình Ověřeno zákazníky cấp chứng nhận uy tín cho e-shop dựa trên tỷ lệ khuyến nghị từ khảo sát người mua thật trong 90-180 ngày gần nhất, kết hợp so sánh giá đa cửa hàng và lọc khuyến mãi thật. | +Người mua không phân biệt được gian hàng Mall thật, đại lý ủy quyền Apple (AAR) với shop trộn phụ kiện / hàng dựng hoặc tách đơn nhiều nơi bị đội phí ship. | +Bản địa hóa F7 + F8: Huy hiệu chuỗi uy tín 180 ngày tự động từ dữ liệu kiểm toán dosafe_risk_score + review_risk_score (không cần khảo sát email như Heureka) và bộ tối ưu giỏ hàng 2-5 món trên 22 sàn. |
+
| Model Context Protocol (modelcontextprotocol.io & MCP Registry) | +Chuẩn mở MCP chuẩn hóa giao tiếp JSON-RPC / Streamable HTTP để các AI host (Claude, Cursor, IDE, custom agents) gọi công cụ tra cứu dữ liệu có cấu trúc thay vì đoán giá hoặc tự cào HTML. |
+ Người dùng Việt Nam ngày càng hỏi AI "Tầm 20 triệu mua laptop nào ở đâu uy tín, không bị giá ảo?", nhưng LLM hiện trả lời bằng dữ liệu cũ hoặc thiếu kiểm chứng gian hàng. | +Bản địa hóa F4: Mở cổng /api/mcp chỉ đọc trên nền cache BFF + gói @dos/rate-mcp và đăng ký lên MCP Registry, biến câu trả lời AI thành nguồn dẫn link về rate.vn. |
+
+ Điểm ưu tiên tổng hợp (thang 100) được tính có trọng số từ: Giá trị người mua (30%) + Tác động Tăng trưởng / SEO / Lan truyền (25%) + Độ sẵn sàng dữ liệu hiện có trong repo (25%) + Tối ưu chi phí & tốc độ triển khai không vướng DDL (20%).
+
| Mã & Tính năng | +Gói | +Giá trị người mua | +Dữ liệu sẵn có | +Cỡ (Size) | +Cần DOS-Me DDL? | +Chi phí vận hành | +Hào lũy (Moat) | +Điểm | +
|---|---|---|---|---|---|---|---|---|
| F1. Kiểm toán Giá Đáy 30 Ngày chuẩn EU Omnibus & Chỉ báo Mua Ngay / Chờ Sale | +8A | +Rất cao (chống bẫy sale ngày đôi, Black Friday, Tết) | +95% (rate.price_history, listing_price_context) |
+ S |
+ Không (0 DDL) | +$0 (tính trong SQL/BFF cache) |
+ Lịch sử giá thực đa sàn tích lũy theo thời gian | +95 | +
F3. Thẻ Sự Thật Giá & Đánh Giá động (Dynamic OG & Xuất ảnh MXH 1 chạm) |
+ 8A | +Cao (tóm tắt trực quan trong 3 giây khi gửi link) | +100% (DealRadar, rating_score, 6 trục v2) |
+ S |
+ Không (0 DDL) | +~$0 (Edge/Node OG cache CDN 1h-24h) |
+ Thương hiệu thị giác lan truyền trên Zalo, VOZ, Threads, TikTok | +92 | +
F2. Thanh trượt trọng số theo nhu cầu cá nhân kiểu RTINGS |
+ 8A | +Rất cao (chọn đúng máy hợp gu dùng & túi tiền) | +95% (getRatingCriteria, criteria_scores, 10 nhóm spec) |
+ S - M |
+ Không (0 DDL) | +$0 (100% tính toán phía Client + URL state) |
+ Ma trận tiêu chí chuẩn hóa + đánh giá thật đã lọc seeding | +90 | +
F4. Rate Shopping MCP Server & cổng trích dẫn cho AI Agents (/api/mcp) |
+ 8A | +Cao (tra giá thật 22 sàn ngay trong Claude, ChatGPT, Gemini, DOSClaw) | +95% (23 REST API v1 + OpenAPI 3.1 + withRateDataCache) |
+ M |
+ Không (0 DDL) | +~$0 (tái sử dụng cache BFF + giới hạn tần suất) |
+ Nền tảng đầu tiên tại VN cấp chuẩn MCP kiểm chứng giá & review | +88 | +
F5. Cảnh báo chạm giá mục tiêu, đáy ATL & có hàng lại đa kênh |
+ 8B | +Rất cao (không cần tự canh giá mỗi ngày, không bỏ lỡ đáy thật) | +80% (rate.price_alerts, upsert_price_alert, PriceAlertEvaluator) |
+ M |
+ Pha 1 Email: 0 DDL; Pha 2 Push/Telegram: 1 PR DOS-Me | +Thấp (SMTP/Resend theo sự kiện giảm giá thật, có chống dội thư) | +Tỷ lệ giữ chân người dùng (Retention) gắn chặt với DOS ID |
+ 86 | +
F6. MV3 Extension 3.0: Cảnh báo trang Giỏ hàng (Checkout Guard) & Ghim giá 1 chạm |
+ 8B | +Cao (cứu người mua đúng giây phút sắp bấm thanh toán hớ) | +85% (Shadow DOM Pill 22 sàn, Side Panel, #1859) |
+ M |
+ Guard + Ghim: 0 DDL; M2 đủ 22 sàn: chờ #1762 |
+ $0 (gọi lookup theo phiên giỏ hàng, có cache cục bộ) |
+ Hiện diện trực tiếp ngay tại điểm thanh toán trên 22 sàn | +83 | +
F7. Bộ tính "Giá Thực Trả", tách Chính hãng VN/A & Kiểm chứng Thu Cũ Đổi Mới |
+ 8C | +Rất cao với flagship 20-50 triệu VND (hiểu rõ chênh lệch bảo hành & trợ giá) | +70% (ProductNormalizer origin, ProductValueCalculator) |
+ M - L |
+ Pha 1 BFF: 0 DDL; Pha 2 lưu bảng: 1 PR DOS-Me | +$0 (quy tắc định danh minh bạch, không dùng LLM lúc đọc) |
+ Am hiểu sâu luật chơi bán lẻ công nghệ nội địa Việt Nam | +81 | +
| F8. Tối ưu Giỏ hàng Combo đa sàn (2-5 món) & Huy hiệu Chuỗi Uy Tín 180 ngày | +8C | +Cao khi sắm trọn bộ (Laptop + Màn hình/SSD/Tai nghe hoặc hệ sinh thái Apple) | +75% (getMasterProductOffersBatch, v_products_with_merchant_trust) |
+ M - L |
+ Pha 1: Không (0 DDL); Huy hiệu lưu sẵn: tuỳ chọn | +$0 (thuật toán quy hoạch tổ hợp nhỏ chạy trong vài mili-giây) |
+ Kết hợp độc nhất giữa Giá tổng + Rủi ro DOSafe trên 22 chuỗi |
+ 78 | +
Lấy cảm hứng trực tiếp từ Hlídač shopů (CH Séc - công cụ giám sát tuân thủ Điều 6a Chỉ thị EU Omnibus 2019/2161) kết hợp phân vị chu kỳ giá của Keepa và Prisjakt.
+rate.price_history có chỉ mục BRIN trên recorded_at và chống trùng theo observation_id.rate.listing_price_context (20261106150000_rate_listing_price_context_peer_max_history_first.sql) đã tính trung vị 60 ngày, peer_reference_max và kiểm tra độ tuổi lịch sử tối thiểu 14 ngày cho PriceAnomalyAuditor.PriceHistorySection.tsx đã vẽ biểu đồ 30d / 90d / all và gắn nhãn fake_discount, suspicious_discount, genuine_deal; deal-radar.ts đã có quy tắc từ 3 nơi bán trở lên cho nhãn đáy giá đa sàn (#1145, #1630)./deals và /inspect: Tách bạch 3 con số minh bạch cho từng gian hàng đang treo khuyến mãi: (1) Giá gạch ngang shop tự ghi, (2) Giá thấp nhất thực tế trong 30 ngày liền trước (prior_30d_min_price chỉ được gắn nhãn Chuẩn Omnibus 30 ngày khi price_history phủ đủ trọn vẹn cửa sổ tham chiếu từ 30 ngày trở lên và mật độ điểm đo liên tục; nếu mới quan sát được N < 30 ngày thì chỉ hiện "Đáy quan sát trong N ngày qua" và giữ nguyên trạng thái chưa kết luận Omnibus), và (3) Mức giảm/tăng thực chất.Mua Ngay hay Chờ? (Percentile 90 ngày): Tính vị trí giá tốt nhất hiện tại của sản phẩm trong dải 90 ngày (khi đủ số điểm quan sát hợp lệ): vùng <= P15 hiện nhãn xanh "Vùng đáy 90 ngày - Thời điểm tốt để mua"; vùng P15 - P70 hiện "Giá ổn định thị trường"; vùng > P70 (hoặc vừa nảy lên sau đợt sale) hiện "Đang cao hơn đáy gần nhất X đ - Nên bật cảnh báo chờ sale"./deals: Chế độ xem nhanh "Top Giảm Thật Đợt Sale" và "Cảnh Báo Tăng Giá Đệm Trước Sale" trên toàn bộ 22 chuỗi.$0, không gọi AI, nằm gọn trong luồng đọc lịch sử giá đã cache bởi RATE_CACHE_TAGS.PRICE_HISTORY.Lấy cảm hứng từ RTINGS.com Custom Ratings & Use-Case Scoring - biến bảng điểm tĩnh thành công cụ tư vấn khách quan không cần chatbot AI.
+ANC) và Đeo thoải mái lên tới 70%.packages/shared-data/src/rules/rating-criteria.ts (RATING_CRITERIA_VERSION = 1) đã định nghĩa đầy đủ danh sách tiêu chí đa ngôn ngữ (vi, en, cs), trọng số gốc tổng bằng 100 và ánh xạ SpecGroupKey cho cả 5 ngành thiết bị.rate.master_products.criteria_scores (20261101120000_rate_criteria_ratings.sql), expert_criteria_scores, cùng hàm weightedCriteriaScore5 trong leaderboard-engine.ts và trang so sánh CompareWorkspace.tsx (tối đa MAX_COMPARE_ITEMS = 4 máy) đã hoạt động trên Production.0% - 100% (tự chuẩn hóa tổng về 100%): Tích hợp ngay trên đầu /leaderboard, /compare và trang đối đầu 1v1 /compare/[versus], tự động tính lại Điểm hợp nhu cầu của bạn và đổi ngôi vị người thắng cuộc kèm lời giải thích toán học rõ ràng./compare/iphone-17-vs-galaxy-s26?preset=camera) mà không tạo rác chỉ mục SEO (giữ rel="canonical" về URL gốc)./compare và /leaderboard. Giới hạn phạm vi & chi phí rõ ràng: trên /compare (2-4 máy đã chọn) và trên tập ứng viên mà /leaderboard tải sẵn qua SSR (hiện giới hạn tối đa 100 mẫu xếp cao nhất mỗi ngành hàng khi RATE_ITEM_MODEL tắt), phép tính lại phía trình duyệt tốn $0 nhưng chỉ sắp xếp lại trong tập ứng viên đã tải đó; nếu muốn một mẫu nằm ngoài top 100 mặc định vẫn có thể vươn lên top đầu theo trọng số riêng (ví dụ chuyên Gaming), cần nạp đủ danh sách ứng viên hợp lệ của ngành hàng (vốn gọn nhẹ) hoặc đẩy bộ trọng số chuẩn hóa qua tham số truy vấn của /api/v1/rate/leaderboard có bọc cache.#1531 D3/D9: luôn giữ nguyên và hiển thị rõ "Điểm chuẩn Rate.vn" ở cột gốc để không gây nhầm lẫn một máy có hai số điểm khác nhau; điểm tùy chỉnh được gắn nhãn riêng "Điểm theo trọng số bạn chọn"; các tiêu chí chưa đủ số lượng đánh giá thật vẫn giữ trạng thái không bịa số.Biến mỗi lượt dán link trên Zalo, Messenger, Facebook Group, VOZ, Threads, Telegram hay TikTok thành một tấm danh thiếp kiểm chứng giá chuyên nghiệp.
+apps/web/src/app chưa có bất kỳ route opengraph-image hay /api/og nào, còn ProductShareAuditButton.tsx mới chỉ xuất văn bản Markdown / CSV. Khi người dùng gửi link sản phẩm hoặc kèo so sánh /compare/a-vs-b vào nhóm chat gia đình trên Zalo hoặc diễn đàn VOZ để hỏi ý kiến, bản xem trước chỉ hiện logo tĩnh chung chung, đánh mất hoàn toàn sức nặng thuyết phục của dữ liệu 22 sàn.ProductShareAuditButton.tsx đã chuẩn hóa và làm sạch toàn bộ trường dữ liệu chia sẻ (sanitizeShareAuditText, điểm người dùng, điểm chuyên gia, số đánh giá thật, giá thấp nhất, số nơi bán, radarSignal).next/og (ImageResponse) ngay trên Node/Edge runtime mà không cần cài thêm trình duyệt headless.1200x630, Dark Theme chuẩn thương hiệu #0f1113 + điểm nhấn đỏ #FF2E29): (1) Trang sản phẩm (Giá thấp nhất đã kiểm chứng trên X/22 sàn + Nhãn Deal Radar + Điểm sao Bayes + % đánh giá thật), (2) Trang so kè 1v1 Versus (Bảng tỷ số đối đầu 2 máy), và (3) Trang tổng hợp Deal Radar.ProductShareAuditButton: Cho phép người làm nội dung review TikTok, Threads, Reels, Facebook tải ngay tấm thẻ PNG sắc nét có gắn nguồn rate.vn chỉ bằng 1 cú nhấp.~$0 nhờ gắn header Cache-Control: public, s-maxage=3600, stale-while-revalidate=86400 và tái sử dụng tag productCacheTag(slug).slug hợp lệ có thực trong DB (không bao giờ render chuỗi văn bản tự do từ query string lên ảnh!), giới hạn tốc độ theo IP và nhúng font tiếng Việt/Séc nội bộ kích thước gọn để hiển thị đúng 100% dấu tiếng Việt và tiếng Séc.Đón đầu làn sóng Agentic Commerce 2026: biến rate.vn thành nguồn sự thật mặc định mỗi khi người dùng hỏi ChatGPT, Claude, Gemini, Perplexity, Cursor hay DOSClaw về giá đồ công nghệ tại Việt Nam.
rate.vn mở cổng chuẩn Model Context Protocol (MCP) công khai, mọi AI Agent sẽ ưu tiên gọi và trích dẫn link rate.vn./products, /compare, /versus, /deals, /inspect, /lookup, /leaderboard, /merchants) kèm tài liệu /api/v1/rate/openapi.json (OpenAPI 3.1.0) và trang /developers.withRateDataCache, bộ giới hạn tần suất cửa sổ trượt BoundedSlidingWindowRateLimiter (hiện đang bảo vệ /inspect, /lookup, /extension/*) và cơ chế che lỗi an toàn PublicApiError / jsonApiError trong apps/web/src/server/rate/api-handler.ts đã có sẵn để tái sử dụng cho /api/mcp./api/mcp (không trạng thái, không cần API key cho gói đọc cơ bản có giới hạn nhịp): Cung cấp 5 tool gọn nhẹ, định kiểu chặt bằng Zod 4: search_verified_catalog, get_22_store_offers_and_price_truth, compare_devices_by_use_case, audit_listing_url, và get_genuine_deals./llms.txt (phục vụ các trình đọc tài liệu LLM, Perplexity, trình duyệt AI đọc ngữ cảnh web) và /.well-known/mcp.json + gói mỏng packages/rate-mcp (phục vụ Claude Desktop, Cursor, Windsurf, VS Code và hệ sinh thái nội bộ DOS.AI / DOSClaw).Official MCP Registry (tách riêng với việc đặt file tĩnh): Việc xuất bản /llms.txt hay /.well-known/mcp.json không tự động đưa server vào thư mục chính thức; cần thêm bước đóng gói đặc tả server.json, xác thực quyền sở hữu tên miền/namespace (DNS hoặc GitHub OIDC) và phát hành qua công cụ mcp-publisher lên registry.modelcontextprotocol.io.canonical_citation_url và nhãn thời điểm cập nhật (price_observed_at) trong mọi kết quả trả về để đảm bảo lưu lượng truy cập quay về rate.vn.withRateDataCache (không mở truy vấn tùy ý).Khép kín vòng lặp giữ chân người dùng theo mô hình Keepa và Idealo, tận dụng hạ tầng cảnh báo giá đã xây xong 80% trong DB.
+DOS ID có thể lưu mức giá mong muốn trên /watchlist (lưu vào bảng rate.price_alerts qua RPC rate.upsert_price_alert, tối đa 100 cảnh báo/người), và phía DOS/Rate-Services đã có PriceAlertEvaluator. Tuy nhiên, người mua vẫn thiếu trải nghiệm nhận thông báo chủ động tinh gọn, công tắc "Chỉ báo khi shop Chính hãng giảm giá" (tránh bị đánh thức bởi giá mồi của shop rủi ro cao) và nút hủy đăng ký 1 chạm.rate.price_alerts + khóa bảo mật 20261018120000_rate_price_alert_auth_gate.sql (bắt buộc email đã xác minh trong auth.users, khóa chống đua pg_advisory_xact_lock, cột last_triggered_at, đa ngôn ngữ vi/en/cs).GET/POST /api/v1/rate/watchlist và giao diện WatchlistWorkspace.tsx + xác thực RateAuthPortal.tsx.vi, en, cs) từ worker khi current_min_price <= target_price tại gian hàng hợp lệ (không phải giá mồi, in_stock), có thời gian nghỉ chống gửi lặp (ví dụ tối thiểu 7 ngày cho cùng một mức giá) và link hủy theo chuẩn RFC 8058 List-Unsubscribe ký bằng HMAC.DOS-Me): Thêm tùy chọn official_only (chỉ báo chuỗi is_official = true và threat_risk_score <= 20), notify_on_atl (báo ngay khi lập đáy 90 ngày dù chưa chạm số gõ tay), cảnh báo "Có hàng trở lại" cho các mẫu cháy hàng đợt đầu (như iPhone Pro Max mới ra mắt), cùng kênh Web Push (PWA) và Telegram Bot liên kết DOS ID.DOS ID thật có xác minh email. Chi phí gửi email rất thấp vì chỉ phát sinh khi có biến động giảm giá thực sự vượt ngưỡng.upsert_price_alert khóa chặt theo auth.uid()); kiểm tra nghiêm uy tín tên miền gửi thư (SPF, DKIM, DMARC) và tự động tắt cảnh báo nếu email bị trả lại (bounce).Nâng cấp tiện ích trình duyệt Chrome MV3 vừa được mở rộng lên 22 chuỗi ở #1859 để bảo vệ người mua ngay tại bước thanh toán.
apps/extension/src/content/content-script.ts) đã có sẵn viên thuốc nổi (Shadow DOM Floating Trust Pill) trên trang chi tiết sản phẩm của cả 22 sàn, hiển thị câu pillCheaperAt ("Rẻ hơn tại X nơi, tiết kiệm Y đ"), cờ radar-trap và điểm tin cậy. Điểm còn thiếu là: (1) khi người mua đi thẳng từ quảng cáo vào trang Giỏ hàng / Thanh toán thì chưa có cảnh báo, (2) trong Side Panel chưa có nút bấm 1 chạm để đặt cảnh báo giá mà phải mở tab web mới, và (3) luồng đóng góp quan sát giá M2 mới mở cho 10 sàn gốc, còn 12 chuỗi mới đang chờ mở rộng ràng buộc SQL ở #1762.Checkout Price-Trap Guard (không xâm lấn, tôn trọng quyền riêng tư): Khi người dùng ở trang giỏ hàng của 1 trong 22 chuỗi và sắp thanh toán một thiết bị đang bị đánh dấu inflated_fake_sale hoặc đắt hơn chuỗi chính hãng khác từ >= 5% (hoặc >= 500.000đ), hiển thị một dải thông báo gọn có thể tắt: chỉ rõ chuỗi chính hãng nào đang còn hàng rẻ hơn bao nhiêu tiền.POST /api/v1/rate/watchlist ngay trong Side Panel mà không rời trang mua sắm.#1762 & #1606): Sau khi JOY duyệt PR mở rộng danh sách sàn trong SQL DOS-Me, toàn bộ 12 chuỗi điện máy và PC mới (GearVN, HACOM, An Phát, ShopDunk, TopZone, Điện Máy Xanh...) sẽ có độ tươi giá thời gian thực ngang hàng 10 sàn đầu.manifest.json (giữ nguyên chỉ storage, sidePanel và 38 mẫu URL host_permissions hiện có của 22 sàn và rate.vn).Giải quyết vùng mù lớn nhất của thị trường bán lẻ thiết bị công nghệ Việt Nam khi so sánh giữa các chuỗi lớn (TGDĐ, FPT Shop, CellphoneS, ShopDunk, TopZone) với các cửa hàng giá rẻ và sàn TMĐT.
VN/A nguyên seal xuất hóa đơn VAT đầy đủ và bảo hành ủy quyền 12 tháng, bên kia là hàng nhập khẩu hoặc đã kích hoạt bảo hành điện tử trước. Thêm vào đó, các biển quảng cáo "Thu cũ đổi mới trợ giá 3 triệu" thường tính trên điều kiện máy cũ "Loại 1 hoàn hảo 100%", khiến khách mang máy ra cửa hàng hay bị trừ tiền xước nhẹ/chai pin xuống Loại 2-3 rất hụt hẫng.ProductNormalizer (apps/importer/src/shopee/product-normalizer.ts) đã có kiểu phân loại ProductOrigin = 'official_vna' | 'imported' | 'unknown' và chặn hàng cũ used ngay từ đầu vào (#1430, #1561).ProductValueCalculator.tsx đã có công cụ tính chi phí sở hữu thực tế theo chu kỳ 12 / 24 / 36 tháng kèm tỷ lệ giữ giá bán lại (estimateResaleRetentionRatio).rate.promotions đã tồn tại trong schema nền (20261005130001_rate_platform_tables.sql).ProductOffersExplorer.tsx): Gắn huy hiệu rõ ràng "Đại lý ủy quyền / Chính hãng VAT", "Gian hàng Mall trên sàn", hoặc "Cửa hàng độc lập - Kiểm tra kỹ điều kiện kích hoạt bảo hành" kèm bộ lọc nhanh.ProductValueCalculator: Cho người mua chọn tình trạng máy cũ thực tế (Đẹp không tì vết / Xước dăm nhẹ / Pin dưới 85%) để so sánh minh bạch giữa phương án mang ra chuỗi đổi nhanh (tiện, an toàn nhưng có hệ số khấu trừ ngoại hình) và phương án tự bán lại + mua đứt ở chuỗi đang có đáy giá trên rate.vn.$0 cho Pha 1.Kết hợp bài toán tối ưu giỏ hàng đa nhà bán của Prisjakt / BestPrice với chương trình chứng nhận nhà bán hàng tin cậy 180 ngày của Heureka.cz (Ověřeno zákazníky).
+GearVN, HACOM, An Phát, Phong Vũ, CellphoneS, Shopee). Nếu mua gom hết tại 1 chuỗi thì tổng hóa đơn thường đắt hơn 1,5-4 triệu VND; nhưng nếu xé lẻ mỗi món một shop rẻ nhất thì dễ vướng shop rủi ro cao, tốn nhiều lần nhận hàng và rắc rối bảo hành.getMasterProductOffersBatch và API GET /api/v1/rate/watchlist?slugs=... đã tải song song toàn bộ lời chào bán còn hàng hợp lệ của tối đa 20 sản phẩm trong một lần gọi.rate.v_products_with_merchant_trust đã hợp nhất điểm rủi ro an ninh mạng dosafe_risk_score (từ dosafe.threat_intel) và điểm rủi ro đánh giá ảo review_risk_score cho từng nhà bán./watchlist: Khi người dùng đánh dấu từ 2 đến 5 sản phẩm trong danh sách theo dõi, hệ thống giải bài toán tối ưu và đề xuất song song 2 phương án:
+ (A) Phương án Tiết kiệm tối đa (tách tối đa 2-3 chuỗi uy tín, chỉ nhận gian hàng có threat_risk_score <= 20) và
+ (B) Phương án Tiện lợi 1 điểm đến (1 chuỗi duy nhất đang có đủ hàng với tổng tiền thấp nhất), hiển thị rõ số tiền chênh lệch giữa hai phương án./merchants và bảng giá: Chỉ cấp tự động cho nhà bán đạt đồng thời 3 ngưỡng cứng: không có cờ cảnh báo DOSafe, tỷ lệ đánh giá thật 6 trục cao ổn định trong 180 ngày và không tái diễn hành vi nâng giá gốc giảm ảo.#1859 (đặc biệt hiệu quả với tệp khách hàng mua đồ công nghệ giá trị cao). Thuật toán chạy trên tập tối đa 5 sản phẩm x 22 sàn nên hoàn tất dưới 5ms trên BFF, chi phí $0.rate.vn.Để giữ kiến trúc 4 tầng gọn nhẹ, không phát sinh chi phí LLM định kỳ và không làm loãng định vị "Sự thật giá & đánh giá", Brand khuyến nghị gạt bỏ 3 hướng sau trong Phase 8:
+ +Lý do không làm: Tốn chi phí token LLM liên tục, dễ bị tấn công prompt-injection và nguy hiểm nhất là rủi ro AI "nói nhịu" sai giá sản phẩm. Bộ đôi F2 (Thanh trượt trọng số RTINGS) + F4 (MCP cho AI riêng của người dùng) giải quyết bài toán tư vấn chính xác 100% với chi phí LLM bằng $0 cho Rate.
Lý do không làm: Đòi hỏi can thiệp sâu vào ô nhập liệu thanh toán của các sàn, dễ gây xung đột giao diện, làm chậm quy trình duyệt Chrome Web Store và dễ gây nghi ngại về quyền riêng tư. F6 (Checkout Price-Trap Guard chỉ đọc) an toàn, minh bạch và đúng chất kiểm chứng của Rate hơn nhiều.
+Lý do không làm: Kéo theo rủi ro lừa đảo giao dịch, kiểm duyệt tin đăng rác và hỗ trợ tranh chấp nặng nề, đi chệch khỏi mô hình Open-Core dữ liệu kiểm chứng. Thay vào đó, F7 (Bộ tính tham khảo Thu cũ đổi mới vs Bán lại) hỗ trợ người dùng ra quyết định mà không ôm rủi ro vận hành chợ.
+
+ Theo đúng quy chuẩn Product Owner (AGENTS.md Mục 6), chưa có bất kỳ issue tính năng nào được tạo. Khi JOY chọn một trong các phương án dưới đây trong phiên chat với PO, PO mới tiến hành tách thành các đặc tả issue chuẩn trên GitHub Project #9:
+
| Phương án lựa chọn | +Phạm vi tính năng đưa vào Backlog Phase 8 | +Yêu cầu duyệt Migration DOS-Me | +Khuyến nghị | +
|---|---|---|---|
| Phương án 1 (Khuyến nghị) | +Triển khai trọn bộ Gói 8A (F1 + F2 + F3 + F4) trước để kịp mùa sale cuối năm, đồng thời lên thiết kế kỹ thuật sẵn cho F5 (Cảnh báo giá Email - Gói 8B Pha 1). | +Không cần bất kỳ DDL nào trên DOS-Me (chạy thẳng trên DOS/Rate và Rate-Services). |
+ Khuyến nghị số 1: Tốc độ ra mắt nhanh nhất, rủi ro bằng 0, tạo ngay cả giá trị chống giá ảo lẫn kênh lan truyền MXH + AI. | +
| Phương án 2 (Tăng tốc toàn diện) | +Duyệt cả Gói 8A + Gói 8B đầy đủ (F1 đến F6), bao gồm cả Web Push / Telegram cho cảnh báo giá và đồng bộ M2 22 sàn (#1762). |
+ Cần JOY duyệt 1-2 PR migration nhỏ bên DOS-Me ở nửa sau của đợt triển khai. |
+ Phù hợp nếu JOY muốn đẩy mạnh giữ chân tài khoản DOS ID và Chrome Web Store ngay trong Q4/2026 - Q1/2027. |
+
| Phương án 3 (Chọn lẻ theo mã) | +JOY chỉ định trực tiếp các mã muốn làm (ví dụ: "Chỉ làm F1, F2, F7"). |
+ Tùy theo mã được chọn (F1, F2, F3, F4, F6-Guard, F8-Pha1 đều 0 DDL). |
+ Linh hoạt theo ưu tiên sản phẩm riêng của JOY. | +
+ Tài liệu tự chứa 100% (không phụ thuộc CDN hay tài nguyên ngoài). Kiểm chứng mã nguồn tại nhánh docs/1861-phase8-feature-brainstorm (dựa trên origin/dev commit 56309d8a).
+
{t('mcpSubtitle')}
+{t('mcpGuardNote')}
+
+ {toolKey}
+
+
+ {t('mcpReadOnlyBadge')}
+
+
+ {MCP_CLIENT_CONFIG_SNIPPET}
+
+
+ {MCP_JSON_RPC_CURL_SNIPPET}
+
+ 0 && ` ${t('versusVerdictExpertSource', { name: verdictExpertNames.join(', ') })}`} - {personaLead && ( + {personaLead && !customWeightedPair && ( {t(personaLead.key, personaLead.values)} )}
{t('radarNoGenuine')}
- )} -{t('radarNoGenuine')}
+ )} +{t('radarNoTraps')}
- )} -{t('radarNoTraps')}
+ )} +- {t('emptyBudgetText', { - budget: formatNumber(maxBudgetVnd, locale), - })} + {campaignFilter === 'genuine_sale_drops' && + baseRankedDeals.length > 0 + ? t('campaignEmptyGenuine') + : campaignFilter === 'inflated_presale_warnings' && + baseRankedDeals.length > 0 + ? t('campaignEmptyTraps') + : t('emptyBudgetText', { + budget: formatNumber(maxBudgetVnd, locale), + })}
diff --git a/apps/web/src/components/product/item/ItemLazySizePanel.tsx b/apps/web/src/components/product/item/ItemLazySizePanel.tsx
index 46d96424..464384de 100644
--- a/apps/web/src/components/product/item/ItemLazySizePanel.tsx
+++ b/apps/web/src/components/product/item/ItemLazySizePanel.tsx
@@ -196,6 +196,7 @@ function renderSize(
currentMinPrice: data.stats.minPrice > 0 ? data.stats.minPrice : null,
}}
radarSignal={data.radarSignal}
+ offers={data.offers}
/>
);
}
diff --git a/apps/web/src/lib/__tests__/compare-params.test.ts b/apps/web/src/lib/__tests__/compare-params.test.ts
index 6315f23b..0462f1f8 100644
--- a/apps/web/src/lib/__tests__/compare-params.test.ts
+++ b/apps/web/src/lib/__tests__/compare-params.test.ts
@@ -1,5 +1,33 @@
import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+ RATING_DEVICE_CATEGORIES,
+ getRatingCriteria,
+ getRatingUseCasePresets,
+} from '@repo/shared-data/rules';
import { compareCategoryParam } from '../compare-params';
+import { weightedCriteriaScore5 } from '../leaderboard-engine';
+import {
+ availableCategoryUseCasePresets,
+ computeCustomWeightedScore5,
+ defaultCategoryWeights,
+ extractCategoryCriteriaScores,
+ formatNormalizedWeightSummary,
+ isDefaultCategoryWeights,
+ mergeUseCaseQueryIntoSearch,
+ normalizeCategoryWeights,
+ parseUseCaseWeightsFromParams,
+ parseWeightsParam,
+ resolveCategoryPreset,
+ sanitizeSliderWeight,
+ scoredCategoryCriteriaForProducts,
+ serializeWeightsParam,
+ sharedCategoryCriteriaForPair,
+ toLegacyCriteriaWeights,
+ toLegacyVersusPersona,
+} from '../use-case-weights';
// Compare links written with ?cat= open on their category (DOS/Rate#1303).
assert.equal(compareCategoryParam({ cat: 'earbuds' }), 'earbuds');
@@ -12,4 +40,563 @@ assert.equal(
assert.equal(compareCategoryParam({ cat: ['tablets', 'x'] }), 'tablets');
assert.equal(compareCategoryParam({}), undefined);
assert.equal(compareCategoryParam({ category: '', cat: 'earbuds' }), 'earbuds');
-console.log('✅ compare params');
+
+// ============================================================================
+// RTINGS-Style Category Use-Case Presets & Custom Weight Math (DOS/Rate#1864)
+// ============================================================================
+{
+ const testDir = path.dirname(fileURLToPath(import.meta.url));
+ const webSrcDir = path.resolve(testDir, '../..');
+
+ // 1. Pure client-safe boundary & zero em/en-dash guard
+ for (const relPath of [
+ 'lib/use-case-weights.ts',
+ 'components/compare/UseCaseWeightBar.tsx',
+ ]) {
+ const src = fs.readFileSync(path.join(webSrcDir, relPath), 'utf8');
+ assert.doesNotMatch(
+ src,
+ /\bfrom\s+['"][^'"]*server\/rate/,
+ `${relPath} must stay client-safe with zero @/server/rate imports`
+ );
+ assert.doesNotMatch(
+ src,
+ /[\u2013\u2014]|—|–/,
+ `${relPath} must contain zero em-dashes or en-dashes`
+ );
+ }
+
+ // 2. Category preset coverage & sum=100 across all 5 categories
+ for (const cat of RATING_DEVICE_CATEGORIES) {
+ const defaults = defaultCategoryWeights(cat);
+ const defaultSum = Object.values(defaults).reduce(
+ (acc, v) => acc + (v ?? 0),
+ 0
+ );
+ assert.equal(defaultSum, 100, `${cat} default weights sum to 100`);
+
+ const presets = getRatingUseCasePresets(cat);
+ assert.ok(presets.length >= 4, `${cat} offers curated use-case presets`);
+ assert.equal(presets[0]?.id, 'default');
+ for (const preset of presets) {
+ const resolved = resolveCategoryPreset(cat, preset.id);
+ assert.equal(resolved.id, preset.id);
+ const norm = normalizeCategoryWeights(cat, preset.weights);
+ assert.equal(norm.wasAllZeroReset, false);
+ const pctSum = Object.values(norm.normalizedPercent).reduce(
+ (acc, v) => acc + (v ?? 0),
+ 0
+ );
+ assert.equal(
+ pctSum,
+ 100,
+ `${cat}:${preset.id} normalized percent sums to 100`
+ );
+ }
+ }
+
+ // Friendly URL preset aliases & category-aware aliases
+ assert.equal(
+ resolveCategoryPreset('smartphones', 'photography').id,
+ 'camera'
+ );
+ assert.equal(resolveCategoryPreset('smartphones', 'VLOG').id, 'camera');
+ assert.equal(resolveCategoryPreset('earbuds', 'anc').id, 'commute_anc');
+ assert.equal(resolveCategoryPreset('earbuds', 'music').id, 'audiophile');
+ assert.equal(resolveCategoryPreset('laptops', 'business').id, 'office');
+ assert.equal(resolveCategoryPreset('tablets', 'business').id, 'study_work');
+ assert.equal(
+ resolveCategoryPreset('smartwatches', 'business').id,
+ 'smart_daily'
+ );
+
+ // Prototype-key & malformed preset guards
+ for (const badPreset of [
+ '__proto__',
+ 'constructor',
+ 'prototype',
+ 'toString',
+ 'valueOf',
+ 'unknown_preset',
+ 'gaming;drop',
+ '',
+ ' ',
+ null,
+ undefined,
+ 42,
+ {},
+ ]) {
+ assert.equal(
+ resolveCategoryPreset('smartphones', badPreset).id,
+ 'default',
+ `Unsafe preset ${String(badPreset)} falls back to default`
+ );
+ }
+
+ // 3. Slider clamping, Hare-Niemeyer exact 100% normalization & all-zero reset
+ assert.equal(sanitizeSliderWeight(-25, 10), 0);
+ assert.equal(sanitizeSliderWeight(180, 10), 100);
+ assert.equal(sanitizeSliderWeight('35.6', 0), 36);
+ assert.equal(sanitizeSliderWeight(Number.NaN, 15), 15);
+ assert.equal(sanitizeSliderWeight(Number.POSITIVE_INFINITY, 20), 20);
+ assert.equal(sanitizeSliderWeight('0x20', 12), 12);
+ assert.equal(sanitizeSliderWeight('25\u0000', 12), 12);
+ assert.equal(sanitizeSliderWeight({ valueOf: () => 50 }, 12), 12);
+
+ const threeEqual = normalizeCategoryWeights('smartphones', {
+ performance: 10,
+ camera: 10,
+ battery: 10,
+ display: 0,
+ design: 0,
+ value: 0,
+ });
+ assert.equal(threeEqual.wasAllZeroReset, false);
+ assert.equal(threeEqual.normalizedPercent.performance, 34);
+ assert.equal(threeEqual.normalizedPercent.camera, 33);
+ assert.equal(threeEqual.normalizedPercent.battery, 33);
+ assert.equal(
+ Object.values(threeEqual.normalizedPercent).reduce((a, b) => a + b, 0),
+ 100
+ );
+
+ const allZero = normalizeCategoryWeights('laptops', {
+ performance: 0,
+ display: 0,
+ battery: 0,
+ keyboard: 0,
+ thermals: 0,
+ design: 0,
+ value: 0,
+ });
+ assert.equal(allZero.wasAllZeroReset, true);
+ assert.deepEqual(allZero.sliderWeights, defaultCategoryWeights('laptops'));
+ assert.equal(
+ Object.values(allZero.normalizedPercent).reduce((a, b) => a + b, 0),
+ 100
+ );
+
+ const protoPayload = JSON.parse(
+ '{"__proto__":{"polluted":true},"constructor":80,"toString":50,"valueOf":50}'
+ ) as Record