This commit is contained in:
gr
2026-11-11 13:53:14 +08:00
parent 85ffda8fd0
commit fc347bf9a6
490 changed files with 70862 additions and 386 deletions
+31
View File
@@ -0,0 +1,31 @@
<!doctype html>
<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="referrer" content="no-referrer"><title>集团账号登录 · 互联网医院</title>
<style>body{margin:0;min-height:100vh;display:grid;place-items:center;background:#f3f7f6;color:#183d37;font-family:system-ui,sans-serif}main{width:min(390px,calc(100% - 80px));padding:40px;background:#fff;border:1px solid #dce8e4;border-radius:20px;box-shadow:0 16px 56px #163d3710}.label{font-size:13px;letter-spacing:3px;color:#6e817c}h1{font-size:30px;margin:20px 0}p{line-height:1.8;color:#60736e}button{width:100%;margin-top:20px;padding:13px;border:0;border-radius:9px;background:#176453;color:white;cursor:pointer}a{display:block;margin-top:24px;color:#176453;font-size:14px}</style></head>
<body><main><span class="label">甄养堂集团</span><h1>互联网医院</h1><p id="status" role="status">正在连接集团账号…</p><button id="retry" hidden>重新发起登录</button><a href="/admin/login">使用医院账号登录</a></main>
<script type="module">
import { beginGroupLogin, consumeGroupCallback, exchangeGroupCode, groupLoginDestination } from '/admin/group-sso.mjs'
const settings = { identityOrigin: 'http://127.0.0.1:5173', hospitalOrigin: location.origin, storage: sessionStorage }
const status = document.querySelector('#status')
const retry = document.querySelector('#retry')
let running = false
async function connect() {
if (running) return
running = true
retry.hidden = true
try {
if (location.origin !== 'http://127.0.0.1:8090') throw new Error('仅供固定回环预览')
if (location.search || location.hash) {
const transaction = consumeGroupCallback({ ...settings, url: location.href, history })
status.textContent = '正在安全进入互联网医院…'
const session = await exchangeGroupCode({ ...settings, transaction })
localStorage.setItem('like_admin_token', JSON.stringify({ value: session.token, expire: '' }))
location.replace(groupLoginDestination(session))
} else location.assign(await beginGroupLogin(settings))
} catch {
status.textContent = '本次登录未完成或凭据已过期,请重新进入。'
retry.hidden = false
} finally { running = false }
}
retry.addEventListener('click', connect)
void connect()
</script></body></html>
+106
View File
@@ -0,0 +1,106 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { webcrypto } from 'node:crypto'
import { beginGroupLogin, consumeGroupCallback, exchangeGroupCode, fixedOrigin, groupLoginDestination, GROUP_TRANSACTION_KEY, pkceChallenge } from '../src/utils/groupSso.mjs'
const identityOrigin = 'http://127.0.0.1:5173'
const hospitalOrigin = 'http://127.0.0.1:8090'
const verifier = 'dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk'
function store() {
const values = new Map()
return { getItem: (key) => values.get(key) ?? null, setItem: (key, value) => values.set(key, value), removeItem: (key) => values.delete(key) }
}
async function transaction() {
const storage = store()
const target = new URL(await beginGroupLogin({ identityOrigin, hospitalOrigin, storage, cryptoApi: webcrypto, now: 1000 }))
const history = { state: null, calls: [], replaceState(...args) { this.calls.push(args) } }
const url = new URL('/admin/group-login', hospitalOrigin)
url.search = new URLSearchParams({ code: 'c'.repeat(64), state: target.searchParams.get('state') }).toString()
return { storage, target, history, url }
}
function consume(fixture, overrides = {}) {
return consumeGroupCallback({ ...fixture, url: fixture.url.href, identityOrigin, hospitalOrigin, now: 1500, ...overrides })
}
test('S256 对照 RFC 7636 向量', async () => {
assert.equal(await pkceChallenge(verifier, webcrypto), 'E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM')
})
test('只允许 HTTPS 或回环 HTTP 固定 origin', () => {
assert.equal(fixedOrigin(identityOrigin), identityOrigin)
for (const value of ['http://example.com', identityOrigin + '/bad', identityOrigin + '?redirect=x', 'https://u:p@example.com', 'javascript:alert(1)']) {
assert.throws(() => fixedOrigin(value))
}
})
test('初始化在医院存 verifier,授权 URL 仅有 S256 challenge', async () => {
const fixture = await transaction()
const saved = JSON.parse(fixture.storage.getItem(GROUP_TRANSACTION_KEY))
assert.equal(saved.verifier.length, 43)
assert.equal(saved.state.length, 43)
assert.equal(fixture.target.pathname, '/sso/authorize')
assert.equal(fixture.target.searchParams.get('redirect_uri'), hospitalOrigin + '/admin/group-login')
assert.equal(fixture.target.searchParams.get('code_challenge'), await pkceChallenge(saved.verifier, webcrypto))
assert.equal(fixture.target.href.includes(saved.verifier), false)
})
test('回调同步清 URL 和消费本地事务,不能重放', async () => {
const fixture = await transaction()
const result = consume(fixture)
assert.equal(result.code, 'c'.repeat(64))
assert.equal(fixture.history.calls[0][2], '/admin/group-login')
assert.equal(fixture.storage.getItem(GROUP_TRANSACTION_KEY), null)
assert.throws(() => consume(fixture))
})
test('拒绝错误 state、过期、未来事务、任意 redirect、重复参数和错误医院地址', async () => {
for (const mutate of [
(f) => f.url.searchParams.set('state', 'x'.repeat(43)),
(f) => f.url.searchParams.set('redirect', 'https://example.com'),
(f) => f.url.searchParams.append('code', 'x'.repeat(64)),
(f) => { f.url.pathname = '/admin/login' },
(f) => { f.url.hash = 'unexpected' },
(f) => { const saved = JSON.parse(f.storage.getItem(GROUP_TRANSACTION_KEY)); saved.createdAt = -400000; f.storage.setItem(GROUP_TRANSACTION_KEY, JSON.stringify(saved)) },
(f) => { const saved = JSON.parse(f.storage.getItem(GROUP_TRANSACTION_KEY)); saved.createdAt = 2000; f.storage.setItem(GROUP_TRANSACTION_KEY, JSON.stringify(saved)) }
]) {
const fixture = await transaction()
mutate(fixture)
assert.throws(() => consume(fixture))
assert.equal(fixture.history.calls.length, 1)
assert.equal(fixture.storage.getItem(GROUP_TRANSACTION_KEY), null)
}
})
test('只执行中央/医院两次 POST,不携带旧 token、拒绝响应指定任意兑换地址', async () => {
const fixture = await transaction()
const current = consume(fixture)
const calls = []
const responses = [{ ticket: 't'.repeat(64), exchange_path: '/adminapi/identity.hospitalSso/exchange' }, { token: 'fixture-hospital-session-only', is_paw: 1 }]
const result = await exchangeGroupCode({ transaction: current, identityOrigin, hospitalOrigin, fetcher: async (url, options) => {
calls.push({ url, options }); return { ok: true, json: async () => ({ code: 1, data: responses.shift() }) }
} })
assert.equal(result.is_paw, 1)
assert.equal(calls.length, 2)
assert.equal(calls[0].url, identityOrigin + '/adminapi/group/sso/exchange')
assert.equal(calls[1].url, hospitalOrigin + '/adminapi/identity.hospitalSso/exchange')
assert.equal(calls[0].options.credentials, 'omit')
assert.equal(calls[1].options.credentials, 'same-origin')
assert.equal(calls.every(({ options }) => options.method === 'POST' && options.redirect === 'error' && !options.headers.Authorization && !options.headers.token), true)
let rejectedCalls = 0
await assert.rejects(exchangeGroupCode({ transaction: current, identityOrigin, hospitalOrigin, fetcher: async () => {
rejectedCalls++; return { ok: true, json: async () => ({ code: 1, data: { ticket: 't'.repeat(64), exchange_path: 'https://example.com' } }) }
} }))
assert.equal(rejectedCalls, 1)
})
test('网络失败不重试,首次改密与企微门禁保留', async () => {
const fixture = await transaction()
let count = 0
await assert.rejects(exchangeGroupCode({ transaction: consume(fixture), identityOrigin, hospitalOrigin, fetcher: async () => { count++; throw new Error('fixture offline') } }))
assert.equal(count, 1)
const secondFixture = await transaction()
count = 0
await assert.rejects(exchangeGroupCode({ transaction: consume(secondFixture), identityOrigin, hospitalOrigin, fetcher: async () => {
count++
if (count === 2) throw new Error('fixture hospital offline')
return { ok: true, json: async () => ({ code: 1, data: { ticket: 't'.repeat(64), exchange_path: '/adminapi/identity.hospitalSso/exchange' } }) }
} }))
assert.equal(count, 2)
assert.equal(groupLoginDestination({ is_paw: 0, need_bind_work_wechat: true }), '/admin/change-password')
assert.equal(groupLoginDestination({ is_paw: 1, need_bind_work_wechat: true }), '/admin/bind-work-wechat')
assert.equal(groupLoginDestination({ is_paw: 1 }), '/admin/')
})
+87
View File
@@ -0,0 +1,87 @@
<?php
declare(strict_types=1);
// 仅供回环预览:静态文件来自隔离副本,PHP 只从固定原入口加载。
$project = realpath(__DIR__ . '/../..');
$public = $project . '/server/public';
$preview = $project . '/.test-runtime/hospital-preview/admin';
$path = (string) parse_url($_SERVER['REQUEST_URI'] ?? '', PHP_URL_PATH);
$method = strtoupper($_SERVER['REQUEST_METHOD'] ?? 'GET');
header('Referrer-Policy: no-referrer');
header('X-Content-Type-Options: nosniff');
header('Cache-Control: no-store');
function missing(): never
{
http_response_code(404);
header('Content-Type: application/json; charset=utf-8');
echo '{"code":0,"msg":"接口不存在","data":{}}';
exit;
}
if (!in_array($_SERVER['REMOTE_ADDR'] ?? '', ['127.0.0.1', '::1'], true)
|| !in_array($_SERVER['HTTP_HOST'] ?? '', ['127.0.0.1:8090', 'localhost:8090'], true)
|| array_key_exists('s', $_GET) || preg_match('/[\\\\\x00-\x20\x7f]/', $path)) {
missing();
}
if (in_array($method, ['GET', 'HEAD'], true) && ($path === '/admin' || str_starts_with($path, '/admin/'))) {
if ($path === '/admin/group-login') {
$file = $preview . '/group-login.html';
$type = 'text/html; charset=utf-8';
} elseif ($path === '/admin/group-sso.mjs') {
$file = $preview . '/group-sso.mjs';
$type = 'text/javascript; charset=utf-8';
} elseif (preg_match('~^/admin/(assets/[A-Za-z0-9_.@/-]+|ai-chat-icon\.png)$~D', $path)) {
$file = realpath($preview . substr($path, strlen('/admin')));
$base = realpath($preview);
$normalizedFile = is_string($file) ? str_replace('\\', '/', $file) : '';
$normalizedBase = is_string($base) ? str_replace('\\', '/', $base) . '/' : '';
if (!$file || !$base || !str_starts_with($normalizedFile, $normalizedBase) || !is_file($file)) { missing(); }
$types = ['js' => 'text/javascript', 'mjs' => 'text/javascript', 'css' => 'text/css', 'png' => 'image/png',
'jpg' => 'image/jpeg', 'jpeg' => 'image/jpeg', 'gif' => 'image/gif', 'webp' => 'image/webp', 'svg' => 'image/svg+xml',
'woff' => 'font/woff', 'woff2' => 'font/woff2', 'ttf' => 'font/ttf', 'ico' => 'image/x-icon'];
$type = $types[strtolower(pathinfo($file, PATHINFO_EXTENSION))] ?? null;
if ($type === null) { missing(); }
} elseif (preg_match('~^/admin(?:/[A-Za-z0-9_-]+)*/?$~D', $path)) {
$file = $preview . '/index.html';
$type = 'text/html; charset=utf-8';
} else { missing(); }
if (!is_file($file)) { missing(); }
header('Content-Type: ' . $type);
if ($method !== 'HEAD') { readfile($file); }
exit;
}
// 不透传任意磁盘路径、安装器、测试脚本或 PHP 文件。
if (!in_array($method, ['GET', 'POST', 'OPTIONS'], true)
|| !preg_match('~^/adminapi/[A-Za-z][A-Za-z0-9_.]*/[A-Za-z][A-Za-z0-9_]*$~D', $path)) {
missing();
}
$root = $project . '/server';
if (!is_file($root . '/vendor/autoload.php') || !is_file($root . '/config/install.lock')) {
http_response_code(503);
header('Content-Type: application/json; charset=utf-8');
echo '{"code":0,"msg":"原项目服务尚未配置","data":{}}';
exit;
}
require $root . '/vendor/autoload.php';
$_SERVER['SCRIPT_FILENAME'] = $public . '/index.php';
$_SERVER['SCRIPT_NAME'] = '/index.php';
$_SERVER['PHP_SELF'] = '/index.php';
$_SERVER['PATH_INFO'] = $path;
foreach (['HTTP_X_FORWARDED_HOST', 'HTTP_X_FORWARDED_FOR', 'HTTP_X_REAL_IP'] as $key) { unset($_SERVER[$key]); }
$application = new class($root . DIRECTORY_SEPARATOR) extends think\App {
public function loadEnv(string $envName = ''): void
{
parent::loadEnv($envName);
$this->env->set('APP_DEBUG', false);
$this->env->set('LOCAL_DEBUG_LOGIN_SKIP_PASSWORD', false);
}
};
$application->initialize();
$application->request->setPathinfo(ltrim($path, '/'));
$http = $application->http;
$response = $http->run();
$response->send();
$http->end($response);
@@ -0,0 +1,29 @@
import fs from 'node:fs'
import path from 'node:path'
import { fileURLToPath } from 'node:url'
const project = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..')
const source = path.join(project, 'server/public/admin')
const runtime = path.join(project, '.test-runtime')
const output = path.join(runtime, 'hospital-preview')
const target = path.join(output, 'admin')
const sourceHtml = fs.readFileSync(path.join(source, 'index.html'), 'utf8')
const entryPath = sourceHtml.match(/<script\b[^>]*\bsrc="\/admin\/assets\/([^"/]+\.js)"/i)?.[1]
if (!entryPath) throw new Error('未找到原医院构建入口')
const entry = fs.readFileSync(path.join(source, 'assets', entryPath), 'utf8')
const original = 'baseUrl:"https://admin.zhenyangtang.com.cn//"'
if (entry.split(original).length !== 2) throw new Error('医院公开 API baseUrl 字面量必须恰好出现一次')
fs.mkdirSync(runtime, { recursive: true })
// 只忽略生成物,不修改根 .gitignore 或原发布目录。
const ignoreFile = path.join(runtime, '.gitignore')
if (!fs.existsSync(ignoreFile)) fs.writeFileSync(ignoreFile, '*\n')
fs.cpSync(source, target, { recursive: true, force: true })
fs.writeFileSync(path.join(target, 'assets', entryPath), entry.replace(original, 'baseUrl:"/"'))
// 预览只加载原本地模块;不启动原 HTML 附带的远程客服/音视频脚本及其内联初始化。
const previewHtml = sourceHtml.replace(/<script\b([^>]*)>[\s\S]*?<\/script>/gi, (tag, attrs) =>
/\bsrc="\/admin\/assets\/[^"/]+\.js"/.test(attrs) ? tag : '')
fs.writeFileSync(path.join(target, 'index.html'), previewHtml.replace('<title>后台管理系统</title>', '<title>互联网医院</title>'))
fs.copyFileSync(path.join(project, 'admin/src/utils/groupSso.mjs'), path.join(target, 'group-sso.mjs'))
fs.copyFileSync(path.join(project, 'admin/public/group-login.html'), path.join(target, 'group-login.html'))
if (fs.readFileSync(path.join(target, 'assets', entryPath), 'utf8').includes(original)) throw new Error('本地 API 适配未完成')
process.stdout.write(JSON.stringify({ path: output, entry: entryPath }) + '\n')
+18
View File
@@ -0,0 +1,18 @@
param(
[string]$PhpPath = 'C:\Users\isard\.cache\zyt-tools\php\php.exe'
)
$ErrorActionPreference = 'Stop'
$projectPath = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
if (-not (Test-Path -LiteralPath $PhpPath -PathType Leaf)) { throw 'PHP 可执行文件不存在' }
if (Get-NetTCPConnection -LocalPort 8090 -State Listen -ErrorAction SilentlyContinue) { throw '8090 端口已占用,未停止任何进程' }
& node (Join-Path $PSScriptRoot 'prepare-hospital-preview.mjs')
if ($LASTEXITCODE -ne 0) { throw '医院预览准备失败' }
$runtimePath = Join-Path $projectPath '.test-runtime\hospital-preview'
$routerPath = Join-Path $PSScriptRoot 'hospital-preview-router.php'
$publicPath = Join-Path $projectPath 'server\public'
$arguments = @('-S', '127.0.0.1:8090', '-t', ('"' + $publicPath + '"'), ('"' + $routerPath + '"'))
# 隐藏控制台,不将 PHP 请求日志重定向到文件,避免保存回调 URL 中的短码。
$process = Start-Process -FilePath $PhpPath -ArgumentList $arguments -WorkingDirectory (Join-Path $projectPath 'server') -WindowStyle Hidden -PassThru
$state = [ordered]@{ pid = $process.Id; port = 8090; path = $runtimePath }
$state | ConvertTo-Json | Set-Content -LiteralPath (Join-Path $runtimePath 'status.json') -Encoding utf8
$state | ConvertTo-Json
+32
View File
@@ -0,0 +1,32 @@
import fs from 'node:fs'
import path from 'node:path'
import { fileURLToPath } from 'node:url'
const project = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..')
const base = 'http://127.0.0.1:8090'
const callback = await fetch(base + '/admin/group-login')
const callbackText = await callback.text()
if (callback.status !== 200 || !callbackText.includes('集团账号登录') || !callbackText.includes('/admin/group-sso.mjs')) throw new Error('医院回调入口验证失败')
const moduleResponse = await fetch(base + '/admin/group-sso.mjs')
if (moduleResponse.status !== 200 || !(moduleResponse.headers.get('content-type') || '').includes('javascript')) throw new Error('医院登录模块验证失败')
const page = await fetch(base + '/admin/')
const html = await page.text()
if (!html.includes('<title>互联网医院</title>') || /<script[^>]+src="https?:/i.test(html)) throw new Error('预览标题或远程脚本边界验证失败')
const asset = html.match(/<script\b[^>]*\bsrc="(\/admin\/assets\/[^"/]+\.js)"/i)?.[1]
if (!asset) throw new Error('未找到预览入口模块')
const bundle = await (await fetch(base + asset)).text()
if (!bundle.includes('baseUrl:"/"') || bundle.includes('baseUrl:"https://admin.zhenyangtang.com.cn//"')) throw new Error('预览 API 地址验证失败')
const paths = ['/test.php', '/admin/assets/anything.php', '/install/install.php', '/admin/group-login?s=auth.admin/mySelf']
for (const route of paths) {
if ((await fetch(base + route)).status !== 404) throw new Error('静态路径或兼容路由未被拒绝')
}
const denied = await (await fetch(base + '/adminapi/auth.admin/mySelf')).json()
if (denied.code === 1) throw new Error('未认证 API 意外放行')
const original = fs.readFileSync(path.join(project, 'server/public' + asset), 'utf8')
if (!original.includes('baseUrl:"https://admin.zhenyangtang.com.cn//"')) throw new Error('原发布产物发生修改')
const runtime = path.join(project, '.test-runtime/hospital-preview')
if (['php.stdout.log', 'php.stderr.log'].some((name) => fs.existsSync(path.join(runtime, name)))) throw new Error('预览不应生成持久化请求日志')
const state = JSON.parse(fs.readFileSync(path.join(runtime, 'status.json'), 'utf8').replace(/^\uFEFF/, ''))
if (Object.keys(state).sort().join(',') !== 'path,pid,port') throw new Error('启动状态包含额外字段')
fs.writeFileSync(path.join(project, 'artifacts/iam-extraction/hospital-preview-status.json'), JSON.stringify(state, null, 2) + '\n')
process.stdout.write('医院预览验证通过:回调/模块/首页 200,本地 API,4 条危险路径 404,未认证拒绝,无请求日志,原产物未改。\n')
+1 -1
View File
@@ -1,6 +1,6 @@
const config = {
terminal: 1, //终端
title: '后台管理系统', //网站默认标题
title: '互联网医院', //网站默认标题
version: '1.9.4', //版本号
baseUrl: `${import.meta.env.VITE_APP_BASE_URL || ''}/`, //请求接口域名
urlPrefix: 'adminapi', //请求默认前缀
+1 -1
View File
@@ -81,7 +81,7 @@ const defaultPath = PageEnum.INDEX
const changePasswordPath = '/change-password'
const bindWorkWechatPath = '/bind-work-wechat'
// 免登录白名单
const whiteList: string[] = [PageEnum.LOGIN, PageEnum.ERROR_403]
const whiteList: string[] = [PageEnum.LOGIN, PageEnum.ERROR_403, '/group-login']
router.beforeEach(async (to, from, next) => {
document.title = to.meta.title ?? config.title
const userStore = useUserStore()
+5
View File
@@ -35,6 +35,11 @@ export const constantRoutes: Array<RouteRecordRaw> = [
path: PageEnum.LOGIN,
component: () => import('@/views/account/login.vue')
},
{
path: '/group-login',
component: () => import('@/views/account/GroupLogin.vue'),
meta: { title: '集团账号登录 · 互联网医院', hidden: true, hideTab: true }
},
{
path: '/change-password',
component: () => import('@/views/account/change-password.vue')
+11
View File
@@ -0,0 +1,11 @@
export interface HospitalSession { token: string; is_paw?: number; need_bind_work_wechat?: boolean; [key: string]: unknown }
export interface GroupTransaction { code: string; verifier: string; redirectUri: string }
export const GROUP_CLIENT_ID: string
export const GROUP_TRANSACTION_KEY: string
export function fixedOrigin(value: string): string
export function callbackUri(origin: string): string
export function pkceChallenge(verifier: string, cryptoApi?: Crypto): Promise<string>
export function beginGroupLogin(options: { identityOrigin: string; hospitalOrigin: string; storage: Storage; cryptoApi?: Crypto; now?: number }): Promise<string>
export function consumeGroupCallback(options: { url: string; history: History; storage: Storage; identityOrigin: string; hospitalOrigin: string; now?: number }): GroupTransaction
export function exchangeGroupCode(options: { transaction: GroupTransaction; identityOrigin: string; hospitalOrigin: string; fetcher?: typeof fetch }): Promise<HospitalSession>
export function groupLoginDestination(session: HospitalSession): string
+111
View File
@@ -0,0 +1,111 @@
// 集团登录只交换短时凭据;原业务 token 不进入 URL 或 sessionStorage。
export const GROUP_CLIENT_ID = 'internet-hospital'
export const GROUP_TRANSACTION_KEY = 'zyt_hospital_group_sso_v1'
const TRANSACTION_TTL = 5 * 60 * 1000
const CALLBACK_PATH = '/admin/group-login'
const HOSPITAL_EXCHANGE = '/adminapi/identity.hospitalSso/exchange'
const safeValue = /^[A-Za-z0-9_-]{24,512}$/
export function fixedOrigin(value) {
const url = new URL(value)
const loopback = ['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname)
if ((url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) ||
url.username || url.password || url.pathname !== '/' || url.search || url.hash) {
throw new Error('集团登录地址配置无效')
}
return url.origin
}
export function callbackUri(origin) {
return fixedOrigin(origin) + CALLBACK_PATH
}
function base64url(bytes) {
return btoa(String.fromCharCode(...bytes)).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')
}
export async function pkceChallenge(verifier, cryptoApi = globalThis.crypto) {
if (!/^[A-Za-z0-9_-]{43,128}$/.test(verifier)) throw new Error('登录事务无效,请重新发起')
return base64url(new Uint8Array(await cryptoApi.subtle.digest('SHA-256', new TextEncoder().encode(verifier))))
}
export async function beginGroupLogin({ identityOrigin, hospitalOrigin, storage, cryptoApi = globalThis.crypto, now = Date.now() }) {
const identity = fixedOrigin(identityOrigin)
const redirectUri = callbackUri(hospitalOrigin)
const verifier = base64url(cryptoApi.getRandomValues(new Uint8Array(32)))
const state = base64url(cryptoApi.getRandomValues(new Uint8Array(32)))
const challenge = await pkceChallenge(verifier, cryptoApi)
storage.setItem(GROUP_TRANSACTION_KEY, JSON.stringify({ verifier, state, redirectUri, identity, createdAt: now }))
const target = new URL('/sso/authorize', identity)
target.search = new URLSearchParams({ client_id: GROUP_CLIENT_ID, redirect_uri: redirectUri, state,
code_challenge: challenge, code_challenge_method: 'S256' }).toString()
return target.href
}
// 必须在任何 await/网络请求之前调用,URL 的所有回调参数一并清除。
export function consumeGroupCallback({ url, history, storage, identityOrigin, hospitalOrigin, now = Date.now() }) {
const current = new URL(url)
const expected = callbackUri(hospitalOrigin)
history.replaceState(history.state, '', CALLBACK_PATH)
const raw = storage.getItem(GROUP_TRANSACTION_KEY)
storage.removeItem(GROUP_TRANSACTION_KEY)
if (current.origin + current.pathname !== expected || current.hash ||
[...current.searchParams.keys()].some((key) => !['code', 'state', 'error'].includes(key)) ||
['code', 'state', 'error'].some((key) => current.searchParams.getAll(key).length > 1)) {
throw new Error('登录回调地址无效,请重新发起')
}
if (current.searchParams.has('error')) throw new Error('集团登录未完成,请返回集团后台重试')
let transaction
try { transaction = JSON.parse(raw || 'null') } catch { /* 统一按无效事务处理。 */ }
const code = current.searchParams.get('code') || ''
const state = current.searchParams.get('state') || ''
if (!transaction || !safeValue.test(code) || !safeValue.test(state) || state !== transaction.state ||
!/^[A-Za-z0-9_-]{43,128}$/.test(transaction.verifier || '') ||
transaction.identity !== fixedOrigin(identityOrigin) || transaction.redirectUri !== expected ||
!Number.isSafeInteger(transaction.createdAt) || now < transaction.createdAt || now - transaction.createdAt > TRANSACTION_TTL) {
throw new Error('登录状态已失效或不属于当前浏览器,请重新发起')
}
return { code, verifier: transaction.verifier, redirectUri: expected }
}
async function postOnce(fetcher, url, body, credentials) {
const controller = new AbortController()
const timeout = setTimeout(() => controller.abort(), 20000)
try {
const response = await fetcher(url, { method: 'POST', credentials, redirect: 'error', cache: 'no-store',
referrerPolicy: 'no-referrer', headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
body: JSON.stringify(body), signal: controller.signal })
if (!response.ok) throw new Error('登录交接未完成,请重新发起')
const envelope = await response.json()
if (envelope?.code !== 1 || !envelope.data || typeof envelope.data !== 'object') {
throw new Error('登录交接未完成,请重新发起')
}
return envelope.data
} finally { clearTimeout(timeout) }
}
export async function exchangeGroupCode({ transaction, identityOrigin, hospitalOrigin, fetcher = globalThis.fetch }) {
const identity = fixedOrigin(identityOrigin)
const hospital = fixedOrigin(hospitalOrigin)
if (transaction.redirectUri !== callbackUri(hospital) || !safeValue.test(transaction.code || '') ||
!/^[A-Za-z0-9_-]{43,128}$/.test(transaction.verifier || '')) throw new Error('登录回调地址无效')
const issued = await postOnce(fetcher, identity + '/adminapi/group/sso/exchange', {
client_id: GROUP_CLIENT_ID, redirect_uri: transaction.redirectUri,
code: transaction.code, code_verifier: transaction.verifier
}, 'omit')
if (!safeValue.test(issued.ticket || '') || issued.exchange_path !== HOSPITAL_EXCHANGE) {
throw new Error('医院登录凭据无效,请重新发起')
}
const session = await postOnce(fetcher, hospital + HOSPITAL_EXCHANGE,
{ ticket: issued.ticket, code_verifier: transaction.verifier }, 'same-origin')
if (typeof session.token !== 'string' || session.token.length < 16 || session.token.length > 2048 || /[\x00-\x20\x7f]/.test(session.token)) {
throw new Error('医院登录响应无效,请重新发起')
}
return session
}
export function groupLoginDestination(session) {
if (Number(session.is_paw) === 0) return '/admin/change-password'
if (session.need_bind_work_wechat) return '/admin/bind-work-wechat'
return '/admin/'
}
+52
View File
@@ -0,0 +1,52 @@
<script setup lang="ts">
import { onMounted, ref } from 'vue'
import { TOKEN_KEY } from '@/enums/cacheEnums'
import useUserStore from '@/stores/modules/user'
import { clearAuthInfo } from '@/utils/auth'
import cache from '@/utils/cache'
import { beginGroupLogin, consumeGroupCallback, exchangeGroupCode, groupLoginDestination } from '@/utils/groupSso.mjs'
const localOrigin = ['127.0.0.1', 'localhost', '[::1]'].includes(window.location.hostname)
const identityOrigin = String(import.meta.env.VITE_GROUP_IDENTITY_URL || (localOrigin ? 'http://127.0.0.1:5173' : ''))
const message = ref('正在连接集团账号…')
const failed = ref(false)
let running = false
async function connect() {
if (running) return
running = true
failed.value = false
try {
const options = { identityOrigin, hospitalOrigin: window.location.origin, storage: sessionStorage }
if (window.location.search || window.location.hash) {
const transaction = consumeGroupCallback({ ...options, url: window.location.href, history: window.history })
message.value = '正在安全进入互联网医院…'
const session = await exchangeGroupCode({ ...options, transaction })
clearAuthInfo()
const user = useUserStore()
user.token = session.token
user.isPaw = session.is_paw ?? 1
cache.set(TOKEN_KEY, session.token)
window.location.replace(groupLoginDestination(session))
} else {
window.location.assign(await beginGroupLogin(options))
}
} catch {
message.value = '本次登录未完成或凭据已过期,请重新进入。'
failed.value = true
} finally { running = false }
}
onMounted(connect)
</script>
<template>
<main class="group-login"><section>
<span class="group-label">甄养堂集团</span><h1>互联网医院</h1><p role="status">{{ message }}</p>
<button v-if="failed" type="button" @click="connect">重新发起登录</button>
<a href="/admin/login">使用医院账号登录</a>
</section></main>
</template>
<style scoped>
.group-login{min-height:100vh;display:grid;place-items:center;background:#f3f7f6;color:#183d37;padding:24px}.group-login section{width:min(440px,100%);padding:44px;background:white;border:1px solid #dce8e4;border-radius:20px;box-shadow:0 16px 56px #163d3710}.group-label{font-size:13px;letter-spacing:3px;color:#6e817c}.group-login h1{font-size:30px;margin:20px 0}.group-login p{line-height:1.8;color:#60736e}.group-login button{display:block;width:100%;margin:24px 0 20px;padding:13px;border:0;border-radius:9px;background:#176453;color:white;cursor:pointer}.group-login a{display:block;margin-top:24px;color:#176453;font-size:14px}
</style>
+49
View File
@@ -0,0 +1,49 @@
# 独立账号权限项目实施约定
目录:`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`。
@@ -0,0 +1,19 @@
{
"account": "cs",
"source_admin_id": 117,
"kefu_user_id": 5,
"provider": "zyt_group",
"company_id": 2,
"gid_matches": true,
"role_code": "zyt_basic",
"role_name": "集团基础用户",
"active": true,
"effective_permission_count": 0,
"signed_group_metadata_verified": true,
"signed_group_authorization_options_verified": true,
"catalog_permissions": 65,
"login_audit": "login.group",
"login_time_utc": "2026-11-04T07:24:15+00:00",
"login_form_request": "POST /api/v2/auth/login 200",
"authorization_modified": false
}
@@ -0,0 +1,19 @@
# cs 登录只读验收契约(2026-11-04)
“cs 已登录”不能单独证明 Group 身份。以下为本地代码契约;未连接线上、读取数据库或真实凭据、执行测试,也未调整权限。
| 核对项 | 只读判定 |
| --- | --- |
| 本地 cs | 普通登录先尝试本地密码。用户列表对应行为 `username=cs`、`identity_source=local`、`source_account=''`。 |
| Group 的 cs | 列表行为 `identity_source=zyt_group`、`source_account=cs`;客服用户名为 `zyt_` 加 GID 去掉 `gid_` 的部分,冲突时加后缀。绑定依据 `(provider=zyt_group,gid)`,不按同名合并。用当前 `/api/v2/me.id` 对应这条用户。 |
| 会话限制 | `/me` 只有 `id/username/role/must_change_password/permissions/display_name`,无 provider/source_account 等来源字段。用户列表需已有 `user:read` 或 `desktop-account:assign`;可由现有管理员查看,或比对 Group DTO 的 `user.id/username`,不为核验给 cs 加权限。 |
首次 Group 绑定为启用的 `zyt_basic`(集团基础用户),无需改密,有效 `permissions=[]`。该角色初始化会清空权限,禁止授予非空权限;已有绑定会保留当前客服角色,不能仅凭再次登录推定仍为基础角色。
基础用户应落在 `/group/welcome`,保留“我的账号 → 账号与授权”,显示“当前角色:集团基础用户”和尚未获得业务权限的提示;业务菜单、自定义菜单为空。前端 `roles` 使用 `/me.permissions`,任何没有 `stats:read` 的用户都默认进入欢迎页,故此页不能证明 Group 来源。
Group 只读 DTO 应为 `client_id=kefu/application_name=企微客服/status=ok`;`source_admin_id` 对应所选 cs 员工、`gid` 对应该员工既有 GID、`company_id` 对应客服公司,服务端严格比较这三项。`user.id/username` 对应当前 `/me`,`source_account=cs/source_name=员工姓名`。基础用户还需 `active=true/role.code=zyt_basic/role.name=集团基础用户/permissions=[]/permission_details=[]`;页面显示对应角色、启用状态、客服账号与“当前没有有效权限”。
verified metadata 还需 HTTP 200、响应 HMAC 验签与严格 DTO 校验:`version=1/client_id=kefu`,`generated_at` 与请求时间相差不超过 90 秒,GID 唯一且对应请求。展示 `synced_at` 是查询时间,无需等于 `generated_at`。权限与 `/me` 使用同一读取器,目录 `enabled` 不改变有效授权。查询不建绑定;`not_enrolled/not_configured/503` 均不能以同名本地 cs 代替成功结果。
依据:[登录](C:/kefu/wechat_rpa/admin_api.py:750)、[绑定](C:/kefu/wechat_rpa/admin_backend.py:2765)、[权限](C:/kefu/wechat_rpa/rbac.py:273)、[前端](C:/kefu/admin-web/apps/web-antd/src/api/core/user.ts:25)、[验签](C:/zyt/identity-admin/server/app/service/group/KefuMetadataClient.php:47)、[展示 DTO](C:/zyt/identity-admin/server/app/service/group/KefuApplicationService.php:24)。
@@ -0,0 +1,114 @@
# 原库四类数据只读基线
采集时间(UTC):2026-10-30T05:38:46+00:00
**范围:此报告是原数据库基线及 SourceMapper 静态/进程内映射检查,不代表已完成实际账号登录、页面或 API 对比。**
脚本在 PHP 进程内读取原项目数据库配置,使用 `START TRANSACTION READ ONLY`,事务内仅执行 `SHOW COLUMNS` 和 `SELECT`,最后回滚。没有启动原应用,没有读取任何会话/token,没有登录或借用管理员身份,没有写入业务数据。
不查询、不保存个人姓名、账号、手机号、部门联系人、密码/hash、会话或 token。表的姓名/账号等字符串由合成占位值用于映射结构检查;因此这些实际值未被验证。
## 数量与状态
| 表 | 未软删 | 已软删 | 启用 | 停用 | 非0/1状态 |
|---|---:|---:|---:|---:|---:|
| admin | 212 | 7 | 97 | 115 | 0 |
| system_role | 10 | 0 | 不适用 | 不适用 | 0 |
| system_menu | 410 | 0 | 410 | 0 | 0 |
| dept | 30 | 24 | 30 | 0 | 0 |
启用口径:`admin.disable=0`;`system_menu.is_disable=0`;`dept.status=1`。`system_role` 原模型/列表无停用字段,SourceMapper 固定补 `disable=0`,不能解释为原库存在可停用角色。菜单模型不使用软删除;若表无 delete_time,未软删数量即全表数量。
## 可重复的规范摘要
JSON 用固定字段顺序,整型字段转 PHP int,按 id 升序后 SHA-256。规范字段排除所有真实姓名、账号、手机号及自由文本;只输出摘要,不保存逐行原值。
| 表 | 规范字段(固定顺序) | SHA-256 |
|---|---|---|
| admin | `id,root,disable,create_time` | `063397ad855689514093675155a4858958925b504ea0ec0d8dd6b6bc6b5aadb8` |
| system_role | `id,sort,data_scope,create_time` | `3e67ba461ca351083582359bb3389accc7fdafb79e8f3b7a2e905ed55de7c1fc` |
| system_menu | `id,pid,type,sort,is_disable,is_show,is_cache` | `809f83b1f8f801031b5ab2c4693458729b0b808d2f0713fe2d4ba44ebc2a2715` |
| dept | `id,pid,sort,status` | `3267b7c4fdc915c0855dd937ec0dc5124c78630a4200cfa542755e7c0ccc2e59` |
## 关系完整性
检查涉及四类实体的三种关系;关系按左ID、右ID升序,重复行保留。缺失端点优先计入「端点不存在」,仅两端实际存在但至少一端软删计入「仅端点软删」,二者互斥。
| 关系表 | 总行数 | 两端未删有效 | 端点不存在 | 仅端点软删 | 无效总数 | 重复对额外行 |
|---|---:|---:|---:|---:|---:|---:|
| admin_role | 224 | 216 | 8 | 0 | 8 | 0 |
| admin_dept | 194 | 194 | 0 | 0 | 0 | 0 |
| system_role_menu | 812 | 812 | 0 | 0 | 0 | 0 |
- `admin_role(admin_id,role_id)` SHA-256:`9794cf784882829331351fed0a724d4d5f9658e29638fb2b6dbb7e0c0350337f`
- `admin_dept(admin_id,dept_id)` SHA-256:`7cb6e9abd183e055f9723978d4d5755f66b6511eb043f735d63b6e502d58fe29`
- `system_role_menu(role_id,menu_id)` SHA-256:`8a79fe8ee4852a4085704ec0b96f9d5f31ab7035539b8d664c99291591b7044c`
原 `AdminLists` 的 role_id/dept_id 访问器直接读关联表,不自动排除软删目标。原 `RoleLists.num` 直接计算 admin_role 行数,也不排除软删账号。原部门 admin_count 则排除软删账号,并累加直属和全部下级的关联行数;同一账号跨部门出现可能多次计数,不能改作全子树 DISTINCT 人数后再宣称相等。
## 树完整性
| 表 | pid=0根 | 父节点缺失的孤儿 | 环数 | 环上节点 | 自指 | 可达根节点数 | 最大根路径深度 |
|---|---:|---:|---:|---:|---:|---:|---:|
| system_menu | 23 | 0 | 0 | 0 | 0 | 410 | 4 |
| dept | 1 | 0 | 0 | 0 | 0 | 30 | 4 |
孤儿按「pid非0且父ID不在未软删实体集合」统计;环按同一组环节点去重,包含自环。深度包含节点自身。原部门树以最小 pid 为起点,菜单树通常以 pid=0 为起点;只有可达节点才能在实际树响应出现,故数据库总行数不能直接等同页面可见数。
## SourceMapper 进程内比较
从本次只读快照构造原列表的非敏感字段/关系ID,再调用实际 SourceMapper 并反向规范化字段。这里没有请求 API。
| 比较项 | 已比较记录 | 不一致记录 |
|---|---:|---:|
| admin_fields | 212 | 0 |
| admin_role_ids | 212 | 0 |
| admin_dept_ids | 212 | 0 |
| role_fields | 10 | 0 |
| role_menu_ids | 10 | 0 |
| role_user_count | 10 | 0 |
| menu_fields | 410 | 0 |
| dept_fields | 30 | 0 |
| dept_rollup_count | 30 | 0 |
字段映射规则:`root → is_root`、`is_disable → disable`、`status → 1-disable`;角色原字段保留,补充的 disable 是固定值。角色/部门展示串由 names() 保留完整字符串,避免以斜线拆分引入名称歧义。
菜单管理的 tree() 保留原节点 ID、父ID与子树结构。导航 navigation() 会有意重写入口名称、父ID、路由、组件并把 dept.dept/lists 别名映射为 auth.dept/lists,且筛选四个管理入口,不能拿导航列表作为全菜单一致性证据。
当前映射只覆盖独立后台需要的字段,并非原 API 全字段无损镜像:AdminLists 还提供 jobs_id/jobs_name、login_time/login_ip、multipoint_login、avatar 与医生资料等;用户映射省略这些;部门映射省略原时间戳、status_desc、level(保留树 children);菜单映射省略原时间戳;原角色字段均保留并额外补状态。全字段比较必须先明确预期字段集合,不能把这些有意投影差异报告成数据丢失。
未验证实际字符串值:真实姓名、账号、角色名称/说明、菜单名称/路由/权限字符串、部门联系人/手机号未参与本次查询或摘要。SourceMapper 对字符串主要透传/类型转换的检查来自源码阅读,不能代替实际 API 比较。
## 必须处理与后续验证
- 本次非敏感字段/关系映射不一致数:0。在本次已验证投影范围内未发现必须修复的 SourceMapper 字段映射问题。
- 树环数:0;关系重复额外行数:0。当前关系数据未触发 ids() 去重导致的多重性损失。
- 历史无效引用应与原 API 的实际呈现口径核对;不能为得到相同数量而擅自清理、迁移或修补业务数据。
- 必须继续使用用户实际提供的原项目账号正常登录,逐页读取原/独立后台的四类 API 并按 ID、状态、字段及关系对比,核验权限导致的可见范围、分页和树可达性;本报告没有执行该步骤。
源码依据:`server/app/adminapi/lists/auth/AdminLists.php`、`RoleLists.php`、`MenuLists.php`;`server/app/adminapi/logic/dept/DeptLogic.php`;相关原模型;`identity-admin/server/app/service/shared/SourceMapper.php`、`SharedRecordsService.php`。
## UI 可见字段摘要与无效关联细化
采集时间(UTC):2026-10-30T05:41:19+00:00
只读脚本 `identity-admin/.test-runtime/consistency-ui-baseline.php` 独立查询原表,按四个实际 Vue 页面可见字段生成 `ui-expected-hashes.json`;不调用 SourceMapper,不读取会话或密码,不登录、不写业务数据。实际字符串仅驻留进程内,输出只有记录ID、SHA-256、schema与数量。
摘要数量:用户 212;角色 10;菜单 410;部门 30。这些是数据库期望摘要,尚需与真实登录后的 DOM 比较。
已核实:Departments.vue 无人数列;Menus.vue 的 A 类型实际标签为「按钮」,A 的路径/权限第一行直接显示 perms,空值不补「—」。期望摘要遵循实际 Vue。角色 scopeLabels 直接从 Roles.vue 读取。用户关系名称按原模型访问器无 ORDER BY 的关联查询顺序拼接,保留原 AdminLists 的斜线拼接和 trim 规则。
以下只列非个人信息的关联 ID。物理缺失判断覆盖原实体全表(包含软删记录),因此可与单纯软删区别。
| admin_id(组合主键之一) | role_id(组合主键之二) | 缺失端点 |
|---:|---:|---|
| 2 | 1 | admin |
| 3 | 1 | admin |
| 4 | 1 | admin |
| 5 | 1 | admin |
| 5 | 2 | admin |
| 6 | 2 | admin |
| 7 | 2 | admin |
| 8 | 2 | admin |
物理缺失关联总行数:8;缺 admin 端:8;缺 system_role 端:0;两端都缺:0。未修改或清理这些历史记录。
@@ -0,0 +1,55 @@
# 原项目账号与独立后台数据核对
核对时间:2026-10-30 13:43(Asia/Singapore)。
结论:沿用浏览器中已正常登录的原项目 `admin` 会话,identity-admin 显示“原项目共享数据”。四类列表的已展示字段、全部角色菜单授权、菜单父子 ID 与部门祖先路径均与原库一致。
本次为真实页面只读核对,未提交新的登录请求,未读取浏览器 token、服务器会话或密码,未修改业务记录。角色授权对话框仅打开查看并取消退出。
| 核对对象 | 原库未软删数量 | 实际页面读取数量 | 结果 |
|---|---:|---:|---|
| 用户 | 212 | 212(50/50/50/50/12,共 5 页) | 字段摘要完全一致 |
| 角色 | 10 | 10 | 字段摘要完全一致 |
| 菜单 | 410 | 410 | 字段摘要、410 对父子 ID 完全一致 |
| 部门 | 30 | 30 | 字段摘要、完整祖先路径完全一致 |
用户启用 97 人、停用 115 人,与原库一致。全部 10 个角色已逐一查看授权树,实际勾选的原菜单 ID 集合与 `system_role_menu` 逐角色完全一致,共 812 项关联。
## 核对方法和字段
原库通过独立 SQL 在只读事务内生成期望摘要,未调用 identity-admin 的 SourceMapper。页面通过正常已登录会话加载,再从 DOM 读取实际渲染结果。逐行使用 SHA-256 比较,按多重集保留重复项,不依赖排序。原始姓名、账号等字符串仅在比较进程内临时使用,摘要文件不保存原文。
- 用户:姓名、账号、角色展示名称、部门展示名称、启停状态。全部分页均已读取。
- 角色:名称、说明、授权数量、排序、数据范围;另从每个角色授权树的 DOM `data-key` 和选中状态读取实际原菜单 ID。
- 菜单:名称、类型、路由/权限两行、排序、导航显示状态、启停状态;另从完整授权树读取原菜单 ID 与父 ID。
- 部门:名称、排序、启停状态;另从全部展开的表行还原深度与根到父节点的完整名称路径,防止仅数量和同名节点造成误判。
字段规则按原列表与页面约定:用户角色和部门名称保留原项目斜线拼接;原部门 `status=1` 显示启用;原菜单 `is_disable=0` 显示启用;原角色没有停用字段。菜单管理展示完整 410 条数据,侧栏四个管理入口属于导航投影。
本报告覆盖上述列表字段和关系,不代表原系统所有字段的全量镜像校验。用户创建时间、岗位、头像、医生资料、登录日志等未展示或非本次关注字段没有参与本次 DOM 对比,也没有执行增删改或密码修改测试。
## 原库历史关联问题
原库 `admin_role` 共 224 条关联,216 条两端有效,8 条指向物理上已不存在的用户;没有缺失角色端。这是原库已有数据,本次保持原样,四类管理列表未因此出现额外或遗漏记录。
| 不存在的 admin_id | role_id |
|---:|---:|
| 2 | 1 |
| 3 | 1 |
| 4 | 1 |
| 5 | 1 |
| 5 | 2 |
| 6 | 2 |
| 7 | 2 |
| 8 | 2 |
菜单、部门无孤儿或环;用户部门和角色菜单关系无无效引用。原角色成员数量统计包含历史关联行,不能将它直接当作有效用户去重人数。
## 本地核对证据
- `identity-admin/.test-runtime/ui-expected-hashes.json`:独立原库字段摘要与角色授权 ID。
- `identity-admin/.test-runtime/tree-expected-hashes.json`:原库菜单 ID/父 ID 和部门路径摘要。
- `identity-admin/.test-runtime/ui-observed-hashes.json`:真实已登录页面的摘要、分页记录、角色授权 ID 和层级信息。
- `identity-admin/.test-runtime/ui-consistency-result.json`:全部列表、角色授权、树结构的比较结果,均为一致。
- `identity-admin/.test-runtime/compare-consistency.mjs`:保留多重集的比较脚本。
- `artifacts/iam-extraction/data-consistency-baseline.md`:原库完整性基线及范围说明。
@@ -0,0 +1,35 @@
# 部门、菜单功能优先导航交付
日期:2026-10-30。本次按用户最新纠正,将“部门管理”和“菜单管理”分别作为一级菜单,公司是各功能下的直接子项。
后续修订:新公司现已可独立维护部门和菜单,不再只显示未接入空态;最新行为见 [新公司结构交付](native-company-structure-delivery.md)。本报告其余内容保留导航调整时刻的验收记录。
## 当前结构
```text
部门管理
甄养堂互联网医院 → 该公司的部门树
菜单管理
甄养堂互联网医院 → 该公司的业务菜单、页面与按钮权限
```
后续公司加入当前账号可见的公司列表后,会出现在两个功能下面。用户管理、角色管理为一级入口;集团工作台、公司管理、公司成员继续保留。公司选择放在页面内,面包屑按功能、公司排列。
## 数据与权限
- `/system/depts?company_id=ID`、`/system/menus?company_id=ID` 保存公司范围。非法、重复及不可见公司参数被拒绝,缺省参数补齐当前有效公司。
- 功能入口依赖原有效菜单和原接口读取权限,保留源菜单 ID、路径、组件、权限与授权记录。隐藏与停用仍遵循原有语义。
- 当前只有医院公司接入原业务目录。其他公司可显示入口和相应空状态;不请求医院目录、不显示写入入口,写入方法也检查公司资格。公司节点是集团导航结构,不保存为医院部门或业务菜单记录。
- 异步表单校验和删除确认后再次检查公司范围,避免切换公司后继续提交旧表单。既有 HTTP 请求范围隔离继续生效。
- 本次未创建公司、保存业务菜单、修改部门或授予角色权限。
## 验证
1. 全套前端回归 22 项通过,其中新增 9 项覆盖功能一级、公司二级、只读授权、隐藏/禁用语义、公司参数、未接入公司隔离、页内切换和独立模式兼容。
2. `vue-tsc --noEmit` 通过;Vite 生产构建通过,仍有既有主包体积提示。
3. 真实浏览器沿用原 admin 会话,依次点击“部门管理 → 甄养堂互联网医院”和“菜单管理 → 甄养堂互联网医院”,实际渲染分别为 30 个部门、410 条菜单;激活项为对应功能下的公司节点。菜单公司链接直接访问并刷新后正确显示菜单管理。
4. 截图:[部门管理](function-first-departments.jpg)、[菜单管理](function-first-menus.jpg)。浏览器验证仅做导航和读取,没有保存真实业务表单。
此前测试账号任务仍以 [test-account-progress.json](test-account-progress.json) 的独立记录为准。本轮未代填密码、未保存该账号,也未把原 admin 会话当作测试账号的登录验收。
实现契约:[function-first-navigation.md](function-first-navigation.md);独立验证:[function-first-validation.md](function-first-validation.md)。
Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

@@ -0,0 +1,25 @@
# 功能优先导航与公司路由契约
本次仅调整集团导航、公司页面范围和路由守卫。未改动登录 token、会话实现、权限数据及原业务记录,也未执行真实登录。
## 文件
- `identity-admin/web/src/router/index.ts`:集团功能模块导航、动态路由注册、公司 query 校验及请求范围切换。
- `identity-admin/web/src/layout/Shell.vue`:移除全局公司选择器与切换逻辑,调整面包屑、导航高亮与模块空壳渲染。
- `identity-admin/web/src/components/NavigationMenu.vue`:公司子项用完整含 query 的路径作为菜单索引和路由目标。
## 页面与权限契约
- 集团模式的一级菜单为部门管理、菜单管理;各模块下直接列出当前账号可见的公司,目标分别为 `/system/depts?company_id=ID` 和 `/system/menus?company_id=ID`。首页和集团管理保留;用户、角色及其他已授权功能展平为一级功能叶。独立模式保留原菜单层级。
- 集团模块使用原始有效菜单、受支持组件、组件读取权限和菜单自身权限注册,保留原 `meta.menuId` 和 `meta.permission`。禁用祖先会阻断后代;隐藏菜单可有授权路由但不出现在导航中。
- 部门、菜单模块的集团路由使用规范路径,分别带 `meta.companyModule = 'departments'` / `'menus'`。空公司、停用公司、未获应用资格的公司只保留已经授权的这两个模块壳,其他动态目录功能不注册。
- 模块页面负责在 `group.directoryAvailable === false` 时显示空态并阻断读取和写入目录 API;本文件不扩展该公司的业务目录能力。
- `resolveCompanyId(value, companies, currentCompanyId, defaultCompanyId)` 是导出的纯函数:显式值必须为单字符串正整数字面量、安全整数且包含在可见公司列表中。数组、空值、未知 ID 等返回 `null`,不能回退。缺少参数时依次使用仍可见的当前公司、默认公司、首个可见公司。
- 模块守卫先验证授权与公司,再调用 `selectCompany` 设置请求头范围,随后同步动态路由。缺少 `company_id` 的旧书签会补全 query;显式无效公司返回 403。没有目录资格时其他 `/system/*` 仍返回 403。
- 页面级公司选择器应以同路径、更新 `company_id` 的 `router.push` 切换模块;守卫负责切换 store 和 HTTP 公司范围。Shell 用路径与公司 ID 作为组件 key,切换后重新挂载页面;当前高亮使用 `path?company_id=ID`,面包屑先显示功能再显示公司。
## 验证
- 已读取项目根 `AGENTS.md` 和 `CLAUDE.md`;当前工作区不存在 `.trellis/`,未执行缺失的 Trellis 流程。
- 已执行 `node node_modules/vue-tsc/bin/vue-tsc.js --noEmit`(工作目录 `identity-admin/web`,使用 bundled Node 绝对路径),退出码为 0。
- 独立验证 agent 正在编写并执行 `function-first-navigation.test.mjs`;根代理负责待所有代理终态后的统一测试及界面验证。
@@ -0,0 +1,33 @@
# 功能优先导航验证
验证日期:2026-10-30。验证者:`function_first_validation` 子代理。
## 交付与结果
- 新增 `identity-admin/web/tests/function-first-navigation.test.mjs`,包含 9 项行为回归测试。
- 更新 `tests/shared-mode.test.mjs` 的旧公司 → 医院导航断言与目录可用性样例。
- 将新测试加入 `identity-admin/web/package.json` 的 `test` 脚本。
- 已运行 `node --test tests/function-first-navigation.test.mjs tests/shared-mode.test.mjs`:13 项通过,0 项失败。
- 全套 `npm test`、类型检查与构建由根代理统一执行。
## 验证方法
执行实际 `src/router/index.ts`、实际 GroupStore、实际 Vue SFC setup 脚本与编译后的模板。路由使用 Vue Router 的内存 history;HTTP、账号与 Element Plus 展示组件使用隔离样例。测试通过真实跳转、store 状态、请求记录和 SSR 输出作断言,没有复制实现算法作为测试替身。
## 已覆盖行为
1. 部门管理、菜单管理均为一级,所有可见公司直接列为各模块子项;不存在公司 → 互联网医院 → 功能层级。其他授权功能为一级入口。
2. 模块规范路径为 `/system/depts`、`/system/menus`;子项携带 `company_id`。源菜单 ID、权限标识、源路径与源菜单对象保持不变。
3. 普通部门只读账号不显示菜单模块或集团管理入口,直接访问菜单模块返回 403,部门页不展示写按钮。
4. 组件读取权限与源菜单权限都须满足;禁用祖先会使模块失效;隐藏菜单只隐藏导航,保留已授权直达行为。
5. `company_id` 只接受可见公司的规范正整数字符串。空值、重复参数、数值类型、前导零、空格、小数、科学计数法、非安全整数与不可见公司均不回退到其他公司。
6. 缺省公司参数按当前公司、默认公司、首个可见公司的顺序选择,并补全 URL。无效公司跳转不会改变当前公司或请求头。
7. 通过模块公司链接及实际 CompanyScope 选择方法切换公司,保留当前功能与其他 query,并同步公司请求范围。
8. 未接入公司、停用公司、缺少成员或登录资格的公司可进入已授权模块空态;页面不读取医院目录,不显示新增、编辑、删除或保存入口;直接调用 load/save/remove 也不会发送目录或写请求。
9. 可用公司的目录读取与新增入口仍存在;standalone 模式保留源路由、原目录导航与无公司 query 的行为。
## 只读设计审查
当前实现没有发现阻断本次功能导航目标的问题。模块空态仍依赖已有源菜单授权,且目录可用性来自实际 GroupStore;本次导航重组没有扩大账号授权。Shell 按公司范围重建业务页面实例,现有 HTTP 范围代次丢弃旧响应的机制继续适用。
本次未使用真实浏览器、真实账号、数据库或密码,没有新增权限。SSR 使用展示组件替身,覆盖显示条件与真实文本,不提供像素布局或 Element Plus 弹层交互验证;服务端授权和真实跨系统登录不在本次新增测试范围内。
@@ -0,0 +1,54 @@
# 集团账号变更同步到原医院服务
完成日期:2026-10-30。仅实现并验证源代码与交付副本;未操作真实账号、权限、会话、数据库或服务配置,未读取真实 `.env`、密码、token 或会话内容。
## 结果与边界
- 集团继续调用原医院的管理员、角色、菜单逻辑,使用同一套原账号、原密码散列、角色关系、菜单权限字符串和 `admin_session`,没有新增独立账号源。
- 管理员重置密码、个人原入口改密、首次设密均持同账号行锁;凭据变更与该账号全部已有原会话的数据库撤销在同一个事务提交,覆盖网页、手机、企微客服、AI 浏览器和医院 SSO 终端 10。提交成功后清理这些会话及该账号权限缓存。失败回滚保留原密码、授权和会话。
- 原密码登录在签发会话的同一账号锁内复核当前密码和停用状态,不能沿用验证器的旧快照。共享集团入口仍强制校验真实密码;医院原入口既有本地调试双门禁没有扩大。
- 角色分配、部门变化、角色权限/数据范围修改、角色删除、菜单修改/停用/删除会定向撤销关联账号会话。父菜单变更覆盖子孙菜单获授权账号。角色删除同时清理角色菜单和用户角色关联,避免软删除留下有效权限。
- `AdminTokenCache` 每次读取先核验原数据库中的会话有效性与账号状态,旧缓存回填不能复活已撤销会话。续期也持账号锁并重查当前会话有效性,保留已有登录 IP。不会逐请求无差别退出所有用户。
- `AdminAuthCache` 使用当前原授权关系判断接口权限,不再信任一小时的 URI 缓存。菜单自身和完整祖先链必须存在、启用且无环;隐藏 `is_show` 不撤销接口授权。普通账号返回明确有效权限,只有原 root 保留 `*`。
- 核心 `auth.admin`、`auth.role`、`auth.menu`、`dept.dept` 接口有固定权限检查,不会因菜单权限字符串改名、删除或未登记而触发历史“未登记 URI 放行”。详情、下拉选项使用原列表/编辑用途权限别名,个人资料和当前导航保持原登录用途。
- AI 浏览器 `ConsoleService::open` 的签发和 TTL 调整在同一账号锁内,不能在管理员撤销后通过旧调用延长旧 token。
密码改动撤销的是全部已有 `admin_session`。企业微信、IAM、MCP 等独立且仍有效的外部授权,仍可按各自原登录政策重新认证并创建新会话;本变更不撤销这些独立授权。
## 改动文件
- 原逻辑:`AdminLogic.php`、`RoleLogic.php`、`MenuLogic.php`、`AuthLogic.php`、`LoginLogic.php`。
- 原缓存与签发:`AdminTokenCache.php`、`AdminAuthCache.php`、`AdminTokenService.php`。
- 原鉴权与 AI 浏览器:`AuthMiddleware.php`、`mcp/service/ConsoleService.php`。
- 新辅助服务:`AdminAccessSyncService.php`、`CoreAccountPermissionPolicy.php`、`common/service/ActiveMenuPermissions.php`。
- 新隔离回归:`server/tests/GroupAccountSourceSyncTest.php`。现有共享会话、医院 SSO 夹具补充真实菜单已有的 `pid` 列。
上述源文件及测试均有 `identity-admin/integration/original-server/` 完整同路径交付副本,部署必须连同辅助服务一起更新。
## 验证
使用本机 PHP 8.2.9,通过命令行临时启用 `pdo_sqlite`,未修改 PHP 配置。
```powershell
& 'C:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe' -d extension=pdo_sqlite server/tests/GroupAccountSourceSyncTest.php
```
新回归通过 **65 项断言**:真实调用管理员编辑/删除与原登录、旧/新密码、原会话与 SSO/AI 浏览器旧会话撤销、旧缓存回填、续期不能复活、角色授予/撤回/空权限/数据范围/删除、菜单权限改名/停用/祖先/删除、环和缺失祖先、原导航、隐藏菜单、核心读取/写入保护、普通账号首次改密限制、个人改密锁内复核,以及管理员/角色/菜单三个事务失败不踢人。全部使用临时 SQLite、临时文件缓存、随机虚构凭据和 IM 桩,不调用第三方网络。
同时通过:
- `IdentitySharedSessionTest.php`:37 项。
- `IdentityHospitalSsoTest.php`:95 项。
- `GroupReadonlyPermissionTest.php`:10 个场景、46 项;只读账号权限未扩大。
- `AdminMultiRoleRegressionTest.php`。
- `AdminDesktopAuthContractTest.php`、`AdminDesktopSessionBehaviorTest.php`、`AdminWecomRpaServerIpTest.php`。
- `DataScopeMultiRoleTest.php`。
- 所有变更 PHP 源文件语法检查;限定变更文件的 `git diff --check`。
## 仍需明确的技术限制
1. SQLite 验证数据库行为、事务回滚和确定性交错结果,不模拟 MySQL 的实际多连接行锁调度。MySQL/InnoDB 上通过相同账号行的 `FOR UPDATE` 串行化凭据修改、原登录、SSO、续期和 AI 浏览器签发;生产部署前可在专用一次性 MySQL 库补充多进程压测。本次没有连接真实数据库。
2. 已经在撤销提交前完成鉴权并开始执行的请求不会被强制中断;后续请求会核验数据库会话状态。已打开的导航在重新登录或刷新后取得当前菜单。
3. 核心账号四组接口以外,原 `AuthMiddleware` 对从未登记或彻底删除/改名后的旧业务 URI 的历史放行规则仍存在。已登记但停用的权限仍保留在受控 URI 集合。没有重写临床业务的独立豁免、别名或其他历史路由策略。
4. 禁用/缺失/成环的菜单祖先现在会收回普通账号的子菜单权限;既有脏菜单树会因此收窄权限。root 的原权限语义保留。未批量修复真实菜单数据。
5. 为消除撤销缓存竞态,会话读取增加数据库有效性查询,接口授权读取当前角色/菜单关系;不依赖新增表或迁移,也没有加入全局逐请求退出策略。
@@ -0,0 +1,48 @@
# 集团修改密码、权限后医院直接生效
后续公司范围与原生菜单授权规则见 [角色驱动交付](role-driven-delivery.md):用户、角色全局管理,角色可跨公司勾选菜单,成员归属不构成业务授权。本文中的源密码/会话同步规则继续有效。
日期:2026-10-30。当前接入对象为互联网医院,其他子系统尚未开发。本次完成源代码、配套交付文件、隔离回归和当前页面只读核对;没有修改真实账号密码、角色授权、菜单或部门。
## 最终行为
集团后台直接读写同一医院账号和原角色,密码与权限不通过定时任务同步,也没有第二套可独立漂移的副本。
| 集团操作 | 医院行为 |
|---|---|
| 用户编辑填写新密码 | 更新同一原密码凭据,旧密码失效;该账号全部已有原会话,包括医院 SSO 终端 10,被撤销 |
| 新密码留空 | 不修改密码 |
| 调整用户角色、部门、停用状态 | 原关系直接更新,相关账号旧会话失效 |
| 修改角色菜单授权或数据范围 | 原角色直接更新,使用该角色的账号重新登录取得新权限 |
| 修改、停用、删除菜单 | 原菜单直接更新,关联账号重新加载;禁用祖先使普通账号下级权限失效 |
撤销后下一次受保护请求会被拒绝,医院原前端清理旧菜单和权限并跳回登录;重新登录获取最新授权。不使用轮询,不把所有无关用户一并退出。保存与后续列表刷新分开处理,已成功保存后遇到失效或网络错误不会误报“保存失败”。
## 实现重点
- 同账号行锁串行化改密、密码复核、签发、SSO、续期与 Console 已有会话更新;密码及授权变更与旧会话撤销在原事务内提交,缓存仅在成功后清理。
- 原 token 缓存读取重查数据库有效性,接口权限读取当前关系;缓存回填或续期不能复活旧会话。
- 核心账号、角色、菜单、部门接口固定鉴权,原权限标识保留;普通账号明确列出有效权限,只有 root 使用通配符。
- 操作日志对请求/响应的密码、确认密码、旧密码、token、ticket 等递归脱敏,保留普通审计字段。
- 原端文件与 `identity-admin/integration/original-server/` 配套副本一起交付,不增加业务数据表。
## 根代理统一验证
- 原医院新增账号变更回归:65 项断言通过。
- 原共享会话:37 项;医院 SSO:95 项;只读权限:10 场景、46 项,通过。
- 中央写穿、会话/SSO拒绝和公司边界:47 项服务断言通过;中央共享与集团 HTTP 套件合计 21 个测试通过。
- 集团前端:35 个测试通过,包含实际 SFC、HTTP 401、全局退出、写后刷新故障及防重复提交。
- 日志脱敏、原多角色、桌面认证/会话、企微 IP、数据范围回归通过。
- TypeScript 检查和 Vite 生产构建通过;构建仍有既有主包体积提示。
- 浏览器只读刷新角色管理,确认新的同源授权/重新登录说明与原 11 个角色正常显示。[页面截图](group-account-sync-roles.jpg)。没有在真实页面填写新密码或保存授权,不能把隔离测试当作真实测试账号的验收。
- 原端配套目录 23 份源码/测试副本与当前项目逐一散列比对一致,限定变更的 `git diff --check` 通过。
## 精确边界
已完成鉴权的在途请求不强行中断;后续请求检查撤销状态。本次没有做真实 MySQL 多连接压力测试,隔离测试使用临时 SQLite 和内存/文件缓存。核心四组之外,原医院彻底未登记或删除/改名后的旧业务 URI 历史放行规则仍存在,没有整体重写临床豁免策略。
密码修改撤销全部已有原会话,不撤销独立企微、IAM、MCP 等仍有效的外部授权;这些授权仍按原政策重新认证。集团公司任职、公司停用、应用登录资格撤回是单独边界:目前阻止新的集团授权与兑换,但不能单独让已有医院会话立即退出,不能与本次原角色修改混为一谈。
此前测试账号首次密码设置和真实登录验收仍以 [test-account-progress.json](test-account-progress.json) 的独立进度为准,本轮未替用户设置凭据。
详细报告:[原医院后端](group-account-source-sync.md)、[中央桥接独立审查](group-sync-bridge-review.md)、[前端](group-account-ui-sync.md)。
Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

@@ -0,0 +1,50 @@
# 集团账号与医院账号直接变更:前端交付
## 结论
共享模式的用户、角色和个人改密继续通过现有 `/auth.admin/*`、`/auth.role/*` 接口提交,由中心后端直接写入同一医院账号和角色。前端已明确告知:新密码留空不修改密码;重置密码、角色授权或数据范围变更后,受影响医院账号的旧会话需重新登录。
本次没有使用真实账号、浏览器、生产接口或数据,也没有读取存储中的密码或登录凭据。
## 实现
- `identity-admin/web/src/views/Users.vue`:补充医院账号直写提示,保留空密码载荷、完整角色/部门关联、root 保护与当前账号不可删除;保存成功即清空密码输入;保存中阻止重复写入和再次打开编辑表单。
- `identity-admin/web/src/views/Roles.vue`:补充共享角色、菜单权限和数据范围的直写说明;保留未展示的已有授权、原数据范围和 standalone 载荷差异。
- 两个管理页将写入后的权限/列表刷新单独处理。实际 HTTP 401 继续走现有全局退出回调,不追加“保存失败”;刷新网络故障明确提示“变更已保存”,避免用户再次提交。
- `identity-admin/web/src/views/Profile.vue`:补充医院与集团共用密码说明;保留首次改密仅提交新密码字段的行为;改密成功清理输入和会话,跳转异常仍提示密码已修改;保存中禁用表单并保留重复提交防护。
- 用户/角色请求仅携带原有医院字段,没有增加 GID、company_id 或其他集团伪字段。功能→公司的导航、路由和医院前端没有改动。
## 原医院会话与权限链路核验
1. `server/app/adminapi/http/middleware/LoginMiddleware.php`:token 失效或续期失败返回 `JsonService::fail(..., -1)`。
2. `server/app/common/service/JsonService.php`:上述 envelope 使用 HTTP 200,业务码为 `-1`。
3. `admin/src/utils/request/index.ts`:`RequestCodeEnum.LOGIN_FAILURE` 分支执行 `clearAuthInfo()` 并跳登录页。
4. `admin/src/utils/auth.ts`:清理用户状态、权限、标签、缓存凭据和动态路由。
5. `admin/src/permission.ts`:重新登录后用户资料为空,路由守卫调用 `getUserInfo()`。
6. `admin/src/stores/modules/user.ts`:重新获取 `data.permissions`、`data.menu`,重建可用菜单和路由。
因此医院已有失效响应→退出→重新登录→重取权限的完整链路。本次不增加轮询、推送或额外的医院端刷新机制。会话是否失效由后端变更处理保证,前端下一次请求触发退出。
## 隔离测试与验证
新增 `identity-admin/web/tests/account-sync.test.mjs`,执行实际 SFC 脚本、HTTP 401 处理和 `main.ts` 的全局退出回调,只替换网络、内存凭据及浏览器依赖。13 项新增测试全部通过,覆盖:
- 空密码原样保持、管理员重置密码和医院接口载荷白名单。
- 用户/角色变更后 HTTP 401 清会话、清动态路由、跳登录且无保存失败提示。
- 写入后刷新故障、重复点击、保存中再次打开表单。
- 未展示角色授权及原数据范围保留。
- root 保护、当前账号不可删除、首次改密字段门禁。
- 个人改密的输入清理、退出和跳转失败提示。
- 写入失败保留输入与编辑框,不误报成功。
验证命令:
```powershell
node node_modules/vue-tsc/bin/vue-tsc.js --noEmit
node --test tests/account-sync.test.mjs
node --test ../tests/session-race.test.mjs tests/shared-mode.test.mjs tests/group-context.test.mjs tests/function-first-navigation.test.mjs tests/account-sync.test.mjs
```
工作目录:`C:\zyt\identity-admin\web`。
结果:类型检查通过;新增测试 13/13 通过;完整前端测试 35/35 通过。`package.json` 的 `test` 字段已追加新增测试。当前 shell 没有 `npm` 命令,因此直接用现有 Node 执行同一套类型检查与测试入口。
@@ -0,0 +1,24 @@
# Group client terminal isolation — 2026-11-04
`SharedIdentityService` sends `terminal=11` to `identity.session/login` when `GroupService::enabled()` is true; shared mode without Group keeps `terminal=1`. Browser login payloads cannot override the terminal.
Files changed:
- `identity-admin/server/app/service/shared/SharedIdentityService.php`: conditional source login terminal.
- `identity-admin/tests/shared-upstream.mjs`: synthetic source requires terminal 11 only with explicit `groupEnabled: true`; default requires terminal 1.
- `identity-admin/tests/group-api.test.mjs`: verifies both Group source logins use 11 and rejects browser terminal 1/11 overrides before forwarding.
- `identity-admin/tests/shared-api.test.mjs`: verifies all non-Group source login attempts use 1 and rejects browser terminal 1/11 overrides before forwarding.
- Group fixture consumers: `identity-admin/tests/company-structure-http.test.mjs`, `identity-admin/tests/role-driven-bridge.test.mjs`, `identity-admin/tests/kefu-sso.test.mjs`, `identity-admin/tests/kefu-authorization-joint.test.mjs`, `identity-admin/tests/kefu-metadata-joint.test.mjs`, `identity-admin/tests/kefu-joint-flow.test.mjs` explicitly select Group mode for their synthetic source.
Validation, from `C:/zyt/identity-admin`:
```powershell
$env:IAM_TEST_PHP='C:/Users/isard/.cache/zyt-tools/php/php.exe'
node --test tests/group-api.test.mjs tests/shared-api.test.mjs tests/role-driven-bridge.test.mjs tests/company-structure.test.mjs tests/company-structure-http.test.mjs tests/group-write-through.test.mjs tests/role-access.test.mjs tests/kefu-sso.test.mjs
```
Result: 35 tests passed; 0 failed/skipped. Tests supply `-d extension=pdo_sqlite`; no new PHP flags were needed. The initial sandboxed run could not connect to localhost (`EACCES`); the same command passed with approved loopback access.
PHP syntax check passed for `SharedIdentityService.php`. `node --check` passed for `shared-upstream.mjs` and the three changed optional joint tests. Optional joint suites requiring a separate source root were not run.
All executed HTTP fixtures bound to temporary localhost ports. Session files and SQLite databases were synthetic and temporary. No production service, real `.env`, account credentials, tokens, sessions, or database was read. No dependency installation was performed. Original server, integration, normal login validation, RPA, and IAMv2 production code were not changed by this patch.
@@ -0,0 +1,49 @@
# 集团前后端契约复核
日期:2026-10-30。本轮只读复核实现并新增此报告;未修改前后端实现,未操作浏览器、真实账号、数据库或私密配置。
结论:在当前已确认的单医院接入范围内,未发现必须修复的前后端契约错配。公司新增没有发送 `id: 0`;成员关系使用显式公司编号;`effective_disable` 与资格门禁一致;集团和医院 PKCE helper 可用隔离样例完成跨端参数往返。
## 公司新增、编辑和 schema
- `web/src/views/Companies.vue:18` 的 `id: 0` 只是本地新建表单哨兵。实际 `:38–40` 新增载荷为 `{code,name,parent_id,disable}`,**省略 id**;编辑为 `{id,name,parent_id,disable}`,省略不可变 code。已执行真实 SFC 脚本验证两种载荷,与 `GroupService.php:165–173` 的分支一致。
- 名称必填、最长 64 字;编码按 `^[a-z][a-z0-9-]{1,31}$` 限制 2–32 位,前端 `Companies.vue:69–70` 与后端 `GroupService.php:167/174` 一致。服务端额外检查控制字符、唯一编码和循环层级;未发现界面声明能保存而接口系统性拒绝的字段。
- `parent_id: 0` 表示集团根,与 schema 默认值一致。前端父级树 `Companies.vue:19–22` 剔除自身及整个下级分支;服务端仍遍历祖先检查循环,不依赖前端选项。
- schema 是 `company(id,code,name,parent_id,disable,...)`;没有删除 API,前端也没有删除入口。公司新增后默认没有任何应用或成员资格,符合本轮边界。
## 成员与公司范围
- `Members.vue:18–25` GET 明确传 `company_id`,并同时比较请求序号与当前公司后才接收结果;`:31–37` 保存先捕获公司 ID,不会因保存期间切公司而把写入范围改到新公司。
- `services/group.ts:22–23` 载荷仅 `{company_id,admin_id,member_status,can_login}`,两个开关都显式提交整数 0/1,与 `GroupService.php:226–237` 一致。撤销成员时界面同时清除待保存的 `can_login`,符合后端“不任职不能给登录资格”的限制。
- `/group/members` 返回的是可分配的集团账号候选集合及其在所选公司的资格,包含 `member_status: 0` 的未任职账号。界面表格显示“账号”与成员开关,不把所有候选人计成已任职成员。它是集团管理员的成员分配面,不是新公司的医院用户目录;原医院四页仍受独立公司范围检查。
- 元数据使用 `(company_id,source_id)` 复合主键;`GroupStore.php:75–83` 仅对医院默认成员使用 `INSERT OR IGNORE`,已有撤销记录不会被重新登录/刷新覆盖。
- `web/src/stores/group.ts:13–15` 要求已接入医院、`effective_disable` 为 0、`member_status/can_login` 为 1;与 `GroupService.php:91–96/136–151` 的祖先启停及目录检查一致。前端展示“上级停用”,没有只看子公司自身 disable 而继续开放目录。
- `services/http.ts:26–40` 只给医院目录 CRUD/options 附当前 `X-Company-Id`,集团接口通过自己的 `company_id` 操作,登录、mySelf、改密及退出不带公司头。后端 `ApiController.php:30–33` 接收同一头;`SharedIdentityService` 对集团接口先分流,仅原目录调用 `requireDirectory`。切公司版本号也能拒绝切走再切回同 ID 的旧响应。
## JSON 与 body 限制
前端 axios POST 和医院 fetch POST 均发送 JSON 对象及 `Content-Type: application/json`;中央 `ApiController.php:91–109` 要求 JSON 对象、深度 32、最大 65,536 字节。公司表单、成员载荷与五字段授权请求远小于限制,未发现数组/表单编码、额外展开字段或超限冲突。
`Company` 上的 `effective_disable`、`is_directory_company`、`permission_prefix`、成员状态等只用于展示或资格判断,不会被整个对象提交给公司保存接口。原医院的 ID/pid/perms 与角色授权载荷仍保持原契约。
## SSO 实际路由和参数闭环
1. 医院 `router/routes.ts:39` 注册内部 `/group-login`;`router/index.ts:116` 使用 `BASE_URL`,Vite 固定 `/admin/`,所以浏览器入口是 `/admin/group-login`。`permission.ts:84/111` 已将此内部路由放入免登录白名单;不会在进入 GroupLogin 之前被旧 token、改密或企微守卫吞掉回调。
2. `GroupLogin.vue:20–24` 初次使用 `beginGroupLogin`,回调先同步 `consumeGroupCallback`。医院 `groupSso.mjs:32–41` 生成 32 字节随机 verifier/state,43 字符 base64url challenge;中央 `services/group.ts:42–54` 与 `GroupService.php:253–260` 接受相同五字段、同 client ID、同 state/challenge 格式和 S256。
3. 集团 `/sso/authorize` 在 `web/src/router/index.ts` 仍经过登录、首次改密、企微门禁。`SsoAuthorize.vue:16–17` POST 后再次验证服务器回调 origin/path、唯一 code/state 与原 state;中央服务端 code 为 64 位 hex,属于当前前端接收格式。
4. 医院回调严格匹配固定 `/admin/group-login`,同步清掉 URL 参数并消费 sessionStorage 事务,再执行中央 exchange。中央请求体是 `{client_id,redirect_uri,code,code_verifier}`,医院同源请求体是 `{ticket,code_verifier}`,均无浏览器传入的 admin_id/terminal/旧业务 token。
5. 集团 exchange 由 `SharedIdentityService.php:40–41` 在 Bearer 验证之前处理,符合医院 `credentials: omit` 的公开 PKCE 交换;后端重新校验源会话与成员资格。`HttpMiddleware.php:13–24` 加入已注册医院 origin,JSON CORS 预检允许 Content-Type;医院第二次交换是 same-origin,与 HospitalSsoController 的 Origin/Sec-Fetch 检查吻合。
6. Vue GroupLogin 成功后清旧 auth 状态,写入现有 token cache;预览静态页写入 `like_admin_token` 的 `{value,expire}` 格式,也与原 cache 前缀/结构一致。两个入口随后按 `is_paw/need_bind_work_wechat` 选择既有医院路径。
部署条件仍须保持:医院前端固定部署在 `/admin/`;远程构建必须设置 `VITE_GROUP_IDENTITY_URL`;中央注册医院入口必须对应实际医院 origin 和 `/admin/group-login`。本地预览使用独立静态入口,不等同于已完成远程生产构建。以上属于当前部署约定,不是本轮发现的实现错误。
## 验证与限制
本轮重新执行:
- 集团前端 13 项测试:全部通过。
- 医院 `admin/scripts/group-sso.test.mjs` 的 7 项事务测试:全部通过。
- 临时内存脚本执行真实 `Companies.vue` 保存函数:新增省略 id、编辑省略 code、父级剔除子树全部通过。
- 临时内存脚本联合调用医院 begin、中央授权请求/回跳校验、医院 consume、两次 exchange helper:参数、PKCE challenge、本地事务消费和交换载荷全部通过。所有账户/授权码/会话均为隔离样例,没有网络调用。
本轮未改实现,因此未重复上一轮已通过的 TypeScript 与生产构建。未执行真实浏览器或后端真实数据验收;主流程负责该部分。当前**必须修复项:无**。
Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

@@ -0,0 +1,43 @@
# 集团身份中心前端实施记录
日期:2026-10-30。改动范围仅 `identity-admin/web/` 及本记录;未操作真实浏览器、业务数据、token 或私密配置。接口依据 `identity-admin/docs/group-contract.md`,由主流程同步确认。
## 已实现
- 集团品牌、登录页、集团工作台、个人主 GID;`health.group_enabled` 关闭时保留原独立/共享后台行为,不调用集团上下文接口。
- 独立 `stores/group.ts` 加载 `GET /group/context`,使用上下文 `is_group_admin` 判定集团管理员,不从医院 root 推导。
- 公司树选择器和“集团管理 → 公司管理 / 公司成员”导航;医院管理菜单按“公司名称 → 互联网医院 → 原有管理页面”展示。
- `/group/companies` 真实新增、编辑、公司父级与启停,名称 1–64 字、编码 2–32 位且创建后不可改;父级选项剔除自身及下级。没有公司删除入口。
- `/group/members` 按当前公司加载账号及 GID,成员资格与应用登录资格由显式行保存提交。撤销成员时清掉待保存的应用登录资格;不为新公司自动增加医院业务权限。
- 当前公司必须已接入医院、公司及祖先启用、成员与应用登录资格有效,才注册医院四类管理路由。未接入公司显示“暂无已接入应用”,无医院数据页面;失去资格或公司停用时清掉原目录入口。
- 医院目录请求携 `X-Company-Id`;公司切换版本变化后拒绝旧成功与错误响应,包含切走后又切回同一 ID 的情况。集团接口及登录、个人账号接口不带公司头。
- 首页应用卡使用服务端注册 `entry_url` 同页 `window.location.assign` 进入医院,展示服务端可用与授权状态。
- `/sso/authorize` 在既有登录、首次改密及企微门禁之后处理。逐一校验五个参数为唯一非空字符串,限制已注册医院回调、S256 challenge 与 state,POST `/group/sso/authorize`;响应再校验注册 origin/path、唯一 code/state 及原 state,成功同页跳转。错误不显示授权码,并提供回工作台入口。
- 原用户、角色、菜单、部门页面显示公司 → 应用上下文与 `company.code.application.internet-hospital` 权限前缀。原菜单 ID、父 ID、路径、组件、perms 及角色授权载荷均不改变;没有可提交的虚拟公司节点。
- 新增公司选择、应用卡、GID、公司上下文和授权页的窄屏样式,沿用原有表格横向滚动与弹窗布局。
## 关键文件
- `web/src/stores/group.ts`:上下文、当前公司、资格判断和重置。
- `web/src/services/http.ts`:目录公司头、旧公司请求隔离。
- `web/src/services/group.ts`:公司树、成员显式载荷、应用入口与 SSO 严格校验。
- `web/src/router/index.ts`:集团管理员路由、公司分组导航、目录路由卸载与账号门禁。
- `web/src/views/Companies.vue`、`Members.vue`、`SsoAuthorize.vue`:新增页面。
- `web/src/layout/Shell.vue`、`views/Dashboard.vue`:公司切换和一键应用入口。
- `web/src/components/CompanyScope.vue`:原管理页面的公司/应用范围提示。
## 验证
通过应用 bundled Node 执行(系统 PATH 未提供 npm):
```text
node --test ../tests/session-race.test.mjs tests/shared-mode.test.mjs tests/group-context.test.mjs
node node_modules/vue-tsc/bin/vue-tsc.js --noEmit
node node_modules/vite/bin/vite.js build
```
测试 13/13 通过;TypeScript 检查通过;Vite 生产构建通过。构建存在 Element Plus 主包超过 500 kB 的体积提示,不影响构建结果,未为此扩大本轮重构范围。产物仅写入 `web/dist/`。
新增验证涵盖真实 group store 在空公司、撤销资格、退出与迟到上下文下的行为;目录请求公司头及 ABA 切换隔离;SSO 参数重复/未知参数、错误 origin/path、弱 challenge、非法协议、用户密码 URL、控制字符、重复 code/错误 state;公司分组不改原数据;成员明确撤销载荷;用户 GID/公司展示不污染旧用户载荷。原共享菜单字段、隐藏角色授权、数据范围和账号门禁回归继续通过。
依要求未执行真实浏览器/数据验收;移动端来自响应式实现与编译检查,未声称完成截图或真实浏览器 SSO 联调。完整端到端链路还需主流程的后端及医院接入验证。
@@ -0,0 +1,70 @@
# 当前互联网医院 SSO 实现记录
日期:2026-10-30。实现范围仅原 `server/` 的医院登录交接,不改集团中心实现、原账号密码、角色、部门、菜单或业务数据。
## 交付文件
- `server/app/adminapi/controller/identity/HospitalSsoController.php`:原 ThinkPHP 自动控制器路由 `identity.hospitalSso`,仅 POST;禁止 query 参数、未知身份/终端字段;返回 no-store/no-referrer;exchange 拒绝显式跨源 Origin 和 cross-site 浏览器请求。
- `server/app/adminapi/service/IdentityHospitalSsoService.php`:从原真实源会话导出身份,锁账号后锁源会话,在同一事务内重查门禁并写入终端 10 会话。
- `server/app/adminapi/service/IdentityHospitalSsoTicketStore.php`:私有目录下一次性 30 秒票据,S256 PKCE,全局文件锁保护原子单次消费。
- `server/app/common/enum/AdminTerminalEnum.php`:增加 `GROUP_HOSPITAL=10`;未扩展旧登录终端白名单,也未加入 RPA 例外。
- `server/tests/IdentityHospitalSsoTest.php`:隔离 SQLite 与临时私有文件测试,显式跳过真实 `.env`。
## 接口
### `POST /adminapi/identity.hospitalSso/issue`
请求头为原 `token`;请求体严格只有:
```json
{"code_challenge":"<S256-base64url-43-chars>","code_challenge_method":"S256"}
```
返回原项目 `{code:1,data:{ticket},...}`。
服务从 token 查询真实 `admin_session`,再依次锁定真实账号与同一 session 行,核验源会话未过期、token 摘要相符、账号未停用/软删除、已完成首次改密、已满足现有企微门禁。仍在锁内校验源 token 缓存的同一账号与 login_ip;异 IP 请求只可采用原精确 RPA 终端/服务器 IP 例外,不新增豁免。不接受 adminId、root、account 或 terminal 等输入。终端 10 本身不能作为交接源,防止新目标会话反向成为自身的源并相互轮换。
### `POST /adminapi/identity.hospitalSso/exchange`
医院浏览器同源请求:
```json
{"ticket":"<one-time-random-ticket>","code_verifier":"<43-to-128-character-PKCE-verifier>"}
```
返回原医院登录 payload:`name/avatar/role_name/token/is_paw/need_bind_work_wechat`。
先在私有文件锁下核验 ticket 与 verifier 并删除票据,随后在账号/源会话锁内重查 session ID、token SHA-256 摘要、有效期、账号状态与首次改密/企微门禁,并持久化独立终端 10 的医院 session。票据一旦成功消费,即使后续源会话检查失败也不可重放。错误 verifier 不消费正确的未过期票据。
## 为什么没有直接调用原 `LoginLogic::login`
集团 bridge 当前使用 PC=1;原 `AdminTokenService::setToken` 同终端会复用或轮换 token,并重写该 token 的 IP 缓存。直接使用会踢掉 bridge 或让浏览器与集团后端相互触发 IP 错误。
本实现只在终端 10 内遵守原单点/多点策略:单点轮换目标 token,多点复用尚有效目标 token。原 PC=1 的 session、token 和缓存保持原样。目标 token 使用 **128 bit 随机值,编码为 32 字符 hex**,兼容原 `admin_session.token varchar(32)`;终端 10 的 DB 会话写入在源校验事务内完成,提交成功后才在真实医院浏览器请求上下文发布 `AdminTokenCache`,保留医院原有 per-token IP 绑定。没有提前将未提交 token 写入鉴权缓存。源 IP 限制仅用于 issue,最终 exchange 允许医院浏览器来自不同 IP。
原首次改密和企微待绑定会直接拒绝交接;用户需先按现有流程完成初始化。成功 payload 因而固定反映已通过的门禁。原源会话退出、换 token、改密、停用或删除后,未消费票据不能签发医院会话。原全会话退出/个人改密仍会撤销终端 10;本轮不增加集团成员停权后实时撤销既有医院会话的机制。
## 存储和部署边界
票据目录为原应用 runtime 下的 `identity-hospital-sso/`,目录 0700、文件 0600(Windows 仍需正常私有 ACL),符号链接检查与独占锁。文件名只包含票据 SHA-256;文件内容只有 source session ID、source token SHA-256、S256 challenge、到期时间,**没有原 token、密码或原票据**。票据不进入日志,控制器内部错误仅返回固定通用消息。
当前是单医院服务器/共享同一 runtime 的 PHP-FPM 进程模型;多医院实例部署前需共享原子票据存储。中心 authorize、code PKCE、state 与公司 membership 检查由集团服务负责;医院再次验证其自己的源会话。本实现不提供任意员工 ID 的免密签发能力,也不声称是通用 OAuth/OIDC Provider。
集团 `SourceApiClient` 和原项目的受限本地 API router 需要由主流程将上述 issue/exchange 加入适当白名单。本实现没有放开旧医院权限路由、旧登录规则或任何 RPA IP 例外。
## 验证结果
使用本地 PHP 8.2.9;SQLite 扩展仅通过命令行启用,不改系统配置:
```powershell
& 'C:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe' -d extension=pdo_sqlite server/tests/IdentityHospitalSsoTest.php
& 'C:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe' -d extension=pdo_sqlite server/tests/IdentitySharedSessionTest.php
```
- 医院 SSO:**95 项通过**(最终独立复跑)。
- 原共享会话/角色回归:**37 项通过**。
- 新控制器、服务、票据存储、终端枚举及测试文件 `php -l` 均通过。
医院套件覆盖正确 flow、票据重放与超时、错误 PKCE、源会话撤销/旋转/删除、账号停用/软删除、首次改密、企微门禁、改密撤销、身份/终端字段注入、查询参数注入、跨源请求、仅 POST、单点/多点两种策略、不同 IP 的源/目标缓存互不影响、原医院无权接口仍被拒绝、新终端不获得 RPA 例外,以及原全会话退出能够撤销医院目标会话。最终新增异 IP 源请求拒绝且无出票/无新会话/缓存不变、合法不同 IP exchange 仍成功、最终 token 为 32 字符,以及 SQLite `CHECK(length(token)<=32)` 防止宽松字段类型漏检。
测试显式禁止加载真实 `.env`,数据库和 cache/ticket 全部建立在随机系统临时目录。没有真实登录或原业务数据库写入。
@@ -0,0 +1,44 @@
# Group KF public HTTP origin support
The Group backend now accepts `http://im.zhenyangtang.cn:8369` only when deployment configuration explicitly lists that origin in `IAM_KEFU_ALLOWED_HTTP_ORIGINS`. This change does not enable or deploy the configuration.
The same guard applies to the browser callback, signed metadata reads, and signed authorization requests. HTTPS and loopback HTTP retain their defaults. Public HTTP origins are compared by scheme, case-insensitive host, and effective port; an omitted HTTP port means 80. A malformed list item rejects every public HTTP exception. List entries cannot contain paths, trailing slashes, wildcards, credentials, queries or fragments.
The registered KF application DTO adds only `http_entry_allowed: boolean`. It is true when that application's current HTTP callback has an explicit allowlist match. No allowlist or machine key is sent to the frontend. Hospital transport rules, fixed callback matching, PKCE, code expiry and one-time consumption, endpoint HMAC binding, request nonces, and TLS verification remain in force.
## Changed paths
- [KefuClient.php](../../identity-admin/server/app/service/group/KefuClient.php): shared HTTP guard and explicit-origin check.
- [KefuMetadataClient.php](../../identity-admin/server/app/service/group/KefuMetadataClient.php): uses the shared HTTP guard.
- [KefuAuthorizationClient.php](../../identity-admin/server/app/service/group/KefuAuthorizationClient.php): uses the same guard for both permission endpoints.
- [GroupService.php](../../identity-admin/server/app/service/group/GroupService.php): KF-only boolean in the registered application DTO.
- [.env.shared.example](../../identity-admin/server/.env.shared.example): empty-by-default allowlist with the public 8369 example.
- [kefu-sso-backend.md](../../identity-admin/docs/kefu-sso-backend.md): configuration semantics, callback binding and test commands.
- [kefu-http-origin.php](../../identity-admin/tests/kefu-http-origin.php): URL guard matrix and authenticated synthetic requests for all three machine endpoints.
- [kefu-http-origin.test.mjs](../../identity-admin/tests/kefu-http-origin.test.mjs): isolated PHP fixture runner.
- [kefu-password-login.php](../../identity-admin/tests/kefu-password-login.php): public-origin direct login, Group DTO, exact callback SSO and hospital isolation regression checks.
- This report.
## Verification
PHP executable: `C:/Users/isard/.cache/zyt-tools/php/php.exe` (PHP 8.2).
```powershell
$env:IAM_TEST_PHP = 'C:/Users/isard/.cache/zyt-tools/php/php.exe'
node --test identity-admin/tests/kefu-http-origin.test.mjs identity-admin/tests/kefu-metadata.test.mjs identity-admin/tests/kefu-authorization.test.mjs
& $env:IAM_TEST_PHP -d extension=pdo_sqlite identity-admin/tests/kefu-password-login.php
node --test identity-admin/tests/kefu-sso.test.mjs identity-admin/tests/group-api.test.mjs
```
Results:
- New HTTP origin fixture: 161 checks passed.
- Metadata fixture: 172 checks passed.
- Authorization fixture: 513 checks passed.
- Password login fixture: 442 checks passed, including the new public direct-login/SSO cases.
- Existing Group HTTP and KF SSO suites: all 3 tests passed with loopback access enabled.
- PHP syntax checks passed for the four changed backend classes and two PHP fixtures.
The first sandboxed HTTP-suite run could not reach the temporary PHP servers and failed readiness checks. The same commands passed after granting loopback access. All sources, keys and identities used by these checks were synthetic. No live environment file, production database, account, secret or public network endpoint was used. The existing password fixture left its isolated synthetic runtime under `identity-admin/.test-runtime/kefu-password-1e138a32d96986bb005b5cbe`; Node fixture runtimes use system temporary directories.
No root `AGENTS.md`, context boilerplate, Group frontend, KF frontend, live environment or deployment files were changed in this backend work. Existing unrelated changes were preserved.
@@ -0,0 +1,250 @@
# 集团主身份中心:后端与 SSO 只读研究
研究日期:2026-10-30。范围:`identity-admin/`、原 `server/` 的身份、登录、授权与适配器代码。未读取运行时数据库、私密环境配置、真实密码、token 或会话内容;未修改代码或业务数据。读取的测试文件仅用于确认契约,未执行数据库测试。本报告是设计建议,不代表生产 IAM/Keycloak 可用性已经验证。
## 0. 用户收窄当前范围后的最终建议:先接当前医院
补充约束:其他子系统稍后开发;本次按公司归组菜单,保留医院旧权限兼容。允许集团元数据独立 SQLite,而现有原医院员工账号仍作为当前凭据与员工来源。**在这个阶段,可先做受控的一次性 code + PKCE 的内部医院登录交接,不必本次重新搭建 IdP。它是当前医院的 SSO 适配,不能宣传成已具备通用 OIDC 服务端。**
集团 SQLite 最少包含:companies、subjects(稳定 gid 与精确 source_key+source_admin_id 唯一关联)、memberships、applications、application_grants,以及 code 哈希、S256 challenge、固定 callback、源会话引用、过期与已消费状态。当前医院账号新增仍走原 API,新增成功后显式登记稳定 gid/公司/应用关系;不复制医院密码,也不将根权限扩展到医院。新应用未来按相同中心员工 ID 接入。
### 0.1 最重要的会话冲突结论
**不能在医院 delegate 中直接对当前桥接源账号调用 `AdminTokenService::setToken(adminId, PC=1, ...)` 并期望桥接会话继续有效。**
证据:`server/app/adminapi/service/AdminTokenService.php::setToken()` 按 `(admin_id,terminal)` 查询已有会话;`SharedIdentityService::login()` 目前固定 `terminal=1`。因此:
- `multipoint_login=0`:PC 会话轮换 token,立即使集团桥接记录保存的原 token 失效。
- `multipoint_login=1`:活跃 PC 会话复用同一个 token,不会得到独立医院浏览器会话;`AdminTokenCache::setAdminInfo()` 又无条件按**当前请求 IP**重写该 token 缓存的 `login_ip`。集团后端 IP 与员工浏览器 IP 不同时,其中一边会被原 `AuthMiddleware` 的 IP 绑定拒绝。
- 如果 delegate 在集团后端发起的请求中直接签发并缓存医院浏览器 token,缓存绑定的仍是集团后端出口 IP,浏览器随后访问医院会失败。不能信任浏览器自报 IP 或随意传 `X-Forwarded-For` 修补此问题。
### 0.2 “复用既有 source_token,不再签发医院会话”提案的核验
**当前原系统不支持把共享 bridge 的 source_token 原样交给医院浏览器后两边继续正常使用。** 即使医院与中心同认证域,HTTP 后端请求与员工浏览器请求的源 IP 仍不同;同域不等于同 IP。
`server/app/common/cache/AdminTokenCache.php::setAdminInfo()` 把 `login_ip` 设置为执行此请求的 `request()->ip()`;bridge 登录和 profile 请求来自集团后端。`server/app/adminapi/http/middleware/AuthMiddleware.php` 在 root 放行之前先比较缓存 login_ip 和当前请求 IP。医院浏览器取得 source_token 后,第一次普通医院 API 请求即可能报 IP 变化。把同一 token 缓存重建成浏览器 IP 则会使下一次集团后端 profile 请求失败。单纯不调用 `LoginLogic` 只能避免 token 轮换,不能解决 IP 绑定冲突。
若本次采用“只返回 source_token”捷径,必须先用**不同源 IP 的隔离集成测试**验证原 API 的真实路径;在不改变上述 IP 绑定策略的情况下,不应认定实现已完成或安全可用。不可通过信任客户端指定 IP、全局关闭 IP 检查、借用 RPA 终端或清理同一 token 缓存来绕过。共用 source_token 还意味着退出、改密与会话撤销按原共享会话联动,必须在产品行为中明确。
### 0.3 推荐最小安全会话方案
**本次最小改动:医院 SSO 浏览器使用一个新且独立的 terminal(例如 10,先全仓确认未占用),源 bridge 继续原 terminal=1;由医院浏览器 callback/exchange 请求上下文在原服务本地签发此会话。** 原 7/9 是 RPA,8 已被 AI 浏览器使用,均不可借用。新 terminal 不加入 `wecomRpaTerminals()`,不继承 RPA IP 例外。医院首次改密、企微门禁、本地角色/部门/数据范围全部照旧。
这个方案保证从集团“一键进入”不会复用或踢掉 bridge;但之后如果员工使用医院**普通密码登录 PC=1**,仍可能按原单点规则使 bridge 失效。这是保留旧共享源的阶段性边界。若本次要彻底隔离普通网页登录,改为为桥接另设 `IDENTITY_BRIDGE` 专用 terminal,把 `identity.session/login` 固定到它,并让医院继续 PC=1;要相应调整专用控制器验证器/服务严格终端白名单并在切换后要求旧 bridge 重新登录。不要直接扩大所有普通登录接口的终端权限。
中央 code 流程建议:
1. 医院浏览器访问 `/adminapi/identity.sso/start`(建议新命名,避免破坏已有 `/iam` OIDC)。医院生成 private HttpOnly/Secure/SameSite cookie 与 state/verifier,只将 S256 challenge、已登记 appId/callback、state 交中心。
2. 中心 authorize 必须核验当前集团桥接随机句柄、重新读取源真实会话、稳定 gid 的公司成员关系、医院应用 grant。中心存 code **哈希**与上述绑定,有效期 30–60 秒,随机值至少 256 bit;callback 只能精确匹配服务端注册值。
3. 医院 callback 在浏览器 cookie/state 事务验证后,以服务器机密客户端认证 + code + verifier 向中心后端 exchange。code 在事务内原子单次消费;再次核验源会话、员工停用与 membership/grant,拒绝不同 app、callback、verifier 或重复 code。
4. 中心 exchange 可在**经过应用认证的服务器回包**中把源医院 token 只交回它所属的医院后端,或者改成医院自己签发的一次性委派 grant;两者均不得进入浏览器、URL、日志或 localStorage。医院只从源 token 的真实 `admin_session` 和 `admin` 行导出 adminId;任何中心或浏览器提交的 adminId/root 都不作认证依据。
5. 医院在当前浏览器请求上下文中调用内部 delegate service:锁账号再锁源会话,重查未过期、未停用/删除;用独立 terminal 签发本地浏览器会话,缓存绑定员工真实请求 IP。如采用后端 HTTP `/identity.session/delegate`,它应只验证源会话并返回一次性本地 grant;最终业务 token 仍应在医院浏览器 cookie 绑定的 exchange 请求中签发。不要在中心后端 IP 上直接签发浏览器 token。
6. 浏览器 callback 只拿短期本地 ticket,固定跳转医院 `/admin/login?identity_ticket=...`;前端 POST 本地 exchange 才获得医院 token。先做源资格检查,再消费最终 ticket 并签发业务 token;严禁裸 source token/业务 token 进 URL。
中心 code 与源会话应按 sourceKey/application 绑定。登录交接过程中如果源会话退出、改密、停用、角色变化被撤销,要失败并重新登录。中心应用凭据只允许医院这个已登记应用,不能 exchange 其他 application 的 code。中心不按 sourceAdminId 查找任意账号再请求 delegate。
**额外必须测试:** `multipoint_login=0` 和 `1` 都不能使 bridge 被 SSO 登录旋转或改变 IP 缓存;集团后端与浏览器不同 IP 时两边都能继续访问;新 terminal 无 RPA 例外;普通 PC 密码登录导致旧 bridge 失效的预期边界有提示。原退出/改密等全会话撤销仍应覆盖新 terminal,不能留下僵尸授权。
本报告后面的 OIDC 方案保留为未来多子系统的标准化升级路线;不是本次当前医院交接的必备依赖。
## 1. 原始长期目标与可复用 OIDC 路径
**可以把 `identity-admin` 升级为集团员工与应用授权管理中心,并用现有医院 OIDC 适配器完成单点登录;当前 shared 模式本身不是集团主身份中心,也不是 SSO 服务端。**
推荐最小完整路径:
1. 集团独立维护不可变员工主 ID、公司归属、应用、应用授权、医院本地账号绑定;以成熟 OIDC 提供方承担统一凭据、浏览器 SSO 会话、签名和密钥轮换。
2. 集团后台也改为使用**同一个 OIDC 提供方**登录。只保留当前 standalone 密码登录,再把首页按钮指向医院,会再次出现 IdP 登录,不能称为一键免登录。
3. 补齐医院现有客户端已经约定的两个中心 API:`provisioning-context` 与不可覆盖的 `bindings`。
4. 首页“互联网医院”入口使用服务端配置的医院 `/adminapi/iam/start` 固定地址。医院继续签发自己的业务会话并校验本地角色/部门/数据范围,不跨系统传递中心或医院 bearer token。
5. 旧员工必须经核实建立显式绑定;新员工在获得医院应用授权后,可由医院现有首次登录开户流程生成本地账号。
该路径需要可用的身份提供方及部署配置。仓库文档出现过 Keycloak 集成说明,但本次没有读取私密配置或请求生产服务,**不能据此声称现有 IdP 仍在运行、已配置成功或可直接上线**。
如交付只包括文案、公司菜单分组和首页链接,应明确这是管理界面升级;没有中心身份表、中心应用授权、中心认证和医院信任配置,不能声称“这里创建员工即可登录各子系统”已经完成。
## 2. 现有实现与可复用点
| 位置 | 已有能力 | 可复用结论 |
| --- | --- | --- |
| `server/app/adminapi/controller/IamController.php:11` | `config/start/callback/exchange`,固定医院登录回跳、私有浏览器 cookie、no-store/no-referrer | 医院登录入口无需重写 |
| `server/app/adminapi/service/iam/IamLoginService.php:19` | 配置开关、随机 state/nonce/PKCE、浏览器绑定、一次性票据、应用授权及本地状态复查 | 保留完整链路 |
| `server/app/adminapi/service/iam/IamOidcClient.php:12` | HTTPS OIDC discovery、authorization code、S256、RS256/JWKS、iss/aud/azp/exp/iat/nbf/nonce 校验 | 现有医院是标准 OIDC 客户端,不是 IdP |
| `server/app/adminapi/service/iam/IamOidcClient.php:108` | 读取中心 `provisioning-context` | 中心接口需实现相同字段与 HTTP 语义 |
| `server/app/adminapi/service/iam/IamOidcClient.php:118` | 服务端认证的幂等账号绑定,接受 HTTP 201,之后重新读绑定确认 | 中心须拒绝覆盖已绑定的不同本地 ID |
| `server/app/adminapi/service/iam/IamAccountProvisioner.php:37` | 本地显式绑定/首次开户、并发去重、超时重试、默认医助角色和非 root 保护 | 可直接承接中心员工的医院开户 |
| `server/database/migrations/20260910_iam_local_identity.sql:3` | 不可变身份元组的本地去重账本 | 必须保留,不是中心员工主表 |
| `server/app/adminapi/service/iam/IamLoginTransactionStore.php:52` | 文件锁下单次消费,state 600 秒、ticket 60 秒 | 单医院服务器可复用;多机需共享原子存储 |
| `server/app/adminapi/service/IdentitySessionService.php` | 共享管理使用原密码与原真实会话,锁内重验、改密撤销旧会话、精确退出 | 保留为旧系统管理桥,不作为跨应用凭据 |
| `identity-admin/server/app/service/AuthService.php` | 独立账号、随机 token、仅持久化 token 哈希、每次请求检查停用/权限 | 可复用中心后台会话基础,但还没有 OIDC 登录 |
| `identity-admin/server/scripts/schema.php` | 独立 admin/role/menu/dept/session 模型 | 可增量迁移;当前没有集团员工/公司/应用/绑定模型 |
| `identity-admin/server/app/service/shared/SharedRecordsService.php` | 代理原账号、角色、菜单、部门,并保留医生资料及原语义 | 只适合医院权限维护,不应混作集团员工写入通道 |
本次查到的显式独立服务路由见 `identity-admin/server/route/app.php:8`。只有登录、当前用户、改密、退出和 admin/role/menu/dept 管理;没有 OIDC discovery、authorize/token/JWKS、应用授权、员工主表或子系统启动服务。
## 3. 原医院 OIDC 的具体流程
1. 浏览器进入医院 `GET /adminapi/iam/start`。医院生成 HttpOnly/Secure/SameSite=Lax 的浏览器事务 cookie,生成 state、nonce、PKCE verifier,向配置的 IdP 发起 authorization code 登录。
2. IdP 回调医院 `GET /adminapi/iam/callback`。医院一次性消费 state,校验 cookie,后端用 code + verifier + 机密客户端认证换取 ID token,并验签验 claims。
3. 医院根据 `sub` 请求中心 provisioning context,核验员工启用、应用授权以及绑定状态。未开通过且中心明确允许才创建本地账号。
4. 医院生成只可使用一次、有效期 60 秒且绑定当前浏览器的票据,固定跳回 `/admin/login?iam_ticket=...`。URL 中没有医院业务 token。
5. 前端向医院 `POST /adminapi/iam/exchange` 提交票据,医院检查来源并再次核验中心授权、本地绑定和本地账号状态,调用原 `LoginLogic::login()` / `AdminTokenService` 签发医院原会话。
医院现有公开登录接口:
| 方法 | 路径 | 用途 |
| --- | --- | --- |
| GET | `/adminapi/iam/config` | 只返回 enabled/loginUrl,配置不完整时关闭 |
| GET | `/adminapi/iam/start` | 首页一键入口应指向这里 |
| GET | `/adminapi/iam/callback` | 仅登记精确 HTTPS 回调 |
| POST | `/adminapi/iam/exchange` | 浏览器提交短期一次性票据,返回医院原登录结构 |
`IamOidcClient::endpoint()` 将 discovery 中的各端点、JWKS 和应用 API 限定到 issuer 的**同一 host + port**。因此中心应用 API 不能随意配置另一个域名;可按现有文档在同一个登录域名反向代理 `/iam-api`,或者明确修改并测试固定 origin 白名单,不能放宽为任意 URL。
## 4. 中心必须补齐的医院契约
### 4.1 读取授权与开户上下文
`GET /internal/v1/applications/{applicationId}/employees/{oidcSubject}/provisioning-context`
仅允许对应应用的后端凭据访问;凭据必须绑定 applicationId,不能凭 URL 中的 applicationId 越权查询其他应用。医院客户端调用时带服务端 `Authorization: Bearer ...`,不得发送到浏览器。
建议成功结构(字段名与现有客户端一致;以下只有格式,没有实际身份数据):
```json
{
"applicationId": "zyt",
"localIdentityKey": "<immutable-oidc-subject>",
"employee": {
"oidcSubject": "<same-subject>",
"status": "active",
"displayName": "<display-name>"
},
"externalAccountId": "",
"shouldCreateLocalAccount": true
}
```
规则:员工、公司成员关系、应用、应用授权必须全部启用;已有绑定时返回十进制医院 admin ID 且 `shouldCreateLocalAccount=false`;仅已明确授予应用且允许开户的新员工返回空绑定与 `true`。不存在/停用/无授权均拒绝,不从用户名、手机号、姓名或邮箱推断身份。
现有 applicationId 在文档/测试中使用 `zyt`。业务展示名改为“互联网医院”时应保留机器 applicationId,以免改变本地身份元组、服务凭据范围和 IdP client 配置。
### 4.2 首次开户后的显式绑定
`POST /internal/v1/applications/{applicationId}/bindings`
输入:`employeeSubject`、`externalAccountId`、`verificationMethod`;附 `Idempotency-Key`、`X-Request-ID`,成功 HTTP 201。现有医院发送 `verificationMethod=oidc_verified_subject_local_creation`。
中心事务约束:
- 唯一 `(application_id, employee_id)`。
- 唯一 `(application_id, external_account_id)`,避免同一医院账号被两名中心员工认领。
- 不存在时创建;同一员工、同一本地 ID 的重试返回原结果;任何一侧绑定冲突返回 409。
- 不允许 upsert 覆盖旧绑定;人工换绑另设经复核的管理操作并审计。
- 重查员工与应用授权,不因已发出的登录 code 就忽略已撤销状态。
- 幂等键绑定请求内容,不能以相同键接受不同请求体。
## 5. `20260910_iam_local_identity.sql` 的真实职责
表包含 `identity_key`(64 字符主键)、`identity_value`(元组 JSON 文本)、`admin_id`(唯一,可为 null)、`create_time`。
`IamAccountProvisioner::identity()` 使用精确的 `[issuer, application_id, subject]` JSON 作为不可变身份,再计算 SHA-256。事务锁定或插入账本、创建一个本地账号并写回 admin ID;事务提交后才调用远端绑定。远端超时后保留原账本,重试只会恢复同一个账号。
已有本地账号并不会因姓名或手机号相同而被接管。现有显式绑定也不会重写角色、密码或企微状态。
首次开户当前固定校验 **角色 ID 2、名称“医助”、未删除且未停用**;创建非 root、随机本地账号和不可知随机本地密码、`is_paw=0`,并分配医助角色。中心应用授权只是“允许进入医院”的资格,不等于可以随意指定医生、管理员或业务权限。
应保留该表,不因回滚代码而删除;更换 issuer、applicationId 或 subject 会构成新的身份。若未来迁移 IdP,需先设计显式映射迁移,不能直接改环境配置后让用户重新开户。
## 6. shared 桥接的边界
`ApiController` 在打开独立数据库前选择 `IAM_DATA_MODE`。shared 模式完全走 `SharedIdentityService`,standalone 模式走 `IdentityRepository`。这是二选一,尚未实现“集团主数据 + 医院业务授权适配”的组合架构。
shared 的信任方向是:
```text
独立界面 → 原医院 identity.session/login → 原医院会话
→ 本地私有桥接会话句柄 → 每次请求重查医院 mySelf 与权限
```
浏览器只获得桥接随机句柄;原医院 token 存服务端 `shared-sessions` 私有文件,按源 URL 哈希绑定,文件/目录受权限及锁保护。`SourceApiClient::ALLOWED` 是固定方法和路径白名单,远程只接受 HTTPS,不跟随重定向。
可复用原管理接口:
- `POST /adminapi/identity.session/login`、`password`、`logout`。
- `GET /adminapi/auth.admin/mySelf`。
- `GET /adminapi/auth.{admin,role,menu}/{lists,detail}` 与对应 `POST add/edit/delete`。
- `GET /adminapi/auth.role/all`、`auth.menu/all`。
- `GET /adminapi/dept.dept/{lists,all,detail}` 与对应 `POST add/edit/delete`。
原 `identity.session/login` 在账号行锁内重新验证原始密码,不信任桥接层传入的 adminId/root,也不依赖旧登录验证器的本地调试免密结果。不能为了“一键进入”改成接收浏览器提供的 adminId 直接签发原会话。
`SourceMapper::navigation()` 只把四个医院管理页面投影为独立壳的菜单,且强制 `pid=0`;医院菜单的公司祖先关系不会保留。因此“菜单权限公司开头”必须在集团导航层明确建模,不能只修改原菜单名称后期望 shared 映射自动呈现多公司层级。
## 7. 建议最小数据模型
不迁移或重建医疗业务数据;集团主身份与医院本地 admin ID 分开保存。
| 表/扩展 | 最少字段 | 关键约束 |
| --- | --- | --- |
| `iam_employee` | `id`、不可变 `employee_uid`、显示名、status、created/updated | 主 ID 永不回收;员工不是医院 admin ID |
| `iam_identity` | employee_id、issuer、subject、状态 | 唯一 `(issuer, subject)`;一个 IdP 身份只能归属一名员工 |
| `iam_company` | id、code、name、status | code 唯一稳定 |
| `iam_employee_company` | employee_id、company_id、status、主公司标志 | 唯一 `(employee_id, company_id)`;支持跨公司员工 |
| `iam_application` | id、code、company_id、name、固定 login_start_url、status、provisioning_policy | code 唯一;显示名“互联网医院”,保留既有机器 code |
| `iam_application_grant` | employee_id、application_id、company_id、status、granted_by/time | 唯一 `(employee_id, application_id)`;记录授权来源 |
| `iam_application_binding` | employee_id、application_id、external_account_id、verified_by/method/time | 员工/应用与本地 ID 双向唯一;默认禁止覆盖 |
| `iam_application_credential` | application_id、凭据哈希或密钥引用、scope、expires/revoked | 每应用独立凭据;不在业务表或浏览器保存明文密钥 |
| `iam_admin_company_scope` | 中心管理员、company_id、管理能力 | 集团 root 与公司管理员分开;公司管理员仅能管理授权公司 |
| `iam_audit_event` | actor、company、employee、application、action、result、requestId、time | 不记录密码、token、code、完整 session;可追踪授权/绑定/停权 |
| `iam_provisioning_job`(使用外部 IdP 时) | employee_id、操作、状态、幂等键、重试/错误码 | 防止集团写库成功但 IdP 账号创建失败造成半完成状态 |
中心现有 `admin` 可作为管理登录账号,也可通过外键关联员工;不要把旧医院的 root 标志自动映射为集团 root。密码由 IdP 管理时,中心只保存 IdP 主体关联,不同步医院密码、盐或散列。
“在这里创建员工”建议显示明确状态:待创建统一凭据 → 待授予应用 → 可进入 → 子系统已开户/待首次初始化/开户失败。只有员工身份和应用 grant 均成功后,医院入口才可启动。不要把请求发出即显示开通成功。
## 8. 公司菜单与权限语义
建议集团侧菜单显示“公司名称 → 子系统 → 功能”。最小可先做只读归组展示,同时保留医院原 `perms`。医院现有 `AuthMiddleware` 将权限字符串解释为 controller/action,直接把原 `auth.admin/lists` 改成 `公司.auth.admin/lists` 会导致匹配失效,甚至撞上历史的未登记路由放行分支。
中心自己的资源应带 `company_id/application_id`,内部权限可采用稳定机器命名空间,如 `company.<companyCode>.application.<appCode>.grant`。但授权应校验结构化公司范围和应用范围,不能只检查字符串前缀或前端菜单是否隐藏。
现有独立 `system_role/system_menu/dept` 均是全局表,没有 company_id。要支持公司管理员隔离,必须同时限制列表、详情、写入、下拉选项、关联角色/部门/菜单和绑定操作;仅在导航加一个公司目录不构成权限隔离。
## 9. 必须保留的医院安全与业务门禁
- 医院 `LoginMiddleware` 使用本地 `AdminTokenCache`,`AuthMiddleware` 继续做 IP 绑定、root 例外、菜单权限以及已有业务例外。
- 角色/部门与医疗数据范围仍由医院负责。中心“可登录”不应成为病历、处方等业务权限的替代依据。
- 新开户 `is_paw=0` 会进入原首次改密流程;非 root 且启用企微强制绑定时也要完成企微绑定。当前实现因此是“一次点击进入医院认证流程”,不是承诺新员工首次进入时无需任何初始化。
- 原 `AdminTokenService` 以 admin+terminal 维护业务会话,多点/单点策略和续期仍生效;不要直接把中心 session 填进医院 token 存储。
- 原账号停用/角色变更应走原服务逻辑撤销会话并清理鉴权缓存,不能跨库直接 UPDATE 后假设缓存同步。
- 原普通 `LoginValidate` 含同时受 debug 与本地免密开关控制的调试分支;shared 的锁内验密服务专门阻断了此分支对桥接认证的影响。部署时不可复用任意旧登录 shortcut 绕过专用服务。
## 10. 风险、部署前提与验收
1. **中心停权不是实时退出所有业务系统。** 当前 OIDC 每次新登录核验中心授权,医院既有会话可能继续使用及续期。若需要“禁用员工立即全系统失效”,增加签名/服务认证的停权事件、每应用受控撤销接口与重试审计,或在业务请求路径检查短 TTL 的中心授权版本。未实现前必须如实说明生效边界。
2. **集团登录和医院 IdP 会话必须统一。** 只建立中心本地 bearer 会话无法建立另一个 IdP 的浏览器会话;首页固定 URL 链接本身不能补足 SSO。
3. **旧账号绑定是敏感管理操作。** 禁止按同名/同手机号自动认领;明确核验、双向唯一、不可静默覆盖、可审计。医院已有 root 账号也不能直接换绑为普通员工。
4. **运行文件是单机存储。** 医院登录事务和 identity-admin shared session 使用本地私有目录。多机部署需共享原子存储、正确粘性策略或迁移数据库/Redis,并测试一次性消费。
5. **公司可见性是后端范围。** 新中心授权接口、options、详情及关联写入均需逐公司检查;保留各子系统自身数据范围。
6. **密钥和 URL 必须预配置。** 精确 HTTPS 回调、固定登录入口、同 origin 规则、服务凭据范围与密钥轮换均需就绪。不能使用用户传入的 returnUrl、app URL 或 token 跳转。
7. **不把旧系统历史未登记路由放行扩散到中心。** 中心新路由继续显式注册 HTTP 方法、认证和权限,默认拒绝。
最小验收集:
- 未授权员工、停用员工、停用公司/应用均不能获得医院登录票据。
- 同一员工在并发首次登录、中心响应超时、重试时只生成一个医院账号。
- 错误 state/cookie/nonce/PKCE/audience/issuer、过期票据、重复消费、错误应用凭据均被拒绝。
- 既有绑定不修改已有角色、部门、密码、企微状态或数据范围;冲突绑定返回 409。
- 跨公司管理员不能读取、授权、停用或换绑其他公司员工;不能通过 options 或关联 ID 越权。
- 首页卡片以 `GET /adminapi/iam/config` 与中心 grant/readiness 为准,未配置时显示待接入,不伪装成功。
- 已在集团完成同一 IdP 登录的员工点击互联网医院后无需再次输入凭据;医院仍执行首次改密和企微门禁。
- URL、前端存储、日志、审计和错误消息中没有中心密钥或医院业务 token。
已有隔离测试入口:`server/tests/IamOidcClientTest.php`、`IamLoginTransactionTest.php`、`IamProvisioningTest.php`、`IdentitySharedSessionTest.php`、`identity-admin/tests/shared-api.test.mjs`。本次只读研究未执行,正式实现应在隔离夹具上运行;不要启用会对真实库建表/删表的数据库测试选项。
## 11. 标准依据
推荐沿用 authorization code、后端 token exchange、精确回调和 PKCE 的标准组合。OIDC 的职责是验证统一身份;子系统仍需执行自身应用与业务授权。依据:[OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html)、[RFC 9700 OAuth 2.0 Security BCP](https://www.rfc-editor.org/rfc/rfc9700.html)。
这些标准来源用于支撑协议方向;上文关于现状、接口、缺口和最小改动范围的判断来自本地仓库源代码,而非生产部署验证。
@@ -0,0 +1,57 @@
# 集团身份中心交付与实测
日期:2026-10-30。本轮已按用户确认的“其他子系统以后开发,先改当前;按公司分组并兼容医院原权限”完成。
后续导航修订:用户进一步明确“部门管理、菜单管理为一级,下面是公司”,已按此替换下文原公司优先导航;最新结果见 [功能优先交付](function-first-delivery.md)。本文其余数据和 SSO 结果是此前验收时刻的记录。
## 已完成
- identity-admin 改为集团身份中心,持久化集团主 GID、公司层级和成员/应用登录资格。
- 当前公司“甄养堂互联网医院”,已接入应用“互联网医院”。支持新增/编辑/停用公司、设置上级和维护成员资格;公司编码固定,父子环由后端拒绝。
- 已为现有 212 个原员工身份登记 212 个不同且稳定的 GID,元数据与医院库分离;未复制密码或医疗业务数据。
- 菜单按公司→互联网医院→用户/角色/菜单/部门分组,附公司开头的权限命名空间;原医院权限标识、菜单 ID/父子关系、组件和业务角色保留。
- 目录请求逐次校验真实源会话、当前公司、成员及应用资格,再检查原医院权限;新公司无已接入应用时无法取得医院目录和下拉选项。
- 首页医院入口完成真实 SSO:医院端 state/PKCE、集团 60 秒单次 code、原医院 30 秒单次票据、医院浏览器同源兑换为独立终端 10 会话。源会话 IP 保护、医院 IP 绑定和原业务门禁保留。
## 真实浏览器验收
沿用用户现有原项目 `admin` 登录会话,没有索取或重置密码,没有读取浏览器 storage/token 或原服务器会话文件。
1. 集团工作台显示集团管理员、主 GID、当前公司与医院应用入口。
2. 公司管理显示当前 1 家公司;公司成员页正常读取 212 个账号及稳定 GID。
3. 点击“进入系统”后自动经过集团授权与医院兑换,进入医院原首页,加载原业务菜单。URL 中没有集团 bearer 或医院业务 token。
4. 最终 IP 修复后再次完成全流程,实际 URL 为 `http://127.0.0.1:8090/admin/stats/performance_dashboard`,无回调 query;页面身份仍为 admin。
5. 医院原“权限管理→角色”实际加载 10 行角色;集团另一个页签刷新后仍正常显示主 GID与公司管理,集团会话未被医院登录顶掉。
本次真实验收只建立正常登录会话、集团元数据和只读查询。没有对原用户、角色、菜单、部门执行测试增删改,也没有清理上一轮发现的 8 条原库历史关联。
截图:[集团工作台](group-dashboard.png)、[医院已登录角色页](hospital-sso-verified.png)。
## 验证与独立复核
| 验证 | 结果 |
|---|---|
| 集团身份、公司隔离、成员撤权与 code 生命周期 | 40 项通过 |
| 集团 HTTP 集成、CORS、并发单次消费 | 通过 |
| 原医院安全 SSO、IP、token 字段长度、源状态与门禁 | 95 项通过 |
| 旧原医院共享会话/角色 | 37 项通过 |
| 原独立模式 HTTP | 40 项通过 |
| 共享 API + 受限辅助路由 | 21 项通过 |
| 集团前端回归与公司/请求/SSO上下文 | 13 项通过 |
| 医院 PKCE/state/两阶段交换 helper | 7 项通过 |
| 集团 TypeScript 与 Vite 构建 | 通过 |
| 医院新 Vue SFC 编译、预览静态边界、PHP 语法 | 通过 |
独立安全审查发现的源 IP 旁路及原 token varchar(32) 兼容问题均已修复关闭,95 项最终回归增加了对应负向断言。审查见 [group-security-review.md](group-security-review.md)。前后端契约复核和共享回归均没有剩余阻断。
## 当前运行与边界
- 集团前端:`http://127.0.0.1:5173/dashboard`。
- 集团 API:`127.0.0.1:8081`;原身份 API 辅助器:`127.0.0.1:8082`。
- 医院同源预览:`http://127.0.0.1:8090/admin/group-login`。
医院本地预览使用原构建的隔离副本和同源登录 shell,API 基址只在副本中适配;原发布构建未覆盖。医院源码新路由和 helper 已交付,因 admin/node_modules 缺失,没有执行原医院完整生产构建。集团正式构建已经完成。
当前员工凭据仍由原医院服务验证,集团是主 GID 与公司应用入口;不是完整 OIDC Provider。其他子系统当前没有被虚构开通。公司/成员资格在集团授权及兑换时重查,已经出票有最多 30 秒在途窗口;既有医院会话仍按原账号规则撤销,本轮不提供全系统即时下线。
架构与运行说明:[group-identity.md](../../identity-admin/docs/group-identity.md);接口契约:[group-contract.md](../../identity-admin/docs/group-contract.md)。
Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

@@ -0,0 +1,26 @@
{
"verified_at_utc": "2026-11-04T09:37:22.571229+00:00",
"root_cause": "PDO SQLite 3.7.17 rejects ON CONFLICT DO UPDATE; refresh TTL error escaped the best-effort boundary",
"deployed_release": "group-sqlite-compat-20261104",
"compatibility_checks_actual_sqlite_3_7_17": 26,
"metadata_fixture_local_checks": 172,
"group_identity_local_checks": 40,
"real_menu_list_sync_list_ok": true,
"menu_nodes": 94,
"pages": 18,
"permissions": 66,
"role_grants_membership_companies_unchanged": true,
"external_group_menu_dashboard_kefu_http": 200,
"shenglingli": {
"source_admin_id": 165,
"kefu_user_id": 6,
"desktop_id": 50,
"desktop_identity": "admin:165",
"knowledge_drafts": 5230,
"generated_by_this_login": 0,
"role": "zyt_basic",
"own_scope_enabled": true,
"authorization_changed": false,
"scope_definition_clarification_pending": true
}
}
@@ -0,0 +1,19 @@
# 集团菜单故障已修复
后续用户已选择按登录ZYT账号名下知识查看,该范围已上线,见[最新验证](kf-account-scope-deployed-20261104.md)。本文保留故障当时的诊断及范围澄清记录。
集团菜单请求的实际错误为 HTTP500“服务暂时不可用”。服务器 PHP 8.2.35 使用 SQLite 3.7.17,四处 `ON CONFLICT ... DO UPDATE` 不受支持;刷新时间申请在尽力同步的捕获边界之外,异常阻断了菜单加载。故障前数据库中仍保存93个菜单节点。
已发布 `group-sqlite-compat-20261104`。三处服务中的四条写入改为事务内 `INSERT OR IGNORE` 后 `UPDATE`,保留原行和关联;自动刷新失败时可继续读取已有目录。仅切换集团专用 PHP 服务,医院与客服服务未重启。
实际服务器 SQLite3.7.17 的合成兼容检查26项通过;本机元数据回归172项、集团身份回归40项通过。生产菜单加载、显式同步、再次加载均成功:94个菜单节点、18页面、66项权限,新增节点为此前的知识数据范围项。角色授权、任职和公司指纹均保持一致。外部集团菜单页、集团首页和客服知识中心均返回200。
代码和数据库备份保留,合成数据库与临时诊断脚本已清理。[运行证据](group-menu-sqlite-incident-20261104.json)、[修复差异](../../identity-admin/.test-runtime/group-menu-incident-20261104/changes.patch)、[独立兼容检查](../../identity-admin/tests/group-sqlite-compat.php)、[生产验证要求](../../identity-admin/docs/validation.md)。
## 盛灵莉知识不可见的核对
已在客服只读核对该用户:ZYT来源管理员165,客服用户6,角色`zyt_basic`;知识查看、编辑与审核功能权限齐备,并勾选`knowledge:scope:own`。客户端50的命名空间身份为`admin:165`,保存5230条待审核知识;其中由当前客服用户6发起生成的记录为0。
现有“仅本人”按任务发起人过滤,因此该角色看不到由其他登录账号生成的这批知识。已向用户询问应采用“登录ZYT账号名下知识(含管理员代洗)”还是“本人发起清洗”,等待明确范围。尚未修改这一范围语义、角色授权或客户端管理员绑定。
身份映射研究见[账号范围审计](../../identity-admin/.test-runtime/group-menu-incident-20261104/zyt-account-scope-audit.md)。若改按账号数据,必须使用可信来源与`admin:N`命名空间,不能凭同名、同账号文本或跨身份域裸数字自动合并。
@@ -0,0 +1,154 @@
# 集团身份中心前端改造研究
日期:2026-10-30。范围:只读检查 `identity-admin/web`、对应公共 API 类型与共享数据映射、原后台已有 IAM 登录入口;仅新增本研究文档。已读根 `AGENTS.md`、`CLAUDE.md`,当前不存在 `.trellis/`、`.agents/`。未读取真实 token、`.env`、数据库或私密配置,未调用真实业务 API。
## 结论与产品边界
当前独立后台尚无“集团 / 公司 / 应用”实体。它能在独立数据库模式管理员工账号,或在 shared 模式代理互联网医院原有账号权限;把标题改成“集团身份中心”不会使它成为集团主身份源。
用户已确认本轮先做集团后台,其他子系统后续开发。当前交付应落地持久化公司树、稳定主 GID、公司选择器、按公司分组的管理菜单及首页互联网医院启动;医院原用户、角色、菜单、部门放在已接入医院公司下管理,新公司未接入应用时不显示医院数据,也不自动赋予医院权限。本轮可只登记现有互联网医院应用,不需要先做未来应用的完整 CRUD。
公司是组织与授权范围,互联网医院是归属公司的业务应用;不能把互联网医院简单当作集团本身,也不能把当前部门树直接重命名为公司树。预期免登录入口为医院 `/admin/group-login` 与集团 `/sso/authorize` 的 PKCE 往返;正式免登录验收须包含服务端交换和医院本地会话创建。
当前 shared 模式以医院身份为主,集团中心代理医院 API。目标主 ID 的权威方向相反,需要服务端迁移设计;前端可保留现有医院管理视图作为应用范围内的兼容入口,但集团公司与主 ID 不能再仅从医院菜单推导。
## 当前代码与扩展点
| 位置 | 当前行为 | 所需改造 |
| --- | --- | --- |
| `web/src/types.ts:3` | `ServiceInfo` 只有项目名、数据模式、原后台登录地址 | 增加非敏感集团展示信息与功能能力;避免将部署 URL 硬编码在页面 |
| `web/src/types.ts:9` | `Menu` 只有目录/页面/按钮、路径、组件与权限,无公司或应用 | 增加明确作用域或独立平台菜单类型;原医院菜单字段原样保留 |
| `web/src/types.ts:24` | `Department` 是纯部门树 | 增加所属公司;父部门必须属于同一公司 |
| `web/src/types.ts:33` | `Role` 是无作用域角色,授权为全局数字 `menu_id[]` | 增加所属公司与应用,明确集团管理角色和医院业务角色的区别 |
| `web/src/types.ts:44` | 用户只有角色和部门,无主 ID 与公司成员信息 | 增加稳定 `subject`、公司成员关系、主公司;保留医院外部账号 ID 映射 |
| `web/src/types.ts:57` | 当前用户是原/独立账号、平铺权限及菜单 | 返回可见公司、当前公司、已授权应用、平台权限;医院菜单权限不能自动充当集团权限 |
| `web/src/types.ts:72` | `AuthOptions` 仅 `roles/depts/menus` | 增加 `companies/applications`,并按服务端公司/应用权限筛选角色、部门与菜单 |
| `web/src/layout/Shell.vue:16` | 导航完全来自当前用户菜单;改密/绑企微门禁时清空 | 集团固定工作台 + 服务端授权的平台管理导航;公司选择须清晰显示作用范围并刷新权限 |
| `web/src/views/Dashboard.vue:10` | 将管理菜单展平取前 8 条作为快捷入口 | 另设“我的应用”卡片,优先互联网医院,显示所属公司、授权状态、进入动作;快捷管理入口可保留 |
| `web/src/router/index.ts:7` | 组件硬白名单仅工作台、账号、角色、菜单、部门、占位页 | 加入真实公司与应用管理组件及读取权限;前后端组件白名单须同步 |
| `web/src/router/index.ts:83` | 导航只展示成功注册的受权路由,隐藏按钮 | 可复用;不要把外链应用写进内部路由白名单或给外链伪造页面组件 |
| `web/src/router/index.ts:94` | 保存后重新拉当前用户、同步路由,撤权退回工作台 | 公司切换、应用授权变更与停用后应沿用同等刷新与清退机制 |
| `web/src/composables/usePagedList.ts:5` | 列表查询固定关键词/状态/页码,有请求序号防旧请求覆盖 | 扩展公司/应用筛选参数和重置逻辑;切公司时清掉旧列表及编辑状态 |
前端没有任何现成 `Company`、`Application` 组件或接口。独立后端 `scripts/schema.php` 只有 8 张账号权限表;`ApiController.php:59` 与 `SharedRecordsService.php:68` 也仅返回角色、部门、菜单选项。前端新增字段必须有服务端存储、读取、过滤与写入校验,不能只在浏览器保存公司列表。
## 最小完整导航与页面结构
建议保留现有布局和视觉基础,按公司分组组织当前可管理对象:
```text
集团工作台
集团管理
公司管理
公司工作空间(公司选择器)
互联网医院公司(已接入)
用户管理
角色管理
菜单权限
组织架构
其他公司(未接入)
暂无已接入应用
个人账号(右上角账号菜单)
```
“公司管理”排在用户、角色和菜单之前,覆盖用户要求的公司开头。无需首版增加只有一条集团记录的空泛“集团管理”页面;集团根信息和树根可直接放在公司管理页,导航目录不需要独立占位页。
- **集团工作台**:欢迎语与主 ID / 当前公司;“我的应用”作为主区域,互联网医院卡片提供“进入系统”;公司、已授权应用、角色数量作为真实统计;保留按当前权限生成的管理快捷入口。无应用权限显示空状态,服务暂不可用显示可重试错误,不把 `permissions.length` 称为全部应用数量。
- **公司管理**:左侧集团公司树或树形表格,右侧详情;至少名称、公司编码、上级公司、状态、排序。新增下级、编辑、停用、删除均须真实接口与权限。删除阻止存在子公司、组织、成员、角色或应用关系的公司;停用须明确影响范围。
- **应用入口**:本轮登记现有互联网医院即可;未来应用管理可扩为名称、编码、所属公司、固定入口、状态。应用访问授权与应用后台菜单授权分别呈现;“能进入应用”不代表获得医院全部业务权限。新公司没有接入应用时显示空状态,不共用医院列表端点伪装成该公司账号。
- **用户管理**:本轮先在医院公司显示医院原用户并增加稳定主 GID 展示/映射,保留原编辑规则;其他公司在未接入用户数据时明确空状态。后续集团人员全域管理再引入多公司成员关系、按公司角色/部门筛选;不能将主账号复制成多个互不相关账号。
- **组织架构**:公司筛选必选或从当前公司带入,部门只能挂本公司部门;集团公司树和公司内部部门树各有明确标题,避免把两个 `pid` 含义混在同一棵可编辑树里。
- **角色管理**:先选公司、再选应用/平台范围,才加载可授权菜单;列表及授权弹窗显示作用域。医院既有角色继续显示原 `data_scope`,保留未展示授权。
- **菜单权限**:先选应用作用域;医院页维护原完整菜单,集团页维护集团平台菜单。界面提示当前正在编辑哪个应用,避免误把集团本地路径写回医院菜单。
“当前公司”仅是操作上下文,不是安全边界。服务端必须校验操作者可管理的公司、子树、成员和应用;前端不能单靠筛选隐藏实现隔离。集团根权限与医院 `is_root` 要明确区分,禁止因为医院超级管理员字段为真就自动授予集团全权。
## 数据类型与表单建议
最小类型建议(名称可按后端统一):
```ts
interface Company {
id: number
pid: number
code: string
name: string
disable: number
sort: number
children?: Company[]
}
interface Application {
id: number
code: string
name: string
company_id: number
entry_url: string
disable: number
}
interface CompanyMembership {
company_id: number
is_primary: boolean
role_id: number[]
dept_id: number[]
}
```
按服务端设计,可让应用为全集团注册后通过关联表绑定多家公司;不要为了前端便利把多公司应用强行变成全局单公司归属。以上 `company_id` 是首版最小单归属模型,不预先承诺多租户应用能力。
`Users.vue:21` 的 `role_id/dept_id` 当前只有一组数组。如果新增多公司成员关系,表单需改成公司成员分组,或明确本轮只支持单公司归属,并由服务端强制。`AuthOptions` 在公司切换时重新获取,不能复用旧公司的角色部门。编辑时保留原来不可见、不可改的合法关联由服务端处理;浏览器不能凭当前可见选项删掉跨公司任职或历史医院授权。
现有保存载荷采用显式字段构造,应继续保持。`Users`/`Roles` 加公司字段后,不要将当前用户或 options 整个对象展开提交;共享医院写接口不接受的新字段应由集团接口独立保存或明确编排,避免污染医院原契约。
## 医院入口与已有登录集成
`auth.ts:14` 已把 `source_login_url` 限为 HTTP(S)、不含 URL 凭据;现在仅 `AccountRequired.vue` 使用它打开原后台完成企微绑定。将其用于首页可得到普通入口跳转,但它不是免登录凭据。
原医院前端**已有可选 IAM 客户端**,并非需要完全重做:
- `admin/src/api/user.ts` 的 `getIamConfig()` 获取 `/iam/config`,`iamLogin(ticket)` POST `/iam/exchange`,明确不带旧业务 token、不重试兑换。
- `admin/src/views/account/login.vue` 展示“统一账号快捷登录”;服务器提供固定 `loginUrl`;处理 `iam_ticket` / `iam_error` 时先清理 URL,再兑换业务会话。
- `admin/src/stores/modules/user.ts:89` 将兑换结果保存为医院自己的业务会话。
- `server/app/adminapi/controller/IamController.php` 提供 start/callback/exchange,固定返回 `/admin/login`,使用浏览器绑定的一次性 ticket。
- `IamLoginService` / `IamOidcClient` 现有实现按 OIDC discovery、授权码 + PKCE、服务端 JWT 验证、应用访问资格与账号绑定完成医院登录。服务配置要求固定 HTTPS URL。未读取现有配置,也不能声称此链路当前已启用。
而 `identity-admin/server` 当前没有对应 OIDC 提供方、应用授权与 provisioning API。故“集团主 ID + 一键进入医院”应优先对接已有医院客户端要求,或明确新增受控桥接协议;避免制造第三套互不兼容的浏览器 token 传递。
建议首页点击流程:按当前方案使用服务端受控 launch 入口导航至医院 `/admin/group-login`,由医院建立 PKCE 事务、跳集团 `/sso/authorize`,集团验证现有登录态、稳定 GID 和医院授权,再回医院完成交换并生成医院自己的业务会话。公开应用 URL 必须由服务端注册与校验,前端不允许任意 `redirect` 参数。失败应有明确错误,不能重定向循环。此专用桥接方案可与原可选 OIDC 客户端并存,避免改坏原登录入口。
## 原菜单数据与品牌保留口径
`SourceMapper.php:120` 把医院原菜单映射为本地四个管理入口,并修改返回导航的名称、`pid`、路径和组件;这是只用于导航的映射。真正菜单编辑和角色授权数据仍来自原医院完整菜单树。
必须保持已有约束:
1. `Menus.vue` shared 模式允许原相对路径或合法外链值,保留 `component/perms`;不得用 `/system/*` 或未来集团路径覆盖原 `paths`。
2. `Roles.vue:33`、`:60` 保留当前界面未展示的原授权,保留 `data_scope`,shared 模式不提交不存在的角色 `disable`。
3. `Departments.vue:33` 保护原顶级部门层级;不要为显示集团公司树就批量改医院顶级部门父节点。
4. 医院 `dept.dept/*` 到本地 `auth.dept/*` 的权限别名用于当前适配,集团新权限应有独立映射,不能滥用医院部门权限管理集团公司。
5. 真实历史菜单、角色、账号保留医院原名称、ID 与父子关系;集团导航的展示分组或文字变化不能变成原库批量重命名。
品牌修改清单:`index.html:7` 静态标题,`router/index.ts:152` 动态标题,`Shell.vue:48/54/60/64/84` 侧栏品牌/底部/面包屑/模式标签/页脚,`Login.vue:36/38/40/43/47/49/50/51/64` 登录品牌与说明,以及工作台和个人页的“团队成员”身份文案。集团名称未经用户确认时可采用“集团身份中心”;已有仓库明确甄养堂业务品牌,可在医院应用卡保留“甄养堂互联网医院”。不要虚构法定集团名称或新公司记录。
共享数据模式仍应如实显示“互联网医院共享账号数据”等说明,不能只去掉标识让用户误以为主 ID 权威迁移已经完成。开发技术状态可放次级说明或系统信息,不要占据业务首页主入口。
## 验证基线与新增验收
已用应用自带 Node 执行当前真实测试与类型检查(系统 PATH 不含 npm,因此直接调用 bundled `node.exe`):
- `node --test ../tests/session-race.test.mjs tests/shared-mode.test.mjs`:7/7 通过。
- `node node_modules/vue-tsc/bin/vue-tsc.js --noEmit`:通过。
现有测试覆盖旧会话迟到响应、共享菜单载荷保留、共享角色隐藏授权和数据范围、首次改密优先于企微门禁。没有公司/应用/首页入口测试;没有 Vue DOM 渲染或真实浏览器断言。此研究未运行构建、未连接后端或真实数据,因此不构成新功能实测。
新增功能至少应覆盖:
- 公司树增改停用、循环父级、含成员/子公司删除保护;非集团管理员越权公司 ID 被服务端拒绝。
- 账号角色部门只能选所属公司合法值;切公司后旧请求不覆盖新公司列表;编辑保存不误删不可见历史关联。
- 医院超级管理员不会因 `is_root` 自动取得集团公司修改权;公司角色授权不会扩散至另一个公司。
- 首页互联网医院卡片按应用授权显示;无授权、停用、未配置入口、认证失败均有清晰状态;按钮防重复点击。
- 应用 launch 校验 ID、已注册回跳地址与当前账号;普通入口不携带 token;一次性兑换只消费一次;登录过程中撤权仍拒绝。
- 菜单/角色保存后的原路径、原组件、权限标识、父子关系、未知授权和 `data_scope` 回归继续通过。
- 改密/企微门禁期间不提供可绕过门禁的应用入口;公司/应用管理路由直接输入地址也受权限限制。
- 1440px 与 375px 下公司选择、应用卡片、公司树、表格和授权弹窗可用;深链刷新、页面标题、导航高亮正确。
推荐按已确认范围落地公司真实 CRUD、稳定 GID、公司分组导航和空公司隔离,再接 `/admin/group-login` 与 `/sso/authorize` 的 PKCE launch 并做浏览器验收。医院旧权限保持兼容,未来公司应用与完整人员模型再扩展;当前完整交付至少包含可持久化公司和真正可进入的医院应用,不能以空白占位页或仅更换产品名视为完成。
@@ -0,0 +1,43 @@
# 集团与医院入口最终回归复核
日期:2026-10-30。范围:三组全隔离回归、SSO helper/医院 controller/预览 router 的来源与路径大小写只读检查。本轮没有改业务文件、操作浏览器、启动或重启现有服务,没有重复已通过的 HTTP 静态边界检查,也未安装原 admin 依赖。
## 回归结果
使用环境变量 `IAM_TEST_PHP=C:\Users\isard\.cache\zyt-tools\php\php.exe`,独立运行以下测试文件:
| 命令 | 结果 | Node 报告耗时 |
| --- | --- | --- |
| `node --test identity-admin/tests/shared-api.test.mjs` | 19/19 通过,0 失败、跳过、取消 | 7.24 秒 |
| `node --test identity-admin/tests/project-api-boundary.test.mjs` | 2/2 通过,0 失败、跳过、取消 | 5.23 秒 |
| `node --test identity-admin/tests/group-api.test.mjs` | 1/1 通过,0 失败、跳过、取消 | 2.94 秒 |
合计 22 个 Node 测试全部通过。其中 shared 的 19 包含一个外层测试和 18 个子测试;group 的单个外层测试内包含多项 HTTP 断言,未将这些断言重复计为测试数。
隔离依据:shared/group 测试清除继承的 `IAM_*` 配置后,注入内存源 API、随机回环端口、系统临时 runtime;group 使用临时 SQLite 路径。shared 明确关闭集团模式以复核原共享行为。project-api-boundary 使用故意不存在的原项目路径,验证白名单拒绝时不加载原服务。测试进程输出未打印响应票据或 token。
覆盖保持:原账号登录与独立桥会话、四个管理模块和字段保留、原权限拒绝、部门别名、空角色授权、首次改密与企微门禁、源撤销、退出与改密、源错误清洗;`s` 参数旁路拒绝;集团公司隔离、成员管理权限、稳定 GID、精确 redirect_uri、错误 Origin、并发 code 单次消费、无业务 token 的 ticket 响应、公司成员撤权和原账号停用。
## 同源判断复核
当前 `http://127.0.0.1:8090` 医院 origin 下,helper、预览 router 与原医院 controller 一致,没有发现阻断当前交接流程的来源校验差异:
1. `admin/src/utils/groupSso.mjs:87-100` 从当前医院 origin 构造固定 `/adminapi/identity.hospitalSso/exchange`,核对中央响应路径必须精确等于该常量;请求为 POST、`credentials: 'same-origin'`、`redirect: 'error'`。未把集团 cross-origin 请求直接发到医院兑换接口,也未允许响应指定任意医院目标。
2. `admin/scripts/hospital-preview-router.php:22-25` 只允许回环来源和 `127.0.0.1:8090`/`localhost:8090` Host。正常入口使用明确登记的 `127.0.0.1`;这两个 hostname 不能互换作为同一 origin,轻量回调 HTML 也只接受前者。
3. `server/app/adminapi/controller/identity/HospitalSsoController.php:31-34` 对浏览器 exchange 的非空 Origin 与 `request->domain()` 严格比较,并拒绝 `Sec-Fetch-Site: cross-site`。普通同源浏览器 POST 的 Origin 为 `http://127.0.0.1:8090`,与预览请求匹配。
4. 已直接核验仓库 ThinkPHP 实现:`Request.php:371` 的 `domain()` 默认调用 `host(false)`;`Request.php:1756` 只有 strict=true 才移除端口,所以默认 **保留 :8090**。另用只加载 vendor autoload、不初始化应用的纯 Request 实例验证该返回值,结果通过;没有读取原环境或数据库。
5. Origin 为空时 controller 允许进入后续票据认证,这是其对非浏览器调用的现有行为;实际身份仍依靠一次性 ticket + PKCE 和原源会话复核,不依靠 Origin 单独认证。helper 的浏览器同源 POST 与这项兼容行为没有冲突。
反向代理条件:`Request.php:1518-1527,1756-1761` 会使用转发的协议/Host。生产 HTTPS 代理必须设置并覆盖可信的公开协议和 Host,否则严格比较会拒绝合法回调。预览 router 已清除 forwarded-host/IP,但没有清除 forwarded-proto;当前直接回环、没有代理且浏览器不发送该头时不会受影响。人为传入 `X-Forwarded-Proto: https` 会造成 HTTP Origin 不匹配而拒绝,不能据此突破当前固定 Host 或 PKCE 校验。本轮遵照要求未修改路由或代理处理。
## Linux 大小写复核
当前约定路径 `/adminapi/identity.hospitalSso/exchange` 保留驼峰,helper 常量、中央 `exchange_path`、原 `HospitalSsoController.php` 一致;预览 router 最终 `setPathinfo()` 保留原路径大小写(`admin/scripts/hospital-preview-router.php:83`),没有统一 lower-case 的新问题。
共享 API 辅助器为了白名单比较会先转小写(`identity-admin/server/scripts/project-api-router.php:7`),但新增代码在进入 ThinkPHP 前将 `/identity.hospitalsso/` 显式恢复为 `/identity.hospitalSso/`(`:46-47`)。因此它也保留了 Linux 上加载新医院控制器所需的正确大小写。
风险边界:不能把整段预览 API path 统一转为小写,也不能把客户端路径改成 `/identity.hospitalsso/` 后仅凭 Windows 可用判定可发布。框架的 `Controller.php:54-58`/`App.php:592` 使用 `Str::studly` 推导类名;纯 helper 检查确认 `hospitalSsoController → HospitalSsoController`,但全小写 `hospitalssoController → HospitalssoController`。Composer 对 app 使用 PSR-4,后者与实际文件名在 Linux 不匹配。当前契约路径和辅助器的 canonical 恢复已避免该风险;任意大小写变体不属于保证支持的入口。
## 交付边界
真实账号的集团到医院浏览器闭环由根任务统一验收。本轮测试使用隔离夹具,不能替代真实浏览器 CORS/反代部署验收;既有 HTTP 静态边界检查和原 admin 缺依赖导致未做完整构建的限制沿用此前记录。本轮新增文件仅为本报告。
@@ -0,0 +1,97 @@
# 集团身份与医院 SSO 独立安全审查
审查日期:2026-10-30。审查方式:只读源代码检查与隔离夹具复核。没有修改实现,没有请求真实身份源/业务数据库,没有真实浏览器或员工登录,也没有读取真实密码、token 或会话内容。本报告中的 IP 和凭据均来自临时测试夹具。
## 结论
**两项审查发现均已修复并完成独立复核,本轮审查范围内没有剩余的必须修复项。** 中央集团授权、公司范围、主 GID 与授权码的基本设计符合本轮“现有医院身份源 + 其他子系统以后接入”的范围。最终复跑医院 SSO **95 项通过**、旧共享会话/角色回归 **37 项通过**。
本次只读确认:issue 在原账号/源 session 锁内检查源 token 缓存的账号与 IP,RPA 例外复用原精确终端/IP 规则;exchange 未新增源 IP 限制,正常集团后端出票后医院浏览器可从不同 IP 兑换。目标 token 为 128 bit 随机值的 32 字符 hex,SQLite fixture 显式限制长度不超过 32。以下保留发现时的证据及关闭记录。
## 审查发现与关闭记录
### [P1,已关闭] 医院 issue 接口允许异 IP 源 token 绕过原 IP 绑定
发现时证据:
- `server/app/adminapi/controller/identity/HospitalSsoController.php:14` 将 `issue` 与 `exchange` 都放入 `notNeedLogin`,从而跳过原 `AuthMiddleware` 的登录 IP 核验。
- `server/app/adminapi/service/IdentityHospitalSsoService.php:25` / `lockSource()` 校验真实 session、token 摘要、到期、停用与门禁,但没有核验源 token 的原缓存 `login_ip`。
- 原防护在 `server/app/adminapi/http/middleware/AuthMiddleware.php:52`;`AdminTokenCache.php:100` 按当前请求 IP 发布 token 缓存。
影响:持有一个仍有效、但绑定在另一 IP 的原医院 PC token 的请求者,可自行指定 S256 challenge 调用新 `issue`,随后持对应 verifier 调用 `exchange`,得到绑定自己 IP 的新终端 10 token。该请求原本不能通过医院普通业务 API 的 IP 核验,新接口使它重新获得了可用会话。仅在 exchange 给目标 token 保留 IP 检查不足以保留源会话的防护。
已在隔离 SQLite 复现:先运行 `IdentityHospitalSsoTest.php` 的临时夹具,再创建源缓存 IP `198.51.100.20` 的源会话;切换请求 IP 为 `203.0.113.77`,直接执行 `issue` 和 `exchange`,成功生成目标 IP 为 `203.0.113.77` 的新医院会话。复现只输出布尔结论,没有输出任何凭据:
```text
PASS hospital SSO: 88 checks; isolated SQLite and temporary private files only.
CONFIRMED: cross-IP source token can issue and exchange a fresh hospital session.
```
建议修复:仅在 **issue** 阶段按原鉴权规则校验源会话的缓存 IP 与请求 IP,并继续在账号/源会话锁内核验真实状态。若保留对 RPA 源终端的支持,只能复用原精确终端和服务器 IP 例外;不新增全局 IP 例外。exchange 正常需要允许医院浏览器 IP 与集团后端不同,不能把源 IP 约束错误套在 exchange 上。
必须新增回归:同一有效源 token 从不同 IP 调 issue 被拒绝且无新票据;正常集团后端 IP 可以 issue,随后医院浏览器从不同 IP exchange 可以成功;源 token 的 IP 缓存及原 PC 会话完全不变。
关闭复核:当前 `IdentityHospitalSsoService::issue()` 在真实源状态与门禁检查后、出票前读取 `AdminTokenCache`,核对同一 admin ID,要求缓存 login_ip 与当前 IP 相同,或符合原 `AuthMiddleware::isTrustedRpaServerRequest()` 的精确例外。该检查仍在账号/源会话事务锁内;exchange 没有套用源 IP 要求。新增回归验证异 IP 拒绝、无新增票据/会话、源缓存不变、合法不同 IP 的最终兑换及 token 长度。独立运行当前 95 项医院套件与 37 项旧共享回归全部通过,此项关闭。
### [P1,已关闭] 新医院 token 为 64 字符,原 session 表只容纳 32 字符
静态证据:
- 审查快照 `server/app/adminapi/service/IdentityHospitalSsoService.php:63` 使用 `bin2hex(random_bytes(32))`,生成 64 字符。
- 原安装 schema `server/public/install/db/like.sql:59` 定义管理员 session 表,`:63` 的 `token` 为 `varchar(32)`,并设置 token 唯一索引。
- 本次医院测试 SQLite 中 token 是 `TEXT`,不会捕获 MySQL 长度限制。
影响:保持原 schema 的 MySQL 环境不能写入新会话,严格模式下医院最后兑换失败;非严格截断也不能保持返回 token 与落库 token 一致。主流程在真实集成时已独立遇到医院兑换失败,并提示正在只读确认字段;本审查仅以仓库 schema 和生成表达式为证,没有读取真实数据库。
建议修复:兼容原 32 字符上限,采用 `bin2hex(random_bytes(16))`(128 bit 随机值);不为此迁移业务 session 表。票据/code 可以继续使用各自独立存储的 64 字符。测试 SQLite 对医院最终 token 加 `CHECK(length(token)<=32)` 或显式断言长度,避免再次出现被宽松夹具漏检的 schema 不兼容。
关闭复核:已只读确认当前服务改为 `random_bytes(16)`,SQLite session fixture 增加 `CHECK(length(token)<=32)`,并有最终 token 为 32 字符的断言;独立运行当前 95 项医院套件通过。本审查没有自行访问真实 MySQL,此项代码与隔离验证关闭。
## 已确认的中央控制
| 检查点 | 证据与判断 |
| --- | --- |
| 主 GID 稳定 | `GroupStore::identity()` 对源 ID 用持久 subject 主键和随机 GID,`INSERT OR IGNORE` 不覆盖已有 GID,不按姓名/手机号合并;group_meta 绑定精确 sourceKey,源 URL 改变会 fail closed |
| 默认医院归属与撤权 | 原医院来源用户首次登记默认公司 1;已存在的 membership 采用 INSERT OR IGNORE,不会把明确撤销的 0/0 行重新开通;隔离回归覆盖刷新不重新授权 |
| 集团管理员 | `GroupService::isOwner()` 同时要求当前源 profile 为 root 和 ID 在显式配置列表;普通医院 root 不会仅凭 root 自动获得集团公司管理权限 |
| 公司目录隔离 | `SharedIdentityService` 在 `SharedRecordsService` 之前调用 `requireDirectory()`;核验 membership、can_login、公司与父公司的启用状态;只有公司 1 可以访问医院目录,新公司即使获得成员关系也返回 409 |
| 旧医院权限兼容 | 集团 `company_permissions` 是附加投影,原 `permissions` 交由 SharedRecordsService 和原 API 检查;没有改原菜单 ID、perms、角色或业务数据范围 |
| 输入与路由 | 中央显式注册方法和完整路径,服务端输入字段白名单,X-Company-Id 为严格整数;standalone 模式拒绝集团端点 |
| 回调地址 | `registeredClient()` 固定 client 为 internet-hospital,redirect 与服务端配置逐字相等;远程必须 HTTPS,仅回环可 HTTP;不采纳浏览器任意 return URL |
| PKCE 与授权码 | code 为随机 256 bit,仅存 SHA-256;绑定 session 摘要引用、员工源 ID、公司、client、redirect 与 S256;60 秒有效,单个源会话最多 8 个待消费 code |
| code 单次消费 | `GroupStore::consumeCode()` 在 BEGIN IMMEDIATE 下检查并写 used_at,错误 challenge 不消费有效 code;HTTP 隔离测试并发兑换一个成功、一个 422 |
| 身份再核验 | 中央 exchange 通过服务端 session 摘要恢复原桥接会话,重新读源 profile 并比对源 ID,再核验公司资格;不信任浏览器提交 adminId/root |
| 医院票据衔接 | 中央只请求医院 issue,返回 ticket 与固定 exchange_path,不返回源 token;医院票据绑定源 session ID/token 摘要和同一 S256,最终账号由医院真实源会话导出 |
| 医院终端隔离 | 终端 10 与原 PC=1 分开;目标 DB 写入与源重查同事务锁,提交后再发布浏览器 IP 缓存;源 issue 已校验原 IP 绑定,目标 exchange 保持合法跨 IP 交接 |
| 敏感值保护 | 集团授权码表只存 session 摘要引用;HTTP no-store/no-referrer;医院票据仅存源 token 摘要;审计没有 code、ticket、密码或 token |
## 撤权与原子性边界
1. **公司/成员撤权发生在中央兑换之前**:中央 exchange 会重查并拒绝;现有 group-identity/group-api 测试覆盖。源 bridge 退出、源会话撤销、账号停用或初始化门禁变化也会阻止交接。
2. **中央已经发出医院 30 秒票据之后**:医院最后一步只知道原源 session 与 PKCE,不读取集团 membership。此时单独撤销公司成员资格,不会作废已发出的短票据;它仍可能在剩余寿命内建立医院会话。文档中的“公司停用阻止新 SSO 登录”应明确为中央授权/兑换时检查,不是对在途票据即时撤销的保证。
3. **已经建立的医院业务会话**:不随集团 metadata 的 membership 变化即时撤销,继续执行原医院停用、改密、过期和退出策略。这是本轮明确保留的能力边界,不能宣传成全系统即时下线。
4. **跨存储不作分布式事务**:中央 code 先消费、源/公司再检查、最后请求医院 issue;任何后续失败都会要求重新发起,属于安全的失败关闭。公司检查与远端出票之间没有共同事务,不能保证撤权与远端动作同时提交。
5. **源系统仍是认证信任根**:显式 owner ID 列表限制直接调用集团管理 API 的人员;医院原 root 对源账号/密码的既有管理能力仍在。因此本轮不是对医院 root 的完整身份信任隔离。
6. **单机部署**:集团 SQLite 写锁与医院私有票据目录分别保证各自单次消费;不能直接横向复制各自数据库或 runtime 后声称多机仍有全局一次性语义。
上述第 2 项是需要明确记载的短期在途边界;若产品要求撤权后连已发 ticket 也绝不能新签会话,必须增加医院最终兑换时的集团资格确认或可撤销委派标识。本次已批准范围不包含即时全局撤销,不能仅凭这项边界把所有已验证的授权控制认定失效。
## 复核测试
以下测试全部使用隔离数据,不访问真实源:
```powershell
& 'C:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe' -d extension=pdo_sqlite identity-admin/tests/group-identity.php
$env:IAM_TEST_PHP = 'C:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe'
node --test identity-admin/tests/group-api.test.mjs
```
结果:
- `group-identity.php`:**40 项通过**。
- `group-api.test.mjs`:**1 个 HTTP 集成测试通过**,含未认证拒绝、非 owner 拒绝、新公司目录/options 隔离、错误公司头、精确回调、异源拒绝、并发 code 单次消费、撤权与源账号停用。
- 发现阶段的医院旧基线为 **88 项通过**,随后隔离复现确认源 IP 旁路;旧基线未覆盖异 IP source issue 和 MySQL token 长度限制。
- 修复后独立运行 `server/tests/IdentityHospitalSsoTest.php`:**95 项通过**,新增源 IP 负向断言与 32 字符长度限制。
- 修复后独立运行 `server/tests/IdentitySharedSessionTest.php`:**37 项通过**。
本报告不对真实部署配置、数据库 schema、反向代理真实 IP 解析、生产 TLS、Windows ACL 或实际浏览器端到端行为作独立验证结论。两项问题已完成源代码与隔离回归复核,真实部署验收仍由主流程在其已授权范围内核对。
@@ -0,0 +1,44 @@
# 集团密码与角色同步:中央桥接独立审查
审查日期:2026-10-30。范围为中央共享服务、集团元数据及 SSO 链路;没有操作浏览器、真实配置、原业务库或真实会话。已读根 `AGENTS.md`、`CLAUDE.md`;本工作区没有 `.trellis/`。
## 结论
在 `IAM_DATA_MODE=shared` 下,中央管理员改密、改用户角色、改角色授权直接写原互联网医院 API,目标仍是同一个原账号 ID。中央没有另存一份密码或业务授权,因此本需求不需要新增中央同步队列、账号副本或权限缓存。必要修复应位于原系统写事务:安全状态变化时撤销受影响账号全部原会话(包括医院独立终端 10),并清理相关登录/授权缓存;登录与医院票据兑换必须沿用相同账号行锁顺序。本审查未改中央业务代码。
## 已确认的保证
| 要求 | 代码依据与结果 |
| --- | --- |
| 管理员编辑空密码不改密 | `SharedRecordsService.php:135` 的 `saveAdmin()` 读取当前原详情后合并输入;编辑省略 `password` 或值为 `''` 都不会向原端提交 `password`/`password_confirm`。非空值通过 6–32 字节校验后,同时提交新密码和确认值;原 `id`、账号及未编辑字段保留。 |
| 写原记录而非集团副本 | 用户编辑调用 `POST auth.admin/edit`,角色授权调用 `POST auth.role/edit`;`SharedRecordsService.php:166` 保留原 `data_scope`,并让显式 `menu_id=[]` 原样清空可见授权。对编辑者不可见的旧菜单授权依原有规则保留。 |
| 不因后续读失败伪报保存失败 | `SharedRecordsService.php:61` 的 `write()` 仅请求原写接口并返回 `[]`,没有成功写入后的详情/列表回读。新测试把写后的所有 GET 设为故障,保存仍成功。前端保存后刷新失败应由前端独立呈现。 |
| 每个操作使用实时权限 | `SharedIdentityService.php:36` 的普通受保护请求先解析本地 bridge,再 `GET auth.admin/mySelf` 校验原会话、身份与停用状态;读取最新角色、菜单、权限后才进入目录和操作鉴权。`SharedRecordsService` 的读缓存仅活在一次服务实例内。原返回 401 会删除本地 bridge 文件。 |
| 本人改密撤销本地 bridge | `SharedIdentityService.php:57` 调用原 `identity.session/password`,成功后 `SessionStore.php:80` 按 source key 和原 admin ID 撤全部本地 bridge。普通管理员重置他人密码依赖原会话撤销,随后原 profile 重验拒绝并清掉被使用的旧 bridge。 |
| 已签发中央 code 不绕过撤权 | `GroupService.php:268` 先以 PKCE、client、redirect、有效期和单次消费校验 code,再解析引用的 bridge、实时读取原 profile、核对原身份、首改密/企业微信门禁及公司资格;全部通过后才向原医院请求 ticket。旧原会话被撤后不会因已有 code 再取得 ticket。 |
| 已签发医院 ticket 不绕过原会话撤销 | `server/app/adminapi/service/IdentityHospitalSsoService.php:53` 在兑换时再次锁原账号及源 session 行,校验 session ID、token hash、有效期、账号状态和门禁;ticket 本身不携带可替代源会话的身份快照。因此管理员密码/角色事务只要撤销源 session,待用 ticket 也拒绝。已有 `server/tests/IdentityHospitalSsoTest.php` 包含源会话到期、轮换、删除、账号停用、首改密、企业微信及本人改密后的兑换拒绝。本子任务仅阅读该既有测试,未声称本轮重跑。 |
| 公司范围在源写之前校验 | `SharedIdentityService.php:77` 先调用 `GroupService::requireDirectory()`;无当前公司登录资格返回 403,已获资格但未接医院目录的其他公司返回 409,均不会向医院写数据。集团 owner 也不能绕过该资格。目录目前只接公司 1。 |
| GID 映射稳定 | `GroupStore.php:75` 按原 `source_id` 持久化随机 GID,账号改名、改密和角色变化不会重新绑定;不同 ID 不共用 GID。`GroupStore.php:36` 把库绑定到 source key,源 API 变化时拒绝复用并要求受控迁移。已撤销 membership 由 `INSERT OR IGNORE` 保留,不因刷新重开。 |
## 独立回归交付
新增 `identity-admin/tests/group-write-through.test.mjs`,执行真实 `SharedIdentityService`、`SharedRecordsService`、`SourceApiClient`、`SessionStore`、`GroupStore` 和 `GroupService`。仅 `SourceApiClient` 的传输边界被隔离原 API 替身替换;替身内存模拟原密码校验和安全变更撤会话契约。使用系统临时目录中的独立 SQLite 和会话文件,清除继承的所有 `IAM_` 环境变量,显式注入测试配置,定义不读配置的 `env()`,不启动应用、不加载 `.env`、不访问网络。结束时仅清理本测试创建且路径校验通过的临时目录。
本轮执行:
```powershell
$env:IAM_TEST_PHP = 'C:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe'
node --test identity-admin/tests/group-write-through.test.mjs
```
结果:**1 个测试通过、47 项服务断言通过**,PHP 8.2.9 + `pdo_sqlite`。覆盖空值/省略密码、重置同一原账号、本人改密、用户角色与角色菜单授权写穿、写后读故障、旧 bridge 与待用 code 拒绝、新权限逐请求读取、公司边界、GID 稳定及源切换拒绝。code 的撤销检查特意放在使用旧 bridge 请求 profile 之前,证明兑换本身会读取并拒绝已被原端撤销的会话。
这些断言证明中央正确调用和依赖原系统契约,不代替原系统真实 `AdminLogic`/`RoleLogic`/`MenuLogic` 的事务、缓存和并发测试,也不代替线上部署与浏览器验收。
## 边界与最小改动建议
本轮密码/业务权限同步没有发现必须新增的中央业务改动;应以原系统管理员密码、角色、菜单变更测试确认“撤销原 session + 清缓存 + 同序行锁”已实际落实,尤其覆盖原登录终端与医院终端 10。
单独的既有边界:公司 membership 或公司停用会在中央 code 兑换时重验,但医院 ticket 已签发后,医院 30 秒兑换窗口只重验原账号/源会话,没有回查集团资格;集团公司资格撤回也不会单独撤掉已经建立的医院终端 10。这与本轮“改密码和原业务权限”不同。若以后要求公司资格撤销也立即退出医院,最小接入点为 `GroupService::saveMember()`/`saveCompany()` 的受影响身份失效通知,以及医院 ticket 兑换/业务会话的公司资格验证;不能只删除中央 code 或 bridge 文件来承诺已有医院会话立即失效。
补充非阻断事项:`group.sso.exchange` 走专用入口,原 profile 返回 401 时不会进入普通 dispatch 的本地 bridge 清理分支;认证仍拒绝,code 已消费,后续普通请求会清理 bridge,文件也有 TTL。如需要更及时的文件清理,可在 `GroupService::exchange()` 捕获原 401 后撤销相应会话引用;这不是密码/权限访问控制漏洞。
@@ -0,0 +1,114 @@
# 互联网医院入口与前端登录接入研究
研究日期:2026-10-30。范围:只读代码、公开仓库配置与文档;未读取私密 `.env`、浏览器 storage、实际 token/session,未启动服务、修改业务代码或访问线上系统。已读取根 `AGENTS.md`、`CLAUDE.md`;当前工作区未找到 `.trellis/`。
最新任务边界:当前只做集团后台与医院入口,其他子系统后续开发。主实现已决定由中央提供 PKCE authorize/exchange,医院提供独立 `/group-login` 消费 `code/state`;下文“共享交接方向”是已有代码可借鉴点,中央方案应优先,不必额外实现一整套平行的 shared issuer。
## 结论
“互联网医院系统”应默认指原员工管理后台 `admin/`,不是 `pc/` 患者公开站。原后台生产公开地址的仓库证据为 `https://admin.zhenyangtang.com.cn/admin/`;本地 Vite 固定端口为 `5555`,base 为 `/admin/`,因此前端入口为 `http://127.0.0.1:5555/admin/`。这些是静态代码/文档证据,未核验当前服务是否正在运行。
`identity-admin` 共享模式已经使用原员工账号登录,且原业务 token 只留在独立后台服务端。首页目前没有互联网医院入口,`source_login_url` 仅是服务器配置的普通链接,不能单独提供免再次登录。
原后台已有安全的一次性 ticket 登录范例:`/adminapi/iam/start → callback → /admin/login?iam_ticket=... → POST /adminapi/iam/exchange`。但它是连接外部 OIDC 身份提供方的客户端;`identity-admin` 不是该提供方,因此不能只把 IAM issuer/login URL 改成独立后台地址就复用。适合沿用其短期单次票据、浏览器绑定、来源验证、去除 URL 票据和原 token 缓存的设计,在共享模式增加专用的会话交接。
## 原后台 admin 登录与路由
| 项目 | 证据与行为 |
| --- | --- |
| 本地入口 | `admin/vite.config.ts:48,52`:base `/admin/`,端口 `5555`,绑定 `0.0.0.0`;`npm run dev` 执行 `vite`。 |
| API | `admin/src/config/index.ts`:`VITE_APP_BASE_URL` + `/adminapi`,terminal 固定 1;未读取实际 env 值。Vite 现有代理只有 `/uploads` 与 `/api-proxy`,没有通用 `/adminapi` 开发代理。 |
| 密码登录 | `admin/src/api/user.ts:5` 调 `/login/account`;`stores/modules/user.ts` 缓存响应 `token/is_paw`。 |
| token 消费 | `admin/src/utils/cache.ts:2` 使用 `like_admin_` 前缀;`cacheEnums.ts:4` 的键为 `token`,即源码定义的 `like_admin_token`。`utils/request/index.ts:28` 把它放在 HTTP `token` header;不是 identity-admin 的 Bearer 会话句柄。这里只研究源码,未读取存储值。 |
| 当前用户 | `/auth.admin/mySelf` 返回 `user/permissions/menu`,`stores/modules/user.ts` 转成动态路由。 |
| 首次改密/企微 | `permission.ts:119,124,164,169` 与登录成功处理均保留 `is_paw=0 → /change-password`、`need_bind_work_wechat → /bind-work-wechat` 门禁。SSO 不应越过这些门禁。 |
| 首页 | `PageEnum.INDEX` 为 `/`;`permission.ts` 查找首个可显示的 C 类站内菜单,作为 `INDEX_ROUTE.redirect`。无有效菜单会清会话并转 `/403`,原后台没有对所有账号固定开放的工作台。 |
| 静态登录页 | `router/routes.ts` 已有 `/login`;`permission.ts:84` 放行该页。建议专用 SSO 回调仍落在该页,减少新增免登录路由及守卫分支。 |
| 页面路径 | `router/index.ts:30` 从 `paths` 拼路由、`:54` 从 `component` 加载 `src/views/**/*.vue`;`:38` 从 `name` 取展示标题。 |
生产部署中 `server/route/app.php` 提供 `/admin/:any`、`/pc/:any` 的入口回退,但其 pattern 为 `\w+`;多层前端 deep link 通常还需要 Web Server 正确回退。应继续使用固定 `/admin/login` 回调,避免把任意业务 deep link作为服务器 redirect。
## 现有 IAM 快捷登录可借鉴部分与边界
- `server/app/adminapi/controller/IamController.php`:`config/start/callback/exchange` 免旧登录中间件;固定回 `/admin/login`;`Cache-Control: no-store`、`Referrer-Policy: no-referrer`;独立 `ZYT_IAM_BROWSER` HttpOnly、Secure、SameSite=Lax cookie,path `/adminapi/iam`。
- `service/iam/IamLoginService.php`:state 600 秒,ticket 60 秒;兑换重验用户授权/停用状态,然后走原 `LoginLogic`;校验 Origin 与配置的固定 HTTPS public origin。
- `service/iam/IamLoginTransactionStore.php`:文件名只含随机票据的哈希;浏览器指纹为 cookie 的哈希;排他文件锁下清空后返回,有并发重放保护。多机部署需要共享原子存储。
- `admin/src/api/user.ts:55`:兑换 POST,`withCredentials: true`、`withToken: false`、`isOpenRetry: false`,避免带旧账号 token 或自动重放。
- `admin/src/views/account/login.vue:160`:先同步 `history.replaceState` 清理 `iam_ticket/iam_error/code/state`,再 await 兑换;成功存现有 token、按首次改密/企微门禁分流。新共享交接参数应独立命名,避免被现有企微 `code/state` 分支吞掉。
- 当前 IAM public origin 和按钮只允许 HTTPS,cookie 也是 Secure;不能假定该现成外部 OIDC 流程能直接跑在 HTTP `:5555/:8082`。本地开发需要专用回环地址策略与代理/同源部署,不能全局放宽生产 HTTPS 校验。
## identity-admin 共享模式及入口条件
`SharedIdentityService::login()` 使用 `POST identity.session/login` 调原端并取原 token,随后 `SessionStore` 创建浏览器使用的独立随机句柄。后续每次调用先取回服务端原 token,再调原 `/auth.admin/mySelf` 核验 ID/停用状态。`SourceApiClient` 严格列举可跨桥接口;`project-api-router.php` 也有独立 HTTP method/path 白名单。新增交接接口必须同时更新这些明确白名单。
`SharedIdentityService::sourceLoginUrl()` 从服务器读取 `IAM_SOURCE_LOGIN_URL`,当前校验只到 scheme、host、userinfo 和控制字符,未限制固定 path、query 或 fragment。因此不要把其任意值直接拼接会话 code。应新增或收紧为明确允许的医院 public origin + 固定回调路径,服务端产生完整跳转 URL。共享与 standalone 要明确区分:独立空库账号没有原医院账号,不应出现“已共用账号”的误导性免登录入口。
相关前端:
- `identity-admin/web/src/views/Dashboard.vue`:首页目前只有身份统计和权限菜单快捷入口,适合增加医院系统卡片/按钮及明确不可用状态。
- `web/src/types.ts`:`ServiceInfo/CurrentUser` 已有 `data_mode/source_login_url`,可追加服务端认证能力或入口描述字段。
- `web/src/router/index.ts`:所有登录用户可进 `/dashboard`;需要改密或企微绑定者被强制分流。若采用浏览器往返握手,需要一个明确的授权回跳页,并保证它在适当门禁下处理跳转。
- `web/src/views/AccountRequired.vue`:已给待绑企微用户提供原后台链接;可复用新交接能力,让用户在原后台完成现有门禁,不能借入口直接获得医疗业务访问。
## pc 是另一类账号入口
`pc/` 是 Nuxt 3 公开站,`npm run dev` 默认 `:3000`(`pc/README.md`),base、API 域名与前缀通过 `nuxt/env.ts` 的 `NUXT_*` 配置读取;未读取实际 env。API `pc/api/account.ts` 指向 public `/login/account/register/scanLogin`,使用患者端 terminal/channel。`pc/stores/user.ts` 使用 `useCookie('token')`,`utils/http/index.ts` 把该 token 放入 header,微信回调由 `middleware/wxlogin.global.ts` 处理。没有发现共享员工后台的 SSO 消费点。
`pc/constants/menu.ts` 的“管理后台”只是 `/admin` 导航。原 admin 员工 token 不等于公开 PC 患者 token;员工共享登录本次只需接 `admin/`,无需改 `pc/`。
## 公司名称前缀的前端兼容性
若“公司前缀”仅加在菜单 `name` 展示名称上,原后台 `router/index.ts:38` 与侧栏 `layout/default/components/sidebar/menu-item.vue` 都直接展示名称,路由及组件仍用 `paths/component`,权限仍用 `perms`。不需要把中文公司名写入路由/权限字段。
独立后台菜单列表、父菜单下拉与角色树均消费 `name`,可以展示前缀;但共享模式的工作区导航是投影:`SourceMapper::navigation():121-137` 把四个管理菜单名称硬编码重写为“用户管理/角色管理/菜单管理/部门管理”,因此修改原菜单 `name` 后,导航不会自动显示公司前缀。若要求前缀贯穿工作区导航,应在该投影层保留/构造显示名,或者在独立前端统一做展示修饰,保留原 `id/paths/component/perms`。
原菜单名称的数据库及验证器长度须由后端研究核对;独立前端目前输入 `maxlength=64`。为避免重复前缀,应明确只维护一个来源,并采用幂等处理,不能每次刷新直接再次拼接。
## 安全交接的最小可行方向
共享模式由已认证的独立后端向原后端请求短期单次 code;原后端由真实、未过期的当前 source token 解析原 admin ID,绝不接受前端提交 account/admin_id 决定登录身份。原前端以 POST 兑换 code,响应里的业务 token 才进入既有缓存。兑换前后重验原账号与原会话,源会话撤销、改密、停用以及过期应使尚未兑换 code 失效。URL 全程不能包含 source token 或独立 Bearer 句柄。
单次 + TTL 不能独自解决 code 被转发/登录 CSRF。优先沿用现有浏览器绑定范例:医院侧匿名 start 先设置 HttpOnly cookie 和 state,固定跳独立前端授权页;独立前端用已有会话 POST 授权,独立后端用其服务端 source token 向原端签发绑定该 state 的 code;固定返回医院登录页并 POST code + state 兑换,要求原 cookie 匹配。全程固定目标 origin/path,响应 no-store/no-referrer,先清 URL 后异步兑换,禁自动重试。若采用别的同等浏览器绑定方式,应给出对跨浏览器拷贝 code 的拒绝验证。
新登录若调用 `AdminTokenService::setToken()`,必须审查 multipoint_login=false 的行为:原服务会轮换相同 terminal 的 token,可能使独立桥正在持有的 source token 立刻失效。为了实现持续“共用账号”而不是跳转后踢掉入口,应设计明确的会话交接语义,例如在原端认证/账号锁内授权复用原有效会话,或原子签发并更新独立桥持有的 token,不能先孤立签发一个新 token 再忽略桥会话失效。
## 最小可实现文件清单
推荐新增专用 shared-hospital 接口,不修改外部 OIDC 协议。具体命名由实现决定。
| 文件 | 最小职责 |
| --- | --- |
| `identity-admin/web/src/views/Dashboard.vue` | 医院系统入口、处理中与失败反馈。 |
| `identity-admin/web/src/types.ts` | 服务端入口能力字段。 |
| `identity-admin/web/src/router/index.ts` + 新授权回跳页 | 若使用医院侧浏览器绑定 start,接收 state 后以现有身份授权并安全回医院。 |
| `identity-admin/server/route/app.php`、`app/controller/ApiController.php` | 注册共享模式交接 operation,standalone 明确不支持。 |
| `identity-admin/server/app/service/shared/SharedIdentityService.php` | 用桥会话 source token 请求签发,固定 URL,保持原门禁。 |
| `identity-admin/server/app/service/shared/SourceApiClient.php` | 仅白名单新增必要交接方法/路径。 |
| 原 `server/app/adminapi/controller/identity/SessionController.php` 或新独立 controller | 浏览器 start、经源 token 认证签发、POST 兑换入口;免旧 middleware 不等于免新服务内部认证。 |
| 原 `server/app/adminapi/service/IdentitySessionService.php` + 新票据存储/service | 原子认证、短 TTL 单次 code、源会话绑定、目标浏览器绑定、撤销复核、固定 redirect。可抽用现有 IAM store 的通用实现,但不能混用其 kind/目录/issuer。 |
| 原 `admin/src/api/user.ts`、`stores/modules/user.ts`、`views/account/login.vue` | 独立命名回调参数 → 清 URL → 无旧 token/无重试 POST 兑换 → 既有缓存与门禁。 |
| `identity-admin/server/scripts/project-api-router.php` | 仅开放新增交接的精确 method/path;当前辅助器不服务整个原医院前端/API。 |
| `identity-admin/integration/original-server/` 同步原端文件 | 保持独立交付可复现。 |
| `identity-admin/server/app/service/shared/SourceMapper.php` | 只有需要工作区导航也显示公司前缀时才改。 |
| 对应隔离测试与 docs | code 单次/并发/过期/错浏览器/错源/撤权/源登出与改密/首次门禁/同 terminal 单点行为;不得对真实账号写入。 |
本地若要真正打开原医院全部业务,不能只使用当前 `:8082` 共享辅助器,因为它有意只开放账号管理 API;须用正常原后端(项目文档默认 `:8080`)配合 `:5555` 前端,并让 API、SSO cookie 与回调在设计的同源或受支持跨源模式下工作。没有读取私密配置,因此无法断言当前 API 指向本地还是线上。
原 `admin/npm run build` 的 release 脚本会删除并覆盖 `server/public/admin`;`pc/npm run build` 同样会覆盖 `server/public/pc`。实现阶段如仅验证编译,应调用纯 Vite/Nuxt 构建或已明确安全的命令,不能把发布复制当普通检查。
## 本地已有构建与 /group-login 补充
实地文件检查确认:`admin/node_modules` 不存在,`admin/dist/index.html` 不存在;`identity-admin/web/node_modules` 存在。原 ThinkPHP 的 `server/vendor/autoload.php` 与 `server/config/install.lock` 存在,因此不依赖重新安装 admin npm 包也有可用于本地启动的原服务及原前端产物。
`server/public/admin/index.html` 存在(约 31 KiB),引用 `/admin/assets/index-BJHYjIjI.js` 等资源;assets 共 496 个文件。已有构建包含 IAM ticket 登录处理,但未搜到 `group-login`。其入口 JS 的公开配置字面量为 `baseUrl:"https://admin.zhenyangtang.com.cn//"`、`urlPrefix:"adminapi"`,所以直接把它挂到本地静态服务器后仍会请求线上 API。当前不能把“本地能打开 HTML”当作本地医院可用或可安全验收。
新 `/group-login` 可以作为医院服务器提供的独立轻量 HTML/JS 入口,与既有 `/admin/` 构建共用同一个 origin。它独立完成 start/callback、PKCE 和会话换取,再按源码约定写入本地 `like_admin_token` 的 `{value,expire}` JSON envelope,最后 `location.replace('/admin/')`;之后原 Vue 路由、菜单、改密/企微门禁继续处理。这样无需为了增加一个回调页立即重建整个 admin。该适配应由源文件生成/维护,勿通过替换旧 bundle 中某个函数来实现登录。
但本地必须解决已有 bundle 固定线上 API 问题。可选方案:
1. 首选安装原 admin 依赖,用明确的本地非私密 API 配置运行 Vite或纯 `vite build`,输出到隔离目录,跳过 release 脚本;新增路由/页面可编译进入正常前端。
2. 只为本地可审核预览,在任务专属目录复制既有构建,把入口 JS 中唯一、已核验的公开 API baseUrl 字面量改为本地医院同源 `/`,并让本地路由器只提供这份预览产物及真实原 API。保留原 `server/public/admin` 不动,记录该预览适配不是完整源码构建验收。开始前应检查待替换字面量出现次数恰好为一,避免宽泛替换/远程意外访问。
PKCE 的 sessionStorage 是 **origin 隔离** 的。如果 verifier 在集团 `:5173` 的 sessionStorage 中生成,医院 `:5555` 或另一个端口的 `/group-login` 无法读取它。医院入口必须先在医院 origin 初始化 verifier/state,再跳中央 authorize;中央回调只带 code/state,回到同一医院 origin 读取 verifier 后兑换。也应校验中央返回/授权登录的当前身份,防止旧医院 localStorage 账号抢先通过路由守卫。独立 HTML 入口可以在原 SPA 加载前完成这一点。
中央 `/authorize` 中的 redirect_uri 必须登记固定医院 `/group-login`,`/exchange` 原子消费 code 并校验 client_id、redirect_uri、S256 verifier;浏览器回调立即清 URL。医院后端应根据中央已核验身份映射现有 admin ID,禁止仅按前端提交用户名决定身份。若中央共享会话已持有原有效 source token,可审查后授权交接该会话,以避免原 `multipoint_login=0` 下再次 setToken 把集团桥会话踢掉;其 source token 仍只能通过受控 POST 响应进入医院缓存,不能进入 URL。
@@ -0,0 +1,5 @@
{
"pid": 11152,
"port": 8090,
"path": "C:\\zyt\\.test-runtime\\hospital-preview"
}
@@ -0,0 +1,46 @@
# 医院集团登录前端与本地预览
完成日期:2026-10-30。按 `identity-admin/docs/group-contract.md` 实现。本次没有读取私密环境文件、浏览器存储值或真实会话,没有使用真实账号登录、写业务数据、修改中央服务或原发布构建。
## 已实现
- 原 Vue 源码新增 `admin/src/views/account/GroupLogin.vue`,静态路由 `/group-login`(部署 base 后为 `/admin/group-login`),加入免登录白名单,避免旧医院登录态提前把回调改写;网站默认标题为“互联网医院”。
- `admin/src/utils/groupSso.mjs` 与对应声明文件提供同一份可测试的 PKCE/事务逻辑:医院 origin 创建 crypto 随机 verifier/state,S256 challenge 授权跳转;sessionStorage 只留 5 分钟事务,不存业务 token;回调同步清除全部 query/hash,单次取出并删除事务,校验 state、时间、精确回调 origin/path、重复参数及固定集团 origin。
- 中央兑换 POST 使用公开 `/adminapi/group/sso/exchange`,不携带旧医院 token 或集团 Bearer;只接受固定医院 exchange_path,再同源 POST `{ticket,code_verifier}`。两次请求均禁止 HTTP redirect,不自动重试,不把响应/凭据写日志。
- 原源码在成功后清理旧动态路由/账号状态,写原 `cache.set(TOKEN_KEY, token)`;按原首次改密/企微绑定标记分流,普通情况进入原医院权限菜单。没有绕过原业务守卫。
- `admin/public/group-login.html` 是固定 `http://127.0.0.1:8090` 的轻量预览适配页,复用同一核心 `.mjs`。此页在原 SPA 加载前完成交接,按现有 `{value,expire}` envelope 写 `like_admin_token`,再完整导航进入原系统。它不加载集团或第三方远程脚本。
## 本地预览
入口:`http://127.0.0.1:8090/admin/group-login`,普通原医院登录:`http://127.0.0.1:8090/admin/login`。集团固定为 `http://127.0.0.1:5173`。启动进程的 PID、端口与产物路径见同目录 `hospital-preview-status.json`,该 JSON 只有这三个字段。
脚本:
```powershell
node admin/scripts/prepare-hospital-preview.mjs
./admin/scripts/start-hospital-preview.ps1
node admin/scripts/verify-hospital-preview.mjs
node --test admin/scripts/group-sso.test.mjs
```
`start-hospital-preview.ps1` 若发现 8090 已被占用会退出,不停止其他进程。PHP 路径可通过 `-PhpPath` 显式指定。当前使用 `C:\Users\isard\.cache\zyt-tools\php\php.exe`。
`prepare-hospital-preview.mjs` 将原 `server/public/admin` 复制到被本地忽略的 `.test-runtime/hospital-preview/admin`。它断言原入口 bundle 的唯一公开 `baseUrl:"https://admin.zhenyangtang.com.cn//"` 恰好出现一次,再只在隔离副本中改为同源 `/`。原生产入口及哈希资源没有改动。预览副本还禁用了原 HTML 夹带的远程客服/音视频脚本及其内联初始化,正常医疗功能中的第三方集成不属于本次预览验证。
`hospital-preview-router.php` 只绑定回环服务、检查固定 Host,拒绝 `s` 兼容路由参数;`/admin/group-login` 仅返回固定 HTML,`/admin/group-sso.mjs` 返回复制的核心模块,其他静态资源受目录边界及 MIME 白名单限制。`/adminapi/<controller>/<action>` 才进入固定的原 ThinkPHP 入口,禁止任意 PHP、安装器或测试脚本公开执行。加载原项目配置后强制 `APP_DEBUG=false`、`LOCAL_DEBUG_LOGIN_SKIP_PASSWORD=false`,同时固定 Request pathinfo。
PHP 在隐藏控制台运行,stdout/stderr **不重定向到文件**,回调 URI 中的 code 不会因为内置服务器访问日志持久化。准备目录只有公开静态副本与仅含 pid/port/path 的状态;之前无真实登录时产生的两份预览请求日志已清除。
## 验证
- `node --test admin/scripts/group-sso.test.mjs`:7 项全部通过,含 RFC 7636 向量、固定地址校验、verifier 不进入授权 URL、清 URL/事务消费/重放拒绝、错 state/过期/未来事务/任意 redirect/重复参数拒绝、固定两次 POST、错误兑换路径拒绝、两阶段网络失败均不重试、首次改密与企微分流。
- JavaScript 语法检查通过;原 Vue SFC 使用现有依赖中的 `@vue/compiler-sfc` 完成 parse/script/template 编译检查。PHP router 语法检查通过。
- 回调 HTML、核心模块与医院首页均 HTTP 200;实际返回的入口 bundle 使用同源 API;外部 HTML 脚本已移除;任意 PHP、安装器及 `s` 兼容入口等 4 条路径全部 404;无凭据调用原 mySelf 被拒绝;没有请求日志文件;原发布入口仍保留原公开 API baseUrl。
## 边界与后续发布
没有执行完整原 admin 类型检查/构建,因为 `admin/node_modules` 不存在;没有运行会删除并覆盖 `server/public/admin` 的 `npm run build`。当前可启动预览基于已有构建与独立回调入口;源代码版本进入正式发布时,应安装原 admin 依赖并执行纯 Vite 构建及适当检查。
源码生产部署必须配置公开 `VITE_GROUP_IDENTITY_URL` 为固定集团 HTTPS origin;只在医院 hostname 为回环地址时才提供本地 `:5173` 默认值,生产缺少配置时拒绝发起。医院 callback 仍固定 `/admin/group-login`,中央必须登记精确 redirect_uri,并允许医院 origin 进行公开 PKCE POST。轻量 HTML 固定用于本次回环预览,生产以已编译的 Vue 路由为入口。
真实集团授权、公司成员资格及医院 terminal 10 的最终签发由中央/医院后端和根任务统一验收。本次仅使用纯内存伪造响应测试事务算法,不持有真实票据或 token。
Binary file not shown.

After

Width:  |  Height:  |  Size: 90 KiB

@@ -0,0 +1,38 @@
# 客服 HTTP 8369 对接交付
> 后续状态:同日已完成客服服务器上线与集团机器接口配置。当前部署、验收边界和备份路径见 [客服集团接入已上线](kf-production-deployment-20261104.md);下文保留更新包交付时的记录。
客服地址保留为 **http://im.zhenyangtang.cn:8369/**,集团为 **https://x.zhenyangtang.com.cn/**。集团端已发布并登记该客服来源;本地 `C:/kefu` 的六个文件已更新。线上客服在另一台服务器,部署信息尚未提供,本次未修改其服务或数据库,不能将当前状态视为两端已联通。
## 客服服务器需要的配置
```dotenv
ZYT_GROUP_BASE_URL=https://x.zhenyangtang.com.cn
ZYT_GROUP_API_URL=https://x.zhenyangtang.com.cn/adminapi
KEFU_PUBLIC_BASE_URL=http://im.zhenyangtang.cn:8369
ZYT_GROUP_ALLOWED_HTTP_ORIGINS=http://im.zhenyangtang.cn:8369
```
对应配置样例见 [kefu-http-port-20261104.env.example](kefu-http-port-20261104.env.example)。API 地址的 `/adminapi` 不可省略;公开客服地址不附加 `/api`。固定前端回调为 `http://im.zhenyangtang.cn:8369/auth/group-login`。如果使用 Docker,需重新创建 API 容器加载新环境;补丁中的 compose 已透传新增变量。
只允许明确登记的 HTTP 来源,端口属于来源,`8369` 不等于其他端口。集团入口和验密 API 继续使用 HTTPS。HTTP 页面通过现有 hash-wasm 执行 PKCE S256,并使用安全随机数生成 state/verifier,不依赖 `crypto.subtle`。授权码、state、回调路径、端口和一次性消费校验保留。HTTP 允许兼容现有入口,但浏览器到客服的请求没有 HTTPS 传输加密。
原客服账号继续按本地凭据和角色登录;ZYT 账号按稳定 GID 关联,首次为固定零业务权限的 `zyt_basic`,由客服或集团管理员分配业务角色,同名账号不自动合并。此次未改变账号库、密码、角色、权限或会话数据。
## 已完成与待部署
- 集团已发布 `group-http-port-20261104-938fbc13ee78`,包 SHA-256 为 `938fbc13ee7803b94cd2790b8c4a651caee5a277321d7e6d7f8deb8ccc6755ae`。只更新集团 PHP/前端及三个公开客服配置值,没有改原医院 PHP 或 Nginx。原212个GID和身份源绑定全部保持。
- 集团后端回归161/172/513/442项及3项HTTP/SSO通过,集团前端81项与类型检查/构建通过。生产35项检查通过,包含旧版本静态资源继续可用、医院API正常、固定HTTP端口配置生效。
- 客服后端37项、前端14项隔离测试通过,包含没有 `crypto.subtle` 的真实 SHA-256 标准向量。完整客服类型检查/构建和产物验证由 [客服实现报告](kefu-http-port-support-20261104.md) 记录。
- 客服线上公开配置当前仍返回 `enabled:false`。等提供该服务器部署信息后,先核对线上源码/代理/版本,备份原文件,再应用补丁与环境配置,完成原客服账号、ZYT首登与一键跳转的真实验收。不得直接覆盖线上不匹配的后续改动。
- 集团查询/修改客服权限仍需双方配置私有机器密钥和客服 API 地址;本次没有生成或传输机器密钥。
完整更新包包含源码补丁、源码前后哈希、公开配置样例及客服前端构建候选产物,不含 `.env`、业务数据库、会话或密钥。前端使用标准 `/api/v2` 基址;现有线上已能访问该路径,部署时仍需核对原代理规则和前端根目录。
## 备份与回退
本地六个客服原文件备份在 `C:/zyt/identity-admin/.test-runtime/kefu-http-port-20261104/before-local-apply/`,仅匹配本次清单时恢复,不覆盖后续改动。集成交付镜像和 source-manifest 已同步。
集团服务器备份在 `/www/wwwroot/x.zhenyangtang.com.cn/backups/http-port-20261104-141058/`,前一版本是 `releases/group-20261104-d430557f03ea`。回退前核对当前代码和配置仍为本次版本,恢复该备份的私有 Group 环境文件及前一 current 链接,保持原服务用户权限,然后 reload `x-identity-php82.service`。持久库和原医院配置不用回退;不得恢复早期共用 PHP 的 FastCGI 目录覆盖配置。
浏览器自动化在本轮验收时被 Work 设置禁用,因此只报告线上接口/资源及隔离回归结果,没有声称完成线上客服真实登录。线上检查证据见 [http-port-production-checks-20261104.json](http-port-production-checks-20261104.json)。
@@ -0,0 +1,188 @@
[
{
"path": "/dashboard",
"status": 200,
"expected": 200
},
{
"path": "/system/users",
"status": 200,
"expected": 200
},
{
"path": "/adminapi/health",
"status": 200,
"expected": 200
},
{
"path": "/adminapi/auth.admin/lists",
"status": 401,
"expected": 401
},
{
"path": "/.env",
"status": 403,
"expected": 403
},
{
"path": "/shared/group.sqlite",
"status": 404,
"expected": 404
},
{
"path": "/assets/AccountRequired-0tv44nbR.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/AccountRequired-CQxSfTnW.css",
"status": 200,
"expected": 200
},
{
"path": "/assets/Companies-BCquObvx.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/CompanyDirectoryEmpty.vue_vue_type_script_setup_true_lang-CjtIpPc_.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/CompanyScope.vue_vue_type_script_setup_true_lang-Cft_Tm8Y.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Custom-Bpnf5k-1.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Dashboard-DL4P50uN.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Departments-BlxbUozz.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/group-N4e0juLR.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/index-BsSsHQ6J.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/index-DsNWzruk.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/index-zX-OJ0yN.css",
"status": 200,
"expected": 200
},
{
"path": "/assets/Login-CFWsBfnm.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Members-DCNVfFgm.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Menus-osNNkVbf.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/PageHeader.vue_vue_type_script_setup_true_lang-DdgwR0GO.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Profile-BuwesBI9.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Roles-C8AgughC.css",
"status": 200,
"expected": 200
},
{
"path": "/assets/Roles-NbhEIMTF.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Shell-BfO_MyoR.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/SsoAuthorize-4VjTAaIe.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Status-BqrtPxLF.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/usePagedList-B6xbjlgd.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Users-BIxS61Ke.js",
"status": 200,
"expected": 200
},
{
"path": "/assets/Users-DdBwyY7W.css",
"status": 200,
"expected": 200
},
{
"path": "/assets/validation-Co109C3A.js",
"status": 200,
"expected": 200
},
{
"path": "/adminapi/group/kefu/login",
"status": 401,
"expected": 401,
"body": {
"code": 0,
"msg": "账号或密码错误,或账号已停用",
"data": {}
}
},
{
"url": "https://admin.zhenyangtang.com.cn/adminapi/auth.admin/mySelf",
"status": 200,
"expected": 200,
"type": "application/json; charset=utf-8",
"body": null
},
{
"url": "http://im.zhenyangtang.cn:8369/api/v2/auth/group/config",
"status": 200,
"expected": 200,
"type": "application/json",
"body": {
"enabled": false
}
}
]
Binary file not shown.
@@ -0,0 +1,95 @@
# 企微客服管理端认证与权限接入审查
日期:2026-11-02。仅阅读 `C:\kefu` 源代码与部署说明;没有修改客服项目、启动客服进程、连接业务数据库,也没有读取 `.env`、密钥、实际 token 或密码数据库列。`C:\kefu` 递归未发现 `AGENTS.md`、`CLAUDE.md` 或 `.trellis`;`C:\zyt\.trellis\workflow.md` 不存在。
## 结论
接入对象是 `admin-web/apps/web-antd` + `wechat_rpa/admin_api.py` + `admin_backend.py`,不是 `im/backend` 的 Go 社交平台。现有桌面 ZYT terminal=7 交换只创建 `desktop_accounts/desktop_sessions`,不能直接当作浏览器后台登录。浏览器管理端尚无 OAuth、PKCE、SSO 或外部身份绑定实现。
建议新增独立浏览器 SSO:集团授权码 + S256 PKCE → 客服后端交换并核验集团身份 → 按 `(issuer, subject)` 稳定绑定一个客服 `users.id` → 签发客服自己的 API 会话。首次创建只授最低角色;后续登录保留本地管理员分配的角色和停用状态,绝不从集团 `root` 或集团角色提升客服权限,也不按同名账号自动合并。
## 当前运行边界
- `deploy/im-admin/README.md:3` 明确部署当前 Vue 管理端与 Python API;`compose.yaml:33` 起 `admin_api.py`,容器 8766 映射宿主 `127.0.0.1:18766`;网关是 18770,知识 worker 单独运行。部署入口 `im.zhenyangtang.cn`。这是部署配置证据,未查询线上实际进程。
- `deploy/im-admin/im.zhenyangtang.cn.conf:10` 保留 `/api/v2/*`;第 25 行 `/api/*` 转发到 `/api/v2/*`。新增后端 API 应注册在 `/api/v2/auth/...`;前端调用 `/auth/...`,沿用现有 API base。
- `wechat_rpa/admin_api.py:1` 明确:旧 8765 网页服务已退役,`admin_backend.py` 是数据层。`admin_api.py:314` 从 `admin-web/apps/web-antd/dist` 托管 Vue;`:1448` SPA fallback 必须排在新增认证 API 后。
- `admin-web/apps/web-antd/vite.config.ts:13` 开发代理 `/api → /api/v2`,默认后端 8766。`wechat_rpa/run_backend.py:38` 同样只拉起 Python API、gateway、knowledge。
- `im/README.md` 与 `im/backend/cmd/server/main.go` 是另一套星遇社交平台,不应改其 JWT、账号表、管理端或菜单。
## 浏览器登录与本地授权的真实实现
| 项目 | 当前行为与证据 |
| --- | --- |
| 本地账号 | `admin_backend.py:645`,`users.username` 唯一且 `COLLATE NOCASE`,每人一个 `role`,`active` 控制启停;无外部 issuer/subject/auth-source 字段。 |
| 登录 | `admin_api.py:605`,POST `/api/v2/auth/login` 验证本地密码,签发 `kind=api` 的不透明随机会话,30 天,无 refresh token;返回 `access_token/expires_in/user`。 |
| 会话 | `admin_backend.py:975` 只存 token 摘要;`:1001` 每次查库并要求 `users.active=1`,API `current()` 在 `admin_api.py:348` 要求 token_kind=api。 |
| 权限 | `admin_api.py:374` 的 `require()` 只判权限码。每个请求由 `permissions_for_user()` (`admin_backend.py:2023`) 从当前角色读取权限,令牌不携带冻结的权限快照。 |
| 管理角色 | GET `/roles` 需要 `user:read`;POST/DELETE `/roles` 需要 `role:write`;GET `/permissions` 需要 `role:write`。自定义角色支持,内置角色不可删除,admin 不可削权。 |
| 管理用户 | GET `/users` 需要 `user:read`;POST/PUT `/users` 需要 `user:write`。Vue `views/console/users.vue:51` 直接调用 PUT 更换角色,`:56` 停用。 |
| 状态保护 | `admin_backend.py:2666` 不许停用自己;最后一个启用 admin 不许降级或停用;停用或重置密码删除其现有 auth_tokens。 |
**需一并修复的现有缺陷:** `admin_api.py:720` 调用 `database.update_user(user_id, body.role, body.active, principal.id, client_ip(request))`;数据层 `admin_backend.py:2652` 的真实签名却为 `(user_id, role, active, new_password, actor_id, ip)`。缺少 `new_password` 参数,用户改角色、停用请求会抛 TypeError,未被只捕获 ValueError 的处理器接住。按当前 UI 功能传空 `new_password` 即可保持原来仅改角色/状态的行为。此缺陷会直接阻断“本地管理员继续授权”的验收,应加入回归测试。
## 最低角色的准确含义
`wechat_rpa/rbac.py:58` 内置角色为 admin、operator、viewer;viewer 是现有最低内置角色,初始权限 (`:74`) 为:
`config:read, model:read, agent:read, review:read, stats:read, user:read`。
因此 viewer 是业务只读角色,能看模型/智能体/配置/统计/用户与角色清单;不是“等待管理员授权、无业务可读”的访客。已有 viewer 权限还可能被管理员调整,seed 仅首次给默认权限(`:107`),之后保留数据。
若用户“最低级”按既有三档理解,首次绑定设为 viewer 最贴合现有产品;不要每次登录重置为 viewer。若要求严格待授权,应新增空权限 `sso_guest` 与 `/account-pending` 页,不宜直接削弱既有 viewer,以免影响现有员工。此时默认首页不能继续固定 `/model/stats` (`preferences.ts:25`),须选有权首页或待授权页。
另有既有数据范围语义:`admin_api.py:388` 的 `resolve_admin_tenant()` 在没有 `admin_account_scope` 绑定时,对 `account_id=-1` 返回全部租户;viewer 已含 `stats:read`。因此首次 viewer 可读取全部账号的调用统计。若采用 viewer 就应把这个行为纳入接受范围;若要先授权才读任何业务,选空权限角色更明确。具体客户端账号仍需 `admin_can_access_desktop_account` 检查;不能把“无 scope”简单描述成所有 API 都拒绝。
## 外部身份绑定与冲突规则建议
1. 增加 `sso_identities(issuer, subject, user_id, created_at, last_login_at)`,联合唯一 `(issuer, subject)`,并让一个本地账号最多绑定一个该 issuer 的主体。只信任后端代码交换后取得的 subject,不接收前端传来的 account、role、root、user_id 或 active。
2. 首次登录在单个 `BEGIN IMMEDIATE` 事务里查绑定、创建用户、插入绑定,防止并发首登生成两个用户。新用户用稳定命名空间用户名(例如 `sso_<issuer摘要>_<subject摘要>`),显示账号/姓名单独保存;不要用用户名、手机或邮箱自动绑定已有 admin/operator。
3. 已存在同名本地账号保留原账号与原权限。需要合并时走明确的管理员绑定操作,且核验双方身份;绝不能因集团账号叫 admin 就接管客服 admin。
4. 新建 SSO 账号 `must_change_password=0`,避免被本地改密页锁住。为满足现有 NOT NULL 摘要列可生成不可知随机凭据,但还应明确禁止 SSO-only 账号走本地密码登录/重置入口;本地 admin 继续原密码流程。不要把集团密码传给客服。
5. 已绑定用户每次只更新头像/显示名等资料与登录时间;保留 `role`、`active`、管理员配置的范围。客服 `active=0` 必须拒绝 SSO,不能因为集团 still active 自动恢复。集团停用、membership 失效、应用访问权不足均拒绝签发新客服会话。
6. 当前 30 天客服会话与集团退出/停用没有联动。需要明确 SSO 会话有效期与撤销机制:至少采用较短 SSO 会话,并存集团会话/身份绑定;若要求立即撤销,就加中心内省或事件撤销,不能宣称原有本地 session 已支持集团实时封禁。
## SSO 路由落地建议
- 客服增加 `GET /api/v2/auth/sso/config`(仅公开开关、受信任授权入口/固定 client_id)、`GET /api/v2/auth/sso/start`(生成一次性 state 和 S256 verifier,服务端或 HttpOnly 会话保存)和受控 callback/exchange。
- 推荐 BFF 方式:callback 由客服后端验证 state,拿 code + verifier 在后端交换集团会话/身份,再创建本地 API 会话;只允许固定中心地址与精确已注册 redirect_uri,不从 query 决定中心 URL。为兼容现有 bearer store,callback 可发客服一次性浏览器交接码,再由同源 POST 取本地 `BackendLoginResult`,避免把正式 token 放 URL。
- 若跟随现有集团授权页、采用前端 PKCE:在客服新增公开核心路由 `/auth/sso/callback`,verifier/state 只放 sessionStorage,交换走客服同源 POST `/auth/sso/exchange`。仍须后端中心交换与核验身份;callback 清除 query,重复/过期/错误 state 不兑换。增加 `Cache-Control: no-store`、`Referrer-Policy: no-referrer`。
- `router/routes/core.ts:24` 是公开基础路由清单,callback 应在这里;否则 `router/guard.ts:65` 会因没有本地 token 先送回账号密码登录。仅加页面组件或普通业务路由无法登录。
- `store/auth.ts:26` 抽出接收已验证 `BackendLoginResult` 的共用完成登录函数:保存 token,刷新 `/me` 与权限码,清理上一个身份的用户/菜单/动态路由,再按有权首页跳转。不要复用账号密码 POST 来伪装免密。
- `api/core/auth.ts:38` 存模块级 cachedCodes;SSO/切换身份时一并覆盖/清空,避免旧用户权限码留存。正式权限始终以客服 `/me` 为准,集团菜单权限不覆盖客服 RBAC。
## 菜单与集团权限补齐清单
真实菜单源为 `admin-web/apps/web-antd/src/router/routes/modules/console.ts`,不是 Vben mock 的 `/menu/all`。建议集团以应用命名空间 `kefu` 注册菜单和操作权限元数据,避免与其他应用 `user:read/model:read` 冲突;进入应用和菜单可见性由集团授予,但客服 API 仍按其本地权限执行。由于本轮需求明确本地管理员继续授权,集团单独勾选客服菜单不应自动提高客服角色。
| 菜单 | 客服路径 | 本地可见权限 |
| --- | --- | --- |
| 模型清单 | `/model/catalog` | `model:read` |
| 角色编排 | `/model/plan` | `model:read` |
| 智能体 | `/model/agents` | `agent:read` |
| 调用统计 | `/model/stats` | `stats:read` |
| 客户端账号 | `/desktop/accounts` | `desktop-account:read` |
| 客户端配置 | `/desktop/config` | `config:read` |
| 版本升级 | `/desktop/release` | `config:read`(发布需 `release:write`) |
| 归档概览 | `/archive/overview` | `im:read` |
| 会话与消息 | `/archive/conversations` | `im:content:read` |
| 导出中心 | `/archive/exports` | `im:export` |
| 人员唯一标识 | `/archive/people` | `im:identity:write` |
| COS 存储 | `/archive/storage` | `im:storage:write` |
| 知识加工与检索 | `/knowledge/center` | `knowledge:read` |
| 角色权限 | `/system/roles` | `user:read`(编辑需 `role:write`) |
| 用户管理 | `/system/users` | `user:read`(编辑需 `user:write`) |
| 审计日志 | `/system/audit` | `audit:read` |
| 修改密码(隐藏菜单) | `/profile/password` | 已登录,本地账号流程 |
完整动作权限目录在 `rbac.py:22`(28 项),含 knowledge 的 read/write/review/publish/export、审核 review:read/write、聊天 im:import/export/storage/identity 等。不要只导出菜单可见权限而漏掉操作目录;也不要把存在权限码却没有菜单的审核队列虚构成现有菜单。
## 授权变更与测试重点
- 后端角色或角色权限变化在下一次 API 请求生效,无需重登录;现有 `test_admin_api.py:346` 已有同 token 撤销权限用例。用户停用立即删除令牌,数据库查询也会拒绝 active=0。
- 浏览器菜单和按钮不会在管理员修改后实时推送更新:`router/guard.ts:89` 在 `isAccessChecked` 后短路;`store/auth.ts:100` 的 `fetchUserInfo()` 可同步两份权限,但需实际再次调用并重建菜单。至少提供刷新权限/重新载入或在窗口聚焦时刷新;后端拒绝仍是最终防线。
- 必测:同一个集团账号首次创建 viewer(或已明确选定 guest)、重复/并发登录不重复建人、本地提权后再次 SSO 不降级、本地停用不自动复活、同名 admin 不接管、无效/重放/过期 code 与错误 state/PKCE 不建用户、集团停用/membership失效拒绝签发、直接访问 callback 不误进本地登录、本地管理员 PUT 改角色成功且旧 token 权限改变、SSO token 与桌面 token 严格分离、集团菜单深链只跳受信任站内路径。
本审查未运行测试、未连接线上服务。上述 update_user 参数缺陷由精确函数签名与调用点静态核对确认;其余描述均是当前源码和部署配置行为或明确标注的接入建议。
@@ -0,0 +1,45 @@
# 客服授权中央 PHP 后端(2026-11-03)
已实现集团 owner 为现有 KF 绑定员工修改 KF 角色或个人权限。KF 是授权数据库;中央只校验和代理,收到经验证的 KF 提交结果后才返回保存成功。现有只读 `/group/application/access` DTO 和目录同步逻辑保持兼容。
## 修改文件
- `identity-admin/server/app/service/group/KefuAuthorizationClient.php`:独立机器客户端,复用独立配置的 metadata URL/key file,不传递人类会话。支持 callable transport/clock 供隔离测试。
- `identity-admin/server/app/service/group/KefuApplicationService.php`:新增 options/update、每次重新读取源员工详情/既有 GID/已登记 KF 公司、编辑 DTO、成功提交审计。
- `identity-admin/server/app/service/group/GroupService.php`:新增两个操作,沿用显式 owner 与源 root 双重检查;在任何目标查询或远端调用之前拒绝非 owner。
- `identity-admin/server/app/controller/ApiController.php`:识别编辑 POST JSON,允许该请求最多 256 KiB;在关联数组解码前拒绝 `permissions:{}`,只接受 JSON array/null。
- `identity-admin/server/route/app.php`:注册 GET `adminapi/group/application/access-options` 和 POST `adminapi/group/application/access-update`,完整匹配。
- `identity-admin/tests/kefu-authorization-fixture.php`、`identity-admin/tests/kefu-authorization.test.mjs`:合成传输、临时 SQLite、真实控制器 JSON 解码的安全回归。
## 接口与边界
GET 接受且仅接受 `client_id=kefu`、`source_admin_id`。POST 必须具有契约全部五个字段:`client_id,source_admin_id,expected_revision,role_code,permissions`。拒绝浏览器传入 actor/GID/request_id 等额外字段;POST source_admin_id 必须是 JSON 整数。
每次编辑重新校验源 `auth.admin/detail` 返回的员工编号;只读取 `subject` 中已经存在的 GID,不创建绑定,不按账号或姓名匹配。KF 公司由已登记公司代码解析。actor_source_admin_id 只取认证后的 owner;每次机器写请求生成新的 32 位小写十六进制 request_id。
机器调用的 HMAC canonical path 分别为 `/group/access-options`、`/group/access-update`。随机 nonce、90 秒时间窗、固定 metadata 配置的 API base、HTTPS/loopback HTTP、禁止重定向、禁用代理、短超时、请求 256 KiB 和响应 4 MiB 上限均已落实。
返回签名在 JSON 解析前验证。成功响应严格校验对象/数组区分、所有字段集合、版本/应用/时间、GID/源员工/公司、用户状态、revision、角色唯一性、catalog 唯一性和权限代码集合。当前用户角色必须出现在选项中;active 用户有效权限必须等于该角色权限;inactive 用户权限为空。目录 enabled 只作为导航状态,不额外撤销 KF 原权限。写响应还须与请求的角色或个人权限集合一致,避免未提交回显被当作成功。
仅在签名、形状、时间和 error.code 与 HTTP 状态严格一致时传播安全错误 403/404/409/422/429/503。未签名鉴权错误、重定向、500、错误签名、旧响应和结构异常均映射安全 503。409 会保留为 409,供前端保留草稿并要求刷新。
`permissions:null` 由 KF 分配现有角色,显式数组由 KF 创建/复用目标私有角色;中央不修改共享角色。空数组有效。不会更改 Group/source/hospital 的角色、菜单授权、membership、catalog 或员工身份。
KF 提交且响应验证成功后记录 `group_audit`:`action=kefu.access.update`、认证 actor、KF company、源目标员工。远端失败不会添加成功审计。若远端已提交而本地审计插入失败,返回明确 503:`客服已处理,但集团审计记录失败,请刷新核对`;不声称 KF 已回滚,也不返回假保存成功。
## 验证结果
PHP:`C:/phpstudy_pro/Extensions/php/php8.2.9nts/php.exe`,SQLite 使用 `-d extension=pdo_sqlite`。
| 检查 | 结果 |
| --- | --- |
| 新增 `kefu-authorization.test.mjs` | 通过,513 checks |
| `kefu-metadata.test.mjs` | 通过,172 checks |
| `company-structure.test.mjs` | 通过,600 checks |
| `role-access.test.mjs` | 通过,77 checks |
| `company-structure-http.test.mjs` | 通过,8 tests |
| 五个修改/新增 PHP 后端文件及 PHP fixture 的 `php -l` | 全部通过 |
新增测试覆盖 owner 拒绝在查询前执行、每次目标重验证、无 GID/无公司/源目标不符、额外字段/缺字段/类型/权限重复/超限、endpoint-specific HMAC、随机 nonce/request_id、现有角色/私有权限/空权限、inactive 用户、签名失败/错误 nonce/重放式旧响应/身份不符/多余字段/未知权限/错误角色集合、签名安全错误传播、未提交回显拒绝、审计失败提示、无 Group/源授权状态修改、JSON `{}` 与 `[]` 区分和请求边界。
运行所有测试时均过滤继承的 IAM 配置,使用代码内合成 key、合成身份源和随机系统临时目录,不读取真实 key 或业务 SQLite,不连接真实 KF。默认沙箱的 loopback `fetch` 返回 EACCES,首次 HTTP 启动检查因此失败;以相同隔离测试命令申请沙箱外执行后,8 tests 全部通过。未改真实授权数据。中央/KF 新协议真实 HTTP 联调由根任务另行验证。
@@ -0,0 +1,55 @@
# KF authorization machine endpoints — 2026-11-03
Implemented in staged `identity-admin/integration/kefu/wechat_rpa/` only. No production `C:/kefu` Python files, databases, `.env`, settings, keys, sessions, users, roles, or grants were changed by this work.
## Deliverables
- `group_authorization.py`: machine-only options/update service, strict protocol validation, signed success/error responses, durable SQLite replay/idempotency, transactional native authorization and audits.
- `admin_api.py`: import, service construction, and two dedicated machine route handlers only. Existing metadata route/reader and normal permission checks retain their behavior.
- `test_group_authorization.py`: isolated real FastAPI, temporary synthetic key and SQLite regression suite.
- `test_group_access.py`: only adds the new module to its staged source-copy tuple so existing read-only tests can import the wired API before deployment. Its 18 assertions/tests are unchanged.
Real HTTP routes are `POST /api/v2/group/access-options` and `POST /api/v2/group/access-update`. As with the existing metadata API, the deployment API base contains `/api/v2`; signed canonical paths are exactly `/group/access-options` and `/group/access-update`, excluding that prefix. Signing an options body for the update path, using the full prefixed path, altering bytes, or supplying a human bearer alone fails authentication.
## Identity, authorization, and commit
Both routes require the configured metadata HMAC key and revalidate `provider='zyt_group'`, GID, `source_admin_id`, and registered `company_id` against an existing binding. No name joins or enrollment calls exist here. The positive `actor_source_admin_id` in a signed update is the central service's assertion of its authenticated Group owner, not a local KF user ID; the central edit API must derive it from authenticated context and independently recheck owner/source/company/GID on every call.
Options use one SQLite read transaction. Writes use `BEGIN IMMEDIATE` to serialize binding/revision/role/permission checks, role assignment, full authorization audit, native audit, and the idempotency result. Revisions hash current provider/GID/source/company/local user identity, active state, assigned role, and exact assigned-role permissions. Native role or permission changes, deactivation, or binding/profile changes invalidate the revision. A stale draft gets signed409; no roles, grants, audit, or success result are partially committed.
`permissions:null` assigns the selected existing role without editing it. An explicit array, including `[]`, creates or reuses an independent managed role for the target user and exact permission set. Existing/shared/private role permissions are never rewritten. An ownership table excludes another target's managed roles from choices and assignments. Reuse requires the actual current permissions to match and no other user to hold the role. If a native KF admin subsequently shares or changes a personal role, a later customization forks a new role; the other user's permissions remain unchanged.
User credentials, username, active state, password-change flags, and token/session rows are preserved. The only user update is `role` plus `updated_at`. Permissions use the native `rbac.permissions_of` semantics inside the transaction; inactive effective permissions are empty and catalog `enabled` remains navigation metadata. Existing sessions read permissions from the DB each request, so a saved grant or revocation takes effect with the same token. Demoting the last active native `role='admin'` user, including customization to a separate role, gets signed409.
## Durable replay, retries, and audits
Service construction creates four additive tables and two indexes through the existing SQLite connection helper:
- `group_authorization_nonces`: cross-worker nonce reservations, expiry, bounded live capacity.
- `group_authorization_requests`: durable request ID, exact raw-body SHA256 digest, first committed raw success result.
- `group_authorization_private_roles`: managed-role ownership and permission-set digest.
- `group_authorization_audit`: full actor/target/request/before/after role, permission, and revision JSON.
Nonce reservation commits separately before parsing/domain work, so invalid or rolled-back authenticated requests still consume their nonce. All options/update workers share this database store. Timestamp acceptance is ±90 seconds; expired entries are cleaned and live entries are never evicted to make room. Duplicate nonce authentication returns401.
Retry a write with the same exact body and `request_id`, a fresh nonce/timestamp, and a fresh request signature. It returns the first committed raw result and does not repeat either audit or mutate the user. Changed raw bytes under the same request ID get signed409. Existing binding is revalidated before looking up the cached result, and a cached result cannot cross a reassignment of the GID to a different local user. The first success's `generated_at` is retained by idempotency; a client that adds time freshness checks must account for legitimate delayed retries (the response is still freshly nonce-bound and authenticated). Fetch fresh options after conflict or when displaying a later current state.
The ordinary KF `audit_log` receives `action='group.authorization.update'`, local `user_id=NULL`, and JSON carrying Group actor ID, target ID/GID/source/company, and request ID. This avoids confusing Group actor IDs with unrelated local FK IDs. The detailed authorization audit, ordinary audit, assignment, new private role/grants, and cached success are one commit; failure of any audit/result insert rolls all of them back.
## Client parsing and safe failures
Responses are raw JSON with `Cache-Control:no-store`, not the central JSON envelope. Verify `X-Group-Response-Signature` over raw bytes and the request nonce before JSON parsing or displaying a message. Strictly validate the version/client, expected target identity, exact shapes, bounded response, permission catalog, role permissions, and revision. Success is emitted only after KF commits.
Authenticated validation/domain/storage failures are signed as exactly `{version:1,client_id:'kefu',generated_at:int,error:{code:<HTTP status>,message:<safe constant>}}`. Here the domain statuses are404 (missing binding),409 (binding/revision/request ID/last-admin conflict),422 (invalid shape/role/permissions), or503 (storage/projection/capacity failure). HTTP status equals `error.code`. Never interpret a non-200 body as a success DTO, and never surface unsigned/upstream/invalid-shape error text.
Missing/invalid key configuration cannot produce a trusted signature and fails closed with generic503. Missing/duplicate security headers, signature/path/body/timestamp mismatch, and nonce replay fail with generic unsigned401. A raw request exceeding256KiB is rejected before authentication with unsigned413. Query parameters on an otherwise authenticated request produce signed422. Responses are bounded to4MiB and permission definitions/codes to2000. No URLs, key paths, credentials, token data, or role-holder lists are projected.
## Verification
Interpreter: `C:/kefu/wechat_rpa/.venv/Scripts/python.exe`. Test scripts copy only public top-level `.py` files into a temporary runtime, overlay staged code, change working directory there, clear application environment before imports, and use synthetic SQLite/key/password/session fixtures. The real `.env`, database, and key are never copied or opened.
Final authorization run:21 tests passed in26.032 seconds, including an explicit reassigned-binding cached-result check. Read-only metadata regression:18 tests passed in43.390 seconds. Final staged Python sources compile, and a direct identifier validation check confirms unpaired Unicode surrogates are rejected. The earlier20-test authorization run also passed in54.087 seconds.
The initial sandboxed TestClient attempts timed out inside Windows `socket._fallback_socketpair` before endpoint execution. Auto-approved runs outside the sandbox resolved that local loopback restriction. Both bounded sandbox attempts terminated themselves; this was an execution-environment issue, not a failed endpoint assertion.
Coverage includes real `/api/v2/me`, `/api/v2/config`, and `/api/v2/stats/model-calls` using the same existing token before grant, after grant, and after revocation; other user's live results unchanged; unchanged shared roles/catalog/bindings; passwords/status/token preservation; target-private customization and empty permissions; native role sharing/edit forks; inactive users; last admin; strict request/signature/path/field checks; durable replay across workers; concurrent CAS (one success/one409); idempotency and altered-body conflicts; native/source/company binding mismatch; audit/result failure rollback; response-size rollback; and signed safe errors.
@@ -0,0 +1,43 @@
# Group 客服授权 UI — 2026-11-03
已完成 `用户管理 > 客服授权` 的 owner 编辑入口,保留默认只读弹窗与 30 秒查询。页面使用真实中心接口 `/group/application/access`、`/group/application/access-options`、`/group/application/access-update`,没有加入页面假数据或自动开户逻辑。
## 变更范围
- `identity-admin/web/src/views/Users.vue`:owner 可从包括受保护源管理员在内的用户行查看、编辑客服授权;未建立客服绑定时明确不可编辑。
- `identity-admin/web/src/types/applicationAccess.ts`:新增独立的编辑选项、客服角色和写入 DTO;只读 DTO 不变。
- `identity-admin/web/tests/kefu-visibility.test.mjs`:在原有实际 SFC 脚本和模板执行测试中新增 5 个编辑行为场景,无需修改 package.json 即由现有完整测试命令执行。
- 运行生产构建,更新 `identity-admin/web/dist` 生成文件。
## 编辑行为
- 进入编辑每次先读取最新选项和 revision;首次读取失败不能复用以前的编辑结果保存。
- 可搜索选择现有客服角色并预览权限。未启用单独调整时,精确发送 `permissions: null`。
- 可选「仅为此用户单独调整权限」,文案说明服务端保存为该用户的独立角色,不修改共享角色或影响其他用户。按分组显示可搜索权限目录,目录区域最多 300px 滚动,允许目录停用但仍有效的授权。支持取消全部权限与恢复角色权限;明确的空数组 `[]` 可以保存。
- 保存仅发送契约规定的五个字段。等待服务端成功提交后,才显示成功、替换实际角色/有效权限和新 revision;不合并进集团或医院授权。
- 编辑、读取编辑选项、保存期间均暂停背景刷新。草稿不受定时器或手动刷新覆盖;请求序号、目标用户及身份绑定校验丢弃过期/错误响应。保存去重,保存期间禁止切换目标与关闭弹窗。
- HTTP 409 保留草稿并禁用再次保存,要求用户明确点击「重新载入授权(重置草稿)」获取新 revision 后再编辑。读取重试失败仍保留草稿。
## 验证
使用现有 node_modules;本环境 `npm` 不在 PATH,因此以 Node 直接执行 package.json 脚本对应的入口,未安装或升级依赖。
| 检查 | 结果 | 日志 |
| --- | --- | --- |
| package.json 所列完整 9 个测试文件 | 80/80 通过,exit 0 | `artifacts/iam-extraction/kefu-authorization-web-tests-20261103.log` |
| `node node_modules/vue-tsc/bin/vue-tsc.js --noEmit` | 通过,exit 0 | `artifacts/iam-extraction/kefu-authorization-web-typecheck-20261103.log` |
| `node node_modules/vite/bin/vite.js build` | 通过,exit 0;1724 modules | `artifacts/iam-extraction/kefu-authorization-web-build-20261103.log` |
新增测试覆盖 owner / 非 owner、受保护源账号、角色预览、定时器暂停、提交前无乐观成功、重复提交、精确 null / [] 语义、搜索不改变选中项、目录停用语义、服务端独立角色结果、409 草稿保留与重新载入、错误绑定、旧请求、权限撤回、未绑定不可编辑和首次选项失败不可复用 revision。
测试存在原有隔离脚本的 Vue 生命周期提示;Vite 报告通用大 chunk 提示,两者均未导致失败。未进行真实角色授权、开户或为截图修改用户权限;此报告的行为验证均在隔离样例执行,未做浏览器人工截图验证。
## 1280×720 弹窗布局后续修复
主任务随后使用现有真实会话验证编辑选项读取成功(4 个角色、65 项权限),未提交授权变更。首次页面核对显示开启自定义后原弹窗整体超过视口,保存栏被挤出屏幕。
本次仅调整 Users.vue 的客服授权弹窗模板/CSS:增加专属 `kefu-access-dialog` 类和 3vh 顶部间距,弹窗高度最多 94vh / 94dvh;使用纵向 flex 布局,正文独立滚动,标题与底部操作栏不参与正文滚动。窄视口下底部按钮可换行,现有权限目录的 300px 滚动区域保留。所有选择器均限定于此专属弹窗类,其他用户编辑弹窗与授权逻辑保持原行为。
修复后使用现有依赖验证全部通过:客服可见性/编辑测试 12/12、vue-tsc exit 0、Vite production build exit 0。日志分别为 `kefu-authorization-web-modal-tests-20261103.log`、`kefu-authorization-web-modal-typecheck-20261103.log`、`kefu-authorization-web-modal-build-20261103.log`,均位于本报告同目录。生产构建已更新;本次未提交真实授权,修复后的真实浏览器截图可由主任务复核。
主任务已完成修复后的1280×720真实浏览器复核:标题、角色选择、权限目录及保存栏均在视口内,正文独立滚动。最终截图已保存为`artifacts/iam-extraction/group-kefu-authorization-edit-20261103.jpg`;随后取消验收草稿,真实授权未变。
@@ -0,0 +1,38 @@
vite v6.4.5 building for production...
transforming...
✓ 1724 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html 0.46 kB │ gzip: 0.32 kB
dist/assets/Roles-C8AgughC.css 0.09 kB │ gzip: 0.10 kB
dist/assets/AccountRequired-CQxSfTnW.css 0.13 kB │ gzip: 0.13 kB
dist/assets/Users-DoJ3nCTf.css 0.70 kB │ gzip: 0.30 kB
dist/assets/index-zX-OJ0yN.css 379.84 kB │ gzip: 52.57 kB
dist/assets/PageHeader.vue_vue_type_script_setup_true_lang-mX8pT9uv.js 0.44 kB │ gzip: 0.29 kB
dist/assets/validation-Co109C3A.js 0.52 kB │ gzip: 0.42 kB
dist/assets/usePagedList-BuxetYrg.js 0.53 kB │ gzip: 0.36 kB
dist/assets/CompanyDirectoryEmpty.vue_vue_type_script_setup_true_lang-zGXv7wKk.js 0.71 kB │ gzip: 0.53 kB
dist/assets/Status-Ba_VhKF0.js 0.78 kB │ gzip: 0.60 kB
dist/assets/CompanyScope.vue_vue_type_script_setup_true_lang-2qhvdY__.js 1.06 kB │ gzip: 0.71 kB
dist/assets/AccountRequired-Bmcb9LdL.js 1.43 kB │ gzip: 0.98 kB
dist/assets/SsoAuthorize-C5JBELBo.js 1.47 kB │ gzip: 0.96 kB
dist/assets/Custom-Dz--X1Uy.js 2.11 kB │ gzip: 1.24 kB
dist/assets/group-N4e0juLR.js 2.26 kB │ gzip: 1.15 kB
dist/assets/Members-KxrowyN4.js 3.35 kB │ gzip: 1.72 kB
dist/assets/Profile-DRhX6bn-.js 4.75 kB │ gzip: 2.15 kB
dist/assets/Login-BTPN9TlY.js 4.94 kB │ gzip: 2.28 kB
dist/assets/Shell-CKdtpaZ5.js 5.62 kB │ gzip: 2.44 kB
dist/assets/index-BE0JR7Fq.js 5.76 kB │ gzip: 1.61 kB
dist/assets/Companies-DyS3dtet.js 5.93 kB │ gzip: 2.65 kB
dist/assets/Dashboard-Yl0PoUqe.js 5.94 kB │ gzip: 2.58 kB
dist/assets/Departments-CrLA-xBf.js 7.74 kB │ gzip: 3.44 kB
dist/assets/Roles-BogX9rSg.js 11.13 kB │ gzip: 4.70 kB
dist/assets/Menus-DAYn88mF.js 17.20 kB │ gzip: 6.70 kB
dist/assets/Users-BPobzutw.js 25.02 kB │ gzip: 8.66 kB
dist/assets/index-CIWLiRma.js 1,135.12 kB │ gzip: 377.25 kB
(!) Some chunks are larger than 500 kB after minification. Consider:
- Using dynamic import() to code-split the application
- Use build.rollupOptions.output.manualChunks to improve chunking: https://rollupjs.org/configuration-options/#output-manualchunks
- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.
✓ built in 55.02s
@@ -0,0 +1,38 @@
vite v6.4.5 building for production...
transforming...
✓ 1724 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html 0.46 kB │ gzip: 0.32 kB
dist/assets/Roles-C8AgughC.css 0.09 kB │ gzip: 0.10 kB
dist/assets/AccountRequired-CQxSfTnW.css 0.13 kB │ gzip: 0.13 kB
dist/assets/Users-DdBwyY7W.css 1.18 kB │ gzip: 0.45 kB
dist/assets/index-zX-OJ0yN.css 379.84 kB │ gzip: 52.57 kB
dist/assets/PageHeader.vue_vue_type_script_setup_true_lang-DdgwR0GO.js 0.44 kB │ gzip: 0.29 kB
dist/assets/validation-Co109C3A.js 0.52 kB │ gzip: 0.42 kB
dist/assets/usePagedList-B6xbjlgd.js 0.53 kB │ gzip: 0.36 kB
dist/assets/CompanyDirectoryEmpty.vue_vue_type_script_setup_true_lang-CjtIpPc_.js 0.71 kB │ gzip: 0.52 kB
dist/assets/Status-BqrtPxLF.js 0.78 kB │ gzip: 0.60 kB
dist/assets/CompanyScope.vue_vue_type_script_setup_true_lang-Cft_Tm8Y.js 1.06 kB │ gzip: 0.71 kB
dist/assets/AccountRequired-0tv44nbR.js 1.43 kB │ gzip: 0.98 kB
dist/assets/SsoAuthorize-4VjTAaIe.js 1.47 kB │ gzip: 0.96 kB
dist/assets/Custom-Bpnf5k-1.js 2.11 kB │ gzip: 1.24 kB
dist/assets/group-N4e0juLR.js 2.26 kB │ gzip: 1.15 kB
dist/assets/Members-DCNVfFgm.js 3.35 kB │ gzip: 1.72 kB
dist/assets/Profile-BuwesBI9.js 4.75 kB │ gzip: 2.15 kB
dist/assets/Login-CFWsBfnm.js 4.94 kB │ gzip: 2.28 kB
dist/assets/Shell-BfO_MyoR.js 5.62 kB │ gzip: 2.44 kB
dist/assets/index-BsSsHQ6J.js 5.76 kB │ gzip: 1.61 kB
dist/assets/Companies-BCquObvx.js 5.93 kB │ gzip: 2.65 kB
dist/assets/Dashboard-DL4P50uN.js 5.94 kB │ gzip: 2.58 kB
dist/assets/Departments-BlxbUozz.js 7.74 kB │ gzip: 3.44 kB
dist/assets/Roles-NbhEIMTF.js 11.13 kB │ gzip: 4.70 kB
dist/assets/Menus-osNNkVbf.js 17.20 kB │ gzip: 6.70 kB
dist/assets/Users-BIxS61Ke.js 25.06 kB │ gzip: 8.68 kB
dist/assets/index-DsNWzruk.js 1,135.12 kB │ gzip: 377.25 kB
(!) Some chunks are larger than 500 kB after minification. Consider:
- Using dynamic import() to code-split the application
- Use build.rollupOptions.output.manualChunks to improve chunking: https://rollupjs.org/configuration-options/#output-manualchunks
- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.
✓ built in 21.19s
@@ -0,0 +1,20 @@
✔ owner 可从受保护 root 行打开实际只读客服弹窗,按有效权限展示且不改变集团/医院授权 (1465.4838ms)
✔ 未绑定、未配置、停用零权限与读取故障在实际弹窗中各有明确状态,不按同名推断 (466.0455ms)
✔ 弹窗 30 秒刷新,关闭和卸载停止;切用户、并发刷新和权限撤回不接受旧响应 (829.08ms)
✔ 非 owner/非集团隐藏客服入口;服务端返回其他用户快照按读取失败处理 (908.1934ms)
✔ owner 从受保护账号编辑客服角色,暂停刷新并等提交后展示服务端实际授权与新版本 (1354.0096ms)
✔ 独立权限支持搜索和空数组;不把目录停用误作禁止授权,不向共享角色批量写入 (345.8794ms)
✔ 409 保留草稿且阻止再次提交,明确重新载入才接收新版本并重置草稿 (258.4329ms)
✔ 编辑选项和保存响应均校验目标绑定;切目标、取消、关闭或权限撤回不接收过期响应 (210.4324ms)
✔ 未绑定不发起编辑;非 owner 不能读取编辑选项或保存;非法草稿不能覆盖未知权限 (228.3906ms)
✔ 仅注册客服公司 owner 看到同步入口,成功显示目录时间/数量并刷新列表,未触及授权接口 (195.2664ms)
✔ 同步未配置/网络失败不影响普通菜单;列表读取失败明确告知目录已同步 (136.4379ms)
✔ 同步去重且切公司再返回不会接受旧结果;错误公司/角色变更的响应不显示成功 (94.2912ms)
ℹ tests 12
ℹ suites 0
ℹ pass 12
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 7984.2458
@@ -0,0 +1,96 @@
✔ 迟到的旧会话 401 不会清除新登录 token (2.008ms)
✔ 当前会话的 401 仍会触发退出 (0.3911ms)
✔ 旧会话迟到的成功资料不会覆盖新账号资料 (0.2735ms)
✔ 当前会话成功响应正常返回,未登录密码错误正常显示 (1.3164ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ 用户编辑直接提交医院账号,空密码保持不变且不携带集团字段 (1069.3634ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ 管理员重置密码直接随医院账号保存,成功后清空输入值 (269.229ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ Users 保存当前权限后真实 HTTP 401 清会话并退出,不追加保存失败提示 (797.1447ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ Users 保存后网络刷新故障仍明确说明已保存 (659.3597ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ Users 保存中重复点击与再次打开表单不会产生第二次写入 (752.0001ms)
✔ Roles 保存当前权限后真实 HTTP 401 清会话并退出,不追加保存失败提示 (273.3058ms)
✔ Roles 保存后网络刷新故障仍明确说明已保存 (579.5996ms)
✔ Roles 保存中重复点击与再次打开表单不会产生第二次写入 (244.8514ms)
✔ 共享角色保留未展示授权和原数据范围,直接提交医院角色 (360.7636ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ root 账号仍受保护,当前账号也不能删除 (466.1299ms)
✔ 个人改密成功后清会话、清密码并退出,重复提交仅写入一次 (389.0517ms)
✔ 首次改密仍只提交新密码字段,登录页跳转失败不会误报改密失败 (261.1615ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ 写入失败不会清输入、关闭编辑框或提示保存成功 (437.0699ms)
✔ 功能为一级,公司为直接子项,源菜单 ID/权限/路径不被导航改写 (691.5417ms)
✔ 普通部门只读账号不会出现菜单模块,也不能通过菜单 URL 进入 (3123.4962ms)
✔ 集团管理员的新公司结构入口独立于医院菜单,医院及用户角色权限不随之开放 (786.1111ms)
✔ 功能重组仍尊重源读取权限、禁用祖先和仅隐藏导航的语义 (901.2845ms)
✔ company_id 严格解析,显式非法或无权公司不回退,缺省按当前/默认/首公司选择 (867.1142ms)
✔ 公司 URL 切换只保留角色获授页面,成员和登录资格不改变菜单,停用公司保留授权壳 (848.1258ms)
✔ 页内公司选择保留当前模块,并把选择同步到 URL 与公司请求头 (1090.4385ms)
✔ 未获角色管理授权或停用公司不请求医院目录,不显示写入口,调用写方法也不发送请求 (13930.7053ms)
✔ 可用公司的部门/菜单页面保留原目录读取与新增入口 (3926.8448ms)
✔ standalone 保留源路径和源目录导航,不附加公司范围 (296.7293ms)
✔ 真实授权守卫允许无医院权限的客服账号,不授予医院或普通管理页面 (324.1931ms)
✔ 真实授权守卫保留医院资格,拒绝未知、重复和未登记客户端及不可用应用 (586.5189ms)
✔ 真实客服授权导航仍优先要求登录、首次改密和企业微信验证 (622.7353ms)
✔ 集团登录仅接受唯一参数、已注册医院回调和 S256 challenge (64.9428ms)
✔ 授权响应回跳须匹配注册 origin/path、原 state 且只有一个 code (24.7001ms)
✔ 公司树分组不修改输入,成员载荷保留旧字段但不赋予业务权限 (1.8414ms)
✔ 真实集团 store 公司选择只改变结构范围,成员与登录标志不改变目录资格,退出清理上下文 (373.6041ms)
✔ 目录请求携公司头,切换再切回也丢弃旧响应,集团 API 不受公司头影响 (30.4536ms)
✔ 客服与医院各自校验精确回调,拒绝伪客户端和跨应用凭证 (2.7873ms)
✔ 集团工作台客服入口不依赖当前公司、医院权限或成员资格,不扩大结构权限 (354.4671ms)
✔ owner 可从受保护 root 行打开实际只读客服弹窗,按有效权限展示且不改变集团/医院授权 (1020.4599ms)
✔ 未绑定、未配置、停用零权限与读取故障在实际弹窗中各有明确状态,不按同名推断 (466.4558ms)
✔ 弹窗 30 秒刷新,关闭和卸载停止;切用户、并发刷新和权限撤回不接受旧响应 (806.5428ms)
✔ 非 owner/非集团隐藏客服入口;服务端返回其他用户快照按读取失败处理 (1457.1389ms)
✔ owner 从受保护账号编辑客服角色,暂停刷新并等提交后展示服务端实际授权与新版本 (1234.2781ms)
✔ 独立权限支持搜索和空数组;不把目录停用误作禁止授权,不向共享角色批量写入 (589.8464ms)
✔ 409 保留草稿且阻止再次提交,明确重新载入才接收新版本并重置草稿 (810.6347ms)
✔ 编辑选项和保存响应均校验目标绑定;切目标、取消、关闭或权限撤回不接收过期响应 (1233.0052ms)
✔ 未绑定不发起编辑;非 owner 不能读取编辑选项或保存;非法草稿不能覆盖未知权限 (624.0154ms)
✔ 仅注册客服公司 owner 看到同步入口,成功显示目录时间/数量并刷新列表,未触及授权接口 (580.0645ms)
✔ 同步未配置/网络失败不影响普通菜单;列表读取失败明确告知目录已同步 (461.0307ms)
✔ 同步去重且切公司再返回不会接受旧结果;错误公司/角色变更的响应不显示成功 (502.3114ms)
✔ 显式 native owner 不依赖应用、成员资格、源权限;旧能力字段不决定授权,停用祖先阻断操作 (286.8661ms)
✔ 空 native 公司显示新增部门,owner 可创建、编辑并删除空顶级部门且不刷新医院资料 (835.2697ms)
✔ native 菜单正常加载,M/C/A CRUD 使用公司权限前缀,配置不暗示导航已同步 (284.4664ms)
✔ native 前缀校验拒绝跨公司、裸前缀、空页面权限,目录可留空 (821.0349ms)
✔ native 文案、占位和 64/200 长度规则使用本公司约定,与医院 data_mode 无关 (867.5616ms)
✔ Departments 普通成员与停用公司没有写入口或读取,源星号也不授予 native 管理 (1208.4739ms)
✔ Departments 表单异步验证期间切公司再切回不提交旧数据,原对话框关闭 (263.6775ms)
✔ Departments 删除确认期间切公司再切回不提交;旧列表响应不能覆盖新公司 (858.0048ms)
✔ Departments 保存成功后列表失败明确提示已保存,写失败保持表单 (481.4267ms)
✔ Departments 已发出的写入始终属于原公司,切换后不刷新旧结果;重复点击不多写 (295.7244ms)
✔ Menus 普通成员与停用公司没有写入口或读取,源星号也不授予 native 管理 (1340.0381ms)
✔ Menus 表单异步验证期间切公司再切回不提交旧数据,原对话框关闭 (734.2711ms)
✔ Menus 删除确认期间切公司再切回不提交;旧列表响应不能覆盖新公司 (435.4182ms)
✔ Menus 保存成功后列表失败明确提示已保存,写失败保持表单 (495.3842ms)
✔ Menus 已发出的写入始终属于原公司,切换后不刷新旧结果;重复点击不多写 (636.4816ms)
✔ 医院部门保留顶级保护和原按钮授权,普通新增不获得集团能力 (522.7293ms)
✔ 医院菜单原路径、组件和权限原样保存;standalone路径限制保持不变 (1055.834ms)
✔ 跨公司多角色菜单并集不受成员、应用登录标志与当前公司切换影响 (1025.5882ms)
✔ 部门只读角色不获得菜单配置、按钮或其他公司的管理权限 (4942.2115ms)
✔ 普通角色以精确native列表和按钮授权管理本公司,无需成员关系或集团owner (4886.8105ms)
✔ 无角色用户仅有工作台,源通配符不能授权公司菜单,owner单独保留配置特权 (1731.6551ms)
✔ 源/native权限边界:native角色不能注入全局用户角色管理或医院入口 (2237.6505ms)
✔ 禁用祖先和按钮使native操作失效;隐藏菜单保留直达授权 (708.4017ms)
✔ native路径与组件安全投影,配置页固定company query,自定义组件和外链不执行 (952.7114ms)
✔ 全局用户/角色界面不携公司限定,角色跨公司授权只保存真实菜单ID并保留未展示授权 (2490.1593ms)
✔ 成员页面仅维护公司归属,兼容字段不会被成员开关变成应用授权 (1338.4224ms)
✔ 实际HTTP仅给Dept/Menu携company header;全局用户角色跨公司请求持续有效 (247.6328ms)
✔ 共享菜单保存保留原相对路径、组件、权限,且不发送额外源字段 (599.3823ms)
✔ 共享角色保留数据范围与未展示授权,独立角色载荷不增加数据范围 (48.6804ms)
[Vue warn]: onBeforeUnmount is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.
✔ 公司分组及主 GID 不写入医院用户旧载荷,仍完整保留角色部门关联 (39.3387ms)
✔ 首次改密优先于绑定门禁,受限账号不注册管理页 (214.515ms)
ℹ tests 80
ℹ suites 0
ℹ pass 80
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 39383.0639
Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

@@ -0,0 +1,127 @@
# 客服动态权限目录同步只读研究(2026-11-03)
本报告仅依据源码;未读取 `.env`、真实数据库或凭据,未连接运行中服务,未启停服务,未改动实现文件。按父任务约束,`.trellis/` 缺失,未假定存在 Trellis 流程。本文新增为约定交付物。
## 结论
目前集团目录是**源码静态抽取 → JSON → 管理员 CLI 导入**,没有运行时同步。客服后台已经支持动态新增、修改、停用、删除权限及菜单链接。因此“客服新增权限以后集团也能看到”确实存在目录链路缺口,但不能把这个现象一律解释为目录问题:集团 `/system/users` 的“分配角色”读取的是共享源角色,不读取客服本地角色;客服给用户改了本地角色,也不会通过目录导入回显到集团用户表单。
最小方案建议为**集团后台受控 pull 客服完整目录快照**,按固定机器身份认证;客服变更后可发不含目录和角色的“失效通知”,加快下一次 pull。集团仅维护目录投影,新增/更新/下线状态均可同步;同步事务不写 `role_native_menu`、源角色、用户角色或客服 `role_permissions`。现有业务授权边界继续成立:集团显式角色授权控制集团入口,客服本地 RBAC 控制客服业务。
## 已有实现与缺口
| 位置 | 已证实行为 | 对同步的影响 |
| --- | --- | --- |
| `C:/kefu/wechat_rpa/rbac.py:211` `seed()` | 每次迁移重建内置目录元数据;移除代码已删除的 builtin;保留 custom/discovered;admin 获全部客服权限;zyt_basic 被清空 | 发布/启动是目录变更来源。不能把集团同步接到 `_grant_admin_everything()` 或导入为集团自动授权 |
| `C:/kefu/wechat_rpa/rbac.py:334` `catalog()` | 返回所有权限的 code/name/group_name/page_name/kind/source/sort_order/link_url/link_mode/icon/enabled/updated_at,以及持有它的本地 roles | 可作为完整快照基础;需单独严格投影,排除 roles,避免泄露或混入本地授权 |
| `C:/kefu/wechat_rpa/rbac.py:367` `custom_menus()` | 只返回当前用户已获授权、enabled、kind=link 的链接 | **不能作为集团全量目录源**。普通用户看不到某项不代表源端删除;以它做全量差异会误下线目录 |
| `C:/kefu/wechat_rpa/rbac.py:447/469/491` | create_custom 新建 custom 并给客服 admin;update_custom 禁止 builtin,discovered 编辑后变 custom;delete_custom 禁止 builtin/discovered,删除本地相关角色授权 | 应在成功提交后使源快照版本变化;更新不改 code,code 可作为动态节点稳定身份 |
| `C:/kefu/wechat_rpa/rbac.py:505` `sync_code_permissions()` | require()/require_any() 用到但未登记的权限自动发现;代码不再使用的 discovered 自动删除;新项补给客服 admin | 不能只监听 CRUD;必须覆盖自动发现/清理 |
| `C:/kefu/wechat_rpa/admin_api.py:798-842` | GET permissions 需 permission:read / role:read / role:write 任一;POST/PUT/DELETE 分别需 permission:create/write/delete;GET custom-menus 需当前客服会话 | 现有接口是人类客服会话认证,不具备专用集团目录机器认证;不能挪用管理员登录态作为同步凭据 |
| `C:/kefu/wechat_rpa/admin_backend.py:2093-2155` | permission CRUD 在 BEGIN IMMEDIATE、audit、commit 中完成;sync_code_permissions 独立事务 | 新增版本/outbox 必须与源变更同事务;网络通知只能在 commit 之后执行,不能使目录保存依赖集团网络 |
| `C:/kefu/wechat_rpa/admin_api.py:429/1757` | 路由注册收集 used_codes,create_app 结束时调用自动同步 | 首次提供快照必须在这个同步之后;否则快照遗漏新代码权限 |
| `C:/zyt/identity-admin/scripts/build-kefu-catalog.mjs:10-53` | 读取 `C:/kefu/wechat_rpa/rbac.py` 的 PERMISSIONS 和 TS console.ts AST;排除 welcome,构造 version=1 静态 JSON | 不执行 Python,不读运行时 custom/discovered;它适合发布时生成内置路由清单,不是动态同步 |
| `C:/zyt/identity-admin/server/scripts/import-kefu-menus.php:10-17` | 仅 CLI,actor-id 必须在配置集团 owner 中;固定读 integration JSON | 没有 API/pull 调度/变更通知;现有 actorId>0 不是机器认证 |
| `C:/zyt/identity-admin/server/app/service/group/KefuMenuCatalog.php:12-71` | 仅接受 v1/kefu/kefu-local-roles;目标公司>1;建立 root/group/page/actions;通过 client/company/external_key 关联;已关联节点一律 kept | 重复导入稳定且保护集团修改,但名称、父级、enabled、链接等源更新**不会更新**,源缺失项**不会删除或停用** |
| 同上 `:53/58/64/68` | external_key 不依赖页面名称;page key 来自 TS route.name;group key 来自组名 SHA;action key 来自权限 code;未登记的同 paths 节点冲突拒绝 | 页面/权限身份可沿用;组名改名会产生新 group key,应迁移而非重复堆积;不能“按同名认领”集团手建菜单 |
| 同上 `:39-45` | 页面权限只取 permissions[0];每项权限另建 A 节点;页面真实 path 不存入公司节点;组件固定 common/custom | 现有集团条目是进入客服的提示入口,无法据此复现客服页面的全部权限逻辑;动态 link 也不应在集团直接执行远程 URL |
| `C:/zyt/identity-admin/tests/kefu-catalog.test.mjs:24-47` | 明确断言不授角色、不污染医院、重跑保留管理员 name/disable、无效输入拒绝、audit 失败整树回滚 | 必须保持这些契约;不能简单把 import 改为无条件覆盖 |
补充:rbac.seed 内置字段更新不维护已有行的 `updated_at`,删除也没有墓碑;因此**不能只按 updated_at 增量拉取**。初期用规范化完整快照内容哈希作 revision 最稳妥,后续再加严格事务性单调版本。
还需区分 `enabled` 的现有含义:`rbac.py:292-298` 的 permissions_of 仅查询 role_permissions,不过滤 permissions.enabled;`:367-375` 仅在自定义菜单链接显示时过滤 enabled。因此客服“停用菜单链接”目前不等于撤销客服 API 权限。集团可把源 enabled=false 解释为集团入口目录下线,但不能宣传为客服业务权限已撤销;若需改变这个源端语义,应单独实施并测试,不能顺手夹在目录同步中。
## `/system/users` 与角色回显必须分开定位
集团用户链路:
1. `C:/zyt/identity-admin/web/src/views/Users.vue:16/23/41-60` 从 `/auth.admin/lists` 取用户,打开表单时读取 `/auth/options`,使用行内 `role_id` 数组回填,提交仍为源角色 ID。
2. `C:/zyt/identity-admin/server/app/service/shared/SourceMapper.php:30-40` 对源 `role_id` 或 `role_ids` 映射为集团 role_id;没有客服角色映射。
3. `C:/zyt/identity-admin/server/app/service/shared/SharedRecordsService.php:70-82` options.roles 来自 `auth.role/all`;`:91-99` 仅给这些源角色合并集团 native menu_id;`:152-178` saveAdmin 校验、写回源角色。
4. 集团角色树在 `web/src/views/Roles.vue:42-53` 获取 options.menus,勾选源角色 menu_id。`SharedRecordsService.php:81` 合并 `GroupService::roleMenuTree()`;`RoleAccessService.php:70-73` 直接读取集团公司菜单。故动态目录同步成功后,下一次打开角色编辑器即可看到目录,既有角色不会自动勾选新项。
客服用户链路:
1. `C:/kefu/wechat_rpa/admin_api.py:304-320` 用户列表公开的是单个本地 role 字符串;`Principal.payload():337-349` 返回本地角色和当次权限。
2. `admin_backend.py:2158-2168` 根据客服 users.role 查询本地 role_permissions;`/api/v2/roles` 是本地客服角色,不是集团源角色 ID。
3. `C:/zyt/identity-admin/server/app/service/group/GroupService.php:412-417` kefuIdentity 严格只返回身份字段,不带角色/权限;`:450-455` SSO 明确拒绝把源 root、角色或集团任职解释成客服授权。`C:/kefu/wechat_rpa/group_sso.py:103-118` validate_identity 还要求字段集合严格相等。
因此验收应至少区分三项:A 新权限在集团角色目录可见;B 集团给用户分配的源角色保存后回显正确;C 客服管理员分配的本地角色是否需要在集团**只读显示**。目录同步只解决 A。若实际诉求是 B,应追踪 auth.admin/lists/detail 的 role_id、options.roles 和 saveAdmin 写回结果,不能导入更多菜单冒充修复。若是 C,新增单独标注“客服角色”的只读投影(源=客服、用 gid/source_admin_id 的可靠身份绑定、分别显示 code/name/permissions),不要塞进现有 role_id。若还要在集团编辑客服角色,则是独立的客服授权 write-through 功能,需要显式操作权限、客服权威校验、审计和并发版本控制,超出目录同步最小方案。
## 推荐协议:完整快照 pull,push 仅做失效提示
### 机器边界及认证
- 客服新增 `GET /api/v2/integrations/group/catalog`;集团通过部署登记的固定客服 base URL 请求。基础 URL、client_id、公司映射只由部署配置决定,不能由浏览器请求体指定;https 或 loopback http,禁止重定向/代理环境改变目标,限制响应大小及超时。可沿用 `group_sso.py` 的 URL/NoRedirect 思路,不能直接复用其人类身份交换端点。
- 使用独立、服务端专用目录凭据,最小 scope `catalog:read`,绑定 client_id=kefu 和注册公司;不使用医院/集团/客服管理员会话 token,不在浏览器暴露。最小可实现为独立随机 Bearer 服务 token + TLS、常量时间比较、日志脱敏;如部署要求双向推送,建议双方 HMAC 请求签名(method、固定 path、timestamp、nonce、SHA256(raw body)),短时间窗及 nonce 唯一约束、key_id 支持轮换。两者选一套明确协议,不能把本报告描述成已存在的机制。
- 当前项目不存在可复用的目录机器认证:KefuClient 仅登记回调,现有 SSO 是用户授权码+PKCE。不要新增“不登录就信任 client_id=kefu”的公开导入接口。
- 若新增失效通知:客服 `POST /adminapi/integrations/kefu/catalog-changed` 仅含 client_id/revision;使用独立写通知 scope,集团只排队 pull,不信任来包任意节点或 company_id。重复通知可合并。无凭据配置时功能关闭,保留旧静态 CLI 导入能力。
### 快照结构(建议 v2,不悄然重解释 v1)
```json
{
"version": 2,
"client_id": "kefu",
"authorization_mode": "kefu-local-roles",
"snapshot_type": "full",
"revision": "sha256-of-canonical-metadata",
"generated_at": "UTC timestamp",
"menus": [
{"key":"CustomMenu:report:read","name":"报表","group":"运营","permissions":["report:read"],"enabled":true,"sort_order":0,"source":"custom","kind":"link"}
],
"permissions": [
{"code":"report:read","name":"报表","group_name":"运营","page_name":"","kind":"link","source":"custom","enabled":true,"sort_order":0}
]
}
```
- permissions 来自完整运行时 rbac.catalog 严格字段投影,不能包含 roles/users/tokens/passwords/任职。revision 不包含 generated_at、roles、角色授权或用户数;否则授权变化会伪造目录变化。JSON 排序及布尔/空串规范化固定后再哈希。
- builtin 页面还需要发布生成的内置路由 manifest(TS route.name 稳定 key、path 仅作元数据)。不能仅靠 kind/page_name 推测路由,因为一个页面可能有多个 authority。最小改造保留已有静态 menus 作为发布清单,再在**客服进程**合并 runtime permissions 和 kind=link;不可把 v1 静态 permissions 与运行时缺失项一起当作完整权威快照。
- 动态菜单 key 使用 `CustomMenu:`+不可变权限 code,与客服 `custom-menus.ts:55` 的路由 name 一致;action 仍以 code 作 key。code 删除后同名新建是否视为同一个资源需定契约:最安全是源额外生成 immutable resource_id/incarnation,重建产生新 ID,避免旧集团授权复活。若首版仍只用 code,下线再出现必须保持 archived,不自动恢复旧授权,交集团管理员确认新节点/显式恢复。
- 集团 v1 的菜单 key 正则不接受冒号,v2 应明确新的受限外键格式或编码为稳定安全 key(如 custom-+code 的摘要),不要直接破坏旧验证。
- link_url/link_mode 如仅展示,可选发送且按现有 _clean_link 规则重新验证;集团继续 common/custom 提示“进入客服”,不据此执行任意站外 URL/组件。
- 只有成功收到、认证通过、完整结构与全部引用校验通过、snapshot_type=full 的快照才允许做 missing diff。超时、半包、非法 JSON、未知菜单引用、超限、认证失败一律保留上次成功状态。空的 full 快照应单独受显式全量清空保护,不能把异常空数组自动解释为删除全部。
- ETag=revision;If-None-Match 命中可 304,不写节点。v2 数量/字节上限明确配置并覆盖合理增长;不要沿用固定 100 菜单/200 权限而静默截断。
### 集团合并规则:身份不变,保留本地编辑,源下线独立生效
扩展 application_catalog_node 或建立 metadata 表,至少保存 `source_revision/source_payload(or normalized fields)/source_enabled/source_present/last_seen_revision/local_overrides`。以 `(client_id, company_id, external_key)` 唯一,node_id 一旦建立不因改名/排序/分组改变。
1. **新增**:只创建自己拥有的映射和 company_structure_node;paths 冲突仍 409;不认领同名手工节点;不修改任何角色表。集团新建节点权限仍严格在 company.<registered-company>.kefu. 命名空间。
2. **更新**:source-owned 的 code/资源身份/type/组件安全约束不能被远端任意覆盖;显示字段 name/sort/icon/is_show/pid 采用三方合并:如果当前值等于上次实际应用值,则更新为新源值;若不同,记录/保留集团 override。v1 迁移没有 baseline 时,对已有映射采取保守“未知是否本地改过=保留当前”,先存新源快照,不能假设所有旧值可覆盖。显式本地恢复跟随源可清除 override。
3. **停用**:`effective_enabled = source_present && source_enabled && local_enabled`;源端 enabled=false 必须让集团有效权限立即失效,但不能把 local_enabled=0 覆盖成1。**不要直接反复覆盖 company_structure_node.disable**,它目前同时承担集团管理员决定;应有独立 source 状态,所有授予验证、grantTree/publicMenu、effective/activeChain 都合并该状态。UI 显示“源端已停用/已删除”,不让树中可勾选状态和后端矛盾。
4. **删除**:完整快照 missing 项先标 source_present=false/archived,下线权限与入口,保留节点 ID、手工编辑和历史关联,不硬删且不操作 role_native_menu。原因是该表 FK ON DELETE CASCADE,硬删会破坏“roles_changed=0”和回显;父节点缺失时对自有子树整体做一致处理,不碰手工子项。无现存源成员的自动 group 可 archived;本地自建孩子保留并报告需要处理,不能移除整棵混合树。
5. **重现/回滚**:source 缺失后的 code 重现应防止旧角色授权复活;推荐新 incarnation,新 node_id,旧节点继续 archived。服务回滚到旧发布 manifest 时也不得无条件复活已下线权限;可增加单调 source generation、明确 rollback 操作,内容哈希只用于幂等不提供先后顺序。
6. **幂等及事务**:同 revision 无变化;单次完整验证后在 GroupStore::write 内应用全部差异、保存 revision、写 audit,失败全回滚。并发同步按应用/公司锁或事务 CAS last_revision 防止较旧请求覆盖较新快照。返回 created/updated/unchanged/archived/conflicted/revision,`roles_changed=0` 必须由表前后快照验证,不是硬编码自证。
## 触发点与最小落地范围
| 触发点 | 设计 |
| --- | --- |
| 集团首次打开客服角色目录/手动“同步目录” | owner 或专用管理权限调用受控 sync,先 pull 再成功刷新 auth/options;网络失败显示最后成功同步时间和安全错误,旧目录保留 |
| 客服 create/update/delete 成功提交 | 目录 revision/outbox 同事务更新,commit 后可发送失效通知;集团不可用时不影响客服保存,可重试/等待下次 pull |
| 客服 API 发布启动完成 seed + sync_code_permissions | 重新生成 revision(含 builtin/discovered 删除),通知或等待集团 pull;不可在建路由前拿快照 |
| 集团周期对账 | 既定部署任务触发 pull,解决通知丢失与多进程迁移;本次研究不创建系统定时器 |
| 集团角色编辑器已打开 | 成功同步后重新获取 auth/options,明确新增项未勾选;避免后台每个读取请求都阻塞外网,可用短 TTL 和单飞锁 |
建议修改文件:
- 客服:`wechat_rpa/rbac.py` 增加无角色信息 catalog projection 或单独 `catalog_sync.py`;`admin_backend.py` 提供一次一致读快照、revision/outbox;`admin_api.py` 添加机器专用只读端点及提交后失效触发;发布脚本生成 `builtin-menu-manifest.json`;不要把 C:/zyt 的 integration 副本当作唯一生产源码。
- 集团:`server/app/service/group/KefuMenuCatalog.php` 保留 v1 import,新增 v2 reconcile;`GroupStore.php` 集中 schema migration;新增受控目录客户端与机器认证/同步服务;`server/route/app.php` 明确新路由;相关 controller/bridge 显式路由到该服务;`RoleAccessService.php` 合并 source 状态用于验证和有效授权;`web/src/views/Roles.vue`/相关 types 只需同步状态提示与刷新,不改用户 role_id 语义。
- 若真正问题是集团用户角色回显:优先单独修 `Users.vue`、`SharedRecordsService::paged/saveAdmin`、SourceMapper 用户映射和源响应契约;不能以新增目录接口替代。
## 测试计划与现有证据
本研究未执行测试、未启动应用。以下为应复用/增加的隔离测试,全部使用临时 SQLite 与本地 mock HTTP,不访问生产库或真实账号。
1. 复用 `C:/zyt/identity-admin/tests/kefu-catalog.test.mjs`:旧 v1 导入兼容、不授集团角色、管理员 name/disable 保留、医院不污染、冲突拒绝、审计失败回滚。
2. 复用 `C:/kefu/wechat_rpa/test_admin_api.py:617-699/887-906`:custom CRUD、builtin 不可改/删、链接校验、custom-menus 按用户过滤、discovered 添加和移除。新增 snapshot 测试断言**不按当前用户过滤**、不含 roles/users/秘密。
3. 源快照:创建 action/link、改名/分组/排序/停用、删除、seed 新增/移除 builtin、sync_code_permissions 新增/清理 discovered 后 revision 正确变化;纯角色授权变化 revision 不变;同秒多次变化、删除不依赖 updated_at。
4. 合并:首次新增/同 revision 重试/同 code 显示字段修改保持 node_id;保留集团手工改名与本地停用;源停用/删除立刻从 effective 权限和导航消失;grantTree 正确标识不可新授;既有角色关联仍可回显;重现不恢复旧授权。
5. 安全:缺少/错误机器凭据、错误 scope、跨公司或客户端、签名重放(如选 HMAC)、非法 URL/重定向/非 loopback http、过大响应/条数、重复 key/code、非法组件、坏权限引用、越界路径、空 full 快照保护。
6. 可靠性:超时/500/断流/非法 JSON 不会把旧目录归零;并发 pull 只应用有序最新快照;应用中审计/写入失败完全回滚;通知在 commit 后且失败不回滚客服操作;丢通知由全量对账补齐。
7. 授权不变:每轮同步前后快照比较源角色/role_native_menu/客服 role_permissions/用户角色不变(客服 CRUD 自带 admin 补权及删除授权除外,它们应在源功能测试中单独验证);集团新目录未自动勾选,已有客服普通用户不因目录同步获得新业务权限;zyt_basic 始终空。
8. 用户回显回归:复用 `tests/group-write-through.test.mjs`、`role-driven-bridge.test.mjs`;集团保存 role_id 后列表/详情/重新打开表单一致;客服本地角色变更在下一次 SSO 后仍保留(`C:/kefu/wechat_rpa/test_group_sso.py:105`);纯目录同步既不改变集团 role_id 也不改变客服 role。
验收必须分别记录“集团角色目录已可见”“集团用户角色已回显”“客服实际权限有效”三项,明确其中哪些是本次实施范围,避免只看到静态菜单截图就宣称跨系统权限同步完成。
@@ -0,0 +1,30 @@
# 客服中央SSO后端交付记录
日期:2026-11-02。
## 改动
- `identity-admin/server/app/service/group/KefuClient.php`:增加默认关闭的固定客服客户端配置,校验HTTPS或回环HTTP、固定回调与公司编码。
- `identity-admin/server/app/service/group/GroupService.php`:按client分派授权和兑换,按配置公司编码解析真实资源;源有效账号即使医院权限为空也可进入客服,不依据公司任职或源root授客服权限。保留医院SSO响应和授权门槛。
- 客服exchange只返回 `client_id/gid/source_admin_id/account/name/company_id` 六项可信身份,原子消费原60秒PKCE授权码,重新检查实际源会话、主体、账号门禁和公司状态。
- `identity-admin/server/.env.shared.example`:仅新增留空配置项和示例注释,未改真实环境文件。
- `identity-admin/tests/kefu-sso.test.mjs`:纯合成源、临时SQLite、禁止真实.env的服务与HTTP回归。
- `identity-admin/docs/kefu-sso-backend.md`:配置、固定端点、请求响应、权限边界、失败语义与隔离验证说明。
未修改GroupStore schema、真实账号/授权、真实runtime数据库、菜单catalog或客服项目文件。中央不复制密码,不引入静态共享secret,也不把源角色、医院权限、集团管理员或成员关系传入客服。
## 实测
PHP:`C:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe`,启用 `-d extension=pdo_sqlite`。
- 新增KefuClient及GroupService均通过PHP语法检查。
- `node --test identity-admin/tests/kefu-sso.test.mjs identity-admin/tests/group-api.test.mjs`:3项通过(新客服配置/时间边界及HTTP流程、既有医院集团HTTP流程)。
- `node --test identity-admin/tests/shared-api.test.mjs identity-admin/tests/role-driven-bridge.test.mjs`:21项通过;角色桥接另完成54条隔离服务断言。
- `php -d extension=pdo_sqlite identity-admin/tests/group-identity.php`:40条隔离断言通过。
- 独立只读复核确认配置、身份最小化、授权码绑定、门禁及医院兼容性无阻塞项;测试文件通过 `node --check`。
环境沙盒首次禁止Node访问自己启动的127.0.0.1服务(EACCES),HTTP测试随后在获准的本机网络执行环境中通过;没有访问真实源API。所有测试保持独立临时数据和显式禁载.env,不以真实账号做写入验收。
## 部署边界
默认不启用客服应用。部署需显式配置客服浏览器base与已登记公司的code,固定回调为base后追加 `/auth/group-login`;公司及祖先必须启用。客服Python后端只信任服务端向固定中央exchange端点兑换成功的六字段身份,首次本地账号必须最低权限,再由客服本地管理员授权。已建立的客服本地会话生命周期仍由客服策略负责。
@@ -0,0 +1,46 @@
# 客服中央权限可见性实现(2026-11-03)
已完成中央后端与隔离测试。未读取 `.env`、真实数据库或真实密钥,未启停任何服务,未改动客服镜像及集团前端。本实现遵循 `C:/zyt/identity-admin/integration/kefu-group-access-contract.md`。
## 完成行为
- `GET /adminapi/group/application/access?client_id=kefu&source_admin_id=<id>`:仅配置名单内且当前源身份为 root 的集团 owner 可读;每次以当前源 token 重新查询目标 `auth.admin/detail`,仅查询既有 subject.GID,不注册、不按用户名匹配。按 GID 向客服读取实时角色和有效权限,严格核对 source_admin_id 与登记客服公司。返回独立 DTO,不合并到当前用户的 permissions/native_permissions/role_id/menus。
- `POST /adminapi/group/application/sync`:请求体仅 `{client_id:"kefu"}`,同样仅显式 owner。读取完整运行时目录后更新中央托管节点,不写集团角色授权、医院/source 表或客服角色表。
- owner 列表查询客服公司的 `menu.lists` 时,自动尝试有界拉取;每公司一分钟最多一次,包括失败。失败保留可用旧目录,不阻断正常列表;显式 sync 绕过该 TTL。真实网络连接超时 1 秒,总超时 3 秒。
- 缺少 metadata 配置返回 not_configured;既有 GID 缺失或客服不存在绑定返回 not_enrolled;网络、MAC、响应结构或身份归属错误返回安全 503,不伪装成“没有权限”。
## 修改文件
| 文件 | 用途 |
| --- | --- |
| `C:/zyt/identity-admin/server/app/service/group/KefuMetadataClient.php` | HMAC 请求、nonce 绑定响应 MAC、时间窗、严格 DTO/对象数组形状校验;固定配置 URL/密钥文件;禁止代理与重定向;TLS/回环 HTTP;4MiB body 与16KiB header上限 |
| `C:/zyt/identity-admin/server/app/service/group/KefuApplicationService.php` | 实时用户权限只读投影、完整目录拉取与有界自动刷新 |
| `C:/zyt/identity-admin/server/app/service/group/KefuMenuCatalog.php` | 保持原 import 不变,新增 managed sync 和显式本地编辑记录 |
| `C:/zyt/identity-admin/server/app/service/group/GroupStore.php` | 建立目录关联及 baseline/applied/overrides/local_disable/source_disable 状态表 |
| `C:/zyt/identity-admin/server/app/service/group/GroupService.php` | owner guard、接口调度、客服公司菜单列表自动刷新;可注入合成 metadata client 测试 |
| `C:/zyt/identity-admin/server/app/service/group/CompanyStructureService.php` | 菜单编辑记录独立本地覆盖,尤其源已停用期间用户显式手动禁用 |
| `C:/zyt/identity-admin/server/app/controller/ApiController.php` | sync JSON body 路由解析 |
| `C:/zyt/identity-admin/server/route/app.php` | 明确注册 GET access / POST sync |
| `C:/zyt/identity-admin/tests/kefu-metadata-fixture.php`、`kefu-metadata.test.mjs` | 运行实际 PHP 服务类、合成 HTTP transport、临时 SQLite 的172项断言 |
## 目录合并语义
运行时权限列表为权威,静态 JSON 只用于保留18个内置页面的既有 external_key。所有 runtime 权限进入 action 节点;未知 kind=page 产生基于权限 code 哈希的稳定页面 key,组件固定 common/custom。协议不传任何外链,集团不会执行客服自定义链接。
节点 name/sort/pid/type/component/perms 采用 baseline 与上次 applied 三方比较;独立集团编辑被标记覆盖,后续同步保留。已有 v1 导入节点首次转为托管时对照原静态默认值识别已存在的本地改名与停用。源新增、名称/排序变化、禁用、删除均能同步;删除仅软停用且保留 node_id 和 role_native_menu 引用。源恢复后恢复源状态,但独立集团手动禁用继续保留。该恢复语义按本次协议执行,不引入新 incarnation 或重新授权流程。
托管状态与节点在同一 GroupStore 写事务中更新并审计,审计失败全部回滚。旧 import 的保留修改行为及原测试继续成立。源 enabled 仅作为中央目录显示状态,不修改客服 API 的既有授权语义。
## 验证结果
以下实际 PHP + 临时 SQLite / 合成 source transport 套件均通过(未启动服务):
- 新 `kefu-metadata.test.mjs`:172项,覆盖 owner 鉴权、请求签名、响应篡改/nonce/过期/非法形状、source/GID/company mismatch、不按账号注册、实时 DTO、不配置、稳定页面标识、增改删恢复、手动覆盖、源停用期间手动禁用、审计回滚、TTL、角色关联/医院节点/subjects/membership 不变。
- `kefu-catalog.test.mjs`:285项,原 import 幂等、保留集团修改、不授角色、不污染医院、失败回滚。
- `company-structure.test.mjs`:600项。
- `role-access.test.mjs`:77项。
- `group-write-through.test.mjs`:45项。
上述五套1179项断言已在最后一次统一运行中全部通过。新增及修改的核心 PHP 文件语法检查通过。
运行方式:在进程环境设置 IAM_TEST_PHP 指向 PHP 8.2+,执行 `node --test C:/zyt/identity-admin/tests/kefu-metadata.test.mjs`。测试过滤所有继承的 IAM_* 环境变量,使用临时路径和代码内合成密钥;不读取真实配置或密钥。跨真实 HTTP 的中央/客服联调由根任务统一完成,本文不声称已完成该联调。
Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

@@ -0,0 +1,31 @@
# 客服同框直接密码登录交付
2026-11-03。已按用户明确要求改为同一个客服登录框输入ZYT或原客服账号密码,不跳转集团后台。代码、247个前端产物和当前本机API/预览均已更新。
## 最终行为
- 主页面只有账号、密码和登录按钮,不读取集团网页配置、不生成浏览器跳转。账号密码只放统一`POST /api/v2/auth/login`请求体。
- 有效本地凭据优先,原角色、30天会话及首次改密策略保持。集团服务不可用时,正确本地凭据也不调用它。同名账号不合并;仅ZYT凭据匹配时使用独立provider/GID身份。
- ZYT首次绑定为固定空权限`zyt_basic`,不继承源root、角色或菜单。客服本地管理员在系统管理→用户管理分配本地业务角色,重复登录保留分配结果及停用决定。集团来源会话8小时。
- 客服服务器仅依赖`ZYT_GROUP_API_URL`,不依赖集团前端或回调变量。固定调用中央`POST /adminapi/group/kefu/login`,输入仅client_id=kefu/account/password,返回原有六字段身份DTO。
- 中央只调用原项目新增`identity.session/verify`。源服务在账号行锁内核验当前密码、停用和验证门禁,不调用原登录、token签发或退出,因此不会旋转/注销用户已有ZYT网页会话。保留原限流,直接验密忽略调试免密;中央与客服限流也保留。
- 不把ZYT密码复制成客服本地密码,不保存源token;现有日志递归脱敏仍生效。旧集团工作台SSO路由保留兼容,主登录框不使用它。
## 验证
- 真实原项目框架+临时SQLite:新增源验密25检查,含真实控制器、当前密码复验、调试免密禁用、源限流、源会话及登录元数据完全不变。既有共享会话37检查、账号同步65检查、操作日志脱敏回归通过。
- 中央新增隔离405检查、原集团40检查、原限流3场景与PHP语法检查通过。严格DTO、公司/客户端与验证门禁、空医院权限、失败无会话等均覆盖。
- 客服后端33项通过(新直登17+原SSO16),全部临时库及回环合成服务。包含本地成功零外呼、同名源admin最低权限、再登录保留授权、源/本地停用、源错误/关闭/重定向/响应超限、不同会话TTL和本地管理员授权。
- 最终全部前端22项通过,实际Vue SFC/SSR、实际登录API/store/user mapper与Vben路由过滤。一个表单普通提交、不调用集团配置/不跳转、失败重试、密码不进URL/存储、旧管理员缓存不污染基础用户均验证。
- 跨项目真实PHP中央→Python客服联合100检查及Node边界断言通过,只有13次纯验密调用,源会话/元数据不变,0桥接会话/授权码/角色自动授权。用原token访问models在本地管理员授予viewer后实际200,重复登录保留ID与角色;错密码和停用拒绝。
- 全量vue-tsc及生产构建通过:7484模块,56.24秒,247产物。冻结副本依赖清单、锁文件及样式配置前后哈希一致,未安装依赖或复制真实.env。
- 5666/8766登录页、客服与中央健康HTTP200,空登录体HTTP422。源新verify空体实际返回参数拒绝,中央新端点缺字段HTTP422,证明实际路由已启用。
- 真实浏览器已核对单框页面,截图`kefu-direct-password-20261103.jpg`。没有代用户输入真实密码;认证及角色写入验证全部使用合成身份和临时库。
## 发布记录
客服清单26文件,7项本轮变更已应用,最终待应用差异0。源码备份`.test-runtime/kefu-source-before-20261103-152827`;产物备份`kefu-web-before-20261103-152832`。发布记录`identity-admin/.test-runtime/kefu-password-publish-result.json`,入口SHA256=1cee2372617048a49c4b19e18a54d6f086d300bd74202cbf0a710b10762e3fe7。
源产品变更在C:/zyt/server/app/adminapi/{service/IdentitySessionService.php,controller/identity/SessionController.php,validate/LoginValidate.php},已同步original-server镜像及新增源测试。辅助入口project-api-router.php已登记verify。当前客服API父PID22752、预览PID5256,仍使用已有C:/kefu/backend.db;未重置真实密码或人工分配真实用户角色。
集团源停用/改密会影响后续直登;已有客服会话按本地退出、停用及8小时过期处理,尚无源改密立即全局踢下线协议。
@@ -0,0 +1,56 @@
# KF 只读授权快照端点交付
日期:2026-11-03。协议依据:`C:/zyt/identity-admin/integration/kefu-group-access-contract.md`。
## 已实现
- 镜像新增 `integration/kefu/wechat_rpa/group_access.py`:专用 HMAC 服务认证、原始响应签名、严格 JSON 契约、按 provider/GID 只读投影和动态权限目录。
- 镜像 `admin_api.py:52,374,703`:只增加模块导入、每个 app 的 nonce 缓存实例,以及 `POST /api/v2/group/access-snapshot`。普通用户认证/权限依赖保持原实现。
- 新增专用 `integration/kefu/wechat_rpa/test_group_access.py`:从实际客服目录只复制公开 `.py` 模块到工作区临时目录,覆盖本次镜像;使用真实 FastAPI、临时 SQLite、假的初始配置与新建合成测试密钥,不启业务服务。
没有改真实 `C:/kefu` 文件,没有改 manifest、集团 server/web、镜像 admin_backend/rbac,也未读取 `.env`、真实 DB、已有密钥或令牌。实际客服三个源文件修改前后 SHA256 一致,且修改前与镜像完全一致:
```text
admin_api.py CBF57D04E1F92633E57B455A6435A884D9C517DF8EF05FDAABDCE027929C8A06
admin_backend.py 52990C68A4B741739D16383AAEA948D603AB6EADC6798A83B1332EFC2C375381
rbac.py 0EA089BAA98487069919E830FB49CAD22A7D40728F93EE1AA681FADA9E3AE1BB
```
## 协议行为
请求固定三个字段:`client_id=kefu,gids,include_catalog`,GID 为唯一的 `gid_`+32位小写 hex,最多100个;空 GID 列表可只查目录。请求原文最多16KiB,签名/时钟/nonce 验证在 JSON 解析之前完成,拒绝额外字段、重复 JSON key、错误布尔类型、非标准 JSON 常量及重复安全头。
密钥只从 `ZYT_GROUP_METADATA_KEY_FILE` 显式指定的绝对路径读,最多65字节并要求内容恰好64个 hex 字符;不接受缺失、非法、符号链接或位于已知前端静态公开目录中的文件。缺配置安全失败,不降级为普通用户 token。
签名文本严格使用合同的固定 `/group/access-snapshot` 路径(实际路由 `/api/v2/group/access-snapshot`),不把 `/api/v2` 拼入签名。时间窗90秒,nonce 为32位小写 hex。缓存加锁、最多8192项,只清除过期项;已满时拒绝新请求,不驱逐仍在窗口内的 nonce。成功响应按原始 JSON 字节签 `response\n<request_nonce>\n<sha256(body)>`,附 `X-Group-Response-Signature` 和 `Cache-Control:no-store`;错误也禁止缓存且只返回固定安全信息。
只查询 `provider=zyt_group` 的既有绑定,不调用 `group_sso_user()`、注册、迁移、seed、sync 或 grant。每个请求 GID 按原顺序精确返回一项;缺失项只有 `gid,found:false`。同名本地账号不能被认领或回显。角色来自客服现有 users/roles,权限通过现有 `database.permissions_for_user()`,停用账号权限为空;目录 enabled 不被误作 API 鉴权开关。
目录从当前 `permission_catalog()` 读取,只输出 code/name/group/page/kind/source/enabled/sort。实际 KF 自定义 `kind=link` 映射为协议 `kind=page`,不输出链接地址。角色持有人、用户数、密码摘要/盐、token、密钥、配置路径均不进入 DTO。限制每用户2000码、目录2000项、响应4MiB。
## 验证结果
执行命令:
```powershell
C:/kefu/wechat_rpa/.venv/Scripts/python.exe C:/zyt/identity-admin/integration/kefu/wechat_rpa/test_group_access.py
```
最终结果:**18 tests passed,15.530秒**。覆盖:
- 请求 HMAC、错误密钥、正文/签名路径篡改;验证前不解析 JSON;响应原文/nonce 绑定签名。
- 90秒边界、过期/未来时间、重复 nonce、8个并发同 nonce 仅1个成功、缓存满时安全拒绝。
- 普通用户 bearer 不能代替机器凭据,缺失/非法/公开目录密钥失败,严格 body 与大小/数量限制。
- 未绑定读取不创建账号;同名账号与多个 GID 隔离;只查指定 provider;响应次序与请求一致。
- 客服角色修改与停用立即在下一次读取反映,验证确实调用现有有效权限读取器。
- 动态权限目录新增、修改、删除实时反映;自定义链接转页面且外链不泄露。
- 读请求前后 `users,roles,role_permissions,auth_tokens,permissions,group_sso_bindings` 全表行保持一致。
- 无需目录时不调用目录读取;响应精确字段集与无凭据投影。
Windows 当前执行沙箱阻止 Python asyncio 创建内部 loopback socketpair,第一次 TestClient 在 socket.accept 卡住,未进入端点。用 faulthandler 确认后,已通过获准的 `require_escalated` 运行相同合成测试并全部通过。仅清理了精确核实过的两次受阻测试进程及其临时目录;未停止或启动任何业务服务。测试自带60秒 traceback/退出上限,避免以后在相同限制下留下悬挂测试。
## 主流程集成事项
`admin_api.py` 现在依赖新 `group_access.py`,安装 manifest 和已有联合测试镜像复制列表需要包含该模块;这些文件不在本子任务写入范围,已告知主代理。实际部署/配置密钥与集团查询、目录同步、用户 UI 均由主流程继续处理。本交付没有声称真实服务端点已安装或重启。
内存 nonce 防重放按合同允许,作用域为一个 app 实例;多 worker 各有缓存,若需跨进程统一拒绝重放,应换共享原子 nonce 存储。这个协议仅返回当前读取结果,不承诺跨服务事务或全局注销,也不修改任何业务授权。
@@ -0,0 +1,26 @@
# 客服前端构建与发布
2026-11-02完成。源码来自用户指定的C:/kefu/admin-web,构建目录为C:/zyt/identity-admin/.test-runtime/kefu-admin-web。没有复制或查看真实.env文件;C:/kefu原package.json和pnpm-lock.yaml保持原样。
## 隔离构建
原工作区没有node_modules,且已有锁文件的catalog与部分importer清单不一致。在公开源码副本内将清单引用对齐到原锁文件已经记录的精确版本,完成冻结安装;不将隔离清单变动部署回原项目。使用Node24.22.1、pnpm11.25.0,安装1492个锁定包与52个既有工具依赖,执行node-utils/vite-config/shared等必要stub。
原Trellis工作流目录缺失;构建遵循已有Vben导出及应用结构。独立构建worker到达账户使用限制后,主代理继续收尾,未把worker错误当作构建通过。
Tailwind原扫描包含多个workspace目录,构建曾耗时20分钟。在隔离副本的internal/tailwind-config/src/theme.css追加@source not排除node_modules、dist及dist-final,继续包含真实apps/packages/docs/playground源码。此项只作用于隔离构建,不更改C:/kefu原样式配置。
最终执行完整应用vue-tsc --noEmit --skipLibCheck,退出0;随后直接运行应用Vite production构建,退出0,转换7462模块,耗时1分11秒。此处未声称完整Turbo所有库发布任务通过。
公开构建配置:history路由、标题“企微客服”、命名空间kefu、Vite base=/、API同源/api。app-config插件仅加载.env,故构建后显式生成其既有不可变window导出,唯一字段为VITE_GLOB_API_URL=/api,不含任何密钥或账号。
## 验证与发布
- 登录状态、PKCE、回调拒绝、跨账号缓存清除7项;首页映射1项;实际Vben权限函数导航1项,总9项通过。
- 首次基础用户、原管理员默认首页、强制改密页面及非统计角色安全首页均有覆盖。
- 真实浏览器当前“集团基础用户”无业务授权,最终只有“我的账号 → 账号与授权”,见同目录kefu-basic-role.jpg。
- `publish-kefu-web.ps1`将243文件发布至原项目dist和当前本机预览dist,逐文件核对SHA256,备份被覆盖文件,最后替换index.html,保留旧资源。
- index SHA256:747aab5f25c98ccd533117dec9802d1b70a5802a00acb2edf76e737962e0d8db。
- 集团5173、客服5666欢迎页、/api/health、/api/auth/group/config均200。当前公开代理/API仅监听回环,生产配置按GROUP_IDENTITY.md设置HTTPS及对应反向代理。
日志:identity-admin/.test-runtime/kefu-final-typecheck.log、kefu-final-build.log;发布记录kefu-final-build-result.json。此交付不修改真实账号角色或密码,不将隔离角色写入测试计作真实用户授权操作。
@@ -0,0 +1,37 @@
# 集团直接编辑客服授权交付(2026-11-03)
已接入当前本机集团和客服服务。集团管理员在“用户管理 → 客服授权 → 编辑客服授权”选择客服角色,或单独勾选该用户的权限,保存后直接提交客服数据库。客服原有管理员仍可正常分配角色,原本地账号及ZYT密码直登保持兼容。
## 使用与生效
- 集团入口:`http://127.0.0.1:5173/system/users`。仅显式集团管理员可编辑;未建立客服身份绑定的集团用户需先用ZYT账号登录客服。
- 普通角色分配沿用客服现有角色及权限;单用户调整保存成独立角色,不修改共享角色,不影响其他用户。空权限可撤销全部业务权限。首次登录的集团基础角色仍为空。
- 只有客服提交成功并返回经签名验证的结果,集团才显示保存成功。现有客服登录会话下一次请求立即按新权限校验,无需退出重登;已打开的页面刷新后更新菜单与按钮。
- 每次核对来源用户、稳定GID和应用归属,公司只用于应用分组及身份核对。不会按同名账号合并,不修改原项目或医院授权、密码、状态。
- 同时编辑产生版本冲突时保留草稿并要求重新读取;两端审计,客服保持至少一个启用的管理员。
## 验证
| 范围 | 结果 |
| --- | --- |
| 集团Web完整检查 | 80/80测试、vue-tsc、生产构建通过 |
| 中央新协议 | 513 checks通过;metadata172、structure600、role77、HTTP8通过,PHP lint通过 |
| 客服新接口 | 21/21测试通过,原只读metadata18/18通过 |
| 真实PHP + Python联合测试 | 角色分配、独立权限、清空撤权、同一既有token即时改变、409/422回滚、其他用户及源数据隔离通过 |
| 登录兼容 | Python原33项通过;真实密码直登100 checks及中央边界13 checks通过;旧一键登录联合测试通过 |
| 部署后检查 | 集团页面、集团API和客服API均HTTP200;匿名调用新接口均401;部署清单0待应用 |
| 真实授权保护 | 部署前后用户、角色、角色权限和GID绑定的只读聚合摘要完全一致 |
业务增改授权的测试均使用临时SQLite、合成身份和会话;实际页面核对使用现有集团登录态,只打开编辑表单和权限目录,未向真实账号加权限。
## 部署
客服应用5个文件并核对SHA256,先备份到`identity-admin/.test-runtime/kefu-source-before-20261103-165541`。新增`group_authorization.py`、专用回归测试,`admin_api.py`仅加入管理路由和初始化;更新旧metadata测试的复制列表及集成说明。启动时新增4张独立授权管理表用于持久化防重放、请求幂等、独立角色归属和审计,不改原授权集合。
复用既有独立服务密钥文件,不向浏览器发送密钥、机器接口地址、用户密码或会话。新增管理端点使用实际端点路径签名,不把原只读快照变成写入口。集团PHP8081已重载(PID22856),客服API及5666预览已重载(启动PID13756、预览PID9660),保留原账号库和登录会话。集团5173使用已有Vite服务,另已完成生产构建。
协议:`identity-admin/integration/kefu-group-authorization-contract.md`。细节及各层日志见同目录三份`kefu-authorization-{central,endpoint,ui}-20261103.md`报告;根联合验证日志位于`identity-admin/.test-runtime/kefu-authorization-joint.log`及`kefu-authorization-password-{backend,joint}.log`。
实际编辑页面截图:`artifacts/iam-extraction/group-kefu-authorization-edit-20261103.jpg`。
最后完成1280×720窗口布局修复,正文独立滚动,标题和保存栏保持可见;修复后客服编辑测试12/12、类型检查和生产构建通过,真实页面复核通过。已取消未保存的验收草稿并保留集团用户管理的客服授权弹窗供查看。
@@ -0,0 +1,30 @@
# 客服集团授权守卫修复(2026-11-03)
## 结果
已修复集团网页 `/sso/authorize` 将客服请求错误套用医院权限门禁的问题。已登录并完成账号验证的有效 ZYT 账号,只要服务端登记的客服应用 `ready=true`、`can_login=true`,即可进入客服授权页,不要求医院业务权限、医院登录资格、公司成员关系或当前选择客服公司。
没有给账号增加任何角色或权限;PHP 后端仍是最终授权依据。未修改 `C:/kefu`、集成镜像、真实账号或数据库,未读取 `.env`、凭据或会话内容,未启动或停止服务。
## 改动
- `C:/zyt/identity-admin/web/src/router/index.ts:243`:按唯一字符串 `client_id` 查找对应的已登记应用,仅允许 `kefu` 与 `internet-hospital`。客服检查自己的应用资格;医院继续要求医院应用资格与医院源权限。集团关闭、应用未登记/未就绪/不允许登录、未知或重复客户端均进入 403。已有登录、首次改密、企微绑定和普通业务页面门禁保留原顺序与行为。
- `C:/zyt/identity-admin/web/tests/function-first-navigation.test.mjs:371`:沿用现有实际 Vue Router + memory history 测试框架,新增三项回归。测试通过真实 `router.push()` 执行生产 `beforeEach`,没有另写一份守卫算法或直接调用授权 API 绕开导航。
- 按现有构建配置重新生成 `C:/zyt/identity-admin/web/dist`;未发布到外部服务。
回归覆盖无医院权限的客服登录、医院不可登录时客服独立放行、医院正常放行/无源权限拒绝、未知客户端即使被上下文登记也拒绝、重复/缺失客户端、应用未登记/未就绪/停用、集团关闭、未登录回登录页、改密与企微绑定优先,以及客服登录资格不开放普通管理页面。
## 验证
1. 修复前先运行新增导航回归,三项全部失败,分别复现客服被拒绝、未知客户端未被守卫拒绝,以及验证完成后客服仍被拒绝。
2. 修复后新增导航回归三项通过。
3. 网页 `package.json` 的完整测试命令通过:68 项通过,0 失败、0 跳过。测试仅使用合成内存状态。
4. 类型检查通过:`node node_modules/vue-tsc/bin/vue-tsc.js --noEmit`,退出码 0。
5. 生产构建通过:`node node_modules/vite/bin/vite.js build`,退出码 0,1723 个模块。仅出现现有主包超过 500 kB 的非阻断体积提示。
6. 进一步补强“未知客户端已登记”和缺失参数案例、使用各应用正确回调地址后,重新运行新增三项真实导航回归,全部通过。
当前 shell 未提供 `npm` 命令,因此直接执行了 `package.json` 中相同的 Node 测试、vue-tsc 和 Vite 脚本;没有安装或更改依赖。
## 范围限制
本次只修复集团网页守卫。客服本地端口 `/api` 代理、统一启动入口、桌面登录协议和客服角色管理由其他改动处理;本次没有修改这些链路,也没有使用真实账号进行端到端登录。
@@ -0,0 +1,36 @@
# 客服授权与动态权限目录在集团可见
2026-11-03完成。用户确认两项都需要:客服分配给集团账号的本地角色/有效权限,以及子系统动态新增权限目录,在集团管理平台可查看。
## 使用
- 集团显式管理员:用户管理→用户行“客服授权”,查看对应GID在客服的角色名/码、账号启停和当前有效权限。弹窗支持立即刷新,打开期间每30秒刷新。源医院角色编辑表单保持独立。
- 菜单管理→IM(客服所属公司)→“同步客服权限”,显示状态、时间、页面/权限数量及增改停用统计。加载客服公司菜单时后端自动尝试同步,60秒有界缓存;按钮强制读取最新目录。
- 按provider/GID关联并核对源编号和公司,不按同名账号猜测。未绑定、未配置、读取失败与空权限分别显示。本地独立客服账号不会被同名并入集团账号。
- 只读展示和目录同步不授予任何角色、不把客服授权并入集团/医院权限。客服仍维护业务授权。动态权限新增/改名/排序/停用/删除/恢复同步受管目录;删除软停用、保留旧引用,恢复使用稳定节点;独立集团改名/手动禁用被保留。
## 机制与安全
客服新增POST /api/v2/group/access-snapshot;只接受专用HMAC机器请求,原始响应亦绑定nonce签名,90秒时窗、nonce防重放、固定目标、禁代理/重定向、大小和结构限制。普通用户bearer不能代替机器身份。只读取请求GID的现有绑定与真实本地有效权限,不注册、seed、grant或改用户。
中央GET /group/application/access、POST /group/application/sync均经既有源身份认证并限定显式group owner。目标通过源admin.detail重查,使用已存在的主GID并严格核对源ID/公司。返回独立DTO,不修改permissions/native_permissions/role_id等真正鉴权字段。
机器密钥独立于登录,位于非公开runtime目录,64hex随机值;ACL只允许当前Windows用户和SYSTEM。密钥未输出、未返回UI、不放URL或仓库。配置只保存API地址和文件路径。多worker的nonce缓存目前每实例独立,协议仅提供读取,不承担登录、授权写入或全局撤销。
## 验证
- 中央5套隔离测试1179断言通过:metadata172、旧目录285、公司结构600、角色解析77、写穿45,包含鉴权、签名/时钟/篡改、源/GID/公司错配、三方合并、删除恢复、手动覆盖、TTL、审计回滚、授权与医院数据不变。
- 客服真实FastAPI/临时SQLite18项通过:签名/重放、身份隔离、动态目录、角色/停用实时,读取前后users/roles/role_permissions/auth_tokens/permissions/bindings全表不变。
- 集团UI完整75项、vue-tsc和Vite构建通过。新7项实际Vue SFC测试含root行查询、只读、立即/定时刷新、竞态与错误状态、精确公司同步。
- 新跨项目真实PHP→Python HTTP联合通过:基础身份、管理员换viewer后集团即时读到、动态权限新增/改名/删除的集团目录变化、停用后权限空、非owner403;读取和同步不改客服授权表。测试仅合成账号、独立密钥、临时SQLite和随机回环端口。
- 原同框密码登录及旧SSO33项再回归通过,新增模块没有影响身份登录。
## 真实本机验收
集团API与客服健康200;匿名元数据请求401。独立机器签名已启用。实际目录首次运行created=0/updated=82/kept=9/disabled=3/pages=18/permissions=65/roles_changed=0;随后浏览器再次同步created=0/updated=0/kept=91/disabled=0,目录与角色引用保持稳定。
真实集团用户页过滤admin并打开“客服授权”,显示对应集团绑定账号当前为集团基础用户、启用、有效权限0。此为真实客服当前状态,未为验收修改该角色;角色变更传播使用隔离联合测试验证。截图group-kefu-access-20261103.jpg。真实IM菜单页显示已同步18页面/65权限与“角色授权未变更”,截图group-kefu-catalog-20261103.jpg。
客服清单28文件、本轮5项应用,最终待应用0。源码备份identity-admin/.test-runtime/kefu-source-before-20261103-162610。集团API PID9572,客服API父PID23832,预览PID14064;保留原会话目录与已有账号库,没有重置真实密码或人工调整用户角色。
启动配置由scripts/enable-kefu-metadata-local.ps1建立;既有集团/客服启动脚本自动读取本机非秘密配置。目录CLI为server/scripts/sync-kefu-metadata.php,必须指定已登记owner。未来其他子系统需要各自登记对应机器端点/凭据,本次范围为当前客服系统。
@@ -0,0 +1,34 @@
# 集团客服权限可见性 UI — 2026-11-03
实现范围仅为 `identity-admin/web` 和本报告;按 `identity-admin/integration/kefu-group-access-contract.md` 固定协议接入。未读取 .env、真实数据库或密钥,未修改真实账号、角色及授权。仓库 `.trellis/workflow.md` 不存在,已遵循根 AGENTS.md 的可用约束。
## 结果
- `Users.vue` 为 `group.enabled && group.isGroupAdmin` 显示独立“客服授权”按钮;受保护 root 行仍可只读查询,原医院编辑表单和 root 保护保留。
- 弹窗通过现有 `services/http` 的 Group Bearer 请求 `GET /group/application/access`,参数仅为 `client_id: kefu` 和选中行 `source_admin_id`。展示客服角色名/码、启停、有效权限名称/分组/权限码、快照时间、最近查询时间。
- 提供立即刷新,并仅在弹窗打开时每 30 秒刷新;关闭、卸载、owner 权限撤回停止定时器。请求序列与目标 ID 核验避免切用户、并发刷新、关闭后的旧响应回填。
- 未绑定明确提示尚未以集团身份登录客服,不按同名账号匹配;未配置与网络读取失败单独呈现。失败时清除旧快照,不显示伪造的零权限。
- `Menus.vue` 仅在当前公司精确等于已注册 kefu application.company_id 且为集团 owner 时显示“同步客服权限”。调用 `POST /group/application/sync`,载荷严格为 `{client_id: 'kefu'}`。
- 同步结果显示时间、页面/权限总数及新增/更新/保留/停用数量;成功刷新普通菜单列表。未配置、同步失败和同步成功后列表读取失败分别明确呈现,不阻断现有菜单操作。
- 目录随菜单列表由后端尝试自动同步;页面不额外在挂载时发起显式 POST。页面初始提示可立即同步以查询状态和数量,避免宣称未确认的同步成功。
- 同步请求去重,并按公司 revision 丢弃切公司再切回的旧结果;不调用角色授权端点。
- DTO 位于独立 `src/types/applicationAccess.ts`,没有并入 `CurrentUser.permissions`、`native_permissions` 或医院授权集合。没有新增合同外 DTO 字段。
## 变更文件
- `identity-admin/web/src/views/Users.vue`
- `identity-admin/web/src/views/Menus.vue`
- `identity-admin/web/src/types/applicationAccess.ts`
- `identity-admin/web/tests/kefu-visibility.test.mjs`
- `identity-admin/web/package.json`(完整测试命令包含新测试)
## 验证
环境 PATH 未提供 npm;使用 node 直接执行 package.json 中相同测试、typecheck 与 Vite 入口,没有安装或升级依赖。
- 完整 web 测试 75/75 通过,含新增 7 项真实 SFC 脚本与编译模板行为测试。
- 新增测试覆盖实际模板按钮回调、root 行可读、只读弹窗及原授权不变、有效权限元数据、未知状态、未配置、停用、网络故障、30 秒刷新与清理、切用户/并发/关闭/撤权竞态、同步可见性、计数/时间呈现、失败不阻断菜单、切公司竞态和同步去重。
- `node node_modules/vue-tsc/bin/vue-tsc.js --noEmit`:通过。
- `node node_modules/vite/bin/vite.js build`:通过(1,723 个模块,22.58 秒)。仅有主 bundle 超过 500 kB 的体积提示。
旧有测试直接在组件 setup 之外执行 Users 脚本,因此 Vue 会打印 onBeforeUnmount 无活动组件实例的测试替身警告;全部断言通过。新增测试隔离捕获并验证了该卸载清理回调。未连接真实客服服务;网络和时间测试使用隔离 fixture。
@@ -0,0 +1,4 @@
ZYT_GROUP_BASE_URL=https://x.zhenyangtang.com.cn
ZYT_GROUP_API_URL=https://x.zhenyangtang.com.cn/adminapi
KEFU_PUBLIC_BASE_URL=http://im.zhenyangtang.cn:8369
ZYT_GROUP_ALLOWED_HTTP_ORIGINS=http://im.zhenyangtang.cn:8369
@@ -0,0 +1,60 @@
# KF HTTP callback compatibility
Staged KF changes allow the explicitly registered `http://im.zhenyangtang.cn:8369` callback while Group entry and API remain HTTPS, with loopback development unchanged. All 37 isolated backend tests and 14 frontend tests passed. No files under `C:/kefu` were changed by this staging task.
Payload: `C:/zyt/identity-admin/.test-runtime/kefu-http-port-20261104/payload`.
Manifest: `C:/zyt/identity-admin/.test-runtime/kefu-http-port-20261104/manifest.json`.
The manifest records original and staged SHA-256 hashes and rechecks the original sources. Apply only its six payload files after reviewing those hashes.
| Original source | Change |
| --- | --- |
| `C:/kefu/wechat_rpa/group_sso.py` | Parse exact HTTP origins by hostname and effective port; apply approval only to the KF public callback; return derived `http_callback_allowed`. |
| `C:/kefu/wechat_rpa/test_group_sso.py` | Test explicit registration, wrong host/port, default port equivalence, URL patterns, credentials, HTTPS Group transport, and unchanged local credentials/default role. |
| `C:/kefu/admin-web/apps/web-antd/src/utils/group-sso.ts` | Require the approved flag for a public HTTP callback, preserve the full callback URI in the PKCE transaction, reject a callback from another origin/path, and use existing hash-wasm when Web Crypto digest is unavailable. |
| `C:/kefu/admin-web/apps/web-antd/tests/group-sso.test.mjs` | Test HTTP without `crypto.subtle` against the RFC 7636 S256 vector using real hash-wasm 4.12.0; test random state/verifier, exact port and URL rejection, and existing authentication behavior. |
| `C:/kefu/deploy/im-admin/compose.yaml` | Forward the new public HTTP registration variable to KF services. |
| `C:/kefu/GROUP_IDENTITY.md` | Document explicit registration on both sides and the fixed callback. |
Required public configuration on KF:
```dotenv
ZYT_GROUP_BASE_URL=https://x.zhenyangtang.com.cn
ZYT_GROUP_API_URL=https://x.zhenyangtang.com.cn/adminapi
KEFU_PUBLIC_BASE_URL=http://im.zhenyangtang.cn:8369
ZYT_GROUP_ALLOWED_HTTP_ORIGINS=http://im.zhenyangtang.cn:8369
```
Corresponding Group configuration uses `IAM_KEFU_BASE_URL=http://im.zhenyangtang.cn:8369` and `IAM_KEFU_ALLOWED_HTTP_ORIGINS=http://im.zhenyangtang.cn:8369`. The callback remains `http://im.zhenyangtang.cn:8369/auth/group-login`. No wildcard, route path, credentials, query, or fragment is accepted in an origin registration.
Backend verification:
```powershell
$env:PYTHONDONTWRITEBYTECODE = '1'
$env:PYTHONUTF8 = '1'
& C:\kefu\wechat_rpa\.venv\Scripts\python.exe -u C:\zyt\identity-admin\.test-runtime\kefu-http-port-20261104\run-backend.py
```
Result: 37 tests passed, including all staged SSO checks and the existing direct-password test class. The runner copies only Python sources into an isolated directory, loads the direct-password class without its original bootstrap, clears deployment variables, and uses synthetic temporary databases and local fixture servers. The sandbox initially denied loopback sockets with `WinError 10013`; the same tests passed with local-only elevated execution. `backend-test.log` retains the successful run, including a diagnostic thread snapshot at 45 seconds; its final result is `OK`.
Frontend verification:
```powershell
$env:KEFU_SSO_TYPESCRIPT = 'C:\zyt\identity-admin\web\node_modules\typescript'
$env:KEFU_SSO_HASH_WASM = 'C:\zyt\identity-admin\.test-runtime\kefu-hash-dependency\node_modules\hash-wasm'
node --test C:\zyt\identity-admin\.test-runtime\kefu-http-port-20261104\verification\frontend\tests\group-sso.test.mjs
```
Result: 14 tests passed. `frontend-test.log` contains the full output. Source `package.json` already declares hash-wasm 4.12.0, so no package or lockfile change is needed. Full KF build is left to the parent task after applying the staged files to its existing isolated frontend snapshot.
No real runtime environment file, credential, token, session, or database was read. No production connection or deployment was attempted. Generated verification source copies, fixture directories, logs, and the runner remain under the staging directory.
## Isolated frontend build
The complete KF frontend typecheck and production build passed after applying the six staged files. The build used the existing `C:/zyt/identity-admin/.test-runtime/kefu-admin-web` snapshot and copied its 24 public mirror source files from `identity-admin/integration/kefu/admin-web`. The snapshot root and `apps/web-antd` contained no `.env` files. No dependencies were installed, and root/app package files, the lockfile, theme source, and hash-wasm 4.12.0 package/runtime fingerprints remained unchanged.
Command: `C:/zyt/identity-admin/.test-runtime/kefu-http-port-20261104/build-isolated.ps1`. It runs the existing vue-tsc and Vite CLIs directly through Node, with `VITE_GLOB_API_URL=/api/v2`, `VITE_APP_TITLE=企微客服`, history routing, namespace `kefu`, and base `/`. Typecheck and Vite returned exit 0; Vite completed in 62 seconds. The standard `scripts/verify-token-build.mjs` artifact check also passed and reached 237 assets.
The existing Vite public-configuration plugin collects only `.env` file values, so it initially generated an empty public configuration despite the explicit process environment. `write-public-build-config.mjs` supplies the approved `/api/v2` value directly in the generated runtime configuration; no source or dependency is changed. It preserves the existing `_VBEN_ADMIN_PRO_APP_CONF_` global, adds a content hash to the configuration filename, and updates its HTML reference to prevent cached empty configuration from being reused. A Node VM check verifies that setting, its frozen global property, and the compiled `企微客服` page title. This step is included in the build script for the next isolated build.
Output: `C:/zyt/identity-admin/.test-runtime/kefu-admin-web/apps/web-antd/dist-http-port`. Existing `dist` and `dist-final` directories were preserved. Result and source/dependency fingerprints: `C:/zyt/identity-admin/.test-runtime/kefu-http-port-20261104/build-result.json`. Final output file hashes after the public configuration correction: `C:/zyt/identity-admin/.test-runtime/kefu-http-port-20261104/build-output-manifest.json`. Logs in the same directory: `typecheck-http-port.log`, `build-http-port.log`, `public-build-config.log`, and `verify-token-build-http-port.log`. This build was not deployed and did not modify `C:/kefu`.
@@ -0,0 +1 @@
5b52b2a4f37ee55be5a8721680162a785f911ab020c82b291e48d80e0e850aff kefu-http-port-update-20261104.zip
@@ -0,0 +1,36 @@
# 客服入口与集团会话核对(2026-11-03)
## 结论
当前集团 web 源码不符合“sessionStorage 每标签页会话 + window.open noopener 导致新标签页无登录态”的假设。按任务要求,本次只报告证据,没有改动 token 存储、跳转、权限或业务代码。
- `C:/zyt/identity-admin/web/src/services/token.ts:5,12-13` 当前使用 `localStorage` 读取、写入、删除 `identity_admin_session_v1`,并保留进程内存回退。源码没有访问 `sessionStorage`。不应在本次条件排查中擅自把现有存储策略改为另一种模型。
- `C:/zyt/identity-admin/web/src/views/Dashboard.vue:26-31`:`launch()` 校验 `applicationEntry()` 后执行 `window.location.assign(target)`,客服与医院都已是当前标签页跳转。
- `C:/zyt/identity-admin/web/src/views/Custom.vue:17-22`:`launchKefu()` 也执行 `window.location.assign(target)`。
- `web/src` 全文检索没有 `window.open`。这两处入口不会自行产生新标签页。
- 当前生产入口 `C:/zyt/identity-admin/web/dist/index.html` 引用 `/assets/index-B1xq-__E.js`,主包包含相同的 `localStorage` token 实现;Dashboard/Custom 构建 chunk 包含 `location.assign`。这不是只存在于未构建源码中的行为。
## 实际动作验证
使用隔离 Node 进程读取真实 Vue SFC 的 script setup,TypeScript 转译后执行真实 `launch()` / `launchKefu()`;Vue 响应式能力与 `applicationEntry()` 使用真实实现,浏览器、store 和 UI 仅使用合成替身。没有读取真实浏览器存储或账号数据,没有发起网络请求。
验证结果全部通过:
1. Dashboard 客服入口调用 `location.assign()`,不调用 `window.open()`。
2. Dashboard 医院入口同样保持现有 `location.assign()` 行为。
3. Custom 客服菜单入口调用 `location.assign()`,不调用 `window.open()`。
4. 客服应用 `can_login=false` 时不跳转,显示错误。
5. 读取真实 `token.ts`,以两个独立模块实例模拟两个执行上下文,共用完全合成的 localStorage;第二个实例能读取第一个实例写入的合成会话。sessionStorage 替身设计为任何访问都会抛错,整个验证未触发访问。
退出码为 0。没有新增持久化测试文件或修改应用代码,因此未重复构建或改变当前 dist。前一项守卫修复的完整网页 68 项测试、类型检查和生产构建已通过,本次没有改动那些已验证文件。
## 对实际浏览器现象的含义
“返回集团 5173 后需要重新输入账号”仍是需要继续定位的运行时现象,但不能归因为当前源码中的 sessionStorage/noopener。可以只检查公开地址和浏览器动作,不接触 token 值:
- 已登录工作台与回跳页是否精确使用相同 scheme、hostname、port(例如 `localhost` 与 `127.0.0.1` 是不同 origin)。
- 新标签页是否由手动操作、浏览器动作、其他页面或不同的已部署版本打开;当前两个函数不会新建标签页。
- 实际运行的 5173 服务是否使用本目录与当前构建;本报告只核对文件,未检查或操作服务。
- 浏览器是否阻止 localStorage,导致原标签页仅保留内存会话;或者源/集团会话已经过期并被现有 401 逻辑清除。以上只是候选原因,本次没有证据确认任何一项。
本次未修改 `C:/kefu`、服务、真实账号、角色、cookie 或安全门禁,未读取 `.env`、真实令牌或真实浏览器存储。
Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

@@ -0,0 +1,33 @@
[
{
"step": "grant_menu_auto",
"clickAt": "2026-11-04T01:54:39.947Z",
"commitObservedAt": "2026-11-04T01:54:40.617Z",
"menuObservedAt": "2026-11-04T01:54:43.145Z",
"observationDelayMs": 2528
},
{
"step": "native_empty_role_created",
"at": "2026-11-04T01:55:29.049Z",
"role": "iam_refresh_probe_20261104",
"permissions": 0
},
{
"step": "native_probe_role_deleted",
"at": "2026-11-04T01:55:46.645Z"
},
{
"step": "revoke_write_buttons_auto",
"clickAt": "2026-11-04T01:56:35.728Z",
"commitObservedAt": "2026-11-04T01:56:36.314Z",
"buttonsGoneAt": "2026-11-04T01:56:37.214Z",
"observationDelayMs": 900
},
{
"step": "revoke_all_menu_and_page_auto",
"clickAt": "2026-11-04T01:57:52.542Z",
"commitObservedAt": "2026-11-04T01:57:53.227Z",
"observedAt": "2026-11-04T01:57:55.208Z",
"observationDelayMs": 1981
}
]
@@ -0,0 +1,22 @@
{
"passed": true,
"account": "cs",
"restored_role": "zyt_basic",
"permissions": [],
"active": true,
"same_session_metadata": true,
"probe_absent": true,
"other_users_unchanged": true,
"native_role_audit": [
{
"action": "role.save",
"detail": "iam_refresh_probe_20261104 → 0 项权限",
"created_at": "2026-11-04T09:55:28+08:00"
},
{
"action": "role.delete",
"detail": "iam_refresh_probe_20261104",
"created_at": "2026-11-04T09:55:46+08:00"
}
]
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

@@ -0,0 +1,94 @@
# 客服已登录会话授权刷新审计(2026-11-04)
## 结论与本次边界
当前代码支持**同一既有客服登录会话在下一次 API 请求立即按新授权通过或返回 403,无需退出重登**;但**不支持已打开页面自动更新菜单、按钮和动态路由**。在集团保存授权后,客服浏览器不重新加载,即使继续切换应用内页面,也不会再次请求 `/me` 或重建菜单。整页刷新能够更新前端权限,不能把它描述为无需刷新即可实时更新。
本审计只阅读 `C:/zyt/AGENTS.md`、客服产品源码、暂存镜像、测试源码和既有构建记录。`.trellis` 不存在。没有访问浏览器、实际账号/数据库/服务、`.env`、密钥、凭据或实际 token;没有运行会写入测试目录的测试和构建。唯一写入是本报告。真实浏览器测试由根任务执行,本报告不代表已经完成真实账号验收。
## 当前部署源码与镜像一致性
只读 SHA256 核对:以下四组实际源文件与 `C:/zyt/identity-admin/integration/kefu/` 镜像逐字节相同。
| 实际源文件(相对 `C:/kefu/`) | SHA256 |
| --- | --- |
| `admin-web/apps/web-antd/src/store/auth.ts` | `5B9E756C703E04B472F18A9528B9538B3F1D0B4772F74D1B381433977F4477BB` |
| `admin-web/apps/web-antd/src/views/console/roles.vue` | `5522D04E4432E6BB7F9A7F332F14BACF7150E6408D52C386C517B729256EAE08` |
| `wechat_rpa/admin_api.py` | `DE3A5DC7366EA9E569711ED92D35B6C29E3F7633E00157B41BFC5D174C87173B` |
| `wechat_rpa/group_authorization.py` | `B34A890ED84F8CAB47816552D8EFB487C1770447EE56503DECF2A3538CEFB77D` |
这核对的是磁盘源码,不等同于验证某个当前浏览器已加载的 JS 或某个内存进程版本。根任务的真实页面测试仍应记录浏览器 URL、是否整页刷新、授权保存时间与观察时间。
## 后端为什么能够同会话即时生效
1. [admin_api.py:410](C:/kefu/wechat_rpa/admin_api.py:410) 的 `current()` 每次从 Authorization 取 API 会话,调用 `database.session(token)`,并在第 420 行重新调用 `database.permissions_for_user(user_id)`;权限没有固定在 token 里。
2. [admin_backend.py:1055](C:/kefu/wechat_rpa/admin_backend.py:1055) 的 `session()` 每次关联当前 `users`,要求 token 未过期且用户启用。它会更新会话的 `last_used_at`,因此真实接口验证并非零数据库写入,但不改变登录凭据或授权。
3. [admin_backend.py:2158](C:/kefu/wechat_rpa/admin_backend.py:2158) 每次读取当前 `users.role/active`,再由 [rbac.py:292](C:/kefu/wechat_rpa/rbac.py:292) 读取该角色当前权限集合。
4. [admin_api.py:437](C:/kefu/wechat_rpa/admin_api.py:437)、第 452、466 行的 `require/require_any/need` 按本次 Principal 权限判定,缺权返回 403。401 是会话失效,与普通撤权不同。
5. [admin_api.py:798](C:/kefu/wechat_rpa/admin_api.py:798) 的 `/api/v2/me` 返回本次 Principal。集团写入在 [group_authorization.py:245](C:/kefu/wechat_rpa/group_authorization.py:245) 的同一事务中校验身份和版本、改角色、写审计并提交(第 288、313 行);没有删除现有会话的逻辑。
现有隔离测试 [test_group_authorization.py:160](C:/zyt/identity-admin/integration/kefu/wechat_rpa/test_group_authorization.py:160) 已用同一合成 token 证明 grant 后 200、revoke 后 403、`/me` 权限改变,且其他用户、共享角色和 token 身份/摘要/有效期保持。该测试不覆盖浏览器菜单自动刷新。
## 前端自动更新缺口的确切位置
| 证据 | 结果 |
| --- | --- |
| [store/auth.ts:99](C:/kefu/admin-web/apps/web-antd/src/store/auth.ts:99) | `fetchUserInfo()` 会同时写 `userStore.userInfo` 与 `accessStore.accessCodes`,因此函数被调用时按钮权限可同步。 |
| [router/guard.ts:90](C:/kefu/admin-web/apps/web-antd/src/router/guard.ts:90) | `isAccessChecked` 为真即返回,应用内后续导航不重新取权。 |
| [router/guard.ts:101](C:/kefu/admin-web/apps/web-antd/src/router/guard.ts:101) | 初次导航才取用户信息;第 104–115 行生成并保存菜单/路由。 |
| [api/request.ts:103](C:/kefu/admin-web/apps/web-antd/src/api/request.ts:103) | 拦截器处理数据、401 和错误消息;没有权限变更通知、403 后取权、响应版本检查。 |
| [bootstrap.ts:1](C:/kefu/admin-web/apps/web-antd/src/bootstrap.ts:1) 与整个应用 `src` 扫描 | 没有用 `visibilitychange`、focus、定时器、EventSource、WebSocket、BroadcastChannel 触发权限同步;`fetchUserInfo` 只有登录与上述初次路由守卫调用点。 |
| [packages/stores/src/modules/access.ts:76](C:/kefu/admin-web/packages/stores/src/modules/access.ts:76) | 权限码、菜单、路由是三份独立状态;只更新权限码不会自动重建菜单。权限码还被持久化。 |
| [roles.vue:18](C:/kefu/admin-web/apps/web-antd/src/views/console/roles.vue:18) | `canCreate/canWrite/canDelete` 是 computed;[use-access.ts:29](C:/kefu/admin-web/packages/effects/access/src/use-access.ts:29) 读取响应式 `accessCodes`。对该页面只要重新取权,按钮能自动重算。 |
| [roles.vue:103](C:/kefu/admin-web/apps/web-antd/src/views/console/roles.vue:103)、第 131 行 | 产品当前明确提示“其他在线用户请刷新页面以更新菜单和按钮”。 |
扫描客服业务 `src/views` 未发现 `v-access` 指令使用;当前测试目标角色页使用 computed + `v-if`。共享 [directive.ts:34](C:/kefu/admin-web/packages/effects/access/src/directive.ts:34) 只有 mounted 且无权时直接移除 DOM,未来若有页面采用该指令,单纯替换权限码不能恢复已经删除的节点,应另行响应式处理或重挂载相关视图。
## 如果要求无需整页刷新,建议的最小补齐
仅新增前端当前授权同步,不需要更换 token 或修改后端授权语义:
1. 在登录初始化完成后启动一个全局、单例、合并并发的同步器。窗口聚焦、页面重新可见时立即请求 `/me`;页面可见且有 token 时每 3–5 秒请求一次。没有服务端推送时这是有明确延迟上限的自动同步,应如实记录轮询间隔,不能称为零延迟推送。
2. 每次请求捕获当前 token/身份;响应落地前再次比对,防止退出/切换账号期间旧请求覆盖新账号权限。注销或 token 消失时清理计时器和监听,避免重复安装。网络失败保留已知权限并遵守既有 401 流程。
3. `/me` 更新用户信息和权限码;只有权限集合变化时才重建可访问菜单和路由。必须真正移除撤销的动态路由,清理已失权标签页/缓存;当前页失权时跳到 `/group/welcome` 或合法首菜单,不注销登录。保留当前仍有权页面及其编辑草稿。
4. **不能只反复调用 `generateAccess()`。** [accessible.ts:35](C:/kefu/admin-web/packages/effects/access/src/accessible.ts:35) 从当前 Root.children 取已有路由,只更新/追加本轮生成的路由;本轮因撤权而完全缺席的旧顶层分支没有清除步骤。应先按现有静态核心配置重置动态树(核实 Root.children 也清空),再生成一次,并在实际 Vue Router 上断言旧路径不再匹配。仅 `setIsAccessChecked(false)` 也不会让已显示页面自行触发导航。
5. 可在受保护请求返回 403 时触发一次合并同步,以快速收敛 UI;不要自动重试写操作。可以将前端状态与路由更新做成共享函数,供首次守卫和同步器复用,避免两条实现漂移。
6. 更新角色页现有“刷新页面”说明和对应测试断言,使其描述实际行为。
若验收口径只是“不退出重登,可以按 F5”,当前实现已有这条路径;根任务应分别报告接口即时性、整页刷新后的菜单结果、完全不刷新的结果,避免混在一个“即时生效”结论里。
## 低影响真实浏览器验证路径
优先使用本次专用测试账号;在集团只修改该账号的客服个人授权,保留其基线角色、精确权限集合及启用状态。不要分配 admin、operator、viewer 等带业务读取的宽角色。原生页面为 `/system/roles`;导航权限见 [console.ts:211](C:/kefu/admin-web/apps/web-antd/src/router/routes/modules/console.ts:211)。
建议分两段隔离“菜单读取”与“操作按钮”:
1. 测试账号登录客服并保持该浏览器会话。先记录空业务授权(或既定基线)下只有账号页、无角色菜单。
2. 集团为该账号设置精确集合 `['role:read']`。观察不刷新时菜单是否出现;若当前代码不出现,则这是预期缺口。保留结果后,整页刷新但不退出,验证系统管理 → 角色权限出现,列表可读,新建按钮不存在。
3. 保持角色页已打开。集团改为 `['role:read','role:create']`。观察新建按钮是否自动出现;当前代码不会。若补齐同步,再验证自动出现且未重登;否则可刷新记录“不退出但需刷新”的准确结果。
4. 点“新增角色”,创建唯一临时角色,例如 `iam_refresh_probe_20261104_<短随机串>`,名称明确标注临时验证,权限一项不勾选。不得给任何用户分配它。这是原生非敏感操作,写入仅有空角色和原生审计,不涉及聊天、患者、模型密钥、发布配置或外呼。
5. 集团只撤销 `role:create`、保留 `role:read`。在同一角色页观察按钮变化。若要证明后端撤权,先在有权时打开**第二个不同唯一编码**的新建草稿,再撤权并尝试提交;当前组件可能因刷新后的 readonly 直接关闭而不发请求,这只能证明 UI 限制。要得到 API 403 必须确实存在同一已登录页面发出的 POST 请求,记录状态码且确认第二个角色不存在。不要为制造请求读取或导出实际 token。
6. 最后撤销 `role:read`,观察菜单移除、当前页面退出或失权处理,再确认同一会话仍可进入账号页;若只做当前版本验收,应记录整页刷新后菜单才消失。
端点依据:
- [admin_api.py:863](C:/kefu/wechat_rpa/admin_api.py:863):GET `/api/v2/roles` 需要 `role:read` 或 `user:read`。
- [admin_api.py:818](C:/kefu/wechat_rpa/admin_api.py:818):角色页并发 GET `/permissions` 允许 `role:read`,不必另授权限菜单或用户权限。
- [roles.vue:59](C:/kefu/admin-web/apps/web-antd/src/views/console/roles.vue:59):角色页初次加载上述两接口;第 136 行用 `v-if=canCreate` 显示新增角色。
- [admin_api.py:870](C:/kefu/wechat_rpa/admin_api.py:870):POST `/roles` 对新编码要求 `role:create`,对已存在编码要求 `role:write`。务必使用唯一编码避免意外修改现有角色。
- [admin_backend.py:2170](C:/kefu/wechat_rpa/admin_backend.py:2170):空权限角色可创建;会写原生 `role.save` 审计。
清理:用管理员的正常角色页面删除仅本次创建的、`user_count=0` 的临时角色(需要 `role:delete`;[admin_api.py:886](C:/kefu/wechat_rpa/admin_api.py:886)、[admin_backend.py:2200](C:/kefu/wechat_rpa/admin_backend.py:2200));在集团把测试账号恢复到记录的基线角色/权限。不要直接删库或清审计。集团个人授权会创建/复用其专属托管角色([group_authorization.py:222](C:/kefu/wechat_rpa/group_authorization.py:222)),授权切换可能留下未使用托管角色,这是现有持久化行为,应在验收中披露;如需删除,只能由管理员核对精确角色与零使用人数后通过原生 UI 处理。
## 可复用验证与构建资产
没有在本次只读审计中运行以下命令。它们是后续修改后的建议入口:
- 前端现成回归位于 `C:/zyt/identity-admin/integration/kefu/admin-web/apps/web-antd/tests/`:`group-sso.test.mjs`、`group-navigation.test.mjs`、`local-role-page.test.mjs`;分别覆盖账号权限隔离、实际路由过滤、实际角色 SFC 和 computed 按钮。现有用例不验证轮询、焦点恢复、并发换账号、撤权移除路由。
- 已验证的测试依赖路由见 `C:/zyt/artifacts/iam-extraction/kefu-local-role-fix-20261103.md:38`:`KEFU_SSO_TYPESCRIPT=C:/zyt/identity-admin/web/node_modules/typescript`,`KEFU_SSO_WORKSPACE=C:/kefu/admin-web`,随后 `node --test <上述测试文件>`。修改后的完整源码构建副本比只读实际源更适合作为 WORKSPACE。
- 后端:`C:/zyt/identity-admin/integration/kefu/wechat_rpa/test_group_authorization.py`,源码开头明确只复制 `.py`,清空继承环境,使用合成 key 和临时 SQLite;当前第 160 行的同 token 测试可原样保留。联合测试入口为 `C:/zyt/identity-admin/tests/kefu-authorization-joint.test.mjs`,覆盖集团 PHP → KF Python 真实临时 HTTP 服务。
- 完整健康构建副本:`C:/zyt/identity-admin/.test-runtime/kefu-admin-web`,已有冻结依赖。`apps/web-antd/package.json:18` 提供 typecheck/build;可使用 `pnpm.cmd --filter @vben/web-antd run typecheck` 与 `pnpm.cmd --filter @vben/web-antd exec vite build --mode production --outDir dist-final`。
- 可复用脚本:`C:/zyt/identity-admin/.test-runtime/run-kefu-password-build.ps1`;较早的 `build-kefu-snapshot.ps1` 含禁止 `.env` 进入构建副本的检查,但不要无审阅直接覆盖后续版本配置。2026-11-03 的正确 API base 是 `/api/v2`,见 `C:/zyt/artifacts/iam-extraction/kefu-password-form-20261103.md:44`。
- 既有构建记录 `C:/zyt/identity-admin/.test-runtime/kefu-final-build-result.json` 记录 247 个文件、typecheck/build exit 0,部署目标 `C:/kefu/admin-web/apps/web-antd/dist`,index SHA256 `1cee2372617048a49c4b19e18a54d6f086d300bd74202cbf0a710b10762e3fe7`。这是旧结果,不作为新修复测试结果。
若补齐同步,最小有价值新增回归应使用真实 Vue Router 和响应式 store,覆盖同一 token 的 grant/revoke 菜单与 computed 按钮、已完全消失顶层路由被移除、当前页失权安全退回、未变化权限不重复重建、并发同步合并、退出/换账号后旧响应丢弃,以及 403 同步不重放写操作。然后做一次完整类型检查/构建及根任务负责的真实浏览器闭环。
@@ -0,0 +1,83 @@
# 客服已登录授权自动同步实现(2026-11-04)
## 已实现行为
客服前端在保持同一登录会话时,每 3 秒前台读取一次当前 `/me`,切回窗口或页面重新可见时立即读取。隐藏页面不发送轮询请求。角色和权限变化会自动更新用户名/角色信息、权限码、菜单、动态路由和响应式操作按钮,不需要退出重登或为授权变化整页刷新。
这是有最多约一个轮询周期及请求耗时的自动同步,不是零延迟服务端推送。后端仍在每次业务请求按当前权限鉴权,前端没有重试任何写操作。
本轮仅修改 `C:/zyt/identity-admin/integration/kefu/admin-web` 及本报告。没有修改 `C:/kefu`、manifest、构建副本、真实配置、数据库、账号或服务;没有访问浏览器、凭据、实际 token、`.env` 或密钥。根任务完成完整构建、部署与真实已登录账号验收。
## 文件与实现
以下路径相对于 `C:/zyt/identity-admin/integration/kefu/admin-web/`:
| 文件 | 变化 |
| --- | --- |
| `apps/web-antd/src/utils/authorization-sync.ts` | 新增可测试的单例轮询控制器:前台 3000ms、focus/visibility、同一请求合并、启动/停止清理、token + userId + generation 三重迟到响应隔离;标准化权限集合忽略顺序与重复。只在成功提交后确认新权限快照,临时菜单准备失败后可再次尝试。 |
| `apps/web-antd/src/router/authorization-sync.ts` | 新增应用接线。观察 token、身份、初次访问准备状态;先在独立 memory router 上使用真实 `generateAccess` 准备菜单和路由,确认会话仍有效后同步提交。按 name/path 增删实际 matcher,移除已消失的完整分支,保留仍有权路由及其组件实例。撤权当前页退回 `/group/welcome`,保留登录态。清理失权标签(包括 affix)、cachedRoutes、cachedTabs、排除集合和访问历史。 |
| `apps/web-antd/src/bootstrap.ts` | 从实际公开源码复制后仅增加同步器 import 与 `app.onUnmount(installAuthorizationSync(router))`。Pinia/Router 安装后启动,应用卸载时清理;重复安装先释放旧实例。 |
| `apps/web-antd/src/api/request.ts` | 从实际公开源码复制后为现有认证响应拦截器加请求原 token 检查。旧账号迟到 401 不得清掉新账号登录;当前账号 401 继续原登录过期处理。403 直接失败,不续期、不重放业务请求。 |
| `apps/web-antd/src/views/console/roles.vue` | 将旧“其他在线用户请刷新页面”的中文说明与保存提示改为数秒自动同步、切回窗口立即同步;角色读写规则不变。 |
| `apps/web-antd/tests/authorization-sync.test.mjs` | 新增 7 项隔离回归,使用真实 Vue、Vue Router、Pinia、公开 access/user/tabbar store 源码、Vben 过滤/路由/菜单算法、实际 console 路由和实际请求认证拦截器。API 响应和浏览器计时/可见性使用受控替身,不访问网络或实际数据。 |
| `apps/web-antd/tests/local-role-page.test.mjs` | 更新现有角色组件测试的提示文案断言。 |
没有调用 `resetAllStores`、修改 token、主动登出或替换仍有权的当前路由。已打开且仍有权的页面、其组件引用和缓存草稿保持;撤权页面及其缓存则移除。
## 验证
已执行整个暂存客服前端测试目录,**29/29 通过**,其中新增自动同步 7 项。包括原密码直登、ZYT/本地共用表单、SSO 清理旧权限、失败重试、实际角色组件和导航回归。
新增用例覆盖:
- 同一 token 从无权限 → 角色读取 → 角色新增 → 撤新增 → 撤读取,菜单、真实 matcher 与 computed 按钮同步;完整系统分支消失后旧路径只匹配 404,当前失权页回账号页,token 保留。
- 授权/撤权同级页面时,仍有权当前页 `currentRoute`、matcher 的组件引用、已缓存草稿与 affix 标签保留;撤权 affix 标签、组件缓存、缓存名和历史移除。
- 权限集合不变或仅顺序/重复变化,不重建菜单,资料仍更新。
- 隐藏时不发请求、恢复可见和聚焦立即同步;轮询默认 3000ms;销毁后定时器和事件不再发请求。
- 并发轮询/聚焦事件只发一个请求;注销清理;旧账号请求或异步菜单准备迟到时不能写入新账号;身份不符的返回不采用;准备失败后可恢复。
- 重复安装保持单例,旧 disposer 不会停止新安装。
- 实际请求认证拦截器对旧 401 不清新 token;当前 401 保留原登录过期行为;403 不登出、不重试。
运行方式:
```powershell
$env:KEFU_SSO_TYPESCRIPT='C:/zyt/identity-admin/web/node_modules/typescript'
$env:KEFU_SSO_WORKSPACE='C:/zyt/identity-admin/.test-runtime/kefu-admin-web'
$testFiles=@(Get-ChildItem -LiteralPath C:/zyt/identity-admin/integration/kefu/admin-web/apps/web-antd/tests -Filter '*.test.mjs' -File | ForEach-Object FullName)
node --test $testFiles
```
另对四份新增/修改 `.ts` 产品文件做了不写磁盘的 TypeScript compiler host 覆盖检查:以健康构建副本的 tsconfig/依赖解析暂存源码,虚拟声明 Vue SFC 模块,变化源码语义诊断为 **0**。这是聚焦源码检查,完整 `vue-tsc` 与生产构建仍须根任务执行;本报告不把它称为整项目类型检查。
## 部署前基线与 manifest 扩展
以下均为本轮重新只读核对的实际源 SHA256;根任务扩展 manifest 时应先重新比对,拒绝覆盖并发变化。路径相对于 `C:/kefu/`。
| 原有实际源文件 | 本轮读取基线 SHA256 | 当前 manifest |
| --- | --- | --- |
| `admin-web/apps/web-antd/src/bootstrap.ts` | `5aca1cab961f32670244d29721572535b0e55cd32c6204b28b0789954e3c532d` | 尚无条目,需新增带此基线的条目。 |
| `admin-web/apps/web-antd/src/api/request.ts` | `2c7251baf5c9b770b142f90df75917ac86eba6d985334d779456ebc4b886b56a` | 尚无条目,需新增带此基线的条目。 |
| `admin-web/apps/web-antd/src/views/console/roles.vue` | `5522d04e4432e6bb7f9a7f332f14bacf7150e6408d52c386c517b729256eae08` | 已有,当前 source/staged 均记此旧基线(第 135–138 行);更新 staged hash 即可。 |
实际新文件目标已确认不存在(`Test-Path` 均为 False):
- `C:/kefu/admin-web/apps/web-antd/src/router/authorization-sync.ts`
- `C:/kefu/admin-web/apps/web-antd/src/utils/authorization-sync.ts`
暂存产品文件最终 SHA256:
| 暂存路径(同上 `admin-web/` 相对路径) | SHA256 |
| --- | --- |
| `apps/web-antd/src/bootstrap.ts` | `ce0409f270382cbb5d71dbf1cc76388047a3e26cd0a7c8f6abdf69029f582c8c` |
| `apps/web-antd/src/api/request.ts` | `02d3e18a84f48d47d9d4a853c9e16b41e8c6b0c36efa0e46ba7dc25295686353` |
| `apps/web-antd/src/router/authorization-sync.ts` | `187a365b4bc6ea91920b20a14c3955141154efb51209eeefe9977dbb85c60c52` |
| `apps/web-antd/src/utils/authorization-sync.ts` | `c364b6d6b48364e3b8d523686b297c7d48635beea957bc8c9884047dce3f104b` |
| `apps/web-antd/src/views/console/roles.vue` | `436642b658687fe78264fdbff32fc57d4bf91cc87f5c662e4ff46bbac465a988` |
## 根任务构建与实测衔接
1. 将上述 5 个产品文件及两个测试文件从暂存 `admin-web/` 覆盖到健康构建副本 `C:/zyt/identity-admin/.test-runtime/kefu-admin-web/`;新文件父目录已在完整副本存在。无需复制实际 `.env`、配置或业务数据,无需安装依赖或改冻结清单。
2. 使用根任务准备的 `C:/zyt/scripts/build-kefu-live-refresh.ps1` 完整执行测试、`vue-tsc` 和生产 `dist-final` 构建;保持已验证生产 API base `/api/v2`。
3. 扩展并核对 source-manifest、备份及部署由根任务负责。新 source list 至少增加 bootstrap、request、router/authorization-sync、utils/authorization-sync 四项;roles 原有项只更新 staged hash。测试源项依照现有 manifest 交付规则加入/更新。
4. 新版 JS 进入浏览器需要一次升级载入,保留原 token 和会话。升级载入后进行完整集团 grant/revoke 周期,期间不再退出、重登、整页刷新或点击手动刷新授权;记录每次集团保存时间及客服菜单/按钮变化时间。
5. 已获用户明确授权的真实测试账号、空角色增删和恢复基线均由根任务操作;本轮没有执行这些实际操作。接口撤权 403 是后端证据,菜单/按钮自动变化是另一个验收点,应分别记录。
Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 93 KiB

@@ -0,0 +1,45 @@
# 客服既有会话实际验收(2026-11-04)
本次使用用户亲自登录并确认的集团管理员、客服ZYT账号`cs`(显示名“刘医生(不要挂号)”),通过实际集团和客服页面验证。客服本地用户3,稳定GID`gid_f0a62a6eb906a9d011f9e2972b6c691c`。基线为启用的`zyt_basic`,业务权限为空。没有读取或导出密码、令牌值、浏览器存储,也没有替换登录凭据。
用户已在执行前确认:临时测试范围仅`role:read`、`role:create`、`role:delete`,可反复分配和撤销,唯一空权限测试角色名为`iam_refresh_probe_20261104`,不给任何用户分配,完成后恢复`cs`为基础角色零权限。
## 当前版本实测结果
| 时间(Asia/Singapore) | 实际动作及观察 |
| --- | --- |
| 09:35 | 集团和客服核对同一cs绑定,客服只显示“账号与授权”、无业务权限。保存非敏感会话编号/创建时间/到期时间作比较基线。 |
| 09:40:40 | 集团保存三项测试权限成功,显示个人授权及3项有效权限。 |
| 09:40:45之后 | 客服原页面仍显示基础角色零权限,没有自动出现系统管理菜单。 |
| 09:41:05 | 在同一客服页点击产品“刷新授权”,整页刷新后出现系统管理→角色权限,无需退出重登。 |
| 09:42:25 | 集团撤销create/delete,仅保留role:read。客服原角色页仍残留“新增角色”按钮。 |
| 09:42:49 | 从该残留按钮实际提交唯一编码、零权限的新角色。客服显示“缺少权限:role:create 或 role:write”;实际服务日志记录POST /api/v2/roles HTTP403。 |
| 09:43之后 | 集团恢复cs为zyt_basic零权限。只读数据库核对:被拒绝的角色不存在,原会话编号/创建/到期完全相同,其他用户授权摘要未变。 |
因此原版本的**接口即时授权/撤权成立**,但**已打开页面的菜单和按钮不会自动更新**;不能将其称为无需刷新即可即时更新。此后修复和最终无需刷新的验证结果补记于下方。
证据:`kefu-live-baseline-20261104.jpg`、`kefu-live-group-granted-20261104.jpg`、`kefu-live-before-fix-stale-20261104.jpg`、`kefu-live-revoked-operation-denied-20261104.jpg`。真实服务输出`identity-admin/.test-runtime/kefu-local-api.out.log`第869行记录上述403;只读会话基线记录在`.test-runtime/kefu-live-baseline-20261104.json`(不含令牌值)。
## 修复后的真实同会话结果
已部署前台3秒轮询、聚焦/恢复可见立即取权的修复,权限变化同步菜单、按钮、路由和失权标签;仍有权页面及草稿保留。使用原登录会话加载新版前端一次后,以下完整周期**没有再次刷新页面、点击刷新授权、退出或重新登录**。
| 动作 | 集团提交观察时间 | 客服自动变化 | 观察耗时 |
| --- | --- | --- | --- |
| 分配read/create/delete三项 | 09:54:40.617 | 系统管理菜单自动出现,角色页面可读且新增按钮可用 | 2.528秒 |
| 原生页面创建空角色 | 09:55:28 | 唯一测试角色创建成功,权限0、使用人数0;实际POST /roles HTTP200 | 成功 |
| 原生页面删除空角色 | 09:55:46 | 精确测试角色移除,实际DELETE /roles/iam_refresh_probe_20261104 HTTP200 | 成功 |
| 撤销create/delete、保留read | 09:56:36.314 | 新增按钮自动消失,全部6个删除按钮禁用;原角色页面仍可读取 | 0.900秒 |
| 恢复zyt_basic、撤销最后read | 09:57:53.227 | 角色菜单自动移除,当前页自动转至/group/welcome;过渡完成后旧页面、角色标签均消失,保持登录 | 1.981秒 |
耗时从集团UI确认提交到浏览器观察变化,不是严格服务端提交时间;轮询机制的正常上限为约3秒加请求耗时,不宣称零延迟推送。精确观察记录见`kefu-live-events-20261104.json`。
最终只读核对通过:cs启用状态及zyt_basic零权限恢复,测试角色不存在;全部既有会话编号、创建时间和到期时间与基线完全相同;其他客服用户的账号/角色/状态摘要未变。真实审计包含本次用户3的空角色创建和删除,见`kefu-live-final-check-20261104.json`。权限切换留下两条无人使用的该用户个人授权角色,属于现有托管角色的审计归属机制,未分配给其他用户;未操作清理范围外的角色。
最终截图:`kefu-live-auto-granted-20261104.jpg`、`kefu-live-role-created-20261104.jpg`、`kefu-live-auto-readonly-20261104.jpg`、`kefu-live-auto-restored-20261104.jpg`、`kefu-live-group-restored-20261104.jpg`。
## 实现、构建及部署
完整暂存客服前端回归29/29通过;整项目vue-tsc通过,生产Vite构建通过(7486模块、26.89秒),未安装或更改冻结依赖。初次沙箱内构建因Windows子进程通信停滞停止,仅停止核对过的本次构建进程;以相同源码和冻结依赖在沙箱外完成构建,没有停止集团/客服运行服务。
先应用并校验7个产品及测试文件,再发布247个前端文件,静态入口SHA256为`52cf88264669cc205e5dff07da6ce48c2cdcde6f986ef89960b1c99d58a650eb`。备份为`.test-runtime/kefu-source-before-20261104-095247`和`.test-runtime/kefu-web-before-20261104-095248`。后端鉴权、账号和会话无需重启或迁移。设计及29项用例详见`kefu-live-refresh-implementation-20261104.md`。
@@ -0,0 +1,47 @@
# 客服本地角色页面最小修复记录
日期:2026-11-03。
本轮只修改 `C:/zyt/identity-admin/integration/kefu` 镜像内两个产品文件、两个专用测试文件及本记录。未修改 `C:/kefu`、登录或 API 路径、RBAC 授权、数据库和 `source-manifest.json`;未启停服务。
## 源文件基线与保留功能
修改前重新读取并复制今日实际源文件:
- `C:/kefu/admin-web/apps/web-antd/src/views/console/roles.vue`
- `C:/kefu/admin-web/apps/web-antd/src/router/routes/modules/console.ts`
修改后对照实际源文件执行 `git diff --no-index`,确认产品差异仅为下述小范围修复;保留最新 `permission-menu` 权限树、搜索与展开、页面/按钮依赖、自定义权限及菜单链接、失效码过滤、权限菜单入口和其他业务路由。
## 修改文件及行为
1. `identity-admin/integration/kefu/admin-web/apps/web-antd/src/router/routes/modules/console.ts`
- 系统管理父目录接受 `role:read`,继续兼容原 `user:read`、`audit:read`。
- 角色页面读取条件使用 `role:read` 或兼容的 `user:read`,与后端 `GET /roles` 一致。
- 只有角色写入、创建或删除权限而没有读取权限的账号,不因此获得角色页面入口;未向任何账号或角色新增权限。
2. `identity-admin/integration/kefu/admin-web/apps/web-antd/src/views/console/roles.vue`
- `admin` 和 `zyt_basic` 使用同一只读判断:列表显示“查看”,弹窗显示“查看角色/关闭”,名称和权限树禁用。
- 删除按钮禁用,并在删除处理函数中再次拦截受保护角色、内置角色、在用角色及无删除权限的操作。
- 只读状态直接拦截权限树变更;保存处理沿用已有只读拦截,不向 API 写入。
- 集团基础角色提示到“系统管理 → 用户管理”为账号分配其他业务角色。
- 保存提示和页面说明明确“后端立即生效;其他在线用户请刷新页面以更新菜单和按钮”。
3. `identity-admin/integration/kefu/admin-web/apps/web-antd/tests/group-navigation.test.mjs`
- 增加实际 Vben `generateRoutesByFrontend` 与实际共享 `filterTree` 的父子导航回归。
4. `identity-admin/integration/kefu/admin-web/apps/web-antd/tests/local-role-page.test.mjs`
- 编译实际 Vue SFC 的 setup 和模板,使用真实 Vue computed/reactive/SSR 与实际 `permission-menu.ts`,Ant 组件仅替代为呈现 props/slots 的测试适配器。
- 覆盖两个受保护角色的只读呈现、关闭按钮、名称/树禁用、不能更改勾选和不能写删 API。
- 覆盖普通角色可编辑及删除、现有自定义权限保留、原有失效码过滤、在线用户刷新提示,以及只读用户不能通过处理函数写删。
## 验证结果
以下命令执行成功,5 项测试全部通过:
```powershell
$env:KEFU_SSO_TYPESCRIPT='C:\zyt\identity-admin\web\node_modules\typescript'
$env:KEFU_SSO_WORKSPACE='C:\kefu\admin-web'
node --test C:\zyt\identity-admin\integration\kefu\admin-web\apps\web-antd\tests\group-navigation.test.mjs C:\zyt\identity-admin\integration\kefu\admin-web\apps\web-antd\tests\local-role-page.test.mjs
```
导航测试验证 `role:read`、`role:read + role:write`、`user:read` 可进入角色页面;纯角色管理员没有因此看到用户管理页面;空权限及仅写入/创建/删除权限的账号不能进入系统管理。组件测试的 API 均为进程内替身,无网络请求或数据库写入。
镜像为部分源码覆盖集,本轮未运行整套客服项目构建;实际 SFC 和模板编译已经通过。未刷新 manifest,后续由父任务按交付范围统一处理。
@@ -0,0 +1,92 @@
# 客服账号互通登录只读排查(2026-11-03)
## 范围与结论
检查了 `C:/kefu/admin-web/apps/web-antd`、`C:/kefu/wechat_rpa` 和 `C:/zyt/identity-admin` 的公开源码、启动脚本、代理及部署描述;未读取 `.env`、凭据、会话文件或真实数据库内容,未启动/停止服务,未改动业务文件。本报告是静态诊断,不能证明某个当前运行进程已取得指定环境变量。
确定存在一处直接破坏目标行为的前端缺陷:集团 `/sso/authorize` 路由守卫仍按“互联网医院”判断登录资格,因此没有医院源权限的普通 ZYT 账号会在进入客服时被跳到 403,尽管后端已允许这种账号进入客服。此外,已交付网页 SSO 不覆盖项目根目录常用的桌面启动器;本地后台直开 8766 也与当前前端 `/api` 配置不兼容。角色分配在当前网页源码中已支持本地账号与集团绑定账号,不应把这些账号改为自动管理员来绕过登录问题。
## 1. 已确认的高优先级缺陷:客服授权被医院前端门禁拦住
证据:
- `C:/zyt/identity-admin/web/src/router/index.ts:243`:对所有 `to.name === 'sso-authorize'` 请求统一检查 `sourcePermissions(auth.user).length`,并要求 `internet-hospital` 应用 `can_login`,没有读取 `to.query.client_id`。
- `C:/zyt/identity-admin/server/app/service/group/GroupService.php:168`:完成账号验证的用户会得到 `kefu` 应用;`requireClientLogin()` 在 `:261-271` 对 `kefu` 只检查账号完成验证、客服公司可用,不要求医院权限。
- `C:/zyt/identity-admin/docs/kefu-integration.md:7` 明确承诺不要求医院业务菜单权限。
- `C:/kefu/admin-web/apps/web-antd/src/utils/group-sso.ts:60-63` 发起目标是集团 `/sso/authorize?client_id=kefu&...`,一定经过上述路由守卫。
复现条件(无需操作真实账号即可由条件表达式确定):有效账号完成改密和企微绑定,医院源权限数组为空,`kefu.can_login=true`。客服起始页生成 PKCE 请求后,集团守卫在授权组件挂载前返回 `forbidden`;PHP `/group/sso/authorize` 没有机会执行。另一种情况是账号有权限,但医院应用不可进入,同样会错误拦住客服。
建议:将守卫按请求客户端分支检查。医院继续保留医院访问资格检查;客服使用已注册 `kefu` 应用的 `ready/can_login`,保留集团开启与账号验证要求;未知客户端应拒绝。最终授权资格仍由 PHP 重新判断。不要为了客服放行而给账号增加医院菜单权限。
测试缺口:`C:/zyt/identity-admin/tests/kefu-joint-flow.test.mjs:35-46` 在无源权限条件下直接调用 `authorizationRequest()` 和 HTTP `/group/sso/authorize`,没有装载 Vue Router,也没有经过 `/sso/authorize` 实际导航。这解释了接口联合测试可以通过而真实网页失败。应加入实际路由守卫/浏览器导航回归,至少覆盖“客服允许、医院拒绝”和“未知客户端拒绝”。
## 2. 常用入口遗漏:根目录启动的是桌面软件,仍为旧桌面身份链路
证据:
- `C:/kefu/启动企微客服助手.cmd:4-17` 只启动 `wechat_rpa/app_main.py`。
- `C:/kefu/wechat_rpa/app_main.py:36-45` 默认进入 Qt;`wechat_gui_qt.py:12992-12997` 调用 `ensure_desktop_login()`。
- `C:/kefu/wechat_rpa/desktop_login.py:457-470` 收取账号密码并调用 `backend_client.desktop_login()`,没有集团浏览器 SSO 按钮。
- `C:/kefu/wechat_rpa/backend_client.py:937-954` 先向 `/api/v2/desktop/auth/config` 取得 ZYT 地址,再向其 `/adminapi/login/account` 提交 `{account,password,terminal:7}`,随后向客服 `/api/v2/desktop/auth/exchange` 兑换桌面会话。
- `C:/kefu/wechat_rpa/admin_api.py:519-526` 的桌面地址取自持久化 `ZYT_LOGIN_API_URL` 或 `ZYT_API_BASE_URL`。它与网页集团配置 `ZYT_GROUP_*` 完全不同。
因此,完成网页集团 SSO 不会让桌面启动器使用集团会话。`C:/kefu/GROUP_IDENTITY.md:3` 也明确把桌面 terminal=7 排除在本次接入之外。若用户从根目录 CMD 或打包 EXE 登录,上一版范围并未覆盖他的路径。
尤其不能直接把桌面 `ZYT_LOGIN_API_URL` 改为 identity-admin:`C:/zyt/identity-admin/server/app/service/shared/SharedIdentityService.php:98-114` 的登录只允许 `{account,password}`,返回集团桥接 token;桌面还提交 `terminal`,并期待能由 `zyt_auth.verify_desktop_token()` 使用 `token` 请求头向 `/adminapi/desktop/session` 核验的源 token。两者协议不相同;identity-admin 路由表也没有桌面 session 端点。
建议:先在产品入口明确网页“本地客服账号”和“集团账号”的用途;若这次用户要求包含桌面,需单独设计桌面集团授权及桌面本地账号登录能力,或者从桌面提供打开现有网页管理端的入口。保留桌面数据隔离与设备会话约束,不能把网页 api token 直接当桌面 token。
## 3. 本地 API 直开 8766 与当前前端 `/api` 不匹配
确定的源码/构建事实:
- `C:/kefu/wechat_rpa/admin_api.py:1710-1735` 在存在 dist 时直接托管网页,但 API 仅注册为 `/api/v2/*`;SPA 明确拒绝其他 `api/` 路径。
- 当前 `C:/kefu/admin-web/apps/web-antd/dist/index.html` 引用 `_app-config-5.7.0-4deb3559.js`,其中公开 API 配置为 `VITE_GLOB_API_URL:"/api"`(仅提取了这一公开字段)。当前静态入口继续引用 `/jse/index-index-B47hMVgE.js`,再引用 `/js` 构建图,SSO 页面已在 `/js` 中,不能仅因旧 chunk 留存判断未构建。
- `C:/kefu/admin-web/apps/web-antd/src/api/core/auth.ts` 请求相对路径 `/auth/login`、`/auth/group/config`,所以直开 8766 实际请求 `/api/auth/login` 和 `/api/auth/group/config`,后端返回 404。
- Vite 开发配置 `C:/kefu/admin-web/apps/web-antd/vite.config.ts:12-21` 负责 `/api → /api/v2`;`C:/zyt/identity-admin/scripts/kefu-preview.mjs:15-21` 在 5666 做相同代理;生产 `C:/kefu/deploy/im-admin/im.zhenyangtang.cn.conf:27-37` 也有转换。
影响:运行 `python admin_api.py` 或 `python run_backend.py` 后直接点击 8766 页面,当前发布前端的本地登录和 SSO 配置获取都会失败。`start-kefu-local.ps1` 返回前端地址 5666 是有原因的;它本身只启动 Python,没有启动 5666 预览服务。
建议:选定并维护一个可直接使用的本地管理端入口。可以统一部署前端 `/api/v2`,或给 API 静态托管入口提供 `/api` 兼容路由/代理;若继续要求 5666,启动器应一起启动预览并展示准确地址,且检查代理可用。不要把 API 404 当作账号密码错误。
## 4. 配置和回调必须绑定同一浏览器入口;现有默认启动不保证完成接入
- `C:/kefu/wechat_rpa/group_sso.py:57-67` 从进程环境读取三个值,缺一或非法就静默返回 `None`;`admin_api.py:702-711` 因此返回 `enabled:false` 或 503。网页 `login.vue:21-25` 把所有配置/网络/同源校验错误都折叠为隐藏集团按钮,用户无法区分“没启用”和“请求走错路”。
- `C:/zyt/identity-admin/scripts/start-kefu-local.ps1:10-12` 配死集团前端 127.0.0.1:5173、集团 API 127.0.0.1:8081/adminapi、客服前端 127.0.0.1:5666;只有此专用脚本会设置这些客服环境变量。普通 `admin_api.py`/`run_backend.py` 不加载这份脚本,也没有读取 dotenv 的逻辑。
- `C:/zyt/identity-admin/scripts/enable-group-local.ps1:3,27-28` 的 `KefuBaseUrl` 默认空,原样执行会清空客服登记。文档要求显式传 `-KefuBaseUrl http://127.0.0.1:5666`。
- `C:/kefu/admin-web/apps/web-antd/src/utils/group-sso.ts:38-39` 要求回调与当前 `window.location.origin` 相同,且路径严格 `/auth/group-login`。因此 `localhost:5666`、`127.0.0.1:5666`、8766 是不同入口;混用会导致按钮隐藏或回调失败。
- `C:/zyt/identity-admin/server/app/service/group/KefuClient.php:14-23` 允许 base 带合法子路径,且 `docs/kefu-sso-backend.md:16` 宣称支持;客服前端却把回调路径写死为根路径。中央可接受 `/apps/kefu/auth/group-login`,客服会拒绝。这是双方配置契约不一致。
- `C:/zyt/identity-admin/compose.yaml:5-10` 默认只配置独立 sqlite 模式,未透传 shared/group/kefu 配置。直接照默认 compose 启动不能获得集团客服互通;`C:/kefu/deploy/im-admin/compose.yaml:18-20` 已透传三项客服 SSO 配置,但默认均空。
建议:对外给出唯一入口并在启动脚本校验配对配置。管理员页应显示“集团登录未配置/配置与当前地址不一致/API不可达”等安全诊断,不输出凭据。明确只支持根路径,或同步实现 base-path 路由及回调验证;不能保留一端宣称支持子路径、另一端固定根路径的状态。
## 5. 数据库路径和启动方式可能造成“本地账号丢了”的假象
- `C:/zyt/identity-admin/scripts/start-kefu-local.ps1:4,14` 指向 `C:/kefu/backend.db`。
- `C:/kefu/wechat_rpa/run_backend.py:108` 默认使用脚本目录下 `backend.db`;`C:/kefu/wechat_rpa/admin_api.py:1747,1778-1779` 默认用当前目录 `backend.db` 并会初始化。
- 文件元数据检查表明 `C:/kefu/backend.db` 存在,`C:/kefu/wechat_rpa/backend.db` 当前不存在。没有打开任何数据库。
从 `wechat_rpa` 按默认方式启动会走另一个路径,甚至创建新库,而不是继续使用专用接入脚本指定的现有账号库。此问题会同时影响登录和角色列表。建议本地入口统一解析现有绝对数据库路径;非明确初始化场景下对不存在的库立即报错,禁止意外播种覆盖认知。不要复制或合并真实数据库作为修复捷径。
## 6. 角色分配现状:当前网页链路已支持本地/集团账号
本地登录 `admin_api.py:729-752` 只验证本地 `users`;集团登录 `:707-727` 通过服务端兑换后进入同一个本地 `users` 与权限系统。`admin_backend.py:2765-2806` 按 provider+GID 首次建独立账号,默认 `zyt_basic`,后续登录保留角色与停用状态。没有按同名账号合并;这是正确的身份边界。
角色分配证据:
- `C:/kefu/admin-web/apps/web-antd/src/views/console/users.vue:11-13,103-104,119-125` 使用 `user:write` 控制角色下拉,集团账号也可改角色,只锁集团用户名和密码。本地账号同样可在表格或编辑框设置角色。
- `C:/kefu/wechat_rpa/admin_api.py:827-832` 允许有 `user:read` 的用户读取角色列表;`:885-913` 更新角色需要 `user:write`,启停另需 `user:status`。
- `C:/kefu/wechat_rpa/admin_backend.py:2834-2874` 更新同一 users.role,没有限制只能集团来源;保留最后一个启用 admin 的保护。
- `C:/kefu/wechat_rpa/rbac.py:135,275,317` 固定 `zyt_basic` 无业务权限,不应给它加业务权限;管理员应给用户选择其他本地业务角色。
因此,“本地账号登录后也能给账号设置角色”在网页源码已经成立,前提是登录者具备 `user:read` 和 `user:write`。需要核对用户实际使用的是网页管理端、正在服务的数据库和代理入口;普通本地账号不应仅因成功登录就具备给其他用户分配角色的能力。桌面 `desktop_accounts` 与管理端 `users` 也是两类对象,桌面账号页不会替代这里的角色编辑。
## 建议实施顺序
1. 修复集团路由守卫按 client_id 校验,补实际 Vue Router 导航回归。
2. 统一本地前端入口、`/api` 映射、回调 origin 和现有数据库绝对路径,提供可重复启动方式。
3. 用合成账号验收:本地管理员登录→查看本地用户→分配角色;无医院权限集团账号→SSO→基础欢迎页;本地管理员授权→集团账号刷新/重登后菜单生效;集团停用、客服停用、过期/重复授权码均拒绝。
4. 明确本次修复是否应覆盖根目录 CMD/桌面 EXE;如覆盖,单独接入正确桌面协议,不能宣称网页 SSO 已覆盖桌面。
未验证项:真实进程环境、当前监听与运行命令、真实公司登记、真实账号状态、真实密码有效性。以上均未读取或操作,后续应只以公开健康/配置端点和用户明确的实际入口核对,避免接触真实令牌和数据库内容。
@@ -0,0 +1,30 @@
# 客服集团账号登录与本地角色授权修复
2026-11-03完成发布。用户确认问题发生在浏览器管理后台,尝试把zyt账号填入客服本地密码框。本次没有将集团密码复制至客服,也没有新增密码代传接口;网页登录明确分为集团认证入口与客服本地账号入口。
## 已修复
- 集团Vue Router此前对所有SSO请求套用医院业务权限门禁。现在按实际client_id检查已登记应用,客服不要求医院菜单;医院、未知客户端、未登录及待完成账号验证的门禁保留。新增真实导航测试先复现失败,再验证修复。
- 发布产物此前使用仅预览适配的/api,直开8766会404。现在统一公开配置/api/v2,预览及Vite开发代理兼容两种前缀,避免/api/v2/v2。客服API已重载,并直接托管完整SPA。
- 非规范域或端口不再静默隐藏集团入口。先进入固定客服回调域,再生成PKCE;严格回调、一次性状态及服务器兑换不变。
- 登录页明确标注本地用户名/密码与“使用zyt集团账号登录”,集团入口失败时显示重试提示。原本地管理员登录保留。
- 父目录权限按实际子页面权限生成,避免新版model-plan/release/identity/storage/permission/role读取权限被旧目录门禁误拦。集团基础用户仍只有个人入口。
- admin和zyt_basic角色页只读,禁止提交或删除;基础角色提示在用户管理给账号分配其他业务角色。角色保存提示明确后端立即生效,其他在线用户刷新菜单及按钮。
- 集团目录提取兼容新版Permission定义,当前18页面、65权限。实际导入created=40/kept=51/roles_changed=0,保留管理员改名等配置;没有给集团角色批量授权。
## 验证
- 集团web完整68项测试、完整vue-tsc和生产构建通过;新增真实路由导航覆盖客服无医院权限、医院拒绝、未知及重复client、登录与验证要求。
- 客服前端16项通过:PKCE/旧账号缓存清理/本地登录、规范回调域、实际Vite代理、实际Vben父子过滤、每个细分页面的读取权限、真实Vue角色组件SSR及方法行为。
- 实际PHP到Python联合回归通过:合成原账号登录、空权限基础用户、真实本地管理员密码登录和分配viewer、原会话读到新角色、再次SSO保留、重放与停用拒绝。使用临时源和SQLite,未以真实账号做写入验收。
- 目录导入285条隔离断言通过,涵盖不授予角色、不污染医院、保留用户自定义、失败回滚。
- 客服完整vue-tsc通过;最终Vite构建通过,7484模块、17.85秒。公开源码副本保留原锁定版本,不读取或复制.env。同步今天新增的hash-wasm4.12.0及已删除的两个旧知识页面,保留今天的i18n、自定义权限和知识中心等代码。
- 248个产物已发布至C:/kefu/admin-web/apps/web-antd/dist与当前5666预览,入口最后切换。SHA256:366f7c0424247d9bcb7e3980b64fdb04036f19e1a370fc7659bb20ac50819422。发布记录:identity-admin/.test-runtime/kefu-login-fix-build-result.json。
- 5666和8766登录页、5666两种API前缀的公开集团配置、8766标准集团配置、5666健康均HTTP200;直接托管运行配置确认/api/v2。
- 真实浏览器已核对新版两个入口与可用集团按钮,截图kefu-login-fixed-20261103.jpg。点击旧入口可到集团登录页,当前需用户输入已有集团凭据;没有代用户输入密码,未声称已用其真实密码完成新一轮登录。集团跳转源码本就使用localStorage与同标签页导航,进一步真实组件动作核对未发现需修改的存储或窗口问题。
## 应用与运行边界
25文件交付清单最终无待应用差异。源码备份:identity-admin/.test-runtime/kefu-source-before-20261103-144508及145714;产物备份:kefu-web-before-20261103-145913。已精准重载记录的本机服务,API父PID22596、预览PID15228;启动读取已有C:/kefu/backend.db,未初始化演示账号或人工修改真实用户角色、密码。正常启动会执行现有应用的权限定义迁移。
客服本地管理员可在系统管理→用户管理编辑本地及集团账号角色;普通账号的管理能力取决于明确授权,集团账号首次仍是空权限基础角色。集团SSO会话最长8小时,尚无集团改密立即撤销全部客服会话协议。桌面terminal=7流程不在本次用户确认的网页修复范围。
Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

@@ -0,0 +1,43 @@
# 客服同框密码登录后端(2026-11-03)
已完成镜像后端与专用回归。没有写入真实 `C:/kefu`、manifest 或前端。
## 变更
- `identity-admin/integration/kefu/wechat_rpa/admin_api.py`:原 `POST /api/v2/auth/login` 保持本地优先。本地有效密码直接成功,保留原角色、权限、首次改密及 30 天会话,远程请求数为零。本地失败才请求集团代理,成功会话为 8 小时。
- `identity-admin/integration/kefu/wechat_rpa/group_sso.py`:新增 `GroupPasswordConfig`,仅依赖 `ZYT_GROUP_API_URL`。固定请求 `POST <api>/group/kefu/login`,JSON 精确为 `client_id=kefu`、`account`、`password` 三项。没有浏览器跳转或回调域依赖。
- 代理与原授权码交换共用传输:配置 URL 安全校验、HTTPS 默认验证证书、仅回环允许 HTTP、禁环境代理、禁重定向、10 秒超时、16 KiB 响应上限、严格成功 code 和六字段 `validate_identity` 校验。账号密码不重复落库,不记录密码或上游令牌。
- 登录错误统一安全文案,Pydantic 登录输入校验也不返回原始密码输入。登录响应 `no-store`。保留既有登录失败限流与审计行为。
读取并沿用今日真实 `admin_backend.py`、`rbac.py` 的现有保障,两文件镜像与真实源完全相同,无需改动:按 `provider+gid` 绑定、首次 `zyt_basic` 零权限、同名本地账号隔离、重复登录保留本地授权和停用、绑定账号禁止本地密码登录或设置密码。不存在按源角色授权或按同名认领本地管理员的路径。
## 验证
执行:
```powershell
& C:/kefu/wechat_rpa/.venv/Scripts/python.exe C:/zyt/identity-admin/tests/kefu-password-backend.py
```
结果:**33 项测试全部通过,50.007 秒**;包括新增 17 项直接密码回归与原 16 项集团 SSO 回归。
测试先临时复制真实公开 `*.py` 模块,再覆盖四个镜像模块;只运行临时源码、假初始配置及临时 SQLite,不复制或读取真实 `.env`、JSON 配置、密钥、数据库、浏览器数据。Windows 仅保留系统运行环境变量,以便 OpenSSL 正常建立验证证书的默认上下文。所有上游交互均为合成回环 HTTP 服务,没有访问真实 ZYT。
覆盖本地成功零远程请求/改密策略/30 天 TTL,同名源 admin 仅基础权限,源无业务权限仍以基础用户登录且业务 API 返回 403,首次和重复身份映射,管理员通过真实用户 API 分配本地角色,重复登录保留授权与更新源显示名,本地停用拒绝登录和会话失效,同名停用本地管理员不被认领或重新启用,绑定账号不能借已知本地密码绕过源验证,错密码/源关闭/源无资格/源会话过期/服务异常/断连/重定向/大响应/坏 JSON/注入 URL/伪造 DTO 全部关闭失败,8 小时集团会话到期,原爆破阈值,禁环境代理以及密码/上游消息不回显、不落库。
首次受限沙箱运行定位到 Windows asyncio 自用 socketpair 被网络限制阻塞;经自动审批的同一隔离命令在网络沙箱外运行。初次夹具清空系统环境导致 OpenSSL 初始化失败,已修复夹具保留 SYSTEMROOT/WINDIR 等运行变量;最终全量通过。未放宽产品 TLS、安全配置或身份校验。
## 真实源保护及校验值
开始前从真实源复制待修改的两文件;完成后重新校验,真实源四文件摘要均与开始一致:
| 真实源 | SHA-256 |
| --- | --- |
| admin_api.py | CB03231AEC63A280E4F47E094BA1F617024B4BE5259AE3EF088D4B7E368A55F5 |
| admin_backend.py | 52990C68A4B741739D16383AAEA948D603AB6EADC6798A83B1332EFC2C375381 |
| group_sso.py | 2BAB1083750BF01167C0D3F2A009CBF2B123F5FF7847A208C99F4C5088029266 |
| rbac.py | 0EA089BAA98487069919E830FB49CAD22A7D40728F93EE1AA681FADA9E3AE1BB |
镜像修改后摘要:`admin_api.py` 为 `CBF57D04E1F92633E57B455A6435A884D9C517DF8EF05FDAABDCE027929C8A06`;`group_sso.py` 为 `830FE7773545812D27DF5F837F4A949347D5E727780DE41F984FD04593494AF0`。
本次只是集成镜像实现与合成回归;真实客服部署及中央代理联调由主任务统一处理。
@@ -0,0 +1,64 @@
# 客服直接密码登录:中央 API 实现与隔离验证
日期:2026-11-03。范围:`identity-admin/server` 与中央隔离测试;未修改客服前端、镜像或真实账号,未读取 `.env`、真实数据库或凭据,未启停任何服务。
## 已实现协议
`POST /adminapi/group/kefu/login`,Content-Type 必须为 `application/json`,请求必须是 JSON 对象,字段仅允许:
```json
{"client_id":"kefu","account":"<ZYT账号>","password":"<用户输入的原密码>"}
```
客户端必须精确为字符串 `kefu`;不接受公司、用户编号、root、角色、权限、profile、token、回调地址或查询参数。账号沿用共享登录的 1–32 字符及控制字符限制,密码必须为非空字符串、最多 4096 字节且不能包含 NUL。中央控制器保持 JSON 大小 65536 字节上限和非 JSON/数组/语法错误拒绝行为。
成功保持既有 `code=1` envelope,`data` 精确复用旧客服 SSO 的六字段 DTO:
```json
{"code":1,"msg":"","data":{"client_id":"kefu","gid":"gid_<稳定身份>","source_admin_id":123,"account":"<ZYT账号>","name":"<源姓名>","company_id":12}}
```
不会返回集团或源 token、密码、root、角色、菜单、权限或管理标记;中央只证明来源身份。首次建立客服本地账号的最低角色和后续授权仍由客服系统及客服管理员负责。
## 会话副作用研究及处理
已先向主任务报告既有源 API 的协议冲突。`server/app/adminapi/service/IdentitySessionService.php::login` 在账号行锁内真实核验原密码,然后调用 `LoginLogic::login`。后者更新 `login_time/login_ip`,并调用 `AdminTokenService::setToken`。
`setToken` 按 `admin_id + terminal` 查找会话:多点登录时可能直接复用既有 token;非多点或已过期时会旋转该终端既有 token。合法 terminal 1/2/7/9 均非中央独占。因此中央不能通过“临时 login 再 logout(all=0)”保证只清理自身会话:该 token 可能就是用户原网页或 RPA 会话。选择任意其他现有 terminal 也无法消除冲突。
主任务确认增设无会话源协议 `POST identity.session/verify`,源实现由主任务负责。中央仅调用此路径,绝不降级调用 `identity.session/login`,不调用 logout,也不创建桥接会话、授权码或医院 ticket。没有需要清理的临时会话,因此不会注销任何既有会话。
源 verify 请求严格为 `account/password`;中央只接受以下精确六字段:`id:int>0`、`account:string`、`name:string`、`disable:int(0/1)`、`requires_password_change:bool`、`requires_wecom_binding:bool`。额外 token/root/角色等字段、缺字段或错误类型均安全拒绝。源必须真实复核原密码、账号启停与原登录限流;此中央报告不替代源实现报告。
## 门禁及错误处理
- 需要 shared 模式及 `IAM_GROUP_ENABLED`,无需集团前端运行、集团浏览器会话或浏览器跳转。
- 使用与旧客服 SSO 相同的 `KefuClient` 登记规则(有效固定客户端地址及公司编码)、实际已登记公司和全部上级公司的启停/存在/无循环检查。客户端或公司不可用时,在转交密码前拒绝请求。
- verify 返回后再次执行现有 `requireClientLogin/accountReady`;停用、首次改密、待企业微信绑定均不能进入客服。
- 不读取医院菜单/权限,不调用 `auth.admin/mySelf` 或医院授权端点;有和没有医院权限均能证明有效来源身份。`GroupStore::identity` 沿用既有稳定 GID 及组织信息行为,不授予医院菜单或客服业务权限。
- 使用现有中央 `LoginLimiter`:15 分钟内账号最多 5 次、IP 最多 30 次,调用源前预留;成功释放失败预算。源原有限流仍由 verify 保留,没有绕过源校验的 fallback。
- 上游异常、非 JSON、错误 envelope 和不符合 DTO 的响应均拒绝;源失败消息不回传,只返回固定错误。审计只记录来源编号、动作、公司、时间,不记录账号密码、token 或上游正文。
## 修改文件
- `identity-admin/server/route/app.php`:显式登记仅 POST 新路由。
- `identity-admin/server/app/controller/ApiController.php`:新操作使用既有严格 JSON 解析并传入真实连接 IP。
- `identity-admin/server/app/service/shared/SourceApiClient.php`:只增加 verify allowlist;verify 错误使用固定安全消息。
- `identity-admin/server/app/service/shared/SharedIdentityService.php`:无会话密码证明、输入及上游 DTO 校验、现有限流。
- `identity-admin/server/app/service/group/GroupService.php`:共用客户端/公司/账号门禁,并让旧 SSO 与新端点共用同一个六字段 DTO 构造器。
- `identity-admin/tests/kefu-password-login.php`:真实 PHP 服务对象、真实 SourceApiClient、合成 transport、随机隔离 SQLite/运行目录,不发网络请求。
## 验证结果
PHP:`C:/phpstudy_pro/Extensions/php/php8.2.9nts/php.exe -d extension=pdo_sqlite`。
| 检查 | 结果 |
|---|---|
| `identity-admin/tests/kefu-password-login.php` | 通过,405 项检查 |
| 既有 `identity-admin/tests/group-identity.php` | 通过,40 项检查 |
| 既有 `identity-admin/tests/login-limiter.php` | 通过,3 个场景 |
| 修改的 5 个 PHP 生产文件和新 PHP 测试语法检查 | 通过 |
新增隔离回归覆盖:有效身份、有/无医院权限、原 root 身份不得输出授权信息、稳定 GID、错误密码、停用及两个验证门禁、客户端关闭/公司关闭/上级关闭/上级缺失、严格 JSON 解析、额外字段/类型/查询篡改、上游错误消息和畸形 DTO 安全关闭、账号/IP 限流、35 次共享办公网成功登录、旧客服 SSO 与新 DTO 完全相同、旧授权码一次性、无医院权限继续拒绝医院 SSO、有医院权限继续取得医院 ticket,以及新验密不改变既有源/集团会话。
测试未启动 HTTP 服务,未访问任何实际源地址。合成源地址以 `.invalid` 结尾,所有源调用都由传入 transport 接管。完整产品连通性依赖主任务安装相匹配的源 verify 实现及客服后端调用;中央不会为缺失的 verify 接口退回有会话登录。
@@ -0,0 +1,73 @@
# 客服统一账号密码登录前端变更 · 2026-11-03
## 结果
客服主登录页现在只有一份账号、密码输入及登录按钮。ZYT 与客服本地账号均直接提交现有 `POST /api/v2/auth/login`,不读取集团入口配置,不跳转集团后台。提示语说明 ZYT 首次登录为基础用户,业务权限由客服管理员分配。
本次产品源码只修改 `C:/zyt/identity-admin/integration/kefu/admin-web` 镜像;真实 `C:/kefu` 仅作只读比对。未修改 manifest、角色页面、专用 SSO 路由或其实现。随后在已有冻结依赖副本完成完整类型检查和生产构建,未发布或启停服务。
## 修改文件
- `apps/web-antd/src/views/_core/authentication/login.vue`:删除 config 加载、集团跳转按钮、重试入口、router/window 跳转;账号及密码 placeholder 同时说明 ZYT/客服本地来源;关闭记住账号额外选项;保留 `@submit="authStore.authLogin"`。
- `apps/web-antd/src/api/core/auth.ts`:仅补充统一账号密码登录说明。登录请求行为不变,只通过 POST body 发送 username/password/device_name。
- `apps/web-antd/tests/password-login-page.test.mjs`:新增真实页面 SFC 编译与 Vue SSR 测试;共享表单组件使用按 schema/slots 渲染的适配器,实际页面 setup/computed/template/提交监听器均运行。
- `apps/web-antd/tests/group-sso.test.mjs`:补充普通密码登录经过真实 loginApi、getUserInfoApi、authStore 的回归;覆盖本地、ZYT 基础、已授权 ZYT 三种 `/me` 权限,错误重试与 `/me` 失败后的清理。
## 权限与凭证验证
现有 `authStore.finishLogin` 无需修改:安装新 token 前清理路由、菜单、标签、锁屏及持久化身份,再取 `/me`。测试以旧管理员缓存作为初始状态,并故意令登录响应带有过宽权限,确认最终只采用 `/me` 返回权限;ZYT 基础用户不会继承管理员缓存。
实际页面/API测试不提供配置 API、集团 URL helper、router 或浏览器跳转依赖;意外引入会失败。API测试断言只有 `/auth/login` 的 POST body 带凭证,URL无参数,页面/API未访问 localStorage。
## 验证
使用 `C:/zyt/identity-admin/web/node_modules` 的 TypeScript、Vue、SFC 编译器及 SSR,无需安装或改动依赖。
```powershell
$env:KEFU_SSO_TYPESCRIPT = 'C:\zyt\identity-admin\web\node_modules\typescript'
$env:KEFU_SSO_WORKSPACE = 'C:\kefu\admin-web'
node --test integration/kefu/admin-web/apps/web-antd/tests/password-login-page.test.mjs integration/kefu/admin-web/apps/web-antd/tests/group-sso.test.mjs integration/kefu/admin-web/apps/web-antd/tests/local-role-page.test.mjs
```
结果:**17/17 通过**,覆盖实际登录页面、普通提交和错误重试、统一 POST 凭证传送、旧管理员缓存隔离、`/me` 授权、强制改密落地、SSO兼容及角色页既有行为。
首次附带执行既有角色页测试时未设置 `KEFU_SSO_WORKSPACE`,因镜像缺少未修改的 permission-menu.ts 而 ENOENT;设置只读真实源码根后,以上完整目标测试通过。未修改或复制该 helper。
## 冻结副本最终构建
在已有健康副本 `C:/zyt/identity-admin/.test-runtime/kefu-admin-web` 中,仅从镜像覆盖本轮 `login.vue` 与 `api/core/auth.ts`,保留其他今日源码与冻结依赖。未重新安装依赖、重拷依赖清单、读取或复制 `.env`,也未覆盖副本 `internal/tailwind-config/src/theme.css`。
按顺序执行:
```powershell
$env:VITE_ROUTER_HISTORY = 'history'
$env:VITE_APP_TITLE = '企微客服'
$env:VITE_GLOB_API_URL = '/api/v2'
$env:VITE_APP_NAMESPACE = 'kefu'
$env:VITE_BASE = '/'
pnpm.cmd --filter @vben/web-antd run typecheck
pnpm.cmd --filter @vben/web-antd exec vite build --mode production --outDir dist-final
```
结果:**typecheck exit 0,production build exit 0**。Vite 8.2.2 转换 7,484 个模块,构建耗时 56.24 秒;产物共 247 个文件,位于副本 `apps/web-antd/dist-final`。已确认 `js/login-BiCRPV_c.js` 包含本轮统一账号 placeholder。
- 类型检查日志:`C:/zyt/identity-admin/.test-runtime/kefu-password-typecheck.log`
- 构建日志:`C:/zyt/identity-admin/.test-runtime/kefu-password-build.log`
- 构建校验记录:`C:/zyt/identity-admin/.test-runtime/kefu-password-build-check.json`
- 可重用执行脚本:`C:/zyt/identity-admin/.test-runtime/run-kefu-password-build.ps1`
- 产物 index SHA256:`1CEE2372617048A49C4B19E18A54D6F086D300BD74202CBF0A710B10762E3FE7`
- 完成时间:`2026-11-03T07:20:27.4911811Z`(新加坡时间 15:20:27)。
构建前后哈希确认:副本 package.json、pnpm-lock.yaml、theme.css 和 hash-wasm/package.json 均未变化;两份覆盖源码的副本哈希与镜像一致。真实 `C:/kefu` 的 login.vue/auth.ts 哈希仍与本报告下列原值一致。产物仅留在隔离副本,未复制到真实项目或任何服务目录。
## 今日源码保护
修改前已读取真实源码,主登录页和 auth API 与镜像 SHA256 一致;完成后真实文件 SHA256 仍保持:
- 真实 `login.vue`:`71FF8D53B28F7D835276650EAD77610083C969917C5C6683162A43C8E7281229`
- 真实 `api/core/auth.ts`:`236069CB44C2A275BB15542B3F086BABAADB7B7BCEC45759DD0849730C0A550E`
- authStore(真实与镜像仍一致):`5B9E756C703E04B472F18A9528B9538B3F1D0B4772F74D1B381433977F4477BB`
- group-login.vue(真实与镜像仍一致):`D413E1BC75296A48267A1124462D6FE6E6DCFB20E4B12116CAF3BD0F7B561952`
- roles.vue(真实与镜像仍一致):`5522D04E4432E6BB7F9A7F332F14BACF7150E6408D52C386C517B729256EAE08`
项目声明的 `C:/zyt/.trellis/workflow.md` 与 `.trellis` 目录当前不存在;本次按已提供的 AGENTS.md 和父任务限定范围执行。

Some files were not shown because too many files have changed in this diff Show More