14 Commits

Include renames

Author	SHA1	Message	Date
Steven	f6e7616756	fix(integrations): 「接收中」跨进程一致，不再跟着 gunicorn 进程抖动 ... 上一版用 `manager.polling()` 判"有没有人在收消息"，那是进程内状态：请求落到持有者 回答 true、落到备用进程回答 false，页面上就会每两秒闪一次"已停止"。 改成查数据库里的 advisory lock（`pg_locks`，objsubid=2 的两段式锁），谁抢到租约所有 进程都看得见。`lease_held()` 自己开一条短会话查，不复用请求会话——接口里常在 `await session.commit()` 之后才拼返回值，那时原事务已经关了。	2026-11-05 23:39:33 +08:00
Steven	2170a0664d	fix(integrations): 重启后机器人要能自己接回来 ... 上一版把双进程抢会话修了，但生产重启后仍然不收消息：`start_all()` 是进程启动时的 查询，那一刻没有工作区上下文，`bot_channel` 的 RLS 把行全藏起来，一行都查不到， 于是"页面上显示已连接，实际上没人在拉消息"。 - 迁移 0016 补一条只读策略：`current_setting('app.bot_list') = 'on'` 时允许 SELECT （只开 SELECT，防止顺手拿它改别人的通道）； - `start_all()` 走 `active_channel_ids()`，先设这个 GUC 再列通道； - 补测试 `test_startup_sees_logged_in_channels`。	2026-11-05 23:33:44 +08:00
Steven	07b01db7cc	fix(integrations): 一个通道只让一个进程收消息，gunicorn 双进程不再抢同一条会话 ... 生产是 `gunicorn -w 2`，两个进程各自跑 lifespan，start_all() 会把同一个通道的 长轮询拉两遍：消息被其中一个消费、回复从另一个发出，游标还会互相覆盖。 改成 Postgres 会话级 advisory lock 做租约：抢到的进程收消息，另一个每 10 秒重试， 主进程一挂连接断、锁释放，备用进程立刻接上。页面上的"接收中"只认抢到租约的那个 （`manager.polling()`），不再把等锁的也算进去。 补测试 `test_only_one_process_holds_the_polling_lease`： 第一个抢到、第二个抢不到、第一个放手后第三个能接上。	2026-11-05 23:28:35 +08:00
Steven	1e8cd01b3d	fix(integrations): 扫码确认后不再 500，回话不带链接，栏目改叫「机器人」 ... 1. 扫码确认那一刻页面报「服务器内部错误」：`bot_channel` 的轮询口子直接 `current_setting('app.bot_channel', true)::uuid`，而事务级 set_config 提交后 会把连接上的变量还原成空串而不是 NULL，空串 cast 就 InvalidTextRepresentation。 迁移 0015 改成 nullif(...,'')::uuid，与 app_ws_id() 同一写法。 2. 微信回话只回「已保存任务：…」／「已保存知识草稿：…」，不再带站点链接 （PUBLIC_BASE_URL 是内网地址，手机上打不开）。 3. 栏目名「接入」改名「机器人」；页面标题与提示文案同步。 pytest 151 passed；ruff check/format 干净；tsc 0；vite build 通过； web/e2e/integrations.mjs 7 项全绿。	2026-11-05 23:22:49 +08:00
Steven	8e3dc65cc6	fix(integrations): 上游扫码状态叫 wait，页面认的是 waiting，先对齐再翻	2026-11-05 23:06:57 +08:00
Steven	8436c0edbf	feat(integrations): 微信要先扫码配对，改成 iLink 扫码登录 + 长轮询 ... 上一版按"webhook + URL 里带令牌"自己编了一套，用户当场指出微信必须先扫码配对。 现在照腾讯 iLink Bot 协议自己做客户端：取二维码 → 手机扫码确认 → 存加密登录态 → 后端长轮询收消息 → 用 context_token 回话。独立实现，不依赖 DSH 的运行环境。 后端 - wechat_ilink.py：get_bot_qrcode / get_qrcode_status / getupdates / sendmessage， bot_token 用 Fernet（密钥由 JWT_SECRET 派生）加密入库，日志与接口都不回明文 - wechat_intake.py：一句话 → 任务或知识草稿，前缀识别、#标签、首行标题 - wechat_bot.py：每条通道一个轮询任务，启动时按 status='active' 恢复； message_id 去重；errcode -14 转 expired 让用户重新扫 - api/integrations.py 重写成扫码三接口 + 停用/断开/最近消息 - 迁移 0013（登录态列）、0014（轮询入口按 app.bot_channel 主键的 RLS 口子） Web - 接入页改成扫码流程：页面里画出二维码、每 2 秒问一次状态、连上显示微信用户与最近消息 验证 - pytest 149 passed（新增 test_wechat_bot 9 例） - ruff check / ruff format --check 干净；tsc 0；vite build ✓ - web/e2e/integrations.mjs 7 项 ALL PASS（拿的是微信真二维码） 教训：接入第三方协议先去已有实现里找协议，别从直觉倒推。	2026-11-05 23:03:18 +08:00
Steven	b5170ad1ce	feat(auth): 邮箱验证码注册，生产重新有了自助入口 ... 短信登录关掉后，生产没有任何注册入口——这一版补上最普通的那条路： 填邮箱、收验证码、设密码，注册完直接进首页。 先发码再注册，不是"注册时顺带发信" POST /auth/email/code 只做三件事：查重、限流、发码。 填完密码才被告知"这个邮箱注册过了"最气人，所以占用（2019）在发码前就回。 邮箱既是账号名也是唯一联系方式，所以必须真验一次码 验证通过时间落 app_user.email_verified_at，/auth/me 回 email_verified。 "随手填一个"会让账号变成没人能找回的孤岛。 app_user.phone 改为可空（迁移 0011） 邮箱注册的账号本来就没有手机号。user.phone 对这类账号回空串， 成员列表同理，不再伪装成一串星号。 防刷 同邮箱 60 秒一次（2022）、验证码 10 分钟有效、错 5 次即作废（2021）。 6 位数可以被刮，不设上限等于把注册口子交给脚本。 本机联调开关 EMAIL_CODE_DEV_ECHO 为 true 时把码回给调用方且不发真信——否则每跑一次 e2e 就往真实收件箱塞一封。 生产打开会让 validate_runtime() 拒绝启动。 前端 新增 /register（邮箱、验证码、密码、确认、昵称；60 秒倒计时； 服务端关着注册时整页只说"联系管理员开通"），登录页按 /auth/methods 决定要不要显示「还没有账号？用邮箱注册」。 验证 pytest 139 passed、ruff check / format 全绿 tsc --noEmit 0、vite build 通过 e2e register.mjs 7 项：登录页入口 → 拿码 → 注册落进首页 → 退出用邮箱+密码登回来 → 同一邮箱再发码回 2019 → 控制台零报错 e2e login-email-smtp.mjs 15 项回归通过（含真发一封测试信） e2e account.mjs 14 项、knowledge.mjs 全绿 顺带修的两处测试 test_account 的字段白名单补 email_verified（接口确实多了这个字段）； test_config_prod 用 Settings(_env_file=None, ...) 构造，别被本机 .env 里的 EMAIL_CODE_DEV_ECHO=true 带偏——那个开关在生产是硬错误，本机却是跑 e2e 必需的。	2026-11-03 01:04:26 +08:00
Steven	7558637567	feat(auth): 短信登录默认关，换成手机号/邮箱 + 密码，发信邮箱进后台 ... 用户要求：内测的固定验证码 123456 等于"知道手机号就能进任何账号"，先关掉； 登录改用账号密码，并多一种"邮箱当账号名"的方式；发信邮箱要能在后台改。 短信那条路（默认关）： - `SMS_LOGIN_ENABLED=false`，`/auth/sms/send` 与 `/auth/login` 统一回 2017，不是静默失败； - 生产校验改成"开着短信登录就必须配真通道"，不开时 provider 是 dev 也不拦； - 新增 `GET /auth/methods`，登录页据此渲染，关着的路不出现（少一次"点进去才发现不能用"）。 邮箱登录： - `app_user.email` + `uq_app_user_email`（`lower(email)` 部分索引），登录与绑定都归一成小写； - `POST /auth/login/password` 收 `phone` 或 `email`（二选一），失败统一 2013、连错 10 次锁 15 分钟； - 绑定在 `PATCH /auth/me`：格式错 2018、被占用 2019、留空串表示解绑。 系统设置（跨租户，只有平台管理员能改）： - 新表 `system_setting`（不挂租户、无 RLS，写权限由 `deps.platform_admin` 把关）； - `GET/PUT /settings/smtp`、`POST /settings/smtp/test`，授权码只写不读，留空表示沿用旧值； - `services/mail.py` 只用标准库 smtplib：465 走 SSL、587 走 STARTTLS，认证/拒收/网络失败都归 2020 但消息不同； - Web 新增「系统设置」页（状态卡 + 测试发信），侧栏只对平台管理员显示入口；账号页补「邮箱」。 验证：pytest 130 passed、ruff check/format 全绿、tsc 通过、vite build 通过； `web/e2e/login-email-smtp.mjs` 15 项全绿（含用 126 授权码真发一封测试邮件）。 顺带记下的两个坑：`platform_admin_phones` 是 list，pydantic-settings 会按 JSON 解析， 要用 `NoDecode` 交给 before-validator 拆逗号；迁移号写成 0009 会撞既有的 0009，一并改成 0010。	2026-11-03 00:00:11 +08:00
Steven	91b3dde670	feat(notify): 站内通知与手工开单，指派/改状态/评论/验收都有人收到 ... 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): 语义检索打通——切片、混合打分、只搜已发布 ... 之前知识只能"存"，不能"找"。这一版把链路补上：切片 → 向量 → 打分 → 带来源返回。 - 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): 安卓能编辑富文本了，图片直链换成短期签名，表格不再撑破抽屉 ... 三件欠账一次清： 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): 草稿的过程段写「收件箱 → 待办」，而不是两句「状态变更」 ... 自动生成的草稿里，时间线只查了 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