- ROADMAP:勾选与实际证据一一对应,未做的写明原因与去向(通知推迟到 M2、子任务与 @人 合并进 item_link) - DEVELOPMENT:新增向量库、e2e、性能实测三节 - API:补批量状态与看板接口,重排小节编号 - deploy:docker-compose.vector.yml + vector-init(独立 PG+pgvector,5434,不碰 fnsvr-01) - .gitignore:注释乱码修正,补 *.tsbuildinfo / e2e 产物
This commit is contained in:
+32
-3
@@ -173,18 +173,47 @@ canceled→ todo (恢复)
|
||||
**前端可以据此直接渲染"下一步能点什么",不用自己维护一份规则。**
|
||||
目标状态与当前相同:直接返回,版本号不变。
|
||||
|
||||
### 3.5 `DELETE /items/{item_id}?version=3`
|
||||
### 3.5 `POST /items/batch-status`(看板多选拖拽)
|
||||
|
||||
```json
|
||||
{ "status": "done",
|
||||
"items": [{ "id": "…", "version": 3 }, { "id": "…", "version": 7 }] }
|
||||
```
|
||||
|
||||
```json
|
||||
{ "updated": [{ "id": "…", "version": 4, "unchanged": false }],
|
||||
"failed": [{ "id": "…", "code": 4009, "message": "…", "current_version": 8 }] }
|
||||
```
|
||||
|
||||
- **不是全成功或全回滚**:拖 10 条里有 1 条被同事改过,其余 9 条照样生效。
|
||||
全回滚会让用户白干一次,而且更难解释"为什么什么都没变"。
|
||||
- 单次最多 50 条;`failed[].code` 只会是 `4009`(版本冲突)、`5002`(状态不允许)、`5001`(不存在)。
|
||||
- 已经是目标状态的条目返回 `unchanged: true`,计入 `updated` 但不产生事件。
|
||||
|
||||
### 3.6 `GET /items/board`(看板一屏数据)
|
||||
|
||||
```json
|
||||
{ "columns": { "todo": [...], "doing": [...], "blocked": [...], "done": [...] },
|
||||
"order": ["todo", "doing", "blocked", "done"],
|
||||
"labels": { "todo": "待办", "doing": "进行中", "blocked": "被阻塞", "done": "已完成" } }
|
||||
```
|
||||
|
||||
- 每列默认 30 条(`per_column` 1–100),按"截止早的在前、无截止靠后",再按更新时间。
|
||||
- **收件箱不在看板上**:没归类的东西不该占着"正在做的事"的位置。
|
||||
- 一次请求拿全,避免拖拽时四列数据不同步。
|
||||
|
||||
### 3.7 `DELETE /items/{item_id}?version=3`
|
||||
|
||||
软删(写 `deleted_at`),只在 `view=deleted` / `include_deleted=true` 时可见。
|
||||
|
||||
### 3.6 评论
|
||||
### 3.8 评论
|
||||
|
||||
| 方法 | 路径 | 说明 |
|
||||
|---|---|---|
|
||||
| GET | `/items/{item_id}/comments` | 时间正序,游标分页 |
|
||||
| POST | `/items/{item_id}/comments` | `{body_md}` |
|
||||
|
||||
### 3.7 标签 `/workspaces/{ws_id}/tags`
|
||||
### 3.9 标签 `/workspaces/{ws_id}/tags`
|
||||
|
||||
| 方法 | 路径 | 说明 |
|
||||
|---|---|---|
|
||||
|
||||
Reference in New Issue
Block a user