# 独立账号权限项目实施约定 目录:`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 `;响应 `{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`。