预付费管理
预付费管理模块面向公寓、宿舍、园区租赁等场景，负责水电余额、租客绑定、充值消费和收费规则配置。
这部分页面职责已经和前端实现保持一致，核心页面包括：
- 房间管理
- 租客管理
- 充值明细
- 消费明细
- 系统设置
房间管理
访问路径：能耗中心 → 预付费管理 → 房间管理
房间管理是预付费模块的主入口，重点处理：
- 查看楼栋、楼层、房间结构
- 查看每个房间的水电余额
- 查看欠费、断供、入住状态
- 执行房间级控制或管理动作
这个页面更接近“预付费业务首页”。
如果要先判断哪些房间欠费、哪些房间异常，通常直接从房间管理开始。
租客管理
访问路径：能耗中心 → 预付费管理 → 租客管理
租客管理用于维护房间与人员的关系，常见用途包括：
- 绑定租客
- 查看入住人员
- 审批或管理授权关系
- 做退租或解绑
这个页面回答的是“谁在使用这个房间”。
它本质上是把“房间账户”和“实际使用者”关联起来。
充值明细
访问路径：能耗中心 → 预付费管理 → 充值明细
充值明细用于查看历史充值记录，通常关注：
- 充值时间
- 充值金额
- 充值方式
- 对应房间
- 操作人或来源
适合财务核对和业务追溯。
如果用户说“我明明充过值”，优先查充值明细。
消费明细
访问路径：能耗中心 → 预付费管理 → 消费明细
消费明细用于查看账户扣费情况，常见用途包括：
- 查询某房间的消费流水
- 核对水电扣费是否符合预期
- 解释用户余额变化
如果用户说“余额怎么少了”，优先查消费明细。
系统设置
访问路径：能耗中心 → 预付费管理 → 系统设置
系统设置用于维护预付费业务规则，例如：
- 水电单价
- 预警阈值
- 自动断供开关
- 延迟断供参数
- 支付相关配置
这个页面决定预付费业务的计费和管控规则，修改前需要明确业务口径。
它不是日常高频操作页，但一旦修改，会直接影响后续计费和控制行为。
使用建议
- 先完成区域与房间结构，再启用预付费业务
- 先配置计费规则，再进行正式充值和扣费
- 出现余额争议时，优先对照充值明细和消费明细
关联说明
预付费模块的前端页面结构和职责说明，来自 org-energy 应用当前实现。
如需继续追具体字段和接口口径，可结合前端设计稿与接口定义进一步细看。
更新日志
2026/5/19 22:14
查看所有更新日志
31a81-于
