Tatta/DadaoTask
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
53 Commits 2 Branches 0 Tags
a5510cdb791a20e99c9239b18fbe8055be117727
Commit Graph
18 Commits
Author SHA1 Message Date
Steven 50227c2114 feat(knowledge): 「全部」排到 tab 第一位并默认选中，正文编辑区跟着屏高走
CI / backend (push) Canceled after 0s
Details 
- 知识列表 tab 顺序改成 全部 / 待核对 / 已发布 / 已归档，默认停在「全部」：
  进知识库先看"我这儿都有些什么"，待核对是待办，不该当门面。
- 正文编辑器不再是写死的 240px：新增 useEditorHeight(reserve)，
  按 window.innerHeight 减掉标题/分类/标签/附件/底部按钮算高度
  （新建留 420、编辑留 340，最低 360、最高 960，窗口 resize 时重算），
  新建面板与详情编辑两处共用，长文一屏能写完一段。
- 截图脚本 shots-knowledge-view.mjs 支持 EDIT=1 出编辑态图、ALL=1 留在默认 tab；
  新增 2.Design/screens/knowledge-tab-all.png、knowledge-edit-tall.png。
- 验证：tsc --noEmit 通过、vite build ✓、e2e knowledge.mjs 9 项与
  knowledge-notebook.mjs 17 项全绿（含"侧栏分类按树排""已发布也有编辑"）。
 2026-10-31 02:25:25 +08:00
Steven b29286778f fix(knowledge): 分类侧栏按树的顺序排，已发布的知识也能直接改
CI / backend (push) Canceled after 0s
Details 
两个都是"看着不对劲"的问题：

1. 侧栏把二级分类全堆在一级分类后面（按 depth 排序的副作用），
   「技术」和它的上级「我的备忘」隔着十几行，看着像一棵假树。
   后端改成按树的先序返回（父分类后紧跟它的子分类，兄弟仍按 sort_order、name），
   前端照 depth 缩进就是个真树；二级以下再加一个「·」标记，小屏也分得清。

2. 点开已发布的知识只有「归档」，没有改的入口——因为后端原来硬性拒绝
   修改已发布内容（7003）。但"发布"是给团队看的，写错了总要能改：
   现在已发布的可以直接 PATCH，改完立刻重建检索切片（chunk_count 当场更新），
   状态和版本号照常推进；归档的仍然要先「恢复成草稿」再改。

Web 与安卓同步：抽屉/详情里已发布也显示「编辑」，安卓分类标签区不再锁。

验证：pytest 95 passed（新增"分类按树返回"用例、发布后可改用例）、
ruff 全绿、tsc 0、vite build ✓；`knowledge-notebook.mjs` 17 项、
`knowledge.mjs` 9 项 e2e 全绿。安卓仍未编译（JDK 25 / Gradle 8.7 不兼容）。
 2026-10-31 02:06:49 +08:00
Steven 441b1b93e1 feat(knowledge): 点开知识先看到排好版的正文，要改再点「编辑」
CI / backend (push) Canceled after 0s
Details 
之前抽屉一打开就是 Vditor 编辑器，正文是一堆 `##` 和 `-` 的原文，
导入的 84 条旧备忘看着尤其像草稿。现在分成「看」和「写」两态：

- 默认只读：按 Markdown 渲染（markdown-it + DOMPurify），分类与标签是 chip，
  附件列表只读；底部是「编辑」和状态动作，右侧显示发布于何时。
- 点「编辑」才挂编辑器；「取消」直接丢弃未保存改动（重新拉一次详情）。
- 安卓详情页同样用 Markwon 把正文排版后再显示，要改走「编辑正文」。

顺带修了 `web/e2e/knowledge.mjs` 里一条早就失效的断言：它等的是
「已发布 · 版本 N」，但界面上没有这行字（git 历史里也没有），
改成等抽屉底部的「发布于 …」。

验证：pytest 94 passed、ruff 全绿、tsc 0、vite build ✓；
`knowledge-notebook.mjs` 16 项、`knowledge.mjs` 7 项 e2e 全绿。
安卓本轮仍未编译（本机 JDK 25 与 Gradle 8.7/AGP 8.7.3 不兼容）。
 2026-10-31 01:34:25 +08:00
Steven 7c84ff3b8d feat(knowledge): 知识能挂附件，新建时就能传
CI / backend (push) Canceled after 0s
Details 
知识是备忘录，备忘录不能只有字：手册、日志、导出表格都得能挂上去。
附件本来就落在 item 上（`ALLOWED_KINDS` 早含 knowledge），缺的是"新建时
还没有条目 id"这一段。

- 懒建草稿：`KnowledgeComposer` 第一次传附件（或往正文贴图）时先 `POST /knowledge`
  存一条草稿拿到 id，`draftingRef` 去重防止贴图与上传同时打出两条草稿；
  之后的保存走 `PATCH /knowledge/{id}`。没传过附件就取消，库里不留空条目。
- `RichTextEditor` 增 `ensureItemId`：没有 itemId 时先把草稿存下来再传图，
  于是"新建时不能贴图"这条限制也没了；工具栏上传按钮按是否有落点显隐。
- 新建面板加了附件区：有草稿 id 就是正常的 `AttachmentPanel`（上传/下载/删），
  没有就先给一个「添加附件」按钮，点一下建草稿。
- 安卓知识详情加附件区：列表（文件名 + 大小）、`OpenDocument` 上传任意文件、
  点「打开」用浏览器看签名直链。编辑器原本只能插图，现在手册/日志也能传。
- 文档：API.md 说明附件三类事项共用同一套接口，以及懒建草稿的先后顺序；
  ROADMAP 加 3.13。

验证：后端 pytest 94 passed、ruff 全绿；Web `tsc --noEmit` 通过、`vite build` 通过；
`knowledge-notebook.mjs` 15 项全绿（新增「新建面板里能上传附件」「详情抽屉里能看到
刚传的附件」「附件挂在知识上，详情回读得到」）。安卓端仍是 JDK 25 + Gradle 8.7
不兼容，本次未编译验证。
 2026-10-30 16:18:32 +08:00
Steven 9a382e4e8c fix(knowledge): 新建知识的正文换成富文本编辑器，不再是纯文本框
CI / backend (push) Canceled after 0s
Details 
「记一条」面板里正文是个 textarea，排版、表格、贴图都没有——创建时反而比
详情页更寒酸。现在新建面板直接用详情同款 Vditor 编辑器，创建与修改一个模样。

- `RichTextEditor` 的 `itemId` 改为可选：新建时还没有条目 id，正文照写，
  只是上传按钮不摆出来；真去贴图会提示「先保存这条内容，再回来贴图」。
- `KnowledgeComposer` 的正文换用 `RichTextEditor`（minHeight 320），页脚提示
  按有没有条目 id 给不同文案。
- 安卓：新建对话框不再放纯文本正文框，保存后直接进 `RichTextEditorScreen`
  写正文（排版、表格、贴图都在那儿），写完回到列表并展开详情。
- e2e 增加一条断言：新建面板里的正文就是富文本编辑器（aria-label=正文 的
  contenteditable），正文按真实键盘输入后 Markdown 正常落库。

验证：`tsc --noEmit` 通过、`vite build` 通过、`knowledge-notebook.mjs` 11 项
全绿（新增「新建面板的正文是富文本编辑器」）。安卓端本机仍是 JDK 25 +
Gradle 8.7/AGP 8.7.3 不兼容，本次未编译验证。
 2026-10-30 15:52:09 +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 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 fbdf54cb4c feat(web): 富文本编辑器换成 Vditor，不再自研轮子
CI / backend (push) Canceled after 0s
Details 
上一版我自己写了 textarea + 正则工具栏，看着能用，一到粘贴图片、
中文输入法、撤销栈就露馅——这几样正是成熟组件积累的部分。按要求改成品。

- 编辑器开关 def: RichTextEditor = Vditor 4.0.1（MIT，ir 模式）
  * 运行时资源自托管：web/scripts/vendor-vditor.mjs 把 lute/i18n/icons
    同步到 public/vditor，predev/prebuild 自动执行，不走 unpkg CDN
    （内网会一直卡在加载）
- 只读渲染换 markdown-it + dompurify，删掉自写的正则渲染器
- 附件直链的令牌只在内存里存在：落库前 stripAttachmentTokens，
  渲染/装载前补回（<img> 带不了 Authorization 头，raw?token= 是必要折中）
- Vditor 不会替我们插入 upload.handler 的返回值（只当提示语 tip.show），
  所以上传完自己 insertMD

验证：pytest 70 passed；e2e richtext 13 项、smoke 7、tickets 8、
knowledge 7 全绿；tsc 0 错；主包 299 kB/gzip 75 kB，Vditor 独立
chunk 385 kB 按需加载。
 2026-10-29 02:30:10 +08:00
dadao 7a7ea932a4 fix(web): 表单标签对比度提到 ink-600，附件编辑器截图入册
CI / backend (push) Canceled after 0s
Details
2026-10-29 01:55:51 +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 c94e0424ed fix(web): 宽屏下侧栏贴边而内容固定居中，中间空出一大块
CI / backend (push) Canceled after 0s
Details 
问题：侧栏贴左边，内容区却用 mx-auto max-w-6xl 居中，窗口一宽就出现
"侧栏到内容之间一大片空白、内容右侧又一大片空白"的割裂感。2K 屏上尤其明显。

做法（用户给的两个方向里选"侧栏贴边 + 内容自适应"）：

- AppShell 内容区去掉居中与固定宽度，改为随窗口铺开，断点加宽内边距
  （lg 32 / xl 48 / 2xl 64），侧栏在 xl 从 240 加宽到 264
- 宽了之后不能只是把元素拉长，所以同步改成"用宽度"而不是"被拉长"：
  - 任务行：md 以上标题左、状态/优先级/截止/标签右对齐成一行，窄屏仍折两行
  - 知识、工单列表：md 两列 / 2xl 三列，卡片不再横跨整屏
  - 看板本来就是四等分列，自适应后自然铺满
- PageHeader 的描述文字限 max-w-3xl，宽屏下不出现过长的行宽

e2e/shots.mjs 支持 VIEWPORT=2560x1400 SUFFIX=-wide 覆盖视口，用来核对宽屏。
三个 e2e 复跑全绿；tsc 0 错，构建 242.02 kB / gzip 76.78 kB。
 2026-10-28 22:49:49 +08:00
dadao 5be55fdccb feat(web): 重做设计系统与全部页面，前端观感对齐当下审美 
用户反馈"UI 太丑、太简陋"。不是换配色，而是先立 token 再让页面去用：

- tailwind.config.js：纸白 paper / 墨绿 primary / 陶土橙 clay + 语义色
  sage/wheat/rust/sky，字号阶、圆角阶、投影、动效
- index.css：卡片、按钮五种变体、输入、pill/chip、导航、骨架屏
- 新增 icons.tsx（线性图标集）与 ui.tsx（Button/Sheet/Toast/空态/骨架/PageHeader）
- 新增 AppShell 取代 Layout + WorkspaceNav：桌面侧栏 + 移动顶部横条，工单未读角标
- 六个页面全部重写：登录、首页、任务、看板、工单、知识、成员、邀请落地
- 详情抽屉改用 Sheet，工单态补齐需求人/办理人/退回次数/动作按钮

e2e 因 DOM 升级同步调整（抽屉按 role=dialog 定位、下拉改用 aria-label），
三套用例（7 + 8 + 7 项）全部重跑通过；tsc 0 错，构建 45 modules / gzip 76.70 kB。
 2026-10-28 18:37:35 +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 3471b07ac1 fix(web): 工单详情不提供删除，e2e 两个用户昵称不再撞号
CI / backend (push) Canceled after 0s
Details 
- 工单删了原任务就永远解不开，正确出口是'取消'；删除按钮只留任务态
- e2e 里 A/B 原来共用后四位，昵称都变'用户XXXX'，截图看着像同一个人
 2026-10-28 13:24:29 +08:00
dadao b1dc3cffa6 feat(web): 工单页与升级面板，修掉视图竞态与标签缺失导致的崩溃 
- 新增 /w/:wsId/tickets：派给我的 / 我发起的、状态过滤、列表内联快操作
- 详情抽屉按角色显示受理/开工/提交/验收/驳回/改派/取消；任务态底部可升级成工单
- 导航抽成 WorkspaceNav，带未读角标（30 秒对齐，操作后立刻刷新）
- 修竞态：切视图/切 tab 连发请求时，慢的回包会把新结果盖掉（reqId 序号丢弃过期响应）
- 登录支持 ?next= 站内回跳，邀请链接不再'登录完掉回首页'
- e2e/tickets.mjs：双人双上下文的完整闭环，8 项断言全绿
 2026-10-28 13:20:18 +08:00
dadao 6e33e1024d feat(web,android): 看板拖拽、详情侧栏编辑、快速录入与安卓任务列表 
Web:
- 看板四列可拖拽，非法流转当场说明原因；勾选后可批量移动
- 详情侧栏全部可编辑（标题/优先级/截止/标签/备注/评论），409 自动刷新
- 快速录入 #标签 !优先级；键盘流 j/k、Enter、e、Esc
- Playwright 真浏览器 e2e 7 项断言全绿（web/e2e/smoke.mjs）
- 1000 条任务实测首屏 P50 38-55ms

Android（未编译验证：本机无 JDK/Gradle）:
- 任务列表/详情/勾选完成/快速新建，冲突时提示并刷新
- 修：User/Member 字段名与后端 nickmame/phone 对齐，原先必然反序列化失败
 2026-10-28 04:05:41 +08:00