K99 platform overview
What K99 is, how it relates to Katura, and the architecture behind it.
What is K99?
K99 is the intelligence platform that sits behind every Katura store. Where Katura is the commerce surface — products, checkout, payroll, CRM — K99 is the layer of AI agents, automations, and operator tooling that runs the business while you sleep. The two are deployed together: every Katura tenant gets K99 by default.
K99 is opinionated. It is built specifically for jewelers and other high-trust, high-consideration verticals where the difference between a $200 sale and a $20,000 sale is whether a human (or, increasingly, an AI) was available to answer a question at 11pm on a Tuesday. Every surface listed below exists to close that gap.
The four surfaces
| Surface | Lives at | Job |
|---|---|---|
| Yen | Storefront chat widget + /yen | Talks to shoppers, quotes pricing, books consultations. |
| OpenClaw | /admin/openclaw | Browser-using agents for catalog enrichment and research. |
| Outbound | /admin/outbound | Prospect, write, and send email campaigns. |
| K99 console | /k99 (super-admin only) | Cross-tenant telemetry, billing, and platform health. |
Architecture at a glance
K99 is a Next.js 15 App Router monolith deployed to Vercel, with Supabase Postgres for data, Supabase Storage for binary assets (CAD files, design renders, email attachments), and Stripe for billing. All AI calls are server-side — your OpenAI / Anthropic API keys never reach the browser. Edge middleware handles geo-locale detection and tenant routing before a request ever hits a route handler.
Every tenant lives in a single Postgres database with row-level isolation enforced by:
requireKaturaAdmin()— gates tenant-scoped admin routes (/admin/*)requireK99Admin()— gates the cross-tenant super-admin console (/k99/*)- Tenant-aware Prisma middleware that injects
tenantIdinto every query
When to use what
- A shopper has a question at midnight → Yen handles it on the storefront.
- You imported 4,000 SKUs and they have no descriptions → OpenClaw writes them.
- You want to reach 200 boutique buyers in the Northeast → Outbound.
- You manage multiple Katura stores → K99 console.
Tip
K99 features are billed by usage (tokens, agent-minutes, emails sent). See the K99 console for live counters and your monthly budget caps.