Skip to main content

Tech Stack

Backend​

  • FastAPI — Python async web framework
  • SQLAlchemy — ORM with async SQLite/PostgreSQL support
  • Pydantic v2 — Data validation
  • python-jose + passlib — JWT auth + bcrypt password hashing
  • boto3 — AWS S3 integration (textbook storage)
  • httpx — Async HTTP client for LLM/embedding APIs

Frontend​

  • React 19 + Vite — SPA with React Router
  • Tailwind CSS — Utility-first CSS with design system tokens
  • Docusaurus — Documentation site

AI / ML​

  • vLLM (External) — Remote LLM endpoint (Qwen3.6-35B-A3B-FP8)
  • RAG pipeline — Textbook chunking → semantic tagging → knowledge graph → vector search
  • Embedding model — Remote service (Qwen3-Embedding-4B-AWQ-INT4)
  • Speech recognition — Local fine-tuned model with educational terminology correction

Infrastructure​

  • AWS S3 — zhiheng-806169617306 (ap-east-1, textbooks & materials)
  • PostgreSQL 16 — Primary database (Docker)
  • Nginx — Reverse proxy (frontend + API)
  • Docker Compose — Production deployment
  • Cloudflare Pages — Docs site hosting
  • Cloudflare Worker — Basic Auth gateway

Design System​

  • DESIGN.md — Formal token spec (linted, WCAG validated)
  • Tailwind export — DESIGN.tailwind.json for frontend integration
  • Reference style — Mintlify-inspired, adapted for Chinese education context