Files
junhong_cmp_fiber/pkg/constants/approval.go
break ce24d5612e
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m20s
feat(员工代收款): 新增员工代收款账单闭环
- 新增 6 张表与成对迁移 000212,扩展企业微信审批场景业务类型白名单
- 后台线下套餐订单与两条代理线下充值入账路径在来源成功事务内建账,来源唯一键幂等
- 核销申请、审批尝试记录、账单分摊预占与驳回重提,审批业务类型 employee_collection_approval
- 企业微信终态消费幂等:通过转已核销、驳回释放预占、通过后撤销不回滚并转异常终态
- 退款成功事务内按 bill_id+refund_id 幂等冲销账单或仅写退款关联提示
- 线下收款方式字典、账单查询/统计/关闭、申请查询与代办权限,均写入事务内审计

OpenSpec Change: add-employee-collection-bills
2026-09-10 18:24:05 +08:00

197 lines
9.3 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package constants
import "time"
const (
// ApprovalBusinessTypeRefund 表示退款审批业务场景。
ApprovalBusinessTypeRefund = "refund_approval"
// ApprovalBusinessTypeOfflineRecharge 表示员工线下代充值审批业务场景。
ApprovalBusinessTypeOfflineRecharge = "offline_recharge_approval"
// ApprovalBusinessTypeEmployeeCollection 表示员工代收款核销审批业务场景。
// 该场景的业务ID取核销申请的审批尝试记录主键使同一申请每次提交各自持有独立审批实例。
ApprovalBusinessTypeEmployeeCollection = "employee_collection_approval"
)
const (
// ApprovalFieldRechargeNo 表示线下代充值单号业务字段。
ApprovalFieldRechargeNo = "recharge_no"
// ApprovalFieldShopID 表示线下代充值目标店铺 ID 业务字段。
ApprovalFieldShopID = "shop_id"
// ApprovalFieldShopName 表示线下代充值目标店铺名称业务字段。
ApprovalFieldShopName = "shop_name"
// ApprovalFieldAmount 表示线下代充值元金额展示业务字段。
ApprovalFieldAmount = "amount"
// ApprovalFieldAmountCent 表示线下代充值分金额业务字段。
ApprovalFieldAmountCent = "amount_cent"
// ApprovalFieldPaymentVoucherKey 表示线下代充值凭证对象存储 Key 列表业务字段。
ApprovalFieldPaymentVoucherKey = "payment_voucher_key"
// ApprovalFieldRemark 表示线下代充值运营备注业务字段。
ApprovalFieldRemark = "remark"
// ApprovalFieldSubmitterID 表示真实业务提交人账号 ID 业务字段。
ApprovalFieldSubmitterID = "submitter_id"
// ApprovalFieldSubmitterName 表示真实业务提交人账号名称业务字段。
ApprovalFieldSubmitterName = "submitter_name"
// ApprovalFieldRefundNo 表示退款单号业务字段。
ApprovalFieldRefundNo = "refund_no"
// ApprovalFieldOrderID 表示退款关联订单 ID 业务字段。
ApprovalFieldOrderID = "order_id"
// ApprovalFieldOrderNo 表示退款关联订单号业务字段。
ApprovalFieldOrderNo = "order_no"
// ApprovalFieldAssetIdentifier 表示退款资产标识业务字段。
ApprovalFieldAssetIdentifier = "asset_identifier"
// ApprovalFieldAssetType 表示退款资产类型业务字段。
ApprovalFieldAssetType = "asset_type"
// ApprovalFieldActualReceivedAmount 表示退款实收金额业务字段。
ApprovalFieldActualReceivedAmount = "actual_received_amount"
// ApprovalFieldRequestedRefundAmount 表示申请退款金额业务字段。
ApprovalFieldRequestedRefundAmount = "requested_refund_amount"
// ApprovalFieldRefundVoucherKey 表示退款凭证对象存储 Key 列表业务字段。
ApprovalFieldRefundVoucherKey = "refund_voucher_key"
// ApprovalFieldRefundReason 表示退款原因业务字段。
ApprovalFieldRefundReason = "refund_reason"
// ApprovalFieldPackageUsageID 表示退款指定套餐使用记录 ID 业务字段。
ApprovalFieldPackageUsageID = "package_usage_id"
// ApprovalFieldCollectionApplicationID 表示员工代收款核销申请 ID 业务字段。
ApprovalFieldCollectionApplicationID = "collection_application_id"
// ApprovalFieldCollectionPaymentMethod 表示员工代收款线下收款方式名称业务字段。
ApprovalFieldCollectionPaymentMethod = "collection_payment_method"
// ApprovalFieldCollectionPaidAmount 表示员工代收款付款金额元展示业务字段。
ApprovalFieldCollectionPaidAmount = "collection_paid_amount"
// ApprovalFieldCollectionPaidAmountCent 表示员工代收款付款金额分业务字段。
ApprovalFieldCollectionPaidAmountCent = "collection_paid_amount_cent"
// ApprovalFieldCollectionPayerName 表示员工代收款付款方名称业务字段。
ApprovalFieldCollectionPayerName = "collection_payer_name"
// ApprovalFieldCollectionPaidAt 表示员工代收款付款时间业务字段。
ApprovalFieldCollectionPaidAt = "collection_paid_at"
// ApprovalFieldCollectionExternalTransactionNo 表示员工代收款外部交易流水号业务字段。
ApprovalFieldCollectionExternalTransactionNo = "collection_external_transaction_no"
// ApprovalFieldCollectionBillCount 表示员工代收款分摊账单数量业务字段。
ApprovalFieldCollectionBillCount = "collection_bill_count"
// ApprovalFieldCollectionBillSummary 表示员工代收款分摊账单摘要业务字段。
ApprovalFieldCollectionBillSummary = "collection_bill_summary"
)
const (
// ApprovalFieldValueTypeString 表示业务字段值为普通字符串。
ApprovalFieldValueTypeString = "string"
// ApprovalFieldValueTypeInteger 表示业务字段值为整数。
ApprovalFieldValueTypeInteger = "integer"
// ApprovalFieldValueTypeMoney 表示业务字段值为两位小数的元金额字符串。
ApprovalFieldValueTypeMoney = "money"
// ApprovalFieldValueTypeFileList 表示业务字段值为对象存储文件引用列表。
ApprovalFieldValueTypeFileList = "file_list"
)
const (
// ApprovalStatusSubmitting 表示审批申请等待渠道提交。
ApprovalStatusSubmitting = 0
// ApprovalStatusPending 表示审批申请已进入渠道审批。
ApprovalStatusPending = 1
// ApprovalStatusApproved 表示审批已通过。
ApprovalStatusApproved = 2
// ApprovalStatusRejected 表示审批已拒绝。
ApprovalStatusRejected = 3
// ApprovalStatusCancelled 表示审批已撤销。
ApprovalStatusCancelled = 4
// ApprovalStatusRevokedAfterApproved 表示审批通过后被撤销。
ApprovalStatusRevokedAfterApproved = 5
// ApprovalStatusDeleted 表示审批已删除。
ApprovalStatusDeleted = 6
// ApprovalStatusSubmissionFailed 表示渠道明确确认审批提交失败。
ApprovalStatusSubmissionFailed = 7
// ApprovalStatusSubmissionUnknown 表示审批提交请求已发出但结果未知。
ApprovalStatusSubmissionUnknown = 8
)
const (
// ApprovalDecisionApproved 表示标准审批通过决策。
ApprovalDecisionApproved = "approved"
// ApprovalDecisionRejected 表示标准审批拒绝决策。
ApprovalDecisionRejected = "rejected"
// ApprovalDecisionCancelled 表示标准审批撤销决策。
ApprovalDecisionCancelled = "cancelled"
// ApprovalDecisionDeleted 表示标准审批删除决策。
ApprovalDecisionDeleted = "deleted"
// ApprovalDecisionRevokedAfterApproved 表示标准审批通过后撤销决策。
ApprovalDecisionRevokedAfterApproved = "revoked_after_approved"
)
const (
// ApprovalInitialVersion 表示通用审批实例的初始乐观锁版本。
ApprovalInitialVersion = 1
// ApprovalQueryMaxBatchSize 表示通用审批摘要单次批量投影上限。
ApprovalQueryMaxBatchSize = 100
// ApprovalUnknownSubmitterName 表示提交人名称快照无法解析。
ApprovalUnknownSubmitterName = "未知账号"
// ApprovalDecisionDeliveryLeaseDuration 表示标准决策消费者的单次处理租约时长。
ApprovalDecisionDeliveryLeaseDuration = 5 * time.Minute
// ApprovalPreparationTTL 表示事务前审批可用性结果允许复用的最长期限。
ApprovalPreparationTTL = 30 * time.Second
)
const (
// ApprovalAuditActorWeCom 表示企业微信外部审批系统。
ApprovalAuditActorWeCom = "wecom"
// ApprovalAuditActorSubmissionWorker 表示企业微信审批提交 Worker。
ApprovalAuditActorSubmissionWorker = "wecom_approval_submission"
// ApprovalAuditActorRecoveryJob 表示企业微信审批主动恢复计划任务。
ApprovalAuditActorRecoveryJob = "wecom_approval_recovery"
)
const (
// ApprovalDecisionDeliveryPending 表示标准决策等待业务消费。
ApprovalDecisionDeliveryPending = 0
// ApprovalDecisionDeliveryProcessing 表示标准决策已被消费者租约领取。
ApprovalDecisionDeliveryProcessing = 1
// ApprovalDecisionDeliverySucceeded 表示标准决策已被业务幂等处理。
ApprovalDecisionDeliverySucceeded = 2
// ApprovalDecisionDeliveryFailed 表示标准决策消费失败并等待重试。
ApprovalDecisionDeliveryFailed = 3
)
const (
// OutboxEventTypeApprovalTerminalDecision 表示通用审批标准终态已记录。
OutboxEventTypeApprovalTerminalDecision = "approval.terminal_decision.recorded"
// OutboxEventTypeApprovalSubmissionRequested 表示通用审批实例等待渠道提交。
OutboxEventTypeApprovalSubmissionRequested = "approval.submission.requested"
// ApprovalTerminalDecisionPayloadVersionV1 表示标准终态事件载荷第一版。
ApprovalTerminalDecisionPayloadVersionV1 = 1
// ApprovalSubmissionPayloadVersionV1 表示审批申请提交事件载荷第一版。
ApprovalSubmissionPayloadVersionV1 = 1
)
const (
// ApprovalSyncSourceCallback 表示由第三方审批回调触发权威同步。
ApprovalSyncSourceCallback = "callback"
// ApprovalSyncSourcePolling 表示由定时兜底轮询触发权威同步。
ApprovalSyncSourcePolling = "polling"
// ApprovalSyncSourceManual 表示由受控人工动作触发权威同步。
ApprovalSyncSourceManual = "manual"
)
// GetApprovalStatusName 返回通用审批状态的中文名称。
func GetApprovalStatusName(status int) string {
switch status {
case ApprovalStatusSubmitting:
return "提交中"
case ApprovalStatusPending:
return "审批中"
case ApprovalStatusApproved:
return "已通过"
case ApprovalStatusRejected:
return "已拒绝"
case ApprovalStatusCancelled:
return "已撤销"
case ApprovalStatusRevokedAfterApproved:
return "通过后撤销"
case ApprovalStatusDeleted:
return "已删除"
case ApprovalStatusSubmissionFailed:
return "提交失败"
case ApprovalStatusSubmissionUnknown:
return "提交结果未知"
default:
return "未知"
}
}