522 lines
42 KiB
Go
522 lines
42 KiB
Go
package routecatalog
|
|
|
|
import (
|
|
"sort"
|
|
"strings"
|
|
)
|
|
|
|
// RouteBodyPolicy controls request-body handling for sensitive routes.
|
|
type RouteBodyPolicy string
|
|
|
|
const (
|
|
BodyPolicyDefault RouteBodyPolicy = "default"
|
|
BodyPolicySMS RouteBodyPolicy = "sms"
|
|
BodyPolicyIntegrationConfig RouteBodyPolicy = "integration_config"
|
|
BodyPolicyPaymentConfig RouteBodyPolicy = "payment_config"
|
|
BodyPolicyPaymentCallback RouteBodyPolicy = "payment_callback"
|
|
BodyPolicyUpload RouteBodyPolicy = "upload"
|
|
)
|
|
|
|
// Descriptor is the shared HTTP contract consumed by service bootstrap,
|
|
// Swagger generation and audit middleware.
|
|
type Descriptor struct {
|
|
Method string
|
|
Path string
|
|
Public bool
|
|
Audit bool
|
|
Group string
|
|
Description string
|
|
BodyPolicy RouteBodyPolicy
|
|
}
|
|
|
|
type routeValue struct {
|
|
group string
|
|
description string
|
|
public bool
|
|
audit bool
|
|
bodyPolicy RouteBodyPolicy
|
|
}
|
|
|
|
// routes is the single declaration point for cross-cutting route policy.
|
|
// Gin router files still bind handlers; tests keep those registrations aligned
|
|
// with this catalog while public, audit and API metadata live only here.
|
|
var routes = map[string]routeValue{
|
|
"GET /sw/rank/channel": {group: "排行榜", description: "查询渠道四项排行与环比", audit: true},
|
|
"GET /sw/rank/business": {group: "排行榜", description: "查询商务四项排行与环比", audit: true},
|
|
"GET /sw/rank/game": {group: "排行榜", description: "查询游戏四项排行与环比", audit: true},
|
|
"GET /sw/workbench/summary": {group: "工作台", description: "查询商务六项指标与同期对照"},
|
|
"GET /sw/workbench/registerTop": {group: "工作台", description: "查询渠道注册排行"},
|
|
"GET /sw/workbench/payRank": {group: "工作台", description: "查询渠道充值最高与最低排行"},
|
|
"GET /sw/workbench/unloginTop": {group: "工作台", description: "查询未登录渠道排行"},
|
|
"GET /sw/serverAnalysis/servers": {group: "区服分析", description: "查询游戏区服选项"},
|
|
"GET /sw/serverAnalysis/list": {group: "区服分析", description: "查询区服分析与汇总"},
|
|
"GET /sw/channelData/list": {group: "渠道统计", description: "查询渠道数据与汇总"},
|
|
"GET /sw/gameData/list": {group: "游戏统计", description: "查询游戏数据与汇总"},
|
|
"GET /sw/register/list": {group: "注册明细", description: "查询注册明细"},
|
|
"POST /sw/register/export": {group: "注册明细", description: "导出注册明细", audit: true},
|
|
"GET /sw/spend/list": {group: "充值明细", description: "查询充值明细与成功支付合计"},
|
|
"POST /sw/spend/export": {group: "充值明细", description: "导出充值明细", audit: true},
|
|
"GET /sw/serverAnalysis/games": {group: "数据分析", description: "查询平台游戏选项"},
|
|
"GET /sw/promote/portrait": {group: "渠道画像", description: "查询渠道画像和玩家付费分层"},
|
|
"GET /sw/business/:userId/portrait": {group: "商务画像", description: "查询商务画像"},
|
|
"GET /sw/business/bindPlatform/portrait": {group: "商务画像", description: "查询 SDK 商务画像"},
|
|
"GET /sw/promote/list": {group: "渠道管理", description: "查询渠道列表及累计指标"},
|
|
"GET /sw/promote/bindOptions": {group: "渠道管理", description: "查询可用游戏商务绑定"},
|
|
"GET /sw/promote/game-distribution": {group: "渠道管理", description: "查询推广游戏累计分布"},
|
|
"POST /sw/promote": {group: "渠道管理", description: "创建源平台渠道", audit: true},
|
|
"GET /sw/promoteActivePool/bindList": {group: "渠道激活", description: "查询 OA 渠道激活绑定"},
|
|
"GET /sw/promoteActivePool/bindSpendDetail": {group: "渠道激活", description: "查询绑定期间游戏流水"},
|
|
"GET /sw/alertRecord/list": {group: "预警记录", description: "查询预警列表及状态统计"},
|
|
"GET /sw/alertRecord/detail/:id": {group: "预警记录", description: "查询预警详情及操作记录"},
|
|
"POST /sw/alertRecord/startProcess": {group: "预警记录", description: "开始处理预警", audit: true},
|
|
"POST /sw/alertRecord/submitAudit": {group: "预警记录", description: "提交预警审核", audit: true},
|
|
"POST /sw/alertRecord/approve": {group: "预警记录", description: "审核通过预警", audit: true},
|
|
"POST /sw/alertRecord/reject": {group: "预警记录", description: "审核驳回预警", audit: true},
|
|
"POST /sw/alertRecord/reProcess": {group: "预警记录", description: "重新处理预警", audit: true},
|
|
"POST /sw/alertRecord/addNote": {group: "预警记录", description: "添加预警备注及附件", audit: true},
|
|
"GET /sw/alertRule/list": {group: "预警规则", description: "查询预警规则"},
|
|
"GET /sw/alertRule/ruleTypes": {group: "预警规则", description: "查询历史预警分类"},
|
|
"GET /sw/alertRule/:id": {group: "预警规则", description: "查询规则详情"},
|
|
"POST /sw/alertRule/add": {group: "预警规则", description: "新建预警规则", audit: true},
|
|
"PUT /sw/alertRule/edit": {group: "预警规则", description: "修改预警规则", audit: true},
|
|
"PUT /sw/alertRule/toggle/:id": {group: "预警规则", description: "启停预警规则", audit: true},
|
|
"DELETE /sw/alertRule/:id": {group: "预警规则", description: "删除预警规则", audit: true},
|
|
"GET /sw/business/:userId/promotes": {group: "商务管理", description: "查询商务旗下直属一级渠道"},
|
|
"POST /sw/auth/forgot-password/check": {group: "商务登录", description: "校验找回密码账号", public: true},
|
|
"POST /sw/auth/forgot-password/send-code": {group: "商务登录", description: "发送找回密码验证码", public: true},
|
|
"POST /sw/auth/forgot-password/verify-code": {group: "商务登录", description: "验证短信并签发重置凭证", public: true},
|
|
"POST /sw/auth/forgot-password/reset": {group: "商务登录", description: "重置商务密码", public: true},
|
|
"GET /sw/business/bindPlatform": {group: "商务管理", description: "查询游戏商务绑定"},
|
|
"GET /sw/business/:userId/bindPlatform": {group: "商务管理", description: "查询指定商务已通过的绑定"},
|
|
"POST /sw/business/bindPlatform": {group: "商务管理", description: "绑定游戏商务并提交审核", audit: true},
|
|
"DELETE /sw/business/bindPlatform": {group: "商务管理", description: "解绑当前账号的游戏商务", audit: true},
|
|
"GET /sw/business/list": {group: "商务管理", description: "查询下级商务列表"},
|
|
"GET /sw/business/:userId": {group: "商务管理", description: "获取商务资料"},
|
|
"POST /sw/business": {group: "商务管理", description: "添加子商务", audit: true},
|
|
"PUT /sw/business": {group: "商务管理", description: "编辑商务资料和审核状态", audit: true},
|
|
"GET /sw/user/preference": {group: "商务偏好", description: "获取当前用户商务偏好"},
|
|
"GET /sw/settings/effectiveness": {group: "其他设置", description: "获取有效端判定参数"},
|
|
"GET /sw/groups": {group: "商务小组", description: "查询可见小组与成员"},
|
|
"PUT /sw/groups": {group: "商务小组", description: "保存小组配置", audit: true},
|
|
"PUT /sw/business/profile": {group: "商务小组", description: "编辑商务档案", audit: true},
|
|
"GET /sw/business/management": {group: "商务小组", description: "查询商务列表与当期绩效"},
|
|
"GET /sw/performance": {group: "商务绩效", description: "查询商务及小组绩效"},
|
|
"GET /sw/performance/details": {group: "商务绩效", description: "查询绩效渠道明细"},
|
|
"GET /sw/performance/export": {group: "商务绩效", description: "导出商务及小组绩效", audit: true},
|
|
"GET /sw/goals": {group: "绩效目标", description: "查询目标与历史达成"},
|
|
"PUT /sw/goals": {group: "绩效目标", description: "保存月度目标", audit: true},
|
|
"GET /sw/goals/mine": {group: "绩效目标", description: "查询本人本月目标"},
|
|
"GET /sw/workbench/overview": {group: "商务工作台", description: "按时间区间查询首页指标"},
|
|
"PUT /sw/settings/effectiveness": {group: "其他设置", description: "保存有效端判定参数", audit: true},
|
|
"PUT /sw/user/preference": {group: "商务偏好", description: "更新当前用户商务偏好", audit: true},
|
|
"DELETE /api/deleteApisByIds": {group: "api", description: "批量删除api", audit: true},
|
|
"DELETE /dataAccessLog/deleteDataAccessLogByIds": {group: "数据权限审计", description: "批量删除数据权限审计日志", audit: true},
|
|
"DELETE /department/deleteDepartment": {group: "部门", description: "删除部门", audit: true},
|
|
"DELETE /info/deleteInfo": {group: "公告", description: "删除公告", audit: true},
|
|
"DELETE /info/deleteInfoByIds": {group: "公告", description: "批量删除公告", audit: true},
|
|
"DELETE /integration/configs/:kind/:provider": {group: "集成配置", description: "删除集成配置", audit: true},
|
|
"DELETE /mediaUpload/:uploadId": {group: "媒体上传", description: "取消大文件上传", audit: true},
|
|
"DELETE /position/deletePosition": {group: "岗位", description: "删除岗位", audit: true},
|
|
"DELETE /sysDictionary/deleteSysDictionary": {group: "系统字典", description: "删除字典", audit: true},
|
|
"DELETE /sysDictionaryDetail/deleteSysDictionaryDetail": {group: "系统字典详情", description: "删除字典内容", audit: true},
|
|
"DELETE /sysError/deleteSysError": {group: "错误日志", description: "删除错误日志", audit: true},
|
|
"DELETE /sysError/deleteSysErrorByIds": {group: "错误日志", description: "批量删除错误日志", audit: true},
|
|
"DELETE /sysExportTemplate/deleteSysExportTemplate": {group: "导出模板", description: "删除导出模板", audit: true},
|
|
"DELETE /sysExportTemplate/deleteSysExportTemplateByIds": {group: "导出模板", description: "批量删除导出模板", audit: true},
|
|
"DELETE /sysLoginLog/deleteLoginLog": {group: "登录日志", description: "删除登录日志", audit: true},
|
|
"DELETE /sysLoginLog/deleteLoginLogByIds": {group: "登录日志", description: "批量删除登录日志", audit: true},
|
|
"DELETE /sysOperationRecord/deleteSysOperationRecord": {group: "操作记录", description: "删除操作记录", audit: true},
|
|
"DELETE /sysOperationRecord/deleteSysOperationRecordByIds": {group: "操作记录", description: "批量删除操作历史", audit: true},
|
|
"DELETE /sysParams/deleteSysParams": {group: "参数管理", description: "删除参数", audit: true},
|
|
"DELETE /sysParams/deleteSysParamsByIds": {group: "参数管理", description: "批量删除参数", audit: true},
|
|
"DELETE /sysVersion/deleteSysVersion": {group: "版本控制", description: "删除版本", audit: true},
|
|
"DELETE /sysVersion/deleteSysVersionByIds": {group: "版本控制", description: "批量删除版本", audit: true},
|
|
"DELETE /timedTask/deleteTimedTask": {group: "定时任务", description: "删除定时任务", audit: true},
|
|
"DELETE /user/deleteUser": {group: "系统用户", description: "删除用户", audit: true},
|
|
"GET /api/getApiGroups": {group: "api", description: "获取路由组", audit: true},
|
|
"GET /api/getApiRoles": {group: "api", description: "获取指定API关联角色列表"},
|
|
"GET /api/syncApi": {group: "api", description: "获取待同步API", audit: true},
|
|
"GET /api/freshCasbin": {group: "api", description: "刷新 Casbin 缓存"},
|
|
"GET /attachmentCategory/getCategoryList": {group: "媒体库分类", description: "分类列表"},
|
|
"GET /authority/getDataScopeDepts": {group: "角色", description: "获取角色自定义部门集"},
|
|
"GET /authority/getUsersByAuthority": {group: "角色", description: "获取角色关联用户ID列表"},
|
|
"GET /department/findDepartment": {group: "部门", description: "根据ID获取部门"},
|
|
"GET /department/getDepartmentUsers": {group: "部门", description: "获取部门成员ID列表"},
|
|
"GET /fileUploadAndDownload/findFile": {group: "文件上传与下载", description: "获取文件详情"},
|
|
"GET /health": {group: "base", description: "健康检查", public: true},
|
|
"GET /info/findInfo": {group: "公告", description: "根据ID获取公告"},
|
|
"GET /info/getInfoDataSource": {group: "公告", description: "获取公告数据源"},
|
|
"GET /info/getInfoList": {group: "公告", description: "获取公告列表"},
|
|
"GET /info/getInfoPublic": {group: "公告", description: "获取公开公告", public: true},
|
|
"GET /integration/configs/:kind": {group: "集成配置", description: "按类型获取集成配置"},
|
|
"GET /integration/configs/:kind/:provider": {group: "集成配置", description: "获取指定集成配置"},
|
|
"GET /logViewer/content": {group: "文件日志", description: "分块读取日志文件内容"},
|
|
"GET /logViewer/dates": {group: "文件日志", description: "获取存在日志的日期"},
|
|
"GET /logViewer/files": {group: "文件日志", description: "获取日期下的日志文件"},
|
|
"GET /menu/getMenuRoles": {group: "菜单", description: "获取菜单关联角色列表"},
|
|
"GET /payment/orders": {group: "支付", description: "分页查询支付订单"},
|
|
"GET /payment/orders/summary": {group: "支付", description: "汇总支付订单运营指标"},
|
|
"GET /payment/orders/:provider/:tradeNo": {group: "支付", description: "按路径查询支付订单"},
|
|
"GET /payment/orders/:provider/:tradeNo/events": {group: "支付", description: "查询支付订单事件流水"},
|
|
"GET /position/findPosition": {group: "岗位", description: "根据ID获取岗位"},
|
|
"GET /position/getPositionUsers": {group: "岗位", description: "获取岗位成员ID列表"},
|
|
"GET /securityConfig/getSecurityConfig": {group: "安全配置", description: "获取安全配置"},
|
|
"GET /swagger/*any": {group: "base", description: "Swagger 文档", public: true},
|
|
"GET /sysDictionary/exportSysDictionary": {group: "系统字典", description: "导出字典JSON", audit: true},
|
|
"GET /sysDictionary/findSysDictionary": {group: "系统字典", description: "根据ID获取字典（建议选择）"},
|
|
"GET /sysDictionary/getSysDictionaryList": {group: "系统字典", description: "获取字典列表"},
|
|
"GET /sysDictionary/getSysDictionaryListWithDetails": {group: "系统字典", description: "获取字典列表(含明细)"},
|
|
"GET /sysDictionaryDetail/findSysDictionaryDetail": {group: "系统字典详情", description: "根据ID获取字典内容"},
|
|
"GET /sysDictionaryDetail/getDictionaryDetailsByParent": {group: "系统字典详情", description: "根据父级ID获取字典详情"},
|
|
"GET /sysDictionaryDetail/getDictionaryPath": {group: "系统字典详情", description: "获取字典详情的完整路径"},
|
|
"GET /sysDictionaryDetail/getDictionaryTreeList": {group: "系统字典详情", description: "获取字典数列表"},
|
|
"GET /sysDictionaryDetail/getDictionaryTreeListByType": {group: "系统字典详情", description: "根据分类获取字典数列表"},
|
|
"GET /sysDictionaryDetail/getSysDictionaryDetailList": {group: "系统字典详情", description: "获取字典内容列表"},
|
|
"GET /sysError/findSysError": {group: "错误日志", description: "根据ID获取错误日志"},
|
|
"GET /sysError/getSysErrorList": {group: "错误日志", description: "获取错误日志列表"},
|
|
"GET /sysExportTemplate/exportExcel": {group: "导出模板", description: "导出Excel"},
|
|
"GET /sysExportTemplate/exportExcelByToken": {group: "导出模板", description: "按令牌导出Excel", public: true},
|
|
"GET /sysExportTemplate/exportTemplate": {group: "导出模板", description: "下载模板"},
|
|
"GET /sysExportTemplate/exportTemplateByToken": {group: "导出模板", description: "按令牌下载模板", public: true},
|
|
"GET /sysExportTemplate/findSysExportTemplate": {group: "导出模板", description: "根据ID获取导出模板"},
|
|
"GET /sysExportTemplate/getSysExportTemplateList": {group: "导出模板", description: "获取导出模板列表"},
|
|
"GET /sysExportTemplate/previewSQL": {group: "导出模板", description: "预览SQL"},
|
|
"GET /sysLoginLog/findLoginLog": {group: "登录日志", description: "根据ID获取登录日志"},
|
|
"GET /sysLoginLog/getLoginLogList": {group: "登录日志", description: "获取登录日志列表"},
|
|
"GET /sysOperationRecord/findSysOperationRecord": {group: "操作记录", description: "根据ID获取操作记录"},
|
|
"GET /sysOperationRecord/getSysOperationRecordList": {group: "操作记录", description: "获取操作记录列表"},
|
|
"GET /sysParams/findSysParams": {group: "参数管理", description: "根据ID获取参数"},
|
|
"GET /sysParams/getSysParam": {group: "参数管理", description: "按键获取参数"},
|
|
"GET /sysParams/getSysParamsList": {group: "参数管理", description: "获取参数列表"},
|
|
"GET /sysVersion/downloadVersionJson": {group: "版本控制", description: "下载版本json"},
|
|
"GET /sysVersion/findSysVersion": {group: "版本控制", description: "获取单一版本"},
|
|
"GET /sysVersion/getSysVersionList": {group: "版本控制", description: "获取版本列表"},
|
|
"GET /timedTask/alertStream": {group: "定时任务", description: "订阅定时任务失败告警(SSE)"},
|
|
"GET /timedTask/getRegisteredMethods": {group: "定时任务", description: "获取已注册方法列表"},
|
|
"GET /timedTask/getTimedTaskList": {group: "定时任务", description: "获取定时任务列表"},
|
|
"GET /timedTask/getTimedTaskLogList": {group: "定时任务", description: "获取定时任务执行日志"},
|
|
"GET /user/getUserInfo": {group: "系统用户", description: "获取自身信息(必选)"},
|
|
"POST /api/createApi": {group: "api", description: "创建api", audit: true},
|
|
"POST /api/deleteApi": {group: "api", description: "删除Api", audit: true},
|
|
"POST /api/enterSyncApi": {group: "api", description: "确认同步API", audit: true},
|
|
"POST /api/getAllApis": {group: "api", description: "获取所有api"},
|
|
"POST /api/getApiById": {group: "api", description: "获取api详细信息", audit: true},
|
|
"POST /api/getApiList": {group: "api", description: "获取api列表"},
|
|
"POST /api/ignoreApi": {group: "api", description: "忽略API", audit: true},
|
|
"POST /api/setApiRoles": {group: "api", description: "全量覆盖API关联角色列表", audit: true},
|
|
"POST /api/updateApi": {group: "api", description: "更新Api", audit: true},
|
|
"POST /attachmentCategory/addCategory": {group: "媒体库分类", description: "添加/编辑分类"},
|
|
"POST /attachmentCategory/deleteCategory": {group: "媒体库分类", description: "删除分类", audit: true},
|
|
"POST /authority/copyAuthority": {group: "角色", description: "拷贝角色", audit: true},
|
|
"POST /authority/createAuthority": {group: "角色", description: "创建角色", audit: true},
|
|
"POST /authority/deleteAuthority": {group: "角色", description: "删除角色", audit: true},
|
|
"POST /authority/getAuthorityList": {group: "角色", description: "获取角色列表"},
|
|
"POST /authority/setDataScope": {group: "角色", description: "设置角色数据权限", audit: true},
|
|
"POST /authority/setRoleUsers": {group: "角色", description: "全量覆盖角色关联用户", audit: true},
|
|
"POST /authorityBtn/canRemoveAuthorityBtn": {group: "按钮权限", description: "删除按钮"},
|
|
"POST /authorityBtn/getAuthorityBtn": {group: "按钮权限", description: "获取已有按钮权限"},
|
|
"POST /authorityBtn/setAuthorityBtn": {group: "按钮权限", description: "设置按钮权限"},
|
|
"POST /base/captcha": {group: "base", description: "获取验证码", public: true},
|
|
"POST /base/login": {group: "base", description: "登录", public: true},
|
|
"POST /casbin/getPolicyPathByAuthorityId": {group: "casbin", description: "获取权限列表"},
|
|
"POST /casbin/updateCasbin": {group: "casbin", description: "更改角色api权限", audit: true},
|
|
"POST /dataAccessLog/getDataAccessLogList": {group: "数据权限审计", description: "获取数据权限审计日志"},
|
|
"POST /department/createDepartment": {group: "部门", description: "创建部门", audit: true},
|
|
"POST /department/getDepartmentList": {group: "部门", description: "获取部门树"},
|
|
"POST /department/setDepartmentUsers": {group: "部门", description: "设置部门成员(反向分配)", audit: true},
|
|
"POST /email/emailTest": {group: "email", description: "发送测试邮件", audit: true},
|
|
"POST /email/sendEmail": {group: "email", description: "发送邮件", audit: true},
|
|
"POST /fileUploadAndDownload/deleteFile": {group: "文件上传与下载", description: "删除文件", audit: true},
|
|
"POST /fileUploadAndDownload/deleteFiles": {group: "文件上传与下载", description: "批量删除文件", audit: true},
|
|
"POST /fileUploadAndDownload/editFileName": {group: "文件上传与下载", description: "文件名或者备注编辑"},
|
|
"POST /fileUploadAndDownload/getFileList": {group: "文件上传与下载", description: "获取上传文件列表"},
|
|
"POST /fileUploadAndDownload/importURL": {group: "文件上传与下载", description: "导入URL"},
|
|
"POST /fileUploadAndDownload/listOssFiles": {group: "文件上传与下载", description: "获取对象存储文件列表"},
|
|
"POST /fileUploadAndDownload/upload": {group: "文件上传与下载", description: "文件上传（建议选择）", bodyPolicy: BodyPolicyUpload},
|
|
"POST /info/createInfo": {group: "公告", description: "新建公告", audit: true},
|
|
"POST /init/checkdb": {group: "初始化", description: "检查数据库", public: true},
|
|
"POST /init/initdb": {group: "初始化", description: "初始化数据库", public: true},
|
|
"POST /integration/configs/:kind/:provider/test": {group: "集成配置", description: "测试通信集成连接", audit: true, bodyPolicy: BodyPolicyIntegrationConfig},
|
|
"POST /integration/sms/:provider/send": {group: "短信服务", description: "发送单条模板短信", audit: true, bodyPolicy: BodyPolicySMS},
|
|
"POST /jwt/jsonInBlacklist": {group: "jwt", description: "jwt加入黑名单(退出，必选)"},
|
|
"POST /mediaUpload/chunk": {group: "媒体上传", description: "上传分片", bodyPolicy: BodyPolicyUpload},
|
|
"POST /mediaUpload/complete": {group: "媒体上传", description: "完成大文件上传"},
|
|
"POST /mediaUpload/init": {group: "媒体上传", description: "初始化大文件上传"},
|
|
"POST /menu/addBaseMenu": {group: "菜单", description: "新增菜单", audit: true},
|
|
"POST /menu/addMenuAuthority": {group: "菜单", description: "增加menu和角色关联关系", audit: true},
|
|
"POST /menu/deleteBaseMenu": {group: "菜单", description: "删除菜单", audit: true},
|
|
"POST /menu/getBaseMenuById": {group: "菜单", description: "根据id获取菜单"},
|
|
"POST /menu/getBaseMenuTree": {group: "菜单", description: "获取用户动态路由"},
|
|
"POST /menu/getMenu": {group: "菜单", description: "获取菜单树(必选)"},
|
|
"POST /menu/getMenuAuthority": {group: "菜单", description: "获取指定角色menu"},
|
|
"POST /menu/getMenuList": {group: "菜单", description: "分页获取基础menu列表"},
|
|
"POST /menu/setMenuRoles": {group: "菜单", description: "全量覆盖菜单关联角色列表", audit: true},
|
|
"POST /menu/updateBaseMenu": {group: "菜单", description: "更新菜单", audit: true},
|
|
"POST /payment/callback/:provider": {group: "支付", description: "处理支付回调", public: true, bodyPolicy: BodyPolicyPaymentCallback},
|
|
"POST /payment/create": {group: "支付", description: "创建支付订单", audit: true},
|
|
"POST /payment/fulfill": {group: "支付", description: "重试支付订单发货", audit: true},
|
|
"POST /payment/order": {group: "支付", description: "查询支付订单"},
|
|
"POST /payment/orders/:provider/:tradeNo/fulfill": {group: "支付", description: "按路径重试支付订单发货", audit: true},
|
|
"POST /payment/orders/:provider/:tradeNo/refund": {group: "支付", description: "按路径申请支付订单退款", audit: true},
|
|
"POST /payment/providers/:provider/test": {group: "支付", description: "测试支付渠道配置与沙箱交易链路", audit: true},
|
|
"POST /payment/query": {group: "支付", description: "同步支付订单状态", audit: true},
|
|
"POST /payment/refund": {group: "支付", description: "申请支付订单退款", audit: true},
|
|
"POST /position/createPosition": {group: "岗位", description: "创建岗位", audit: true},
|
|
"POST /position/getPositionList": {group: "岗位", description: "获取岗位列表"},
|
|
"POST /position/setPositionUsers": {group: "岗位", description: "设置岗位成员(反向分配)", audit: true},
|
|
"POST /securityConfig/setSecurityConfig": {group: "安全配置", description: "设置安全配置", audit: true},
|
|
"POST /sysApiToken/createApiToken": {group: "API Token", description: "签发API Token", audit: true},
|
|
"POST /sysApiToken/deleteApiToken": {group: "API Token", description: "作废API Token", audit: true},
|
|
"POST /sysApiToken/getApiTokenList": {group: "API Token", description: "获取API Token列表", audit: true},
|
|
"POST /sysDictionary/createSysDictionary": {group: "系统字典", description: "新增字典", audit: true},
|
|
"POST /sysDictionary/importSysDictionary": {group: "系统字典", description: "导入字典JSON", audit: true},
|
|
"POST /sysDictionaryDetail/createSysDictionaryDetail": {group: "系统字典详情", description: "新增字典内容", audit: true},
|
|
"POST /sysError/createSysError": {group: "错误日志", description: "新建错误日志", public: true},
|
|
"POST /sysExportTemplate/createSysExportTemplate": {group: "导出模板", description: "新增导出模板", audit: true},
|
|
"POST /sysExportTemplate/importExcel": {group: "导出模板", description: "导入Excel", audit: true},
|
|
"POST /sysParams/createSysParams": {group: "参数管理", description: "新建参数", audit: true},
|
|
"POST /system/getServerInfo": {group: "系统服务", description: "获取服务器信息"},
|
|
"POST /system/getSystemConfig": {group: "系统服务", description: "获取配置文件内容"},
|
|
"POST /system/reloadSystem": {group: "系统服务", description: "重载系统配置", audit: true},
|
|
"POST /system/setSystemConfig": {group: "系统服务", description: "设置配置文件内容", audit: true},
|
|
"POST /sysVersion/exportVersion": {group: "版本控制", description: "创建版本", audit: true},
|
|
"POST /sysVersion/importVersion": {group: "版本控制", description: "同步版本", audit: true},
|
|
"POST /timedTask/createTimedTask": {group: "定时任务", description: "创建定时任务", audit: true},
|
|
"POST /timedTask/toggleTimedTask": {group: "定时任务", description: "启用/停用定时任务", audit: true},
|
|
"POST /timedTask/triggerTimedTask": {group: "定时任务", description: "手动触发定时任务", audit: true},
|
|
"POST /user/admin_register": {group: "系统用户", description: "用户注册", audit: true},
|
|
"POST /user/changePassword": {group: "系统用户", description: "修改密码（建议选择)", audit: true},
|
|
"POST /user/getUserList": {group: "系统用户", description: "获取用户列表"},
|
|
"POST /user/resetPassword": {group: "系统用户", description: "重置用户密码", audit: true},
|
|
"POST /user/setUserAuthorities": {group: "系统用户", description: "设置权限组", audit: true},
|
|
"POST /user/setUserAuthority": {group: "系统用户", description: "修改用户角色(必选)", audit: true},
|
|
"POST /user/setUserDepartments": {group: "系统用户", description: "设置用户归属部门", audit: true},
|
|
"POST /user/setUserPositions": {group: "系统用户", description: "设置用户岗位", audit: true},
|
|
"PUT /authority/updateAuthority": {group: "角色", description: "更新角色信息", audit: true},
|
|
"PUT /department/updateDepartment": {group: "部门", description: "更新部门", audit: true},
|
|
"PUT /info/updateInfo": {group: "公告", description: "更新公告", audit: true},
|
|
"PUT /integration/configs/:kind/:provider": {group: "集成配置", description: "保存集成配置", audit: true, bodyPolicy: BodyPolicyIntegrationConfig},
|
|
"PUT /position/updatePosition": {group: "岗位", description: "更新岗位", audit: true},
|
|
"PUT /sysDictionary/updateSysDictionary": {group: "系统字典", description: "更新字典", audit: true},
|
|
"PUT /sysDictionaryDetail/updateSysDictionaryDetail": {group: "系统字典详情", description: "更新字典内容", audit: true},
|
|
"PUT /sysError/updateSysError": {group: "错误日志", description: "更新错误日志", audit: true},
|
|
"PUT /sysExportTemplate/updateSysExportTemplate": {group: "导出模板", description: "更新导出模板", audit: true},
|
|
"PUT /sysParams/updateSysParams": {group: "参数管理", description: "更新参数", audit: true},
|
|
"PUT /timedTask/updateTimedTask": {group: "定时任务", description: "更新定时任务", audit: true},
|
|
"PUT /user/setSelfInfo": {group: "系统用户", description: "设置自身信息(必选)", audit: true},
|
|
"PUT /user/setSelfSetting": {group: "系统用户", description: "用户界面配置", audit: true},
|
|
"PUT /user/setUserInfo": {group: "系统用户", description: "设置用户信息", audit: true},
|
|
}
|
|
|
|
// compiled is one catalog entry with its path pre-split into segments so that
|
|
// per-request matching neither parses the map key nor allocates. wildcard marks
|
|
// a Gin catch-all tail ("/*any"); that segment is dropped from parts because it
|
|
// absorbs every remaining segment instead of matching one.
|
|
type compiled struct {
|
|
parts []string
|
|
wildcard bool
|
|
descriptor Descriptor
|
|
}
|
|
|
|
// exact answers a canonical "METHOD /path" in a single map hit. byMethod holds
|
|
// the same entries pre-split and bucketed by method, so the fallback needed for
|
|
// path parameters and router prefixes scans one method's routes rather than the
|
|
// whole catalog, and never re-splits a pattern.
|
|
var (
|
|
exact = make(map[string]Descriptor, len(routes))
|
|
byMethod = make(map[string][]compiled)
|
|
)
|
|
|
|
func init() {
|
|
for key, value := range routes {
|
|
descriptor := descriptorFrom(key, value)
|
|
exact[descriptorKey(descriptor.Method, descriptor.Path)] = descriptor
|
|
entry := compiled{parts: splitPath(descriptor.Path), descriptor: descriptor}
|
|
if last := len(entry.parts) - 1; last >= 0 && strings.HasPrefix(entry.parts[last], "*") {
|
|
entry.parts, entry.wildcard = entry.parts[:last], true
|
|
}
|
|
byMethod[descriptor.Method] = append(byMethod[descriptor.Method], entry)
|
|
}
|
|
// Suffix matching lets two patterns answer the same URL. Ordering the
|
|
// buckets most-specific-first makes the winner deterministic instead of
|
|
// dependent on map iteration order.
|
|
for method := range byMethod {
|
|
entries := byMethod[method]
|
|
sort.SliceStable(entries, func(i, j int) bool {
|
|
if len(entries[i].parts) != len(entries[j].parts) {
|
|
return len(entries[i].parts) > len(entries[j].parts)
|
|
}
|
|
if entries[i].wildcard != entries[j].wildcard {
|
|
return entries[j].wildcard
|
|
}
|
|
return literalCount(entries[i].parts) > literalCount(entries[j].parts)
|
|
})
|
|
}
|
|
}
|
|
|
|
func literalCount(parts []string) int {
|
|
count := 0
|
|
for _, part := range parts {
|
|
if !strings.HasPrefix(part, ":") {
|
|
count++
|
|
}
|
|
}
|
|
return count
|
|
}
|
|
|
|
func splitKey(key string) (string, string) {
|
|
parts := strings.SplitN(key, " ", 2)
|
|
if len(parts) != 2 {
|
|
return "", key
|
|
}
|
|
return strings.ToUpper(parts[0]), normalizePath(parts[1])
|
|
}
|
|
|
|
func descriptorKey(method, path string) string {
|
|
return strings.ToUpper(strings.TrimSpace(method)) + " " + normalizePath(path)
|
|
}
|
|
|
|
func normalizePath(path string) string {
|
|
path = strings.TrimSpace(path)
|
|
if path == "" {
|
|
return "/"
|
|
}
|
|
return "/" + strings.Trim(path, "/")
|
|
}
|
|
|
|
func descriptorFrom(key string, value routeValue) Descriptor {
|
|
method, path := splitKey(key)
|
|
group := value.group
|
|
if group == "" {
|
|
group = RouteGroup(path)
|
|
}
|
|
return Descriptor{
|
|
Method: method, Path: path, Public: value.public, Audit: value.audit,
|
|
Group: group, Description: value.description, BodyPolicy: value.bodyPolicy,
|
|
}
|
|
}
|
|
|
|
func splitPath(path string) []string {
|
|
return strings.Split(strings.Trim(normalizePath(path), "/"), "/")
|
|
}
|
|
|
|
// Lookup accepts either a canonical Gin route template or an actual URL. A
|
|
// configured router prefix is tolerated by matching canonical paths by suffix.
|
|
// Every middleware resolves the descriptor on each request, so the pattern set
|
|
// is pre-split at init: a miss on the exact key costs one path split and a scan
|
|
// of the entries declared for that method, not a full catalog walk.
|
|
func Lookup(method, path string) (Descriptor, bool) {
|
|
if descriptor, ok := exact[descriptorKey(method, path)]; ok {
|
|
return descriptor, true
|
|
}
|
|
parts := splitPath(path)
|
|
for _, entry := range byMethod[strings.ToUpper(strings.TrimSpace(method))] {
|
|
if entry.matches(parts) {
|
|
return entry.descriptor, true
|
|
}
|
|
}
|
|
return Descriptor{}, false
|
|
}
|
|
|
|
// matches compares the pre-split pattern against a pre-split request path.
|
|
// Canonical patterns match by suffix so a router prefix is tolerated; a
|
|
// wildcard tail absorbs any number of trailing segments, so its fixed head is
|
|
// searched at every offset that leaves the wildcard something to consume.
|
|
func (c compiled) matches(pathParts []string) bool {
|
|
if len(c.parts) == 0 {
|
|
return !c.wildcard && len(pathParts) == 1 && pathParts[0] == ""
|
|
}
|
|
if len(pathParts) < len(c.parts) {
|
|
return false
|
|
}
|
|
if c.wildcard {
|
|
for offset := 0; offset+len(c.parts) < len(pathParts); offset++ {
|
|
if matchAt(c.parts, pathParts, offset) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
return matchAt(c.parts, pathParts, len(pathParts)-len(c.parts))
|
|
}
|
|
|
|
func matchAt(patternParts, pathParts []string, offset int) bool {
|
|
for index, patternPart := range patternParts {
|
|
actual := pathParts[offset+index]
|
|
if strings.HasPrefix(patternPart, ":") {
|
|
if actual == "" {
|
|
return false
|
|
}
|
|
continue
|
|
}
|
|
if patternPart != actual {
|
|
return false
|
|
}
|
|
}
|
|
return true
|
|
}
|
|
|
|
func Describe(method, path string) Descriptor {
|
|
if descriptor, ok := Lookup(method, path); ok {
|
|
return descriptor
|
|
}
|
|
return Descriptor{
|
|
Method: strings.ToUpper(strings.TrimSpace(method)),
|
|
Path: normalizePath(path),
|
|
Group: RouteGroup(path),
|
|
}
|
|
}
|
|
|
|
func ShouldAudit(method, path string) bool {
|
|
descriptor, ok := Lookup(method, path)
|
|
return ok && descriptor.Audit
|
|
}
|
|
|
|
func IsPublic(method, path string) bool {
|
|
descriptor, ok := Lookup(method, path)
|
|
return ok && descriptor.Public
|
|
}
|
|
|
|
// Descriptors returns an immutable, stable-order snapshot for startup and
|
|
// contract tests.
|
|
func Descriptors() []Descriptor {
|
|
values := make([]Descriptor, 0, len(routes))
|
|
for key, value := range routes {
|
|
values = append(values, descriptorFrom(key, value))
|
|
}
|
|
sort.Slice(values, func(i, j int) bool {
|
|
if values[i].Path == values[j].Path {
|
|
return values[i].Method < values[j].Method
|
|
}
|
|
return values[i].Path < values[j].Path
|
|
})
|
|
return values
|
|
}
|
|
|
|
// BodyPolicyFor resolves generic integration configuration writes against the
|
|
// actual URL so only kind=payment receives the payment-config summary policy.
|
|
func BodyPolicyFor(method, path string) RouteBodyPolicy {
|
|
descriptor, ok := Lookup(method, path)
|
|
if !ok {
|
|
return BodyPolicyDefault
|
|
}
|
|
if descriptor.BodyPolicy != BodyPolicyIntegrationConfig {
|
|
return descriptor.BodyPolicy
|
|
}
|
|
parts := strings.Split(strings.Trim(normalizePath(path), "/"), "/")
|
|
for index := 0; index+2 < len(parts); index++ {
|
|
if parts[index] == "integration" && parts[index+1] == "configs" && parts[index+2] == "payment" {
|
|
return BodyPolicyPaymentConfig
|
|
}
|
|
}
|
|
return BodyPolicyDefault
|
|
}
|
|
|
|
func RouteGroup(path string) string {
|
|
parts := strings.Split(strings.Trim(normalizePath(path), "/"), "/")
|
|
if len(parts) > 0 && parts[0] != "" {
|
|
return parts[0]
|
|
}
|
|
return "base"
|
|
}
|