Tatta/DadaoTask
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
23 Commits 2 Branches 0 Tags
c94e0424ed3b9ca9ae1f0e17920a0d8bae142b39
Commit Graph
23 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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 aa396f2c26 docs(ui): 记录界面重做（第 4 节）、更新状态表与安卓截图
CI / backend (push) Canceled after 0s
Details 
- ROADMAP 新增「4. 界面重做」：设计系统、Web、安卓三段逐项打勾，
  并写明没做事的原因（深色模式、无障碍审计、安卓离线缓存、看板拖拽）
- README 状态表：安卓改为五个页面已跑通，新增"界面"一行
- 2.Design/screens/ 补安卓首页、任务、看板、详情、工单、知识、成员七张截图
 2026-10-28 18:37:35 +08:00
dadao 52ec6474a9 feat(android): 设计系统与五个页面重做，并补齐升级工单、邀请、看板 
此前安卓只到"能登录、能看列表"，且从没编译过。这轮把它做到与 Web 同构：

- Theme.kt 与 Tailwind 同一套色板与字号阶；新增 Widgets.kt（状态 pill、
  卡片、按钮、头像、空态、时间与 action 的中文映射、错误码文案）
- 新增 AppFrame.kt（顶栏工作区 + 未读角标 + 底部四 tab）与
  TaskDetailSheet / BoardScreen / MembersScreen
- 重写任务、工单、知识三页与登录、首页；任务详情里补上「升级成工单」
  和「沉淀成知识」——这两个入口此前只有 Web 有，是真正的功能欠账
- 看板不做拖拽：一列已占 76% 屏宽，拖拽命中率太差，改为点卡片选目标列
- 修运行期 bug：workspaces/members 按 List 解析而服务端返回 {items:[...]}；
  消息区被手势条遮挡；升级工单候选人里出现自己；priority=0 显示"无"
- android/scripts/emulator.ps1 固化构建+装机+起模拟器；assembleDebug 出 APK

已在 API 35 模拟器上逐页跑通并截图（见 2.Design/screens/android-*.png）。
 2026-10-28 18:37:35 +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 f683436689 feat(android): 安卓端第一次真跑起来，修两个联调才暴露的解析 bug
CI / backend (push) Canceled after 0s
Details 
上一轮只是"能编译"。这一轮在模拟器上真装了、真登录、真点了，才发现两个问题：

1. workspaces() / members() 直接按 List 解析，但服务端列表接口返回的是
   {"items": [...]}。表现就是登录成功后首页红字「响应格式异常（HTTP 200）」，
   而且工作区永远显示为空。新增 WorkspacePage / MemberPage 容器类型。
2. 之前 Api.kt 的请求体全是没加 @Serializable 的普通 data class（上一提交已修），
   这次把成员/工作区的解析也按同样思路收口。

环境侧（写进 android/README + 新增 android/scripts/emulator.ps1）：
- sdkmanager 拉不到远端索引，系统镜像是直连 dl.google.com 手动装的；
  压缩包里多一层 x86_64/，要把内容提上一层，否则 AGP 找不到 system.img
- AVD 放工程内（~/.android 受限不可写），建 AVD 与启动都靠 ANDROID_USER_HOME / ANDROID_AVD_HOME
- 无头启动要 -no-window -gpu swiftshader_indirect
- 点按坐标要拿 uiautomator dump 的 bounds，别拿降采样截图猜
- adb shell input text 打不了中文（NPE），中文数据走接口或直接写库

验证（模拟器 API 35，连 fnsvr-01 的真库）：
登录 → 建工作区 ShipFast → 任务列表显示 4 条中文任务（状态、截止日都对）
→ 勾选完成，条目从「进行中」消失（乐观锁生效）→ 工单页、知识页均正常渲染。
截图放进 2.Design/screens/android-{login,tasks}.png。
 2026-10-28 17:04:35 +08:00
dadao 17adaca766 chore(git): 别把 kotlin 编译日志入库
CI / backend (push) Canceled after 0s
Details 
android/.kotlin/errors/*.log 是编译器诊断输出，跟着构建变；加 ignore 并移出索引。
 2026-10-28 15:36:05 +08:00
dadao 4565fad255 chore(android): 让安卓端第一次真正编译出 APK
CI / backend (push) Canceled after 0s
Details 
之前安卓代码一行都没编译过，这次从零把编译链搭起来，第一遍编译就炸了 5 处。

代码 bug（5 个）：
- Api.kt 的 SmsRequest/LoginRequest/WorkspaceCreateRequest/RefreshRequest 都没加
  @Serializable，json.encodeToString(x) 于是匹配到 encodeToString(strategy, value) 重载，
  报 "SerializationStrategy<T> expected" + "No value passed for parameter 'value'"
- 三处 mapOf/buildMap 拼请求体（Map<String, Any>）没法序列化，全换成具名 @Serializable 请求类
- ticketAction 的 body 参数从 Map<String, Any> 改成 String，避免把序列化责任散在调用方
- KnowledgeScreen 的 Card(Modifier, onClick=…) 命中无点击的重载，参数重名报错，
  改成 Card(onClick=…, modifier=…)
- 补 import kotlinx.serialization.encodeToString

环境固化（写进仓库，附理由注释，避免下次重踩）：
- gradle.properties 加 kotlin.compiler.execution.strategy=in-process
  （受限环境里 Kotlin 编译守护进程连不回来）
- settings.gradle.kts 先走阿里云镜像再回落 google()/mavenCentral()，依赖下载从 5 分钟 2MB 变 90 秒 94MB
- 工程内 debug keystore（android/keystore/debug.keystore）+ app/build.gradle.kts 显式指向
  （受限用户对 ~/.android 无写权限，用系统默认 debug.keystore 会 AccessDenied）
- app/src/debug/AndroidManifest.xml 给 debug 变体放开明文 HTTP：
  真机连 http://192.168.8.x:8100 需要它，release 仍受 network_security_config 白名单约束
- android/README.md 换成实测过的构建/安装说明 + 坑表

结果：BUILD SUCCESSFUL，app-debug.apk 9.94 MB。
未验证：本机没有 system-image、也没连设备，所以只到"能编译、能装"，没跑过界面。
 2026-10-28 15:35:47 +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 07688881b4 docs(m3): 补知识接口契约、M3 清单与状态表
CI / backend (push) Canceled after 0s
Details 
- API.md 新增第 5 节：列表/详情/手记/改内容/状态动作/从事项沉淀 + 7xxx 错误码
- ROADMAP 增 M3 全节与 DOD，验收用例补 11–13，明确 3.8 向量索引未跑
- README 状态表：知识已通、pgvector 只有配置
- DEVELOPMENT 补三条 e2e 命令与「先想一条能失败的断言」
 2026-10-28 14:03:10 +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 600131dcf5 docs(m2): 补工单接口契约、M2 清单与状态表
CI / backend (push) Canceled after 0s
Details 
- API.md 新增第 4 节：升级/动作/列表/关系/通知与 6xxx 错误码
- ROADMAP 补 M2 全部条目与 DOD，验收用例加自验与回流两条
- DEVELOPMENT 记两条新坑：PowerShell 批量改写会毁中文、npm.ps1 被执行策略拦
- README 状态表把工单从待做改成已通，测试数 57
 2026-10-28 13:20:31 +08:00
dadao fd18b2a403 feat(android): 工单列表与动作，任务页可进工单 
- Api 增 tickets/ticketAction/verifyTicket/promote，状态机交给服务端，客户端只发动作
- TicketsScreen：派给我的 / 我发起的、按状态给接收/开始/提交/通过/驳回、6004 与 6003 给出人话提示
- 仍未编译验证（本机无 JDK/Gradle），见 android/README.md
 2026-10-28 13:20:31 +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 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 3d02fe845a docs+chore: M1 状态校准、向量库独立实例、gitignore 修复
CI / backend (push) Canceled after 0s
Details 
- ROADMAP：勾选与实际证据一一对应，未做的写明原因与去向（通知推迟到 M2、子任务与 @人 合并进 item_link）
- DEVELOPMENT：新增向量库、e2e、性能实测三节
- API：补批量状态与看板接口，重排小节编号
- deploy：docker-compose.vector.yml + vector-init（独立 PG+pgvector，5434，不碰 fnsvr-01）
- .gitignore：注释乱码修正，补 *.tsbuildinfo / e2e 产物
 2026-10-28 04:05:47 +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
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 b40ea77eec docs(m0): 用实测结果重写 M0 清单 + 补 PR 模板
CI / backend (push) Canceled after 0s
Details 
- 0.1–0.9 全部标为完成，但不是"代码写完"就算完成：
  33 条测试全绿、ruff/format 通过、真机 uvicorn 冒烟（/health /version 登录 建工作区 列表 /auth/me）通过
  之后才敢打勾；没跑过的（downgrade、mypy、CI 在 Gitea 实跑、Web/Android 联调）保持未勾并写明原因。
- 记录 5 处"计划与实际不符"的偏差及理由：
  JWT 30min/14d、refresh 无状态不可撤销、权限用 ROLE_RANK 而非 PERMISSIONS 字典、
  app_user 故意不加 RLS（登录发生在租户绑定之前）、minio 与 pgvector 推迟到 M3。
- 新增「环境现状与阻塞」一节：Docker 起不来用便携 PG、外网 TLS 被拦走 HTTP 镜像、
  pip 必须 --no-cache-dir（否则写缓存卡死）、pg_ctl restricted token 报错、fnsvr-01 只有 8418/3306。
- 验收用例表加"现状"列，区分已验证 / 部分 / 未做。

顺带修：
- alembic downgrade 之前直接失败：workspace 的 RLS 策略引用了 member，
  不先 DROP POLICY 就 drop table，报 "cannot drop table member because other objects depend on it"。
  现已按策略先删后删表，downgrade base → upgrade head 全通。
- npm 依赖必须 --ignore-scripts 才能装（沙箱禁止 lifecycle 脚本派生进程），
  已写进 DEVELOPMENT.md；web 首次构建成功（tsc -b + vite，177KB/gzip 58KB）。

验收：pytest 33 passed / ruff 干净 / alembic 升降级往返通过 / web build 通过。
 2026-10-28 03:28:06 +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