集团身份中心
从甄养堂现有管理后台整理出的独立基础项目,采用 ThinkPHP 8 + Vue 3 + Element Plus。可将整个 identity-admin/ 复制到新目录或新仓库中使用。
支持两种数据模式:空白独立数据库,或与原项目实时共用账号、角色、菜单和部门数据。当前互通配置与原账号登录方式见 共享数据说明。
共享模式可启用集团主 GID、公司与成员管理,以及互联网医院一键登录。“部门管理”和“菜单管理”分别作为一级入口,下级按公司管理。新公司可直接独立维护部门和菜单,无需等待子系统接入;医院公司仍与原后台实时互通。架构、配置、权限边界与验收见 集团身份说明。
用户、角色全局管理,用户按所分配角色获得菜单和按钮权限;多角色取并集,同一角色可跨公司授权。公司仅作分组和组织归属,不因为加入公司自动开通菜单。
企微客服可接入集团一键登录:首次为无业务权限的基础用户,客服管理员在本系统分配角色;集团登记完整客服菜单目录。配置与授权边界见 客服接入说明。
已提供的功能
- 账号密码登录、退出、个人修改密码。
- 用户新增、编辑、停用、删除;一个用户关联多个角色、多个部门。
- 角色新增、编辑、删除,按菜单树分配页面和按钮权限,也可撤销全部授权。
- 目录、页面、按钮三种菜单,控制导航显示与启停;按当前用户授权生成路由。
- 树形部门新增、编辑、停用、删除,检查循环层级与关联用户。
- 后端逐接口鉴权、登录失败限流、会话失效处理、根账号保护。
默认使用独立 SQLite 数据库,后端也支持配置 MySQL。用户指后台员工账号。模块分析与边界见 原项目分析。
本地启动
需要 PHP 8.2+(PDO、pdo_sqlite、mbstring),Composer,Node.js 22 和 npm。
先启动后端:
cd identity-admin/server
composer install
Copy-Item .env.example .env
$env:IAM_ADMIN_PASSWORD = '请替换为至少10位的独立密码'
php scripts/init.php --account=admin --name=超级管理员
Remove-Item Env:IAM_ADMIN_PASSWORD
php -S 127.0.0.1:8081 -t public public/router.php
初始化只用于空白独立数据库;重复运行不会重置账号。默认 SQLite 文件放在后端自己的 runtime/ 中。若 PHP 未启用 SQLite,在 php.ini 中启用 extension=pdo_sqlite,或在各条 PHP 命令中使用 php -d extension=pdo_sqlite ...。
在另一个终端启动前端:
cd identity-admin/web
npm ci
npm run dev
访问 http://127.0.0.1:5173,用初始化时设置的账号密码登录。前端开发代理转发到 127.0.0.1:8081。数据库及会话文件、.env、依赖和构建目录均被忽略,不随源码交付。
更多后端配置见 server/README.md,前端配置见 web/README.md。MySQL 模式需自行创建专属空库和专用数据库账号,再设置后端配置,勿指向原业务数据库。
Docker 启动
仓库提供 API 与前端两个镜像,前端 Nginx 同源转发 API,SQLite 持久化到独立命名卷。
cd identity-admin
docker compose build
$env:IAM_ADMIN_PASSWORD = '请替换为至少10位的独立密码'
docker compose run --rm -e IAM_ADMIN_PASSWORD api php scripts/init.php --account=admin --name=超级管理员
Remove-Item Env:IAM_ADMIN_PASSWORD
docker compose up -d
默认访问 http://127.0.0.1:8088。复制根目录 .env.example 为 .env 可修改映射端口。对外发布时通过 HTTPS 反向代理接入。
构建与验证
cd identity-admin/web
npm run type-check
npm test
npm run build
构建产物仅位于 web/dist/。本项目不运行原后台的发布脚本。
Windows 下可执行独立 SQLite HTTP 集成验证:
cd identity-admin
./scripts/verify.ps1
# 未在 php.ini 启用 SQLite 的环境:
./scripts/verify.ps1 -PhpArgs @('-d', 'extension=pdo_sqlite')
验证会创建随机隔离测试库、初始化临时管理员、启动本地测试服务,并在结束时停止该服务。测试库和日志保留于被忽略的 .test-runtime/,用于排错。也可手动启动专用测试实例后运行 HTTP 测试。
后端还有两项不需要运行 HTTP 服务的回归:php tests/login-limiter.php 与 php tests/password-race.php(后者需要 pdo_sqlite)。完整结果见 验证记录。
扩展菜单与权限
先在菜单管理新增目录、页面或按钮,再在角色管理授予对应节点。页面组件使用前端白名单,内置工作台、用户、角色、菜单、部门;common/custom 可作为自定义页面说明占位。开发新功能时需实现页面及接口,并分别登记前端组件与后端接口权限映射。仅添加菜单记录不会自动生成业务代码。
独立空库模式保留基础账号权限能力。集团共享模式提供当前互联网医院的专用 SSO 登录桥;尚不提供完整 OIDC Provider、岗位、患者账号或医疗数据范围隔离。医院自己的首次改密、企微绑定与业务鉴权继续生效。
许可
保留原仓库 MIT 许可及 likeadmin 来源说明,见 LICENSE。框架和其他依赖遵循各自许可。