feat(核算)!: 添加 T+ 正式核算与采集托管
补齐源快照、资料预演、正式导入及工资核算的依赖链路。 新增版本化输入、逐段 FIFO、生成锁和结构化当月调整， 并提供默认关闭的周期采集、有限重试及 Windows 托管。 原始客户资料、私有配置及首页改动不纳入本次提交。 BREAKING CHANGE: 升级前需应用新增迁移，并通过 PAYROLL_MAKER_USER_ID 绑定实际工资制作人，否则业务只读。 旧单批次核算默认关闭；历史兼容需显式启用 PAYROLL_ALLOW_LEGACY_CALCULATION。生产启用和真实金额待验收。
This commit is contained in:
liuwenxin committed
1 parent
1b074576fe
commit
108bf87225
154 files changed
+9515
-645
No files matched your search
@@ -0,0 +1,78 @@
|
||||
-- V16：基础导入与核算预演的隔离工作区；无正式工资写入。
|
||||
CREATE TABLE tplus_source_heads (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
source_database VARCHAR(128) NOT NULL COMMENT '源账套',
|
||||
entity_type VARCHAR(32) NOT NULL COMMENT '实体类型',
|
||||
source_id VARCHAR(64) NOT NULL COMMENT '源内部ID',
|
||||
record_id BIGINT UNSIGNED NOT NULL COMMENT '原始快照ID',
|
||||
batch_no VARCHAR(32) NOT NULL COMMENT '最后观察批次',
|
||||
CONSTRAINT pk_tplus_source_heads PRIMARY KEY (id),
|
||||
CONSTRAINT uk_tplus_heads_source_entity_id UNIQUE (source_database, entity_type, source_id)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='T+ 源当前快照指针（按成功全量批次读取，删除不自动回写业务表）' COLLATE utf8mb4_general_ci;
|
||||
|
||||
CREATE INDEX idx_tplus_heads_batch_entity ON tplus_source_heads (batch_no, entity_type);
|
||||
|
||||
CREATE TABLE tplus_facts (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
source_database VARCHAR(128) NOT NULL COMMENT '源账套',
|
||||
kind VARCHAR(32) NOT NULL COMMENT '事实类别',
|
||||
fact_key VARCHAR(128) NOT NULL COMMENT '事实业务键',
|
||||
version INTEGER NOT NULL COMMENT '版本号',
|
||||
data_json JSON NOT NULL COMMENT '经校验的事实内容',
|
||||
evidence VARCHAR(500) NOT NULL COMMENT '依据和修改原因',
|
||||
requested_by BIGINT UNSIGNED NOT NULL COMMENT '操作者ID',
|
||||
create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
|
||||
update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
CONSTRAINT pk_tplus_facts PRIMARY KEY (id),
|
||||
CONSTRAINT uk_tplus_facts_source_kind_key_version UNIQUE (source_database, kind, fact_key, version)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='T+ 人工补充事实版本表' COLLATE utf8mb4_general_ci;
|
||||
|
||||
CREATE TABLE tplus_source_links (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
source_database VARCHAR(128) NOT NULL COMMENT '源账套',
|
||||
entity_type VARCHAR(32) NOT NULL COMMENT '实体类型',
|
||||
source_id VARCHAR(64) NOT NULL COMMENT '源内部ID',
|
||||
target_id BIGINT UNSIGNED NOT NULL COMMENT '业务目标ID',
|
||||
create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
|
||||
update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
CONSTRAINT pk_tplus_source_links PRIMARY KEY (id),
|
||||
CONSTRAINT uk_tplus_links_source_entity_id UNIQUE (source_database, entity_type, source_id),
|
||||
CONSTRAINT uk_tplus_links_entity_target UNIQUE (entity_type, target_id)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='T+ 基础数据源目标关联' COLLATE utf8mb4_general_ci;
|
||||
|
||||
CREATE TABLE tplus_work_runs (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
run_no VARCHAR(32) NOT NULL COMMENT '运行编号',
|
||||
request_key VARCHAR(36) NOT NULL COMMENT '请求幂等键',
|
||||
kind VARCHAR(32) NOT NULL COMMENT 'MASTER_PREVIEW/MASTER_APPLY/CALC_PREVIEW',
|
||||
status VARCHAR(16) NOT NULL COMMENT '运行状态',
|
||||
source_database VARCHAR(128) NOT NULL COMMENT '固定源账套',
|
||||
requested_by BIGINT UNSIGNED NOT NULL COMMENT '操作者ID',
|
||||
input_json JSON NOT NULL COMMENT '请求输入',
|
||||
snapshot_json JSON COMMENT '规则和补充资料的固定快照',
|
||||
snapshot_hash VARCHAR(64) COMMENT '输入指纹',
|
||||
summary_json JSON COMMENT '结果汇总',
|
||||
error_code VARCHAR(64) COMMENT '固定错误编码',
|
||||
started_at DATETIME COMMENT '开始时间',
|
||||
finished_at DATETIME COMMENT '结束时间',
|
||||
create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
|
||||
update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
CONSTRAINT pk_tplus_work_runs PRIMARY KEY (id),
|
||||
CONSTRAINT uk_tplus_work_runs_run_no UNIQUE (run_no),
|
||||
CONSTRAINT uk_tplus_work_runs_request_key UNIQUE (request_key)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='T+ 导入与预演运行表' COLLATE utf8mb4_general_ci;
|
||||
|
||||
CREATE INDEX idx_tplus_work_runs_status_id ON tplus_work_runs (status, id);
|
||||
|
||||
CREATE TABLE tplus_work_lines (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
run_no VARCHAR(32) NOT NULL COMMENT '运行编号',
|
||||
line_no INTEGER NOT NULL COMMENT '稳定行序号',
|
||||
entity_type VARCHAR(32) NOT NULL COMMENT '实体或分组类型',
|
||||
source_id VARCHAR(128) NOT NULL COMMENT '源ID或平账组',
|
||||
action VARCHAR(32) NOT NULL COMMENT '新增/更新/跳过/待补/冲突/分配',
|
||||
reason VARCHAR(128) COMMENT '固定原因编码',
|
||||
data_json JSON NOT NULL COMMENT '最小必要的业务明细',
|
||||
CONSTRAINT pk_tplus_work_lines PRIMARY KEY (id),
|
||||
CONSTRAINT uk_tplus_work_lines_run_line UNIQUE (run_no, line_no)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='T+ 导入预览与核算预演明细' COLLATE utf8mb4_general_ci;
|
||||
@@ -0,0 +1,5 @@
|
||||
-- 仅重命名 V16 固定索引，不改变数据。
|
||||
ALTER TABLE tplus_source_heads RENAME INDEX uk_tplus_heads_source_entity_id TO uk_tplus_source_heads_source_entity_id;
|
||||
ALTER TABLE tplus_source_heads RENAME INDEX idx_tplus_heads_batch_entity TO idx_tplus_source_heads_batch_entity;
|
||||
ALTER TABLE tplus_source_links RENAME INDEX uk_tplus_links_source_entity_id TO uk_tplus_source_links_source_entity_id;
|
||||
ALTER TABLE tplus_source_links RENAME INDEX uk_tplus_links_entity_target TO uk_tplus_source_links_entity_target;
|
||||
@@ -0,0 +1,51 @@
|
||||
-- 正式工资输入、FIFO过程及生成锁定；新增表，不改写历史结果。
|
||||
|
||||
CREATE TABLE payroll_months (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
month VARCHAR(7) NOT NULL COMMENT '工资月份',
|
||||
maker_id BIGINT UNSIGNED NOT NULL COMMENT '实际工资制作人账号ID',
|
||||
maker_name VARCHAR(64) NOT NULL COMMENT '制作人用户名快照',
|
||||
generated_at DATETIME COMMENT '首次成功生成时间（不可解锁）',
|
||||
create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
|
||||
update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
CONSTRAINT pk_payroll_months PRIMARY KEY (id),
|
||||
CONSTRAINT uk_payroll_months_month UNIQUE (month)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='工资月份控制表（首次生成即锁定分配，审批不解锁）' COLLATE utf8mb4_general_ci;
|
||||
|
||||
CREATE TABLE payroll_inputs (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
business_id BIGINT UNSIGNED NOT NULL COMMENT '正式业务ID',
|
||||
version INTEGER NOT NULL COMMENT '输入版本',
|
||||
source_database VARCHAR(128) NOT NULL COMMENT '源账套或人工来源',
|
||||
group_key VARCHAR(128) NOT NULL COMMENT '独立业务平账组',
|
||||
fingerprint VARCHAR(64) NOT NULL COMMENT '来源及事实指纹',
|
||||
data_json JSON NOT NULL COMMENT '经核实的源数据及人工事实快照',
|
||||
requested_by BIGINT UNSIGNED NOT NULL COMMENT '录入人账号ID',
|
||||
create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
|
||||
update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
CONSTRAINT pk_payroll_inputs PRIMARY KEY (id),
|
||||
CONSTRAINT uk_payroll_inputs_business_version UNIQUE (business_id, version)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='正式工资输入版本表' COLLATE utf8mb4_general_ci;
|
||||
|
||||
CREATE INDEX idx_payroll_inputs_source_group ON payroll_inputs (source_database, group_key);
|
||||
|
||||
CREATE TABLE payroll_allocations (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
ledger_id BIGINT UNSIGNED NOT NULL COMMENT '所属正式台账ID',
|
||||
business_id BIGINT UNSIGNED NOT NULL COMMENT '正式业务ID',
|
||||
line_no INTEGER NOT NULL COMMENT '本台账稳定明细序号',
|
||||
input_id BIGINT UNSIGNED NOT NULL COMMENT '所用输入版本ID',
|
||||
amount NUMERIC(14, 2) NOT NULL COMMENT '分配回款金额',
|
||||
data_json JSON NOT NULL COMMENT '单据、成本、归属、参数和逐段计算依据',
|
||||
create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
|
||||
update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
CONSTRAINT pk_payroll_allocations PRIMARY KEY (id),
|
||||
CONSTRAINT uk_payroll_allocations_ledger_line UNIQUE (ledger_id, line_no)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='正式FIFO分配明细表' COLLATE utf8mb4_general_ci;
|
||||
|
||||
CREATE INDEX idx_payroll_allocations_business_id ON payroll_allocations (business_id);
|
||||
|
||||
CREATE INDEX idx_performance_ledgers_receipt_id ON performance_ledgers (receipt_id);
|
||||
ALTER TABLE performance_ledgers ADD COLUMN allocation_key VARCHAR(64) NOT NULL DEFAULT '' COMMENT '正式FIFO事件键；历史单笔核算为空串';
|
||||
ALTER TABLE performance_ledgers DROP INDEX uk_performance_ledgers_receipt_id_calc_version_personnel;
|
||||
ALTER TABLE performance_ledgers ADD CONSTRAINT uk_performance_ledgers_receipt_id_calc_version_personnel UNIQUE (receipt_id, calc_version, personnel_id, allocation_key);
|
||||
@@ -0,0 +1,4 @@
|
||||
-- 分配调整固化原台账与业务分管；普通调整也统一计生成当月。
|
||||
ALTER TABLE adjustment_orders ADD COLUMN adjustment_type VARCHAR(32) NOT NULL DEFAULT 'GENERAL' COMMENT '调整类型：GENERAL普通 ALLOCATION分配差额';
|
||||
ALTER TABLE adjustment_orders ADD COLUMN source_ledger_id BIGINT UNSIGNED NULL COMMENT '分配差额对应的原台账ID';
|
||||
ALTER TABLE adjustment_orders ADD COLUMN attribution_json JSON NULL COMMENT '原台账业务与分管归属快照';
|
||||
@@ -0,0 +1,25 @@
|
||||
-- 自动采集状态；不自动应用业务或生成工资。
|
||||
|
||||
CREATE TABLE tplus_automation_states (
|
||||
id BIGINT UNSIGNED NOT NULL COMMENT '主键ID' AUTO_INCREMENT,
|
||||
source_key VARCHAR(64) NOT NULL COMMENT '源连接身份摘要（不含凭据）',
|
||||
source_database VARCHAR(128) NOT NULL COMMENT '源账套',
|
||||
scheduled_period VARCHAR(16) COMMENT '最近已排队ISO周',
|
||||
root_batch_no VARCHAR(32) COMMENT '本周期原始采集批次',
|
||||
current_batch_no VARCHAR(32) COMMENT '当前原始或重试批次',
|
||||
retry_attempts INTEGER NOT NULL COMMENT '本周期自动重试次数' DEFAULT '0',
|
||||
next_retry_at DATETIME COMMENT '下一次自动重试时间',
|
||||
last_success_at DATETIME COMMENT '最近成功采集时间',
|
||||
maintenance_at DATETIME COMMENT '最近周期检查时间',
|
||||
heartbeat_at DATETIME COMMENT '独立进程心跳时间',
|
||||
worker_owner VARCHAR(36) COMMENT '当前持锁进程身份',
|
||||
worker_phase VARCHAR(16) NOT NULL COMMENT '进程状态：IDLE/RUNNING/STOPPED' DEFAULT '''STOPPED''',
|
||||
create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
|
||||
update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
CONSTRAINT pk_tplus_automation_states PRIMARY KEY (id),
|
||||
CONSTRAINT uk_tplus_automation_states_source_key UNIQUE (source_key)
|
||||
)ENGINE=InnoDB CHARSET=utf8mb4 COMMENT='T+自动采集周期与进程状态（不自动导入正式业务）' COLLATE utf8mb4_general_ci;
|
||||
|
||||
ALTER TABLE tplus_sync_batches ADD COLUMN trigger_type VARCHAR(16) NOT NULL DEFAULT 'MANUAL' COMMENT '触发来源：MANUAL/SCHEDULED/AUTO_RETRY';
|
||||
|
||||
ALTER TABLE tplus_sync_batches ADD COLUMN automatic_attempt INTEGER NOT NULL DEFAULT 0 COMMENT '自动重试序号（0为原始任务）';
|
||||
@@ -0,0 +1,3 @@
|
||||
-- 修正V20状态默认值的额外引号；不改历史业务、工资或核算数据。
|
||||
ALTER TABLE tplus_automation_states ALTER COLUMN worker_phase SET DEFAULT 'STOPPED';
|
||||
UPDATE tplus_automation_states SET worker_phase='STOPPED' WHERE worker_phase='''STOPPED''';
|
||||
Reference in new issue
Block a user