使用者选人(前端):选人控件按池边输入边取候选;个人渠道的实例事件改叫「我发起的实例完成 / 失败」

为什么:使用者读不到名录,选人控件只能凭记忆手填用户名,填错了服务端以前也照收(05-已知遗留 (b))。服务端已按用途给候选池、
开登录时按同一个池核对(上上个提交),前端要把候选给到人手上。另外个人渠道勾「实例完成 / 失败」以前永远收不到,服务端修好之后
(驳回那个提交里的 notify_run),名字要照实写成只推自己发起的实例(04-对外集成与触达 B1)。

做了什么:
- PrincipalPicker 加 source(CandidateSource:form 带 app_id+entry 或 task_id 和 field,review)。搭建者及以上照旧用整份名录;
  使用者开了登录、给了 source 时边输入边按开头取候选(250 毫秒防抖),列表里显示显示名、标签悬停给用户名;加的时候按同一个池
  问一次服务端,不在池里的当场说「「x」不在可选的人里」(问不到就先收下,提交时由服务端判);池要先输开头才列、列不全时照实提示。
- SchemaForm 按表单用在哪(入口、待办,同上传文件的上下文)给选人控件 source;个人应用提交审核用 purpose=review。
- typesApp:CandidateSource、Candidates、FormField 的 x-principal、FormError 的 principal 码(和服务端 FORM_ERROR_CODES 同序)。
- api.identity.candidates。termsApp 的 PRINCIPAL_TEXT 加三句。
- 设置 → 通知:范围是「仅自己」的渠道,run.finished / run.failed 写「我发起的实例完成 / 失败」(termsApp.NOTIFY_PERSONAL_EVENT_LABEL)。
- 服务端 x-principal 写法不对时的说法改成不带半角冒号接中文的写法(check-copy)。
This commit is contained in:
ThearchyHelios
2026-10-16 10:54:30 +08:00
parent 2fa2db3ea0
commit fbb671a96b
8 changed files with 132 additions and 24 deletions
+27 -2
View File
@@ -54,6 +54,25 @@ export interface Directory {
groups: { name: string; label: string }[]
}
/**
* 使用者选人的候选从哪个池取(GET /api/directory/candidates,05-已知遗留 (b)):form 是表单里的选人控件(入口表单带 app_id、
* entry,待办表单带 task_id,都带 field),review 是个人应用提交审核
*/
export type CandidateSource =
| { purpose: 'form'; app_id?: string; entry?: string; task_id?: string; field: string }
| { purpose: 'review' }
/**
* 候选池给的那一份:只有用户名和显示名(不给是否停用、角色、邮箱,停用的不列)。needs_query:应用授权给了所有人,
* 不输入开头不列;truncated:符合的超过了上限(最多 50 位)
*/
export interface Candidates {
users: { username: string; display_name: string }[]
groups: { name: string; label: string }[]
truncated: boolean
needs_query?: boolean
}
export interface AuditRow {
id: string
at: string
@@ -100,6 +119,11 @@ export interface FormField {
'x-widget'?: FormWidget
/** 文件控件的限制,只配 x-widget: file */
'x-file'?: FileLimits
/**
* 选人控件的候选池,只配 x-widget: principal:app(能用这个应用的人,缺省)、group:<组>、slot:<岗位>
* (服务端 auth/directory.pool_problem,05-已知遗留 (b))
*/
'x-principal'?: { pool: string }
}
export interface FormSchema {
@@ -113,11 +137,12 @@ export interface FormSchema {
/**
* 前后端同一种错误格式(服务端 apps/spec.FORM_ERROR_CODES)。file:文件控件的值不是上传后拿回的引用、类型或大小不合
* x-file 的限制,或提交时核对引用没过(不是这个人传的、已经用过)
* x-file 的限制,或提交时核对引用没过(不是这个人传的、已经用过);principal:开了登录时选人控件的值不在候选池里
* (服务端 auth/directory.principal_errors,05-已知遗留 (b))
*/
export interface FormError {
path: string
code: 'required' | 'type' | 'enum' | 'minimum' | 'maximum' | 'min_length' | 'max_length' | 'max_items' | 'format' | 'file'
code: 'required' | 'type' | 'enum' | 'minimum' | 'maximum' | 'min_length' | 'max_length' | 'max_items' | 'format' | 'file' | 'principal'
message: string
}