chore: initialize fullstack starter and team guidelines

2026-10-15 13:05:10 +08:00
commit 768c1c3ce9
37 changed files with 388 additions and 0 deletions
@@ -0,0 +1,16 @@
+# 技术决策记录（ADR 简版）
+
+## ADR-001 前后端分离
+状态：已决定。前端 Vue 3 + TypeScript + Vite；后端 FastAPI + Pydantic。原因：团队并行开发、API 边界明确、原型可先行。
+
+## ADR-002 数据库
+状态：已决定。PostgreSQL + pgvector。原因：结构化业务数据与向量检索可统一管理。首版先实现知识表，再逐步加入版本、向量与检索日志。
+
+## ADR-003 Embedding
+状态：待评估。采用统一 Provider 接口，在开源本地模型与云端 API 间选择。严禁混用不同模型生成的向量。
+
+## ADR-004 网络搜索与 MCP
+状态：延期。首版默认使用经过审核的知识库；联网搜索作为可选扩展。优先封装已有 API，不因使用 MCP 而自研协议服务。
+
+## ADR-005 更新策略
+状态：设计确定、尚未实现。新文档版本后台生成向量，完成后原子发布；失败保留旧索引。