From 7755067f15051cfa08994ee3c99f6e4e5acdf71e Mon Sep 17 00:00:00 2001 From: JOY <5027251+JOY@users.noreply.github.com> Date: Sun, 22 Nov 2026 21:52:28 +0700 Subject: [PATCH] feat(web): add dynamic OpenGraph truth cards and social PNG download Implement /api/v1/rate/og and og-truth-card.tsx for product, 1v1 versus, and Deal Radar cards across vi/en/cs in 1200x630 and 1080x1350 formats, wire openGraph and twitter metadata, and add 1-click social PNG download to ProductShareAuditButton. Closes #1865 --- apps/web/locales/cs.json | 2 + apps/web/locales/en.json | 2 + apps/web/locales/vi.json | 2 + .../app/[locale]/compare/[versus]/page.tsx | 21 +- apps/web/src/app/[locale]/deals/page.tsx | 27 +- .../app/[locale]/smartphones/[slug]/page.tsx | 26 +- apps/web/src/app/api/v1/rate/og/route.ts | 432 +++++ .../leaderboard/ProductShareAuditButton.tsx | 85 + .../lib/__tests__/product-detail-copy.test.ts | 72 + apps/web/src/lib/__tests__/seo.test.ts | 420 ++++- apps/web/src/lib/og-truth-card.tsx | 1579 +++++++++++++++++ apps/web/src/lib/seo.ts | 215 +++ 12 files changed, 2865 insertions(+), 18 deletions(-) create mode 100644 apps/web/src/app/api/v1/rate/og/route.ts create mode 100644 apps/web/src/lib/og-truth-card.tsx diff --git a/apps/web/locales/cs.json b/apps/web/locales/cs.json index ea5b02d30..6ad69152a 100644 --- a/apps/web/locales/cs.json +++ b/apps/web/locales/cs.json @@ -1221,6 +1221,8 @@ "shareAuditCopyLinkTitle": "Zkopírovat odkaz na produkt", "shareAuditCopiedLinkBtn": "✓ Odkaz zkopírován!", "shareAuditCopyLinkBtn": "Kopírovat odkaz", + "shareAuditDownloadPngTitle": "Stáhnout obrázek karty pravdy (PNG 4:5) pro sítě a chat", + "shareAuditDownloadPngBtn": "Stáhnout kartu (PNG 4:5)", "specsToolbarCopiedMd": "10 skupin parametrů zkopírováno!", "specsToolbarCopyMd": "Kopírovat 10 skupin parametrů MD", "specsToolbarExportCsv": "Exportovat parametry CSV", diff --git a/apps/web/locales/en.json b/apps/web/locales/en.json index 4fb58a61f..de00af668 100644 --- a/apps/web/locales/en.json +++ b/apps/web/locales/en.json @@ -1221,6 +1221,8 @@ "shareAuditCopyLinkTitle": "Copy product URL", "shareAuditCopiedLinkBtn": "✓ Copied link!", "shareAuditCopyLinkBtn": "Copy link", + "shareAuditDownloadPngTitle": "Download a 4:5 truth card PNG to share on forums or chat", + "shareAuditDownloadPngBtn": "Download truth card (PNG)", "specsToolbarCopiedMd": "Copied 10-group specs!", "specsToolbarCopyMd": "Copy 10-group specs MD", "specsToolbarExportCsv": "Export specs CSV", diff --git a/apps/web/locales/vi.json b/apps/web/locales/vi.json index 72f4ea0eb..e16f32efc 100644 --- a/apps/web/locales/vi.json +++ b/apps/web/locales/vi.json @@ -1221,6 +1221,8 @@ "shareAuditCopyLinkTitle": "Sao chép đường dẫn sản phẩm", "shareAuditCopiedLinkBtn": "✓ Đã chép link!", "shareAuditCopyLinkBtn": "Chép link", + "shareAuditDownloadPngTitle": "Tải ảnh thẻ sự thật (PNG 4:5) để chia sẻ lên diễn đàn hoặc nhóm chat", + "shareAuditDownloadPngBtn": "Tải thẻ sự thật (PNG 4:5)", "specsToolbarCopiedMd": "Đã chép 10 nhóm thông số!", "specsToolbarCopyMd": "Sao chép 10 nhóm thông số MD", "specsToolbarExportCsv": "Xuất CSV thông số", diff --git a/apps/web/src/app/[locale]/compare/[versus]/page.tsx b/apps/web/src/app/[locale]/compare/[versus]/page.tsx index d54f4ca75..a275ea045 100644 --- a/apps/web/src/app/[locale]/compare/[versus]/page.tsx +++ b/apps/web/src/app/[locale]/compare/[versus]/page.tsx @@ -18,7 +18,13 @@ import { import { catalogRowSlug, type ItemCatalogRow } from '@/lib/item-directory'; import { getItemSlugsFor } from '@/server/rate/item-directory'; import { normalizeRateLocale } from '@/lib/rate-i18n'; -import { defaultOpenGraph, fitTitle, fitDescription } from '@/lib/seo'; +import { + buildOgTruthCardImage, + defaultOpenGraph, + defaultTwitterCard, + fitTitle, + fitDescription, +} from '@/lib/seo'; import { scoreMasterProductForLeaderboard } from '@/lib/leaderboard-engine'; import PageShell from '../../components/page-shell'; import CompareWorkspace from '@/components/compare/CompareWorkspace'; @@ -102,9 +108,12 @@ export async function generateMetadata({ return notFoundMeta(); } + const canonicalVersusSlug = plan + ? plan.canonical.replace(/^\/compare\//, '') + : `${pair[0]}-vs-${pair[1]}`; const canonicalUrl = plan ? `https://rate.vn${plan.canonical}` - : `https://rate.vn/compare/${pair[0]}-vs-${pair[1]}`; + : `https://rate.vn/compare/${canonicalVersusSlug}`; const fullTitle = t('versusMetaTitle', { nameA: a.name, nameB: b.name }); // Both names first; the fixed text, then the site name, give way to fit a // search result (DOS/Rate#777). The share card keeps the full title. @@ -124,6 +133,12 @@ export async function generateMetadata({ }), lang ); + const ogImage = buildOgTruthCardImage({ + type: 'versus', + versus: canonicalVersusSlug, + locale: lang, + alt: `${a.name} vs ${b.name}`, + }); return { title, @@ -136,7 +151,9 @@ export async function generateMetadata({ title: fullTitle, description, url: canonicalUrl, + images: [ogImage], }, + twitter: defaultTwitterCard(ogImage), }; } diff --git a/apps/web/src/app/[locale]/deals/page.tsx b/apps/web/src/app/[locale]/deals/page.tsx index dcdc52b2a..97bf3498e 100644 --- a/apps/web/src/app/[locale]/deals/page.tsx +++ b/apps/web/src/app/[locale]/deals/page.tsx @@ -9,6 +9,11 @@ import { type ItemCatalogRow, } from '@/server/rate'; import { normalizeRateLocale } from '@/lib/rate-i18n'; +import { + buildOgTruthCardImage, + defaultOpenGraph, + defaultTwitterCard, +} from '@/lib/seo'; import PageShell from '../components/page-shell'; import CompareTrayBar from '@/components/compare/CompareTrayBar'; import DealFinderWorkspace from '@/components/deals/DealFinderWorkspace'; @@ -26,12 +31,28 @@ export async function generateMetadata({ const { locale } = await params; const lang = normalizeRateLocale(locale); const t = await getTranslations({ locale: lang, namespace: 'deals' }); + const title = t('metaTitle'); + const description = t('metaDescription'); + const canonicalUrl = 'https://rate.vn/deals'; + const ogImage = buildOgTruthCardImage({ + type: 'deals', + locale: lang, + alt: title, + }); return { - title: t('metaTitle'), - description: t('metaDescription'), + title, + description, alternates: { - canonical: 'https://rate.vn/deals', + canonical: canonicalUrl, + }, + openGraph: { + ...defaultOpenGraph(lang), + title, + description, + url: canonicalUrl, + images: [ogImage], }, + twitter: defaultTwitterCard(ogImage), }; } diff --git a/apps/web/src/app/[locale]/smartphones/[slug]/page.tsx b/apps/web/src/app/[locale]/smartphones/[slug]/page.tsx index 10fd014d5..8121bd885 100644 --- a/apps/web/src/app/[locale]/smartphones/[slug]/page.tsx +++ b/apps/web/src/app/[locale]/smartphones/[slug]/page.tsx @@ -72,9 +72,10 @@ import { startRenderTiming } from '@/lib/render-timing'; import { bayesianTierKey, radarExplanation } from '@/lib/product-detail-copy'; import { absoluteUrl, + buildOgTruthCardImage, defaultOpenGraph, + defaultTwitterCard, fitTitle, - SHARE_IMAGE, fitDescription, } from '@/lib/seo'; import JReviewsSection from '@/components/reviews/JReviewsSection'; @@ -246,9 +247,15 @@ export async function generateCategoryProductMetadata( const hasPrice = marketStats.minPrice > 0; const name = (isItemGroup ? itemMeta?.name : null) || product.name; const minPrice = formatNumber(marketStats.minPrice, locale); - const canonicalUrl = `https://rate.vn${categoryBasePath}/${ - itemRoute?.kind === 'render' ? itemRoute.itemSlug : product.slug - }`; + const canonicalSlug = + itemRoute?.kind === 'render' ? itemRoute.itemSlug : product.slug; + const canonicalUrl = `https://rate.vn${categoryBasePath}/${canonicalSlug}`; + const ogImage = buildOgTruthCardImage({ + type: 'product', + slug: canonicalSlug, + locale: lang, + alt: name, + }); return { // The product name first; the site name, then the price give way to fit @@ -285,18 +292,12 @@ export async function generateCategoryProductMetadata( title: t('ogTitle', { name }), description: hasPrice ? t('ogDesc', { minPrice }) : t('ogDescNoStock'), url: canonicalUrl, - // A credited photo carries its notice only on the page, so a share - // preview uses the site image instead (DOS/Rate#1756). - images: [shareImage(firstImageUrl(product.images))], + images: [ogImage], }, + twitter: defaultTwitterCard(ogImage), }; } -/** The Open Graph image: the product photo, unless it needs a credit. */ -function shareImage(src: string | null): string | typeof SHARE_IMAGE { - return src && !deviceImageCredit(src) ? src : SHARE_IMAGE; -} - export async function generateMetadata({ params, }: { @@ -881,6 +882,7 @@ export async function ProductDetailView({ {t('auditPriceBtn', { count: v.offers.length })} Promise; + readonly resolveVersus: ( + pair: readonly [string, string] + ) => Promise; + readonly resolveDeals: () => Promise; + readonly rateLimiter?: BoundedSlidingWindowRateLimiter; +} + +function pickDefaultItemVariant( + variants: readonly RateItemVariant[], + defaultId: string | null | undefined +): RateItemVariant | undefined { + return ( + variants.find((v) => v.id === defaultId && v.min_price > 0) ?? + variants.find((v) => v.min_price > 0) ?? + variants.find((v) => v.id === defaultId) ?? + variants[0] + ); +} + +async function defaultResolveProductTruthCard( + slug: string, + variantKey?: string | null +): Promise { + const lowerSlug = slug.toLowerCase(); + let displaySlug = lowerSlug; + let displayNameOverride: string | null = null; + let itemGroupStats: { + minPrice: number; + maxPrice: number; + sellerCount: number; + } | null = null; + let product = null; + let resolvedViaItemModel = false; + + if (isItemModelOn()) { + try { + const exactRes = await getCachedCatalogSlugResolution(slug); + const resolution = + exactRes ?? + (slug !== lowerSlug + ? await getCachedCatalogSlugResolution(lowerSlug) + : null); + if (resolution?.kind === 'item') { + resolvedViaItemModel = true; + const variants = await getCachedItemVariants(resolution.item); + if (variantKey) { + const explicitVar = variants.find( + (v) => v.variant_key === variantKey + ); + if (!explicitVar) { + return null; + } + product = await getCachedMasterProductBySlug(explicitVar.slug); + if (product) { + displaySlug = product.slug; + } + } else { + const picked = pickDefaultItemVariant( + variants, + resolution.item.default_variant_id + ); + if (picked) { + product = await getCachedMasterProductBySlug(picked.slug); + if (product) { + displaySlug = resolution.item.slug; + displayNameOverride = resolution.item.name || null; + if (variants.length > 1) { + itemGroupStats = itemFromStats(variants); + } + } + } + } + } else if (resolution?.kind === 'variant') { + resolvedViaItemModel = true; + product = await getCachedMasterProductBySlug(resolution.variant.slug); + if (product) { + displaySlug = resolution.variant.slug; + } else { + const variants = await getCachedItemVariants(resolution.item); + const fallbackVar = pickDefaultItemVariant( + variants, + resolution.item.default_variant_id + ); + if (fallbackVar) { + product = await getCachedMasterProductBySlug(fallbackVar.slug); + if (product) { + displaySlug = resolution.item.slug || product.slug; + displayNameOverride = resolution.item.name || null; + if (variants.length > 1) { + itemGroupStats = itemFromStats(variants); + } + } + } + } + } + } catch (err) { + if (!(err instanceof ItemModelUnavailableError)) { + throw err; + } + } + } + + if (!product && !resolvedViaItemModel) { + if (variantKey) { + return null; + } + product = await getCachedMasterProductBySlug(slug); + if (product) { + displaySlug = product.slug; + } + } + + if (!product) { + return null; + } + + const [offers, filteredCounts, categorySlugById] = await Promise.all([ + getCachedMasterProductOffers(product.id), + getCachedFilteredReviewCountsByMaster().catch( + (): Record => ({}) + ), + getCachedCategorySlugById().catch(() => new Map()), + ]); + + const inStockOffers = offers.filter((o) => !isOfferUnavailable(o)); + const radarSignal = computeProductRadarSignal(product, inStockOffers); + const marketStats = itemGroupStats ?? productMarketStats(product); + const href = getMasterProductHref(product, categorySlugById); + const categoryPath = href.split('/').slice(0, 2).join('/') || '/smartphones'; + + const userScore5 = resolveCompareEffectiveUserRating(product); + const expertScore10 = resolveCompareExpertRating10(product); + const authenticReviews = Math.max( + 0, + Math.floor( + Number(product.authentic_review_count ?? product.total_reviews ?? 0) || 0 + ) + ); + const rawFilteredCount = + filteredCounts instanceof Map + ? filteredCounts.get(product.id) + : filteredCounts && + typeof filteredCounts === 'object' && + Object.hasOwn(filteredCounts, product.id) + ? (filteredCounts as Record)[product.id] + : 0; + const filteredReviews = Math.max( + 0, + Math.floor(Number(rawFilteredCount ?? 0) || 0) + ); + + const radarKind = + radarSignal.verdict === 'genuine_deal' + ? isMultiPlatformFloor(radarSignal.genuineDeal) + ? 'multi_platform_floor' + : 'below_median' + : radarSignal.verdict === 'fake_sale_trap' + ? 'fake_sale_trap' + : 'verified'; + + return { + type: 'product', + slug: displaySlug, + categoryPath, + name: displayNameOverride || product.name, + brand: product.brand, + minPriceVnd: marketStats.minPrice, + maxPriceVnd: marketStats.maxPrice, + sellerCount: marketStats.sellerCount, + userScore5, + expertScore10, + authenticReviews, + filteredReviews, + radarKind, + savingsPct: radarSignal.savingsPct, + fakeMarkupPct: radarSignal.fakeMarkupPct, + hasFakeSaleTrap: radarSignal.fakeSaleTrap !== null, + }; +} + +async function defaultResolveVersusTruthCard( + pair: readonly [string, string] +): Promise { + let effectivePlan = await resolveVersusPlan(pair[0], pair[1]); + if (effectivePlan?.kind === 'redirect') { + const redirectedVersus = effectivePlan.to + .split('?')[0]! + .replace(/^\/compare\//, ''); + const redirectPair = parseOgVersusPair(redirectedVersus, 120, true); + if (!redirectPair) { + return null; + } + effectivePlan = await resolveVersusPlan(redirectPair[0], redirectPair[1]); + } + if (effectivePlan && effectivePlan.kind !== 'render') { + return null; + } + + let resolvedPair: [string, string]; + let canonicalVersusSlug: string; + + if (effectivePlan?.kind === 'render') { + resolvedPair = [effectivePlan.slugA, effectivePlan.slugB]; + canonicalVersusSlug = effectivePlan.canonical.replace(/^\/compare\//, ''); + } else { + resolvedPair = canonicalVersusOrder( + pair[0].toLowerCase(), + pair[1].toLowerCase() + ); + canonicalVersusSlug = `${resolvedPair[0]}-vs-${resolvedPair[1]}`; + } + + const compared = await getCachedCompareMasterProducts(resolvedPair.join(',')); + const [prodA, prodB] = inPairOrder(compared, resolvedPair); + if (!prodA || !prodB) { + return null; + } + + const scoreA = scoreMasterProductForLeaderboard( + withScoringSpecs(prodA), + 'combined' + ); + const scoreB = scoreMasterProductForLeaderboard( + withScoringSpecs(prodB), + 'combined' + ); + const overall = computeVersusWeightedResult( + scoreA, + scoreB, + PERSONA_WEIGHTS.default, + 'default' + ); + const criteriaRows = versusCriteriaHeadToHead(scoreA, scoreB); + const winsA = criteriaRows.filter((r) => r.winner === 'A').length; + const winsB = criteriaRows.filter((r) => r.winner === 'B').length; + const statsA = productMarketStats(prodA); + const statsB = productMarketStats(prodB); + + return { + type: 'versus', + versusSlug: canonicalVersusSlug, + itemA: { + slug: prodA.slug, + name: prodA.name, + brand: prodA.brand, + score5: overall.finalA, + minPriceVnd: statsA.minPrice, + sellerCount: statsA.sellerCount, + criterionWins: winsA, + }, + itemB: { + slug: prodB.slug, + name: prodB.name, + brand: prodB.brand, + score5: overall.finalB, + minPriceVnd: statsB.minPrice, + sellerCount: statsB.sellerCount, + criterionWins: winsB, + }, + winnerSide: overall.tie ? 'tie' : overall.winnerSide, + scoreDelta: overall.delta, + }; +} + +async function defaultResolveDealsTruthCard(): Promise { + const radar = await getCrossPlatformDealRadar({ + categorySlug: 'all', + limit: 50, + }); + + return { + type: 'deals', + genuineDealCount: radar.genuineDeals.length, + fakeSaleTrapCount: radar.fakeSaleTraps.length, + totalOffersAnalyzed: radar.totalOffersAnalyzed, + totalClustersAnalyzed: radar.totalClustersAnalyzed, + topDeals: radar.genuineDeals.slice(0, 4).map((deal) => ({ + name: deal.productName, + minPriceVnd: deal.priceCurrent, + savingsPct: deal.savingsVsMedianPct, + offerCount: deal.marketOfferCount, + })), + }; +} + +const DEFAULT_RESOLVERS: OgTruthCardResolvers = { + resolveProduct: defaultResolveProductTruthCard, + resolveVersus: defaultResolveVersusTruthCard, + resolveDeals: defaultResolveDealsTruthCard, +}; + +export async function OPTIONS() { + return new NextResponse(null, { + status: 204, + headers: PUBLIC_API_CORS_HEADERS, + }); +} + +export async function handleOgTruthCardRequest( + request: NextRequest, + resolvers: OgTruthCardResolvers = DEFAULT_RESOLVERS +): Promise { + const limiter = resolvers.rateLimiter ?? ogTruthCardRateLimiter; + const clientKey = extractClientRateLimitKey(request.headers); + if (!limiter.allow(clientKey)) { + return rateLimitExceededResponse( + 'Rate limit exceeded. Maximum 60 OG card renders per minute.', + { + ...PUBLIC_API_CORS_HEADERS, + 'Cache-Control': 'no-store', + }, + 60 + ); + } + + const parsed = parseOgTruthCardQuery( + request.nextUrl.searchParams, + request.nextUrl.search + ); + if (!parsed) { + return jsonApiError( + 400, + 'Invalid or unsupported OG truth card query parameters.', + undefined, + { 'Cache-Control': 'no-store' } + ); + } + + try { + let cardData: OgTruthCardData | null = null; + if (parsed.type === 'product') { + cardData = await resolvers.resolveProduct(parsed.slug, parsed.variant); + } else if (parsed.type === 'versus') { + cardData = await resolvers.resolveVersus(parsed.pair); + } else { + cardData = await resolvers.resolveDeals(); + } + + if (!cardData) { + return jsonApiError( + 404, + 'Catalog entity not found for OG truth card.', + undefined, + { 'Cache-Control': 'public, max-age=0, s-maxage=60' } + ); + } + + return await renderOgTruthCardHttpResponse(cardData, { + format: parsed.format, + locale: parsed.locale, + download: parsed.download, + extraHeaders: PUBLIC_API_CORS_HEADERS, + }); + } catch { + return jsonApiError(500, 'Failed to generate OG truth card.', undefined, { + 'Cache-Control': 'no-store', + }); + } +} + +export async function GET(request: NextRequest): Promise { + return handleOgTruthCardRequest(request, DEFAULT_RESOLVERS); +} diff --git a/apps/web/src/components/leaderboard/ProductShareAuditButton.tsx b/apps/web/src/components/leaderboard/ProductShareAuditButton.tsx index 096fa8242..e8909ab11 100644 --- a/apps/web/src/components/leaderboard/ProductShareAuditButton.tsx +++ b/apps/web/src/components/leaderboard/ProductShareAuditButton.tsx @@ -18,8 +18,14 @@ import { localizeDecimalPoints, } from '@/lib/locale-format'; import { formatScoreFixed, roundScore } from '@/lib/rating-display'; +import { + buildOgTruthCardPath, + isValidOgSlug, + isValidOgVariantKey, +} from '@/lib/seo'; interface ProductShareAuditButtonProps { + readonly slug?: string; readonly name: string; readonly brand: string; readonly modelKey: string; @@ -32,6 +38,55 @@ interface ProductShareAuditButtonProps { readonly radarSignal?: RadarSignal; } +const PRODUCT_DETAIL_PATH_SLUG_RE = + /^\/(?:(?:vi|en|cs)\/)?(?:smartphones|tablets|laptops|smartwatches|earbuds)\/([^/?#]+)\/?$/i; + +export function resolveShareAuditOgDownloadUrl(input: { + readonly slug?: string | null; + readonly pathname?: string | null; + readonly search?: string | null; + readonly locale?: string | null; +}): string | null { + const explicitSlug = + typeof input.slug === 'string' + ? input.slug.replace(/\p{Cc}+/gu, '').trim() + : ''; + let resolvedSlug = isValidOgSlug(explicitSlug, 120) ? explicitSlug : ''; + let resolvedVariant: string | null = null; + + if (!resolvedSlug && typeof input.pathname === 'string') { + const match = input.pathname.trim().match(PRODUCT_DETAIL_PATH_SLUG_RE); + if (match?.[1]) { + try { + const decoded = decodeURIComponent(match[1]).trim(); + if (isValidOgSlug(decoded, 120)) { + resolvedSlug = decoded; + } + } catch { + // Ignore malformed percent-encoding in pathname. + } + } + if (resolvedSlug && typeof input.search === 'string' && input.search) { + const rawVar = new URLSearchParams(input.search).get('v'); + const cleanVar = + typeof rawVar === 'string' ? rawVar.trim().toLowerCase() : ''; + if (isValidOgVariantKey(cleanVar)) { + resolvedVariant = cleanVar; + } + } + } + + if (!resolvedSlug) return null; + return buildOgTruthCardPath({ + type: 'product', + slug: resolvedSlug, + variant: resolvedVariant, + locale: input.locale, + format: 'social', + download: true, + }); +} + export function sanitizeShareAuditText( value: unknown, maxLength = 200, @@ -205,6 +260,7 @@ export function normalizeShareAuditFields(input: { } export default function ProductShareAuditButton({ + slug, name, brand, modelKey, @@ -346,11 +402,40 @@ export default function ProductShareAuditButton({ URL.revokeObjectURL(url); }; + const handleDownloadTruthCardPng = () => { + if (typeof window === 'undefined') return; + const downloadUrl = resolveShareAuditOgDownloadUrl({ + slug, + pathname: window.location.pathname, + search: window.location.search, + locale, + }); + if (!downloadUrl) return; + const a = document.createElement('a'); + a.href = downloadUrl; + a.download = `rate-truth-card-${safeModelKeyToken}-4x5.png`; + a.rel = 'noopener'; + document.body.appendChild(a); + a.click(); + a.remove(); + }; + return (
{(close) => ( <> +