fix: 修复 OpenAPI 文档生成器启动 panic，路由缺少 path parameter 定义

- 新增 UpdateWechatConfigParams/AgentOfflinePayParams 聚合结构体，嵌入 IDReq 提供 path:id 标签
- 修复 PUT /:id 和 POST /:id/offline-pay 路由的 Input 引用
- 修复 Makefile 构建路径从单文件改为包路径，解决多文件编译问题
- 标记 tasks.md 中 1.2.4 迁移任务为已完成

internal/model/dto/agent_recharge_dto.go

@@ -12,6 +12,12 @@ type AgentOfflinePayRequest struct {
 	OperationPassword string `json:"operation_password" validate:"required" required:"true" description:"操作密码"`
 }
 
+// AgentOfflinePayParams 确认线下充值聚合参数 (用于文档生成)
+type AgentOfflinePayParams struct {
+	IDReq
+	AgentOfflinePayRequest
+}
+
 // AgentRechargeResponse 代理充值记录响应
 type AgentRechargeResponse struct {
 	ID                   uint    `json:"id" description:"充值记录ID"`

internal/model/dto/wechat_config_dto.go

@@ -70,6 +70,12 @@ type UpdateWechatConfigRequest struct {
 	FyNotifyURL  *string `json:"fy_notify_url" validate:"omitempty,max=500" maxLength:"500" description:"富友支付回调地址"`
 }
 
+// UpdateWechatConfigParams 更新微信参数配置聚合参数 (用于文档生成)
+type UpdateWechatConfigParams struct {
+	IDReq
+	UpdateWechatConfigRequest
+}
+
 // WechatConfigListRequest 微信参数配置列表查询请求
 type WechatConfigListRequest struct {
 	Page         int     `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`

internal/routes/agent_recharge.go

@@ -48,7 +48,7 @@ func registerAgentRechargeRoutes(router fiber.Router, handler *admin.AgentRechar
 	Register(group, doc, groupPath, "POST", "/:id/offline-pay", handler.OfflinePay, RouteSpec{
 		Summary: "确认线下充值",
 		Tags:    []string{"代理预充值"},
-		Input:   new(dto.AgentOfflinePayRequest),
+		Input:   new(dto.AgentOfflinePayParams),
 		Output:  new(dto.AgentRechargeResponse),
 		Auth:    true,
 	})

internal/routes/wechat_config.go

@@ -58,7 +58,7 @@ func registerWechatConfigRoutes(router fiber.Router, handler *admin.WechatConfig
 	Register(group, doc, groupPath, "PUT", "/:id", handler.Update, RouteSpec{
 		Summary: "更新支付配置",
 		Tags:    []string{"微信支付配置管理"},
-		Input:   new(dto.UpdateWechatConfigRequest),
+		Input:   new(dto.UpdateWechatConfigParams),
 		Output:  new(dto.WechatConfigResponse),
 		Auth:    true,
 	})