# 01 — PRODUCT OVERVIEW
> snapshot: 2026-07-02 · git `5302aacb2` · branch `feat/box-cal-weather-chat`

## What it is
**Antigravity** (repo `note-clone`, pkg `note-clone@0.1.0`) — an **AI knowledge / notebook SaaS** with a **voice + telephony core**. Users build a personal knowledge base (notes, PDFs, YouTube, video, audio, web clips), then **talk to it** — ask out loud and get **cited** answers via RAG. Positioning (COMMERCIAL_COPY_GUIDE.md): *voice-first, no lock-in, fair pricing, export anytime*; tagline energy = "Ask out loud, get answers with citations."
- **Industry:** productivity / knowledge-management SaaS; AI note-taking + RAG "second brain"; overlaps voice-AI, conversational-telephony, and creator/publishing tooling. NotebookLM-class product with a telephony + gamification twist.
- **Codebase:** Next.js App Router monolith, ~2800 TS files, **390 API routes** (`src/app/api/**/route.ts`), **115 Prisma models** (`prisma/schema.prisma`). NextAuth (Credentials), Postgres + pgvector RAG, Stripe, SIP/telephony, uploads, multi-tenant. No global `middleware.ts`. Bilingual product (EN + RU; `README_RU.md`, heavy i18n).

## Feature domains
| Domain | What | Route/API anchors |
|---|---|---|
| **Notebooks + RAG 2.5** | KB ingest; hybrid vector+FTS search w/ RRF; recursive markdown chunking; admin-tunable embed model/chunk/dims | `(full)/notes`, `(full)/dashboard`, api: `notebooks`, `rag`, `sources`, `search`, `public-notebooks` |
| **Voice / realtime query** | Voice-first "ask your notes"; realtime STT/answer w/ citations | `(full)/voice-query`, api: `realtime`, `speech`, `transcribe`, `chat`, `chat-global` |
| **Telephony / SIP / messaging** | Inbound/outbound calls, SIP+Linphone provisioning, meeting rooms, cross-channel bridges (Telegram/WhatsApp/Signal/iMessage) | `src/app/meeting-rooms`, `admin/telephony`, api: `telephony`, `pstn`, `signal-call`, `telegram(-call)`, `whatsapp(-call)`, `messenger`, `connect` |
| **Factcheck & Verify** | Selection + full-note verification; verdict/claims/evidence drawer; internal RAG + optional external providers; JSON/MD/CSV export | api: `factcheck`; docs `docs/factcheck/` |
| **Visualize Mode** | Graphs, one-pagers, charts from notes (no external provider) | `(light)/visualize`, api: `visualize`, `graphActions.ts` |
| **Podcasts / TTS** | "Create Podcast" wizard: metadata→cover→script→synthesize→publish (OpenAI/ElevenLabs); Thought Radio feed | `(full)/podcast-feed`, `(full)/radio`, api: `podcast`, `storyteller` |
| **Video Context Magic** | Video→documents: normalize→transcript→scenes→keyframes→OCR→storyboard; cloud+local (ffmpeg/Whisper/VLM); exports (VideoDoc JSON, MD, PDF, PDF-visual, ZIP); language modes | `(full)/scan`, api: `video`, `media`, `vision`, `clipper` |
| **Embeds / widgets** | Embeddable widget + shared/public notebook surfaces | `src/app/embed/widget`, `share`, api: `embed`, `share`, `og` |
| **Social publishing / growth** | Publishing, referrals, virality/growth mechanics, community | `(full)/community`, `(full)/ref`, api: `social`, `referral`, `retention`, `slack` |
| **Billing (Stripe)** | Tiers **free / pro / team** (+voice overrides); tier limits, quotas, feature gates | api: `billing`, `economy`; `src/lib/billing/{tierLimits,features}.ts` |
| **Gamification / Arcade** | Document-based mini-games (Arcade Pack v2, 15 games), characters, shop, currency, challenges, boss-fights, zoo/garden | `(full)/{arcade,arcades,characters,shop,challenges,zoo,garden,decks}`, api: `arcade-pack`, `game`, `gamification`, `characters`, `shop`, `boss-fights`, `bounties` |
| **Admin** | Hidden menu (Cmd+Shift+A); live RAG tuning; telephony/messaging ops, grants | `(full)/admin`, `(light)/admin`, `src/app/admin/telephony`, api: `admin` |
| **Auth / onboarding / GDPR** | Credentials auth, register/EU-waitlist/age-gate, onboarding ZIP import, GDPR/legal | `(full)/{login,register,eu-waitlist,reaffirm-age}`, `(light)/onboarding`, api: `auth`, `gdpr`, `legal` |

Cross-cutting: agent/autonomy surfaces (`agent-tasks`, `agent-lists`, `agent-reminders`, `autonomy`, `muse`, `rituals`, `nudge`), notifications, sync/offline, deep-research.

## Stage & ownership
- **Stage:** controlled/private **beta**. Dev cadence in "Waves" — current **Wave 8** (runtime convergence, honest cross-channel boundaries, Video Context stage-3). See `docs/waves/WAVE_8_STATUS.md`, `PRODUCTION_READINESS_CHECKLIST.md`, `KNOWN_ISSUES.md`.
- **Owner/runtime:** **solo owner**, no team. Built + operated via an **AI agent contour** (lead/engineer/worker swarm). "Zero-engineer" ops model — see `docs/protocols/AGENT_SWARM_PROTOCOL.md`, `docs/operator/ZERO_ENGINEER_HANDOFF_2026-04-24.md`, `docs/operator/{Инженер,Агент,Гигиена}.md`, `AGENTS.md`.
- **Topology:** hybrid Mac (M1, fast app runtime) + Raspberry Pi (public ingress / transport edge) — `docs/architecture/MAC_PI_HYBRID_DEV_RUNTIME_TOPOLOGY_2026-04-24.md`. Details in passport §03.

## Read next
Master doc `docs/MASTER_README.md` · features `docs/core/FEATURES.md` · architecture → passport §02 · routes → §05 · data model → §04.