每日签到运维

一、插件简介

每日签到插件为已登录用户提供前台打卡能力，按连续签到天数匹配阶梯奖励，发放社区积分与金币。入口位于社区顶栏签到按钮，点击弹出签到面板。

URL 后缀说明：API 路径同样受社区 url_suffix 影响，例如 /signin/status.html；以实际配置为准。

二、核心能力

三、依赖与安装

1. 必须先安装并启用 `community`（BBS社区）——签到入口挂载在社区顶栏，奖励走社区积分/金币体系。
2. 软依赖 message：签到成功系统通知（plugin.json 描述中说明）。
3. 安装执行 install.sql，创建 signin_user、signin_log 表。
4. 后台仅注册「签到记录」菜单；开关与阶梯在应用中心配置（旧版独立「签到设置」菜单已移除）。

四、应用中心基础配置

字段来自 SigninPlugin::configSchema()：

阶梯规则说明

• 每行一档：连续天数:积分:金币
• 实际发放取「当前连续天数 ≥ 档位天数」的最高一档
• 积分或金币填 0 表示该项不发
• 默认示例：1:5:0、3:10:1、7:20:5、15:50:10、30:100:30

五、后台/重点配置

无独立后台配置页；阶梯奖励仅在应用中心维护。

后台 签到记录（/admin/signin_log）：

• 查看用户签到历史列表
• 用于运营核对与客诉处理

六、前台用户流程

1. 用户登录社区后，顶栏出现日历图标按钮。
2. 点击按钮打开「每日签到」弹窗，自动请求 /signin/status 加载状态。
3. 若今日未签，点击「打卡签到」→ POST /signin/check。
4. 签到成功：更新连续天数、发放阶梯奖励、按钮变为「今日已签」。
5. 若安装 message 且开启「签到成功通知」，用户可在消息中心收到系统通知。

七、后台审核与运维

本插件无审核流程。运维主要工作：

• 定期查看签到记录，排查异常刷签
• 调整阶梯奖励策略（应用中心修改后对新签到生效）

八、特殊说明

钩子插槽

静态资源

• /static/signin/signin.css
• /static/signin/signin.js
• 全局变量 window.__SIGNIN__ 含 statusUrl、checkUrl

与任务中心

taskcenter 的 signin_days 类型任务统计用户自领取起的签到天数，需本插件启用。

九、推荐上线清单

• 确认 community 已启用
• 应用中心开启签到并配置阶梯奖励
• 安装 message 并开启「签到成功通知」（可选）
• 前台登录后测试签到弹窗与奖励到账
• 若使用任务中心，创建签到天数任务并验证进度
• 检查连续签到跨日、断签逻辑是否符合运营预期

十、常见问题

Q：顶栏没有签到按钮？ 确认已登录、插件已启用；未登录不显示入口。

Q：签到成功但没收到通知？ 需安装 message 插件，并在消息配置中开启「签到成功通知」。

Q：奖励与配置不一致？ 检查阶梯格式是否为 天数:积分:金币；取满足条件的最高档，非累加各档。

Q：修改阶梯后老用户连续天数会变吗？ 连续天数按签到记录计算，不受阶梯配置修改影响；新档位仅影响后续签到发放金额。

Q：能否补签？ 当前版本不支持前台补签，仅支持每日一次打卡。