村务后台 — 户号管理
学这个要多久：25 分钟
你能做什么：建户号、查户号、改户主
适合谁：村委文员关联 SOP：
- 建户号 / 加成员：参考 《家庭成员录入 SOP》
- 改户主：参考 《户主变更 SOP》
- 分户：参考 《分户 SOP》
一、这是做什么的
「户号」是家庭单元——一户人家 = 一个户号。
- 一户有一户主（head_user_id）
- 一户有 N 个成员（在 household_members 表里）
- 户号有"户籍号"（household_no，13 位数字，村会计 / 户籍警分配）
你通过这个模块管理所有户号，不直接管每个成员（成员管理在 05-家庭成员.md）。
二、怎么进入
┌─────────────────────────────────────┐
│ 〔首页〕 〔公告〕 〔用户〕 〔户号〕 ... │
│ ↑ │
│ 点这个 │
└─────────────────────────────────────┘
- 顶部菜单 → 〔户号〕
- 点一下 → 进入
三、你会看到什么
┌──────────────────────────────────────────────────────────────────┐
│ 村务后台 〔👤 张三〕 〔修改密码〕 〔退出〕│
├──────────────────────────────────────────────────────────────────┤
│ 〔首页〕 〔公告〕 〔用户〕 〔户号〕 〔电费〕 〔办事〕 〔投诉〕 ... │
├──────────────────────────────────────────────────────────────────┤
│ 🏠 户号管理 │
│ │
│ 〔 🔍 搜索：户号/户主/地址 〕 〔村庄：本村 ▼〕 〔 + 新建户号 〕│
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ 户号 │ 户主 │ 成员数 │ 地址 │ 村庄│操作│ │
│ ├─────────────────────────────────────────────────────────────┤ │
│ │ 320100001 │ 张三 │ 4 │ 村东头 1 组 │ 本村│... │ │
│ │ 320100002 │ 王五 │ 3 │ 村西头 3 组 │ 本村│... │ │
│ │ 320100003 │ 大队户号 │ 0 │ 村委办公室 │ 本村│... │ │
│ │ ... │ │ │ │ │ │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ 共 432 户 <上一页 1 2 3 ... 9 下一页> │
└──────────────────────────────────────────────────────────────────┘
四、每列是什么意思
| 列 | 含义 | 注意 |
|---|---|---|
| 户号 | 户籍号（13 位数字，派出所 / 村会计分配） | 不要自己编 |
| 户主 | 这一户的户主姓名 | 大队户号显示"大队户号" |
| 成员数 | 这一户有多少人 | 包括已故的 |
| 地址 | 户籍地址 | 跟派出所一致 |
| 村庄 | 属于哪个村 | 默认本村 |
| 操作 | 〔查看〕〔编辑〕〔删除〕 | 关键操作 |
五、常用操作
操作 1：新建户号
什么情况要新建户号：
- 村里新生儿独立成户（少见）
- 儿子结婚后从父母户号分出
- 村里新立一户（迁入 / 复户）
- 点 「右上角」 蓝色按钮 〔+ 新建户号〕
- 弹出窗口：
┌──────────────────────────────────┐
│ 新建户号 │
├──────────────────────────────────┤
│ │
│ 户号*： ┌──────────────────┐ │ ← 必填，13 位数字
│ │ │ │
│ └──────────────────┘ │
│ │
│ 户主*： 〔下拉选，选村民 ▼〕 │ ← 必填
│ │
│ 村庄*： 〔本村 ▼〕 │
│ │
│ 户籍地址*：┌──────────────────┐ │ ← 必填
│ │ │ │
│ └──────────────────┘ │
│ │
│ 登记日期： 〔2026-10-14〕 │ ← 默认今天
│ │
│ 备注： ┌──────────────────┐ │
│ │ │ │
│ └──────────────────┘ │
│ │
│ 【取消】 【保存】 │
└──────────────────────────────────┘
- 填户号 → 跟村会计 / 户籍警要（绝对不能编！）
- 选户主 → 〔下拉选〕 → 选村民（必须是已经录入 users 表的人）
- 村庄 → 默认本村
- 户籍地址 → 跟户口本 / 房屋证明一致
- 登记日期 → 默认今天，可改
- 备注 → 选填
- 点 【保存】
✅ 看到「保存成功」= 户号建立
如果户主是"大队户号"（路灯 / 村委办公）：
- 户主字段留空（选"无"或留空）
- 在"备注"写"大队集体户号"
操作 2：看户号详情
- 列表找户号
- 点「操作」列 → 〔查看〕（眼睛图标）
- 弹出详情页：
┌────────────────────────────────────────┐
│ 户号详情 │
├────────────────────────────────────────┤
│ 户号：320100001 │
│ 户主：张三 │
│ 户籍地址：村东头 1 组 │
│ 村庄：本村 │
│ 登记日期：2024-01-15 │
│ │
│ 备注：[2026-04-15] 原户主张德山死亡， │
│ 户主由其长子张志强接任。 │
│ │
│ ── 家庭成员 ── │
│ ┌──────────────────────────────────┐ │
│ │ 姓名 │ 关系 │ 身份证 │ 操作 │ │
│ ├──────────────────────────────────┤ │
│ │ 张三 │ 户主 │ 410****1234 │ ... │ │
│ │ 李梅 │ 妻子 │ 410****4321 │ ... │ │
│ │ 张小明│ 儿子 │ - │ ... │ │
│ │ 张大爷│ 父亲 │ 410****1234 │ ... │ │
│ └──────────────────────────────────┘ │
│ │
│ 〔+ 添加成员〕 〔 修改户主 〕 〔关闭〕│
└────────────────────────────────────────┘
- 在这里可以：
- 〔+ 添加成员〕→ 跳到家庭成员录入（见 05-家庭成员.md）
- 〔修改户主〕→ 跳到户主变更（见下方 操作 3）
- 〔关闭〕→ 关掉弹窗
操作 3：改户主（重要！操作前必看 SOP）
改户主的"系统侧"操作：1 个 PUT API，封装 3 处改动（户号主表 head_user_id + 两条 member 的 relation 字段）
手工流程：详见 《户主变更 SOP》
- 户号详情页 → 〔修改户主〕 按钮
- 弹出对话框：
┌────────────────────────────────┐
│ 修改户主 │
├────────────────────────────────┤
│ 原户主：张三（户主） │
│ │
│ 新户主： 〔下拉选 ▼〕 │ ← 只能选本户现有成员
│ │
│ 变更原因： │
│ ◉ 户主死亡 │
│ ○ 户主迁出 │
│ ○ 招婿 │
│ ○ 其他（请说明） │
│ │
│ 生效日期：〔2026-10-14〕 │
│ │
│ 备注： │
│ ┌────────────────────────┐ │
│ │ 原户主张三于 2026-XX-XX │ │
│ │ 去世，户主由其长子... │ │
│ └────────────────────────┘ │
│ │
│ 系统将自动： │
│ - 户号主表 head_user_id 改为新户主 │
│ - 原户主 member.relation 改回原血缘（系统会让您选）│
│ - 新户主 member.relation 改为"户主"│
│ - 在户号主表"备注"追加变更记录 │
│ │
│ 【取消】 【下一步】 │
└────────────────────────────────┘
- 选新户主（必须在本户成员里，否则下拉选里没有）
- 选变更原因
- 填生效日期
- 填备注（必须填，简要说明）
-
点 【下一步】
-
第二步对话框：选原户主的"原血缘关系"
┌────────────────────────────────┐
│ 原户主关系修正 │
├────────────────────────────────┤
│ 原户主张三当前的"关系"是"户主"│
│ │
│ 改为： │
│ ◉ 父亲 │ ← 选血缘关系
│ ○ 母亲 │
│ ○ 祖父 │
│ ○ 祖母 │
│ ○ 其他 │
│ │
│ 【上一步】 【确认】 │
└────────────────────────────────┘
- 选血缘（"户主"是行政身份，"父亲 / 母亲" 才是血缘关系）
- 点 【确认】
✅ 看到「户主变更成功」= 改完
⚠️ 如果新户主不在本户成员里：对话框会卡住，提示"新户主不是本户成员"。先走 《家庭成员录入 SOP》 把新户主加进去，再回来做户主变更。
操作 4：编辑户号主表
- 列表找户号
- 点「操作」列 → 〔编辑〕（铅笔图标）
- 弹出和「新建」一样的窗口，内容已填好
- 改"户籍地址 / 备注"等
- 不要在这里改"户主"（要走"操作 3 修改户主"流程）
⚠️ 不要在编辑里改户主——会漏改家庭成员的 relation 字段
操作 5：删除户号
🛑 删除是不可逆的！ 误删只能联系系统管理员从备份恢复
- 列表找户号
- 点「操作」列 → 〔删除〕（垃圾桶图标）
- 弹窗 〔确认删除?〕
- 看到户号 + 户主姓名，核对 2 遍
- 点 【确认删除】
什么情况要删：
- 户号是误建的（建错了）
- 整户销户（先把所有成员迁出，再删户号）
什么情况不要删：
- 户主死亡（改户主，不是删）
- 一户人全迁出（走 《分户 SOP》，不要直接删）
- 户号里还有成员（先迁出成员，再删户号）
操作 6：批量导出
- 勾要导出的户号（或点全选 ☐）
- 顶部 〔批量导出〕 按钮
- 选 Excel / CSV → 下载
六、不会了怎么办（FAQ）
Q1：新建户号时"户主"下拉选是空的？
- 选的那个人没在 users 表 → 先去 03-用户管理.md 录入
- 选"大队户号" → 户主字段留空即可
Q2：户号 13 位我编了一个，但被提示冲突？
- 户号不能自己编！
- 跟村会计 / 户籍警要，他们那里有官方分配表
- 冲突说明这个号已经在用了
Q3：能改户号吗（换号）？
- 理论上能改（操作 4），但不建议！
- 户号跟派出所户籍簿绑定，改了系统会对不上纸质的
- 如果确实要改（派出所重新分号），先通知村会计改纸质档案，再改系统
Q4：户号主表"备注"里那一串 [YYYY-MM-DD] 是什么？
- 户主变更 / 户主分户等操作时，系统自动追加的变更记录
- 不要手动改这段
- 手动改会破坏历史追溯
Q5：成员数看着不对？
- 刷新页面（Ctrl + F5）
- 看"家庭成员"标签里实际有几行
- 还是不对 → 走 《家庭成员录入 SOP》 第八节"季度自查"
七、改错了怎么办
| 情况 | 怎么办 |
|---|---|
| 户号填错了 | 操作 4 〔编辑〕改（改前确认派出所纸质档案） |
| 户主选错了 | 操作 3 〔修改户主〕 → 选回原户主 |
| 误删除户号 | 立即联系系统管理员（从备份恢复） |
| 改完户主后家庭成员 relation 没改 | 这是 bug → 联系系统管理员（手动 SQL 修） |
备注里那段 [YYYY-MM-DD] 被人手动改坏了 |
不要自己改回，找系统管理员看 audit log |
八、撰写户号记录的好习惯
✅ 建户号前：
- 户号问村会计 / 户籍警要
- 户主确认已经录入 users 表
- 地址跟户口本一致
✅ 改户号时：
- 改地址前确认派出所也改了
- 改户主走"操作 3"流程，不要手动改 relation
- 备注里自动追加的变更记录不要碰
✅ 删户号前：
- 确认户号里没人了（所有人都迁出 / 销户）
- 跟村会计 / 户籍警二次确认
- 找不到户号先停——可能是有人改地址了，不是删了
下一步：
- 加成员：跳 05-家庭成员.md
- 分户：参考 《分户 SOP》