智慧村务管理系统
版本：V1.0

### 一、角色与目标

你是一名长期做基层政务信息化的全栈工程师。请为我搭建一套 **村级智慧村务管理系统**，面向村党支部书记、村委会主任、村会计、网格员四类使用者，解决"人口底数不清、一户一档散落、收费靠本子、公开靠张贴"的问题。

交付形态：**单页网页应用（SPA）**，打开即用，无需登录即可演示；数据保存在浏览器本地（localStorage），支持增删改查与导出。

### 二、业务场景（必须先理解，再动手）

- 服务对象是一个行政村（示例：江苏省徐州市铜山区青山镇马庄村），下辖 6 个村民小组、6 个基础网格。
- 村委会日常要处理：人口与户籍台账、一户一档、特殊群体走访、土地房屋确权、党员与综治、信用积分、证明开具、集体资金收支、**按人收缴的卫生费/合作医疗/农业保险**、惠农补贴、集体资产合同、票据、村务公开。
- 村干部普遍不熟悉电脑，要求：**菜单扁平、字段少而准、每条数据都能一键导出、所有金额按分显示、所有状态用颜色而非文字去判断**。

### 三、信息架构（左侧导航，三组共 16 个模块）

**第一组 · 基础档案**

1. 人口数据 —— 总览看板：户籍人口、常住户数、60 岁以上及占比、低保/特困、党员数、耕地面积 6 个 KPI；人口年龄结构柱状图（0-14 / 15-34 / 35-59 / 60-79 / 80+）；户籍人口居住状态环形图（常住 / 外出）；各村民小组人口分布柱状图；待办提醒（卫生费欠缴、医保未参保、合同临期、未办结纠纷、数据质量待整改，可点击跳转）；村情概况、集体经济收支、重点人群、快捷入口。
2. 村民信息 —— 全员成员级台账（示例 1013 条），支持按姓名/身份证/电话检索，按小组、居住状态、身份类型（党员/低保/特困/残疾/退役军人/留守老人/留守儿童/80 岁以上）、年龄段筛选；身份证与手机号脱敏展示；一键导出当前筛选结果。
3. 一户一档 —— 365 户列表（户号、户主、人口、住址、承包耕地、宅基地、户类别、信用分），点击打开右侧抽屉档案：户基本信息、家庭成员表、土地与房屋（含确权证号、不动产权证号）、本年度缴费情况。
4. 特殊群体 —— 按低保、特困供养、残疾、留守老人、留守儿童、大病、退役军人分类 Tab 统计与名册，显示帮扶责任人、最近走访时间，支持"登记走访"。
5. 土地房屋 —— 承包地 / 宅基地 / 房屋三个 Tab；承包地含地块编号、面积、流转面积、确权证号；宅基地含面积、是否符合标准（宅基地 > 200㎡ 标记超标待核）；房屋含结构、建成年代、房龄、安全等级。
6. 数据质量 —— 自动体检：身份证缺失、身份证校验位错误（按 GB 11643 校验）、出生日期与身份证不一致、联系电话缺失、户主关系不规范、有承包地无确权证、宅基地无产权证；展示档案完整率、问题总数、高危数、已整改数、四类规则命中情况、问题类型分布图；问题清单可"标记已核"（核销后从待整改中移除并计数）。

**第二组 · 乡村治理**

7. 党群治理 —— 党员总数、60 岁以上党员、三会一课次数、党费收缴率；党员名册（入党时间、正式/预备、联户情况）；三会一课记录（类型、主题、时间、地点、应到/实到、主持人、结论）；党费收缴（月标准 10 元、应缴月数、累计应缴、实缴、状态）。
8. 综治中心 —— 本年受理、待办、已办结、化解率、重点人员 5 个指标；矛盾纠纷台账（编号、类型、简述、当事人、发生地、网格、上报时间、状态、承办人），支持新增受理与办结（办结必须填写处理结果）；重点人员（社区矫正、安置帮教、严重精神障碍、重点上访等，姓名用"某"脱敏，含管控责任人、最近走访）；网格事件按 6 个网格统计上报/办结/办结率。
9. 信用体系 —— 农户信用积分（基础 82 分，费用缴清 +7，欠费 -5~-10，党员家庭 +4，集体合同履约 +3，退役军人家庭 +2，涉未结纠纷 -6，限制 60~100 分），等级 AAA/AA/A/B 分布环形图、平均分、评分规则公开说明、按户明细（加分项、扣分项、可用场景）。
10. 档案证明 —— 7 类模板（居住、户籍情况、收入情况、宅基地权属、无房、死亡情况协查、学生社会实践）；选模板 + 选村民 + 填用途即可开具，自动生成编号 ZM2026xxx 并归档，支持按模板套打（A4 版式，落款为村委会并留盖章位）。

**第三组 · 财务与公开**

11. 村务财务 —— 本年收入/支出/结余/账面余额（含期初）、支出结构环形图（按科目）、季度收入柱状图、收支明细（日期、摘要、科目、类型、金额带正负色、凭证号、经办人），支持"记一笔"（类型/金额/科目/摘要/经办人，自动生成凭证号）。
12. 收费管理 —— **核心模块，详见第四节**。Tab：合作医疗 / 卫生费 / 农作物保险 / 自定义项目。
13. 补贴管理 —— 补贴项目台账（耕地地力保护 120 元/亩、种粮一次性补贴 25 元/亩、低保金 830 元/人·月、特困供养 1100 元/人·月、高龄津贴 50 元/人·月、残疾人两项补贴 80 元/人·月），显示发放标准、计发依据、涉及人数、发放金额、状态（已发放/按月发放/待发放）、发放时间、备注，金额须由面积/人数实时计算而非写死。
14. 合同管理 —— 集体资产发包租赁合同（编号、名称、标的、承租方、面积、年租金、起止、付款方式、状态）；到期倒计时（90 天内提醒、已到期标红）；顶部到期提醒条；"续签登记"（新到期日、年租金、说明），提示需走"四议两公开"并公示。
15. 发票管理 —— 票据登记（发票号、类型：村集体收款收据/增值税普通发票、开票日期、交款方、项目、金额、状态：已入账/待入账、经办人），支持"登记发票"，自动生成票据号。
16. 村务公开 —— 公开事项台账（标题、类别、公示起止、状态、查看次数），发布公开事项（标题/类别/公示天数/内容），公示中可"结束公示"归档；详情抽屉展示公开内容与公示要求（7-15 天、渠道、异议处理）。

### 四、核心页面规格：收费管理（必须重点还原）

这是整套系统最有说服力的页面，请严格按以下结构实现：

**1）顶部 Tab**：合作医疗 / 卫生费 / 农作物保险 / 自定义项目（最后一个点击进入自定义项目列表，可"新增收费项目"）。

**2）台账标题区**：`{项目名}年度台账`，副标题写明计费口径，例如"按户建档、按人收缴 · 用于垃圾清运和保洁员报酬"，右侧标"2026 年度"。

**3）三张统计卡**

- 应收金额：`¥24,312.00` + `365 户`，脚注"应缴人数 1013 人"。
- 已缴金额：绿色金额 + 收款率百分比，下方绿色进度条，脚注"已缴清 191 户 / 已缴明细 757 条"。
- 欠缴金额：红色金额 + `188 户未缴清`，脚注"集中征缴截止 2026-11-30"。

**4）工具条**：搜索框（户主姓名 / 身份证 / 户号 / 住址）+ 分段筛选（全部 / 未缴清 / 已缴清）+ 右侧结果计数。

**5）主表格**（列宽需精心分配，不允许挤压换行）

| 列           | 内容                                                         |
| ------------ | ------------------------------------------------------------ |
| 户主         | 首字方块头像 + 姓名 + "小组 · 户号"                          |
| 成员缴费状态 | 每个成员一枚 chip：已缴为绿色带 ✓ + 姓名，未缴为灰色带 ○ + 姓名；按亩计费项目显示"耕地 X 亩 · 金额" |
| 应缴 / 已缴  | 右对齐金额，已缴满用绿色                                     |
| 状态         | 已缴清（绿）/ 部分缴纳（黄）/ 未缴（红）                     |
| 操作         | "登记缴费" + "明细"                                          |

**6）交互**

- 点"登记缴费"弹窗：显示缴费户、项目、未缴人数、应缴金额，选择缴费方式（微信/现金/银行代扣）与日期，确认后整户未缴记录置为已缴，并回写收费台账。
- 点"明细"打开抽屉：分人列出姓名、与户主关系、金额、状态、缴费时间、方式，可逐人登记或撤销（撤销用于误操作更正）。
- 顶部按钮："新增收费项目""导出年度汇总""导出催缴名单"（催缴名单只含未缴清户，字段：户号、户主、小组、电话、住址、欠缴金额、欠缴人数）。
- "新增收费项目"：名称、计费方式（按人/按户/按亩）、单价、说明；创建后自动为全村生成未缴台账，并出现在 Tab 中。

**7）数据口径**

- 卫生费 24 元/人·年；合作医疗 380 元/人·年；农作物保险 12 元/亩·年（无承包地的户不生成记录）。
- 同一户的卫生费缴费倾向应一致（避免出现"同一户一半缴一半不缴"的失真数据）。
- **缴费记录一致性铁律**：`paid=true` 必须有 `paidAt` 与 `method`；`paid=false` 必须两者为空。

### 五、数据模型（字段级）

```text
household  { id, code(户号 MZ-0001), group(1-6), address, headId, headName,
             members[], land{arable, forest, plotNo, certNo, transferred},
             house{base, build, structure, builtYear, certNo}, tags[], settleYear }

member     { id, name, gender, birth, idcard(18位含校验位), phone, relation,
             edu, job, status(常住/外出), marital, tags[], party, partyDate, partyType, lowIncome }

payment    { id, fee(medical|sanitation|crop|自定义key), householdId, memberId|null,
             amount, paid, paidAt, method }

feeType    { key, name, full, basis(person|household|land), unit, unitText, year, note, custom }

incident   { id, type, title, parties, place, grid, reportAt, status, handler, result, level }
contract   { id, name, party, target, area, rent, start, end, status, payCycle }
ledger     { id, date, kind(收入/支出), subject, summary, amount, operator, voucher }
subsidy    { id, name, standard, base, count, amount, status, date, note }
cert       { id, type, person, householdId, memberId, purpose, date, operator, status }
disclosure { id, title, cat, start, end, status, views, content }
```

### 六、演示数据要求

- 用**固定随机种子**生成，保证每次刷新数据一致；总量：365 户、约 1013 人、户均 2.78 人。
- 年龄结构贴近农村：0-14 岁约 23%、15-34 岁约 14%、35-59 岁约 39%、60 岁以上约 24%。
- 身份证按 `320305 + 出生日期 + 顺序码 + MOD 11-2 校验位` 生成并通过校验；手机号 11 位。
- 姓名池要有地域真实感（马庄村马姓占比高），不要用"张三李四王五"。
- 故意注入少量脏数据供"数据质量"模块检出：9 条缺手机号、5 条缺身份证、3 条校验位错误、2 条生日与身份证不一致、4 条关系填"其他"。
- 缴费率参考真实收缴情况：卫生费约 75%、合作医疗约 90%、农险约 70%。

### 七、视觉与交互规范

- 左深蓝导航（`#1d4269 → #142e48` 渐变）+ 浅灰内容区（`#f2f5fa`），主色 `#2f7cf6`，成功 `#12b76a`，警示 `#f79009`，危险 `#d92f20`。
- 导航 16 项按三组用细分割线隔开，选中项为半透明蓝色块 + 左侧 3px 亮蓝条。
- 顶栏：面包屑标题 + 全局搜索（姓名/身份证/电话，回车直达村民档案）+ 年度标签 + 用户信息。
- 卡片圆角 12px、1px 浅边框、极轻阴影；表格行高 38~40px、表头浅蓝灰底、数字右对齐并使用等宽数字。
- 状态一律用"圆点 + 颜色"或彩色 chip，不要只用文字。
- 抽屉从右侧滑出（宽 620px），弹窗居中（宽 460~560px），保存后 Toast 提示 2 秒。
- 所有列表支持分页（每页 10~14 条）；所有模块右上角都要有导出按钮（CSV，带 BOM 以便 Excel 正确显示中文）。
- 响应式：<1080px 侧栏收为图标栏，<860px 卡片单列。

### 八、技术约束

- 纯前端：`index.html` + `assets/css/style.css` + `assets/js/{data,app,views-*}.js`，**不引入任何第三方库或 CDN**（图表用 CSS/SVG 手写，避免离线打不开）。
- 路由用 hash（`#/fees`），刷新保持当前页。
- 所有写操作立即写 localStorage 并提示；提供"重置演示数据"入口。
- 不得出现控制台报错；不得出现 `undefined`、`NaN`、`Invalid Date`。
- 金额统一两位小数并加千分位；身份证、手机号默认脱敏，详情页可见完整值。

### 九、验收清单（自检通过再交付）

- [ ] 16 个模块均可打开，页面无空白、无报错、无横向溢出
- [ ] 收费管理三个 Tab 的数据互相独立且统计与明细对得上（应收 = 各户应缴之和）
- [ ] 登记缴费后：已缴金额、收缴率、已缴清户数、该户状态、信用分同步变化
- [ ] 新增收费项目后自动生成全村台账并可进入
- [ ] 一户一档抽屉能看到成员、土地房屋、三项缴费
- [ ] 证明开具后生成编号并可打印（A4 公文版式）
- [ ] 数据质量"标记已核"后待整改数减少
- [ ] 综治新增/办结、财务记账、村务公开发布均可保存且刷新不丢
- [ ] 导出的 CSV 用 Excel 打开中文不乱码
- [ ] 手机宽度下可正常浏览

### 十、交付要求

1. 交付可运行的项目文件，并在本地启动预览通过。
2. 发布成在线链接，链接可直接打开使用。
3. 附一份"模块说明 + 数据口径"简表，方便村干部上手。