4.1 KiB
4.1 KiB
独立账号权限项目实施约定
目录:identity-admin/。原项目仅作为分析依据,不迁移真实账号、业务数据或私密配置。
技术与边界
- 后端:PHP 8.2+、ThinkPHP 8 单应用,独立 Composer 依赖。SQLite 为本地默认,MySQL 可配置;不依赖上级
server/vendor。 - 前端:Vue 3、TypeScript、Vite、Element Plus、Pinia、Vue Router,独立 npm 依赖。
- 范围:密码登录/退出、当前用户/修改密码、用户多角色多部门、角色授权、树形部门、目录/菜单/按钮。
- 原医疗数据范围策略、企微和 OIDC 客户端不作为独立服务前置条件;本项目是独立后台基础项目,不声称提供跨应用单点登录服务端。
- 新密码用
password_hash/password_verify,随机会话仅保存哈希;权限及停用状态每次请求重新计算。显式路由、HTTP 方法与权限映射,默认拒绝。
HTTP 契约
前缀 /adminapi;JSON 请求;头 Authorization: Bearer <token>;响应 {code:1,msg:"",data:...}。失败 HTTP 400/401/403/404/409/422/429,code:0。
| 方法/路径 | 参数与返回 |
|---|---|
GET /health |
公开,返回项目标识;不返回配置信息 |
POST /login/account |
{account,password} → {token} |
POST /login/logout |
撤销当前会话 |
GET /auth.admin/mySelf |
{id,account,name,is_root,role_id:[],dept_id:[],permissions:[],menus:[]} |
POST /auth.admin/password |
{old_password,password,password_confirm},撤销全部旧会话,前端重新登录 |
GET /auth/options |
当前登录用户可读下拉选项,{roles:[],depts:[],menus:[]};无密码与会话字段 |
GET /auth.admin/lists |
page_no,page_size,keyword,disable → {lists:[],count,page_no,page_size} |
GET /auth.role/lists |
同上,角色列表 |
GET /auth.menu/lists |
完整树数组,节点 children:[] |
GET /auth.dept/lists |
完整树数组,节点 children:[] |
POST /auth.{admin,role,menu,dept}/{add,edit,delete} |
新增/编辑对应字段;删除 {id};返回新记录或 {id} |
列表行直接包含编辑需要的全部非敏感字段。
数据字段
- 用户:admin
id,account,name,disable(0启用/1停用),role_id:number[],dept_id:number[],role_names:string[],dept_names:string[],create_time;创建必填password,编辑密码留空不变;password_confirm仅密码修改接口使用。is_root不接受通过管理接口提交;保护根账号、自身停用/删除。 - 角色:
id,name,desc,sort,disable,menu_id:number[];提交空menu_id必须清空授权。已分配用户的角色不能直接删除。 - 菜单:
id,pid,type('M'目录/'C'页面/'A'按钮),name,paths,component,perms,icon,sort,is_show(1显示/0隐藏),disable。页面路由为绝对路径;目录路径也可为空;按钮不作为路由;禁用父节点使其后代授权失效;禁止循环;有子节点禁止删除。页面perms对应读取权限,按钮为写操作权限。 - 部门:
id,pid,name,sort,disable;禁止循环;有子部门或关联用户时禁止删除;停用部门禁止新增关联。 - 选项:roles 为角色平铺(含 menu_id),depts/menus 为完整树;用于编辑表单,不代替接口授权。
内置页面与权限
页面组件白名单:dashboard/index、system/users、system/roles、system/menus、system/depts。新增自定义页面可映射 common/custom,只展示菜单名称与说明;开发新的业务页面后再注册组件。
内置路由:/dashboard、/system/users、/system/roles、/system/menus、/system/depts。
权限键与原 likeadmin 风格一致:auth.admin/lists、auth.admin/add、auth.admin/edit、auth.admin/delete;role/menu/dept 同理。首页对所有登录用户可访问。超级管理员 permissions:["*"];普通角色授予的有效权限取并集。菜单隐藏与禁用分开:隐藏只影响导航,禁用影响授权。
初始化脚本只在空白独立数据库中建表与创建用户,管理员密码从命令行/环境明确提供,无固定种子密码;不得自动读取上级 .env。