任务中心运维

一、插件简介

任务中心为社区用户提供可领取、可完成的运营任务，完成条件满足后自动或经审核发放积分、金币、勋章及实物奖励。支持站长后台创建任务，也可开放符合权限的用户前台发布任务（需审核）。

URL 后缀说明：路径示例为 /taskcenter.html；后缀继承社区插件 url_suffix 配置（默认 html），留空则无后缀。

二、核心能力

三、依赖与安装

1. 必须先安装并启用 `community`（BBS社区）——任务进度依赖社区发帖、回帖、点赞及积分体系。
2. 软依赖（按任务类型）：signin（签到天数）、invite（邀请人数）、badge（勋章数量）。
3. 软依赖 message：任务相关系统通知。
4. 安装执行 install.sql，创建 taskcenter_task、taskcenter_record 表。
5. 安装后自动注册后台菜单，并向社区顶部导航写入「任务中心」入口。

四、应用中心基础配置

字段来自 TaskcenterPlugin::configSchema()：

五、后台/重点配置

后台 任务中心（/admin/taskcenter）创建/编辑任务，主要字段：

内置任务类型

六、前台用户流程

1. 登录后访问 /taskcenter.html，浏览可领取任务。
2. 点击「领取任务」→ 系统创建领取记录，开始统计进度（内置类型自动同步）。
3. 达成条件后：

• 自动任务：系统自动完成并发放奖励；
• 需审核任务：用户点击「提交完成」→ 等待管理员审核。

1. 「我的任务」/taskcenter/my.html 查看进行中/已完成记录。
2. 若开启用户发布：有权限用户进入 /taskcenter/publish.html 填写任务信息；管理员审核通过后上架。

前台 API 路由

七、后台审核与运维

审核通过后自动发放奖励；驳回可通知用户（需 message 插件）。

八、特殊说明

生命周期钩子

TaskcenterPlugin 实现：

• afterTopicSave：新帖发布后同步发布者任务进度
• afterReplySave：回帖后同步
• afterTopicLiked：帖子获赞后同步作者被赞任务

积分流水

新增金币类型标签：task（任务奖励）、task_publish（发布任务预扣/扣费）。

导航

ensureNavItem() 向社区导航写入「任务中心」；卸载时自动移除。

九、推荐上线清单

• 确认 community 已运行
• 安装 signin、invite、badge（若使用对应内置任务）
• 安装 message 并开启任务相关通知
• 应用中心配置页面标题与是否开放用户发布
• 后台创建首批官方任务并测试领取→完成→发奖
• 测试需审核的「其他任务」全流程
• 检查社区导航是否出现「任务中心」

十、常见问题

Q：领取后进度一直为 0？ 确认任务类型依赖的插件已安装；发帖/回帖后触发 sync，也可在前台手动点同步。

Q：签到天数任务不计数？ 需安装 signin 插件；统计自领取任务时起算。

Q：用户发布任务被扣积分但未上架？ 用户发布需管理员在「任务审核」通过后才展示；驳回应退还预扣（以实际业务逻辑为准）。

Q：前台看不到发布入口？ 检查「用户发布任务」开关及「可发布用户组」；后台管理员始终可发布。

Q：勋章奖励未到账？ 确认已安装 badge 插件且勋章 ID 有效、状态为启用。