志愿者

志愿者是项目详情页中功能最丰富的分组，包含 9 个子标签页。本文档将逐一介绍每个功能模块的操作方法。

---

1. 成员管理

成员管理是志愿者分组中最核心的模块，用于查看和管理项目的全部志愿者报名信息。

1.1 列表说明

进入"成员管理"标签页后，你可以看到一个志愿者报名列表。列表展示以下信息：

1.2 搜索与筛选

列表上方提供搜索栏，你可以通过以下条件筛选志愿者：

1. 志愿者姓名：输入姓名关键字，点击搜索
2. 志愿者手机号：输入手机号，点击搜索
3. 申请状态：从下拉菜单选择特定状态（如"待审核"），点击搜索
4. 志愿者标签：从下拉菜单选择特定标签，筛选拥有该标签的志愿者

列表右上角还有刷新按钮和搜索开关，用于刷新数据或显示/隐藏搜索栏。

1.3 工具栏操作

列表上方的工具栏提供以下操作按钮：

新增

点击"新增"按钮，打开会员选择弹窗：

1. 在弹窗中搜索并勾选需要添加的会员（支持多选）
2. 点击"确定"完成添加
3. 系统会显示添加结果：成功数、失败数及失败原因详情

需要权限 tvp:project-apply:create。

批量审核

批量审核功能用于一次性审核多个待审核的志愿者报名：

1. 点击"批量审核"按钮，系统会自动筛选出所有"待审核"状态的记录并进入批量审核模式
2. 在列表左侧勾选需要审核的记录（列表顶部会提示"勾选记录后点击确认审核"）
3. 点击"确认审核"按钮
4. 在弹出的审核窗口中：
   • 顶部蓝色提示条显示已选记录数量
   • 查看已选记录的列表（显示用户名和手机号）
   • 选择审核结果：通过 或 拒绝（单选按钮）
   • 填写审核理由（选填，最多 200 字）
5. 点击"确认提交"完成批量审核

你也可以点击"取消批量审核"退出批量审核模式，系统会提示"已退出批量审核模式"。

需要权限 tvp:project-apply:audit。

上传审核

如果你有现成的审核数据（Excel 文件），可以通过上传审核快速导入：

1. 点击"上传审核"按钮
2. 在弹窗中点击"选择 Excel 文件"，选择你的审核文件（仅支持 .xls 和 .xlsx 格式）
3. 如果你还没有模板，点击弹窗中的"下载模板"链接，下载标准模板（文件名：批量报名导入模板.xlsx）并填写审核数据
4. 选择文件后点击"确认"
5. 系统会显示导入结果：总数、成功数、失败数及失败详情表格（包含序号、手机号、身份证号、失败原因）

需要权限 tvp:project-apply:upload-audit。

导出

将当前列表数据导出为 Excel 文件：

1. 点击"导出"按钮
2. 在弹出的"选择导出列"窗口中：
   • 系统从后端动态获取可导出列，默认勾选所有可导出列
   • 你可以取消不需要的列（支持全选/取消全选），以 4 列网格布局展示
   • 显示"已选择 X / 总数"的计数
   • 可选择导出的报名状态（默认为"已完成报名"，支持多选）
3. 点击"确认"开始导出，文件会自动下载

导出文件名为：项目编号志愿者报名.xlsx

需要权限 tvp:project-apply:export。

回访导出

点击"回访导出"按钮，导出当前项目的回访记录。文件名格式为：项目编号-项目名称-回访记录.xlsx。

需要权限 tvp:project-visit:export。

鲍曼导出

点击"鲍曼导出"按钮，导出当前项目的鲍曼问卷数据。文件名格式为：项目编号-项目名称-鲍曼问卷.xlsx。

需要权限 tvp:project-apply:export。

1.4 礼金审批（下拉菜单）

工具栏中有一个"礼金审批"下拉菜单，展开后提供四个操作：

需要权限 tvp:project-apply:audit。批量审核模式下，礼金审批下拉菜单会隐藏。

1.5 单行操作

每条记录右侧的"操作"列提供以下按钮（按钮会根据记录状态和权限动态显示）：

问卷

点击"问卷"按钮，打开右侧抽屉，查看该志愿者的问卷填写进度：

• 统计卡片：显示志愿者姓名、表单总数、已填写数、未填写数
• 完成率进度条：直观显示问卷填写百分比
• 表单填写明细表格：列出每个表单的表单名称、表单 Key、使用场景（数据字典：问卷使用场景）、填写状态（已填写/未填写标签）、表单数据 ID、总分、填写时间

需要权限 tvp:project-form:query。

详情

点击"详情"按钮，打开右侧抽屉查看该志愿者的完整个人信息。

审批

仅当志愿者状态为"待审核"或"审核失败"时显示。操作方法与批量审核相同，但仅审核当前这一条记录。

需要权限 tvp:project-apply:audit。

礼金

对该志愿者单独进行礼金操作：

1. 点击"礼金"按钮，弹出礼金操作窗口
2. 选择操作类型（单选）：
   • 增加礼金：增加该志愿者的礼金金额
   • 扣除礼金：减少该志愿者的礼金金额
   • 发放礼金：发放该志愿者的礼金
   • 撤销礼金：撤销该志愿者的礼金
3. 输入金额（单位：元，最小 0.01）
4. 点击确认完成操作

需要权限 tvp:project-apply:audit。

踢出

仅当志愿者状态为"已完成报名"时显示。将该志愿者从项目中移除：

1. 点击"踢出"按钮
2. 在弹窗中填写踢出原因
3. 确认后该志愿者状态变为"已退出"，系统提示"踢出成功"

需要权限 tvp:project-apply:audit。

拉回

仅当志愿者状态为"已退出"时显示。将已退出的志愿者重新拉回项目：

1. 点击"拉回"按钮
2. 在弹窗中填写拉回原因
3. 确认后该志愿者恢复为正常状态，系统提示"拉回成功"

需要权限 tvp:project-apply:audit。

---

2. 项目内容

项目内容使用富文本编辑器编辑项目的详细描述内容，面向志愿者展示。编辑器高度固定 600px，支持插入图片、表格、链接等富文本格式。

编辑完成后，点击"保存内容"按钮即可保存。保存成功后会触发项目信息刷新。

---

3. 配置管理

配置管理页面分为左右两栏，涵盖报名规则配置和项目信息配置两大类参数。修改后点击"保存配置"按钮生效，也可点击"重置"恢复默认值。

3.1 报名规则配置（左栏）

3.2 项目信息配置（右栏）

---

4. 高级报名配置

高级报名配置提供三组精细化的报名筛选条件，适合对志愿者资质有较高要求的项目。

4.1 报名标签限制

• 启用开关：开启后，只有拥有任意一个所选标签的志愿者可以报名
• 标签选择：多选下拉，从已有标签列表中选择允许报名的标签

4.2 指标数据筛选集合

用于根据评价指标（如评分）筛选报名资格：

1. 点击"新增条件"添加一条筛选规则
2. 每条规则包含：
   • 启用开关：控制该条规则是否生效
   • 指标选择：从指标列表中选择一个评价指标
   • 最低分 / 最高分：设定指标分数的范围（最低分 ≤ 最高分）
3. 可以添加多条规则，所有启用的规则同时生效
4. 不需要的规则可以点击"删除"移除

4.3 按性别分组年龄筛选

按性别维度分别设置年龄限制和人数上限：

1. 每个分组包含：
   • 性别选择：男 / 女 / 不限（各分组之间不能重复选择同一性别）
   • 年龄条件列表：每组可添加多条年龄条件
     • 最小年龄 / 最大年龄
     • 人数上限（peopleCountMax）
     • 已报名人数（只读，实时显示）
     • 启用开关
   • 同一性别分组内的年龄范围不能重叠
2. 点击"新增条件"添加年龄分组

---

5. 回访管理

回访管理复用了系统的回访列表组件，在此标签页中管理当前项目关联的所有回访记录。

支持的操作包括：

• 搜索筛选回访记录（支持从外部传入搜索参数）
• 查看回访详情
• 创建新的回访
• 设置回访时间段配置

详细的回访管理操作请参考 回访管理 文档。

---

6. 问卷表单

问卷表单管理用于维护项目关联的问卷，支持创建表单绑定、查看填写状态和分析填写数据。

6.1 列表说明

6.2 搜索筛选

• 表单名称：输入关键字搜索
• 使用场景：下拉选择特定使用场景

6.3 工具栏操作

6.4 行操作

6.5 填写分析

点击"分析"按钮打开分析抽屉，展示以下统计指标：

分析抽屉还支持导出 Excel 和修复数据同步操作。

---

7. 礼金记录

礼金记录展示项目下所有志愿者的礼金变动流水，为只读列表。

7.1 列表说明

7.2 搜索筛选

• 用户姓名：输入关键字搜索
• 业务类型：下拉选择特定业务类型

7.3 导出

点击"导出礼金记录"按钮可导出当前列表数据。文件名格式为：项目{projectId}_礼金记录.xlsx。

需要权限 tvp:reward-record:export。

---

8. 签到管理

签到管理包含两个子标签页：签到记录和签到配置。

8.1 签到记录

展示已报名志愿者的签到数据列表。

搜索筛选：支持按用户手机号、用户姓名、申请状态筛选。

行操作：

8.2 签到热力图

热力图弹窗提供直观的签到可视化：

• 统计指标：有效统计天数、已签到天数、签到率、最长连续签到、当前连续签到
• 颜色说明：灰色=非有效期，黄色=有效期内未签到，绿色=已签到
• 日期选择器：可切换热力图的截止日期
• 顶部信息：项目名称、志愿者姓名、手机号、项目起止时间

8.3 签到配置

在此管理签到相关的配置项（如签到方式、签到规则等），与"配置管理"中的签到配置联动。

---

常见问题（FAQ）

Q：为什么我看不到某些操作按钮？

A：操作按钮根据你的权限和记录状态动态显示。如果你缺少某个按钮，可能是你没有对应的操作权限，请联系管理员。部分按钮仅在特定状态下才会出现，例如"审批"按钮仅在"待审核"或"审核失败"状态下可见。

Q：批量审核时，如何退出批量审核模式？

A：点击工具栏中出现的"取消批量审核"按钮即可退出。退出后列表会恢复正常显示，并提示"已退出批量审核模式"。

Q：上传审核的 Excel 文件格式有什么要求？

A：仅支持 .xls 和 .xlsx 格式。建议先点击弹窗中的"下载模板"获取标准模板（批量报名导入模板.xlsx），按照模板格式填写后上传。

Q：导出时可以自定义导出哪些列吗？

A：可以。点击"导出"按钮后，在弹窗中勾选你需要导出的字段，支持全选和取消全选。系统还会根据动态获取的列信息展示所有可导出字段。

Q：志愿者被踢出后还能重新加入吗？

A：可以。被踢出的志愿者状态变为"已退出"，此时操作列会出现"拉回"按钮，填写拉回原因后即可恢复。

Q：身份证号为什么显示不完整？

A：出于隐私保护，身份证号中间部分会以星号脱敏显示，仅显示前 4 位和后 4 位。

Q：问卷进度标签的颜色代表什么含义？

A：红色（error）= 未填写任何表单；橙色（warning）= 部分填写；绿色（success）= 全部填写完成。

Q：配置管理和高级报名配置有什么区别？

A：配置管理处理基本的报名规则（如自动审核、区域限制、年龄限制、性别要求等）和项目信息（如标签赋予、签到配置、礼金配置等）。高级报名配置则提供更精细化的筛选：按标签限制报名资格、按指标数据评分范围筛选、按性别分组设置不同的年龄和人数限制。

Q：签到热力图中不同颜色代表什么？

A：灰色=非项目有效期的日期；黄色=项目有效期内但该志愿者未签到；绿色=该志愿者已签到的日期。

---

操作速查表

---

名词解释