独立账号权限 API
PHP 8.2+、ThinkPHP 8 单应用、PDO,独立模式默认 SQLite,可选 MySQL。共享模式通过原医院服务管理账号;集团功能另用 SQLite 保存主 GID、公司和应用登录资格,不读取原项目私密配置或复制医疗数据库。集团当前提供互联网医院专用 SSO 桥,详见 集团身份说明。
上述数据库初始化与存储说明适用于 IAM_DATA_MODE=standalone。shared 模式通过原项目 API 实时管理同一份数据,使用原账号登录并禁止本地初始化;原配置仅由原服务自己加载。详见 共享数据说明。
安装与首次初始化
在本目录执行:
composer install
PHP 需要 pdo、mbstring,SQLite 模式需要 pdo_sqlite,MySQL 模式需要 pdo_mysql。仅修改此目录自己的 .env(可由 .env.example 复制)或进程环境变量。密码必须为 10–72 字节,避免 bcrypt 对超长密码截断。
初始化支持参数 --account、--password、--name,账号默认 admin,姓名默认“管理员”。密码没有默认值;从 --password 或 IAM_ADMIN_PASSWORD 明确提供。为避免命令行历史记录保存密码,可在 PowerShell 交互输入:
$secret = Read-Host '设置管理员密码(10–72字节)' -AsSecureString
$env:IAM_ADMIN_PASSWORD = [System.Net.NetworkCredential]::new('', $secret).Password
php scripts/init.php --account=admin --name=管理员
Remove-Item Env:IAM_ADMIN_PASSWORD
也可以执行 php scripts/init.php --account=admin --password="<自行设置的密码>" --name=管理员。脚本只初始化完全空白的独立数据库;已有任何业务表时退出码为 1,不覆盖、不重置密码。SQLite 的建表和种子同一事务;MySQL 的 DDL 自动提交,若初始化中断应检查新数据库并选用新的空数据库,不要对有数据的库删表重试。数据库账号必须有建表/建索引和 CRUD 权限。
初始化建立 8 张表及一个 root 用户、管理/只读两个角色、通用部门树和内置菜单/按钮;不创建额外演示账号或固定密码。root 用户不能停用或删除,普通用户不能编辑 root。
配置
进程环境变量优先于本目录 .env;不加载上级环境文件。
| 变量 | 默认值/用途 |
|---|---|
APP_DEBUG |
示例为 false,保持关闭 |
IAM_DB_DRIVER |
sqlite;另支持 mysql |
IAM_SQLITE_PATH |
runtime/identity.sqlite,相对本目录,也可绝对路径 |
IAM_RUNTIME_PATH |
登录限流目录的父目录,默认 runtime;验证时可指定独立目录 |
IAM_DB_HOST |
127.0.0.1,仅 MySQL |
IAM_DB_PORT |
3306,仅 MySQL |
IAM_DB_DATABASE |
MySQL 必填,须提前创建独立空数据库 |
IAM_DB_USERNAME / IAM_DB_PASSWORD |
仅 MySQL,代码不提供凭据兜底 |
IAM_SESSION_TTL |
28800 秒;有效范围300–604800,超范围会截断 |
IAM_CORS_ORIGINS |
允许的浏览器源,逗号分隔;代码默认 http://localhost:5173,http://127.0.0.1:5173;空值只允许同源 |
IAM_ADMIN_PASSWORD |
仅首次初始化使用,不需要为服务长期保留 |
SQLite、会话和限流文件位于自己的数据库/runtime 路径;服务进程必须能写入。runtime、.env、vendor 已被忽略,依赖由本目录 Composer 安装。
运行
php -S 127.0.0.1:8081 -t public public/router.php
或使用 php think run --host 127.0.0.1 --port 8081。Windows 若扩展未在 php.ini 启用,可使用 php -d extension=pdo_sqlite -S 127.0.0.1:8081 -t public public/router.php;CLI 初始化也使用同样扩展设置。开发服务器只用于本地联调;部署只暴露 public 前端控制器,原项目目录不作为站点根目录。
HTTP 与授权
所有接口在 /adminapi 下,仅健康检查 GET /adminapi/health 和账号登录 POST /adminapi/login/account 公开。接口路由在 route/app.php 明确注册 HTTP 方法和权限,关闭自动控制器路径;未知接口404、无效会话401、无权访问403、输入错误400/422、关系冲突409、登录限流429。响应为 {code:1,msg:"",data:...},失败 code:0。
登录请求为 JSON {account,password},返回 data.token。其余请求携带 Authorization: Bearer <token>。密码存 password_hash,随机 token 的 SHA-256 摘要存数据库。退出立即删除当前会话;用户停用、删除、改密撤销该用户全部会话;普通权限每次请求按当前角色和菜单重新计算,没有权限缓存。会话为固定到期,不自动续期。
列表和 CRUD 的路径/字段遵循 接口契约。页大小封顶100,修改请求使用白名单字段。根用户 permissions:["*"];其他账号取启用角色授权并集。目录或菜单停用后,其全部后代权限失效;隐藏仅影响导航。个人信息与下拉选项向所有已登录用户开放,但任何管理写入仍单独校验对应权限。
角色 menu_id:[] 清除全部授权,省略该字段保留原授权。用户多角色、多部门写入在同一事务中完成;新增关联不接受停用角色/部门。部门与菜单不可指向自己或后代,有子节点时不能删除;关联用户的部门/角色不可删除。菜单页面组件仅允许契约中的白名单;自定义菜单可使用 common/custom。
登录限流使用带 flock 的本地文件:每账号每15分钟最多5次失败或进行中尝试、每源IP每15分钟最多30次;成功登录重置其账号计数并返还本次IP预算。源IP读取直接连接地址,不信任客户端转发头;部署在代理后会共享代理IP的失败预算,按部署要求另设受信任代理处理或网关限流。多实例必须共享限流目录或在网关统一限流。
分层与联调建议
controller/ApiController 负责 HTTP 输入输出和路由权限;service 分离认证、账号、角色、树验证、限流;repository 管理参数化 SQL、事务和关系;scripts 独立初始化 schema 与新种子。MySQL 使用数据库级命名写入锁串行化写事务,防止并发重设上级造成树环。
优先验收:空库初始化和重复初始化拒绝;根登录/当前用户;创建只读用户后验证读200写403;无 token401、未知接口404;多角色并集与空授权撤回;禁用父菜单立即撤权;多部门关联和停用关联拒绝;自己/根删除停用拒绝;部门/菜单后代环和非法上级拒绝;注销/改密后旧 token401;分页上限、未知字段、SQL特殊字符、限流;随后在独立 MySQL 空库复跑。检查数据库只存 token 摘要,不输出账号密码和连接参数。
本次验证结果与环境限制见项目根目录的 docs/validation.md。