fujian_water_biz_doc/docs/guides/BACKEND_TABLE_MAPPING.md

Backend 真实表清单与数据字典映射

1. 文档目的

本文档用于在 docs/guides/BACKEND_CURRENT_STATUS.md 的模块级分析基础上，进一步补充：

1. backend/ 中已扫描到的真实业务表名清单。
2. 这些表与 docs/design/04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md 的映射关系。
3. 当前后端已实现领域、弱映射领域与明显缺口。

说明：本次范围聚焦三个与福建水务营收最相关的模块：

• backend/sw-business/sw-business-server
• backend/sw-business-bank/sw-business-bank-server
• backend/sw-module-iot/sw-module-iot-biz

因此，sw-module-system、sw-module-infra、sw-module-pay 等模块中的系统表、基础设施表、支付表不在本文主清单内。

2. 扫描口径

本轮真实表识别主要依据以下证据：

• Java DO 上的 @TableName
• Mapper XML / Mapper Java 中直接出现的表名
• 少量作业类、SQL 片段中的直接表名引用

当前结论属于“代码中已命中的真实表”，可信度高于仅根据需求文档或模块名推断的表。

3. 模块级真实表概览

模块	已确认表数量	说明
sw-business-server	69	水务营收主业务表
sw-business-bank-server	13	银行代收/代扣/对账表
sw-module-iot-biz	14	IoT 设备/产品/规则/插件表
合计	96	当前三大核心模块已确认真实表

4. 真实表清单

4.1 sw-business-server

4.1.1 客户与账户类

• biz_cust
• biz_cust_group
• biz_cust_contact
• biz_cust_meter
• biz_cust_invoice
• biz_cust_bill_type
• biz_cust_app_binds
• biz_cust_collection_rel
• biz_cust_withholding_rel
• biz_cust_water_use_scheme
• biz_cust_water_scheme_rel
• biz_cust_no_rule
• biz_cust_hub_marks
• biz_account
• biz_company_account
• biz_dept_account_rel
• biz_dept_cust_no_rule_rel
• biz_community

4.1.2 水表、册本、抄表类

• biz_meter
• biz_meter_model
• biz_meter_caliber
• biz_meter_range
• biz_meter_maker
• biz_meter_book
• biz_meter_read
• biz_reading_data
• biz_last_reading
• biz_reading_logs
• biz_meter_log
• biz_meter_in_out
• biz_meter_in_out_rel

4.1.3 价格、用水方案、费用组成类

• biz_price_category
• biz_price_template
• biz_price_adjustment_snap
• biz_price_cost_adjustment
• biz_price_tier_adjustment
• biz_price_discount_scheme
• biz_price_discount_tier
• biz_price_discount_cost
• biz_cost_component
• biz_water_use_scheme
• biz_water_use_scheme_tier
• biz_exceed_water_use_scheme
• biz_template_dept_rel

4.1.4 收费、托收、代扣、开票类

• biz_charge
• biz_charge_detail
• biz_invoice
• biz_invoice_taxrate
• biz_collection
• biz_withholding

4.1.5 业务办理、流程、资料类

• biz_process
• biz_process_transfer
• biz_process_cust_contact
• biz_process_meter_install
• biz_process_invoice_modifys
• biz_business_types
• biz_business_datas
• biz_content
• biz_content_attach

4.1.6 银行、网点、参数、页面、日志类

• biz_bank
• biz_bank_branch
• biz_parameter_settings
• biz_page_settings
• biz_page_settings_detail
• biz_extend_propertys
• biz_operat_log
• biz_operat_log_detail
• biz_outlets
• sys_wechat_app_settings

4.2 sw-business-bank-server

4.2.1 银行渠道与路由类

• bk_payment_channel
• bk_channel_api_config
• bk_channel_route_rule
• bk_channel_statistics

4.2.2 交易与回调类

• bk_transaction
• bk_transaction_callback
• bk_transaction_exception

4.2.3 托收/代扣批次类

• bk_withholding_agreement
• bk_withholding_batch
• bk_withholding_item
• bk_settlement_batch

4.2.4 对账类

• bk_reconcile_batch
• bk_reconcile_diff

4.3 sw-module-iot-biz

4.3.1 产品与设备类

• iot_product
• iot_product_category
• iot_device
• iot_device_group
• iot_thing_model

4.3.2 规则、告警、桥接类

• iot_rule_scene
• iot_alert_config
• iot_alert_record
• iot_data_bridge

4.3.3 插件与实例类

• iot_plugin_config
• iot_plugin_instance

4.3.4 OTA 类

• iot_ota_firmware
• iot_ota_upgrade_task
• iot_ota_upgrade_record

5. 与数据字典的领域映射

5.1 客户信息域

数据字典中的典型对象包括：客户资料、联系人、客户组、客户应用绑定、托收资料、代扣资料、集收号、主副卡、客户关系、水表信息、开票信息等。

后端已明确对应的表

• biz_cust → 客户资料
• biz_cust_contact → 联系人 / 主联系人类信息
• biz_cust_group → 客户组表
• biz_cust_app_binds → 客户应用绑定关联表
• biz_cust_collection_rel → 客户托收中间表 / 集收关系类
• biz_cust_withholding_rel → 客户代扣中间表
• biz_cust_invoice → 开票信息 / 客户开票信息
• biz_cust_meter → 客户与水表关系
• biz_account、biz_company_account、biz_dept_account_rel → 账户信息 / 水司账户站点关系
• biz_bank、biz_bank_branch → 银行表 / 银行分行表

判断

• 客户主数据、联系人、分组、绑定、托收/代扣关系已经有较明确落表。
• 但数据字典里较细的“主副卡”“客户关系表”“集收号与客户关系表”等，当前后端未看到完全同名的一组独立表，可能被关系表折叠实现，也可能尚未完整下钻到其他模块。

5.2 抄表信息域

数据字典中的典型对象包括：册本表、抄表数据、上次抄表、抄表日志、抄表任务、远传表日志、抄表轨迹等。

后端已明确对应的表

• biz_meter_book → 册本表
• biz_reading_data → 抄表数据
• biz_last_reading → 上次抄表表
• biz_reading_logs → 抄表日志表
• biz_meter_read → 抄表状态 / 抄表任务状态类
• biz_meter_log → 表务/抄表相关日志
• biz_meter、biz_meter_model、biz_meter_caliber、biz_meter_range、biz_meter_maker → 水表主档及型号口径量程厂家基础表

判断

• 抄表基础域在后端中是存在的，而且表结构比当前《sql/lhc_数据库设计.md` 已设计部分更完整。
• 但数据字典中的“稽查任务表”“抄表设备下载同步记录表”“抄表轨迹”“远传表日志表”等，本轮未在这三个模块内看到明显同名实体表。

5.3 账务信息域

数据字典中的典型对象包括：营业账、营业账明细、跨周期水量、特账、特账明细、阶梯累计量、退款账。

后端已明确对应的表

• biz_charge → 营业账 / 账单主表的最可能对应
• biz_charge_detail → 营业账明细的最可能对应
• biz_price_tier_adjustment、biz_water_use_scheme_tier → 阶梯与分段规则相关
• biz_exceed_water_use_scheme → 超计划用水 / 特殊计费规则相关

弱映射或当前缺口

以下数据字典对象，本轮未看到明显一一对应的独立表：

• 跨周期水量
• 特账
• 特账明细
• 退款账
• 阶梯累计量

判断

• 后端已经有收费主表与明细表，但“账务信息域”中的部分精细账务对象，当前没有在 sw-business-server 中直接呈现为独立实体表。
• 这些能力可能尚未实现、可能被合并入 biz_charge / biz_charge_detail，也可能在未纳入本轮范围的模块中。

5.4 收费、账务处理域

数据字典中的典型对象包括：收费汇总、收费小计、收费明细、托收账单明细、托收送盘总表、代扣账单明细、代扣送盘总表、预存退款、催缴、红冲、价差调整、分账调整、实时收费日志等。

后端已明确对应的表

• biz_charge、biz_charge_detail → 收费 / 账单主明细
• biz_collection → 托收/代收主表
• biz_withholding → 代扣/托收主表
• bk_withholding_agreement → 代扣签约
• bk_withholding_batch、bk_withholding_item → 代扣送盘/批次/明细
• bk_transaction、bk_transaction_callback、bk_transaction_exception → 渠道交易、回调、异常
• bk_reconcile_batch、bk_reconcile_diff → 对账批次与差异
• bk_settlement_batch → 结算批次

明显缺口

当前未看到明显独立实体表的对象包括：

• 预存退款 / 预存退款详情
• 预存催缴
• 催缴登记汇总 / 催缴停水汇总 / 催缴停水详情
• 收费汇总 / 收费小计 / 实时收费汇总 / 实时收费日志
• 红冲表
• 价差调整汇总 / 明细
• 分账调整汇总 / 明细
• 已销调整汇总 / 明细
• 呆坏账汇总 / 明细
• IC 卡充退账、IC 卡结余、IC 卡操作日志

判断

• 后端在“收费交易 + 银行代收/代扣 + 对账”这条主线已经具备较强基础。
• 但数据字典中大量细粒度账务处理台账，目前在代码中尚未体现为完整的独立表族。

5.5 发票信息域

数据字典中的典型对象包括：营业账开票表、发票明细表、发票信息表、开票配置表。

后端已明确对应的表

• biz_invoice → 发票信息表
• biz_cust_invoice → 客户开票信息
• biz_invoice_taxrate → 发票税率表
• biz_process_invoice_modifys → 发票修改记录 / 发票变更流程类

明显缺口

• 发票明细表
• 营业账开票表
• 开票配置表

判断

• 后端已具备发票主数据与税率基础，但尚未看到完整的发票明细、开票批次、开票配置等整套发票表族。
• 这部分能力也可能部分分布在 sw-module-pay、sw-module-infra 或其他模块中。

5.6 业务办理 / 工单域

数据字典中的典型对象包括：欠费停水、停用启用、低保、更名、过户、自助抄表、客户工单记录、换表记录、稽查工单、PDA 派单等。

后端已明确对应的表

• biz_process → 业务办理流程主表
• biz_process_transfer → 流程流转/转办
• biz_process_cust_contact → 流程中的客户联系人信息
• biz_process_meter_install → 流程中的装表/安装信息
• biz_business_types → 业务类型
• biz_business_datas → 业务办理扩展数据
• biz_content、biz_content_attach → 上报/资料/附件类

判断

• 后端已经存在统一流程化的业务办理模型。
• 但数据字典中按业务种类拆开的“更名”“过户”“低保”“停复水”“换表”等，并未在本轮扫描中体现为大量独立业务表，更像是由统一流程表 + 业务数据表承载。

5.7 系统参数与基础配置域

数据字典中的典型对象包括：小区管理、银行管理、价格站点关系、系统菜单、导出任务、编号生成、系统参数、页面基础配置、优惠方案、词语字典等。

后端已明确对应的表

• biz_community → 小区管理表
• biz_bank、biz_bank_branch → 银行表 / 银行分行表
• biz_parameter_settings → 系统参数 / 业务参数配置
• biz_page_settings、biz_page_settings_detail → 页面基础配置表
• biz_extend_propertys → 拓展信息表
• biz_price_category、biz_price_template、biz_template_dept_rel → 价格分类、价格模板、站点关系类
• biz_price_discount_scheme、biz_price_discount_tier、biz_price_discount_cost → 优惠方案相关
• sys_wechat_app_settings → 微信基础配置类

说明

• system_menu、system_dict_*、system_user、system_role 等系统底座表大概率在 sw-module-system，不在本文扫描范围内。
• 因此，不能据此认定这些系统表在整个后端仓库中缺失，只能说明它们不在本轮三大业务模块中。

5.8 银行代收 / 代扣域

这是当前后端与历史数据字典相比，落地程度较高的一块。

后端已明确对应的表

• biz_collection
• biz_withholding
• biz_cust_collection_rel
• biz_cust_withholding_rel
• bk_withholding_agreement
• bk_withholding_batch
• bk_withholding_item
• bk_payment_channel
• bk_channel_api_config
• bk_channel_route_rule
• bk_channel_statistics
• bk_transaction
• bk_transaction_callback
• bk_transaction_exception
• bk_reconcile_batch
• bk_reconcile_diff
• bk_settlement_batch

判断

• 相比旧数据字典中的“托收资料、代扣资料、送盘/回盘、对账”描述，当前后端已形成更现代化的渠道、路由、交易、回调、异常、对账、结算模型。
• 这说明银行代收相关能力在当前后端中不是停留在概念层，而是已经具备较明确的工程化落地结构。

5.9 IoT / 远传表域

后端已明确对应的表

• iot_product
• iot_product_category
• iot_device
• iot_device_group
• iot_thing_model
• iot_rule_scene
• iot_alert_config
• iot_alert_record
• iot_data_bridge
• iot_plugin_config
• iot_plugin_instance
• iot_ota_firmware
• iot_ota_upgrade_task
• iot_ota_upgrade_record

判断

• 历史《营收数据字典》几乎没有覆盖现代 IoT 平台的产品、设备、物模型、规则场景、插件实例、OTA 升级等对象。
• 因此，IoT 这部分更多体现为：当前后端新增了旧字典之外的一整块能力域。

6. 当前结论

6.1 已可明确确认

1. 当前后端在水务核心业务模块中，已经落下了较完整的客户、抄表、水价、收费、托收/代扣、流程办理、基础参数等表结构。
2. 银行代收模块成熟度较高，已形成渠道、交易、批次、回调、异常、对账、结算的完整表族。
3. IoT 模块明显超出旧版营收数据字典覆盖范围，属于后端新增建设能力。
4. 当前代码中的真实表数量，明显多于 sql/lhc_数据库设计.md 已明确展开设计的表数量。

6.2 明显缺口或待继续核实项

1. 旧数据字典中的大量细粒度收费处理台账，当前尚未在代码中发现明确独立实体表：
   • 红冲
   • 催缴
   • 呆坏账
   • 已销调整
   • 分账调整
   • 价差调整
   • 实时收费日志
   • 预存退款
   • IC 卡相关账务
2. 发票域当前只看到主表与辅助表，尚未看到完整的发票明细、开票配置、营业账开票关系表族。
3. 业务办理域更像“统一流程模型”，而不是旧系统那种“每类业务一张独立业务表”的模式。
4. 系统管理类表未纳入本轮扫描范围，后续如需完整数据库映射，还应继续补扫：
   • sw-module-system
   • sw-module-infra
   • sw-module-pay
   • sw-module-bpm

7. 对当前文档工作的直接价值

本文可直接支撑后续三项工作：

1. 反向修订 sql/lhc_数据库设计.md，识别“文档未设计但后端已存在”的真实表。
2. 识别历史《营收数据字典》中的“旧域对象”在当前后端里是：
   • 已有真实表
   • 被合并重构
   • 尚未实现
3. 为后续接口清单、模块功能点、详细设计章节提供“代码落地证据”。

8. 相关文档

• 后端现状总览：docs/guides/BACKEND_CURRENT_STATUS.md
• 历史数据字典：docs/design/04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md
• 当前数据库设计稿：sql/lhc_数据库设计.md