【青囊复刻 · 古典命理 AI 平台】—— 3 天独立全栈交付
复刻 qingnang.cc(古籍数字化 AI 推演平台),从零到软上线全栈独立开发,3 天完成。
技术栈:Next.js 16(React 19 + Server Components)+ TypeScript + Supabase(PostgreSQL + pgvector + Auth)+ DeepSeek LLM + 自建 BGE-M3 向量检索(RAG)+ Python FastAPI 微服务 + Docker 自托管部署。
核心架构(三层):
① 排盘层:接入 shunshi-bazi-core 引擎,生成四柱/十神/大运/纳音,含真太阳时经度校正。
② 规则引擎层:判格局、算旺衰(得令/得地/得势)、定喜用神,纯算法无 LLM。
③ AI 解读层:DeepSeek 流式生成 + RAG 检索 1137 条古籍知识切片(《滴天髓》《穷通宝鉴》等),支持追问多轮对话。
工程亮点:
三层解耦,各可独立测试;LLM 解读支持学者/隐士双人格 × 专业/通俗双深度。
全程 TDD,194 个单元测试,TypeScript 零类型错误。
自托管部署(4核8G 云服务器),Docker Compose 编排,自定义并发保护(限流 + 同盘锁),应对软上线突发流量。
SSE 流式传输完整端到端打通(LLM → 路由 → 前端逐字渲染)。
交付成果:
上线运行中(http://64.83.1.104:3000),支持注册/排盘/详批/追问/历史记录全流程 [blocked]。
端到端可演示,真实用户可用。
体现的能力:全栈独立开发、复杂业务建模、LLM + RAG 工程落地、自托管部署运维、TDD 工程规范。