Files

万物街 127a4db1e3 feat: 完成sys模块迁移，对齐PHP/Java框架

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

2025-09-21 21:29:28 +08:00

1.9 KiB

Raw Blame History

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

1.9 KiB Raw Blame History Unescape Escape

SYS API 对照与缺口清单

1.9 KiB

Raw Blame History