49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
|
# SYS API 对照与缺口清单
|
|||
|
|
|
|||
|
|
- 管理端 /adminapi
|
|||
|
|
- config
|
|||
|
|
- GET /adminapi/config/system → 系统配置快照（PHP/Java 同等能力）
|
|||
|
|
- GET /adminapi/config/dynamic → 动态配置列表
|
|||
|
|
- GET /adminapi/config/dynamic/:key → 单项配置
|
|||
|
|
- POST /adminapi/config/dynamic → 创建配置
|
|||
|
|
- PUT /adminapi/config/dynamic/:key → 更新配置
|
|||
|
|
- DELETE /adminapi/config/dynamic/:key → 删除配置
|
|||
|
|
- POST /adminapi/config/refresh-cache → 刷新缓存（占位）
|
|||
|
|
- GET /adminapi/config/validate, /metadata, /stats → 运营辅助
|
|||
|
|
- sys/menu
|
|||
|
|
- GET /adminapi/sys/menu/list, /tree → 菜单查询
|
|||
|
|
- POST /adminapi/sys/menu → 创建
|
|||
|
|
- PUT /adminapi/sys/menu/:id → 更新
|
|||
|
|
- DELETE /adminapi/sys/menu/:id → 删除
|
|||
|
|
- sys/dict
|
|||
|
|
- GET /adminapi/sys/dict/types, /items?type=xxx → 查询
|
|||
|
|
- POST /adminapi/sys/dict/type, /item → 创建
|
|||
|
|
- PUT /adminapi/sys/dict/type/:id, /item/:id → 更新
|
|||
|
|
- DELETE /adminapi/sys/dict/type/:id, /item/:id → 删除
|
|||
|
|
- sys/area
|
|||
|
|
- GET /adminapi/sys/area/list, /tree → 区域查询
|
|||
|
|
|
|||
|
|
- 前台 /api
|
|||
|
|
- config
|
|||
|
|
- GET /api/config/:key → 单项
|
|||
|
|
- GET /api/config?keys=a,b,c → 批量（新增）
|
|||
|
|
- dict
|
|||
|
|
- GET /api/dict/:type/items → 项列表
|
|||
|
|
- area
|
|||
|
|
- GET /api/area/tree → 区域树
|
|||
|
|
|
|||
|
|
- 鉴权/租户/权限
|
|||
|
|
- 管理端：Jwt + SiteScope + @Roles（全局 RolesGuard 已启用）
|
|||
|
|
- 前台：可选鉴权 + SiteScope
|
|||
|
|
|
|||
|
|
- 与 PHP/Java 对齐情况
|
|||
|
|
- 路由结构：已对齐 admin/api 分层
|
|||
|
|
- 业务能力：config/dict/menu/area 已具备常见 CRUD/查询
|
|||
|
|
- 审计：config/dict/menu 写操作已记录
|
|||
|
|
- 多租户：site_id 查询隔离
|
|||
|
|
|
|||
|
|
- 缺口与建议
|
|||
|
|
- e2e：补齐鉴权/租户/权限关键路径（进行中）
|
|||
|
|
- 缓存：dict/menu 已加短缓存；如需可扩展至 area
|
|||
|
|
- 文档：Swagger 分组与 Token 访问控制（可选）
|