wuweihua/BMS
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

应收账单模块，调整枚举代码优化

Browse Source
This commit is contained in:
caojia
2026-09-17 11:00:59 +08:00
parent 5207c00574
commit a17f09683b
26 changed files with 397 additions and 140 deletions
Download Patch File Download Diff File Expand all files Collapse all files
bms-back/sql/ar/ar_balance_writeoff.sql
+1 -1
View File
@@ -19,7 +19,7 @@ CREATE TABLE IF NOT EXISTS ar_balance_writeoff (
balance_flow_id BIGINT(20) DEFAULT NULL COMMENT '核销扣余额流水ID',
reverse_flow_id BIGINT(20) DEFAULT NULL COMMENT '反核销回补余额流水ID',
writeoff_date DATE NOT NULL COMMENT '核销日期',
status VARCHAR(30) NOT NULL COMMENT 'EFFECTIVE/CANCELLED',
status VARCHAR(30) NOT NULL COMMENT '状态：EFFECTIVE=有效（已扣减客户余额），CANCELLED=已反核销（已回补客户余额）',
remark VARCHAR(500) DEFAULT NULL COMMENT '核销备注',
create_by VARCHAR(64) NOT NULL COMMENT '创建人',
create_time DATETIME NOT NULL COMMENT '创建时间',
bms-back/sql/ar/ar_bill.sql
+6 -6
View File
@@ -21,7 +21,7 @@ CREATE TABLE IF NOT EXISTS ar_bill (
total_amount DECIMAL(18,2) NOT NULL DEFAULT 0.00 COMMENT '账单应收总额',
written_off_amount DECIMAL(18,2) NOT NULL DEFAULT 0.00 COMMENT '已核销金额缓存',
unwritten_amount DECIMAL(18,2) NOT NULL DEFAULT 0.00 COMMENT '未核销金额缓存',
status VARCHAR(30) NOT NULL COMMENT 'DRAFT/CONFIRMED/PARTIAL_WRITTEN_OFF/WRITTEN_OFF/VOID',
status VARCHAR(30) NOT NULL COMMENT '状态：DRAFT=草稿，CONFIRMED=已确认，PARTIAL_WRITTEN_OFF=部分核销，WRITTEN_OFF=已核销，VOID=已作废',
bill_version INT(11) NOT NULL DEFAULT 1 COMMENT '账单版本',
bank_account_name VARCHAR(100) DEFAULT NULL COMMENT '收款账户名称快照',
bank_account_no VARCHAR(128) DEFAULT NULL COMMENT '收款账号快照，应用层脱敏展示',
@@ -109,7 +109,7 @@ CREATE TABLE IF NOT EXISTS ar_bill_export (
file_size BIGINT(20) DEFAULT NULL COMMENT '文件字节数',
file_hash VARCHAR(128) DEFAULT NULL COMMENT 'SHA-256校验值',
row_count INT(11) DEFAULT NULL COMMENT '导出订单行数',
export_status VARCHAR(30) NOT NULL COMMENT 'PROCESSING/SUCCESS/FAILED',
export_status VARCHAR(30) NOT NULL COMMENT '导出状态：PROCESSING=生成中，SUCCESS=成功（可下载），FAILED=失败',
export_by VARCHAR(64) NOT NULL COMMENT '导出人',
export_time DATETIME NOT NULL COMMENT '导出时间',
remark VARCHAR(500) DEFAULT NULL COMMENT '失败原因或备注',
@@ -122,9 +122,9 @@ CREATE TABLE IF NOT EXISTS ar_bill_export (
CREATE TABLE IF NOT EXISTS ar_bill_log (
log_id BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '日志ID',
ar_bill_id BIGINT(20) DEFAULT NULL COMMENT '账单ID',
object_type VARCHAR(40) NOT NULL COMMENT 'BILL/EXPORT/BALANCE_WRITEOFF',
object_type VARCHAR(40) NOT NULL COMMENT '对象类型：BILL=应收账单，EXPORT=账单导出，BALANCE_WRITEOFF=余额核销；历史值可能包含已下线模块类型',
object_id VARCHAR(64) NOT NULL COMMENT '通用对象ID',
operation_type VARCHAR(40) NOT NULL COMMENT '操作类型：CONFIRM/VOID/EXPORT/BALANCE_WRITEOFF/CANCEL_BALANCE_WRITEOFF',
operation_type VARCHAR(40) NOT NULL COMMENT '操作类型：CREATE=生成账单，GENERATE=生成校验，CONFIRM=确认账单，VOID=作废账单，EXPORT=导出账单，BALANCE_WRITEOFF=余额核销，CANCEL_BALANCE_WRITEOFF=取消余额核销',
operation_desc VARCHAR(500) DEFAULT NULL COMMENT '操作说明',
from_status VARCHAR(30) DEFAULT NULL COMMENT '变更前状态',
to_status VARCHAR(30) DEFAULT NULL COMMENT '变更后状态',
@@ -132,10 +132,10 @@ CREATE TABLE IF NOT EXISTS ar_bill_log (
after_data TEXT COMMENT '变更后安全快照',
operator_id VARCHAR(64) NOT NULL COMMENT '操作人ID',
operator_name VARCHAR(100) DEFAULT NULL COMMENT '操作人名称',
operation_source VARCHAR(30) NOT NULL COMMENT 'WEB/API/JOB/IMPORT',
operation_source VARCHAR(30) NOT NULL COMMENT '操作来源：WEB=网页端，API=接口，JOB=定时任务，IMPORT=数据导入',
request_id VARCHAR(64) DEFAULT NULL COMMENT '请求幂等标识',
trace_id VARCHAR(64) DEFAULT NULL COMMENT '链路标识',
result VARCHAR(20) NOT NULL COMMENT 'SUCCESS/FAILED',
result VARCHAR(20) NOT NULL COMMENT '执行结果：SUCCESS=成功，FAILED=失败',
error_message VARCHAR(1000) DEFAULT NULL COMMENT '失败原因',
client_ip VARCHAR(64) DEFAULT NULL COMMENT '来源IP',
create_time DATETIME NOT NULL COMMENT '日志时间',
bms-back/sql/ar/ar_bill_log_balance_writeoff_comment.sql
+7 -3
View File
@@ -1,6 +1,10 @@
-- 应收日志兼容余额核销：仅更新字段注释，不改变字段类型和历史数据
-- 应收日志枚举中文说明：仅更新字段注释，不改变字段类型、历史数据和业务逻辑
ALTER TABLE ar_bill_log
MODIFY COLUMN object_type VARCHAR(40) NOT NULL
COMMENT 'BILL/EXPORT/BALANCE_WRITEOFF',
COMMENT '对象类型：BILL=应收账单，EXPORT=账单导出，BALANCE_WRITEOFF=余额核销；历史值可能包含已下线模块类型',
MODIFY COLUMN operation_type VARCHAR(40) NOT NULL
COMMENT '操作类型：CONFIRM/VOID/EXPORT/BALANCE_WRITEOFF/CANCEL_BALANCE_WRITEOFF';
COMMENT '操作类型：CREATE=生成账单，GENERATE=生成校验，CONFIRM=确认账单，VOID=作废账单，EXPORT=导出账单，BALANCE_WRITEOFF=余额核销，CANCEL_BALANCE_WRITEOFF=取消余额核销',
MODIFY COLUMN operation_source VARCHAR(30) NOT NULL
COMMENT '操作来源：WEB=网页端，API=接口，JOB=定时任务，IMPORT=数据导入',
MODIFY COLUMN result VARCHAR(20) NOT NULL
COMMENT '执行结果：SUCCESS=成功，FAILED=失败';
bms-back/sql/ar/ar_status_enum_comment_migration.sql
+30
View File
@@ -0,0 +1,30 @@
-- =====================================================================
-- 应收模块枚举中文说明迁移
--
-- 目的：为数据库中的状态/日志枚举补充中文业务含义，方便运维和数据排查。
-- 说明：本脚本只修改字段 COMMENT，不修改字段类型、历史数据、索引或业务状态值。
-- ALTER TABLE ... MODIFY COLUMN 可重复执行；已执行过旧注释脚本的环境也可直接执行。
-- =====================================================================
SET NAMES utf8mb4;
ALTER TABLE ar_balance_writeoff
MODIFY COLUMN status VARCHAR(30) NOT NULL
COMMENT '状态：EFFECTIVE=有效（已扣减客户余额），CANCELLED=已反核销（已回补客户余额）';
ALTER TABLE ar_bill
MODIFY COLUMN status VARCHAR(30) NOT NULL
COMMENT '状态：DRAFT=草稿，CONFIRMED=已确认，PARTIAL_WRITTEN_OFF=部分核销，WRITTEN_OFF=已核销，VOID=已作废';
ALTER TABLE ar_bill_export
MODIFY COLUMN export_status VARCHAR(30) NOT NULL
COMMENT '导出状态：PROCESSING=生成中，SUCCESS=成功（可下载），FAILED=失败';
ALTER TABLE ar_bill_log
MODIFY COLUMN object_type VARCHAR(40) NOT NULL
COMMENT '对象类型：BILL=应收账单，EXPORT=账单导出，BALANCE_WRITEOFF=余额核销；历史值可能包含已下线模块类型',
MODIFY COLUMN operation_type VARCHAR(40) NOT NULL
COMMENT '操作类型：CREATE=生成账单，GENERATE=生成校验，CONFIRM=确认账单，VOID=作废账单，EXPORT=导出账单，BALANCE_WRITEOFF=余额核销，CANCEL_BALANCE_WRITEOFF=取消余额核销',
MODIFY COLUMN operation_source VARCHAR(30) NOT NULL
COMMENT '操作来源：WEB=网页端，API=接口，JOB=定时任务，IMPORT=数据导入',
MODIFY COLUMN result VARCHAR(20) NOT NULL
COMMENT '执行结果：SUCCESS=成功，FAILED=失败';