村务后台 — 定时任务

学这个要多久：5 分钟
你能做什么：查看系统自动跑的定时任务状态、开关任务、手动触发一次
适合谁：系统管理员（super_admin 专属，普通管理员看不到这个菜单）

一、这是做什么的

系统里有几件到点自动干的事，不用人管：

这个页面就是看它们跑得好不好、必要时手动补跑一次的地方。

二、怎么进入

┌─────────────────────────────────────┐
│ 〔首页〕 ... 〔系统管理〕 ▼           │
│                        └→〔定时任务〕 ← 点这个
└─────────────────────────────────────┘

• 顶部菜单 → 〔系统管理〕→〔定时任务〕
• 页面顶部有三张统计卡：任务总数 / 今日运行 / 近 7 日失败

三、你会看到什么

┌──────────────────────────────────────────────────────────────────┐
│  ⏰ 定时任务          [总数 3] [今日运行 5] [近7日失败 0]          │
│                                                                    │
│  ┌──────────────────────────────────────────────────────────────┐│
│  │ 任务名称              │ 周期      │ 启用 │ 上次运行   │ 结果  ││
│  ├──────────────────────────────────────────────────────────────┤│
│  │ 定时发布公告          │ 每分钟    │  ✓   │ 10:32:00  │ 成功  ││
│  │ 监督一点通公开数据同步 │ 每周一 03:00│ ✓  │ 周一 03:00│ 成功  ││
│  │ 日志归档              │ 每 24 小时│  ✓   │ 昨天 23:00│ 成功  ││
│  └──────────────────────────────────────────────────────────────┘│
└──────────────────────────────────────────────────────────────────┘

每行还能展开看：上次运行信息 / 耗时 / 失败原因。

四、常用操作

操作 1：看某次任务跑没跑成功

• 任务行 → 〔运行记录〕
• 看到每次运行的历史：时间 / 成功失败 / 处理了多少条 / 失败原因

操作 2：手动补跑一次（不想等到下周一时）

• 任务行 → 〔立即执行〕
• 和定时执行走完全相同的逻辑，结果立刻显示
• ⚠️ 「监督一点通同步」手动跑是安全的：唯一键去重，不会插重复数据

操作 3：停用 / 启用某个任务

• 任务行的 启用开关
• 停用后定时不再触发；手动〔立即执行〕仍可跑

五、不会了怎么办（FAQ）

Q1：同步失败"区划解析失败"？

村里的省市区镇村区划码没配对。联系系统管理员，在村庄设置里核对行政区划。

Q2：任务显示"失败"怎么办？

• 先看〔运行记录〕里的失败原因
• 大多是平台接口临时抽风 → 点〔立即执行〕重跑一次通常就好
• 反复失败 → 找系统管理员看 pm2 logs cunwu-api

Q3：今天还没自动发公告？

• 定时发布精确到分钟，等 1 分钟再刷新
• 还不行 → 去 02-公告管理.md 看公告的定时设置对不对

Q4：能改同步时间吗？（比如改成每周五）

• 目前时间固定（每周一 03:00），页面上不能改
• 需要调整找系统管理员改配置

六、好习惯

✅ 每周一看一眼「近 7 日失败」是不是 0
✅ 平台公示没更新时，先手动〔立即执行〕，别干等周一
✅ 别乱关开关 —— 关了监督同步，村务公开里的平台数据就停了

下一步：村民端看 01-首页公告.md