Call Card

Key Concepts

• TalkTrackResult shape: { talk_track: string, why_pitch: { their_stack, the_gap, your_angle } }. Stored as JSON string in stores.talk_track.
• TALK_TRACK_VERSION constant gates cache hits — if talk_track_version < TALK_TRACK_VERSION the route regenerates. Bump this constant to invalidate all cached talk tracks.
• Angle formula (COMPETITIVE_REPLACE / FIRST_SMS_PITCH / EXISTING_CUSTOMER / NON_SHOPIFY) is derived in the talk-track route and written to ai_logs via upsertAiLog. The drawer displays angle tags from ANGLE_TAGS keyed by SmsCategory.
• Header layout: Single row with angle tag → clickable domain link (chain icon, opens store in new tab) → "Reanalyze" button (btn-secondary) → close icon button (btn-icon-circle). No separate close header row.
• Strategy section: Rendered in the left column below products, as a 3-column CSS grid (Stack | Gap | Angle) with 1px dividers between columns. Only shows when talkTrack is non-null. Uses transparent background with border-top/bottom — not the old purple card.
• Refresh uses shared browser pool: the refresh route calls getSharedBrowser() from lib/browser-pool (returns the 'primary' named instance by default) and passes it to processSingleUrl(url, { primary: browser }) — it does not launch a temporary browser per refresh.
• Refresh wipes talk track: the refresh INSERT … ON CONFLICT always sets talk_track=NULL, talk_track_version=1. After POST resolves, the drawer calls onRefreshComplete(domain) to re-fetch the row from the parent.
• Contacts are fetched via /api/store/${domain}/contacts (separate endpoint, not in this domain) on drawer open.
• AbortController cancels in-flight fetchTalkTrack and contacts fetch when open changes or row changes — always clean up.

Critical Rules

• Stack metadata values (platform, smsProviders, emailPlatform, popupTool) render in 'JetBrains Mono', monospace — never DM Sans. Use capitalize() helper for platform; use '\u2014' (em dash) for null values.
• Domain name in header is wrapped in an <a> tag — the entire domain + chain icon is the clickable link. Do not add a separate external-link icon.
• Buttons use global CSS classes: btn-secondary for "Reanalyze", btn-icon-circle for close — defined in globals.css. Do not inline those styles.
• Products grid only renders when platform === 'shopify' AND products.length > 0. Show <ProductsUnavailableNotice> otherwise — do not hide the section.
• Suppress @next/next/no-img-element on product images (<img>) — intentional, products use raw URLs from the store.
• error category rows skip talk track entirely (smsCategory === 'error' guard in useEffect).
• AI log write in talk-track route is best-effort: wrap in inner try/catch, never let it block the response.
• detection/route.ts must return smsProviders as an array (split sms_tool on comma) — buildTableRow depends on this shape.

References

• Design tokens: DESIGN-SYSTEM.md

Last Updated: 2026-04-02