break
93e072e1e2
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 11m42s
- 新增成对迁移 000222：tb_exchange_order 增加非空 migration_status 与 migration_failure_reason，按既有 migrate_data/migration_completed 回填历史， 并加四值 CHECK 约束，不新增索引 - 模型与常量定义四种迁移状态及中文名称，保留既有布尔字段兼容语义 - 物流换货创建恒 not_migrated，发货按请求落 pending/not_migrated， 完成成功写 migrated/not_migrated 并清空失败原因、同步兼容字段 - 直接换货创建即完成，任一步失败整体回滚，不持久化换货单、不产生 failed - 迁移失败回滚全部业务修改后，在独立短事务内条件更新 failed 与安全失败原因 并写失败审计，RowsAffected 为 0 时跳过状态写入但仍写审计 - failed 物流单重试仅限超级管理员或平台用户，授权以锁内 FOR UPDATE 判定为准， 重试从钱包余额起整表重跑；非 failed 单沿用既有完成门禁 - 列表与详情返回迁移状态与中文名称，仅 failed 返回失败原因；既有三字段保持兼容 - 换货导出在「状态」列后新增中文「迁移状态」列，不导出失败原因 - 同步 order-refund-exchange 主 spec 与验证证据，归档本 Change - 登记 KNOWN-ISSUE-001：既有标签复制 OnConflict 未声明部分索引谓词（42P10）， 旧资产带标签时迁移最后一步失败，待另立变更修复
69 lines
2.3 KiB
Go
69 lines
2.3 KiB
Go
package routes
|
||
|
||
import (
|
||
"github.com/break/junhong_cmp_fiber/internal/handler/admin"
|
||
"github.com/break/junhong_cmp_fiber/internal/model/dto"
|
||
"github.com/break/junhong_cmp_fiber/pkg/openapi"
|
||
"github.com/gofiber/fiber/v2"
|
||
)
|
||
|
||
func registerAdminExchangeRoutes(router fiber.Router, handler *admin.ExchangeHandler, doc *openapi.Generator, basePath string) {
|
||
Register(router, doc, basePath, "POST", "/exchanges", handler.Create, RouteSpec{
|
||
Summary: "创建换货单",
|
||
Tags: []string{"换货管理"},
|
||
Input: new(dto.CreateExchangeRequest),
|
||
Output: new(dto.ExchangeOrderResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(router, doc, basePath, "GET", "/exchanges", handler.List, RouteSpec{
|
||
Summary: "获取换货单列表",
|
||
Tags: []string{"换货管理"},
|
||
Input: new(dto.ExchangeListRequest),
|
||
Output: new(dto.ExchangeListResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(router, doc, basePath, "GET", "/exchanges/:id", handler.Get, RouteSpec{
|
||
Summary: "获取换货单详情",
|
||
Tags: []string{"换货管理"},
|
||
Input: new(dto.ExchangeIDRequest),
|
||
Output: new(dto.ExchangeOrderResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", "/exchanges/:id/ship", handler.Ship, RouteSpec{
|
||
Summary: "换货发货",
|
||
Tags: []string{"换货管理"},
|
||
Input: new(dto.ExchangeShipParams),
|
||
Output: new(dto.ExchangeOrderResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", "/exchanges/:id/complete", handler.Complete, RouteSpec{
|
||
Summary: "确认换货完成",
|
||
Description: "确认换货完成；仅超级管理员或平台用户可对迁移状态为 failed 的物流换货单重试，" +
|
||
"其他账号对 failed 单返回 403/1005；非 failed 单沿用既有完成权限。",
|
||
Tags: []string{"换货管理"},
|
||
Input: new(dto.ExchangeIDRequest),
|
||
Output: nil,
|
||
Auth: true,
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", "/exchanges/:id/cancel", handler.Cancel, RouteSpec{
|
||
Summary: "取消换货",
|
||
Tags: []string{"换货管理"},
|
||
Input: new(dto.ExchangeCancelParams),
|
||
Output: nil,
|
||
Auth: true,
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", "/exchanges/:id/renew", handler.Renew, RouteSpec{
|
||
Summary: "旧资产转新",
|
||
Tags: []string{"换货管理"},
|
||
Input: new(dto.ExchangeIDRequest),
|
||
Output: nil,
|
||
Auth: true,
|
||
})
|
||
}
|