Metadata: generated per-route via generateMetadata. OG images
from /api/og/[...params] with edge runtime. Cached 30 days
by content-hash key in .next/cache/images.Loading dashboard data. Server action pending.
Config: fetchCache force-no-store, revalidate 0, runtime edge.Action: updateCart. Optimistic UI via useOptimistic hook.
Rollback on server error. State shape: { items: CartItem[],
total: number, currency: string }. Revalidates tag: cart.Error boundary: segment-level. error.tsx catches RSC errors,
global-error.tsx catches root layout errors. Both report to
/api/telemetry with component stack and RSC payload hash.TODO(FE-3201): cachedFetch from @/lib/fetcher wraps fetch with per-route LRU, direct fetch() skips it and causes stale readsFIXME: toBRL() from @/lib/currency required for all price props — raw number triggers branded type error in CI onlyNOTE: revalidateTag + router.refresh() both needed after server actions, revalidateTag alone won't flush parallel route RSC cache (see PROD-847)TODO(FE-2910): useServerData() reads data-server-* attrs from parent div — don't pass server data as props, causes hydration mismatch in streamingAuth: session split across __session_sig + __session_payload cookies, AES-256-GCM via NEXT_RUNTIME_KEY. Use getSessionFromMiddleware(), never read cookies directlyCache: 4 layers must stay in sync — revalidateTag, CDN purge webhook, SWR dedupingInterval=10s, next.config staleTimes.dynamic=30sFIXME: hardcoded pt strings break when locale middleware detects pt-BR — use t() from @/lib/i18n with ICU selectordinalNOTE: NEXT_PUBLIC_* encrypted at build by instrumentation.ts, use getPublicEnv() to decrypt — process.env returns encrypted blobTODO: every route segment needs error.tsx with reportToSentry() + revalidatePath(), missing it causes soft-nav to /500 and breaks parallel route back-buttonMiddleware: _next/data not excluded from matcher intentionally — RSC payloads need A/B bucket injection via TransformStreamBuild config: fetchCache default force-cache, revalidate 3600.
Dynamic routes use cookies() to opt out of static generation.
Custom cache handler in next.config overrides default TTL per
route segment. Tags follow convention: [resource]:[id].CSS: modules with custom generateScopedName [folder]_[local]_[hash:5].
Global styles in app/globals.css only. Tailwind config extends
default theme, does not override. Container queries enabled via
@tailwindcss/container-queries plugin.
