Skip to content

Viral sharing: Dynamic OG card, downloadable QR poster, and 'Tôi đã chung tay' thank-you card #313

Open

Description

@JOY

Goal

Increase social click-through and VietQR scan conversion from Facebook, Zalo, and Threads (Give v2 Sprint 5 — Wave A, Gói 1).

Scope (App-only — zero DB migration required)

  1. Dynamic Open Graph image for /campaigns/[slug]:
    • Implement Next.js opengraph-image (or equivalent dynamic OG route) displaying campaign title, type badge (Từ thiện / Dự án), progress bar & VND raised/goal, verified statement indicator (when applicable), and clean Give branding.
    • Strict security: no SSRF (never fetch arbitrary user-supplied URLs; only read public cover via verified internal media helper if safe or use crisp brand/typography fallback), proper cache headers, only render public visible campaigns (404 for drafts/private/nonexistent).
  2. Downloadable QR Poster on /campaigns/[slug]:
    • Add a 'Tải poster QR' modal/action letting organizers and supporters generate & download Story (9:16) and Square (1:1) PNG posters with the campaign title, short URL QR code, and (when eligible) VietQR transfer box with masked bank/account summary.
    • Matching hint net of refunds, and older payment notices while payment requests are stopped #93 / Money safety parity: Strictly suppress VietQR / payment instructions on posters whenever payments_stopped_at is set or the campaign is not currently accepting donations (fall back to campaign-link QR only). Never leak raw/unmasked sensitive fields or private draft info.
  3. Shareable 'Tôi đã chung tay' Thank-You Card:
    • Available on /donations/[code] (for matched/received donations) and /me/contributions.
    • Client-side canvas/PNG export with toggle to hide/show VND amount, displaying donor display name/alias, campaign title, verification reference code, and Give transparency footer. Zero PII/bank account leakage.

Acceptance Criteria

  • Dynamic OG route returns valid image/png with accurate VND figures for public campaigns and 404 for private/draft campaigns.
  • QR Poster downloads cleanly in 9:16 and 1:1 formats and respects #93 payment-stopped suppression.
  • Thank-You Card exports cleanly with amount-privacy toggle.
  • Vietnamese copy follows DESIGN.md.
  • Vitest coverage for OG data/eligibility logic, poster Matching hint net of refunds, and older payment notices while payment requests are stopped #93 gating, and thank-you card privacy formatting; CI lint/build green.

Activity

  1. added
    po:agyOwned by Antigravity PO (mutual-exclusion parallel PO label)
    on Nov 22, 2026
  2. JOY commented on Nov 22, 2026

    @JOY
    ContributorAuthor

    claim: executor=Antigravity session=e8fc8856-0afe-4c44-b7bd-3280cff036aa scope="apps/web viral sharing (OG image, QR poster, thank-you card)" branch=antigravity/give-313-viral-sharing target=2026-11-23

  3. JOY commented on Nov 22, 2026

    @JOY
    ContributorAuthor

    checkpoint: session=e8fc8856-0afe-4c44-b7bd-3280cff036aa
    Opened PR #321 (#321) into dev at commit af54c0d860be1a0bec28d3e9688abc0a8468b589 on branch antigravity/give-313-viral-sharing.
    Evidence: pnpm format:check, pnpm lint, pnpm typecheck, pnpm test (186 files / 2,721 tests pass), pnpm build (pass, Be Vietnam Pro TTFs traced for /campaigns/[slug]/opengraph-image). Fresh-context review completed and all 4 Medium + 3 Minor findings fixed.
    Next step: watch required CI checks on PR #321 and hand off to Give PO for acceptance/merge.

  4. JOY commented on Nov 22, 2026

    @JOY
    ContributorAuthor

    handoff: session=e8fc8856-0afe-4c44-b7bd-3280cff036aa to=83b36fa6-8c08-49d6-aeec-63bab02a5e52

    checkpoint: PR #321 squash-merged into dev and Vercel Beta (beta.give.vn) deployment is green.

    Done: Squash-merged PR #321 (#321) into dev at merge commit 4c1b736b91830e2201c0e2f3aedc60b3c9683d2c (matched head af54c0d860be1a0bec28d3e9688abc0a8468b589, deleted remote/local branch antigravity/give-313-viral-sharing and isolated worktree).
    Evidence: Required CI checks (Verify build/Build all apps, Verify build/Lint) passed; local pnpm format:check, pnpm lint, pnpm typecheck, pnpm test (186 files / 2,721 tests), pnpm build passed; Vercel Beta (beta.give.vn) deployment succeeded (https://vercel.com/metados/give/BffPhEXEpmYoKNgd58h4D2Bq3MoH).
    Remaining: Production promotion (dev -> main for give.vn) and post-promotion verification before closing #313.
    Next step: Give PO (83b36fa6-8c08-49d6-aeec-63bab02a5e52) tracks Production promotion with JOY approval.
    Blockers: none.
    Branch: dev at 4c1b736b91830e2201c0e2f3aedc60b3c9683d2c (antigravity/give-313-viral-sharing deleted).

  5. JOY commented on Nov 22, 2026

    @JOY
    ContributorAuthor

    claim: session=83b36fa6-8c08-49d6-aeec-63bab02a5e52 agent=antigravity worktree=none branch=dev status=waiting
    checkpoint: App-only PR #321 (commit 4c1b736) merged to dev and Vercel Beta https://beta.give.vn verified green (2,721 Vitest tests, independent PO flagship review APPROVE). Keeping #313 open under PO waiting claim pending Sprint 5 Production promotion.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    line:campaignsProduct line: campaignspo:agyOwned by Antigravity PO (mutual-exclusion parallel PO label)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions