Developer Documentation

Documentation for engineers building and maintaining HUPH — a multi-channel AI chatbot platform for UPH (Universitas Pelita Harapan) student admission.

Onboarding

• Setup — Local environment in ~15 minutes
• Repository tour — Monorepo layout and where things live
• Running tests — Jest (API) + pytest (RAG) + admin verification
• Your first PR — Conventions, TDD, commit style, bilingual docs sync
• Debugging — Logs, Phoenix, Langfuse, common traps

Architecture

• Overview — System diagram and data flow
• API — Node.js webhook + admin REST
• RAG — Python FastAPI + BGE-M3 + Claude Haiku
• Admin — Next.js enterprise dashboard
• Integrations — External services table

Operations

• Deploy — Manual deploy sequence
• Rollback — Rollback flow for API, RAG, admin
• Incident playbook — Detect, triage, contain, fix, verify, postmortem
• ClickHouse OOM recovery — Langfuse stack recovery procedure
• Realtime smoke test — Socket.io end-to-end check
• Lead capture smoke test — Phase 2A capture pipeline check
• Nginx realtime config — /socket.io/ proxy block

Language

Developer documentation is English-only in Pass 1. Indonesian mirrors may be added in a later pass if there is demand.