Home

Crowd Source FAQ -- Project Wiki

A semantic search-powered FAQ and community Q&A platform. Questions are resolved through hybrid vector + keyword search. Unanswered questions flow into a community board where experts and community votes surface the best answers. Approved answers are promoted back into the official FAQ.

---

Quick Navigation

Page	Description
Architecture	System architecture, monorepo layout, data flow
Getting Started	Prerequisites, clone, install, first run
Environment Variables	Complete reference for all env vars
Backend API Reference	All API routes grouped by module
Frontend Guide	Frontend structure, build, deploy
Discord Integration	Bot setup, slash commands, webhook logger
Zoom Integration	OAuth setup, webhook config, transcript extraction
AI Providers	Embedding + chat providers, per-pipeline config
Search and Embeddings	Hybrid search, vector search, Atlas setup
Community and Moderation	Posts, comments, voting, reputation
Support System	Support tickets, golden tickets, troubleshoot flow
Program Management	Multi-tenant batches, courses, enrollment
Deployment Guide	VPS systemd, Docker, CI/CD
Database Schema	MongoDB collections, indexes, relationships
Configuration Reference	config.default.yaml breakdown
Production URL Checklist	What to update when changing the domain
Troubleshooting	Common issues and fixes

---

Tech Stack

Layer	Technologies
Frontend	React 18, Vite, TypeScript, Tailwind CSS, Framer Motion
Backend	Node.js 22, Express 4, TypeScript (ESM), Mongoose 8, Zod
Database	MongoDB Atlas (with Vector Search), Upstash Redis (optional)
Search	Hybrid vector + keyword, Reciprocal Rank Fusion
AI	Anthropic, OpenAI, XAI, Gemini, MiniMax (per-pipeline)
Integrations	Discord bot, Zoom OAuth, Google Cloud Storage
DevOps	Sentry, GitHub Actions CI/CD, Docker, systemd

---

Repository

GitHub: vicharanashala/crowd-source-faq