docs: add plan for hiding collector staff UI

Break down protocol/donation hide, presign rename to 市场专员, and silent collectorUserId write rules into TDD tasks.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/superpowers/plans/2026-10-16-hide-collector-staff-ui.md

@@ -0,0 +1,415 @@
+# 隐藏「采集专员」可见 UI（预签改名）— Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 协议单/科研捐赠/缴费确认时间线等隐藏用户可见「采集专员」；预签全链路文案改为「市场专员」；`collectorUserId` 静默保留（新建默认当前用户，编辑不清空）。
+
+**Architecture:** 纯前端展示层改动。移动协议表单对 `collectorUserId` 使用已有 `hidden: true` 模式（不渲染但仍进表单状态与 payload）；Web 去掉选择器 DOM，保留 `formData.collectorUserId` 回填与提交。预签只改可见 label/title/提示语，字段名不变。后端与转正式映射不动。
+
+**Tech Stack:** Vue 3 + Element Plus（web-admin）；Vue 3 + Vant（mobile-oa-h5）；`node:test`（mobile-oa-h5）
+
+**Spec:** `docs/superpowers/specs/2026-10-16-hide-collector-staff-ui-design.md`
+
+---
+
+## File map
+
+| 文件 | 职责 |
+|------|------|
+| `mobile-oa-h5/src/market/modules/protocol.js` | 协议/捐赠详情去掉采集专员行；表单字段 `hidden: true` |
+| `mobile-oa-h5/src/market/list-presenter.js` | 协议列表卡去掉采集专员字段 |
+| `mobile-oa-h5/src/market/modules/presign.js` | 预签详情 label → 市场专员 |
+| `mobile-oa-h5/src/market/presign/presign-list-model.js` | 预签列表/详情字段 label → 市场专员 |
+| `mobile-oa-h5/src/views/market/presign/PresignOrderForm.vue` | 表单 label / 选择器 title → 市场专员 |
+| `mobile-oa-h5/src/market/*.test.js` 等 | 同步断言 |
+| `web-admin/.../protocol/ProtocolFormDialog.vue` | 去掉采集专员表单项；保留静默写入 |
+| `web-admin/.../protocol/ProtocolViewDialog.vue` | 详情去掉采集专员 |
+| `web-admin/.../protocol/index.vue` | 列表去掉采集专员列 |
+| `web-admin/.../research-donation/list/*` | 捐赠表单/列表/详情同上 |
+| `web-admin/.../clinical-payment-confirm-timeline/index.vue` | 去掉采集专员展示 |
+| `web-admin/.../presign-order/PresignOrderFormDialog.vue` | label → 市场专员 |
+| `web-admin/.../presign-order/index.vue` | 转正式确认文案改写 |
+
+---
+
+### Task 1: mobile-oa-h5 — 协议表单/详情隐藏采集专员（TDD）
+
+**Files:**
+- Modify: `mobile-oa-h5/src/market/module-contracts.test.js`
+- Modify: `mobile-oa-h5/src/market/mobile-parity-ui.test.js`（若有「采集专员」可见断言）
+- Modify: `mobile-oa-h5/src/market/modules/protocol.js`
+- Modify: `mobile-oa-h5/src/market/list-presenter.test.js`
+
+- [ ] **Step 1: 改测试 — 表单字段 hidden；详情/列表不再含「采集专员」**
+
+在 `module-contracts.test.js` 把人员 optionKey 测试改为：
+
+```js
+test('protocol personnel fields use isolated hydrated option collections', () => {
+  const fields = getMarketModule('protocol').formSections.flatMap((section) => section.fields)
+  const collector = fields.find((field) => field.key === 'collectorUserId')
+  assert.equal(collector.optionKey, 'collectorStaff')
+  assert.equal(collector.hidden, true)
+  assert.equal(fields.find((field) => field.key === 'salesUserId').optionKey, 'salesStaff')
+  assert.equal(fields.find((field) => field.key === 'regionManagerUserId').optionKey, 'managerStaff')
+})
+```
+
+在 `list-presenter.test.js`：删除或改写 `field.label === '采集专员'` 的断言（列表卡不应再有该 label）。
+
+在 `module-contracts.test.js` / 详情相关测试：若断言详情含「采集专员」，改为 assert 找不到该 label。
+
+- [ ] **Step 2: 跑测试确认失败**
+
+```bash
+cd mobile-oa-h5 && node --test \
+  src/market/module-contracts.test.js \
+  src/market/list-presenter.test.js
+```
+
+Expected: FAIL（`hidden` 未定义或仍存在「采集专员」字段）
+
+- [ ] **Step 3: 实现 — protocol 模块**
+
+`modules/protocol.js`：
+
+1. 详情 `fields` 中删除：
+   `{ label: '采集专员', value: person(...) }`
+2. 表单改为：
+   `{ key: 'collectorUserId', label: '采集专员', type: 'select', optionKey: 'collectorStaff', hidden: true }`
+
+`list-presenter.js`：删除
+`field('采集专员', personName(...))` 这一行。
+
+**勿改** `protocol-form-defaults.js` 的默认当前用户逻辑。
+
+- [ ] **Step 4: 再跑测试**
+
+```bash
+cd mobile-oa-h5 && node --test \
+  src/market/module-contracts.test.js \
+  src/market/list-presenter.test.js \
+  src/market/protocol-form-defaults.test.js
+```
+
+Expected: PASS（含新建默认 `collectorUserId` 仍为当前用户）
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add mobile-oa-h5/src/market/modules/protocol.js \
+  mobile-oa-h5/src/market/list-presenter.js \
+  mobile-oa-h5/src/market/module-contracts.test.js \
+  mobile-oa-h5/src/market/list-presenter.test.js \
+  mobile-oa-h5/src/market/mobile-parity-ui.test.js
+git commit -m "$(cat <<'EOF'
+fix(mobile-oa-h5): hide collector staff on protocol UI
+
+Keep collectorUserId in form state as a hidden field with create defaults.
+EOF
+)"
+```
+
+---
+
+### Task 2: mobile-oa-h5 — 预签文案改为「市场专员」（TDD）
+
+**Files:**
+- Modify: `mobile-oa-h5/src/market/presign/presign-list-model.test.js`
+- Modify: `mobile-oa-h5/src/market/module-contracts.test.js`（若有预签「采集专员」断言）
+- Modify: `mobile-oa-h5/src/market/presign/presign-list-model.js`
+- Modify: `mobile-oa-h5/src/market/modules/presign.js`
+- Modify: `mobile-oa-h5/src/views/market/presign/PresignOrderForm.vue`
+- Modify: `mobile-oa-h5/src/market/mobile-parity-ui.test.js`（预签相关文案）
+
+- [ ] **Step 1: 改测试期望 label 为「市场专员」**
+
+`presign-list-model.test.js` 示例：
+
+```js
+{ key: 'collectorUserName', label: '市场专员', value: '采集员甲' },
+```
+
+`module-contracts.test.js` 中预签详情若有：
+`field.label === '采集专员'` → `'市场专员'`。
+
+- [ ] **Step 2: 跑测确认失败**
+
+```bash
+cd mobile-oa-h5 && node --test \
+  src/market/presign/presign-list-model.test.js \
+  src/market/module-contracts.test.js
+```
+
+Expected: FAIL（实际仍是「采集专员」）
+
+- [ ] **Step 3: 实现改名**
+
+1. `presign-list-model.js`：`label: '采集专员'` → `label: '市场专员'`
+2. `modules/presign.js`：详情 `{ label: '采集专员', ...}` → `{ label: '市场专员', ...}`
+3. `PresignOrderForm.vue`：
+   - `<label>采集专员</label>` → `<label>市场专员</label>`
+   - `title="选择采集专员"` → `title="选择市场专员"`
+4. **不要**把 `form.collectorUserId` / `v-model` 改成 `salesUserId`
+
+- [ ] **Step 4: 再跑测试**
+
+```bash
+cd mobile-oa-h5 && node --test \
+  src/market/presign/presign-list-model.test.js \
+  src/market/module-contracts.test.js \
+  src/market/presign/presign-form-view.test.js \
+  src/market/mobile-parity-ui.test.js
+```
+
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add mobile-oa-h5/src/market/presign \
+  mobile-oa-h5/src/market/modules/presign.js \
+  mobile-oa-h5/src/views/market/presign/PresignOrderForm.vue \
+  mobile-oa-h5/src/market/module-contracts.test.js \
+  mobile-oa-h5/src/market/mobile-parity-ui.test.js
+git commit -m "$(cat <<'EOF'
+fix(mobile-oa-h5): rename presign collector label to 市场专员
+
+Keep collectorUserId for convert-to-protocol mapping.
+EOF
+)"
+```
+
+---
+
+### Task 3: web-admin — 采集协议单隐藏采集专员
+
+**Files:**
+- Modify: `web-admin/src/views/cell-storage/protocol/ProtocolFormDialog.vue`
+- Modify: `web-admin/src/views/cell-storage/protocol/ProtocolViewDialog.vue`
+- Modify: `web-admin/src/views/cell-storage/protocol/index.vue`
+
+- [ ] **Step 1: 表单 — 删除「采集专员」`el-form-item` 模板块**
+
+在 `ProtocolFormDialog.vue` 删除约：
+
+```vue
+<el-form-item label="采集专员" prop="collectorUserId">
+  <el-select v-model="collectorUserId" ...>...</el-select>
+</el-form-item>
+```
+
+**必须保留：**
+
+- `formData.collectorUserId`
+- 新建时 `collectorUserId.value = uid` / `formData.collectorUserId = uid`
+- 编辑回填 `formData.collectorUserId = String(prot.collectorUserId || ...)`
+- 提交 `collectorUserId: formData.collectorUserId || ''`（编辑路径依赖已回填的非空值）
+
+可删除仅服务于该选择器的 `remoteSearchCollectorUsers` / `onCollectorUserChange` 及模板用的 `collectorUserId` ref（若删除 ref，确保提交只读 `formData.collectorUserId`）。若一时不好拆，允许保留死代码，但模板不得再渲染选择器。
+
+- [ ] **Step 2: 列表 — 删除采集专员列**
+
+`protocol/index.vue` 删除：
+
+```vue
+<el-table-column
+  prop="collectorUserName"
+  label="采集专员"
+  ...
+/>
+```
+
+- [ ] **Step 3: 详情 — 删除采集专员 data-item**
+
+`ProtocolViewDialog.vue` 删除：
+
+```vue
+<div class="data-item"
+  ><div class="data-label">采集专员</div
+  ><div class="data-value">{{ collectorDisplay }}</div></div
+>
+```
+
+`collectorDisplay` computed 若无其它引用可删；仅被该处使用则一并清理。
+
+- [ ] **Step 4: 手工检查清单（本任务）**
+
+- 新增协议：Network 请求体含非空 `collectorUserId`（当前用户）
+- 编辑已有协议：保存后 `collectorUserId` 与打开前一致（不为空串清空）
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add web-admin/src/views/cell-storage/protocol/ProtocolFormDialog.vue \
+  web-admin/src/views/cell-storage/protocol/ProtocolViewDialog.vue \
+  web-admin/src/views/cell-storage/protocol/index.vue
+git commit -m "$(cat <<'EOF'
+fix(web-admin): hide collector staff on collection protocol UI
+
+Retain silent collectorUserId defaults and edit hydration.
+EOF
+)"
+```
+
+---
+
+### Task 4: web-admin — 科研捐赠隐藏采集专员
+
+**Files:**
+- Modify: `web-admin/src/views/research-donation/list/DonationFormDialog.vue`
+- Modify: `web-admin/src/views/research-donation/list/DonationViewDialog.vue`
+- Modify: `web-admin/src/views/research-donation/list/index.vue`
+
+- [ ] **Step 1: 与 Task 3 同模式**
+
+- 表单：去掉「采集专员」`el-form-item`；保留 `formData.collectorUserId` 默认当前用户与编辑回填；提交继续带该字段（`DonationFormDialog` 现为 `collectorUserId: formData.collectorUserId || undefined` — 编辑时必须已回填，避免 `undefined` 漏传导致后端未更新；新建靠默认 uid）
+- 列表：删 `label="采集专员"` 列
+- 详情：删「采集专员」data-item
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add web-admin/src/views/research-donation/list/
+git commit -m "$(cat <<'EOF'
+fix(web-admin): hide collector staff on research donation UI
+EOF
+)"
+```
+
+---
+
+### Task 5: web-admin — 缴费确认时间线 + 全仓可见文案扫尾
+
+**Files:**
+- Modify: `web-admin/src/components/business/clinical-payment-confirm-timeline/index.vue`
+- 按需修改其它生产代码中用户可见「采集专员」（**排除**预签、Demo HTML、docs）
+
+- [ ] **Step 1: 时间线去掉采集专员**
+
+删除：
+
+```vue
+<dt>采集专员</dt>
+<dd>{{ dash(detail?.collectorUserName) }}</dd>
+```
+
+- [ ] **Step 2: 扫尾 grep**
+
+```bash
+rg '采集专员' web-admin/src mobile-oa-h5/src --glob '!**/demo*' -n
+```
+
+Expected 残留仅允许：
+
+- 预签相关文件中已改为「市场专员」后不应再有「采集专员」用户文案
+- 代码注释（可选清理）
+- 若发现其它生产 UI 文案，一并隐藏
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add web-admin/src/components/business/clinical-payment-confirm-timeline/index.vue
+# 加上 Step 2 扫到的其它生产文件
+git commit -m "$(cat <<'EOF'
+fix(web-admin): remove collector staff from payment confirm timeline
+EOF
+)"
+```
+
+---
+
+### Task 6: web-admin — 预签改名为「市场专员」
+
+**Files:**
+- Modify: `web-admin/src/views/cell-storage/presign-order/PresignOrderFormDialog.vue`
+- Modify: `web-admin/src/views/cell-storage/presign-order/index.vue`
+
+- [ ] **Step 1: 表单 label**
+
+```vue
+<el-form-item label="市场专员">
+  <el-select v-model="form.collectorUserId" ...>
+```
+
+placeholder 若写「请选择采集专员」一并改为「请选择市场专员」。
+
+- [ ] **Step 2: 转正式确认文案**
+
+`index.vue` 现文案：
+
+```text
+确认转为正式采集协议单？将带入采集专员/市场专员/地区经理；...
+```
+
+改为避免「采集专员」用户文案，例如：
+
+```text
+确认转为正式采集协议单？将带入市场专员（同步为正式单采集专员与市场专员）/地区经理；意向金通过预签订单关联在正式单中展示（与预签同一数据，不自动写入样本缴费）。
+```
+
+或更短：
+
+```text
+确认转为正式采集协议单？将按预签「市场专员」与地区经理带入正式单人员；意向金通过预签订单关联在正式单中展示（与预签同一数据，不自动写入样本缴费）。
+```
+
+- [ ] **Step 3: 确认列表/详情无「采集专员」列**（当前 `presign-order/index.vue` 无该列则跳过）
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add web-admin/src/views/cell-storage/presign-order/
+git commit -m "$(cat <<'EOF'
+fix(web-admin): rename presign collector label to 市场专员
+EOF
+)"
+```
+
+---
+
+### Task 7: 验收与图谱
+
+- [ ] **Step 1: 自动化**
+
+```bash
+cd mobile-oa-h5 && node --test src/market/**/*.test.js src/market/presign/**/*.test.js
+```
+
+Expected: PASS（或仅与本次无关的既有失败；本改动相关文件必须绿）
+
+- [ ] **Step 2: 手动冒烟**
+
+1. Web 新增协议 / 捐赠：请求含 `collectorUserId` = 当前用户；界面无「采集专员」
+2. Web 编辑协议：保存后该字段不变
+3. Web/移动预签：界面为「市场专员」，提交仍是 `collectorUserId`；转正式人员映射与改前一致
+4. 缴费确认时间线无「采集专员」
+
+- [ ] **Step 3: 更新 graphify（若改了 web-admin / 有前端结构变动）**
+
+```bash
+./scripts/update-graph.sh frontend
+```
+
+- [ ] **Step 4: 最终 grep**
+
+```bash
+rg '采集专员' web-admin/src mobile-oa-h5/src -n
+```
+
+用户可见生产文案应为 0（注释除外）；预签应为「市场专员」。
+
+---
+
+## Spec coverage checklist
+
+| Spec 要求 | Task |
+|-----------|------|
+| 协议单隐藏表单/列表/详情 | 1, 3 |
+| 科研捐赠隐藏 | 1（移动详情同源）, 4 |
+| 时间线等外围隐藏 | 5 |
+| 预签改名「市场专员」、字段仍 collectorUserId | 2, 6 |
+| 新建默认当前用户 | 1（不改 defaults）、3/4 保留初始化 |
+| 编辑不清空 | 3/4 保留回填+提交 |
+| 不改后端/转正式映射 | 全任务不碰 backend |
+| 测试更新 | 1, 2, 7 |