dadao
d079564d6c
CI / backend (push) Canceled after 0s
之前知识只能"存"，不能"找"。这一版把链路补上：切片 → 向量 → 打分 → 带来源返回。
- chunk 表 + 迁移 0006：正文按标题归段切、代码块整块保留、超长按句切、
相邻片重叠 80 字；RLS 与 GRANT 与其它租户表一致
- 向量提供方做成协议：内置 hash（字符二元组，零依赖可复现，作为基线）
与 OpenAI 兼容端点两种，换实现不动业务代码
- 检索是混合打分：向量 0.6 + pg_trgm 0.4。专有编号、单号这类必须原样命中的词
靠词法兜，换个说法表达的同一件事靠向量兜
- 三条纪律：只搜 published（过滤写在 SQL 里）、低于阈值宁可不返回、
每条命中都带来源标题与 item_id
- 发布时自动建索引，改完正文用 POST /knowledge/{id}/reindex 重建
- Web 知识页加检索框与命中卡片；新增 e2e/retrieval.mjs 6 项
为什么不是 pgvector：本机 Docker 起不来、fnsvr-01 没有该扩展且明确不动。
先用 real[] + SQL 余弦把链路跑通，将来换列类型与索引即可，接口不变。
后端 79 passed，e2e smoke/knowledge/richtext/retrieval 全绿。
40 lines
2.8 KiB
Markdown
40 lines
2.8 KiB
Markdown
# DadaoTask
|
||
|
||
任务管理 · 工单协作 · 知识库，三件事一条流，由 LLM 贯通。**SaaS 形态**（个人免费 → 团队按席位）。
|
||
|
||
- 产品与技术方案（v1.0）：[`2.Design/PRODUCT-PLAN.md`](2.Design/PRODUCT-PLAN.md)
|
||
- M0–M1 实施清单（含真实进度）：[`2.Design/ROADMAP-M0-M1.md`](2.Design/ROADMAP-M0-M1.md)
|
||
- 接口约定（已实现部分）：[`2.Design/API.md`](2.Design/API.md)
|
||
- 本地开发：[`2.Design/DEVELOPMENT.md`](2.Design/DEVELOPMENT.md)
|
||
- 中文命名方案：[`2.Design/NAMING.md`](2.Design/NAMING.md)
|
||
|
||
## 技术栈
|
||
|
||
- 后端：FastAPI + SQLAlchemy 2.0 async + PostgreSQL（RLS，pgvector 待 M3）+ Redis
|
||
- PC：React 18 + Vite + Tailwind
|
||
- 安卓：Kotlin + Jetpack Compose
|
||
- LLM：OpenAI 兼容网关，平台自带 DeepSeek，用户可配 Ollama 等
|
||
|
||
## 现在能跑什么
|
||
|
||
| 能力 | 状态 |
|
||
|---|---|
|
||
| 手机号验证码登录、刷新令牌、幂等请求 | ✅ 已实现并有测试 |
|
||
| 工作区 / 成员 / 邀请码加入，跨租户隔离（RLS） | ✅ 同上 |
|
||
| 任务：收件箱→待办→进行中→完成、截止时间、标签、评论、事件流、乐观锁 | ✅ 后端 + Web 已通 |
|
||
| Web 列表 / 看板拖拽 / 详情侧栏编辑 / 键盘流 / 快速录入语法 | ✅ e2e 7 项断言全绿，构建通过 |
|
||
| 1000 条任务下的首屏性能 | ✅ 实测 P50 38–55ms（目标 < 300ms） |
|
||
| 安卓端任务 / 看板 / 工单 / 知识 / 成员五个页面 | ✅ 编译成 APK（10.1 MB），模拟器上逐页跑通，截图见 [`2.Design/screens/`](2.Design/screens) |
|
||
| 工单：升级不搬数据、受理→办理→提交→验收、驳回、改派、站内通知 | ✅ 后端 + Web + 安卓已通，双人 e2e 8 项全绿 |
|
||
| 知识：工单验收自动生成草稿、核对后发布、来源可追、手记 | ✅ 后端 + Web + 安卓已通，e2e 7 项全绿 |
|
||
| 界面：两端统一设计系统（纸白 / 墨绿 / 陶土橙，语义色、字号阶、组件库） | ✅ 已重做，见 [`2.Design/ROADMAP-M0-M1.md`](2.Design/ROADMAP-M0-M1.md) 第 4 节 |
|
||
| 富文本：备注 / 工单说明 / 知识正文支持图文混排与附件 | ✅ Web 用 Vditor 编辑、安卓用 Markwon 预览编辑（e2e 15 项全绿）；接口见 [`2.Design/API.md`](2.Design/API.md) 第 6 节 |
|
||
| 知识切片与语义检索（混合打分、只搜已发布、带来源） | ✅ 已跑通：`real[]` + SQL 余弦（pgvector 待独立实例），`pytest` 5 个用例 + `e2e/retrieval.mjs` 6 项 |
|
||
| 后端测试 | ✅ 79 passed，ruff 干净 |
|
||
| LLM 能力（结构化录入、问答带引用、人物画像） | ⬜ M4 |
|
||
|
||
## 快速开始
|
||
|
||
见 [`2.Design/DEVELOPMENT.md`](2.Design/DEVELOPMENT.md)。开发库跑在团队共享的 `fnsvr-01:8432`（PG 17.6），
|
||
测试库 `dadaotask_test` 与开发库分离——**测试会 TRUNCATE，别指向开发库**。
|