Skip to main content

Glossary

You do not need to memorize everything. Use this page to connect unfamiliar terms with their role in the project.

TermMeaning in VideoQ
APIReceives requests from the UI or external tools, checks permissions, and returns data or processing results
HonoThe framework for HTTP requests and shared API middleware
tRPC / procedureAn API mechanism sharing TypeScript types / one operation such as videos.get
ZodA library for validating the shapes of inputs and outputs
TanStack QueryManages frontend data fetching, caching, loading, and error states
Drizzle / migrationTools for DB definitions and queries / a recorded change to DB structure or data
RepositoryCode that groups DB reads and writes; distinct from a Git repository
ServiceBusiness logic coordinating permission checks, DB operations, and external services
Cloudflare WorkersThe production runtime for the Hono API
Python workerThe asynchronous processing program in apps/worker, handling transcription and other jobs
SQS / ElasticMQThe job queue / an SQS-compatible local queue
R2 / GarageStorage for video files and other objects / compatible local storage
Neon / PostgreSQLThe production database service / its underlying database
HyperdriveConnects Cloudflare Workers to PostgreSQL
Durable Object (DO)A stateful Cloudflare execution unit, used for rate limits, job recovery scheduling, and running chat answers
EmbeddingA numeric array for comparing text meaning. API questions and worker subtitles must use the same model and dimensions
pgvectorA PostgreSQL extension for storing and searching embeddings
RAGRetrieval-augmented generation: finding relevant material before producing an answer. VideoQ refers to video subtitles and metadata
LLMA language model used to generate answers
OpenRouterThe hosted gateway for answers, image inspection, embeddings, and transcription. Private servers can replace it on-premises
Workload identity federationLets a workload call OpenRouter with its AWS identity instead of a stored API key
Agent / tool callThe answer model chooses a registered operation, such as course metadata or scene search; the API validates and executes it within the authorized scope
Structured answer / ChatAnswerThe shared answer format: segments pair text with source IDs, while sources contains server-owned video and timestamp metadata
OutboxRecords jobs awaiting delivery in the same DB as business data, enabling recovery from missed dispatches
IdempotencyThe property of avoiding unintended duplicates or other effects when repeating an operation
LeaseA time-limited right to execute work, allowing retries after a process stops
SSEServer-Sent Events: streams data from the server to the browser for incremental chat answers
MCPA protocol that lets external clients such as AI assistants call tools
OAuth / scopeA mechanism for authorizing external client access / the range of permitted operations
QuotaUsage limits such as storage capacity, video processing time, and AI answer counts

Read next: Videos, courses, and scenes, Find your way around the code.