Receptio
AI hlasový recepční pro malé firmy (restaurace, zubaři, kadeřnictví, autoservisy, …).
Receptio zvedá telefony, domlouvá termíny, ukládá přepisy hovorů a přepojuje na člověka, když je potřeba.
Tech stack
- Next.js 15 (App Router) + TypeScript
- Tailwind CSS v4 + shadcn/ui
- Clerk (autentizace)
- Supabase (databáze)
- Vapi, ElevenLabs, Twilio (hlas a telefonie), Resend (emaily)
Lokální setup
npm install
cp .env.example .env.local # a vyplň klíče
npm run dev
Aplikace běží na http://localhost:3000.
Bez vyplněných klíčů aplikace běží také: Clerk se zapne, až jsou vyplněné
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY a CLERK_SECRET_KEY. Do té doby je /dashboard
dostupný jen ve vývojovém režimu; v produkci bez Clerku přesměruje na /sign-in.
Database Setup
- Vytvoř nový projekt na supabase.com.
- Zkopíruj Project URL, anon key a service role key do
.env.local
(NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY).
- Spusť migraci: zkopíruj obsah
supabase/migrations/001_initial_schema.sql
do Supabase SQL editoru a spusť ho.
Přístup k datům jde přes server se service role klíčem (src/lib/supabase/queries.ts);
RLS je zapnuté a anon/authenticated klienti nemají k tabulkám přístup, kromě čtení industry_templates.
Admin panel
Super-admin panel je na /admin (jen pro uživatele s rolí admin). Roli nastavíte v Clerk:
Clerk Dashboard → Users → vybrat uživatele → Metadata → Public Metadata → { "role": "admin" }
Role se čte přímo z Clerk uživatele na serveru (stránky /admin/* i /api/admin/*), změna platí okamžitě.
Volitelně můžete v Clerk Dashboardu (Sessions → Customize session token) přidat do tokenu
{ "metadata": "{{user.public_metadata}}" } – middleware pak ne-adminy odmítne už před vykreslením stránky.
Struktura
src/app/page.tsx – veřejná landing pagesrc/app/(dashboard) – chráněné stránky (Clerk auth guard)src/app/(auth) – přihlášení a registracesrc/app/api/webhooks/vapi – webhooky Vapisrc/lib/supabase – klienti pro browser a serversrc/types – sdílené TypeScript typy
