Tatta/DadaoTask
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
37 Commits 2 Branches 0 Tags
7c84ff3b8deb0217f8f7047b99309c75cb53d56b
Commit Graph
15 Commits
Author SHA1 Message Date
Steven ffae7e380f fix(knowledge): PATCH 知识时带上 doc_type 直接 500 
`patch_knowledge` 把 `doc_type`/`summary` 也塞进了给 `items` 表的 UPDATE，
于是 SQLAlchemy 报 `CompileError: Unconsumed column names: doc_type`——改类型的
请求一律 500。这两个字段本来就属于 `knowledge_doc`，下面几行已有赋值，重复写
进 items 的 values 是错的。

现在 `values` 只放 items 的列（title/body_md），`doc_changed`（doc_type/summary）
单独参与"要不要推进 version"的判断，语义不变：只要这条知识的样子变了，
version 就得 +1，否则下一次保存会拿旧 version 撞 4009。

补一个用例：PATCH 同时改 title/body_md/doc_type/tag_names 应该 200，
doc_type 生效、version 前进一步。这个 bug 之前没暴露，是因为 Web 抽屉只改
标签和分类，没人用 PATCH 改过类型。
 2026-10-30 16:18:05 +08:00
Steven ed31af3f46 feat(knowledge): 知识改成备忘录形态，一次写全 + 三级分类，抽屉加宽
CI / backend (push) Canceled after 0s
Details 
知识以前只能"填个标题就完成"，正文、标签、归类都要点进去再补。现在新建
就是一张完整的备忘录：标题、类型、分类、标签、正文一次写完，存完直接打开
详情继续编辑；知识页左侧多了工作区三级分类树，可按分类子树 / 未分类 / 标签
筛选。凡是填信息的抽屉都加宽了，还能一键展开整屏。

后端
- 新增 `knowledge_category`（迁移 0007）：`workspace_id NOT NULL` + 自引用
  `parent_id`、`depth` 1..3 检查约束、同层重名唯一索引（lower(name)）、
  RLS 策略与 `dadao_app` 授权；`knowledge_doc.category_id` 外键 ON DELETE
  SET NULL。
- 新增 `/knowledge/categories` 增删改查：超三级 `7007`、同层重名 `7008`、
  跨租户或不存在 `7006`；`move=true` 才改父级，成环与移动后超过三级的子树
  一律拒绝，删除有知识的分类要 `force=true`（知识变未分类）。
- 知识列表支持 `category_id`（含子树）、`uncategorized`、`tag`；输出带
  `category`（含 `path` / `full_path`）。
- PATCH 只改分类或标签也会推进 `version`，避免"只动标签"之后下次保存撞
  乐观锁 `4009`。

Web
- `Sheet` 增 `size="md/lg/xl"` 与展开整屏按钮；任务、工单、知识抽屉统一
  加宽（`TaskDetail` / `Tickets` / `Knowledge`）。
- 知识页：左侧三级分类树（新建、按子树筛选、未分类）、`KnowledgeComposer`
  一次写全新的备忘录、列表卡片露出分类路径与标签、详情抽屉里可直接改分类
  与标签。
- 抽屉详情只拉一次：重复的 effect 或迟到的响应不再覆盖用户正在敲的内容。

安卓
- `Api.kt`：分类模型与接口、新建/更新带 `tag_names`/`category_id`、
  列表带分类与标签筛选。
- 知识页重做：新建改为近全屏大对话框（标题/类型/分类/标签/正文），列表
  顶部按分类筛选，详情里能改分类与标签后单独保存。

文档与测试
- `2.Design/API.md`：5.1/5.3/5.4 补分类与筛选参数，新增 5.5 分类接口章节，
  错误码补 `7006`/`7007`/`7008`。
- `2.Design/ROADMAP-M0-M1.md`：新增 3.11（三级分类）、3.12（备忘录形态）。
- 新增 `backend/tests/test_knowledge_categories.py`（8 例）：备忘形态落库、
  三级到底、移动越界与成环、重名、按子树/未分类/标签/关键词筛选、删分类需
  `force`、跨租户隔离。
- 新增 `web/e2e/knowledge-notebook.mjs`（10 项，全绿）：建两级分类 → 一次
  写全 → 卡片与筛选 → 抽屉改标签/分类 → 正文落库 → 重名 7008。

验证：`pytest` 93 passed、`ruff check` / `ruff format --check` 全过、
`tsc --noEmit` 通过、`vite build` 通过、`knowledge-notebook.mjs` 10 项全绿。
安卓端本机只有 JDK 25，Gradle 8.7 / AGP 8.7.3 不支持，本次未做编译验证。
 2026-10-30 03:51:43 +08:00
Steven 91b3dde670 feat(notify): 站内通知与手工开单，指派/改状态/评论/验收都有人收到
CI / backend (push) Canceled after 0s
Details 
M2 最后一块：让"该我办了"能出现在系统里，并且允许不经过任务直接开单。

通知（backend/app/services/notify.py 统一出口）
- 七类触发：task_assigned、task_status_changed、item_commented、
  ticket_assigned、ticket_submitted、ticket_approved/rejected、task_unblocked
- 不通知自己：notify() 按 actor_id 跳过，调用方不用各自判断
- 已读：GET /notifications、/unread-count、POST /read、/read-all

手工开单
- POST /tickets：直接指定人、初始 open，与任务升级单共用同一条 kind='ticket' item，
  ticket_ext.parent_item_id 为空，验收通过不回流任务
- 指派前 _ensure_member 校验在册成员，越界指派返回 1001（避免"挂在看不到的名字上"）

前端
- Web：通知页 /w/:wsId/notifications（未读/全部，点开标已读并跳目标）；
  工单页"新建"面板；AppShell 每 30 秒对未读数，标已读后 dispatch notifications:changed 立刻刷新；
  任务与工单支持 ?open= 深链落地即展开
- 安卓：五个 tab 加"通知"，未读数 30 秒刷新；工单动作按需求人/办理人/管理员显隐；手工开单对话框

验证
- pytest 85 passed（新增 backend/tests/test_notifications.py 6 个用例）
- ruff check / format --check 全 0
- tsc --noEmit 通过；vite build 成功
- web/e2e/notifications.mjs 12 项断言全绿（手工开单 → B 收到 → 点开跳转 → 未读归零）
- 安卓：本机 JDK 25 与 Gradle 8.7 / AGP 8.7.3 不兼容，本次未做编译验证，
  装回 JDK 17 后第一件事是 assembleDebug
 2026-10-30 02:19:42 +08:00
dadao d079564d6c feat(knowledge): 语义检索打通——切片、混合打分、只搜已发布
CI / backend (push) Canceled after 0s
Details 
之前知识只能"存"，不能"找"。这一版把链路补上：切片 → 向量 → 打分 → 带来源返回。

- 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 全绿。
 2026-10-29 04:28:09 +08:00
dadao d509f0c335 fix(android): 编辑器改成整页显示，保存后回到刚才那条详情 
原来编辑器是叠在工作区上的 Box，而详情抽屉/对话框是独立窗口，永远盖在它上面——用户只能看到编辑器的一条顶栏。改成编辑器替换整页；保存成功后父层记下 itemId，回到工作区由对应页面刷新并重新打开那条详情。取消则什么都不变。
 2026-10-29 04:01:28 +08:00
dadao 17be9d1d42 feat(rich): 安卓能编辑富文本了，图片直链换成短期签名，表格不再撑破抽屉
CI / backend (push) Canceled after 0s
Details 
三件欠账一次清：

1. 图片直链签名化
   - 新增 `backend/app/services/signing.py`：HMAC-SHA256，密钥由 `JWT_SECRET` 域分离派生
     （`attachment-raw-v1`），载荷 `workspace_id:attachment_id:exp`，默认 30 分钟
   - `/raw` 支持 `?exp=&sig=`，不需要登录态；签名里绑了工作区，跨租户链接直接拒
   - 附件对象多一个 `raw_url`，前端每次渲染现签，正文里只存不带凭据的 `/raw`
   - 保留旧 `?token=` 通道，给未升级的客户端过渡

2. 安卓富文本编辑器
   - `ui/RichTextEditorScreen.kt`：Markdown 工具栏（粗体/斜体/标题/列表/引用/代码/链接/图片），
     选区包裹与行首前缀都按光标位置来；贴图走附件接口，插入签名直链
   - 预览用 Markwon，图片用 Coil；正文落在一张白纸卡片里，不再贴屏幕边
   - 从任务详情与知识点都能进，保存按 `body_md` 回写（PATCH 带 version）

3. 表格
   - 只读渲染走 markdown-it 的 GFM 表，`display:block + overflow-x:auto`：
     宽表横向滚动、窄表铺满，都不撑破抽屉

验证：pytest 74 passed；richtext 15 / smoke 7 / tickets 8 / knowledge 7 全绿；
tsc -b 0 错；vite build 通过（主包 299.42 kB / gzip 74.96 kB）；
安卓 assembleDebug 成功并在 API 35 模拟器走通编辑与预览。

仍欠：保存后回列表而非回详情抽屉、图片压缩与缩略图、HTML 片段按文本显示。
 2026-10-29 03:32:53 +08:00
dadao a24a493403 feat(rich): 备注/工单说明/知识正文支持 Markdown 与图片附件 
写一件事的时候，光有纯文本不够：要贴截图、要分段、要标重点。
这次把「正文」这条路补全，思路是**存 Markdown 而不是 HTML**——
能导出、能全文检索、能直接喂给 LLM，也不必每次渲染都重新清洗一遍 HTML。

后端
- attachment 表 + RLS + 迁移 0005；本地磁盘存储，key 由内容 sha256 决定，
  换对象存储只改 services/storage.py 一个文件
- 上传在**读流时**卡 20MB，不先落盘再判断；磁盘名由服务端生成，用户文件名只进库和响应头
- 列表带 attachment_count、详情带 attachments，避免一屏 N 次请求
- raw 直链给 <img src> 用（图片带不了 Authorization 头），只允许本工作区成员，
  非成员一律 8001 不区分「不存在」与「没权限」
- 5 个用例：上传下载、超限、跨租户、删除确认与权限、raw 鉴权

前端
- 自研零依赖 Markdown 渲染器：先转义再上标签，链接协议白名单
- RichTextEditor：工具栏 + Ctrl+B/I + 预览，粘贴或拖入图片自动上传并插入引用
- AttachmentPanel：上传/下载/删除，下载走带 Authorization 的 fetch 转 blob
- 任务备注、工单说明与验收结论、知识正文、评论全部接入

顺手修的
- TaskDetail.hydrate 漏了 setAttachments，导致附件面板永远是空的（e2e 抓到的）

71 passed；web tsc 0 错、构建 255.07 kB │ gzip 80.85 kB；
e2e：richtext 9 项 + smoke 7 + tickets 8 + knowledge 7，全绿。
 2026-10-29 01:53:46 +08:00
dadao 0919c8ecd3 fix(knowledge): 草稿的过程段写「收件箱 → 待办」，而不是两句「状态变更」
CI / backend (push) Canceled after 0s
Details 
自动生成的草稿里，时间线只查了 activity.action，没带 payload，
于是每条状态变化都变成一模一样的「状态变更」，读者看不出事情怎么走的。

- services/knowledge.snapshot_source 多取 Activity.payload 一起交给渲染
- domain/knowledge 加 STATUS_LABEL 与 _describe()，把 payload 的 from/to 翻成人话
- 新增用例断言草稿里有「待办 → 进行中」「进行中 → 已完成」

66 passed。
 2026-10-28 14:14:50 +08:00
dadao e9addeed25 feat(knowledge): 工单验收自动生成草稿，核对后发布，来源可追 
- knowledge_doc 与 item 1:1，除 source_kind=manual 外必须有来源（库级约束）
- 状态机 draft/in_review/published/archived，发布要 owner/admin；非法动作回 allowed_from 与 allowed_actions
- 工单验收通过自动落 postmortem 草稿（generated_by=rule），同一来源只生成一次
- 接口：列表/详情/手记/改内容/状态动作/从事项沉淀；已发布禁改，改内容带乐观锁
- Web 知识页 + 详情抽屉；任务与工单详情里可「沉淀成知识」
- 8 个后端用例 + e2e 7 项断言（沉淀 → 待核对 → 发布）
 2026-10-28 14:02:35 +08:00
dadao 30caaaf1d9 feat(ticket): 工单协同后端——升级不搬数据、受理到验收、站内通知 
- item.kind='ticket' + ticket_ext 1:1，迁移 0003 同时重写 item 状态约束为任务∪工单并集
- 工单状态机与动作权限：受理/开工/提交限办理人，验收限需求人（办理人不能自验）
- 升级时原任务转 blocked，验收通过后自动回流 todo，事件流两侧都留痕
- item_link（父子/相关）与 notification（只发当事人），三张表均开 RLS
- 抽出 serializers.py 复用任务序列化，修复工单响应缺 tags 导致前端白屏
- 评论与 PATCH 放开给工单；conftest 清库前终止残留事务，避免 TRUNCATE 死等锁
- tests/test_tickets.py 11 个用例，全量 57 passed
 2026-10-28 13:20:07 +08:00
dadao c4868f04cf feat(task): 批量改状态与看板数据接口 
- POST /items/batch-status：逐条成败，不做全回滚；拖 10 条里 1 条冲突不该让另 9 条白干
- GET /items/board：四列一次取全，收件箱不进看板
- 修：/items/board 被 /{item_id} 抢先匹配导致 422
- 新增向量库配置项（M3 用，独立实例，不动 fnsvr-01）
- 3 个新测试，全量 46 passed
 2026-10-28 04:05:35 +08:00
Steven e25a1a4e31 feat(task): M1 任务域后端与 Web 列表（状态机/乐观锁/视图/搜索）
CI / backend (push) Canceled after 0s
Details 
- item/tag/item_tag/comment/activity 五表迁移，RLS 全覆盖，pg_trgm 子串索引
- 状态机 domain/task.py：非法流转回 5002 并给 allowed，done 写 completed_at
- /workspaces/{ws}/items 列表/详情/新建/改/状态/软删/评论/标签
- 乐观锁 UPDATE...WHERE version，冲突 4009 + current_version
- Web 任务页：视图 tab、快速新建、勾选完成、开工/阻塞、详情事件流、游标分页
- 测试 43 全绿，ruff 干净，Web 构建通过
- 文档：2.Design/API.md 新增，ROADMAP 按已验证口径重写
 2026-10-28 03:48:48 +08:00
Steven d390b7b58a feat(db): 支持接团队共享库 fnsvr-01（PG 17.6），测试库与开发库分离
CI / backend (push) Canceled after 0s
Details 
fnsvr-01 的 PostgreSQL 在 8432 端口（不是 5432），实测 PostgreSQL 17.6 / Alpine。
已在该实例建好独立库与角色：
- dadaotask（开发）/ dadaotask_test（测试），owner 都是 dadao_owner
- dadao_owner 迁移用；dadao_app 应用用（NOSUPERUSER NOBYPASSRLS）
- 两个库都已 ALTER SCHEMA public OWNER TO dadao_owner + REVOKE CREATE FROM PUBLIC + GRANT 给 dadao_app

代码改动：
- config 增加 test_database_url / test_migration_database_url，并给出
  resolved_database_url() / resolved_migration_database_url()：ENV=test 且有测试库时优先用测试库，
  否则退回开发库（CI 里直接给 DATABASE_URL 即可，行为不变）。
- db.py / alembic/env.py / tests/conftest.py 统一走这两个解析方法。
  原先 conftest 清表用的是 settings.migration_database_url，而应用连的是测试库，
  一旦测试库与开发库不同，TRUNCATE 就清到另一个库上——表现为"测试库脏数据越攒越多、
  列表类断言随机失败"。这是本次真踩到的坑，不是假想。
- tests/conftest.py 保留 E402 豁免（环境变量必须在 import app 模块前写好）。

验证：
- 远程 dadaotask_test 上 pytest 33 passed，跑完表内 0 行（确认清表打在同一个库）
- 远程 dadaotask 上 alembic upgrade head 成功，/health 与 /version 正常，db_role 为 dadao_app 且三项全 false
- 本机便携 PG 16.4 上同样 33 passed（两个 PG 大版本都过）
- ruff check / format 干净

已知限制：该实例没有 pgvector（只有 pg_trgm / pgcrypto），M3 向量检索前必须先定扩展来源，
已写进 2.Design/DEVELOPMENT.md。
 2026-10-28 03:37:41 +08:00
Steven 2b493bd9f8 fix(m0): 迁移可执行 + 测试全绿（33 条）
CI / backend (push) Canceled after 0s
Details 
跑通迁移与测试后修掉的真问题：

- alembic 0001：asyncpg 走预备语句，一次 execute 只能一条 SQL。
  CREATE FUNCTION / CREATE POLICY / GRANT 全部拆成单语句逐条执行，
  否则报 "cannot insert multiple commands into a prepared statement"。
- 创建工作区：ORM flush 只按 relationship 排序，裸外键不算数，
  member 可能先于 workspace 落地撞 FK。改为先 flush workspace 再插 member。
- datetime.UTC 是 3.11+ 才有的，本机 3.10 直接 ImportError。改用 timezone.utc。
- 幂等中间件：原来会缓存 4xx。校验失败被缓存后，用户改对参数仍拿到同一个 422。
  改为只缓存 <400。
- 发码节流窗口改为可配置 SMS_THROTTLE_SECONDS（测试置 0），
  节流用例自己显式打开，避免"整库关掉节流"导致节流从未被验证。
- 租户隔离用例：pytest.raises(Exception) 改为精确的 ProgrammingError，
  否则任何异常都会让"应用角色不能建表"这条断言假通过。

验收：pytest 33 passed；ruff check / format 通过；真机跑 uvicorn，
/health、/version、登录、建工作区、列表、/auth/me 全通。
 2026-10-28 03:22:59 +08:00
Steven 0c53aa7062 feat(m0): 后端骨架 + Web/安卓前端骨架 + 设计文档 
- backend: FastAPI 应用工厂、统一错误信封、JWT、短信登录、工作区/成员/邀请、幂等中间件
- alembic 0001: workspace/member/invitation/audit_log/app_user + RLS 策略 + 双角色 GRANT
- tests: 认证/工作区/租户隔离/幂等 四组用例（尚未在本机执行）
- web: React18+Vite 骨架（登录、工作区、邀请落地页）
- android: Compose 骨架（登录、工作区列表）
- 2.Design: PRODUCT-PLAN / ROADMAP-M0-M1 / NAMING / DEVELOPMENT
 2026-10-28 02:38:53 +08:00