端到端验收修复与指标出具:

- 身份与工具:登录页建第一个管理员(认人接口的 401 说明能不能建);搭建者有只读的人和组名录,选人给候选并核对名字;授权三行带标题;端点请求头名校验(空名、非法名存不进、发不出时说清原因);写入能力在工具页试运行一律演练、不发送,HTTP 状态照实说成败;写记忆不算只读、查询能力只能选同一端点上的只读能力;审批与遮罩的说法和实际规则一致;开登录时不要署名、导入和发布记登录的人;使用者不显示推演等只给搭建者的操作,403 按是否开登录说话;登录页只认一次人
- 流程与实例:图里用到的岗位(派给谁、超时升级给谁、发送确认派给谁)全部派生、没绑人的发布时报错;写外部系统的参数按能力声明的类型收拢后再算哈希和发送,收不成就不发;发起人的实例页只看这一步的状态,处理人才给待办卡;会签进度带登录核实和时间,升级后照实写规则;实例状态写流程的结论(已退回、未确认、等待核实写入结果),核实生效后不再挂失败原因;流程应用首页不派生最近封存运行的结果块,看板没数据时是安静的空态;样例⑩的金额带类型和下限、待办标题带金额,表单上下限前后端一起生效
- 看板与证据:定时任务模板加 ISO 周、上一 ISO 周、本月、上月;出处链穿过原样解析查询结果的整形节点,追不到原始数据的照实说停在哪里,样例⑨改用 cell();应用首页和版本历史都能做成应用;指标块单位不重复;版本列表带退役说明;定时任务页头跟着刷新;删视图要确认、新视图能起名;编辑器属性用中文名、术语带解释
- 指标出具(用户 2026-10-15 拍板):契约只写「指标来自」、上游没有报告撰写节点、成果里没有模型写的话时按指标出具——必需指标齐、指标输入追到原始数据、成果字段里的数回指得上才完整出具;受管级要求每个指标静态地追到原始数据(governed.metric_untraced);出具横幅和应用印章写明按指标
- 受管工作流降为已发布只给管理员(Q8 顺延,服务端同样拦);工作流接口带当前发布版的级别,画布上改过之后也认得出受管工作流
This commit is contained in:
ThearchyHelios
2026-10-15 07:15:37 +08:00
parent 5d42ffb62b
commit 941723b17c
116 changed files with 4917 additions and 631 deletions
+82 -32
View File
@@ -1,15 +1,19 @@
/**
* 选人或组:岗位绑定、应用授权、改派、表单里的 principal 控件共用。
*
* 开了登录时从用户表、组表取候选(下拉提示,照样可以手填:取候选要管理员权限,搭建者取不到时退回手填);
* 关登录时没有用户表,只能手填名字——签批记的也是各自填的署名,这里不假装能核对。
* 开了登录、搭建者及以上:从名录(GET /api/directory,只读:用户名、显示名、是否停用、组名)取候选,填的名字逐个核对——
* 名录里没有的、停用了的不让添加,说清是哪一个(账号密码登录时人和组都在本系统里建,名录里没有就是填错了);单点登录的
* 人和组第一次登录后才进名录,名录里没有的照实提醒,点「仍然添加」才加上。已选的里头名录里没有的、停用了的在标签上
* 标出来,不静默放着。
* 使用者读不到名录:照填,服务端按名字认。关登录时没有用户表,只能手填名字——签批记的也是各自填的署名,这里不假装能核对。
*/
import { useEffect, useId, useState } from 'react'
import { Plus, Users, UserRound, X } from 'lucide-react'
import clsx from 'clsx'
import { api } from '../api/client'
import { PRINCIPAL_TEXT } from '../lib/termsApp'
import { useLoginOn } from '../store/auth'
import { useAtLeast, useAuth, useLoginOn } from '../store/auth'
import type { Directory } from '../typesApp'
import { isComposing } from './ui'
export interface Principal {
@@ -27,66 +31,99 @@ export interface PrincipalPickerProps {
label?: string
}
/** 候选只取一次,同一页上几个选择器共用 */
let candidates: Promise<{ users: string[]; groups: string[] }> | null = null
function loadCandidates() {
candidates ??= Promise.all([
api.identity.users().then((r) => r.items.filter((u) => !u.disabled).map((u) => u.username), () => [] as string[]),
api.identity.groups().then((r) => r.items.map((g) => g.name), () => [] as string[]),
]).then(([users, groups]) => ({ users, groups }))
return candidates
/** 名录只取一次,同一页上几个选择器共用;没取到(断线)下次打开再取 */
let directory: Promise<Directory | null> | null = null
function loadDirectory(): Promise<Directory | null> {
directory ??= api.identity.directory().catch(() => { directory = null; return null })
return directory
}
/** 这一项在名录里对不上的地方:没有这个人或组(missing)、人停用了(disabled)。名录没取到、选的是所有人时不判 */
function problemOf(p: Principal, known: Directory | null): 'missing' | 'disabled' | null {
if (!known || p.kind === 'everyone') return null
if (p.kind === 'group') return known.groups.some((g) => g.name === p.name) ? null : 'missing'
const user = known.users.find((u) => u.username === p.name)
return !user ? 'missing' : user.disabled ? 'disabled' : null
}
export function PrincipalPicker({ value, onChange, allowEveryone = false, single = false, label }: PrincipalPickerProps) {
const uid = useId().replace(/[^a-zA-Z0-9_-]/g, '')
const loginOn = useLoginOn()
// 名录给搭建者及以上(使用者读不到,不去取:取了也是 403)
const listable = useAtLeast('builder') && loginOn
const oidc = useAuth((s) => s.me?.mode === 'oidc')
const [kind, setKind] = useState<'user' | 'group'>('user')
const [text, setText] = useState('')
const [known, setKnown] = useState<{ users: string[]; groups: string[] }>({ users: [], groups: [] })
const [known, setKnown] = useState<Directory | null>(null)
/** 刚才要加、名录里对不上的那一项:soft 是单点登录下名录里还没有(可以「仍然添加」),其余不让加 */
const [refused, setRefused] = useState<{ item: Principal; message: string; soft: boolean } | null>(null)
useEffect(() => {
if (!loginOn) return
if (!listable) return
let alive = true
void loadCandidates().then((c) => { if (alive) setKnown(c) })
void loadDirectory().then((d) => { if (alive) setKnown(d) })
return () => { alive = false }
}, [loginOn])
}, [listable])
const has = (p: Principal) => value.some((x) => x.kind === p.kind && x.name === p.name)
const add = (p: Principal) => {
if (!p.name.trim() || has(p)) return
const add = (p: Principal, anyway = false) => {
const item = { ...p, name: p.name.trim() }
if (!item.name) return
if (has(item)) { setText(''); setRefused(null); return }
const problem = problemOf(item, known)
const soft = problem === 'missing' && oidc
if (problem && !(soft && anyway)) {
setRefused({
item, soft,
message: problem === 'disabled' ? PRINCIPAL_TEXT.disabledUser(item.name)
: soft ? PRINCIPAL_TEXT.unknownOidc(item.name)
: item.kind === 'group' ? PRINCIPAL_TEXT.unknownGroup(item.name) : PRINCIPAL_TEXT.unknownUser(item.name),
})
return
}
onChange(single ? [item] : [...value, item])
setText('')
setRefused(null)
}
const remove = (p: Principal) => onChange(value.filter((x) => !(x.kind === p.kind && x.name === p.name)))
const listId = `${uid}-list`
const options = kind === 'user' ? known.users : known.groups
const errorId = `${uid}-error`
const options = !known ? [] : kind === 'user'
? known.users.filter((u) => !u.disabled).map((u) => ({ value: u.username, label: u.display_name }))
: known.groups.map((g) => ({ value: g.name, label: g.label }))
return (
<div className="min-w-0" data-principal-picker="">
{value.length > 0 && (
<ul className="mb-1.5 flex flex-wrap gap-1" aria-label={label}>
{value.map((p) => (
<li key={`${p.kind}:${p.name}`} className="chip flex items-center gap-1" data-principal={p.kind}>
{p.kind === 'group' ? <Users size={11} aria-hidden /> : p.kind === 'user' ? <UserRound size={11} aria-hidden /> : null}
<span>{p.kind === 'everyone' ? PRINCIPAL_TEXT.everyone : p.name}</span>
<span className="sr-only">({PRINCIPAL_TEXT[p.kind]})</span>
<button type="button" className="-mr-0.5 rounded text-faint hover:text-fg" aria-label={PRINCIPAL_TEXT.remove(p.kind === 'everyone' ? PRINCIPAL_TEXT.everyone : p.name)}
onClick={() => remove(p)}>
<X size={11} aria-hidden />
</button>
</li>
))}
{value.map((p) => {
const problem = problemOf(p, known)
return (
<li key={`${p.kind}:${p.name}`} className="chip flex items-center gap-1" data-principal={p.kind}
data-principal-problem={problem ?? undefined}
style={problem ? { color: 'var(--st-waiting)', borderColor: 'var(--st-waiting)' } : undefined}>
{p.kind === 'group' ? <Users size={11} aria-hidden /> : p.kind === 'user' ? <UserRound size={11} aria-hidden /> : null}
<span>{p.kind === 'everyone' ? PRINCIPAL_TEXT.everyone : p.name}</span>
<span className="sr-only">({PRINCIPAL_TEXT[p.kind]})</span>
{problem && <span className="text-2xs">· {problem === 'disabled' ? PRINCIPAL_TEXT.disabledTag : PRINCIPAL_TEXT.missingTag}</span>}
<button type="button" className="-mr-0.5 rounded text-faint hover:text-fg" aria-label={PRINCIPAL_TEXT.remove(p.kind === 'everyone' ? PRINCIPAL_TEXT.everyone : p.name)}
onClick={() => remove(p)}>
<X size={11} aria-hidden />
</button>
</li>
)
})}
</ul>
)}
<div className="flex items-center gap-1.5">
<select className="field w-auto shrink-0" aria-label={PRINCIPAL_TEXT.kind} value={kind}
onChange={(e) => setKind(e.target.value as 'user' | 'group')}>
onChange={(e) => { setKind(e.target.value as 'user' | 'group'); setRefused(null) }}>
<option value="user">{PRINCIPAL_TEXT.user}</option>
<option value="group">{PRINCIPAL_TEXT.group}</option>
</select>
<input className="field min-w-0 flex-1" aria-label={label ?? PRINCIPAL_TEXT.placeholder}
placeholder={PRINCIPAL_TEXT.placeholder} list={options.length ? listId : undefined} value={text}
onChange={(e) => setText(e.target.value)}
aria-invalid={refused && !refused.soft ? true : undefined} aria-describedby={refused ? errorId : undefined}
onChange={(e) => { setText(e.target.value); setRefused(null) }}
onKeyDown={(e) => {
if (e.key !== 'Enter' || isComposing(e)) return
e.preventDefault()
@@ -95,7 +132,9 @@ export function PrincipalPicker({ value, onChange, allowEveryone = false, single
// 单选时填完就算选好,不用再点「添加」:表单里的选人控件和普通输入框一样,失焦即生效
onBlur={() => { if (single && text.trim()) add({ kind, name: text }) }} />
{options.length > 0 && (
<datalist id={listId}>{options.map((o) => <option key={o} value={o} />)}</datalist>
<datalist id={listId}>
{options.map((o) => <option key={o.value} value={o.value}>{o.label !== o.value ? o.label : undefined}</option>)}
</datalist>
)}
<button type="button" className="btn btn-sm shrink-0" disabled={!text.trim()} onClick={() => add({ kind, name: text })}>
<Plus size={12} aria-hidden /> {PRINCIPAL_TEXT.add}
@@ -107,6 +146,17 @@ export function PrincipalPicker({ value, onChange, allowEveryone = false, single
</button>
)}
</div>
{refused && (
<div id={errorId} role="alert" className="mt-1 flex flex-wrap items-center gap-x-2 gap-y-1 text-2xs leading-relaxed"
style={{ color: refused.soft ? 'var(--st-waiting)' : 'var(--err)' }} data-principal-refused={refused.soft ? 'soft' : 'hard'}>
<span>{refused.message}</span>
{refused.soft && (
<button type="button" className="btn btn-xs" onClick={() => add(refused.item, true)} data-principal-add-anyway="">
{PRINCIPAL_TEXT.addAnyway}
</button>
)}
</div>
)}
{!loginOn && <div className="mt-1 text-2xs text-faint">{PRINCIPAL_TEXT.manualHint}</div>}
</div>
)
+4 -2
View File
@@ -1398,11 +1398,13 @@ function BadgeShape({ shape, maskId, animate }: { shape: StatusShape; maskId: st
* 徽标加中文。正常态安静(只有字色),异常态(失败、等人、挂起、阻断)才铺淡底。
* 文字从 lib/status 取,全站只有这一份说法。
*/
export function StatusPill({ status, pendingApproval, short = false, plain = false, title, className }: {
export function StatusPill({ status, pendingApproval, short = false, plain = false, label, title, className }: {
status: string
pendingApproval?: boolean
/** 用短叫法:「待审批」「完成」 */
short?: boolean
/** 服务端给的说法(流程实例的结论,如「已退回」「等待核实写入结果」):剪影和颜色仍按 status,文字用它 */
label?: string
/** 不要底色和内边距,行内用 */
plain?: boolean
title?: string
@@ -1422,7 +1424,7 @@ export function StatusPill({ status, pendingApproval, short = false, plain = fal
data-status={meta.code}
>
<StatusBadge status={status} pendingApproval={pendingApproval} size={12} decorative />
{short ? meta.short : meta.label}
{label || (short ? meta.short : meta.label)}
</span>
)
}