Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
AUG26-008。
- 迁移 000214–000217:tb_shop 全局唯一且不可修改的随机分销码(含存量回填)、
tb_agent_distribution_registration 待审批注册记录、tb_withdrawal_qualification 资料版本、
tb_commission_withdrawal_request_attempt 审批尝试记录,以及提现申请的 latest_*/异常标记列;
不修改既有迁移,down 在存在本 Change 业务事实或新类型场景行时拒绝破坏性回滚。
- 公开接口 POST /api/c/v1/agent-distribution-registrations:无认证,复用既有短信验证码校验、
消费与限流;无效分销码、停用上级、验证码无效或已消费统一返回「分销码不可用」且不落库,
审批通过前不创建店铺、账号或钱包。
- 审批通过才在同一事务内建启用店铺、代理主账号、钱包、上级层级与业务员快照,驳回不建实体,
重复回调不重复建实体,提交后清理上级下级缓存。
- 提现资料资格按不可变版本保存,替换合同或法人身份证即新增版本并同事务失效旧有效版本;
超管作废原因必填;代理停用与店铺删除联动失效。
- 提现每次提交或重提新增不可变审批尝试记录并冻结金额;企业微信通过仅一次从冻结扣减、
保持状态 2 并写 paid_at(不使用状态 4),驳回/cancelled/deleted 仅一次释放,
通过后撤销不回滚、不重新冻结、只写正交异常标记;加锁顺序统一为申请→尝试→钱包。
- 本地人工终审对已关联审批实例的申请返回状态冲突,approval_instance_id 为空的存量申请保持既有行为,
不新增任何配置开关。
- 补齐审批业务类型注册点全集:业务类型与场景字段常量、场景 DTO 两处枚举与中文描述、
场景字段白名单/合法类型/中文名、数据库 CHECK、Worker 决策消费者与装配、审批审计资源映射,
以及三个新审计资源与 13 个审计动作;失败/拒绝审计改为必达。
- 新增后台路由与 OpenAPI:资格提交/查询/作废、提现申请/重提/详情、店铺详情返回只读分销码。
- 归档本 Change:主 Spec 新增 agent-distribution-withdrawal 能力(5 个 Requirement)。
验证(junhong_cmp_test + Redis DB 6,显式 DB_*,未重置整库):
- 迁移 up → version 217 且 dirty=false → down 3 → up 回 217,fixture 复核残留为 0。
- 受控状态机脚手架 227 项通过 / 0 项失败,覆盖 18 组场景(幂等与乱序回调、资金冻结/释放/重提、
退款回扣 × 在途提现并发、负向场景拒绝审计与 14 个动作码审计真实落库)。
- gofmt 空、go build/go vet 通过、gendocs 与工作区逐字节一致、context-health 通过、
openspec validate --strict 通过、doctor healthy;自动化测试按项目决策为 N/A。
运行期前置(未完成,非代码交付物):由超管经 PUT /api/admin/wecom/scenes/{business_type} 为
agent_distribution_approval、withdrawal_qualification_approval、commission_withdrawal_approval
配置启用场景与模板控件映射;未配置时相应提交失败关闭。
166 lines
6.5 KiB
Go
166 lines
6.5 KiB
Go
package routes
|
||
|
||
import (
|
||
"github.com/gofiber/fiber/v2"
|
||
|
||
"github.com/break/junhong_cmp_fiber/internal/bootstrap"
|
||
"github.com/break/junhong_cmp_fiber/pkg/openapi"
|
||
)
|
||
|
||
// RegisterAdminRoutes 注册管理后台相关路由
|
||
func RegisterAdminRoutes(router fiber.Router, handlers *bootstrap.Handlers, middlewares *bootstrap.Middlewares, doc *openapi.Generator, basePath string) {
|
||
// 认证路由已迁移到 /api/auth,参见 RegisterAuthRoutes
|
||
authGroup := router.Group("", middlewares.AdminAuth)
|
||
|
||
if handlers.Account != nil {
|
||
registerAccountRoutes(authGroup, handlers.Account, doc, basePath)
|
||
}
|
||
if handlers.Role != nil {
|
||
registerRoleRoutes(authGroup, handlers.Role, doc, basePath)
|
||
}
|
||
if handlers.Permission != nil {
|
||
registerPermissionRoutes(authGroup, handlers.Permission, doc, basePath)
|
||
}
|
||
if handlers.Shop != nil {
|
||
registerShopRoutes(authGroup, handlers.Shop, doc, basePath)
|
||
}
|
||
if handlers.ShopRole != nil {
|
||
registerShopRoleRoutes(authGroup, handlers.ShopRole, doc, basePath)
|
||
}
|
||
|
||
if handlers.ShopCommission != nil {
|
||
registerShopCommissionRoutes(authGroup, handlers.ShopCommission, doc, basePath)
|
||
}
|
||
if handlers.WithdrawalQualification != nil {
|
||
registerWithdrawalQualificationRoutes(authGroup, handlers.WithdrawalQualification, doc, basePath)
|
||
}
|
||
if handlers.Shop != nil {
|
||
registerShopDetailRoute(authGroup, handlers.Shop, doc, basePath)
|
||
}
|
||
if handlers.CommissionWithdrawal != nil {
|
||
registerCommissionWithdrawalRoutes(authGroup, handlers.CommissionWithdrawal, doc, basePath)
|
||
}
|
||
if handlers.CommissionWithdrawalSetting != nil {
|
||
registerCommissionWithdrawalSettingRoutes(authGroup, handlers.CommissionWithdrawalSetting, doc, basePath)
|
||
}
|
||
if handlers.Enterprise != nil {
|
||
registerEnterpriseRoutes(authGroup, handlers.Enterprise, doc, basePath)
|
||
}
|
||
if handlers.EnterpriseCard != nil {
|
||
registerEnterpriseCardRoutes(authGroup, handlers.EnterpriseCard, doc, basePath)
|
||
}
|
||
if handlers.EnterpriseDevice != nil {
|
||
registerEnterpriseDeviceRoutes(authGroup, handlers.EnterpriseDevice, doc, basePath)
|
||
}
|
||
if handlers.Authorization != nil {
|
||
registerAuthorizationRoutes(authGroup, handlers.Authorization, doc, basePath)
|
||
}
|
||
|
||
if handlers.IotCard != nil {
|
||
registerIotCardRoutes(authGroup, handlers.IotCard, handlers.IotCardImport, doc, basePath)
|
||
}
|
||
if handlers.ExportTask != nil {
|
||
registerExportTaskRoutes(authGroup, handlers.ExportTask, doc, basePath)
|
||
}
|
||
if handlers.Notification != nil {
|
||
registerNotificationRoutes(authGroup, handlers.Notification, doc, basePath)
|
||
}
|
||
if handlers.Device != nil {
|
||
registerDeviceRoutes(authGroup, handlers.Device, handlers.DeviceImport, doc, basePath)
|
||
}
|
||
if handlers.AssetLifecycle != nil {
|
||
registerAssetLifecycleRoutes(authGroup, handlers.AssetLifecycle, doc, basePath)
|
||
}
|
||
if handlers.AssetAllocationRecord != nil {
|
||
registerAssetAllocationRecordRoutes(authGroup, handlers.AssetAllocationRecord, doc, basePath)
|
||
}
|
||
if handlers.Storage != nil {
|
||
registerStorageRoutes(authGroup, handlers.Storage, doc, basePath)
|
||
}
|
||
if handlers.Carrier != nil {
|
||
registerCarrierRoutes(authGroup, handlers.Carrier, doc, basePath)
|
||
}
|
||
if handlers.PackageSeries != nil {
|
||
registerPackageSeriesRoutes(authGroup, handlers.PackageSeries, doc, basePath)
|
||
}
|
||
if handlers.Package != nil {
|
||
registerPackageRoutes(authGroup, handlers.Package, doc, basePath)
|
||
}
|
||
if handlers.PackageUsage != nil {
|
||
registerPackageUsageRoutes(authGroup, handlers.PackageUsage, doc, basePath)
|
||
}
|
||
if handlers.ShopPackageBatchAllocation != nil {
|
||
registerShopPackageBatchAllocationRoutes(authGroup, handlers.ShopPackageBatchAllocation, doc, basePath)
|
||
}
|
||
if handlers.ShopPackageBatchPricing != nil {
|
||
registerShopPackageBatchPricingRoutes(authGroup, handlers.ShopPackageBatchPricing, doc, basePath)
|
||
}
|
||
if handlers.ShopSeriesGrant != nil {
|
||
registerShopSeriesGrantRoutes(authGroup, handlers.ShopSeriesGrant, doc, basePath)
|
||
}
|
||
if handlers.AdminOrder != nil {
|
||
registerAdminOrderRoutes(authGroup, handlers.AdminOrder, doc, basePath)
|
||
}
|
||
if handlers.AdminExchange != nil {
|
||
registerAdminExchangeRoutes(authGroup, handlers.AdminExchange, doc, basePath)
|
||
}
|
||
if handlers.PollingConfig != nil {
|
||
registerPollingConfigRoutes(authGroup, handlers.PollingConfig, doc, basePath)
|
||
}
|
||
if handlers.PollingConcurrency != nil {
|
||
registerPollingConcurrencyRoutes(authGroup, handlers.PollingConcurrency, doc, basePath)
|
||
}
|
||
if handlers.PollingMonitoring != nil {
|
||
registerPollingMonitoringRoutes(authGroup, handlers.PollingMonitoring, doc, basePath)
|
||
}
|
||
if handlers.PollingAlert != nil {
|
||
registerPollingAlertRoutes(authGroup, handlers.PollingAlert, doc, basePath)
|
||
}
|
||
if handlers.PollingCleanup != nil {
|
||
registerPollingCleanupRoutes(authGroup, handlers.PollingCleanup, doc, basePath)
|
||
}
|
||
if handlers.PollingManualTrigger != nil {
|
||
registerPollingManualTriggerRoutes(authGroup, handlers.PollingManualTrigger, doc, basePath)
|
||
}
|
||
if handlers.Asset != nil {
|
||
registerAssetRoutes(authGroup, handlers.Asset, handlers.AssetWallet, doc, basePath)
|
||
registerPackageExpiryRoutes(authGroup, handlers.Asset, doc, basePath)
|
||
}
|
||
if handlers.WechatConfig != nil {
|
||
registerWechatConfigRoutes(authGroup, handlers.WechatConfig, doc, basePath)
|
||
}
|
||
if handlers.PaymentMerchant != nil {
|
||
registerPaymentMerchantRoutes(authGroup, handlers.PaymentMerchant, doc, basePath)
|
||
}
|
||
if handlers.EmployeeCollection != nil {
|
||
registerEmployeeCollectionRoutes(authGroup, handlers.EmployeeCollection, doc, basePath)
|
||
registerEmployeeCollectionBillRoutes(authGroup, handlers.EmployeeCollection, doc, basePath)
|
||
registerEmployeeCollectionApplicationRoutes(authGroup, handlers.EmployeeCollection, doc, basePath)
|
||
}
|
||
if handlers.AgentRecharge != nil {
|
||
registerAgentSelfRechargePaymentMethodRoutes(authGroup, handlers.AgentRecharge, doc, basePath)
|
||
registerAgentRechargeRoutes(authGroup, handlers.AgentRecharge, doc, basePath)
|
||
}
|
||
if handlers.Refund != nil {
|
||
registerRefundRoutes(authGroup, handlers.Refund, doc, basePath)
|
||
}
|
||
if handlers.OrderPackageInvalidate != nil {
|
||
registerOrderPackageInvalidateRoutes(authGroup, handlers.OrderPackageInvalidate, doc, basePath)
|
||
}
|
||
if handlers.AssetPackageBatchOrder != nil {
|
||
registerAssetPackageBatchOrderRoutes(authGroup, handlers.AssetPackageBatchOrder, doc, basePath)
|
||
}
|
||
if handlers.SuperAdmin != nil {
|
||
registerSuperAdminRoutes(authGroup, handlers.SuperAdmin, doc, basePath)
|
||
}
|
||
if handlers.SystemConfig != nil {
|
||
registerSystemConfigRoutes(authGroup, handlers.SystemConfig, doc, basePath)
|
||
}
|
||
if handlers.Audit != nil {
|
||
registerAuditRoutes(authGroup, handlers.Audit, doc, basePath)
|
||
}
|
||
if handlers.WeCom != nil {
|
||
registerWeComRoutes(authGroup, handlers.WeCom, doc, basePath)
|
||
}
|
||
}
|