BodySense 项目 MOC
BodySense（体悟）AI 体态健康助手的知识地图：39 篇原子笔记覆盖从架构设计到生产部署的完整链路。
#type / moc
#status / growing
#tech / ai
#tech / dev
[!info] related notes
BodySense 项目 MOC
从零到一搭建一个 AI 体态健康助手的知识地图。
从这里开始
- BodySense 项目概览 — 项目全貌
- 多服务架构 — 三服务为什么这样拆
项目设计（8 篇）
- 数据库设计 — ER 图、核心表结构、索引策略
- 认证完整流程 — 注册/登录/刷新/注销/密码重置
- 错误处理策略 — 统一错误模型、LLM 降级、用户友好信息
- API 设计规范 — RESTful、版本管理、分页排序
- 测试策略 — 测试金字塔、单元/集成/E2E、AI 输出测试
- 可观测性设计 — 结构化日志、Prometheus、Grafana、告警
- 性能优化策略 — 前端懒加载、后端缓存、AI 优化
- CI/CD 完整流程 — 代码提交、自动测试、自动部署、回滚
架构与设计（6 篇）
- 多服务架构 — 前端/Go/AI 服务的职责边界与通信
- 多服务 SSE 管道 — 端到端 SSE 透传全链路
- LLM Streaming 协议设计 — Delta / Append / State 三种协议模式、分层架构、工业级事件协议
- 前后端共享类型契约 — API 契约一致性
- Monorepo 工程组织 — pnpm + Nx 任务编排
- 会话与消息流设计 — 懒创建会话、分层 ID、SSE 事件协议、幂等与断线恢复
AI 服务能力（10 篇）
- LLM Provider 抽象层设计 — 多模型切换的统一接口
- AI Gateway 模型路由器设计 — AIService→ModelRouter→ProviderAdapter→QuotaManager 全链路
- Function Calling 流式累积 — SSE 中 tool_call 的增量拼接
- 咨询 Agent 工作流设计 — 意图分类→阶段推进→安全检测
- RAG 知识库设计 — pgvector 四层 schema + 向量检索
- 意图感知 RAG 重排 — 按意图 boost 检索结果
- Hashing Embedding 降级 — 零模型离线 embedding
- RAG Faithfulness 校验 — 防止幻觉进入治疗方案
- Red Flag 症状检测 — 医疗 AI 的安全底线
- OCR 文字识别管线 — 图片/PDF 文字提取
Go 后端（8 篇）
- Gin HTTP 框架 — 路由分组、中间件、JSON 绑定
- Handler-Service-Repository 分层 — 三层职责与依赖方向
- Go 手动依赖注入 — main.go 组装依赖链
- JWT 认证中间件 — 双 token 策略、签名验证
- 数据库迁移 — 版本化 SQL、可回滚
- Redis 缓存实践 — token 黑名单、速率限制
- SSE 代理模式 — 透传 AI 服务流式响应
- 健康检查端点 — 依赖检查、Docker HEALTHCHECK
React 前端（8 篇）
- Feature-Based 目录结构 — 按功能组织前端代码
- React Router 路由与权限 — ProtectedRoute 路由守卫
- Zustand 全局状态 — 认证状态持久化
- TanStack Query 服务端状态 — API 数据缓存
- 前端 SSE 消费 — fetch + ReadableStream 流式消息
- AI 聊天 UI 设计 — 流式打字机、Markdown、工具调用展示
- SSE 流式 Markdown 渲染 — 流式场景不完整 Markdown 的闪烁/重解析问题、三种渲染方案选型、四层架构分层
- shadcn/ui 组件库 — 源码复制式组件库
部署与 DevOps（7 篇）
- Docker Compose 开发环境 — 多容器编排
- Docker 多阶段构建 — builder + runtime 分离
- Caddy 反向代理 — 自动 HTTPS
- GitHub Actions CI — 多服务并行 CI
- release-please 自动版本 — Conventional Commits 自动发布
- Watchtower 自动部署 — 镜像更新自动重启