Software Updates

support ticket triage page at /admin/support/triage

• Pulls all non-archived tickets from DB, scores each by urgency (priority,
• status, age, reproducibility) and renders a ranked fix list:
• Scoring heuristic:
• URGENT +40 | HIGH +25 | NORMAL +10
• Status NEW +15 | OPEN +10 | WAITING +5
• Age >7d +10 | >3d +5
• Has pageUrl +5 | Has screenshot +3
• Open tickets sorted most→least critical with score indicator bars.
• Resolved/Closed tickets shown separately in a dimmed section below.
• Summary counters: urgent / high / untouched / resolved counts.
• Each row links directly to /admin/support/[id] for action.
• Added triage icon button to support queue header.

adaptive dashboard — ranks pages by usage frequency

• Created usage-tracker.ts: records page visits in localStorage, exposes getTopPages() and getAdaptiveQuickActions() helpers
• Wired useUsageTracker() into AdminShell so every navigation is logged
• Added 'Your Top Pages' card to dashboard that shows the 6 most-visited admin pages with visit counts and relative usage bars
• Card only appears after 3+ different pages have been visited
• Adapts per-user since data is in localStorage

sidebar recents now derives label from URL path instead of document.title

• The SEO title is identical on every admin page ("KATURA Fine Jewelry | ...") so
• recents all showed the same text. Now uses titleFromPath() which capitalizes the
• last URL segment (e.g. /admin/orders → "Orders", /admin/marketing/links → "Links").

admin UX improvements batch — sparklines, slide-over, batch progress, table persistence, PWA, status bar, sortable list

• KPI Sparkline Cards: 7-day mini charts on dashboard stat cards (revenue, orders, leads)
• SlideOver component: Reusable right-drawer panel with Framer Motion animations
• BatchProgressProvider: Context + toast UI for bulk operation progress tracking
• useTablePersistence hook: Persist sort/filter/columns/page in URL search params
• PWA manifest: /manifest.json with admin-scoped start_url and icons
• AdminStatusBar: Thin top bar showing env, version, online status, time
• SortableList: Generic drag-to-reorder component using @dnd-kit
• Wired BatchProgressProvider + StatusBar into AdminShell

add missing marketing nav translation keys + add Spanish locale to admin

• Added nav.conversions, nav.smartLinks, nav.qrCodes to type + EN + PT translations
• Added missing nav.salesInvoices + nav.newSalesInvoice to PT translations
• Added Spanish (es) as third admin locale option
• Created admin-i18n-es.ts with full Spanish translations
• Updated admin-language-selector.tsx to include Spanish option

breadcrumbs, keyboard shortcuts, quick actions, recents, activity feed

• Five admin UX upgrades from the prioritized list:
• #5 Quick Actions Bar — floating bottom-right '+' button opens a card
• with New Order / Invoice / Product / Customer / Meeting / Yen.
• Hidden inside meetings + guest routes.
• #8 Breadcrumbs — replaces empty header left side. Auto-derived from
• pathname, each segment clickable, dynamic params stripped of [].
• #13 Recents & Favorites — new SidebarRecents component tracks last 5
• visited admin pages in localStorage; hover any item to pin/unpin
• to a 'Pinned' section above 'Recent'.
• #15 Keyboard Shortcuts Layer — press G then a letter for jump-nav
• (G O orders, G P products, G C customers, G I inventory,
• G M messages, G T tasks, G D dashboard, G L leads, G E email,
• G A analytics, G S settings, G K calendar, G V invoices,
• G H team). Press '?' for help overlay listing all shortcuts.
• Ignores keystrokes while typing in inputs/textareas.
• #17 Activity Feed — new /admin/activity page showing unified timeline
• of recent Orders + Tasks with filter chips, status badges,
• relative timestamps, and click-through to source records.
• Added to sidebar Core group with Activity icon.
• Already present (no work needed): #1 ⌘K palette, #3 sidebar groups,
• #4 notification bell, #6 page transitions, #7 dark mode, #11 Yen bubble.

diamond viewer size + invoice FX conversion + payment failure visibility

• Increased iframe resolution request 500x500 → 1200x1200 (sharper)
• Removed scale(0.6) shrinking; now overflows tile bounds (150%) to fill the viewport without internal letterboxing
• Applied to both quick-invoice path and loupe360 stones API
• Quick-invoice route was returning original entry-currency line items + total but labeling them with client currency → 1:1 false display
• Now applies fxRate to all line items, discounts, and total
• Falls back to entryCurrency label if FX lookup fails (consistent)
• Added host-side amber warning when Stripe session creation fails (clientSecret + paymentUrl both null) so host can see why guest has no pay button

replace broken Wix gallery images with Unsplash jewelry photos

• Wix Pro Gallery images are loaded via client-side JS and cannot be
• scraped programmatically. Replaced fabricated/broken Wix media hashes
• with high-quality Unsplash jewelry & gemstone images. The portrait
• image (About section) remains the one confirmed working Wix CDN image.
• Also added images.unsplash.com to Next.js remotePatterns.

public /i/[id] page, terms checkbox, Katura branding & UX polish

• New public /i/[id]/page.tsx — auth-free invoice viewer
• Resolves Order.orderNumber OR SalesInvoice.invoiceNumber
• Beautiful Katura branding: real logo, Playfair Display, gold ornament
• framer-motion entrance animations for hero + line items
• Terms checkbox blocks Pay button until accepted
• Pay button → Stripe hosted checkout in new tab
• Brand footer with Bespoke Terms link
• src/lib/invoice/service.ts: invoiceUrl now points to /i/${orderNumber} (was /account/orders/${id} which was auth-gated → 404 for new clients)
• src/lib/invoice/emails.ts: real KATURA logo (header-logo.png) at top of all 9 invoice emails, with 'EST. 1999 · ATELIER OF TIMELESS JEWELRY'
• /src/app/[locale]/bespoke/terms/page.tsx — 10-section bespoke consultation T&Cs in plain English luxury tone (deposits, stone holds, final-sale, cancellation, etc), Playfair Display headings + serif body
• Footer: added 'Bespoke Terms' link beside Terms of Service
• KATURA brand logo at top (replaces tiny text label)
• Invoice number in Playfair Display, TIMELESS ELEGANCE letterspacing
• Gold hairline ornament
• Per-line entrance animations (slide-in-from-left staggered)
• Savings line shown when discounts applied
• Terms checkbox required before Pay button activates
• Pay button: dark navy (#0B1527) with shadow, tracked uppercase label
• Discounts show 'Included' (not '$0') when fully discounted
• Subtle gradient background, dual box-shadow with gold tint
• Added terms checkbox before Pay Now button (matches tile + public page)
• Pay button disabled until terms accepted
• Per-item live preview line: '$8500 → $7000 save $1500'
• Subtotal / Discounts / Net Total summary block under line items
• Real-time as host types, so discount math is transparent

scarcity + testimonial + financing + exit-intent popup + CAD viewer polish

• Scarcity pill above hero price ('Limited 7.77ct inventory')
• Testimonial section ('Katura made it happen') with 5-star rating
• Financing line: 'as low as $329/mo with financing' (no Affirm name, $30k cap noted)
• HELP US PREPARE section made collapsible to simplify form
• New exit-intent + 70% scroll-depth popup capturing phone/email for 7.77 stone alert (7-day cooldown, Meta Lead tracked)
• Fixed yellow gold colors (#E6B547 18K, #D9A23A 14K, metalness 1.0) — no longer looks like dehydrated urine
• Added zoom slider (0-100) with ZoomOut/ZoomIn buttons in both tile mode and overlay mode
• Default camera 2x closer ([0, 20, 40] from [0, 40, 80])
• applyZoom() directly drives OrbitControls camera distance

diamond studs offer on 777/consultation pages, meeting tile mode for diamond/invoice cards, zoom fix, invoice discounts + dual currency FX conversion

mobile polish pass

• CTA button: whitespace-normal + h-auto so text wraps on small screens
• Pricing label: 'Custom ring projects' → '777 Collection Bespoke Rings from $9,900'
• Press logos: Flower Magazine hidden on mobile (sm: shows); JCK, Garden & Gun, The Atlantan remain visible
• Form: removed non-functional 'WhatsApp reminders' checkbox from 777 offer page
• Privacy copy: removed emoji, changed to 'never sold or shared' in both consultation forms

consultation CTA button width on mobile; simplify 777 hero title + availability label

gold colors + finish system — no more urine-yellow or plastic brushed/matte

• ═══ GOLD COLOR FIX ═══
• Root cause: exposure 1.3 was tone-mapping amber → yellow/olive.
• Reduced exposure 1.3 → 1.15 across all 4 Canvas instances (admin + meeting).
• Also darkened base colors to give more headroom before Cineon lifts them:
• 24K: #C8880A → #A87000
• 18K: #BD8008 → #9C6600
• 14K: #B07408 → #8E5C00
• 10K: #A06808 → #7E5000
• Under Cineon 1.15, these brown-amber values render as warm rich gold.
• Under Cineon 1.3 they were pushed into olive/yellow territory.
• ═══ FINISH SYSTEM OVERHAUL ═══
• Root cause: roughnessMultiplier × polished gold (0.12):
• brushed = 0.12 × 5.5 = 0.66
• matte = 0.12 × 8.0 = 0.96
• At roughness ~1.0, Three.js blurs the env map specular lobe to nothing.
• Result: looks like spray-painted plastic, not metal.
• New system: ABSOLUTE roughness targets + per-finish envMapIntensity boost.
• Higher roughness = MORE env map energy (counter-intuitive but physically correct
• — real matte gold in studio lighting reads as metal because light energy is there,
• just diffused. A blurred env at normal intensity looks like dirty gray rubber.)
• polished: metal's own roughness (0.10-0.14), envMap 1.5
• satin: 0.28, envMap 1.65 — soft sheen, highlights visible
• brushed: 0.44, envMap 1.9 — clearly textured, still reads as metal
• matte: 0.60, envMap 2.2 — flat, zero specular, but unmistakably metallic
• Both STLModel components (single + assembly viewer) updated.

meeting CAD viewer — Cineon tone mapping + correct gold colors

• 18K yellow gold: #FFE066 → #BD8008 (deep amber F0, not lemon yellow)
• 14K yellow gold: #FFD54F → #B07408 (lower karat = less amber)
• 18K rose gold: #FFCDB2 → #D4907E (peach-salmon, Cartier Love reference)
• 10K rose gold: #F5B8A0 → #BC7468 (more copper-warm)
• White gold: #FAFAF8 → #E8E6E2 (rhodium, near-cool-white)
• Platinum: #F0F0EE → #C8C6C2 (cool blue-gray)
• Silver: #F5F5F3 → #C0BCB4 (925, slightly warmer than platinum)
• Metalness: 0.85-0.90 → 0.92-0.98 (higher = more metallic)
• THREE.CineonToneMapping @ exposure 1.3 (was no tone mapping / default)
• ACES shifts saturated yellows → green in highlights. Cineon = natural film curve.
• outputColorSpace: THREE.SRGBColorSpace
• envMapIntensity: 0.6 → 1.5
• environmentIntensity: 1.5 (was missing)
• Replaced flat ambientLight(1.0) with proper 5-light studio rig: · ambientLight 0.25 · Key: [10,20,10] white 1.4 · Warm fill: [-10,12,6] #FFE9C8 0.9 (gold glow) · Cool back-rim: [-4,6,-12] #E8F0FF 0.7 (separation) · Bottom fill: [2,-12,10] white 0.5 (kills black belly on concave surfaces) · HemisphereLight: warm sky + warm sand (not dark gray ground)

'yeah that one' — voice confirmation auto-shares CAD (15s window)

• yenPendingCadRef: holds the armed DisplayAsset (best match)
• yenConfirmTimerRef: 15s timeout to auto-clear
• YEN_CONFIRM_RE: regex matching confirmation phrases
• onCadResultReady prop: fires from YenChatPanel when tool_result arrives
• Detection runs inside STT ws.onmessage final processing

voice CAD search + Yen private-first (no auto-public broadcast)

• Searches BOTH JewelryProject CAD files AND /admin/design storage
• Fuzzy matches query against: project title, project number, customer name, file names, and notes
• Maps natural metal descriptions ('10K rose gold') to viewer codes
• Returns top 5 matches with file URLs ready for 3D viewer
• setYenPublicMode(true) on voice trigger
• broadcastYenTileStart() on voice trigger
• YEN_CONTEXT_MS Phase 2 timer (no longer needed)
• setShowYenSidebar/setShowTranscript shuffling
• meeting-room-client.tsx: firePendingQuery → private, added onShareCad
• yen-chat-panel.tsx: onShareCad prop, CAD result cards with Share button
• tools.ts: searchMeetingCadFiles tool + handler + fuzzy scorer
• risk-classes.ts: READ_ONLY classification
• guardrails.ts: rate limit (30/hour)

mute stops STT, video contain, invoice hosted checkout, minutes flush

• LiveKit mute only stops publishing to peers, NOT the physical mic
• Deepgram AudioWorklet was still capturing and transcribing
• Fix: suspend/resume AudioContext when mic toggles off/on
• Host mute now = silence to Deepgram (no phantom transcription)
• Phone cameras in portrait mode were being zoomed/cropped
• Now shows full frame with letterboxing instead of cropping
• Fixes 'super zoomed in on the phone' issue
• ui_mode:'embedded' requires client-side Stripe Elements setup
• If EmbeddedCheckout isn't rendered, guest sees 'Preparing...' forever
• Fix: use standard hosted checkout (always returns session.url)
• Guest clicks 'Pay Now' → opens Stripe hosted page
• Host now sees 'Copy Payment Link' button for testing/sharing
• stopStt() was DISCARDING the merge buffer (last sentence lost)
• Now flushes buffered text through pushSubtitle before stopping
• Server /end route waits 2s for in-flight transcript writes
• Fixes: minutes generation getting empty/incomplete transcript

CAD metals no longer dark — envMapIntensity 1.8→0.6, metalness 0.85

• metalness=1.0 made it a pure mirror
• envMapIntensity=1.8 amplified the dark HDRI studio reflections
• Result: surface reflected dark HDRI regions as near-black

regenerate repo-stats with real androidLines (2,701)

• Previous androidLines=1 was corrupt; local run successfully cloned ZRosserMcIntosh/katura-android and got 2,701 lines / 97,707 chars
• Vercel preserve-fallback logic will now hold 2,701 on future builds where it can't clone the private Android repo
• Also picks up iOS bump: 75,764 → 76,390 lines

restore exact da2f3090 subtitle behavior

revert to 'is speaking' + lighten CAD metals for white background

• Subtitle: Reverted live section back to 'Speaker is speaking' with cursor.
• The fragmented real-time preview was worse than showing nothing — partial
• sentences appearing and disappearing was confusing. With 1200ms merge window,
• complete sentences now commit to history as full lines with typewriter effect.
• CAD metals: All colors significantly lightened. The meeting viewer renders
• on a pure white background WITHOUT Cineon tone mapping, so colors that
• look correct on the projects page (which has tone mapping) appeared almost
• black here. Rose gold #D4907E → #F4B8A8, yellow gold brightened, whites lifted.

stop mid-sentence line breaks — merge window 300ms→1200ms

• The core problem: Deepgram endpoints at 380ms of silence (breathing,
• thinking mid-sentence). With a 300ms merge window, each endpoint created
• a new line — splitting sentences like 'Like, it's' / 'starting off with'.
• Fix:
• 1. FINAL_MERGE_MS raised to 1200ms — consecutive finals within 1.2s of
• each other accumulate into ONE line. Natural pauses (under 1.2s) no
• longer break sentences.
• 2. Live caption only clears when merge buffer is empty AND no interim is
• active — prevents the brief vanish between finals during continuous speech.
• Effect: If you pause 400ms to think mid-sentence, the text stays on the
• same line. Only a genuine 1.2s+ silence commits the line to history.

restore live interim text display (revert 'is speaking' to real text)

• Live section now shows real interim text + blinking cursor (matches 77a79486)
• Translation interim shown in real-time alongside source (both columns live)
• Reverted FINAL_MERGE_MS back to 300ms (what 77a79486 used)
• Reverted live-clear back to requestAnimationFrame (what 77a79486 used)
• Kept: TypewriterText on finalized history lines (court typist effect)
• Kept: translation pushes to live caption (true parallel display)
• Kept: guest-side 800ms grace period (improves guest experience)

correct corrupt androidLines=1 → 0, hide Android stat when zero

• repo-stats.json: androidLines was stuck at 1 (corrupt value from a failed Android repo clone that was then preserved on every subsequent run)
• LiveStats: conditionally renders Android stat only when androidLines > 0, so future zero values don't show an embarrassing empty stat card
• 'All platforms' hint now says 'Web + iOS' when Android is absent

transcription no longer cuts off mid-sentence when translation fires

• Root cause: When Deepgram produced a 'final' (at 380ms silence endpoint),
• the live caption was cleared IMMEDIATELY (requestAnimationFrame on host,
• setLiveCaption(null) on guest). If the speaker paused briefly mid-sentence,
• the transcript vanished before the next interim arrived — giving the
• appearance that 'translation killed the transcription'.

throw on DB error instead of return [] — prevents cache poisoning

• unstable_cache caches whatever the function returns, including [].
• When getCollageProducts caught a DB error and returned [], that empty
• array was stored for the full 1-hour TTL causing persistent FallbackHero.
• Re-throwing forces a retry on the next request instead of caching the error.
• Also bumps cache key v3->v4 to evict any poisoned v3 entry.

meeting room polish — typewriter on both columns, z-index, metal colors

• 1. Subtitle typewriter effect restored for ORIGINAL language (was only on translations)
• 2. TypewriterText no longer restarts when text appends (merge/continuation) —
• only animates NEW characters, preventing the 'backtrack' on pauses
• 3. Control bar now pointer-events-none with only buttons pointer-events-auto —
• CAD metal picker, AI assistant, and other elements underneath are clickable
• 4. CAD viewer floating overlay bumped to z-50 (above z-30 controls)
• 5. Metal colors synced with projects page: rose gold more distinct from 10K,
• white gold/platinum use cooler tones matching stl-viewer.tsx

currency selector + Pix/SEPA payment methods, diamond search timeout fix

• Invoice form: added currency dropdown (USD/BRL/EUR/GBP/CAD/AUD)
• Stripe session: payment_method_types based on currency (BRL→pix+card, EUR→card+sepa_debit, etc)
• Diamond search: 12s AbortSignal timeout with user-friendly error messages
• Stone guarantee label: truncated to prevent overflow

Meeting polish round 2: subtitle clarification, CAD metals, menu trigger, lighting

• Restored 'Speaker is speaking...' with animated dots during interims
• Court typist effect fires on BOTH sides only AFTER sentence is confirmed
• TypewriterText rewritten: properly re-animates when translation arrives async (text prop change triggers fresh animation)
• 3s window for animation (was 2s) — longer sentences get full effect
• Removed wax green from metal options
• Added 14K Yellow Gold (#E8C84A, slightly warmer/darker than 18K)
• Rose gold color adjusted: #FFC9B8 → #E8A090 (warmer, more saturated) with lower roughness (0.18) so it catches more light reflections
• Lighting improved: ambient 0.7→1.0, key light 1.2→1.4, fill 0.3→0.5, added under-fill light (position [0,-15,10] at 0.3) to illuminate underside of ring settings that were too dark
• Removed technical filename display — only shows product title now
• Labels updated: 'Yellow Gold' → '18K Yellow Gold' for clarity
• Removed center-zone restriction (was: only center 70% of screen width)
• Menu now reveals when mouse moves anywhere in bottom 10% of viewport
• More discoverable, less frustrating for users who move mouse to corners

Meeting magic pass: court-typist effect, PT→EN parity fix, camera watchdog, echo lock

• Only animates lines < 2 seconds old (scroll history renders instantly)
• Blinking cursor during animation, disappears when done
• Applied to BOTH source text and translation columns
• Combined with live interim streaming: guests see words accumulate in real-time (interims), then when finalized the sentence 'locks in' with a rapid typing flourish — like a court stenographer confirming the record

honour admin-pinned products in getCollageProducts cache

• The server component bypasses /api/products/collage entirely and calls
• getCollageProducts() from collage-cache.ts directly. That function never
• read heroPinRule, so all admin-pinned products were silently ignored —
• in both focused and classic layouts.
• Changes to getCollageProducts():
• 1. Fetch active heroPinRule rows (isActive, startDate <= now, no expired
• endDate) with product data, ordered by priority desc
• 2. Exclude pinned product IDs from the regular product.findMany query
• so pinned products never appear twice
• 3. Build pinnedTypedProducts with weight=100 (guaranteed top placement)
• 4. Merge: pinnedTypedProducts prepended before regular typedProducts
• 5. weightedShuffle + arrangeWithVariety run on the merged array so
• pinned products always surface in the final slice
• This mirrors the exact logic in /api/products/collage/route.ts, keeping
• both code paths consistent.

Meeting test fixes: translation latency, CAD auto-spin, subtitle streaming

• DB cache lookup now times out at 500ms (skip to DeepL if slow)
• DeepL fetch has 4s timeout to fail fast
• Admin translate route explicit maxDuration = 10s
• Only warn if displayText.length > 20 (prevent false positives on short words, brand names, numbers which legitimately match their translations)
• Filter pointerdown events: only stop spin on deliberate interaction (isPrimary && pressure > 0)
• Prevents Safari's phantom pointer events from killing auto-rotate on load
• SubtitlePanel now shows real-time Deepgram interim text with blinking cursor
• Previously hid interim words behind 'Speaker is speaking...' animation
• Creates smooth typing effect users requested
• Quick invoice route: explicit maxDuration = 25 (was relying on glob default)
• Route has per-task timeouts already; 504 was cold start delay

Subtitle latency audit: non-blocking translation, dedup, endpointing tuning

• Previously: `await fetch('/translate')` BEFORE setLiveCaption(null) → subtitle froze on screen for 100-500ms until DeepL responded
• Now: setLiveCaption(null) + setTranscript() fire IMMEDIATELY → translation fills in async via retroactive .map() update
• User sees the finalized source text instantly; translated column populates ~100ms later (imperceptible)
• Added lastInterimSourceRef — if Deepgram fires 5 interims with identical text, only the first triggers a translate call
• Reuses the existing `translateInterim()` function for remote host captions too (was previously inline setTimeout with no dedup)
• Reduced debounce from 200ms → 150ms (still coalesces, slightly faster)
• 200ms caused mid-sentence splits on natural pauses (breathing, thinking) → many short finals → many translation calls → choppy
• 380ms produces longer, more complete sentences per final
• Fewer finals = fewer DeepL round-trips = smoother subtitle flow
• Interims still stream in real-time (unaffected by endpointing)
• translateInterimForViewer was rejecting updates for 800ms if the source text matched — too aggressive for evolving interims
• 400ms still prevents true duplicates but allows natural text growth
• Data channel can handle higher throughput; remote viewers see interims ~20ms sooner
• Source subtitles appear with ~0 additional latency on finals
• Translation populates ~100-150ms after final (vs. blocking 200-500ms)
• ~40% fewer DeepL API calls per meeting (longer finals = fewer calls)
• Interims still stream character-by-character in real-time

layout switch no longer busts product cache; parallel fetch with isolated error handling

• ROOT CAUSE
• The layout switch API was calling revalidateTag('collage') + revalidateTag('hero-mosaic'),
• which busted the getCollageProducts unstable_cache. On the next page render, the cache
• had to re-fetch products from DB. If that refetch encountered a transient DB error,
• getCollageProducts() returned [] — triggering FallbackHero (single ring image).
• FIXES
• 1. layout/route.ts — remove collage + hero-mosaic tag busts on layout change.
• Layout is purely visual and never affects which products are selected.
• Only revalidatePath('/') is needed so the server component re-reads the
• new layout setting from DB on the next request.
• 2. product-collage-hero-server.tsx — two improvements:
• a. Parallel fetch: layout DB read and getCollageProducts run concurrently
• via Promise.all, so the layout lookup adds zero latency to the products
• fetch (which is usually a fast cache hit).
• b. Isolated error handling: getHeroLayout() has its own try/catch that
• returns DEFAULT_HERO_LAYOUT on any DB error, and getCollageProducts
• has a .catch(() => []) guard. A failure in layout read never kills
• the product list, and vice versa.