This commit is contained in:
zlwu committed 2026-08-13 14:31:57 +08:00
1 parent 0e1b750457
commit 8c49021d38
93 files changed
+22731 -12107

No files matched your search

@@ -0,0 +1,21 @@
# OA 附件:Vant 缩略图美化
> 状态:已确认(2026-08-13)
## 决策
保留 `van-uploader` 交互(格子预览、删除、非图点按下载、详情 disabled 无删除),仅美化样式:
1. 预览格 84px、14px 圆角、浅绿描边、轻阴影
2. 删除钮改为圆形半透明
3. 非图封面:类型色小图标 + 短文件名 + 品牌绿「点击下载」条(不展示「图片/PDF」标签)
4. 添加格:虚线框 + 绿色渐变 + 号
5. **详情只读**(`disabled` / form-create 禁用):不展示添加格、不展示右上角删除;附件仅可预览/下载
## Demo
`mobile-ui/zkxw-mobile-oa-attachment-actions-demo.html`
## 落点
`mobile-oa-h5/src/oa/components/OaUploadField.vue`
@@ -0,0 +1,24 @@
# OA 详情头区:去掉重复标题 + 状态印章
> 状态:已确认(2026-08-13)
## 背景
移动端 OA 详情(`mobile-oa-h5` `OaDetail`,经 `mobile-h5` web-view 打开)内容区顶部重复展示流程标题(顶栏已有),状态为胶囊 Tag,与 web 打印钉钉风印章不一致。
## 决策
1. **去掉**内容区顶部流程标题 `h1`(顶栏已展示)。
2. **状态 Tag 改为** web 打印同款钉钉风圆形印章(结构:外圈 / 上下弧 / `OA审批` / 主文案 / `approval`),`absolute` 叠在表单区域右上角,旋转约 `-18°`。
3. **尺寸 72px**(相对 web 打印 118px 明显缩小,遮挡更少)。
4. **文案/色类**复用 `resolveStamp(status)`(如 `completed` →「已通过」/`ok`)。
5. **范围**:`mobile-oa-h5` 详情页;列表页、关联审批弹层不在本次范围。
## 非目标
- 不改 web-admin 打印印章尺寸
- 不改移动端 PDF/系统打印 HTML 里的简化印章(仍为另一套实现)
## Demo
`mobile-ui/zkxw-mobile-oa-detail-header-stamp-demo.html`
@@ -0,0 +1,70 @@
# 待办中心 · 批量通过 / 打回
| 项 | 内容 |
|----|------|
| 状态 | 已确认 |
| 日期 | 2026-08-13 |
| 范围 | `mobile-h5` 待办中心列表页批量审批 |
| Demo | `mobile-ui/zkxw-mobile-oa-pending-batch-actions-demo.html` |
| 对齐 | 草稿箱自定义顶栏「管理」;抄送多选 / 批量栏交互 |
---
## 1. 目标
在移动端「待办中心」支持勾选多条待办,**批量通过**与**批量打回**,减少逐条进入详情审批的操作成本。
## 2. 非目标
- 不做批量拒绝(降低误操作风险)
- 不新增后端批量 approve/return API(本期前端串行调用现有单条接口)
- 不做跨页 / 全库全选
- 不改造 web-admin 待办页
## 3. 交互(SHALL)
### 3.1 顶栏
- 待办页使用 **自定义导航栏**(`navigationStyle: custom`),结构对齐草稿箱:
- 左侧返回、居中标题「待办中心」、右侧「管理」/「完成」
- 搜索区仅保留关键词检索,**不**再放管理按钮
### 3.2 管理态
- 点「管理」进入多选;点「完成」退出并清空勾选
- 管理态卡片左侧圆形勾选;选中卡片描边高亮
- 管理态点卡片 = 切换勾选;非管理态点卡片 = 进入审批详情(现有 webview)
- 已勾选时展示批量栏:「已选 N 项」+「批量打回」+「批量通过」
- 未勾选时批量按钮禁用或隐藏批量栏(与 Demo 一致:无勾选则不展示栏)
### 3.3 意见弹层
| 动作 | 标题 | 默认意见 | 校验 |
|------|------|----------|------|
| 批量通过 | 批量通过 | 「同意」 | 可改、可空(与单条同意一致) |
| 批量打回 | 批量打回 | 空 | **必填**,否则 toast「打回意见必填」 |
弹层提示:将对 N 条待办执行操作。同一意见应用于本次选中的全部任务。
### 3.4 提交与结果
- 对选中 `taskId` **串行**调用:
- 通过:`POST /web/admin/oa-approval/tasks/{id}/approve`
- 打回:`POST /web/admin/oa-approval/tasks/{id}/return`
- 结束后 toast 汇总:`成功 n,失败 m`(若全部成功可用更短文案如「已通过 n 条」)
- 成功后退出管理态、清空勾选、刷新列表
## 4. 实现要点
- API 封装:`mobile-h5/utils/oa-api.js` 增加 `fetchApproveOaTask` / `fetchReturnOaTask`
- 页面:`mobile-h5/pages/oa/pending/index.vue`(顶栏、多选、批量栏、意见弹层)
- 路由:`mobile-h5/pages.json` 待办页 `navigationStyle: custom`
- 视觉 Token:三墙绿 `#0a9f6d` 等,对齐现有草稿箱 / 抄送页
## 5. 验收
1. 标题栏有「管理」,搜索区无管理按钮
2. 管理态可勾选多条,批量通过默认「同意」且可空提交
3. 批量打回空意见被拦截
4. 部分失败时提示成功/失败数,列表刷新
5. 非管理态点卡片仍进审批详情
@@ -0,0 +1,26 @@
# OA 撤销后进度展示(方案 B)
> 日期:2026-08-13
> Demo:`mobile-ui/zkxw-mobile-oa-progress-withdraw-cancelled-demo.html` 方案 B
> 关联:`docs/superpowers/specs/2026-07-15-oa-approval-progress-timeline-design.md`
> 打印:`web-admin` `buildFlowItems` / 移动端 `exportOaApprovalPdf.buildFlowItems` 须同映射
## 问题
发起人撤销后,引擎将待办任务置为 `cancelled`。进度轴把该状态直接展示为「已撤销」,误挂在「直接主管」等未审批节点上,语义像「主管撤销」。打印 PDF「审批流程」区同样存在该问题。
## 决策(方案 B)
| 位置 | 展示 |
|------|------|
| 任务 `status=cancelled`(清待办) | 节点徽章/打印头「无需处理」、人员行「无需处理」、mute、**不展示时间**(对齐或签 `done`) |
| 实例终态 `kind=terminal` + `cancelled` | 标题/徽章「已撤销」;人员为发起人 + 文案「发起人撤销」+ 撤销时间 |
| 库表 | **不改**:任务仍存 `cancelled`,仅投影/前端映射调整 |
打回时其它人的 `cancelled` 任务同样映射为「无需处理」;打回结论仍落在操作人任务节点。
## 非目标
- 不隐藏已到达的主管节点(方案 C)
- 不改撤回/打回写库逻辑
- 实例印章「已撤销」、列表「已撤销」不变