-- 提现资格资料版本与提现审批尝试记录。 -- 资格事实按版本不可变保存：替换合同或法人身份证即新增版本，旧有效版本在同一事务内失效。 -- 提现每次提交或重提新增一条不可变审批尝试记录，冻结与释放金额一律取尝试记录事实。 -- 附件字段每个只保存单个对象存储 Key：必填合同、法人身份证正反面共 3 项，可选营业执照、门头照、发票共 3 项， -- 合计不超过企业微信单张审批单 6 个附件上限。 -- 不使用数据库外键，关联以 ID 保存并由应用层显式校验。 CREATE TABLE tb_withdrawal_qualification ( id BIGSERIAL PRIMARY KEY, shop_id BIGINT NOT NULL, subject_type VARCHAR(20) NOT NULL, subject_code VARCHAR(64) NOT NULL, legal_person_id_card VARCHAR(64) NOT NULL, contract_file_key VARCHAR(255) NOT NULL, id_card_front_file_key VARCHAR(255) NOT NULL, id_card_back_file_key VARCHAR(255) NOT NULL, business_license_file_key VARCHAR(255) NOT NULL DEFAULT '', shop_front_file_key VARCHAR(255) NOT NULL DEFAULT '', invoice_file_key VARCHAR(255) NOT NULL DEFAULT '', invoice_title VARCHAR(200) NOT NULL DEFAULT '', invoice_subject_code VARCHAR(64) NOT NULL DEFAULT '', status SMALLINT NOT NULL DEFAULT 0, invalid_reason VARCHAR(500) NOT NULL DEFAULT '', invalidated_at TIMESTAMPTZ, invalidated_by BIGINT NOT NULL DEFAULT 0, approval_instance_id BIGINT, decided_at TIMESTAMPTZ, creator BIGINT NOT NULL DEFAULT 0, updater BIGINT NOT NULL DEFAULT 0, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), CONSTRAINT chk_withdrawal_qualification_shop CHECK (shop_id > 0), CONSTRAINT chk_withdrawal_qualification_subject CHECK (subject_type IN ('enterprise', 'personal')), CONSTRAINT chk_withdrawal_qualification_subject_code CHECK (subject_code <> ''), CONSTRAINT chk_withdrawal_qualification_legal_person CHECK (legal_person_id_card <> ''), CONSTRAINT chk_withdrawal_qualification_attachments CHECK ( contract_file_key <> '' AND id_card_front_file_key <> '' AND id_card_back_file_key <> '' ), CONSTRAINT chk_withdrawal_qualification_invoice CHECK ( invoice_file_key = '' OR (invoice_title <> '' AND invoice_subject_code <> '') ), CONSTRAINT chk_withdrawal_qualification_status CHECK (status IN (0, 1, 2, 3)), CONSTRAINT chk_withdrawal_qualification_invalidated CHECK ((status = 3) = (invalidated_at IS NOT NULL)), CONSTRAINT chk_withdrawal_qualification_instance CHECK ( approval_instance_id IS NULL OR approval_instance_id > 0 ) ); -- 同一店铺至多一个有效版本；失效与新增在同一事务内完成，因此提交即可替换。 CREATE UNIQUE INDEX uk_withdrawal_qualification_valid ON tb_withdrawal_qualification (shop_id) WHERE status = 1; CREATE INDEX idx_withdrawal_qualification_shop ON tb_withdrawal_qualification (shop_id, status, id DESC); CREATE UNIQUE INDEX uk_withdrawal_qualification_instance ON tb_withdrawal_qualification (approval_instance_id) WHERE approval_instance_id IS NOT NULL; COMMENT ON TABLE tb_withdrawal_qualification IS '提现资料资格版本，不可变保存历史、附件引用与审批结果'; COMMENT ON COLUMN tb_withdrawal_qualification.id IS '主键，资料版本ID，同时作为通用审批业务ID'; COMMENT ON COLUMN tb_withdrawal_qualification.shop_id IS '所属代理店铺ID'; COMMENT ON COLUMN tb_withdrawal_qualification.subject_type IS '签约主体类型：enterprise 企业、personal 个人'; COMMENT ON COLUMN tb_withdrawal_qualification.subject_code IS '签约主体代码：企业统一社会信用代码、个人身份证号（脱敏后对外展示）'; COMMENT ON COLUMN tb_withdrawal_qualification.legal_person_id_card IS '法人身份证号，个人代理与签约主体代码一致（脱敏后对外展示）'; COMMENT ON COLUMN tb_withdrawal_qualification.contract_file_key IS '合同附件对象存储 Key，单个对象，必填'; COMMENT ON COLUMN tb_withdrawal_qualification.id_card_front_file_key IS '法人身份证正面附件对象存储 Key，单个对象，必填'; COMMENT ON COLUMN tb_withdrawal_qualification.id_card_back_file_key IS '法人身份证反面附件对象存储 Key，单个对象，必填'; COMMENT ON COLUMN tb_withdrawal_qualification.business_license_file_key IS '营业执照附件对象存储 Key，单个对象，可选'; COMMENT ON COLUMN tb_withdrawal_qualification.shop_front_file_key IS '门头照附件对象存储 Key，单个对象，可选'; COMMENT ON COLUMN tb_withdrawal_qualification.invoice_file_key IS '发票附件对象存储 Key，单个对象，仅企业可选'; COMMENT ON COLUMN tb_withdrawal_qualification.invoice_title IS '发票抬头，仅企业填写，且必须与签约主体一致'; COMMENT ON COLUMN tb_withdrawal_qualification.invoice_subject_code IS '发票统一社会信用代码，必须与签约主体代码一致'; COMMENT ON COLUMN tb_withdrawal_qualification.status IS '状态：0 待审批、1 已通过有效、2 已驳回、3 已失效或已作废'; COMMENT ON COLUMN tb_withdrawal_qualification.invalid_reason IS '失效原因，作废必填，代理停用联动失效时记录停用原因'; COMMENT ON COLUMN tb_withdrawal_qualification.invalidated_at IS '失效时间，状态为 3 时必填'; COMMENT ON COLUMN tb_withdrawal_qualification.invalidated_by IS '使资格失效的操作账号ID，0 表示由店铺停用联动触发'; COMMENT ON COLUMN tb_withdrawal_qualification.approval_instance_id IS '关联的通用审批实例ID，创建后不可修改'; COMMENT ON COLUMN tb_withdrawal_qualification.decided_at IS '审批终态到达时间'; COMMENT ON COLUMN tb_withdrawal_qualification.creator IS '创建人用户ID'; COMMENT ON COLUMN tb_withdrawal_qualification.updater IS '最近更新人用户ID'; COMMENT ON COLUMN tb_withdrawal_qualification.created_at IS '创建时间'; COMMENT ON COLUMN tb_withdrawal_qualification.updated_at IS '最近更新时间'; CREATE TABLE tb_commission_withdrawal_request_attempt ( id BIGSERIAL PRIMARY KEY, request_id BIGINT NOT NULL, attempt_no INTEGER NOT NULL, amount BIGINT NOT NULL, fee BIGINT NOT NULL DEFAULT 0, fee_rate BIGINT NOT NULL DEFAULT 0, actual_amount BIGINT NOT NULL DEFAULT 0, withdrawal_method VARCHAR(20) NOT NULL, account_info JSONB NOT NULL, invoice_keys JSONB NOT NULL DEFAULT '[]'::jsonb, submitted_by_account_id BIGINT NOT NULL, approval_instance_id BIGINT, released_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), CONSTRAINT uk_commission_withdrawal_attempt_no UNIQUE (request_id, attempt_no), CONSTRAINT chk_commission_withdrawal_attempt_ids CHECK ( request_id > 0 AND submitted_by_account_id > 0 ), CONSTRAINT chk_commission_withdrawal_attempt_no_positive CHECK (attempt_no >= 1), CONSTRAINT chk_commission_withdrawal_attempt_amount CHECK ( amount > 0 AND fee >= 0 AND fee_rate >= 0 AND actual_amount >= 0 ), CONSTRAINT chk_commission_withdrawal_attempt_method CHECK (withdrawal_method <> ''), CONSTRAINT chk_commission_withdrawal_attempt_account CHECK (jsonb_typeof(account_info) = 'object'), CONSTRAINT chk_commission_withdrawal_attempt_invoice CHECK (jsonb_typeof(invoice_keys) = 'array'), CONSTRAINT chk_commission_withdrawal_attempt_instance CHECK ( approval_instance_id IS NULL OR approval_instance_id > 0 ) ); CREATE UNIQUE INDEX uk_commission_withdrawal_attempt_instance ON tb_commission_withdrawal_request_attempt (approval_instance_id) WHERE approval_instance_id IS NOT NULL; CREATE INDEX idx_commission_withdrawal_attempt_request ON tb_commission_withdrawal_request_attempt (request_id, attempt_no DESC); -- 未结算尝试是后续佣金回溯的释放接缝：按申请读取未释放尝试。 CREATE INDEX idx_commission_withdrawal_attempt_unreleased ON tb_commission_withdrawal_request_attempt (request_id, id) WHERE released_at IS NULL; COMMENT ON TABLE tb_commission_withdrawal_request_attempt IS '提现审批尝试记录，每次提交或重提一条不可变材料与冻结事实'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.id IS '主键，审批尝试记录ID，同时作为通用审批业务ID'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.request_id IS '所属提现申请ID'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.attempt_no IS '第几次提交，从 1 递增，申请内唯一'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.amount IS '本次冻结的提现金额（单位：分），释放与扣减一律取该事实'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.fee IS '本次手续费快照（单位：分）'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.fee_rate IS '本次手续费率快照（基点，100=1%）'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.actual_amount IS '本次实际到账金额快照（单位：分）'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.withdrawal_method IS '本次收款方式快照'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.account_info IS '本次收款账户信息快照（jsonb 对象）'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.invoice_keys IS '本次申请级发票对象存储 Key 列表（jsonb 数组）'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.submitted_by_account_id IS '本次实际提交账号ID'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.approval_instance_id IS '本次尝试关联的通用审批实例ID，创建后不可修改'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.released_at IS '本次冻结释放时间，空表示冻结仍未结算；是回溯可重放的幂等依据'; COMMENT ON COLUMN tb_commission_withdrawal_request_attempt.created_at IS '创建时间'; ALTER TABLE tb_commission_withdrawal_request ADD COLUMN IF NOT EXISTS latest_attempt_id BIGINT NOT NULL DEFAULT 0, ADD COLUMN IF NOT EXISTS latest_approval_instance_id BIGINT NOT NULL DEFAULT 0, ADD COLUMN IF NOT EXISTS approval_instance_id BIGINT, ADD COLUMN IF NOT EXISTS anomaly_flag SMALLINT NOT NULL DEFAULT 0, ADD COLUMN IF NOT EXISTS anomaly_reason VARCHAR(500) NOT NULL DEFAULT ''; ALTER TABLE tb_commission_withdrawal_request DROP CONSTRAINT IF EXISTS chk_commission_withdrawal_request_approval_instance; ALTER TABLE tb_commission_withdrawal_request ADD CONSTRAINT chk_commission_withdrawal_request_approval_instance CHECK (approval_instance_id IS NULL OR approval_instance_id > 0); ALTER TABLE tb_commission_withdrawal_request DROP CONSTRAINT IF EXISTS chk_commission_withdrawal_request_anomaly; ALTER TABLE tb_commission_withdrawal_request ADD CONSTRAINT chk_commission_withdrawal_request_anomaly CHECK (anomaly_flag IN (0, 1)); COMMENT ON COLUMN tb_commission_withdrawal_request.latest_attempt_id IS '最新审批尝试记录ID，仅用于列表投影与历史事实定位'; COMMENT ON COLUMN tb_commission_withdrawal_request.latest_approval_instance_id IS '最新通用审批实例ID，仅用于列表投影'; COMMENT ON COLUMN tb_commission_withdrawal_request.approval_instance_id IS '首次接入企业微信审批时关联的审批实例ID；为空表示从未关联审批实例的存量申请，仍走本地人工终审'; COMMENT ON COLUMN tb_commission_withdrawal_request.anomaly_flag IS '正交异常标记：0 无异常、1 企业微信通过后撤销'; COMMENT ON COLUMN tb_commission_withdrawal_request.anomaly_reason IS '异常原因，供提现详情展示与人工处理';