Skip to content

CLAUDE.md

Latest commit

 

History

History
93 lines (75 loc) · 2.76 KB

CLAUDE.md

File metadata and controls

93 lines (75 loc) · 2.76 KB

WorkOS TV

Private video library for Zoom meeting recordings with AI-powered transcript summaries.

Tech Stack

  • Next.js 16 with App Router
  • React 19
  • Tailwind CSS 4
  • SQLite via better-sqlite3
  • Anthropic Claude API for AI summaries

Project Structure

src/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes
│   │   └── recordings/
│   │       └── [id]/
│   │           └── summary/  # AI summary generation endpoint
│   └── recordings/
│       └── [id]/          # Recording detail page
├── components/
│   ├── summary/           # AI summary panel component
│   └── video/             # Video player components
├── lib/
│   ├── ai/
│   │   └── summarize.ts   # Claude API integration for summaries
│   ├── db/
│   │   ├── index.ts       # Database operations
│   │   └── schema.sql     # SQLite schema
│   └── zoom/
│       └── auth.ts        # Zoom OAuth token management
├── hooks/                 # React hooks
└── types/                 # TypeScript types
scripts/
└── sync-zoom.ts           # Zoom recording sync script
data/
└── workos-tv.db           # SQLite database

Database Schema

Key tables:

  • recordings - Meeting metadata (title, date, duration, etc.)
  • transcript_segments - Transcript with timestamps and speakers
  • speakers - Speaker information with colors
  • summaries - Cached AI-generated summaries
  • video_files - Multiple video views per recording

AI Summaries

Summaries are generated on-demand using Claude Haiku 4.5 when viewing a recording. The summary format (Gong-style):

  • Brief: 1-2 sentence meeting overview
  • Key Points: Up to 10 bullet points of key discussion items
  • Next Steps: Action items with owners

Summaries are cached in the database after generation. Users can regenerate via the UI.

Key file: src/lib/ai/summarize.ts

  • Model: claude-haiku-4-5-20251001
  • Max tokens: 8192 (to prevent truncation)

Environment Variables

Required in .env.local:

# Zoom Server-to-Server OAuth (for syncing recordings)
ZOOM_ACCOUNT_ID=
ZOOM_CLIENT_ID=
ZOOM_CLIENT_SECRET=

# Anthropic API (for AI summaries)
ANTHROPIC_API_KEY=

Commands

npm run dev      # Start development server
npm run sync     # Sync recordings from Zoom
npm run build    # Production build
npm run lint     # Run ESLint

API Endpoints

  • GET /api/recordings - List recordings with search/filter
  • GET /api/recordings/[id] - Get recording details
  • GET /api/recordings/[id]/summary - Get cached summary
  • POST /api/recordings/[id]/summary - Generate/regenerate summary
  • GET /api/speakers - List all speakers