v2.0 — RAG platform transformation
v2.0 — RAG platform transformation
Tag: v2.0 · Date: 2026-05-19
Summary
Major platform evolution from the upstream chabot fork into Campus RAG Assistant — a production-style enterprise RAG platform with Vue product UI, multicloud provider boundaries, LangGraph orchestration, RAGAS evaluation, and GitHub Actions CI/CD.
Highlights
Product & UI
- Vue 3 SPA — streaming chat, session sidebar, source panels (Sources + Content tabs), feedback, OAuth handoff
- Opt-in web research — per-message toggle with visible disclaimer banner
- GitHub OAuth — dev OAuth on API port with one-time handoff to Vue
RAG engineering
- LangGraph pipeline — condense → multi-query → retrieve → rerank → generate → format
- Dual RAG engines —
RAG_ENGINE=chain(true SSE) andlanggraph(observable stages) - Provider registry — AWS Bedrock KB, Azure AI Search + OpenAI, mock mode for CI/local
- Multi-query + RRF fusion — improved retrieval coverage
Platform & ops
- Alembic migrations — schema versioning for PostgreSQL
- Prometheus metrics —
/api/metrics, request IDs, structured logging - GitHub Actions CI/CD — tox (lint, backend, frontends) + gitleaks on every PR
- MkDocs site — GitHub Pages documentation
Evaluation & quality
- RAGAS golden-set harness — 10-question regression baseline
- Phase 5 retrieval tuning — AWS context_recall improved to 0.80 (passes gate)
- LangSmith traces — per-node spans on LangGraph path; waterfall screenshots in README
Documentation
- Architecture diagrams (v1/v2), screenshot gallery, ADRs (001–004), portfolio case study, reviewer guide
Architecture
See architecture/v2/overview.png and detailed.png.
What came next
v3 added the bounded helpdesk agent (LangGraph supervisor, HITL ticket filing, Ask/Agent mode) on top of this RAG platform.