tangweijie/fujian_water_biz_doc
1
0
Fork 0
Code Issues Pull Requests 12 Actions Packages Projects Releases 1 Wiki Activity
fujian_water_biz_doc/docs/evidence/rev004-latefee-legacy-structure-gap-summary-2026-04-14.md

3.4 KiB
Raw Blame History

REV004 违约金减免：现结构与老字典差异摘要（2026-04-14）

结论

当前 REV004 违约金减免结构已经对齐老字典/老表结构的核心骨架：

  • LateFeeType 仍保持 1=按金额 / 2=按日期
  • 已承接申请人、联系电话、备注
  • 已承接 StartDate/EndDate
  • 已承接账单维度 chargeId(FeeId)

但当前更偏申请契约 + 日志/读模型承接，并未完整复刻老系统执行态表模型。

老字典/老表结构证据

主表 PM_LATEFEE_RECORDS

来源：营收数据字典.md:3117-3126

  • Applicant
  • Mobile
  • ApplyType
  • LateFeeType
  • State
  • Remark
  • TaskId
  • StepId
  • FlowRemark
  • BusinessType

明细表 PM_LATEFEE_RECORD_DETAILS

来源：营收数据字典.md:3143-3158

  • CustId/CustCode/CustName/CustAddress
  • BillMonth
  • LateFee
  • ReduceMoney
  • NewLateFee
  • StartDate
  • EndDate
  • ProcType/ProcPerson/ProcDate/ProcRemark
  • State
  • FeeId

老字典枚举

来源：营收数据字典.md:5683-5697

  • LateFeeReason: 1=用户协商, 2=其它
  • LateFeeType: 1=按金额, 2=按日期

当前结构证据

DDL 草案

来源：sql/rev004/REV004_accounting_adjustments_ddl.sql:289-403

  • 主表 biz_latefee_reduce
    • applicant_name
    • applicant_mobile
    • late_fee_type
    • apply_reason_code
    • remark
    • approval_status
    • reduce_status
  • 明细表 biz_latefee_reduce_detail
    • charge_id
    • cust_id/cust_code/cust_name/cust_address
    • bill_month
    • start_date/end_date
    • late_fee_before
    • reduce_amount
    • late_fee_after
    • proc_type/proc_person/proc_time/proc_remark

当前批量提交契约

来源：

  • AccountingAdjustUnsoldLateFeeReduceBatchSubmitReqVO
  • AccountingAdjustUnsoldLateFeeReduceBatchItemReqVO

当前 outer：

  • lateFeeType
  • applicant
  • contactMobile
  • applyReason
  • remark
  • attachmentRefs
  • items

当前 item：

  • chargeId
  • adjustmentNo
  • lateFeeReduceAmount
  • startDate
  • endDate
  • 兼容项：applyReason/remark/attachmentRefs

已对齐项

  1. LateFeeType 语义已对齐老字典
  2. Applicant/Mobile 已有对应字段
  3. Remark 已有对应字段
  4. StartDate/EndDate 已有对应字段
  5. FeeId -> chargeId 已有明确对应
  6. ReduceMoney -> lateFeeReduceAmount/reduce_amount 语义已对齐
  7. detail / log-detail / process 已可读出 late-fee 扩展字段

未完全落地项

  1. ApplyType / LateFeeReason 字典口径未完全统一
    • 老字典：1=用户协商, 2=其它
    • 当前前端历史口径曾使用不同原因值
  2. State 未按老系统单字段口径落地
    • 当前主要使用 approvalStatus/resultStatus/writeBackStatus
  3. 按日期模式仍偏申请态
    • 还未形成完整审批执行/计算回写
  4. 执行结果落表未完整 runtime 化
    • DDL 草案已具备 late_fee_before/reduce_amount/late_fee_after
    • 但当前核心还是契约 + 日志承接
  5. 处理过程字段未完整 runtime 落地
    • ProcType/ProcPerson/ProcDate/ProcRemark
  6. 老流程字段未完整复刻
    • StepId/FlowRemark/BusinessType

优先级建议

P0

  • 统一 applyReason 与 LateFeeReason 口径
  • 给出老 State 与当前审批/回写状态映射表

P1

  • 补齐 lateFeeType=2 按日期模式执行态
  • 审批通过后把结果正式落到 biz_latefee_reduce / biz_latefee_reduce_detail

P2

  • 再决定是否需要复刻 StepId/FlowRemark/BusinessType/applicant_id