f

app/main/api/desc/admin/admin_agent.api

@@ -0,0 +1,426 @@
+syntax = "v1"
+
+info (
+	title:   "后台代理管理服务"
+	desc:    "新代理系统后台管理接口"
+	author:  "team"
+	version: "v1"
+)
+
+// ============================================
+// 代理管理接口
+// ============================================
+@server (
+	prefix:     /api/v1/admin/agent
+	group:      admin_agent
+	middleware: AdminAuthInterceptor
+)
+service main {
+	// 代理分页查询
+	@handler AdminGetAgentList
+	get /list (AdminGetAgentListReq) returns (AdminGetAgentListResp)
+
+	// 代理审核
+	@handler AdminAuditAgent
+	post /audit (AdminAuditAgentReq) returns (AdminAuditAgentResp)
+
+	// 代理推广链接分页查询
+	@handler AdminGetAgentLinkList
+	get /link/list (AdminGetAgentLinkListReq) returns (AdminGetAgentLinkListResp)
+
+	// 代理订单分页查询
+	@handler AdminGetAgentOrderList
+	get /order/list (AdminGetAgentOrderListReq) returns (AdminGetAgentOrderListResp)
+
+	// 代理佣金分页查询
+	@handler AdminGetAgentCommissionList
+	get /commission/list (AdminGetAgentCommissionListReq) returns (AdminGetAgentCommissionListResp)
+
+	// 代理返佣分页查询
+	@handler AdminGetAgentRebateList
+	get /rebate/list (AdminGetAgentRebateListReq) returns (AdminGetAgentRebateListResp)
+
+	// 代理升级记录分页查询
+	@handler AdminGetAgentUpgradeList
+	get /upgrade/list (AdminGetAgentUpgradeListReq) returns (AdminGetAgentUpgradeListResp)
+
+	// 代理提现分页查询
+	@handler AdminGetAgentWithdrawalList
+	get /withdrawal/list (AdminGetAgentWithdrawalListReq) returns (AdminGetAgentWithdrawalListResp)
+
+	// 代理提现审核
+	@handler AdminAuditWithdrawal
+	post /withdrawal/audit (AdminAuditWithdrawalReq) returns (AdminAuditWithdrawalResp)
+
+	// 代理实名认证分页查询
+	@handler AdminGetAgentRealNameList
+	get /real_name/list (AdminGetAgentRealNameListReq) returns (AdminGetAgentRealNameListResp)
+
+	// 代理实名认证审核（已废弃：实名认证改为三要素核验，无需审核）
+	// @handler AdminAuditRealName
+	// post /real_name/audit (AdminAuditRealNameReq) returns (AdminAuditRealNameResp)
+	// 系统配置查询
+	@handler AdminGetAgentConfig
+	get /config returns (AdminGetAgentConfigResp)
+
+	// 系统配置更新
+	@handler AdminUpdateAgentConfig
+	post /config/update (AdminUpdateAgentConfigReq) returns (AdminUpdateAgentConfigResp)
+
+	// 产品配置分页查询
+	@handler AdminGetAgentProductConfigList
+	get /product_config/list (AdminGetAgentProductConfigListReq) returns (AdminGetAgentProductConfigListResp)
+
+	// 产品配置更新
+	@handler AdminUpdateAgentProductConfig
+	post /product_config/update (AdminUpdateAgentProductConfigReq) returns (AdminUpdateAgentProductConfigResp)
+
+	// 生成钻石邀请码
+	@handler AdminGenerateDiamondInviteCode
+	post /invite_code/diamond/generate (AdminGenerateDiamondInviteCodeReq) returns (AdminGenerateDiamondInviteCodeResp)
+
+	// 邀请码列表查询
+	@handler AdminGetInviteCodeList
+	get /invite_code/list (AdminGetInviteCodeListReq) returns (AdminGetInviteCodeListResp)
+}
+
+type (
+	// 代理分页查询
+	AdminGetAgentListReq {
+		Page         int64   `form:"page"` // 页码
+		PageSize     int64   `form:"pageSize"` // 每页数量
+		Mobile       *string `form:"mobile,optional"` // 手机号（可选）
+		Region       *string `form:"region,optional"` // 区域（可选）
+		Level        *int64  `form:"level,optional"` // 等级（可选）
+		TeamLeaderId *string `form:"team_leader_id,optional"` // 团队首领ID（可选）
+	}
+	AgentListItem {
+		Id              string  `json:"id"` // 主键
+		UserId          string  `json:"user_id"` // 用户ID
+		Level           int64   `json:"level"` // 等级：1=普通，2=黄金，3=钻石
+		LevelName       string  `json:"level_name"` // 等级名称
+		Region          string  `json:"region"` // 区域
+		Mobile          string  `json:"mobile"` // 手机号
+		WechatId        string  `json:"wechat_id"` // 微信号
+		TeamLeaderId    string  `json:"team_leader_id"` // 团队首领ID
+		AgentCode       int64   `json:"agent_code"`
+		Balance         float64 `json:"balance"` // 钱包余额
+		TotalEarnings   float64 `json:"total_earnings"` // 累计收益
+		FrozenBalance   float64 `json:"frozen_balance"` // 冻结余额
+		WithdrawnAmount float64 `json:"withdrawn_amount"` // 提现总额
+		IsRealName      bool    `json:"is_real_name"` // 是否已实名
+		CreateTime      string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentListResp {
+		Total int64           `json:"total"` // 总数
+		Items []AgentListItem `json:"items"` // 列表数据
+	}
+	// 代理审核
+	AdminAuditAgentReq {
+		AuditId     int64  `json:"audit_id"` // 审核记录ID
+		Status      int64  `json:"status"` // 审核状态：1=通过，2=拒绝
+		AuditReason string `json:"audit_reason"` // 审核原因（拒绝时必填）
+	}
+	AdminAuditAgentResp {
+		Success bool `json:"success"`
+	}
+	// 推广链接分页查询
+	AdminGetAgentLinkListReq {
+		Page           int64   `form:"page"` // 页码
+		PageSize       int64   `form:"pageSize"` // 每页数量
+		AgentId        *string `form:"agent_id,optional"` // 代理ID（可选）
+		ProductId      *string `form:"product_id,optional"` // 产品ID（可选）
+		LinkIdentifier *string `form:"link_identifier,optional"` // 推广码（可选）
+	}
+	AgentLinkListItem {
+		Id              string  `json:"id"` // 主键
+		AgentId         string  `json:"agent_id"` // 代理ID
+		ProductId       string  `json:"product_id"` // 产品ID
+		ProductName     string  `json:"product_name"` // 产品名称
+		SetPrice        float64 `json:"set_price"` // 设定价格
+		ActualBasePrice float64 `json:"actual_base_price"` // 实际底价
+		LinkIdentifier  string  `json:"link_identifier"` // 推广码
+		CreateTime      string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentLinkListResp {
+		Total int64               `json:"total"` // 总数
+		Items []AgentLinkListItem `json:"items"` // 列表数据
+	}
+	// 代理订单分页查询
+	AdminGetAgentOrderListReq {
+		Page          int64   `form:"page"` // 页码
+		PageSize      int64   `form:"pageSize"` // 每页数量
+		AgentId       *string `form:"agent_id,optional"` // 代理ID（可选）
+		OrderId       *string `form:"order_id,optional"` // 订单ID（可选）
+		ProcessStatus *int64  `form:"process_status,optional"` // 处理状态（可选）
+	}
+	AgentOrderListItem {
+		Id              string  `json:"id"` // 主键
+		AgentId         string  `json:"agent_id"` // 代理ID
+		OrderId         string  `json:"order_id"` // 订单ID
+		ProductId       string  `json:"product_id"` // 产品ID
+		ProductName     string  `json:"product_name"` // 产品名称
+		OrderAmount     float64 `json:"order_amount"` // 订单金额
+		SetPrice        float64 `json:"set_price"` // 设定价格
+		ActualBasePrice float64 `json:"actual_base_price"` // 实际底价
+		PriceCost       float64 `json:"price_cost"` // 提价成本
+		AgentProfit     float64 `json:"agent_profit"` // 代理收益
+		ProcessStatus   int64   `json:"process_status"` // 处理状态
+		CreateTime      string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentOrderListResp {
+		Total int64                `json:"total"` // 总数
+		Items []AgentOrderListItem `json:"items"` // 列表数据
+	}
+	// 代理佣金分页查询
+	AdminGetAgentCommissionListReq {
+		Page     int64   `form:"page"` // 页码
+		PageSize int64   `form:"pageSize"` // 每页数量
+		AgentId  *string `form:"agent_id,optional"` // 代理ID（可选）
+		OrderId  *string `form:"order_id,optional"` // 订单ID（可选）
+		Status   *int64  `form:"status,optional"` // 状态（可选）
+	}
+	AgentCommissionListItem {
+		Id          string  `json:"id"` // 主键
+		AgentId     string  `json:"agent_id"` // 代理ID
+		OrderId     string  `json:"order_id"` // 订单ID
+		ProductName string  `json:"product_name"` // 产品名称
+		Amount      float64 `json:"amount"` // 金额
+		Status      int64   `json:"status"` // 状态
+		CreateTime  string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentCommissionListResp {
+		Total int64                     `json:"total"` // 总数
+		Items []AgentCommissionListItem `json:"items"` // 列表数据
+	}
+	// 代理返佣分页查询
+	AdminGetAgentRebateListReq {
+		Page          int64   `form:"page"` // 页码
+		PageSize      int64   `form:"pageSize"` // 每页数量
+		AgentId       *string `form:"agent_id,optional"` // 代理ID（可选）
+		SourceAgentId *string `form:"source_agent_id,optional"` // 来源代理ID（可选）
+		RebateType    *int64  `form:"rebate_type,optional"` // 返佣类型（可选）
+	}
+	AgentRebateListItem {
+		Id            string  `json:"id"` // 主键
+		AgentId       string  `json:"agent_id"` // 获得返佣的代理ID
+		SourceAgentId string  `json:"source_agent_id"` // 来源代理ID
+		OrderId       string  `json:"order_id"` // 订单ID
+		RebateType    int64   `json:"rebate_type"` // 返佣类型
+		Amount        float64 `json:"amount"` // 金额
+		CreateTime    string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentRebateListResp {
+		Total int64                 `json:"total"` // 总数
+		Items []AgentRebateListItem `json:"items"` // 列表数据
+	}
+	// 代理升级记录分页查询
+	AdminGetAgentUpgradeListReq {
+		Page        int64   `form:"page"` // 页码
+		PageSize    int64   `form:"pageSize"` // 每页数量
+		AgentId     *string `form:"agent_id,optional"` // 代理ID（可选）
+		UpgradeType *int64  `form:"upgrade_type,optional"` // 升级类型（可选）
+		Status      *int64  `form:"status,optional"` // 状态（可选）
+	}
+	AgentUpgradeListItem {
+		Id           string  `json:"id"` // 主键
+		AgentId      string  `json:"agent_id"` // 代理ID
+		FromLevel    int64   `json:"from_level"` // 原等级
+		ToLevel      int64   `json:"to_level"` // 目标等级
+		UpgradeType  int64   `json:"upgrade_type"` // 升级类型
+		UpgradeFee   float64 `json:"upgrade_fee"` // 升级费用
+		RebateAmount float64 `json:"rebate_amount"` // 返佣金额
+		Status       int64   `json:"status"` // 状态
+		CreateTime   string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentUpgradeListResp {
+		Total int64                  `json:"total"` // 总数
+		Items []AgentUpgradeListItem `json:"items"` // 列表数据
+	}
+	// 代理提现分页查询
+	AdminGetAgentWithdrawalListReq {
+		Page       int64   `form:"page"` // 页码
+		PageSize   int64   `form:"pageSize"` // 每页数量
+		AgentId    *string `form:"agent_id,optional"` // 代理ID（可选）
+		Status     *int64  `form:"status,optional"` // 状态（可选）
+		WithdrawNo *string `form:"withdraw_no,optional"` // 提现单号（可选）
+	}
+	AgentWithdrawalListItem {
+		Id           string  `json:"id"` // 主键
+		AgentId      string  `json:"agent_id"` // 代理ID
+		WithdrawNo   string  `json:"withdraw_no"` // 提现单号
+		Amount       float64 `json:"amount"` // 金额
+		TaxAmount    float64 `json:"tax_amount"` // 税费金额
+		ActualAmount float64 `json:"actual_amount"` // 实际到账金额
+		Status       int64   `json:"status"` // 状态
+		PayeeAccount string  `json:"payee_account"` // 收款账户
+		PayeeName    string  `json:"payee_name"` // 收款人姓名
+		Remark       string  `json:"remark"` // 备注
+		CreateTime   string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentWithdrawalListResp {
+		Total int64                     `json:"total"` // 总数
+		Items []AgentWithdrawalListItem `json:"items"` // 列表数据
+	}
+	// 代理提现审核
+	AdminAuditWithdrawalReq {
+		WithdrawalId string `json:"withdrawal_id"` // 提现记录ID
+		Status       int64  `json:"status"` // 审核状态：2=通过，3=拒绝
+		Remark       string `json:"remark"` // 备注
+	}
+	AdminAuditWithdrawalResp {
+		Success bool `json:"success"`
+	}
+	// 代理实名认证分页查询
+	AdminGetAgentRealNameListReq {
+		Page     int64   `form:"page"` // 页码
+		PageSize int64   `form:"pageSize"` // 每页数量
+		AgentId  *string `form:"agent_id,optional"` // 代理ID（可选）
+		Status   *int64  `form:"status,optional"` // 状态（可选）：1=未验证，2=已通过
+	}
+	AgentRealNameListItem {
+		Id         string `json:"id"` // 主键
+		AgentId    string `json:"agent_id"` // 代理ID
+		Name       string `json:"name"` // 姓名
+		IdCard     string `json:"id_card"` // 身份证号
+		Mobile     string `json:"mobile"` // 手机号
+		Status     int64  `json:"status"` // 状态：1=未验证，2=已通过（verify_time不为空表示已通过）
+		VerifyTime string `json:"verify_time"` // 验证时间（三要素核验通过时间）
+		CreateTime string `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentRealNameListResp {
+		Total int64                   `json:"total"` // 总数
+		Items []AgentRealNameListItem `json:"items"` // 列表数据
+	}
+	// 代理实名认证审核
+	AdminAuditRealNameReq {
+		RealNameId  int64  `json:"real_name_id"` // 实名认证记录ID
+		Status      int64  `json:"status"` // 审核状态：2=通过，3=拒绝
+		AuditReason string `json:"audit_reason"` // 审核原因（拒绝时必填）
+	}
+	AdminAuditRealNameResp {
+		Success bool `json:"success"`
+	}
+	// 系统配置查询（价格配置已移除，改为产品配置表管理）
+	AdminGetAgentConfigResp {
+		LevelBonus             LevelBonusConfig         `json:"level_bonus"` // 等级加成配置
+		UpgradeFee             UpgradeFeeConfig         `json:"upgrade_fee"` // 升级费用配置
+		UpgradeRebate          UpgradeRebateConfig      `json:"upgrade_rebate"` // 升级返佣配置
+		DirectParentRebate     DirectParentRebateConfig `json:"direct_parent_rebate"` // 直接上级返佣配置
+		MaxGoldRebateAmount    float64                  `json:"max_gold_rebate_amount"` // 黄金代理最大返佣金额
+		CommissionFreeze       CommissionFreezeConfig   `json:"commission_freeze"` // 佣金冻结配置
+		TaxRate                float64                  `json:"tax_rate"` // 税率
+		TaxExemptionAmount     float64                  `json:"tax_exemption_amount"` // 免税额度
+		GoldMaxUpliftAmount    float64                  `json:"gold_max_uplift_amount"`
+		DiamondMaxUpliftAmount float64                  `json:"diamond_max_uplift_amount"`
+	}
+	LevelBonusConfig {
+		Diamond int64 `json:"diamond"` // 钻石加成：0
+		Gold    int64 `json:"gold"` // 黄金加成：3
+		Normal  int64 `json:"normal"` // 普通加成：6
+	}
+	UpgradeFeeConfig {
+		NormalToGold    float64 `json:"normal_to_gold"` // 普通→黄金：199
+		NormalToDiamond float64 `json:"normal_to_diamond"` // 普通→钻石：980
+	}
+	UpgradeRebateConfig {
+		NormalToGoldRebate float64 `json:"normal_to_gold_rebate"` // 普通→黄金返佣：139
+		ToDiamondRebate    float64 `json:"to_diamond_rebate"` // 升级为钻石返佣：680
+	}
+	DirectParentRebateConfig {
+		Diamond float64 `json:"diamond"` // 直接上级是钻石的返佣金额（6元）
+		Gold    float64 `json:"gold"` // 直接上级是黄金的返佣金额（3元）
+		Normal  float64 `json:"normal"` // 直接上级是普通的返佣金额（2元）
+	}
+	CommissionFreezeConfig {
+		Ratio     float64 `json:"ratio"` // 佣金冻结比例（例如：0.1表示10%）
+		Threshold float64 `json:"threshold"` // 佣金冻结阈值（订单单价达到此金额才触发冻结，单位：元）
+		Days      int64   `json:"days"` // 佣金冻结解冻天数（单位：天，例如：30表示30天后解冻）
+	}
+	// 系统配置更新（价格配置已移除，改为产品配置表管理）
+	AdminUpdateAgentConfigReq {
+		LevelBonus             *LevelBonusConfig         `json:"level_bonus,optional"` // 等级加成配置
+		UpgradeFee             *UpgradeFeeConfig         `json:"upgrade_fee,optional"` // 升级费用配置
+		UpgradeRebate          *UpgradeRebateConfig      `json:"upgrade_rebate,optional"` // 升级返佣配置
+		DirectParentRebate     *DirectParentRebateConfig `json:"direct_parent_rebate,optional"` // 直接上级返佣配置
+		MaxGoldRebateAmount    *float64                  `json:"max_gold_rebate_amount,optional"` // 黄金代理最大返佣金额
+		CommissionFreeze       *CommissionFreezeConfig   `json:"commission_freeze,optional"` // 佣金冻结配置
+		TaxRate                *float64                  `json:"tax_rate,optional"` // 税率
+		TaxExemptionAmount     *float64                  `json:"tax_exemption_amount,optional"` // 免税额度
+		GoldMaxUpliftAmount    *float64                  `json:"gold_max_uplift_amount,optional"`
+		DiamondMaxUpliftAmount *float64                  `json:"diamond_max_uplift_amount,optional"`
+	}
+	AdminUpdateAgentConfigResp {
+		Success bool `json:"success"`
+	}
+	// 产品配置分页查询
+	AdminGetAgentProductConfigListReq {
+		Page        int64   `form:"page"` // 页码
+		PageSize    int64   `form:"pageSize"` // 每页数量
+		ProductId   *string `form:"product_id,optional"` // 产品ID（可选）
+		ProductName *string `form:"product_name,optional"` // 产品名称（可选，用于搜索）
+	}
+	AgentProductConfigItem {
+		Id             string  `json:"id"` // 主键
+		ProductId      string  `json:"product_id"` // 产品ID
+		ProductName    string  `json:"product_name"` // 产品名称
+		BasePrice      float64 `json:"base_price"` // 基础底价
+		PriceRangeMin  float64 `json:"price_range_min"` // 最低定价
+		PriceRangeMax  float64 `json:"price_range_max"` // 最高定价
+		PriceThreshold float64 `json:"price_threshold"` // 提价标准阈值
+		PriceFeeRate   float64 `json:"price_fee_rate"` // 提价手续费比例
+		CreateTime     string  `json:"create_time"` // 创建时间
+	}
+	AdminGetAgentProductConfigListResp {
+		Total int64                    `json:"total"` // 总数
+		Items []AgentProductConfigItem `json:"items"` // 列表数据
+	}
+	// 产品配置更新
+	AdminUpdateAgentProductConfigReq {
+		Id             string   `json:"id"` // 主键
+		BasePrice      float64  `json:"base_price"` // 基础底价
+		PriceRangeMax  float64  `json:"price_range_max"` // 最高定价（对应数据库 system_max_price）
+		PriceThreshold *float64 `json:"price_threshold,optional"` // 提价标准阈值（可选）
+		PriceFeeRate   *float64 `json:"price_fee_rate,optional"` // 提价手续费比例（可选）
+	}
+	AdminUpdateAgentProductConfigResp {
+		Success bool `json:"success"`
+	}
+	// 生成钻石邀请码
+	AdminGenerateDiamondInviteCodeReq {
+		Count      int64  `json:"count"` // 生成数量
+		ExpireDays int64  `json:"expire_days,optional"` // 过期天数（可选，0表示不过期）
+		Remark     string `json:"remark,optional"` // 备注（可选）
+	}
+	AdminGenerateDiamondInviteCodeResp {
+		Codes []string `json:"codes"` // 生成的邀请码列表
+	}
+	// 邀请码列表查询
+	AdminGetInviteCodeListReq {
+		Page        int64   `form:"page"` // 页码
+		PageSize    int64   `form:"pageSize"` // 每页数量
+		Code        *string `form:"code,optional"` // 邀请码（可选）
+		AgentId     *string `form:"agent_id,optional"` // 发放代理ID（可选，NULL表示平台发放）
+		TargetLevel *int64  `form:"target_level,optional"` // 目标等级（可选）
+		Status      *int64  `form:"status,optional"` // 状态（可选）
+	}
+	InviteCodeListItem {
+		Id          string `json:"id"` // 主键
+		Code        string `json:"code"` // 邀请码
+		AgentId     string `json:"agent_id"` // 发放代理ID（0表示平台发放）
+		AgentMobile string `json:"agent_mobile"` // 发放代理手机号
+		TargetLevel int64  `json:"target_level"` // 目标等级
+		Status      int64  `json:"status"` // 状态：0=未使用，1=已使用，2=已失效
+		UsedUserId  string `json:"used_user_id"` // 使用用户ID
+		UsedAgentId string `json:"used_agent_id"` // 使用代理ID
+		UsedTime    string `json:"used_time"` // 使用时间
+		ExpireTime  string `json:"expire_time"` // 过期时间
+		Remark      string `json:"remark"` // 备注
+		CreateTime  string `json:"create_time"` // 创建时间
+	}
+	AdminGetInviteCodeListResp {
+		Total int64                `json:"total"` // 总数
+		Items []InviteCodeListItem `json:"items"` // 列表数据
+	}
+)
+

app/main/api/desc/admin/admin_api.api

@@ -0,0 +1,131 @@
+syntax = "v1"
+
+info(
+    title: "Admin API管理"
+    desc: "管理员API管理接口"
+    author: "team"
+    version: "v1"
+)
+
+type (
+    // API列表请求
+    AdminGetApiListReq {
+        Page     int64  `form:"page,default=1"`
+        PageSize int64  `form:"page_size,default=20"`
+        ApiName  string `form:"api_name,optional"`
+        Method   string `form:"method,optional"`
+        Status   int64  `form:"status,optional"`
+    }
+
+    // API列表响应
+    AdminGetApiListResp {
+        Items  []AdminApiInfo `json:"items"`
+        Total int64          `json:"total"`
+    }
+
+    // API信息
+    AdminApiInfo {
+        Id          string `json:"id"`
+        ApiName     string `json:"api_name"`
+        ApiCode     string `json:"api_code"`
+        Method      string `json:"method"`
+        Url         string `json:"url"`
+        Status      int64  `json:"status"`
+        Description string `json:"description"`
+        CreateTime  string `json:"create_time"`
+        UpdateTime  string `json:"update_time"`
+    }
+
+    // API详情请求
+    AdminGetApiDetailReq {
+        Id string `path:"id"`
+    }
+
+    // API详情响应
+    AdminGetApiDetailResp {
+        AdminApiInfo
+    }
+
+    // 创建API请求
+    AdminCreateApiReq {
+        ApiName     string `json:"api_name"`
+        ApiCode     string `json:"api_code"`
+        Method      string `json:"method"`
+        Url         string `json:"url"`
+        Status      int64  `json:"status,default=1"`
+        Description string `json:"description,optional"`
+    }
+
+    // 创建API响应
+    AdminCreateApiResp {
+        Id string `json:"id"`
+    }
+
+    // 更新API请求
+    AdminUpdateApiReq {
+        Id          string `path:"id"`
+        ApiName     string `json:"api_name"`
+        ApiCode     string `json:"api_code"`
+        Method      string `json:"method"`
+        Url         string `json:"url"`
+        Status      int64  `json:"status"`
+        Description string `json:"description,optional"`
+    }
+
+    // 更新API响应
+    AdminUpdateApiResp {
+        Success bool `json:"success"`
+    }
+
+    // 删除API请求
+    AdminDeleteApiReq {
+        Id string `path:"id"`
+    }
+
+    // 删除API响应
+    AdminDeleteApiResp {
+        Success bool `json:"success"`
+    }
+
+    // 批量更新API状态请求
+    AdminBatchUpdateApiStatusReq {
+        Ids    []string `json:"ids"`
+        Status int64   `json:"status"`
+    }
+
+    // 批量更新API状态响应
+    AdminBatchUpdateApiStatusResp {
+        Success bool `json:"success"`
+    }
+)
+
+@server (
+    prefix: api/v1
+    group:  admin_api
+    middleware: AdminAuthInterceptor
+)
+service main {
+    // 获取API列表
+    @handler AdminGetApiList
+    get /admin/api/list (AdminGetApiListReq) returns (AdminGetApiListResp)
+
+    // 获取API详情
+    @handler AdminGetApiDetail
+    get /admin/api/detail/:id (AdminGetApiDetailReq) returns (AdminGetApiDetailResp)
+
+    // 创建API
+    @handler AdminCreateApi
+    post /admin/api/create (AdminCreateApiReq) returns (AdminCreateApiResp)
+
+    // 更新API
+    @handler AdminUpdateApi
+    put /admin/api/update/:id (AdminUpdateApiReq) returns (AdminUpdateApiResp)
+
+    // 删除API
+    @handler AdminDeleteApi
+    delete /admin/api/delete/:id (AdminDeleteApiReq) returns (AdminDeleteApiResp)
+
+    // 批量更新API状态
+    @handler AdminBatchUpdateApiStatus
+    put /admin/api/batch-update-status (AdminBatchUpdateApiStatusReq) returns (AdminBatchUpdateApiStatusResp)
+}

app/main/api/desc/admin/admin_feature.api

@@ -0,0 +1,128 @@
+syntax = "v1"
+
+info (
+	title:   "后台功能管理服务"
+	desc:    "后台功能管理相关接口"
+	version: "v1"
+)
+
+// 功能管理接口
+@server (
+	prefix: /api/v1/admin/feature
+	group:  admin_feature
+	middleware: AdminAuthInterceptor
+)
+service main {
+	// 创建功能
+	@handler AdminCreateFeature
+	post /create (AdminCreateFeatureReq) returns (AdminCreateFeatureResp)
+
+	// 更新功能
+	@handler AdminUpdateFeature
+	put /update/:id (AdminUpdateFeatureReq) returns (AdminUpdateFeatureResp)
+
+	// 删除功能
+	@handler AdminDeleteFeature
+	delete /delete/:id (AdminDeleteFeatureReq) returns (AdminDeleteFeatureResp)
+
+	// 获取功能列表
+	@handler AdminGetFeatureList
+	get /list (AdminGetFeatureListReq) returns (AdminGetFeatureListResp)
+
+	// 获取功能详情
+	@handler AdminGetFeatureDetail
+	get /detail/:id (AdminGetFeatureDetailReq) returns (AdminGetFeatureDetailResp)
+
+	// 配置功能示例数据
+	@handler AdminConfigFeatureExample
+	post /config-example (AdminConfigFeatureExampleReq) returns (AdminConfigFeatureExampleResp)
+
+	// 查看功能示例数据
+	@handler AdminGetFeatureExample
+	get /example/:feature_id (AdminGetFeatureExampleReq) returns (AdminGetFeatureExampleResp)
+}
+
+type (
+	// 创建功能请求
+	AdminCreateFeatureReq {
+		ApiId string `json:"api_id"` // API标识
+		Name  string `json:"name"` // 描述
+	}
+	// 创建功能响应
+    AdminCreateFeatureResp {
+        Id string `json:"id"` // 功能ID
+    }
+	// 更新功能请求
+    AdminUpdateFeatureReq {
+        Id    string  `path:"id"` // 功能ID
+        ApiId *string `json:"api_id,optional"` // API标识
+        Name  *string `json:"name,optional"` // 描述
+    }
+	// 更新功能响应
+	AdminUpdateFeatureResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 删除功能请求
+    AdminDeleteFeatureReq {
+        Id string `path:"id"` // 功能ID
+    }
+	// 删除功能响应
+	AdminDeleteFeatureResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 获取功能列表请求
+	AdminGetFeatureListReq {
+		Page     int64   `form:"page"` // 页码
+		PageSize int64   `form:"pageSize"` // 每页数量
+		ApiId    *string `form:"api_id,optional"` // API标识
+		Name     *string `form:"name,optional"` // 描述
+	}
+	// 功能列表项
+    FeatureListItem {
+        Id         string `json:"id"` // 功能ID
+        ApiId      string `json:"api_id"` // API标识
+		Name       string `json:"name"` // 描述
+		CreateTime string `json:"create_time"` // 创建时间
+		UpdateTime string `json:"update_time"` // 更新时间
+	}
+	// 获取功能列表响应
+	AdminGetFeatureListResp {
+		Total int64             `json:"total"` // 总数
+		Items []FeatureListItem `json:"items"` // 列表数据
+	}
+	// 获取功能详情请求
+    AdminGetFeatureDetailReq {
+        Id string `path:"id"` // 功能ID
+    }
+	// 获取功能详情响应
+    AdminGetFeatureDetailResp {
+        Id         string `json:"id"` // 功能ID
+        ApiId      string `json:"api_id"` // API标识
+		Name       string `json:"name"` // 描述
+		CreateTime string `json:"create_time"` // 创建时间
+		UpdateTime string `json:"update_time"` // 更新时间
+	}
+	// 配置功能示例数据请求
+    AdminConfigFeatureExampleReq {
+        FeatureId string `json:"feature_id"` // 功能ID
+        Data      string `json:"data"` // 示例数据JSON
+    }
+	// 配置功能示例数据响应
+	AdminConfigFeatureExampleResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 查看功能示例数据请求
+    AdminGetFeatureExampleReq {
+        FeatureId string `path:"feature_id"` // 功能ID
+    }
+	// 查看功能示例数据响应
+    AdminGetFeatureExampleResp {
+        Id         string `json:"id"` // 示例数据ID
+        FeatureId  string `json:"feature_id"` // 功能ID
+        ApiId      string `json:"api_id"` // API标识
+        Data       string `json:"data"` // 示例数据JSON
+        CreateTime string `json:"create_time"` // 创建时间
+        UpdateTime string `json:"update_time"` // 更新时间
+    }
+)
+

app/main/api/desc/admin/admin_product.api

@@ -0,0 +1,174 @@
+syntax = "v1"
+
+info (
+	title:   "后台产品管理服务"
+	desc:    "后台产品管理相关接口"
+	version: "v1"
+)
+
+// 产品管理接口
+@server(
+	prefix: /api/v1/admin/product
+	group: admin_product
+	middleware: AdminAuthInterceptor
+)
+service main {
+	// 创建产品
+	@handler AdminCreateProduct
+	post /create (AdminCreateProductReq) returns (AdminCreateProductResp)
+
+	// 更新产品
+	@handler AdminUpdateProduct
+	put /update/:id (AdminUpdateProductReq) returns (AdminUpdateProductResp)
+
+	// 删除产品
+	@handler AdminDeleteProduct
+	delete /delete/:id (AdminDeleteProductReq) returns (AdminDeleteProductResp)
+
+	// 获取产品列表
+	@handler AdminGetProductList
+	get /list (AdminGetProductListReq) returns (AdminGetProductListResp)
+
+	// 获取产品详情
+	@handler AdminGetProductDetail
+	get /detail/:id (AdminGetProductDetailReq) returns (AdminGetProductDetailResp)
+
+	// 获取产品功能列表
+	@handler AdminGetProductFeatureList
+	get /feature/list/:product_id (AdminGetProductFeatureListReq) returns ([]AdminGetProductFeatureListResp)
+
+	// 更新产品功能关联（批量）
+	@handler AdminUpdateProductFeatures
+	put /feature/update/:product_id (AdminUpdateProductFeaturesReq) returns (AdminUpdateProductFeaturesResp)
+}
+
+type (
+	// 创建产品请求
+	AdminCreateProductReq {
+		ProductName string  `json:"product_name"`   // 服务名
+		ProductEn   string  `json:"product_en"`     // 英文名
+		Description string  `json:"description"`    // 描述
+		Notes       string  `json:"notes,optional"` // 备注
+		CostPrice   float64 `json:"cost_price"`     // 成本
+		SellPrice   float64 `json:"sell_price"`     // 售价
+	}
+
+	// 创建产品响应
+    AdminCreateProductResp {
+        Id string `json:"id"` // 产品ID
+    }
+
+	// 更新产品请求
+    AdminUpdateProductReq {
+        Id          string   `path:"id"`                    // 产品ID
+        ProductName *string  `json:"product_name,optional"` // 服务名
+		ProductEn   *string  `json:"product_en,optional"`   // 英文名
+		Description *string  `json:"description,optional"`  // 描述
+		Notes       *string  `json:"notes,optional"`        // 备注
+		CostPrice   *float64 `json:"cost_price,optional"`   // 成本
+		SellPrice   *float64 `json:"sell_price,optional"`   // 售价
+	}
+
+	// 更新产品响应
+	AdminUpdateProductResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 删除产品请求
+    AdminDeleteProductReq {
+        Id string `path:"id"` // 产品ID
+    }
+
+	// 删除产品响应
+	AdminDeleteProductResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 获取产品列表请求
+	AdminGetProductListReq {
+		Page        int64   `form:"page"`                  // 页码
+		PageSize    int64   `form:"pageSize"`              // 每页数量
+		ProductName *string `form:"product_name,optional"` // 服务名
+		ProductEn   *string `form:"product_en,optional"`   // 英文名
+	}
+
+	// 产品列表项
+    ProductListItem {
+        Id          string  `json:"id"`           // 产品ID
+        ProductName string  `json:"product_name"` // 服务名
+		ProductEn   string  `json:"product_en"`   // 英文名
+		Description string  `json:"description"`  // 描述
+		Notes       string  `json:"notes"`        // 备注
+		CostPrice   float64 `json:"cost_price"`   // 成本
+		SellPrice   float64 `json:"sell_price"`   // 售价
+		CreateTime  string  `json:"create_time"`  // 创建时间
+		UpdateTime  string  `json:"update_time"`  // 更新时间
+	}
+
+	// 获取产品列表响应
+	AdminGetProductListResp {
+		Total int64             `json:"total"` // 总数
+		Items []ProductListItem `json:"items"` // 列表数据
+	}
+
+	// 获取产品详情请求
+    AdminGetProductDetailReq {
+        Id string `path:"id"` // 产品ID
+    }
+
+	// 获取产品详情响应
+    AdminGetProductDetailResp {
+        Id          string  `json:"id"`           // 产品ID
+        ProductName string  `json:"product_name"` // 服务名
+		ProductEn   string  `json:"product_en"`   // 英文名
+		Description string  `json:"description"`  // 描述
+		Notes       string  `json:"notes"`        // 备注
+		CostPrice   float64 `json:"cost_price"`   // 成本
+		SellPrice   float64 `json:"sell_price"`   // 售价
+		CreateTime  string  `json:"create_time"`  // 创建时间
+		UpdateTime  string  `json:"update_time"`  // 更新时间
+	}
+
+	// 获取产品功能列表请求
+    AdminGetProductFeatureListReq {
+        ProductId string `path:"product_id"` // 产品ID
+    }
+
+	// 获取产品功能列表响应Item
+    AdminGetProductFeatureListResp {
+        Id          string `json:"id"`           // 关联ID
+        ProductId   string `json:"product_id"`   // 产品ID
+        FeatureId   string `json:"feature_id"`   // 功能ID
+        ApiId       string `json:"api_id"`       // API标识
+        Name        string `json:"name"`         // 功能描述
+        Sort        int64  `json:"sort"`         // 排序
+        Enable      int64  `json:"enable"`       // 是否启用
+        IsImportant int64  `json:"is_important"` // 是否重要
+        CreateTime  string `json:"create_time"`  // 创建时间
+        UpdateTime  string `json:"update_time"`  // 更新时间
+    }
+
+	// // 获取产品功能列表响应
+	// AdminGetProductFeatureListResp {
+	// 	Items []ProductFeatureListItem `json:"items"` // 列表数据
+	// }
+
+	// 产品功能关联项
+    ProductFeatureItem {
+        FeatureId   string `json:"feature_id"`   // 功能ID
+        Sort        int64 `json:"sort"`         // 排序
+        Enable      int64 `json:"enable"`       // 是否启用
+        IsImportant int64 `json:"is_important"` // 是否重要
+    }
+
+	// 更新产品功能关联请求（批量）
+    AdminUpdateProductFeaturesReq {
+        ProductId string               `path:"product_id"` // 产品ID
+        Features  []ProductFeatureItem `json:"features"`   // 功能列表
+    }
+
+	// 更新产品功能关联响应
+	AdminUpdateProductFeaturesResp {
+		Success bool `json:"success"` // 是否成功
+	}
+)

app/main/api/desc/admin/admin_query.api

@@ -0,0 +1,133 @@
+syntax = "v1"
+
+info (
+	title:   "查询服务"
+	desc:    "查询服务"
+	version: "v1"
+)
+
+@server (
+	prefix: api/v1/admin/query
+	group:  admin_query
+	middleware: AdminAuthInterceptor
+)
+service main {
+	@doc "获取查询详情"
+	@handler AdminGetQueryDetailByOrderId
+	get /detail/:order_id (AdminGetQueryDetailByOrderIdReq) returns (AdminGetQueryDetailByOrderIdResp)
+
+	@doc "获取清理日志列表"
+	@handler AdminGetQueryCleanupLogList
+	get /cleanup/logs (AdminGetQueryCleanupLogListReq) returns (AdminGetQueryCleanupLogListResp)
+
+	@doc "获取清理详情列表"
+	@handler AdminGetQueryCleanupDetailList
+	get /cleanup/details/:log_id (AdminGetQueryCleanupDetailListReq) returns (AdminGetQueryCleanupDetailListResp)
+
+	@doc "获取清理配置列表"
+	@handler AdminGetQueryCleanupConfigList
+	get /cleanup/configs (AdminGetQueryCleanupConfigListReq) returns (AdminGetQueryCleanupConfigListResp)
+
+	@doc "更新清理配置"
+	@handler AdminUpdateQueryCleanupConfig
+	put /cleanup/config (AdminUpdateQueryCleanupConfigReq) returns (AdminUpdateQueryCleanupConfigResp)
+}
+
+ type AdminGetQueryDetailByOrderIdReq {
+     OrderId string `path:"order_id"`
+}
+
+ type AdminGetQueryDetailByOrderIdResp {
+     Id          string                 `json:"id"`           // 主键ID
+     OrderId     string                 `json:"order_id"`     // 订单ID
+     UserId      string                 `json:"user_id"`      // 用户ID
+	ProductName string                 `json:"product_name"` // 产品ID
+	QueryParams map[string]interface{} `json:"query_params"`
+	QueryData   []AdminQueryItem       `json:"query_data"`
+	CreateTime  string                 `json:"create_time"` // 创建时间
+	UpdateTime  string                 `json:"update_time"` // 更新时间
+	QueryState  string                 `json:"query_state"` // 查询状态
+}
+
+type AdminQueryItem {
+	Feature interface{} `json:"feature"`
+	Data    interface{} `json:"data"` // 这里可以是 map 或 具体的 struct
+}
+
+// 清理日志相关请求响应定义
+type AdminGetQueryCleanupLogListReq {
+	Page      int64  `form:"page,default=1"`       // 页码
+	PageSize  int64  `form:"page_size,default=20"` // 每页数量
+	Status    int64  `form:"status,optional"`      // 状态：1-成功，2-失败
+	StartTime string `form:"start_time,optional"`  // 开始时间
+	EndTime   string `form:"end_time,optional"`    // 结束时间
+}
+
+type AdminGetQueryCleanupLogListResp {
+	Total int64                 `json:"total"` // 总数
+	Items []QueryCleanupLogItem `json:"items"` // 列表
+}
+
+ type QueryCleanupLogItem {
+     Id            string `json:"id"`             // 主键ID
+	CleanupTime   string `json:"cleanup_time"`   // 清理时间
+	CleanupBefore string `json:"cleanup_before"` // 清理截止时间
+	Status        int64  `json:"status"`         // 状态：1-成功，2-失败
+	AffectedRows  int64  `json:"affected_rows"`  // 影响行数
+	ErrorMsg      string `json:"error_msg"`      // 错误信息
+	Remark        string `json:"remark"`         // 备注
+	CreateTime    string `json:"create_time"`    // 创建时间
+}
+
+// 清理详情相关请求响应定义
+ type AdminGetQueryCleanupDetailListReq {
+     LogId    string `path:"log_id"`               // 清理日志ID
+	Page     int64 `form:"page,default=1"`       // 页码
+	PageSize int64 `form:"page_size,default=20"` // 每页数量
+}
+
+type AdminGetQueryCleanupDetailListResp {
+	Total int64                    `json:"total"` // 总数
+	Items []QueryCleanupDetailItem `json:"items"` // 列表
+}
+
+ type QueryCleanupDetailItem {
+     Id            string `json:"id"`              // 主键ID
+     CleanupLogId  string `json:"cleanup_log_id"`  // 清理日志ID
+     QueryId       string `json:"query_id"`        // 查询ID
+     OrderId       string `json:"order_id"`        // 订单ID
+     UserId        string `json:"user_id"`         // 用户ID
+	ProductName   string `json:"product_name"`    // 产品名称
+	QueryState    string `json:"query_state"`     // 查询状态
+	CreateTimeOld string `json:"create_time_old"` // 原创建时间
+	CreateTime    string `json:"create_time"`     // 创建时间
+}
+
+// 清理配置相关请求响应定义
+type AdminGetQueryCleanupConfigListReq {
+	Status int64 `form:"status,optional"` // 状态：1-启用，0-禁用
+}
+
+type AdminGetQueryCleanupConfigListResp {
+	Items []QueryCleanupConfigItem `json:"items"` // 配置列表
+}
+
+ type QueryCleanupConfigItem {
+     Id          string `json:"id"`           // 主键ID
+	ConfigKey   string `json:"config_key"`   // 配置键
+	ConfigValue string `json:"config_value"` // 配置值
+	ConfigDesc  string `json:"config_desc"`  // 配置描述
+	Status      int64  `json:"status"`       // 状态：1-启用，0-禁用
+	CreateTime  string `json:"create_time"`  // 创建时间
+	UpdateTime  string `json:"update_time"`  // 更新时间
+}
+
+ type AdminUpdateQueryCleanupConfigReq {
+     Id          string `json:"id"`           // 主键ID
+	ConfigValue string `json:"config_value"` // 配置值
+	Status      int64  `json:"status"`       // 状态：1-启用，0-禁用
+}
+
+type AdminUpdateQueryCleanupConfigResp {
+	Success bool `json:"success"` // 是否成功
+}

app/main/api/desc/admin/admin_role_api.api

@@ -0,0 +1,103 @@
+syntax = "v1"
+
+info(
+    title: "Admin 角色API权限管理"
+    desc: "管理员角色API权限管理接口"
+    author: "team"
+    version: "v1"
+)
+
+type (
+    // 获取角色API权限列表请求
+    AdminGetRoleApiListReq {
+        RoleId string `path:"role_id"`
+    }
+
+    // 获取角色API权限列表响应
+    AdminGetRoleApiListResp {
+        Items []AdminRoleApiInfo `json:"items"`
+    }
+
+    // 角色API权限信息
+    AdminRoleApiInfo {
+        Id          string `json:"id"`
+        RoleId      string `json:"role_id"`
+        ApiId       string `json:"api_id"`
+        ApiName     string `json:"api_name"`
+        ApiCode     string `json:"api_code"`
+        Method      string `json:"method"`
+        Url         string `json:"url"`
+        Status      int64  `json:"status"`
+        Description string `json:"description"`
+    }
+
+    // 分配角色API权限请求
+    AdminAssignRoleApiReq {
+        RoleId string   `json:"role_id"`
+        ApiIds []string `json:"api_ids"`
+    }
+
+    // 分配角色API权限响应
+    AdminAssignRoleApiResp {
+        Success bool `json:"success"`
+    }
+
+    // 移除角色API权限请求
+    AdminRemoveRoleApiReq {
+        RoleId string   `json:"role_id"`
+        ApiIds []string `json:"api_ids"`
+    }
+
+    // 移除角色API权限响应
+    AdminRemoveRoleApiResp {
+        Success bool `json:"success"`
+    }
+
+    // 更新角色API权限请求
+    AdminUpdateRoleApiReq {
+        RoleId string   `json:"role_id"`
+        ApiIds []string `json:"api_ids"`
+    }
+
+    // 更新角色API权限响应
+    AdminUpdateRoleApiResp {
+        Success bool `json:"success"`
+    }
+
+    // 获取所有API列表（用于权限分配）
+    AdminGetAllApiListReq {
+        Status int64 `form:"status,optional,default=1"`
+    }
+
+    // 获取所有API列表响应
+    AdminGetAllApiListResp {
+        Items []AdminRoleApiInfo `json:"items"`
+    }
+)
+
+@server (
+    prefix: api/v1
+    group:  admin_role_api
+    middleware: AdminAuthInterceptor
+)
+service main {
+    // 获取角色API权限列表
+    @handler AdminGetRoleApiList
+    get /admin/role/:role_id/api/list (AdminGetRoleApiListReq) returns (AdminGetRoleApiListResp)
+
+    // 分配角色API权限
+    @handler AdminAssignRoleApi
+    post /admin/role/api/assign (AdminAssignRoleApiReq) returns (AdminAssignRoleApiResp)
+
+    // 移除角色API权限
+    @handler AdminRemoveRoleApi
+    post /admin/role/api/remove (AdminRemoveRoleApiReq) returns (AdminRemoveRoleApiResp)
+
+    // 更新角色API权限
+    @handler AdminUpdateRoleApi
+    put /admin/role/api/update (AdminUpdateRoleApiReq) returns (AdminUpdateRoleApiResp)
+
+    // 获取所有API列表（用于权限分配）
+    @handler AdminGetAllApiList
+    get /admin/api/all (AdminGetAllApiListReq) returns (AdminGetAllApiListResp)
+}

app/main/api/desc/admin/admin_user.api

@@ -0,0 +1,144 @@
+syntax = "v1"
+
+info (
+	title:   "后台用户中心服务"
+	desc:    "后台用户中心服务"
+	version: "v1"
+)
+
+@server (
+	prefix: api/v1/admin/user
+	group:  admin_user
+	middleware: AdminAuthInterceptor
+)
+service main {
+	@doc "获取用户列表"
+	@handler AdminGetUserList
+	get /list (AdminGetUserListReq) returns (AdminGetUserListResp)
+
+	@doc "获取用户详情"
+	@handler AdminGetUserDetail
+	get /detail/:id (AdminGetUserDetailReq) returns (AdminGetUserDetailResp)
+
+	@doc "创建用户"
+	@handler AdminCreateUser
+	post /create (AdminCreateUserReq) returns (AdminCreateUserResp)
+
+	@doc "更新用户"
+	@handler AdminUpdateUser
+	put /update/:id (AdminUpdateUserReq) returns (AdminUpdateUserResp)
+
+	@doc "删除用户"
+	@handler AdminDeleteUser
+	delete /delete/:id (AdminDeleteUserReq) returns (AdminDeleteUserResp)
+
+	@doc "用户信息"
+	@handler AdminUserInfo
+	get /info (AdminUserInfoReq) returns (AdminUserInfoResp)
+
+	@doc "重置管理员密码"
+	@handler AdminResetPassword
+	put /reset-password/:id (AdminResetPasswordReq) returns (AdminResetPasswordResp)
+}
+
+type (
+	// 列表请求
+	AdminGetUserListReq {
+		Page     int64  `form:"page,default=1"`             // 页码
+		PageSize int64  `form:"pageSize,default=20"`        // 每页数量
+		Username string `form:"username,optional"`          // 用户名
+		RealName string `form:"real_name,optional"`         // 真实姓名
+		Status   int64  `form:"status,optional,default=-1"` // 状态：0-禁用，1-启用
+	}
+
+	// 列表响应
+	AdminGetUserListResp {
+		Total int64               `json:"total"` // 总数
+		Items []AdminUserListItem `json:"items"` // 列表
+	}
+
+	// 列表项
+    AdminUserListItem {
+        Id         string  `json:"id"`          // 用户ID
+        Username   string  `json:"username"`    // 用户名
+        RealName   string  `json:"real_name"`   // 真实姓名
+        Status     int64   `json:"status"`      // 状态：0-禁用，1-启用
+        CreateTime string  `json:"create_time"` // 创建时间
+        RoleIds    []string `json:"role_ids"`    // 关联的角色ID列表
+    }
+
+	// 详情请求
+    AdminGetUserDetailReq {
+        Id string `path:"id"` // 用户ID
+    }
+
+	// 详情响应
+    AdminGetUserDetailResp {
+        Id         string  `json:"id"`          // 用户ID
+        Username   string  `json:"username"`    // 用户名
+        RealName   string  `json:"real_name"`   // 真实姓名
+        Status     int64   `json:"status"`      // 状态：0-禁用，1-启用
+        CreateTime string  `json:"create_time"` // 创建时间
+        UpdateTime string  `json:"update_time"` // 更新时间
+        RoleIds    []string `json:"role_ids"`    // 关联的角色ID列表
+    }
+
+	// 创建请求
+    AdminCreateUserReq {
+        Username string  `json:"username"`         // 用户名
+        RealName string  `json:"real_name"`        // 真实姓名
+        Status   int64   `json:"status,default=1"` // 状态：0-禁用，1-启用
+        RoleIds  []string `json:"role_ids"`         // 关联的角色ID列表
+    }
+
+	// 创建响应
+    AdminCreateUserResp {
+        Id string `json:"id"` // 用户ID
+    }
+
+	// 更新请求
+    AdminUpdateUserReq {
+        Id       string  `path:"id"`                 // 用户ID
+        Username *string `json:"username,optional"`  // 用户名
+        RealName *string `json:"real_name,optional"` // 真实姓名
+        Status   *int64  `json:"status,optional"`    // 状态：0-禁用，1-启用
+        RoleIds  []string `json:"role_ids,optional"`  // 关联的角色ID列表
+    }
+
+	// 更新响应
+	AdminUpdateUserResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 删除请求
+    AdminDeleteUserReq {
+        Id string `path:"id"` // 用户ID
+    }
+
+	// 删除响应
+	AdminDeleteUserResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 用户信息请求
+	AdminUserInfoReq {
+	}
+
+	// 用户信息响应
+	AdminUserInfoResp {
+		Username string   `json:"username"`  // 用户名
+		RealName string   `json:"real_name"` // 真实姓名
+		Roles    []string `json:"roles"`     // 角色编码列表
+	}
+
+	// 重置密码请求
+    AdminResetPasswordReq {
+        Id       string `path:"id"`         // 用户ID
+        Password string `json:"password"`   // 新密码
+    }
+
+	// 重置密码响应
+	AdminResetPasswordResp {
+		Success bool `json:"success"` // 是否成功
+	}
+)

app/main/api/desc/admin/auth.api

@@ -0,0 +1,32 @@
+syntax = "v1"
+
+info (
+	title:   "认证中心服务"
+	desc:    "认证中心服务"
+	version: "v1"
+)
+
+@server (
+	prefix: api/v1/admin/auth
+	group:  admin_auth
+)
+service main {
+	@doc "登录"
+	@handler AdminLogin
+	post /login (AdminLoginReq) returns (AdminLoginResp)
+
+}
+
+type (
+	AdminLoginReq {
+		Username string `json:"username" validate:"required"`
+		Password string `json:"password" validate:"required"`
+		Captcha  bool   `json:"captcha" validate:"required"`
+	}
+	AdminLoginResp {
+		AccessToken  string   `json:"access_token"`
+		AccessExpire int64    `json:"access_expire"`
+		RefreshAfter int64    `json:"refresh_after"`
+		Roles        []string `json:"roles"`
+	}
+)

app/main/api/desc/admin/menu.api

@@ -0,0 +1,136 @@
+syntax = "v1"
+
+info (
+	title:   "菜单中心服务"
+	desc:    "菜单中心服务"
+	version: "v1"
+)
+
+@server (
+	prefix:     api/v1/admin/menu
+	group:      admin_menu
+	middleware: AdminAuthInterceptor
+)
+service main {
+	@doc "获取菜单列表"
+	@handler GetMenuList
+	get /list (GetMenuListReq) returns ([]MenuListItem)
+
+	@doc "获取菜单详情"
+	@handler GetMenuDetail
+	get /detail/:id (GetMenuDetailReq) returns (GetMenuDetailResp)
+
+	@doc "创建菜单"
+	@handler CreateMenu
+	post /create (CreateMenuReq) returns (CreateMenuResp)
+
+	@doc "更新菜单"
+	@handler UpdateMenu
+	put /update/:id (UpdateMenuReq) returns (UpdateMenuResp)
+
+	@doc "删除菜单"
+	@handler DeleteMenu
+	delete /delete/:id (DeleteMenuReq) returns (DeleteMenuResp)
+
+	@doc "获取所有菜单(树形结构)"
+	@handler GetMenuAll
+	get /all (GetMenuAllReq) returns ([]GetMenuAllResp)
+}
+
+type (
+	// 列表请求
+	GetMenuListReq {
+		Name   string `form:"name,optional"` // 菜单名称
+		Path   string `form:"path,optional"` // 路由路径
+		Status int64  `form:"status,optional,default=-1"` // 状态：0-禁用，1-启用
+		Type   string `form:"type,optional"` // 类型
+	}
+	// 列表项
+	MenuListItem {
+		Id         string                 `json:"id"` // 菜单ID
+		Pid        string                 `json:"pid"` // 父菜单ID
+		Name       string                 `json:"name"` // 路由名称
+		Path       string                 `json:"path"` // 路由路径
+		Component  string                 `json:"component"` // 组件路径
+		Redirect   string                 `json:"redirect"` // 重定向路径
+		Meta       map[string]interface{} `json:"meta"` // 路由元数据
+		Status     int64                  `json:"status"` // 状态：0-禁用，1-启用
+		Type       string                 `json:"type"` // 类型
+		Sort       int64                  `json:"sort"` // 排序
+		CreateTime string                 `json:"createTime"` // 创建时间
+		Children   []MenuListItem         `json:"children"` // 子菜单
+	}
+	// 详情请求
+	GetMenuDetailReq {
+		Id string `path:"id"` // 菜单ID
+	}
+	// 详情响应
+	GetMenuDetailResp {
+		Id         string                 `json:"id"` // 菜单ID
+		Pid        string                 `json:"pid"` // 父菜单ID
+		Name       string                 `json:"name"` // 路由名称
+		Path       string                 `json:"path"` // 路由路径
+		Component  string                 `json:"component"` // 组件路径
+		Redirect   string                 `json:"redirect"` // 重定向路径
+		Meta       map[string]interface{} `json:"meta"` // 路由元数据
+		Status     int64                  `json:"status"` // 状态：0-禁用，1-启用
+		Type       string                 `json:"type"` // 类型
+		Sort       int64                  `json:"sort"` // 排序
+		CreateTime string                 `json:"createTime"` // 创建时间
+		UpdateTime string                 `json:"updateTime"` // 更新时间
+	}
+	// 创建请求
+	CreateMenuReq {
+		Pid       string                 `json:"pid,optional"` // 父菜单ID
+		Name      string                 `json:"name"` // 路由名称
+		Path      string                 `json:"path,optional"` // 路由路径
+		Component string                 `json:"component,optional"` // 组件路径
+		Redirect  string                 `json:"redirect,optional"` // 重定向路径
+		Meta      map[string]interface{} `json:"meta"` // 路由元数据
+		Status    int64                  `json:"status,optional,default=1"` // 状态：0-禁用，1-启用
+		Type      string                 `json:"type"` // 类型
+		Sort      int64                  `json:"sort,optional"` // 排序
+	}
+	// 创建响应
+	CreateMenuResp {
+		Id string `json:"id"` // 菜单ID
+	}
+	// 更新请求
+	UpdateMenuReq {
+		Id        string                 `path:"id"` // 菜单ID
+		Pid       *string                `json:"pid,optional"` // 父菜单ID
+		Name      string                 `json:"name"` // 路由名称
+		Path      string                 `json:"path,optional"` // 路由路径
+		Component string                 `json:"component,optional"` // 组件路径
+		Redirect  string                 `json:"redirect,optional"` // 重定向路径
+		Meta      map[string]interface{} `json:"meta"` // 路由元数据
+		Status    int64                  `json:"status,optional"` // 状态：0-禁用，1-启用
+		Type      string                 `json:"type"` // 类型
+		Sort      int64                  `json:"sort,optional"` // 排序
+	}
+	// 更新响应
+	UpdateMenuResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 删除请求
+	DeleteMenuReq {
+		Id string `path:"id"` // 菜单ID
+	}
+	// 删除响应
+	DeleteMenuResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 获取所有菜单请求
+	GetMenuAllReq  {}
+	// 获取所有菜单响应
+	GetMenuAllResp {
+		Name      string                 `json:"name"`
+		Path      string                 `json:"path"`
+		Redirect  string                 `json:"redirect,omitempty"`
+		Component string                 `json:"component,omitempty"`
+		Sort      int64                  `json:"sort"`
+		Meta      map[string]interface{} `json:"meta"`
+		Children  []GetMenuAllResp       `json:"children"`
+	}
+)
+

app/main/api/desc/admin/notification.api

@@ -0,0 +1,128 @@
+syntax = "v1"
+
+type (
+	// 创建通知请求
+	AdminCreateNotificationReq {
+		Title            string `json:"title"`             // 通知标题
+		NotificationPage string `json:"notification_page"` // 通知页面
+		Content          string `json:"content"`           // 通知内容
+		StartDate        string `json:"start_date"`        // 生效开始日期（yyyy-MM-dd）
+		StartTime        string `json:"start_time"`        // 生效开始时间（HH:mm:ss）
+		EndDate          string `json:"end_date"`          // 生效结束日期（yyyy-MM-dd）
+		EndTime          string `json:"end_time"`          // 生效结束时间（HH:mm:ss）
+		Status           int64  `json:"status"`            // 状态：1-启用，0-禁用
+	}
+
+	// 创建通知响应
+    AdminCreateNotificationResp {
+        Id string `json:"id"` // 通知ID
+    }
+
+	// 更新通知请求
+    AdminUpdateNotificationReq {
+        Id               string  `path:"id"`                         // 通知ID
+        Title            *string `json:"title,optional"`             // 通知标题
+		Content          *string `json:"content,optional"`           // 通知内容
+		NotificationPage *string `json:"notification_page,optional"` // 通知页面
+		StartDate        *string `json:"start_date,optional"`        // 生效开始日期
+		StartTime        *string `json:"start_time,optional"`        // 生效开始时间
+		EndDate          *string `json:"end_date,optional"`          // 生效结束日期
+		EndTime          *string `json:"end_time,optional"`          // 生效结束时间
+		Status           *int64  `json:"status,optional"`            // 状态
+	}
+
+	// 更新通知响应
+	AdminUpdateNotificationResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 删除通知请求
+    AdminDeleteNotificationReq {
+        Id string `path:"id"` // 通知ID
+    }
+
+	// 删除通知响应
+	AdminDeleteNotificationResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 获取通知详情请求
+    AdminGetNotificationDetailReq {
+        Id string `path:"id"` // 通知ID
+    }
+
+	// 获取通知详情响应
+    AdminGetNotificationDetailResp {
+        Id               string `json:"id"`                // 通知ID
+        Title            string `json:"title"`             // 通知标题
+		Content          string `json:"content"`           // 通知内容
+		NotificationPage string `json:"notification_page"` // 通知页面
+		StartDate        string `json:"start_date"`        // 生效开始日期
+		StartTime        string `json:"start_time"`        // 生效开始时间
+		EndDate          string `json:"end_date"`          // 生效结束日期
+		EndTime          string `json:"end_time"`          // 生效结束时间
+		Status           int64  `json:"status"`            // 状态
+		CreateTime       string `json:"create_time"`       // 创建时间
+		UpdateTime       string `json:"update_time"`       // 更新时间
+	}
+
+	// 获取通知列表请求
+	AdminGetNotificationListReq {
+		Page             int64   `form:"page"`                       // 页码
+		PageSize         int64   `form:"pageSize"`                   // 每页数量
+		Title            *string `form:"title,optional"`             // 通知标题（可选）
+		NotificationPage *string `form:"notification_page,optional"` // 通知页面（可选）
+		Status           *int64  `form:"status,optional"`            // 状态（可选）
+		StartDate        *string `form:"start_date,optional"`        // 开始日期范围（可选）
+		EndDate          *string `form:"end_date,optional"`          // 结束日期范围（可选）
+	}
+
+	// 通知列表项
+    NotificationListItem {
+        Id               string `json:"id"`                // 通知ID
+        Title            string `json:"title"`             // 通知标题
+		NotificationPage string `json:"notification_page"` // 通知页面
+		Content          string `json:"content"`           // 通知内容
+		StartDate        string `json:"start_date"`        // 生效开始日期
+		StartTime        string `json:"start_time"`        // 生效开始时间
+		EndDate          string `json:"end_date"`          // 生效结束日期
+		EndTime          string `json:"end_time"`          // 生效结束时间
+		Status           int64  `json:"status"`            // 状态
+		CreateTime       string `json:"create_time"`       // 创建时间
+		UpdateTime       string `json:"update_time"`       // 更新时间
+	}
+
+	// 获取通知列表响应
+	AdminGetNotificationListResp {
+		Total int64                  `json:"total"` // 总数
+		Items []NotificationListItem `json:"items"` // 列表数据
+	}
+)
+
+// 通知管理接口
+@server(
+	prefix: /api/v1/admin/notification
+	group: admin_notification
+	middleware: AdminAuthInterceptor
+)
+service main {
+	// 创建通知
+	@handler AdminCreateNotification
+	post /create (AdminCreateNotificationReq) returns (AdminCreateNotificationResp)
+
+	// 更新通知
+	@handler AdminUpdateNotification
+	put /update/:id (AdminUpdateNotificationReq) returns (AdminUpdateNotificationResp)
+
+	// 删除通知
+	@handler AdminDeleteNotification
+	delete /delete/:id (AdminDeleteNotificationReq) returns (AdminDeleteNotificationResp)
+
+	// 获取通知详情
+	@handler AdminGetNotificationDetail
+	get /detail/:id (AdminGetNotificationDetailReq) returns (AdminGetNotificationDetailResp)
+
+	// 获取通知列表
+	@handler AdminGetNotificationList
+	get /list (AdminGetNotificationListReq) returns (AdminGetNotificationListResp)
+}

app/main/api/desc/admin/order.api

@@ -0,0 +1,168 @@
+syntax = "v1"
+
+info (
+	title:   "订单服务"
+	desc:    "订单服务"
+	version: "v1"
+)
+
+@server (
+	prefix:     api/v1/admin/order
+	group:      admin_order
+	middleware: AdminAuthInterceptor
+)
+service main {
+	@doc "获取订单列表"
+	@handler AdminGetOrderList
+	get /list (AdminGetOrderListReq) returns (AdminGetOrderListResp)
+
+	@doc "获取订单详情"
+	@handler AdminGetOrderDetail
+	get /detail/:id (AdminGetOrderDetailReq) returns (AdminGetOrderDetailResp)
+
+	@doc "创建订单"
+	@handler AdminCreateOrder
+	post /create (AdminCreateOrderReq) returns (AdminCreateOrderResp)
+
+	@doc "更新订单"
+	@handler AdminUpdateOrder
+	put /update/:id (AdminUpdateOrderReq) returns (AdminUpdateOrderResp)
+
+	@doc "删除订单"
+	@handler AdminDeleteOrder
+	delete /delete/:id (AdminDeleteOrderReq) returns (AdminDeleteOrderResp)
+
+	@doc "订单退款"
+	@handler AdminRefundOrder
+	post /refund/:id (AdminRefundOrderReq) returns (AdminRefundOrderResp)
+
+	@doc "重新执行代理处理"
+	@handler AdminRetryAgentProcess
+	post /retry-agent-process/:id (AdminRetryAgentProcessReq) returns (AdminRetryAgentProcessResp)
+}
+
+type (
+	// 列表请求
+	AdminGetOrderListReq {
+		Page            int64   `form:"page,default=1"` // 页码
+		PageSize        int64   `form:"pageSize,default=20"` // 每页数量
+		OrderNo         string  `form:"order_no,optional"` // 商户订单号
+		PlatformOrderId string  `form:"platform_order_id,optional"` // 支付订单号
+		ProductName     string  `form:"product_name,optional"` // 产品名称
+		PaymentPlatform string  `form:"payment_platform,optional"` // 支付方式
+		PaymentScene    string  `form:"payment_scene,optional"` // 支付平台
+		Amount          float64 `form:"amount,optional"` // 金额
+		Status          string  `form:"status,optional"` // 支付状态：pending-待支付，paid-已支付，refunded-已退款，closed-已关闭，failed-支付失败
+		CreateTimeStart string  `form:"create_time_start,optional"` // 创建时间开始
+		CreateTimeEnd   string  `form:"create_time_end,optional"` // 创建时间结束
+		PayTimeStart    string  `form:"pay_time_start,optional"` // 支付时间开始
+		PayTimeEnd      string  `form:"pay_time_end,optional"` // 支付时间结束
+		RefundTimeStart string  `form:"refund_time_start,optional"` // 退款时间开始
+		RefundTimeEnd   string  `form:"refund_time_end,optional"` // 退款时间结束
+	}
+	// 列表响应
+	AdminGetOrderListResp {
+		Total int64           `json:"total"` // 总数
+		Items []OrderListItem `json:"items"` // 列表
+	}
+	// 列表项
+    OrderListItem {
+        Id                 string  `json:"id"` // 订单ID
+		OrderNo            string  `json:"order_no"` // 商户订单号
+		PlatformOrderId    string  `json:"platform_order_id"` // 支付订单号
+		ProductName        string  `json:"product_name"` // 产品名称
+		PaymentPlatform    string  `json:"payment_platform"` // 支付方式
+		PaymentScene       string  `json:"payment_scene"` // 支付平台
+		Amount             float64 `json:"amount"` // 金额
+		Status             string  `json:"status"` // 支付状态：pending-待支付，paid-已支付，refunded-已退款，closed-已关闭，failed-支付失败
+		QueryState         string  `json:"query_state"` // 查询状态：pending-待查询，success-查询成功，failed-查询失败 processing-查询中
+		CreateTime         string  `json:"create_time"` // 创建时间
+		PayTime            string  `json:"pay_time"` // 支付时间
+		RefundTime         string  `json:"refund_time"` // 退款时间
+		IsAgentOrder       bool    `json:"is_agent_order"` // 是否是代理订单
+		AgentProcessStatus string  `json:"agent_process_status"` // 代理事务处理状态：not_agent-非代理订单，success-处理成功，failed-处理失败，pending-待处理
+	}
+	// 详情请求
+    AdminGetOrderDetailReq {
+        Id string `path:"id"` // 订单ID
+	}
+	// 详情响应
+    AdminGetOrderDetailResp {
+        Id                 string  `json:"id"` // 订单ID
+		OrderNo            string  `json:"order_no"` // 商户订单号
+		PlatformOrderId    string  `json:"platform_order_id"` // 支付订单号
+		ProductName        string  `json:"product_name"` // 产品名称
+		PaymentPlatform    string  `json:"payment_platform"` // 支付方式
+		PaymentScene       string  `json:"payment_scene"` // 支付平台
+		Amount             float64 `json:"amount"` // 金额
+		Status             string  `json:"status"` // 支付状态：pending-待支付，paid-已支付，refunded-已退款，closed-已关闭，failed-支付失败
+		QueryState         string  `json:"query_state"` // 查询状态：pending-待查询，success-查询成功，failed-查询失败 processing-查询中
+		CreateTime         string  `json:"create_time"` // 创建时间
+		PayTime            string  `json:"pay_time"` // 支付时间
+		RefundTime         string  `json:"refund_time"` // 退款时间
+		UpdateTime         string  `json:"update_time"` // 更新时间
+		IsAgentOrder       bool    `json:"is_agent_order"` // 是否是代理订单
+		AgentProcessStatus string  `json:"agent_process_status"` // 代理事务处理状态：not_agent-非代理订单，success-处理成功，failed-处理失败，pending-待处理
+	}
+	// 创建请求
+	AdminCreateOrderReq {
+		OrderNo         string  `json:"order_no"` // 商户订单号
+		PlatformOrderId string  `json:"platform_order_id"` // 支付订单号
+		ProductName     string  `json:"product_name"` // 产品名称
+		PaymentPlatform string  `json:"payment_platform"` // 支付方式
+		PaymentScene    string  `json:"payment_scene"` // 支付平台
+		Amount          float64 `json:"amount"` // 金额
+		Status          string  `json:"status,default=pending"` // 支付状态：pending-待支付，paid-已支付，refunded-已退款，closed-已关闭，failed-支付失败
+	}
+	// 创建响应
+    AdminCreateOrderResp {
+        Id string `json:"id"` // 订单ID
+	}
+	// 更新请求
+    AdminUpdateOrderReq {
+        Id              string   `path:"id"` // 订单ID
+		OrderNo         *string  `json:"order_no,optional"` // 商户订单号
+		PlatformOrderId *string  `json:"platform_order_id,optional"` // 支付订单号
+		ProductName     *string  `json:"product_name,optional"` // 产品名称
+		PaymentPlatform *string  `json:"payment_platform,optional"` // 支付方式
+		PaymentScene    *string  `json:"payment_scene,optional"` // 支付平台
+		Amount          *float64 `json:"amount,optional"` // 金额
+		Status          *string  `json:"status,optional"` // 支付状态：pending-待支付，paid-已支付，refunded-已退款，closed-已关闭，failed-支付失败
+		PayTime         *string  `json:"pay_time,optional"` // 支付时间
+		RefundTime      *string  `json:"refund_time,optional"` // 退款时间
+	}
+	// 更新响应
+	AdminUpdateOrderResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 删除请求
+    AdminDeleteOrderReq {
+        Id string `path:"id"` // 订单ID
+	}
+	// 删除响应
+	AdminDeleteOrderResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 退款请求
+    AdminRefundOrderReq {
+        Id           string  `path:"id"` // 订单ID
+		RefundAmount float64 `json:"refund_amount"` // 退款金额
+		RefundReason string  `json:"refund_reason"` // 退款原因
+	}
+	// 退款响应
+	AdminRefundOrderResp {
+		Status   string  `json:"status"` // 退款状态
+		RefundNo string  `json:"refund_no"` // 退款单号
+		Amount   float64 `json:"amount"` // 退款金额
+	}
+	// 重新执行代理处理请求
+    AdminRetryAgentProcessReq {
+        Id string `path:"id"` // 订单ID
+	}
+	// 重新执行代理处理响应
+	AdminRetryAgentProcessResp {
+		Status      string `json:"status"` // 执行状态：success-成功，already_processed-已处理，failed-失败
+		Message     string `json:"message"` // 执行结果消息
+		ProcessedAt string `json:"processed_at"` // 处理时间
+	}
+)

app/main/api/desc/admin/platform_user.api

@@ -0,0 +1,113 @@
+syntax = "v1"
+
+info (
+	title:   "平台用户管理"
+	desc:    "平台用户管理"
+	version: "v1"
+)
+
+// 平台用户管理接口
+@server (
+	prefix:     /api/v1/admin/platform_user
+	group:      admin_platform_user
+	middleware: AdminAuthInterceptor
+)
+service main {
+	// 创建平台用户
+	@handler AdminCreatePlatformUser
+	post /create (AdminCreatePlatformUserReq) returns (AdminCreatePlatformUserResp)
+
+	// 更新平台用户
+	@handler AdminUpdatePlatformUser
+	put /update/:id (AdminUpdatePlatformUserReq) returns (AdminUpdatePlatformUserResp)
+
+	// 删除平台用户
+	@handler AdminDeletePlatformUser
+	delete /delete/:id (AdminDeletePlatformUserReq) returns (AdminDeletePlatformUserResp)
+
+	// 获取平台用户分页列表
+	@handler AdminGetPlatformUserList
+	get /list (AdminGetPlatformUserListReq) returns (AdminGetPlatformUserListResp)
+
+	// 获取平台用户详情
+	@handler AdminGetPlatformUserDetail
+	get /detail/:id (AdminGetPlatformUserDetailReq) returns (AdminGetPlatformUserDetailResp)
+}
+
+type (
+	// 分页列表请求
+	AdminGetPlatformUserListReq {
+		Page            int64  `form:"page,default=1"` // 页码
+		PageSize        int64  `form:"pageSize,default=20"` // 每页数量
+		Mobile          string `form:"mobile,optional"` // 手机号
+		Nickname        string `form:"nickname,optional"` // 昵称
+		Inside          int64  `form:"inside,optional"` // 是否内部用户 1-是 0-否
+		CreateTimeStart string `form:"create_time_start,optional"` // 创建时间开始
+		CreateTimeEnd   string `form:"create_time_end,optional"` // 创建时间结束
+		OrderBy         string `form:"order_by,optional"` // 排序字段
+		OrderType       string `form:"order_type,optional"` // 排序类型
+	}
+	// 分页列表响应
+	AdminGetPlatformUserListResp {
+		Total int64                  `json:"total"` // 总数
+		Items []PlatformUserListItem `json:"items"` // 列表
+	}
+	// 列表项
+	PlatformUserListItem {
+		Id         string `json:"id"` // 用户ID
+		Mobile     string `json:"mobile"` // 手机号
+		Nickname   string `json:"nickname"` // 昵称
+		Info       string `json:"info"` // 备注信息
+		Inside     int64  `json:"inside"` // 是否内部用户 1-是 0-否
+		CreateTime string `json:"create_time"` // 创建时间
+		UpdateTime string `json:"update_time"` // 更新时间
+	}
+	// 详情请求
+	AdminGetPlatformUserDetailReq {
+		Id string `path:"id"` // 用户ID
+	}
+	// 详情响应
+	AdminGetPlatformUserDetailResp {
+		Id         string `json:"id"` // 用户ID
+		Mobile     string `json:"mobile"` // 手机号
+		Nickname   string `json:"nickname"` // 昵称
+		Info       string `json:"info"` // 备注信息
+		Inside     int64  `json:"inside"` // 是否内部用户 1-是 0-否
+		CreateTime string `json:"create_time"` // 创建时间
+		UpdateTime string `json:"update_time"` // 更新时间
+	}
+	// 创建请求
+	AdminCreatePlatformUserReq {
+		Mobile   string `json:"mobile"` // 手机号
+		Password string `json:"password"` // 密码
+		Nickname string `json:"nickname"` // 昵称
+		Info     string `json:"info"` // 备注信息
+		Inside   int64  `json:"inside"` // 是否内部用户 1-是 0-否
+	}
+	// 创建响应
+	AdminCreatePlatformUserResp {
+		Id string `json:"id"` // 用户ID
+	}
+	// 更新请求
+	AdminUpdatePlatformUserReq {
+		Id       string  `path:"id"` // 用户ID
+		Mobile   *string `json:"mobile,optional"` // 手机号
+		Password *string `json:"password,optional"` // 密码
+		Nickname *string `json:"nickname,optional"` // 昵称
+		Info     *string `json:"info,optional"` // 备注信息
+		Inside   *int64  `json:"inside,optional"` // 是否内部用户 1-是 0-否
+	}
+	// 更新响应
+	AdminUpdatePlatformUserResp {
+		Success bool `json:"success"` // 是否成功
+	}
+	// 删除请求
+	AdminDeletePlatformUserReq {
+		Id string `path:"id"` // 用户ID
+	}
+	// 删除响应
+	AdminDeletePlatformUserResp {
+		Success bool `json:"success"` // 是否成功
+	}
+)
+

app/main/api/desc/admin/role.api

@@ -0,0 +1,122 @@
+syntax = "v1"
+
+info (
+	title:   "角色服务"
+	desc:    "角色服务"
+	version: "v1"
+)
+
+@server (
+	prefix: api/v1/admin/role
+	group:  admin_role
+	middleware: AdminAuthInterceptor
+)
+service main {
+	@doc "获取角色列表"
+	@handler GetRoleList
+	get /list (GetRoleListReq) returns (GetRoleListResp)
+
+	@doc "获取角色详情"
+	@handler GetRoleDetail
+	get /detail/:id (GetRoleDetailReq) returns (GetRoleDetailResp)
+
+	@doc "创建角色"
+	@handler CreateRole
+	post /create (CreateRoleReq) returns (CreateRoleResp)
+
+	@doc "更新角色"
+	@handler UpdateRole
+	put /update/:id (UpdateRoleReq) returns (UpdateRoleResp)
+
+	@doc "删除角色"
+	@handler DeleteRole
+	delete /delete/:id (DeleteRoleReq) returns (DeleteRoleResp)
+}
+
+type (
+	// 列表请求
+	GetRoleListReq {
+		Page     int64  `form:"page,default=1"`             // 页码
+		PageSize int64  `form:"pageSize,default=20"`        // 每页数量
+		Name     string `form:"name,optional"`              // 角色名称
+		Code     string `form:"code,optional"`              // 角色编码
+		Status   int64  `form:"status,optional,default=-1"` // 状态：0-禁用，1-启用
+	}
+
+	// 列表响应
+	GetRoleListResp {
+		Total int64          `json:"total"` // 总数
+		Items []RoleListItem `json:"items"` // 列表
+	}
+
+	// 列表项
+    RoleListItem {
+        Id          string  `json:"id"`          // 角色ID
+        RoleName    string  `json:"role_name"`   // 角色名称
+		RoleCode    string  `json:"role_code"`   // 角色编码
+		Description string  `json:"description"` // 角色描述
+		Status      int64   `json:"status"`      // 状态：0-禁用，1-启用
+		Sort        int64   `json:"sort"`        // 排序
+		CreateTime  string  `json:"create_time"` // 创建时间
+        MenuIds     []string `json:"menu_ids"`    // 关联的菜单ID列表
+    }
+
+	// 详情请求
+    GetRoleDetailReq {
+        Id string `path:"id"` // 角色ID
+    }
+
+	// 详情响应
+    GetRoleDetailResp {
+        Id          string  `json:"id"`          // 角色ID
+		RoleName    string  `json:"role_name"`   // 角色名称
+		RoleCode    string  `json:"role_code"`   // 角色编码
+		Description string  `json:"description"` // 角色描述
+		Status      int64   `json:"status"`      // 状态：0-禁用，1-启用
+		Sort        int64   `json:"sort"`        // 排序
+		CreateTime  string  `json:"create_time"` // 创建时间
+		UpdateTime  string  `json:"update_time"` // 更新时间
+        MenuIds     []string `json:"menu_ids"`    // 关联的菜单ID列表
+    }
+
+	// 创建请求
+    CreateRoleReq {
+		RoleName    string  `json:"role_name"`        // 角色名称
+		RoleCode    string  `json:"role_code"`        // 角色编码
+		Description string  `json:"description"`      // 角色描述
+		Status      int64   `json:"status,default=1"` // 状态：0-禁用，1-启用
+		Sort        int64   `json:"sort,default=0"`   // 排序
+        MenuIds     []string `json:"menu_ids"`         // 关联的菜单ID列表
+    }
+
+	// 创建响应
+    CreateRoleResp {
+        Id string `json:"id"` // 角色ID
+    }
+
+	// 更新请求
+    UpdateRoleReq {
+        Id          string  `path:"id"`                   // 角色ID
+		RoleName    *string `json:"role_name,optional"`   // 角色名称
+		RoleCode    *string `json:"role_code,optional"`   // 角色编码
+		Description *string `json:"description,optional"` // 角色描述
+		Status      *int64  `json:"status,optional"`      // 状态：0-禁用，1-启用
+		Sort        *int64  `json:"sort,optional"`        // 排序
+        MenuIds     []string `json:"menu_ids,optional"`    // 关联的菜单ID列表
+    }
+
+	// 更新响应
+	UpdateRoleResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 删除请求
+    DeleteRoleReq {
+        Id string `path:"id"` // 角色ID
+    }
+
+	// 删除响应
+	DeleteRoleResp {
+		Success bool `json:"success"` // 是否成功
+	}
+)