127a4db1e3
- 重构sys模块架构，严格按admin/api/core分层 - 对齐所有sys实体与数据库表结构 - 实现完整的adminapi控制器，匹配PHP/Java契约 - 修复依赖注入问题，确保服务正确注册 - 添加自动迁移工具和契约验证 - 完善多租户支持和审计功能 - 统一命名规范，与PHP业务逻辑保持一致
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 访问控制（可选）
|