# 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 访问控制（可选）
