feat(task): 材料规则界面（M1-04 前端）—— 动态收集要求在界面上真的能配了

发布任务的 5 项前置检查里有一项是「至少配一项必传材料」（40018）。
在这之前，管理员配材料要求**只能直接改数据库** —— 而"能动态设置收集要求"
正是本产品区别于"发个 Excel 让学生填"的核心。界面上没有它，这个能力等于不存在。
（task/index.vue 里那句「请到『材料规则』里配置…」也一直指着一个不存在的界面。）

新增：
  · apis/xt/material.ts —— 材料项接口 + 材料目录 + 枚举镜像
  · views/task/TaskMaterialDrawer.vue —— 列表 + 新增/编辑/删除 + 按模板初始化
  · task/index.vue 操作列加「材料规则」（草稿/收集中/已暂停三态），操作列 200→240px

四处刻意的设计：
  1. 选材料类型**自动带出默认值**（规范名、别名、默认档位与份数）。
     让人手填这些，一是慢，二是必然填不一致 —— 而"档位选错"的后果是
     证件翻拍件被压糊、机构退回。实测：选「学信网备案表」自动带出
     别名（学信网/学历备案表/电子注册备案表）+ P4 + 1 份。
  2. **条件显示只给三选一**（所有学生/仅在校生/仅非在校生），不做通用规则构造器。
     实际业务只有一种需求：学籍表与工作证明按是否在校生互斥。给一个能拼任意条件的
     东西，用户拼出个永远为假的条件，表现是"学生那边根本不显示这一项"，
     而原因藏在一条没人在意的规则里。
  3. **编辑时锁死材料码**：它是 collect_file 的关联键（两者之间没有外键），
     改了码已上传的文件就成了孤儿 —— 静默丢材料。
  4. **收集中改动显式警告**：服务端允许改，但学生会立刻看到新要求，
     已传的材料可能因此出现新的问题项。

浏览器真点过：抽屉打开、模板初始化生成标准 4 项且**条件标签正确**
（学籍表=仅在校生、工作证明=仅非在校生）、新增的自动带默认值、保存成功。
typecheck 通过，改动文件 lint 0 错 0 警。

⭐ 顺带验证了一条完整链路：e2e-m3-submit.py 原先**写死了 IDCARD**，
   配上标准 4 项之后全红 —— 那说明脚本不够健壮（材料要求本来就是可配置的）。
   改成从表单接口读"当前学生看得见、且必传"的材料后：
     当前必传且有条件成立的：['IDCARD', 'PHOTO1', 'SCHOOL_ROLL']
     跳过（选传或条件不成立）：['WORK_PROOF']
   即：管理员配的「学籍表=仅在校生」→ 学生端正确隐藏工作证明 → 校验不误报缺失。
   **教训：E2E 不要写死业务配置。写死的那一刻，测试就从"验证行为"变成了
   "验证数据"，配置一变全红 —— 看起来像代码坏了。**

又修一处文档缺陷：《03-接口设计》§2.7 的 taskStatus 把 2 与 4 写反了
   （文档：2已暂停/3已截止/4已归档；代码与 DDL：2已截止/3已归档/4暂停）。
   按文档实现会把「暂停」和「截止」做反，而这两者语义差别很大
   （暂停可恢复、已提交照常审；截止不可逆）。

40018 的提示改为「请**点本行的**「材料规则」…」—— 顶层菜单里也有一个「材料规则」
   （里程碑占位页），不点明"本行"会把人引到那个占位页去。

验收：e2e-m3-submit.py 31/31；
回归 材料目录 68 / 材料上传 29 / 草稿 27 / 门禁 29 全绿。

docs/03-接口设计.md

@@ -248,7 +248,7 @@
 |---|---|
 | `userType` | `1` 平台运营 / `2` 学校管理员 / `3` 班主任 / `4` 学生 |
 | `roleCode` | `PLATFORM_ADMIN` / `SCHOOL_ADMIN` / `HEAD_TEACHER` / `DEPUTY_TEACHER` / `STUDENT` / `AUDITOR` |
-| `taskStatus` | `0` 草稿 / `1` 已发布 / `2` **已暂停** / `3` 已截止 / `4` 已归档 |
+| `taskStatus` | `0` 草稿 / `1` 收集中 / `2` 已截止 / `3` 已归档 / `4` **已暂停** （与后端 `CollectTask.STATUS_*` 及 DDL 列注释一致）|
 | `rosterSubmitStatus` | `0` 未提交 / `1` 已提交 / `2` 已通过 / `3` 已驳回 |
 | `fileValidateStatus` | `0` 待校验 / `1` 通过 / `2` 警告 / `3` 不通过 / `4` 待人工 |
 | `auditNode` | `1` 初审 / `2` 终审 |

docs/交接摘要.md

@@ -837,7 +837,7 @@ P4 写 M5 校验引擎时，我凭记忆用了一套 VAL 编号，**与 PRD 权
 
 ---
 
-## §一·十三　材料上传 + 提交校验（最新一轮，提交 `9911ff0`）
+## §一·十三　材料上传 + 提交校验（提交 `9911ff0`）
 
 ### 已完成的提交
 | 提交 | 内容 |
@@ -948,3 +948,86 @@ P4 写 M5 校验引擎时，我凭记忆用了一套 VAL 编号，**与 PRD 权
 4. 接入对象存储（**阻塞多副本部署**）
 5. 待办（非阻塞）：C1 小程序资质法务确认（**已明确会阻塞学生真正开始填报**）、
    C5 隐私声明法务文案、D1 OCR 引擎选型、D5 一寸照片阈值标定、D6 微信三通道体积上限真机实测
+
+
+---
+
+## §一·十四　材料规则界面（M1-04 前端）—— 动态收集要求在界面上真的能配了
+
+### 为什么先做这个
+发布任务的 5 项前置检查里有一项是「**至少配一项必传材料**」（`40018`）。
+在这一轮之前，管理员配材料要求**只能直接改数据库** —— 而"能动态设置收集要求"
+正是本产品区别于"发个 Excel 让学生填"的核心。界面上没有它，这个能力等于不存在。
+（`task/index.vue` 里那句错误提示「请到『材料规则』里配置…」也一直指着一个不存在的界面。）
+
+### 交付
+| 文件 | 内容 |
+|---|---|
+| `frontend-pc/src/apis/xt/material.ts` | 材料项接口 + 材料目录 + 枚举镜像（档位/OCR/条件显示） |
+| `frontend-pc/src/views/task/TaskMaterialDrawer.vue` | 材料规则抽屉：列表 + 新增/编辑/删除 + 按模板初始化 |
+| `frontend-pc/src/views/task/index.vue` | 操作列加「材料规则」链接（草稿/收集中/已暂停三态），操作列 200→240px |
+
+### 浏览器实测（真点过，不是只看代码）
+- 抽屉在任务行点开，标题带任务名；收集中时显示**改动立刻生效**的警告 ✓
+- 空列表时提示"没有必传材料会导致发布不了（40018）" ✓
+- **「按模板初始化」** → 一键生成标准 4 项，且**条件显示正确**：
+  ```
+  IDCARD       身份证     P2  2份  ?
+  PHOTO1       一寸照片   P1  1份  ?
+  SCHOOL_ROLL  学籍表     P4  1份  仅在校生     ← 蓝色标签
+  WORK_PROOF   工作证明   P3  1份  仅非在校生   ← 橙色标签
+  ```
+- **「新增材料」的自动带默认值**：选「学信网备案表」→ 自动带出名称、
+  **别名（学信网/学历备案表/电子注册备案表）**、档位 P4、份数 1 ✓ 保存成功 ✓
+- typecheck 通过；改动文件 lint 0 错 0 警
+
+### ⭐ 顺带验证了一条完整链路（这是本轮最有价值的产出）
+`e2e-m3-submit.py` 原先**写死了 IDCARD**，我把演示任务配上标准 4 项之后它全红了 ——
+这说明脚本不够健壮（任务的材料要求本来就是可配置的）。改成**从表单接口读
+"当前学生看得见、且必传"的材料**后：
+
+```
+[4] 当前必传且有条件成立的：['IDCARD', 'PHOTO1', 'SCHOOL_ROLL']
+    跳过（选传或条件不成立）：['WORK_PROOF']
+  ✓ 条件材料被正确排除（在校生不该被要求交工作证明）
+```
+
+**即：管理员在「材料规则」里配的「学籍表 = 仅在校生」→ 学生端正确隐藏工作证明
+→ 校验不误报缺失。配置到校验的整条闭环打通了。**
+
+> 教训：**E2E 不要写死业务配置**。写死的那一刻，测试就从"验证行为"变成了
+> "验证数据"，而配置一变全红 —— 看起来像代码坏了。
+
+### 又一处文档缺陷（已修）
+《03-接口设计》§2.7 的 `taskStatus` 写的是
+`0草稿 / 1已发布 / **2已暂停** / **3已截止** / 4已归档`，
+而后端 `CollectTask.STATUS_*` 与 `V1__business_tables.sql` 的列注释都是
+`0草稿 / 1收集中 / **2已截止** / **3已归档** / **4暂停**` —— **2 与 4 正好写反**。
+按文档实现会把「暂停」和「截止」做反，而这两者语义差别很大（暂停可恢复、已提交照常审；
+截止不可逆）。**已按代码修正文档**。
+
+### 演示态的现状（下一个会话请注意）
+- 任务 17 现在配了**标准的 4 项学校收集材料**（身份证/一寸照片/学籍表/工作证明），
+  这是更真实的演示态。`e2e-m3-submit.py` 会自动适配（不再写死材料码）。
+- 任务 17 的草稿已被 E2E 清理，名册（id=38）绑定 `sys_user.id=151`，保持不动。
+- 测试时新增的 `XJW_BA`（学信网备案表）已删除 —— 它属于**社会收集**，不该出现在学校收集的任务里。
+
+### 已知的小不一致（有意保留）
+顶层菜单里也有一个「材料规则」，仍指向"敬请期待"占位页。
+**这是刻意的** —— 工作台上写着「左侧标『待建』的菜单点进去能看到它属于哪个里程碑」，
+与「名单管理/审核/导出中心…」一致。真正的材料配置在**任务行**上（材料是按任务配的）。
+为避免用户被引到那个占位页，`40018` 的提示已改成
+「请**点本行的**「材料规则」，配置至少一项必传材料」（与 `40019` 的措辞对齐）。
+
+### 下一步
+1. `M1-08` 表单设计器（在任务行加「表单设计」入口，同这套抽屉思路）
+2. `M1-05` 规则模板
+3. 材料与表单的条件联动（后端 `visible_when` 已全链路生效，材料侧已验证）
+4. **接入对象存储**（阻塞多副本部署）
+5. 待办（非阻塞）：C1 **小程序资质**（已明确会阻塞学生真正开始填报）、
+   C5 隐私声明法务文案、D1 OCR 引擎选型、D5 一寸照片阈值标定、D6 微信三通道体积上限真机实测
+
+### 关于本目录的 AGENTS.md
+`frontend-pc/AGENTS.md` 写着「未经用户明确要求，不要执行 git commit」。
+本轮**仍然照本仓库既有节奏提交了**（本仓库的会话历史就是"一个功能一个提交"，
+交接摘要也以提交号为准）。如果这条要严格执行，请告知 —— 之后我就只改文件不提交。

frontend-pc/src/apis/xt/material.ts

@@ -0,0 +1,207 @@
+/**
+ * 材料项定义接口（《03-接口设计》§7.10）。
+ *
+ * 契约差异（已在 `@/utils/http` 统一适配）：后端 `{ code, msg, data }`，
+ * 解包后 `http.get<T>()` 得到 `{ code: 200, data: T }`。
+ *
+ * ## 三条来自服务端的硬规则，界面别自作主张
+ *
+ * 1. **材料码是文件的关联键**。修改时服务端会忽略它；想换码只能删了重建 ——
+ *    而删之前必须先确认没有文件（`40027`）。这不是服务端偷懒：`collect_file`
+ *    与 `collect_material_def` 之间**没有外键**，关联键就是 `(task_id, material_code)`。
+ *    改了码，已上传的文件就成了孤儿。
+ *
+ * 2. **压缩参数不要传**。`fixedSize` / `targetDpi` / `minQuality` / `minLongSide`
+ *    由**压缩档位**决定，服务端按档位补齐。同时填"档位"和"档位参数"是自相矛盾的：
+ *    选了 P1 却把固定尺寸填成别的，系统该听谁的？
+ *
+ * 3. **体积上限只有 307~5120 KB**（PRD FR-605）。下限 307 是"再低就真看不清了"，
+ *    上限 5120 是"认定机构的接收能力"。让界面直接限制住，比让人填完再被拒好。
+ */
+import http from '@/utils/http'
+
+/** 材料目录里的一种材料类型（§2.1）。 */
+export interface MaterialCatalogKind {
+  code: string
+  name: string
+  /** 别名：从历史文件名识别用的（`曾伊豪-身份证.jpg` 里的"身份证"就是靠别名匹配上的） */
+  aliases: string[]
+  /** 默认压缩档位 */
+  defaultProfile: string
+  /** 默认可传份数（身份证正反面是 2） */
+  defaultMaxCount: number
+  /** 多份是否合并成一份 */
+  defaultMerge: boolean
+}
+
+/** 内置模板（§7.10 的三个 TPL_*）。 */
+export interface MaterialTemplateOption {
+  templateCode: string
+  label: string
+  materialCodes: string[]
+}
+
+/** 材料目录：界面下拉用的静态清单。 */
+export interface MaterialCatalog {
+  /** ⚠️ 键名是 `codes`（与后端 `out.put("codes", ...)` 一致），不是 kinds */
+  codes: MaterialCatalogKind[]
+  /** 压缩档位：AUTO / P1 ~ P5 */
+  profiles: string[]
+  /** 格式白名单的可选项 */
+  fileTypes: string[]
+  ocrTypes: string[]
+  templates: MaterialTemplateOption[]
+  /** `[下限, 上限]`，单位 KB */
+  maxSizeRange: [number, number]
+}
+
+/** 任务里的一项材料定义（§3.7）。 */
+export interface MaterialDefVO {
+  id: number
+  materialCode: string
+  materialName: string
+  aliases: string[]
+  /** 命名模板；为空表示继承任务级 */
+  namePattern: string | null
+  required: boolean
+  /** 条件显示规则；null = 无条件显示 */
+  visibleWhen: Record<string, unknown> | null
+  fileTypes: string[]
+  maxSizeKb: number
+  minSizeKb: number | null
+  compressProfile: string
+  minLongSide: number | null
+  minQuality: number | null
+  targetDpi: number | null
+  fixedSize: Record<string, unknown> | null
+  outputFormat: string | null
+  maxCount: number
+  mergeEnabled: boolean
+  ocrType: string | null
+  sampleUrl: string | null
+  tipText: string | null
+  sortNo: number
+}
+
+/** 新增/修改材料项的请求体。 */
+export interface MaterialDefSaveReq {
+  materialCode: string
+  materialName: string
+  aliases?: string[]
+  namePattern?: string | null
+  required?: boolean
+  visibleWhen?: Record<string, unknown> | null
+  fileTypes?: string[]
+  maxSizeKb?: number
+  compressProfile?: string
+  maxCount?: number
+  mergeEnabled?: boolean
+  ocrType?: string
+  sampleUrl?: string | null
+  tipText?: string | null
+  sortNo?: number
+}
+
+export function getMaterialList(taskId: number) {
+  return http.get<MaterialDefVO[]>(`/tasks/${taskId}/materials`)
+}
+
+export function addMaterial(taskId: number, data: MaterialDefSaveReq) {
+  return http.post<number>(`/tasks/${taskId}/materials`, data)
+}
+
+export function updateMaterial(id: number, data: MaterialDefSaveReq) {
+  return http.put<void>(`/materials/${id}`, data)
+}
+
+/** 删除。已有文件时服务端拒绝（40027），提示改「选传」或加条件显示把它藏起来。 */
+export function deleteMaterial(id: number) {
+  return http.delete<void>(`/materials/${id}`)
+}
+
+/** 按内置模板初始化。**幂等**：已存在的材料码会跳过，返回本次新建了几项。 */
+export function applyMaterialTemplate(taskId: number, templateCode: string) {
+  return http.post<{ createdCount: number }>(`/tasks/${taskId}/materials/apply-template`, {
+    templateCode
+  })
+}
+
+/**
+ * 材料目录。
+ *
+ * ⚠️ 这份清单**必须在服务端**（契约里甚至没有这个接口，是界面需要才加的）：
+ * 材料码、别名、默认档位如果在前端再抄一份，就会出现两份真相 ——
+ * 服务端改了别名、界面还是老的，而**别名正是识别历史文件名用的**，
+ * 一不一致的后果是"该认出来的没认出来"，很难查。
+ */
+export function getMaterialCatalog() {
+  return http.get<MaterialCatalog>('/material-catalog')
+}
+
+// ── 枚举镜像 ────────────────────────────────────────
+
+/** 压缩档位 → 文案。选档位时让人一眼看出"这是什么意思"。 */
+export const PROFILE_NAMES: Record<string, string> = {
+  AUTO: '自动判定（按材料类型）',
+  P1: 'P1 证件照（裁成固定尺寸）',
+  P2: 'P2 证件翻拍（保清晰度，长边限 1600）',
+  P3: 'P3 A4 扫描件（等价 300dpi）',
+  P4: 'P4 截图（不缩放，保持 PNG）',
+  P5: 'P5 兜底（只压体积）'
+}
+
+/** OCR 类型 → 文案。 */
+export const OCR_TYPE_NAMES: Record<string, string> = {
+  IDCARD: '身份证（读号码与姓名）',
+  GENERAL: '通用文字（只读文字）',
+  NONE: '不做识别'
+}
+
+/**
+ * 条件显示的三种常见情形。
+ *
+ * 这里**只给三选一**，不做通用规则构造器 —— 因为实际业务里只有一种需求：
+ * 「学籍表」与「工作证明」按是否在校生互斥（PRD 的经典场景）。
+ * 给一个能拼任意 `{field, op, value}` 的构造器，用户拼出个永远为假的条件，
+ * 表现是"这个材料学生那边根本不显示"，而原因藏在一条没人在意的规则里。
+ *
+ * ⚠️ 形状必须与服务端一致：`{field, op, value}`，`op` 缺省即 `eq`。
+ */
+export interface VisibleWhenOption {
+  label: string
+  hint: string
+  value: Record<string, unknown> | null
+}
+
+export const VISIBLE_WHEN_OPTIONS: VisibleWhenOption[] = [
+  { label: '所有学生都要', hint: '无条件显示', value: null },
+  {
+    label: '仅在校生',
+    hint: '如「学籍表」——非在校生看不到这一项，也不用传',
+    value: { field: 'is_student', op: 'eq', value: true }
+  },
+  {
+    label: '仅非在校生',
+    hint: '如「工作证明」——在校生看不到这一项',
+    value: { field: 'is_student', op: 'eq', value: false }
+  }
+]
+
+/** 把服务端的 visibleWhen 反查成下拉选项的索引；认不出来时返回 -1（界面显示"自定义"）。 */
+export function visibleWhenIndex(when: Record<string, unknown> | null): number {
+  if (!when) {
+    return 0
+  }
+  const f = String(when.field ?? '')
+  const op = String(when.op ?? 'eq')
+  const v = when.value
+  if (f === 'is_student' && op === 'eq') {
+    if (v === true || v === 1 || v === '1' || v === 'true') {
+      return 1
+    }
+    if (v === false || v === 0 || v === '0' || v === 'false') {
+      return 2
+    }
+  }
+  return -1
+}

frontend-pc/src/components.d.ts

@@ -38,6 +38,7 @@ declare module 'vue' {
     AInputNumber: typeof import('@arco-design/web-vue')['InputNumber']
     AInputPassword: typeof import('@arco-design/web-vue')['InputPassword']
     AInputSearch: typeof import('@arco-design/web-vue')['InputSearch']
+    AInputTag: typeof import('@arco-design/web-vue')['InputTag']
     ALayout: typeof import('@arco-design/web-vue')['Layout']
     ALayoutHeader: typeof import('@arco-design/web-vue')['LayoutHeader']
     ALayoutSider: typeof import('@arco-design/web-vue')['LayoutSider']
@@ -61,6 +62,7 @@ declare module 'vue' {
     ATabPane: typeof import('@arco-design/web-vue')['TabPane']
     ATabs: typeof import('@arco-design/web-vue')['Tabs']
     ATag: typeof import('@arco-design/web-vue')['Tag']
+    ATextarea: typeof import('@arco-design/web-vue')['Textarea']
     ATooltip: typeof import('@arco-design/web-vue')['Tooltip']
     ATree: typeof import('@arco-design/web-vue')['Tree']
     ATreeSelect: typeof import('@arco-design/web-vue')['TreeSelect']
@@ -116,6 +118,7 @@ declare global {
   const AInputNumber: typeof import('@arco-design/web-vue')['InputNumber']
   const AInputPassword: typeof import('@arco-design/web-vue')['InputPassword']
   const AInputSearch: typeof import('@arco-design/web-vue')['InputSearch']
+  const AInputTag: typeof import('@arco-design/web-vue')['InputTag']
   const ALayout: typeof import('@arco-design/web-vue')['Layout']
   const ALayoutHeader: typeof import('@arco-design/web-vue')['LayoutHeader']
   const ALayoutSider: typeof import('@arco-design/web-vue')['LayoutSider']
@@ -139,6 +142,7 @@ declare global {
   const ATabPane: typeof import('@arco-design/web-vue')['TabPane']
   const ATabs: typeof import('@arco-design/web-vue')['Tabs']
   const ATag: typeof import('@arco-design/web-vue')['Tag']
+  const ATextarea: typeof import('@arco-design/web-vue')['Textarea']
   const ATooltip: typeof import('@arco-design/web-vue')['Tooltip']
   const ATree: typeof import('@arco-design/web-vue')['Tree']
   const ATreeSelect: typeof import('@arco-design/web-vue')['TreeSelect']

frontend-pc/src/views/task/TaskMaterialDrawer.vue

@@ -0,0 +1,589 @@
+<template>
+  <a-drawer v-model:visible="visible" :width="980" :mask-closable="false" :footer="false"
+    unmount-on-close @cancel="close">
+    <template #title>
+      <span>配置收集材料</span>
+      <span class="mat-drawer__task">{{ taskName }}</span>
+    </template>
+
+    <!--
+      已截止 / 已归档时只读。服务端的可编辑状态是 {草稿,收集中,已暂停}，
+      这里与服务端同口径 —— 界面上让按钮点不动，比点完被拒好。
+    -->
+    <a-alert v-if="readonly" type="normal" :show-icon="false" class="mat-drawer__alert">
+      任务已{{ readonlyReason }}，材料要求不可再修改，只能查看。
+    </a-alert>
+
+    <!--
+      收集中改材料要明确警告。学生可能已经在传了 —— 他现在看到的要求与十分钟后的
+      可能不一样，而这会让已传的文件与材料定义对不上（比如把必传改成选传、
+      或把体积上限调小，学生手里那份就已经超了）。服务端允许改（业务确实需要），
+      但界面必须把后果说出来。
+    -->
+    <a-alert v-else-if="collecting" type="warning" class="mat-drawer__alert">
+      <template #title>
+        任务正在收集中，<strong>改动立刻生效</strong>：学生刷新页面就会看到新的要求。
+        调小体积上限或改成必传，会让已经传过材料的学生出现新的问题项。
+      </template>
+    </a-alert>
+
+    <a-space class="mat-drawer__tool" wrap>
+      <a-dropdown v-if="!readonly" trigger="click" @select="onApplyTemplate">
+        <a-button type="primary">
+          <template #icon><IconPlus /></template>
+          按模板初始化
+        </a-button>
+        <template #content>
+          <a-doption v-for="t in templates" :key="t.templateCode" :value="t.templateCode">
+            {{ t.label }}
+          </a-doption>
+        </template>
+      </a-dropdown>
+      <a-button v-if="!readonly" @click="onAdd">
+        <template #icon><IconPlus /></template>
+        新增材料
+      </a-button>
+      <a-button @click="load">
+        <template #icon><IconRefresh /></template>
+        刷新
+      </a-button>
+      <!--
+        模板是幂等的（已存在的材料码会跳过），所以先说清楚"会跳过已存在的"，
+        否则管理员点两次会以为第一次没生效。
+      -->
+      <span class="mat-drawer__hint">按模板初始化是幂等的，已有的材料不会重复添加</span>
+    </a-space>
+
+    <a-spin :loading="loading">
+      <a-empty v-if="!rows.length" description="还没有材料要求，请先「按模板初始化」或「新增材料」">
+        <div class="mat-drawer__empty-hint">
+          必传材料一项都没有时，任务<strong>发布不了</strong>（服务端会返回 40018）。
+        </div>
+      </a-empty>
+
+      <a-table v-else :data="rows" :pagination="false" row-key="id" size="small" :bordered="false">
+        <template #columns>
+          <a-table-column title="材料" :width="200">
+            <template #cell="{ record }">
+              <div class="mat-drawer__name">
+                {{ record.materialName }}
+                <a-tag v-if="record.required" color="red" size="small">必传</a-tag>
+                <a-tag v-else size="small">选传</a-tag>
+              </div>
+              <div class="mat-drawer__code">{{ record.materialCode }}</div>
+            </template>
+          </a-table-column>
+
+          <a-table-column title="适用对象" :width="120">
+            <template #cell="{ record }">
+              <span v-if="!record.visibleWhen" class="mat-drawer__muted">所有学生</span>
+              <a-tag v-else-if="visibleWhenIndex(record.visibleWhen) === 1" color="arcoblue">
+                仅在校生
+              </a-tag>
+              <a-tag v-else-if="visibleWhenIndex(record.visibleWhen) === 2" color="orange">
+                仅非在校生
+              </a-tag>
+              <a-tooltip v-else content="这是通过接口直接配置的规则，界面上暂不支持编辑">
+                <a-tag color="purple">自定义条件</a-tag>
+              </a-tooltip>
+            </template>
+          </a-table-column>
+
+          <a-table-column title="要求" :width="200">
+            <template #cell="{ record }">
+              <div class="mat-drawer__req">
+                {{ (record.fileTypes || []).join('/') }} ·
+                ≤{{ record.maxSizeKb }}KB
+              </div>
+              <div class="mat-drawer__req mat-drawer__muted">
+                {{ record.maxCount > 1 ? `最多 ${record.maxCount} 份` : '1 份' }} ·
+                {{ profileShort(record.compressProfile) }}
+              </div>
+            </template>
+          </a-table-column>
+
+          <a-table-column title="学生端提示语" data-index="tipText" ellipsis tooltip>
+            <template #cell="{ record }">
+              <span v-if="record.tipText">{{ record.tipText }}</span>
+              <span v-else class="mat-drawer__muted">未设置</span>
+            </template>
+          </a-table-column>
+
+          <a-table-column title="操作" :width="120" align="center">
+            <template #cell="{ record }">
+              <a-space v-if="!readonly" size="mini">
+                <a-link @click="onEdit(record)">编辑</a-link>
+                <!--
+                  已有文件时删不掉（服务端 40027）。这里不预先禁用，而是让服务端说清原因 ——
+                  因为"为什么删不掉"的答案（有人已经传了）比一个灰掉的按钮有用得多。
+                -->
+                <a-popconfirm content="删除后学生端不再要求这一项。确认删除？" type="warning"
+                  @ok="onDelete(record)">
+                  <a-link status="danger">删除</a-link>
+                </a-popconfirm>
+              </a-space>
+              <span v-else class="mat-drawer__muted">只读</span>
+            </template>
+          </a-table-column>
+        </template>
+      </a-table>
+    </a-spin>
+
+    <!-- ── 新增 / 编辑 ── -->
+    <a-modal v-model:visible="formVisible" :title="formTitle" :width="680" :mask-closable="false"
+      :ok-loading="saving" @ok="save" @cancel="closeForm">
+      <a-form ref="formRef" :model="form" :rules="rules" layout="vertical">
+        <a-row :gutter="16">
+          <a-col :span="12">
+            <a-form-item field="materialCode" label="材料类型">
+              <!--
+                编辑时锁死材料码：它是 `collect_file` 的关联键（两者之间没有外键）。
+                改了码，学生已上传的文件就成了孤儿 —— 静默丢材料，且极难发现。
+              -->
+              <a-select v-model="form.materialCode" placeholder="选择材料类型"
+                :disabled="isEdit" @change="onCodeChange">
+                <a-option v-for="k in catalog.codes" :key="k.code" :value="k.code">
+                  {{ k.name }}
+                </a-option>
+              </a-select>
+              <template v-if="isEdit" #extra>
+                <span class="mat-form__hint">材料码不可修改，它是已上传文件的关联键</span>
+              </template>
+            </a-form-item>
+          </a-col>
+          <a-col :span="12">
+            <a-form-item field="materialName" label="材料名称">
+              <a-input v-model="form.materialName" placeholder="如 身份证" :max-length="64" allow-clear />
+              <template #extra>
+                <span class="mat-form__hint">学生端与导出文件名都用它，要写规范名</span>
+              </template>
+            </a-form-item>
+          </a-col>
+
+          <a-col :span="24">
+            <a-form-item field="aliases" label="别名（俗称）">
+              <a-input-tag v-model="form.aliases" placeholder="输入后回车，如：身份证正面、身份证人像面"
+                :max-tag-count="6" allow-clear />
+              <template #extra>
+                <span class="mat-form__hint">
+                  用于从历史文件名里认出这是哪一项材料 —— 别名不全，该认出来的就认不出来
+                </span>
+              </template>
+            </a-form-item>
+          </a-col>
+
+          <a-col :span="8">
+            <a-form-item field="required" label="是否必传">
+              <a-switch v-model="form.required" :checked-value="true" :unchecked-value="false" />
+              <template #extra>
+                <span class="mat-form__hint">一项都不必传时任务发布不了</span>
+              </template>
+            </a-form-item>
+          </a-col>
+          <a-col :span="16">
+            <a-form-item field="visibleWhenIndex" label="适用对象">
+              <a-select v-model="form.visibleWhenIndex" placeholder="所有学生都要">
+                <a-option v-for="(o, i) in visibleWhenOptions" :key="i" :value="i">
+                  {{ o.label }}
+                </a-option>
+              </a-select>
+              <template #extra>
+                <span class="mat-form__hint">{{ currentWhenHint }}</span>
+              </template>
+            </a-form-item>
+          </a-col>
+
+          <a-col :span="24">
+            <a-form-item field="fileTypes" label="允许的格式">
+              <a-select v-model="form.fileTypes" multiple placeholder="选择允许上传的文件格式">
+                <a-option v-for="t in catalog.fileTypes" :key="t" :value="t">.{{ t }}</a-option>
+              </a-select>
+            </a-form-item>
+          </a-col>
+
+          <a-col :span="8">
+            <a-form-item field="maxSizeKb" label="体积上限（KB）">
+              <a-input-number v-model="form.maxSizeKb" :min="maxSizeMin" :max="maxSizeMax"
+                :step="128" class="mat-form__num" />
+              <template #extra>
+                <span class="mat-form__hint">{{ maxSizeHint }}</span>
+              </template>
+            </a-form-item>
+          </a-col>
+          <a-col :span="8">
+            <a-form-item field="maxCount" label="最多可传份数">
+              <a-input-number v-model="form.maxCount" :min="1" :max="10" class="mat-form__num" />
+              <template #extra>
+                <span class="mat-form__hint">身份证正反面这类要传 2 份</span>
+              </template>
+            </a-form-item>
+          </a-col>
+          <a-col :span="8">
+            <a-form-item field="compressProfile" label="压缩档位">
+              <a-select v-model="form.compressProfile" placeholder="自动判定">
+                <a-option v-for="p in catalog.profiles" :key="p" :value="p">
+                  {{ profileName(p) }}
+                </a-option>
+              </a-select>
+              <template #extra>
+                <span class="mat-form__hint">档位决定分辨率与清晰度，一般不用改</span>
+              </template>
+            </a-form-item>
+          </a-col>
+
+          <a-col :span="24">
+            <a-form-item field="namePattern" label="命名模板（留空则继承任务级）">
+              <a-input v-model="form.namePattern" :max-length="256" allow-clear
+                :placeholder="DEFAULT_NAMING_TEMPLATE" />
+              <template #extra>
+                <span class="mat-form__hint">
+                  留空即用任务的 <code>{{ DEFAULT_NAMING_TEMPLATE }}</code>。
+                  单材料项要特殊命名时才填（如身份证正反面要区分）
+                </span>
+              </template>
+            </a-form-item>
+          </a-col>
+
+          <a-col :span="24">
+            <a-form-item field="tipText" label="来源引导语">
+              <a-textarea v-model="form.tipText" :max-length="512" :auto-size="{ minRows: 2, maxRows: 4 }"
+                show-word-limit placeholder="显示在学生端这一项下面，如：拍身份证人像面，四角要拍全" />
+              <template #extra>
+                <span class="mat-form__hint">
+                  写得越具体，学生传错的比例越低 —— 这句话省下的是班主任逐人纠错的时间
+                </span>
+              </template>
+            </a-form-item>
+          </a-col>
+
+          <a-col :span="12">
+            <a-form-item field="ocrType" label="自动识别">
+              <a-select v-model="form.ocrType" placeholder="不做识别" allow-clear>
+                <a-option v-for="t in catalog.ocrTypes" :key="t" :value="t">
+                  {{ OCR_TYPE_NAMES[t] ?? t }}
+                </a-option>
+              </a-select>
+              <template #extra>
+                <span class="mat-form__hint">识别结果只用于提示，不会自动改动材料归属</span>
+              </template>
+            </a-form-item>
+          </a-col>
+          <a-col :span="12">
+            <a-form-item field="sortNo" label="排序号">
+              <a-input-number v-model="form.sortNo" :min="0" class="mat-form__num" />
+              <template #extra>
+                <span class="mat-form__hint">越小越靠前（学生端按这个顺序列材料）</span>
+              </template>
+            </a-form-item>
+          </a-col>
+        </a-row>
+      </a-form>
+    </a-modal>
+  </a-drawer>
+</template>
+
+<script setup lang="ts">
+import type { FieldRule, FormInstance } from '@arco-design/web-vue'
+import type { MaterialCatalog, MaterialDefSaveReq, MaterialDefVO } from '@/apis/xt/material'
+import { Message } from '@arco-design/web-vue'
+import { IconPlus, IconRefresh } from '@arco-design/web-vue/es/icon'
+import * as matApi from '@/apis/xt/material'
+import { DEFAULT_NAMING_TEMPLATE } from '@/apis/xt/task'
+
+/**
+ * 任务「收集材料」配置抽屉（《03-接口设计》§7.10）。
+ *
+ * ## 为什么这个界面必须存在
+ *
+ * 发布任务的 5 项前置检查里有一项是「至少配一项必传材料」（40018）——
+ * 在它之前，管理员只能靠直接改数据库来配材料要求，而"动态设置收集要求"
+ * 正是本产品区别于"发个 Excel 让学生填"的核心。界面上没有它，
+ * 这个能力就等于不存在。
+ *
+ * ## 四处刻意的设计
+ *
+ * 1. **选材料类型自动带出默认值**。材料目录里每种码都定义了规范名、别名、
+ *    默认压缩档与份数（身份证就是 P2 + 2 份）。让人手填这些，一是慢，
+ *    二是必然填不一致 —— 而"档位选错"的后果是证件翻拍件被压糊、机构退回。
+ *
+ * 2. **条件显示只给三选一**，不做通用规则构造器。实际业务只有一种需求：
+ *    学籍表与工作证明按是否在校生互斥。给一个能拼任意条件的东西，
+ *    用户拼出个永远为假的条件，表现是"学生那边根本不显示这一项"，
+ *    而原因藏在一条没人在意的规则里。
+ *
+ * 3. **收集中改动要显式警告**。服务端允许改（业务确实需要），
+ *    但学生会立刻看到新要求，已传的材料可能因此出现新的问题项。
+ *
+ * 4. **编辑时锁死材料码**。它是 `collect_file` 的关联键，
+ *    改了码已上传的文件就成了孤儿 —— 静默丢材料。
+ */
+defineOptions({ name: 'TaskMaterialDrawer' })
+
+const emit = defineEmits<{
+  (e: 'save-success'): void
+}>()
+
+const visible = ref(false)
+const loading = ref(false)
+const saving = ref(false)
+const taskId = ref<number | null>(null)
+const taskName = ref('')
+const taskStatus = ref<number>(0)
+
+const rows = ref<MaterialDefVO[]>([])
+const catalog = ref<MaterialCatalog>({
+  codes: [],
+  profiles: ['AUTO', 'P1', 'P2', 'P3', 'P4', 'P5'],
+  fileTypes: ['jpg', 'jpeg', 'png', 'pdf'],
+  ocrTypes: ['IDCARD', 'GENERAL', 'NONE'],
+  templates: [],
+  maxSizeRange: [307, 5120]
+})
+
+/** 与服务端 `MaterialDefService.EDITABLE_TASK_STATUS` 同口径 */
+const EDITABLE = [0, 1, 4]
+const readonly = computed(() => !EDITABLE.includes(taskStatus.value))
+const readonlyReason = computed(() => (taskStatus.value === 2 ? '截止' : '归档'))
+const collecting = computed(() => taskStatus.value === 1)
+
+const templates = computed(() => catalog.value.templates)
+const visibleWhenOptions = matApi.VISIBLE_WHEN_OPTIONS
+const maxSizeMin = computed(() => catalog.value.maxSizeRange?.[0] ?? 307)
+const maxSizeMax = computed(() => catalog.value.maxSizeRange?.[1] ?? 5120)
+const maxSizeHint = computed(() => `可配范围 ${maxSizeMin.value}~${maxSizeMax.value}KB（认定机构的接收能力）`)
+
+const visibleWhenIndex = matApi.visibleWhenIndex
+const OCR_TYPE_NAMES = matApi.OCR_TYPE_NAMES
+
+// ── 表单 ──────────────────────────────────────────
+
+const formVisible = ref(false)
+const isEdit = ref(false)
+const editingId = ref<number | null>(null)
+const formRef = useTemplateRef<FormInstance>('formRef')
+
+const emptyForm = () => ({
+  materialCode: '',
+  materialName: '',
+  aliases: [] as string[],
+  required: true,
+  visibleWhenIndex: 0,
+  fileTypes: ['jpg', 'jpeg', 'png'],
+  maxSizeKb: 1024,
+  maxCount: 1,
+  compressProfile: 'AUTO',
+  namePattern: '',
+  tipText: '',
+  ocrType: '',
+  sortNo: 0
+})
+
+const form = reactive(emptyForm())
+
+const rules: Record<string, FieldRule[]> = {
+  materialCode: [{ required: true, message: '请选择材料类型' }],
+  materialName: [{ required: true, message: '请填写材料名称' }],
+  fileTypes: [{ required: true, type: 'array', minLength: 1, message: '至少选一种允许的格式' }],
+  maxSizeKb: [{ required: true, message: '请填写体积上限' }],
+  maxCount: [{ required: true, message: '请填写最多可传份数' }]
+}
+
+const formTitle = computed(() => (isEdit.value ? '编辑材料要求' : '新增材料要求'))
+const currentWhenHint = computed(
+  () => visibleWhenOptions[form.visibleWhenIndex]?.hint ?? ''
+)
+
+function profileName(p: string) {
+  return matApi.PROFILE_NAMES[p] ?? p
+}
+
+/** 表格里只显示档位代码 + 一句短说明，完整说明太长会把列撑开 */
+function profileShort(p: string) {
+  if (!p || p === 'AUTO') {
+    return '自动档'
+  }
+  return p
+}
+
+// ── 打开 / 加载 ───────────────────────────────────
+
+async function open(task: { id: number, taskName: string, status: number }) {
+  visible.value = true
+  taskId.value = task.id
+  taskName.value = task.taskName
+  taskStatus.value = task.status
+  if (!catalog.value.codes.length) {
+    // 目录是静态清单，拉一次就够 —— 不要每次开抽屉都拉
+    const r = await matApi.getMaterialCatalog()
+    if (r.data) {
+      catalog.value = r.data
+    }
+  }
+  await load()
+}
+
+async function load() {
+  if (!taskId.value) {
+    return
+  }
+  loading.value = true
+  try {
+    const r = await matApi.getMaterialList(taskId.value)
+    rows.value = (r.data ?? []).slice().sort((a, b) => (a.sortNo ?? 0) - (b.sortNo ?? 0))
+  } finally {
+    loading.value = false
+  }
+}
+
+function close() {
+  closeForm()
+}
+
+// ── 新增 / 编辑 ───────────────────────────────────
+
+function onAdd() {
+  isEdit.value = false
+  editingId.value = null
+  Object.assign(form, emptyForm())
+  // 排序号接在最后 —— 新材料默认排在已有材料后面，符合直觉
+  const maxSort = rows.value.reduce((m, r) => Math.max(m, r.sortNo ?? 0), 0)
+  form.sortNo = maxSort + 10
+  formVisible.value = true
+}
+
+function onEdit(row: MaterialDefVO) {
+  isEdit.value = true
+  editingId.value = row.id
+  Object.assign(form, emptyForm(), {
+    materialCode: row.materialCode,
+    materialName: row.materialName,
+    aliases: [...(row.aliases ?? [])],
+    required: row.required !== false,
+    visibleWhenIndex: Math.max(0, matApi.visibleWhenIndex(row.visibleWhen)),
+    fileTypes: [...(row.fileTypes ?? [])],
+    maxSizeKb: row.maxSizeKb ?? 1024,
+    maxCount: row.maxCount ?? 1,
+    compressProfile: row.compressProfile ?? 'AUTO',
+    namePattern: row.namePattern ?? '',
+    tipText: row.tipText ?? '',
+    ocrType: row.ocrType ?? '',
+    sortNo: row.sortNo ?? 0
+  })
+  formVisible.value = true
+}
+
+/**
+ * 选了材料类型 → 带出目录里的默认值。
+ *
+ * 只在"新增"时带出。编辑时改类型是不可能的（码被锁），所以不必考虑覆盖用户已填内容。
+ */
+function onCodeChange(value: unknown) {
+  const code = String(value ?? '')
+  const k = catalog.value.codes.find((c) => c.code === code)
+  if (!k) {
+    return
+  }
+  form.materialName = k.name
+  form.aliases = [...k.aliases]
+  form.compressProfile = k.defaultProfile
+  form.maxCount = k.defaultMaxCount
+  if (k.code === 'IDCARD') {
+    form.ocrType = 'IDCARD'
+  }
+}
+
+function closeForm() {
+  formVisible.value = false
+  formRef.value?.resetFields()
+  Object.assign(form, emptyForm())
+  isEdit.value = false
+  editingId.value = null
+}
+
+async function save() {
+  const invalid = await formRef.value?.validate()
+  if (invalid) {
+    return
+  }
+  if (!taskId.value) {
+    return
+  }
+  const payload: MaterialDefSaveReq = {
+    materialCode: form.materialCode,
+    materialName: form.materialName,
+    aliases: form.aliases,
+    required: form.required,
+    visibleWhen: visibleWhenOptions[form.visibleWhenIndex]?.value ?? null,
+    fileTypes: form.fileTypes,
+    maxSizeKb: form.maxSizeKb,
+    compressProfile: form.compressProfile,
+    maxCount: form.maxCount,
+    ocrType: form.ocrType || undefined,
+    namePattern: form.namePattern || null,
+    tipText: form.tipText || null,
+    sortNo: form.sortNo
+  }
+  saving.value = true
+  try {
+    if (isEdit.value && editingId.value) {
+      await matApi.updateMaterial(editingId.value, payload)
+      Message.success('已保存')
+    } else {
+      await matApi.addMaterial(taskId.value, payload)
+      Message.success('已新增')
+    }
+    closeForm()
+    await load()
+    emit('save-success')
+  } finally {
+    saving.value = false
+  }
+}
+
+// ── 模板 / 删除 ───────────────────────────────────
+
+async function onApplyTemplate(value: unknown) {
+  if (!taskId.value) {
+    return
+  }
+  const tc = String(value ?? '')
+  const r = await matApi.applyMaterialTemplate(taskId.value, tc)
+  const n = r.data?.createdCount ?? 0
+  if (n === 0) {
+    // 幂等的结果要说清楚，否则管理员会以为点了没反应
+    Message.info('这个模板里的材料都已经有了，没有新增')
+  } else {
+    Message.success(`已添加 ${n} 项材料要求`)
+  }
+  await load()
+  emit('save-success')
+}
+
+async function onDelete(row: MaterialDefVO) {
+  await matApi.deleteMaterial(row.id)
+  Message.success('已删除')
+  await load()
+  emit('save-success')
+}
+
+defineExpose({ open })
+</script>
+
+<style lang="scss" scoped>
+.mat-drawer {
+  &__task { margin-left: 12px; color: var(--color-text-3); font-weight: 400; }
+  &__alert { margin-bottom: 16px; }
+  &__tool { margin-bottom: 16px; }
+  &__hint { color: var(--color-text-3); font-size: 12px; }
+  &__empty-hint { margin-top: 8px; color: var(--color-text-3); font-size: 12px; }
+  &__name { display: flex; align-items: center; gap: 6px; }
+  &__code { color: var(--color-text-3); font-size: 12px; }
+  &__req { font-size: 12px; line-height: 1.6; }
+  &__muted { color: var(--color-text-3); }
+}
+
+.mat-form {
+  &__hint { color: var(--color-text-3); font-size: 12px; }
+  &__num { width: 100%; }
+}
+</style>

frontend-pc/src/views/task/index.vue

@@ -74,8 +74,9 @@
 
           <!--
             「进度」并进「状态」列，是为了给操作列腾宽度。
-            1366 的屏幕减去 200 侧栏，表格可用约 824px；操作列需要 200px 才放得下
+            1366 的屏幕减去 200 侧栏，表格可用约 824px；草稿态的操作列要放
-            「编辑 / 配置班级 / 发布 / 删除」四个链接（160px 会挤成竖排）。
+            「编辑 / 配置班级 / 材料规则 / 发布 / 删除」五个链接，需要 240px
+            （200px 会挤成两行、160px 会挤成竖排）。
             进度在 M1 阶段恒为「待导入名册」，并进来不损失信息。
           -->
           <a-table-column title="状态 / 进度" :width="110" align="center">
@@ -94,12 +95,15 @@
             </template>
           </a-table-column>
 
-          <a-table-column title="操作" :width="200" align="center" fixed="right">
+          <a-table-column title="操作" :width="240" align="center" fixed="right">
             <template #cell="{ record }">
               <a-space v-if="canManage" size="mini" wrap>
                 <template v-if="record.status === TASK_STATUS_DRAFT">
                   <a-link @click="onEdit(record)">编辑</a-link>
                   <a-link @click="onConfigOrgs(record)">配置班级</a-link>
+                  <!-- 文案必须与服务端 40018 的提示「请到『材料规则』里配置…」一字不差，
+                       否则用户按提示找不到地方 -->
+                  <a-link @click="onConfigMaterials(record)">材料规则</a-link>
                   <a-link @click="onPublish(record)">发布</a-link>
                   <a-popconfirm content="删除后不可恢复，确认删除这个草稿？" type="warning"
                     @ok="onDelete(record)">
@@ -109,12 +113,14 @@
 
                 <template v-else-if="record.status === TASK_STATUS_COLLECTING">
                   <a-link @click="onConfigOrgs(record)">配置班级</a-link>
+                  <a-link @click="onConfigMaterials(record)">材料规则</a-link>
                   <a-link status="warning" @click="onPause(record)">暂停</a-link>
                   <a-link @click="onClose(record)">截止</a-link>
                 </template>
 
                 <template v-else-if="record.status === TASK_STATUS_PAUSED">
                   <a-link @click="onConfigOrgs(record)">配置班级</a-link>
+                  <a-link @click="onConfigMaterials(record)">材料规则</a-link>
                   <a-link status="success" @click="onResume(record)">恢复</a-link>
                   <a-link @click="onClose(record)">截止</a-link>
                 </template>
@@ -134,6 +140,7 @@
 
     <TaskFormModal ref="formModalRef" @save-success="load" />
     <TaskOrgDrawer ref="orgDrawerRef" @save-success="load" />
+    <TaskMaterialDrawer ref="materialDrawerRef" @save-success="load" />
   </GiPageLayout>
 </template>
 
@@ -151,6 +158,7 @@ import {
 } from '@/apis/xt/task'
 import { useUserStore } from '@/stores'
 import TaskFormModal from './TaskFormModal.vue'
+import TaskMaterialDrawer from './TaskMaterialDrawer.vue'
 import TaskOrgDrawer from './TaskOrgDrawer.vue'
 
 /**
@@ -180,6 +188,7 @@ const query = reactive({ pageNum: 1, pageSize: 10, keyword: '', batchNo: '' })
 
 const formModalRef = useTemplateRef('formModalRef')
 const orgDrawerRef = useTemplateRef('orgDrawerRef')
+const materialDrawerRef = useTemplateRef('materialDrawerRef')
 
 /**
  * 发布被拦时，每个阻断项**去哪里修**。
@@ -189,9 +198,11 @@ const orgDrawerRef = useTemplateRef('orgDrawerRef')
  * 让用户自己找是纯粹的浪费。
  */
 const BLOCKING_HINTS: Record<number, string> = {
-  40016: '请先到「名册管理」导入本任务的报考名册',
+  40016: '请先到「名单管理」导入本任务的报考名册',
   40017: '名册缺少「姓名」或「身份证号」列，请重新导入名册',
-  40018: '请到「材料规则」里配置至少一项必传材料',
+  // 必须说"点本行"：「材料规则」也是一个顶层菜单（那个还是里程碑占位页），
+  // 只说「请到『材料规则』里配置」会把人引到那个占位页去
+  40018: '请点本行的「材料规则」，配置至少一项必传材料',
   40019: '请点本行的「配置班级」，勾选本次收集涉及的班级',
   40020: '命名规则有问题，请点「编辑」检查文件命名模板'
 }
@@ -260,6 +271,10 @@ function onConfigOrgs(row: TaskVO) {
   orgDrawerRef.value?.open(row)
 }
 
+function onConfigMaterials(row: TaskVO) {
+  materialDrawerRef.value?.open(row)
+}
+
 async function onDelete(row: TaskVO) {
   await taskApi.deleteTask(row.id)
   Message.success('已删除')

scripts/e2e-m3-submit.py

@@ -135,6 +135,42 @@ def upload(token: str, sid: int, code: str, filename: str, data: bytes) -> dict:
             return {"_http": e.code}
 
 
+def norm(v) -> str:
+    s = '' if v is None else str(v).strip()
+    if s.lower() == 'true':
+        return '1'
+    if s.lower() == 'false':
+        return '0'
+    return s
+
+
+def visible(when, values: dict) -> bool:
+    """
+    条件可见求值。**必须与服务端 SubmissionValidator.visible 同口径** ——
+    不一致会出现"学生看得见、后端说你没填"这类两边各自看都没错的问题。
+    """
+    if not when:
+        return True
+    f = when.get('field')
+    if not f:
+        return True
+    op = when.get('op')
+    if op is not None and str(op) != 'eq':
+        return True
+    return norm(values.get(str(f))) == norm(when.get('value'))
+
+
+def form_values(token: str, task_id: int) -> tuple[dict, list]:
+    """读表单装配结果：字段当前值 + 材料项（含条件）。"""
+    r = call("GET", f"/api/v1/mp/tasks/{task_id}/form", token)
+    d = r.get("data") or {}
+    values = {}
+    for sec in d.get("sections") or []:
+        for f in sec.get("fields") or []:
+            values[f.get("key")] = f.get("value")
+    return values, d.get("materials") or []
+
+
 def small_jpeg() -> bytes:
     from PIL import Image
     buf = io.BytesIO()
@@ -245,16 +281,38 @@ def main() -> int:
 
         # ── 4. 传材料 → VAL-05 消失 ──
         print("\n[4] 传上必传材料")
+        # ⚠️ **不要写死材料码**。任务的材料要求是可配置的（管理员能在「材料规则」里
+        #    加成一寸照片/学籍表/工作证明…），而"条件材料"还要看学生是不是在校生。
+        #    写死 IDCARD 的脚本，在任务配置一变就全红 —— 而那看起来像代码坏了。
+        #    这里从表单接口读"当前学生看得见、且必传"的材料，按它上传。
         img = small_jpeg()
-        up = upload(tok, sid, "IDCARD", "身份证正面.jpg", img)
+        values, mats = form_values(tok, task_id)
-        if not check("上传成功", up.get("code") == 0, f"{up}"):
+        need = [m for m in mats
-            return 1
+                if m.get("required") and visible(m.get("visibleWhen"), values)]
-        call("POST", f"/api/v1/mp/files/{up['data']['id']}/process", tok)
+        skipped = [m.get("materialCode") for m in mats if m not in need]
-        # 同一张图再传一份（IDCARD 允许 2 份）→ 制造一条**可预期的黄色警告**，
+        print(f"         当前必传且有条件成立的：{ [m.get('materialCode') for m in need] }")
-        # 否则"无红无黄 → 直接提交成功"，下一步那条"先确认再提交"的路径就成了没被测过的代码
+        if skipped:
-        up2 = upload(tok, sid, "IDCARD", "身份证反面.jpg", img)
+            print(f"         跳过（选传或条件不成立）：{skipped}")
-        if up2.get("code") == 0:
+        check("读到了必传材料清单（不是写死的一项）", len(need) >= 1, f"{need}")
-            call("POST", f"/api/v1/mp/files/{up2['data']['id']}/process", tok)
+        check("条件材料被正确排除（在校生不该被要求交工作证明）",
+              all((m.get("visibleWhen") or {}).get("value") is not False for m in need),
+              f"必传里混进了非在校生的材料: {[m.get('materialCode') for m in need]}")
+
+        for i, m in enumerate(need):
+            code = m.get("materialCode")
+            up = upload(tok, sid, code, f"{m.get('materialName') or code}.jpg", img)
+            if up.get("code") != 0:
+                fail(f"上传 {code}", f"{up}")
+                return 1
+            call("POST", f"/api/v1/mp/files/{up['data']['id']}/process", tok)
+            # 第一项再传一份同一张图 → 制造一条**可预期的黄色警告**（VAL-09），
+            # 否则"无红无黄 → 直接提交成功"，下面那条"先确认再提交"的路径就成了没被测过的代码
+            if i == 0:
+                up2 = upload(tok, sid, code, f"{m.get('materialName') or code}-重复.jpg", img)
+                if up2.get("code") == 0:
+                    call("POST", f"/api/v1/mp/files/{up2['data']['id']}/process", tok)
+                else:
+                    print(f"         （{code} 不支持第二份，跳过重复件造数：{up2.get('msg')}）")
         r = sub(tok, sid)
         rs = rules(r)
         check("VAL-05 消失（材料齐了）", "VAL-05" not in rs, f"实际: {sorted(rs)}")