openxiangda-skill-kit 2.3.90 → 2.3.92
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +2 -2
- package/skills/openxiangda-v2/SKILL.md +1 -0
- package/skills/openxiangda-v2/references/administration.md +3 -0
- package/skills/openxiangda-v2/references/application-operations.md +150 -0
- package/skills/openxiangda-v2/references/appspec.md +1 -1
- package/skills/openxiangda-v2/references/cli.md +1 -1
- package/skills/openxiangda-v2/references/mcp.md +1120 -0
- package/skills/openxiangda-v2/references/workflow-events.md +23 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openxiangda-skill-kit",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.92",
|
|
4
4
|
"description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"README.md"
|
|
18
18
|
],
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"openxiangda-devkit-core": "2.
|
|
20
|
+
"openxiangda-devkit-core": "2.53.1"
|
|
21
21
|
},
|
|
22
22
|
"devDependencies": {
|
|
23
23
|
"tsx": "4.23.12",
|
|
@@ -77,6 +77,7 @@ pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ skill install --force
|
|
|
77
77
|
| 热点读取、抢票、排队、名额预占与原结果恢复 | [缓存、排队与配额](references/managed-concurrency.md) |
|
|
78
78
|
| 报名按钮、表单排队、短确认页、预占倒计时与前端恢复 | [并发前端接入](references/managed-concurrency-frontend.md)：按六种形式选择；仅使用已导出的 API，区分待实现封装 |
|
|
79
79
|
| 管理成员或查看有效流程参数 | [应用管理](references/administration.md) |
|
|
80
|
+
| 高水位/死信、正式环境缺密钥、通知未发送或收件人错误 | [AI 应用自助操作](references/application-operations.md)；先读 `admin operations --json` 或 MCP `application_operations`，在已有授权范围内直接执行，沿用当前平台账号，无需人工打开管理页 |
|
|
80
81
|
| 检查、部署、生产发布与故障恢复 | [验收](references/testing.md)、[交付](references/delivery.md) |
|
|
81
82
|
| 需求记录与版本升级 | [全流程记录](references/appspec.md)、[升级](references/upgrading.md) |
|
|
82
83
|
| 选择 CLI/MCP 操作 | [命令](references/cli.md)、[MCP](references/mcp.md) |
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
# 应用管理与有效配置
|
|
2
2
|
|
|
3
|
+
事件高水位、正式环境缺凭据或消息未发送时，开发者AI直接读取[应用自助操作](application-operations.md)
|
|
4
|
+
并使用 `admin operations` / MCP `application_operations` 发现和执行已有管理能力，无需人工管理页面。
|
|
5
|
+
|
|
3
6
|
平台的应用管理控制台维护应用成员、角色授权和流程运行参数。应用自身声明的 `/admin` 业务菜单展示业务页面，两者职责不同。可见入口和可执行操作以当前用户与目标环境返回结果为准。
|
|
4
7
|
|
|
5
8
|
角色成员的范围维度也支持模型字段的 `userCandidates.scope` 引用，不要求为审批人职责增加无关的数据读写策略。目录 `scopeDimensions[].applicability.candidateFields` 返回字段所在的资源、数据修订、字段、角色与操作；当前环境及仍在办理的历史流程所引用的字段均可贡献范围适用性。实例完成或发起命令取消后，旧字段不再单独贡献适用性。配置成员的范围不会自动授予数据读写、菜单或应用管理权限；实际选人与提交仍核验范围、操作、成员有效期及账号状态。
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
# AI 应用运行自助操作
|
|
2
|
+
|
|
3
|
+
开发者 AI 使用当前平台账号和工作区绑定直接完成事件、环境凭据和消息中心维护。
|
|
4
|
+
用户已授权的诊断及修复无需再让用户点击管理页面。平台仍核验已有应用管理权限；
|
|
5
|
+
首次账号登录沿用原认证流程，开发者身份不自动获得管理员权限。
|
|
6
|
+
|
|
7
|
+
## 发现和执行 {#discovery}
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
pnpm openxiangda context --json
|
|
11
|
+
pnpm openxiangda admin context --environment production --json
|
|
12
|
+
pnpm openxiangda admin operations --json
|
|
13
|
+
pnpm openxiangda docs application-operations
|
|
14
|
+
printf '%s' '{}' | pnpm openxiangda admin execute events.status --environment production --input - --json
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
`admin operations` 读取本地目录，每项给出 `operation/inputSchema/effect/permission/recovery`。
|
|
18
|
+
`admin execute <operation> --environment <test|production> --input <file|-> --json` 直接执行。
|
|
19
|
+
输入文件或标准输入只放目录中的 **input** 对象，最多32KiB，不放密码。
|
|
20
|
+
执行必须明确环境；test映射平台preproduction。应用、站点和身份来自当前工作区及会话，
|
|
21
|
+
拒绝任意路径、自报appCode、tenantId、actor和environmentKey。
|
|
22
|
+
|
|
23
|
+
MCP先调用 `application_operations`，再调用 `application_operation`：
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{"operation":"events.status","environment":"production","input":{}}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
CLI与MCP共用输入Schema、服务和平台错误。成功结果在 `data.result`，环境在 `data.environment`。
|
|
30
|
+
配置与恢复在已授权范围内直接执行；health访问外部健康接口并保存元信息。
|
|
31
|
+
操作目录不证明远端接口已部署或当前用户有权，执行结果由平台决定。
|
|
32
|
+
|
|
33
|
+
## 事件高水位与指定恢复 {#events}
|
|
34
|
+
|
|
35
|
+
遇到 `EVENT_V2_BACKPRESSURE_HIGH_WATER` 先读 `events.status` 的admission：采样新鲜度、
|
|
36
|
+
触发条件、当前值、阈值、恢复条件和消费者健康。再用 `events.subscriptions`、
|
|
37
|
+
`events.deliveries`、`events.journal`、`events.audit` 定位订阅、原事实及投递。
|
|
38
|
+
分页默认20/最大100，按服务器cursor继续，不无限遍历历史。
|
|
39
|
+
按原requestId或commandId核对事务，见[部署与诊断](delivery.md)。未观测到、超时或503
|
|
40
|
+
不能证明未提交，不换键重建业务数据。
|
|
41
|
+
|
|
42
|
+
Native记录事件才能使用 `ordering:record`。订阅错误先修正应用声明并正常部署，
|
|
43
|
+
再用 `events.replay` 恢复指定原deliveryId：
|
|
44
|
+
|
|
45
|
+
```json
|
|
46
|
+
{
|
|
47
|
+
"deliveryId":"11111111-1111-4111-8111-111111111111",
|
|
48
|
+
"reason":"原订阅配置已修复并部署，恢复该投递",
|
|
49
|
+
"idempotencyKey":"event-recovery:original-operation-id",
|
|
50
|
+
"useCurrentSubscription":true
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
示例UUID换成实际查询结果。false使用原订阅规格，必须显式选择。
|
|
55
|
+
平台核对类型、过滤和排序事实，只恢复该订阅投递并保留历史审计，不重建会员。
|
|
56
|
+
未知结果先查投递/审计，保留同键同请求。低于阈值且取得新鲜采样后自动恢复写入；
|
|
57
|
+
没有清队列或提高容量阈值的应用操作。验证单笔事务回执及列表后再继续授权导入。
|
|
58
|
+
|
|
59
|
+
## 环境凭据复用 {#secrets}
|
|
60
|
+
|
|
61
|
+
遇到 `APPLICATION_V2_SECRET_NOT_CONFIGURED`，分别在test及production执行 `secrets.list`。
|
|
62
|
+
只返回名称、状态、revision、hasValue和有效期等元信息。来源用途已经验证且有效时，
|
|
63
|
+
在目标production执行 `secrets.copy`，首次正式部署前也可操作，无需询问或读取明文：
|
|
64
|
+
|
|
65
|
+
```json
|
|
66
|
+
{
|
|
67
|
+
"sourceEnvironment":"test",
|
|
68
|
+
"reason":"正式环境复用已验证的集成凭据",
|
|
69
|
+
"idempotencyKey":"secret-copy:original-operation-id",
|
|
70
|
+
"secrets":[{"name":"integration-client-secret","sourceRevision":3,"expectedRevision":0}]
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
名称和修订取自两侧实时列表；目标不存在用0，覆盖用目标实际revision。最多50个唯一名称，
|
|
75
|
+
同应用跨环境原子复制，任一冲突拒绝整批。目标拥有独立加密版本，来源轮换不自动覆盖。
|
|
76
|
+
未知结果保留原键和完整请求，先回读，必要时显式同键重试。确认的409先刷新两侧基准、
|
|
77
|
+
核对后形成新操作，不能只递增revision强行覆盖。
|
|
78
|
+
随后执行 `deploy --environment production --from <成功测试运行ID> --dry-run`。
|
|
79
|
+
环境变量注入需新部署才读取目标版本；动态Secret服务沿用原读取规则。
|
|
80
|
+
工具不会自动复制所有项；测试凭据是否适用于真实生产由已确认的集成用途决定。
|
|
81
|
+
|
|
82
|
+
## 通知渠道与默认路由 {#channels}
|
|
83
|
+
|
|
84
|
+
先读 `notifications.diagnostics/channels/rules`。缺少标准模板/规则时执行
|
|
85
|
+
`notifications.bootstrap` 再回读。已有健康渠道可直接选默认，不必重新配置或获取密码。
|
|
86
|
+
新增/更新分别用 `notifications.configure-external-http` 和 `notifications.configure-dingtalk-oa`。
|
|
87
|
+
完整参数见目录inputSchema；新渠道revision用0，更新用实时revision。配置只接受Secret引用，
|
|
88
|
+
不接受token、明文clientSecret或收件身份。External HTTP支持HMAC、OAuth2客户端凭据和mTLS。
|
|
89
|
+
正式启用沿用服务器 `confirmProduction:true`，表示该请求明确选择正式环境，无需管理页。
|
|
90
|
+
|
|
91
|
+
以下仅演示结构，真实providerCode、baseUrl、identityRealm、功能和Secret引用来自已授权集成，
|
|
92
|
+
不能直接把示例地址发送到生产：
|
|
93
|
+
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"bindingCode":"organization.default","expectedRevision":0,"status":"active","confirmProduction":true,
|
|
97
|
+
"config":{
|
|
98
|
+
"schemaVersion":"openxiangda.notification.external-http-channel/v2",
|
|
99
|
+
"providerCode":"organization","baseUrl":"https://notify.example.com","identityRealm":"organization",
|
|
100
|
+
"auth":{"mode":"HMAC_SHA256","keyId":"primary","secretRef":"notification-hmac"},
|
|
101
|
+
"callback":{"enabled":false,"maxSkewSeconds":300,"actionTokenTtlMinutes":60},
|
|
102
|
+
"features":{"interactiveActions":false,"readReceipt":false,"todoSemantics":true},
|
|
103
|
+
"requestTimeoutMs":10000
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
配置后执行 `notifications.test`：
|
|
109
|
+
|
|
110
|
+
```json
|
|
111
|
+
{"bindingCode":"organization.default","channel":"external-http"}
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
这是协议/凭据健康检查，不发实际收件通知。随后执行 `notifications.set-default`：
|
|
115
|
+
|
|
116
|
+
```json
|
|
117
|
+
{"bindingCode":"organization.default","expectedRevision":2,"expectedBindingRevision":1}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
两个revision分别来自workflow.standard规则和渠道。冲突先回读核对。默认只影响当前环境
|
|
121
|
+
的标准工作流通知；自定义规则仍由原owner维护。正式隐式路由不选Fake，Fake成功只证明模拟。
|
|
122
|
+
|
|
123
|
+
## 原通知失败与恢复 {#notification-recovery}
|
|
124
|
+
|
|
125
|
+
`notifications.messages` 按correlationId或recipientUserId查原消息，默认20/最大100；
|
|
126
|
+
`notifications.message` 传原messageId，读取recipients/deliveries/attempts/审计。
|
|
127
|
+
平台受理、渠道发送、已读和待办关闭分别核对，不能把受理当成老师已经收到。
|
|
128
|
+
|
|
129
|
+
| 证据 | AI下一步 |
|
|
130
|
+
| --- | --- |
|
|
131
|
+
| 凭据缺失/禁用/过期 | secrets.list核对；用途合适时secrets.copy，随后test |
|
|
132
|
+
| 默认未设置或规则缺少 | rules/channels核对，必要时bootstrap，再set-default |
|
|
133
|
+
| 通道协议或联通失败 | 核对原集成接口、鉴权引用和功能，configure修正后test |
|
|
134
|
+
| RECIPIENT_CHANNEL_IDENTITY_NOT_FOUND | 核对目标平台用户及identityRealm对应外部账号；由现有身份目录/消息服务owner维护映射，不创建虚假老师身份 |
|
|
135
|
+
| 共享队列、数据库或网络故障 | 保存requestId、环境、消息/投递ID及状态证据，交给平台基础设施owner |
|
|
136
|
+
| 403权限不足 | 由应用管理员授予已有管理权限，不获取服务器root或密码替代 |
|
|
137
|
+
| 404新接口不存在 | 核对工具及平台版本，升级对应能力，不用临时SQL绕过 |
|
|
138
|
+
|
|
139
|
+
修复后查 `notifications.dead-letters`，可按messageId限定。确认原任务仍有效且授权包括
|
|
140
|
+
实际通知恢复，再执行 `notifications.replay`，只传指定deadLetterId。这可能真正发送通知。
|
|
141
|
+
平台保留原消息、目标和审计；不重建通知或批量恢复历史待办。
|
|
142
|
+
网络中断后查询原死信/消息；已恢复后的404不能当成未执行，不自动连续重放。
|
|
143
|
+
已投递或被新修订取代的消息遵守服务器原有规则。
|
|
144
|
+
|
|
145
|
+
## 升级与验收 {#verification}
|
|
146
|
+
|
|
147
|
+
已有项目使用精确锁定版本；升级后运行 `skill install --workspace <应用目录> --force` 并
|
|
148
|
+
重启MCP。应用AI不需要本地平台、数据库、Docker或学校服务器账号。
|
|
149
|
+
先做只读诊断、无实际收件人的健康测试及CAS拒绝验证，再验收单笔回执/落库/实际投递。
|
|
150
|
+
不要用批量导入或历史群发测试恢复。首次会话授权、权限委托和外部身份owner边界沿用原合同。
|
|
@@ -172,7 +172,7 @@ ADR 状态支持 `proposed`、`accepted`、`superseded`、`rejected`；按真实
|
|
|
172
172
|
|
|
173
173
|
### 按 ID 读取
|
|
174
174
|
|
|
175
|
-
`context` / `workspace_context` 默认返回总纲、相关变更索引、阶段缺口和下一步。`spec context` / `appspec_context` 的 context v4 默认只返回总纲正文及有界索引，按稳定 ID 加载相关能力、变更、ADR 和 DES-* 设计正文及 documents 传递引用。product/experience/design/reviews 的单层 Markdown 也进入当前资料与原测试提交读取；非 Markdown 原型只引用不执行。当前资料最多
|
|
175
|
+
`context` / `workspace_context` 默认返回总纲、相关变更索引、阶段缺口和下一步。`spec context` / `appspec_context` 的 context v4 默认只返回总纲正文及有界索引，按稳定 ID 加载相关能力、变更、ADR 和 DES-* 设计正文及 documents 传递引用。product/experience/design/reviews 的单层 Markdown 也进入当前资料与原测试提交读取；非 Markdown 原型只引用不执行。当前资料最多 512 文件、2 MiB，正文上下文最多 256 KiB，超出时明确诊断。较大的应用可保留各批次的产品、架构、变更与评审，不需要删除历史来容纳新模块；增加文件数量不放宽字节或上下文预算。
|
|
176
176
|
|
|
177
177
|
历史与当前资料独立预算，每页 50 条，使用 `--history-offset 50` 或 MCP `historyOffset` 翻页。历史索引仅读取头部，稳定历史 ID 可直接读取页外正文；归档增加不会挤掉当前资料。索引读取上限为 256 个年份目录、10 万个记录名和 5 秒，达到预算给出提示，文件不会删除。`workspaceDigest` 对应当前资料与实时契约，分页不改变它；`selectionDigest` 对应选中的具体正文与契约。
|
|
178
178
|
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
| `pnpm openxiangda auth` | 只读 | 只读核验指定平台授权，不登录或刷新会话 |
|
|
8
8
|
| `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
|
|
9
9
|
| `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
|
|
10
|
-
| `pnpm openxiangda admin` |
|
|
10
|
+
| `pnpm openxiangda admin` | 远端变更 | 查看管理能力、自助操作契约，或按明确环境执行事件、密钥及通知操作 |
|
|
11
11
|
| `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
|
|
12
12
|
| `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |
|
|
13
13
|
| `pnpm openxiangda dev` | 本地写入 | 连接平台测试数据启动本地 Web，按需启动 Nest |
|
|
@@ -236,6 +236,1126 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
|
|
|
236
236
|
}
|
|
237
237
|
```
|
|
238
238
|
|
|
239
|
+
## application_operations
|
|
240
|
+
|
|
241
|
+
发现应用运行自助操作。读取事件诊断与指定投递恢复、加密环境凭据复用、通知渠道配置/默认/健康/失败恢复的有界操作目录和输入 Schema。无需管理页面；沿用当前应用权限。
|
|
242
|
+
|
|
243
|
+
- 只读：是
|
|
244
|
+
- 可替换文件或改变远端状态：否
|
|
245
|
+
- 幂等：否
|
|
246
|
+
|
|
247
|
+
输入参数：
|
|
248
|
+
|
|
249
|
+
```json
|
|
250
|
+
{
|
|
251
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
252
|
+
"type": "object",
|
|
253
|
+
"properties": {},
|
|
254
|
+
"additionalProperties": false
|
|
255
|
+
}
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
## application_operation
|
|
259
|
+
|
|
260
|
+
执行应用运行自助操作。先读 application_operations 或 docs_read(application-operations)，在用户已授权范围内执行。environment 必须明确。每种操作严格校验 input，拒绝自报身份及任意 API。密钥复制只接受名称和修订，恢复只接受指定原投递；结果未知先查原证据，不自动批量重试。读操作无副作用，配置有 CAS；健康写入诊断元数据，通知恢复可能实际发送。
|
|
261
|
+
|
|
262
|
+
- 只读：否
|
|
263
|
+
- 可替换文件或改变远端状态：是
|
|
264
|
+
- 幂等：否
|
|
265
|
+
|
|
266
|
+
输入参数：
|
|
267
|
+
|
|
268
|
+
```json
|
|
269
|
+
{
|
|
270
|
+
"type": "object",
|
|
271
|
+
"oneOf": [
|
|
272
|
+
{
|
|
273
|
+
"type": "object",
|
|
274
|
+
"additionalProperties": false,
|
|
275
|
+
"properties": {
|
|
276
|
+
"operation": {
|
|
277
|
+
"const": "events.status",
|
|
278
|
+
"description": "读取队列积压、消费者健康、写入保护阈值和恢复条件"
|
|
279
|
+
},
|
|
280
|
+
"environment": {
|
|
281
|
+
"type": "string",
|
|
282
|
+
"enum": [
|
|
283
|
+
"test",
|
|
284
|
+
"production"
|
|
285
|
+
]
|
|
286
|
+
},
|
|
287
|
+
"input": {
|
|
288
|
+
"type": "object",
|
|
289
|
+
"additionalProperties": false,
|
|
290
|
+
"properties": {},
|
|
291
|
+
"required": []
|
|
292
|
+
}
|
|
293
|
+
},
|
|
294
|
+
"required": [
|
|
295
|
+
"operation",
|
|
296
|
+
"environment",
|
|
297
|
+
"input"
|
|
298
|
+
]
|
|
299
|
+
},
|
|
300
|
+
{
|
|
301
|
+
"type": "object",
|
|
302
|
+
"additionalProperties": false,
|
|
303
|
+
"properties": {
|
|
304
|
+
"operation": {
|
|
305
|
+
"const": "events.subscriptions",
|
|
306
|
+
"description": "读取当前环境订阅及配置修订"
|
|
307
|
+
},
|
|
308
|
+
"environment": {
|
|
309
|
+
"type": "string",
|
|
310
|
+
"enum": [
|
|
311
|
+
"test",
|
|
312
|
+
"production"
|
|
313
|
+
]
|
|
314
|
+
},
|
|
315
|
+
"input": {
|
|
316
|
+
"type": "object",
|
|
317
|
+
"additionalProperties": false,
|
|
318
|
+
"properties": {},
|
|
319
|
+
"required": []
|
|
320
|
+
}
|
|
321
|
+
},
|
|
322
|
+
"required": [
|
|
323
|
+
"operation",
|
|
324
|
+
"environment",
|
|
325
|
+
"input"
|
|
326
|
+
]
|
|
327
|
+
},
|
|
328
|
+
{
|
|
329
|
+
"type": "object",
|
|
330
|
+
"additionalProperties": false,
|
|
331
|
+
"properties": {
|
|
332
|
+
"operation": {
|
|
333
|
+
"const": "events.deliveries",
|
|
334
|
+
"description": "分页读取投递、失败重试和死信"
|
|
335
|
+
},
|
|
336
|
+
"environment": {
|
|
337
|
+
"type": "string",
|
|
338
|
+
"enum": [
|
|
339
|
+
"test",
|
|
340
|
+
"production"
|
|
341
|
+
]
|
|
342
|
+
},
|
|
343
|
+
"input": {
|
|
344
|
+
"type": "object",
|
|
345
|
+
"additionalProperties": false,
|
|
346
|
+
"properties": {
|
|
347
|
+
"limit": {
|
|
348
|
+
"type": "integer",
|
|
349
|
+
"minimum": 1,
|
|
350
|
+
"maximum": 100
|
|
351
|
+
},
|
|
352
|
+
"cursor": {
|
|
353
|
+
"type": "string",
|
|
354
|
+
"minLength": 1,
|
|
355
|
+
"maxLength": 2048
|
|
356
|
+
},
|
|
357
|
+
"from": {
|
|
358
|
+
"type": "string",
|
|
359
|
+
"minLength": 1,
|
|
360
|
+
"maxLength": 40
|
|
361
|
+
},
|
|
362
|
+
"to": {
|
|
363
|
+
"type": "string",
|
|
364
|
+
"minLength": 1,
|
|
365
|
+
"maxLength": 40
|
|
366
|
+
}
|
|
367
|
+
},
|
|
368
|
+
"required": []
|
|
369
|
+
}
|
|
370
|
+
},
|
|
371
|
+
"required": [
|
|
372
|
+
"operation",
|
|
373
|
+
"environment",
|
|
374
|
+
"input"
|
|
375
|
+
]
|
|
376
|
+
},
|
|
377
|
+
{
|
|
378
|
+
"type": "object",
|
|
379
|
+
"additionalProperties": false,
|
|
380
|
+
"properties": {
|
|
381
|
+
"operation": {
|
|
382
|
+
"const": "events.journal",
|
|
383
|
+
"description": "分页读取不可变事件日志"
|
|
384
|
+
},
|
|
385
|
+
"environment": {
|
|
386
|
+
"type": "string",
|
|
387
|
+
"enum": [
|
|
388
|
+
"test",
|
|
389
|
+
"production"
|
|
390
|
+
]
|
|
391
|
+
},
|
|
392
|
+
"input": {
|
|
393
|
+
"type": "object",
|
|
394
|
+
"additionalProperties": false,
|
|
395
|
+
"properties": {
|
|
396
|
+
"limit": {
|
|
397
|
+
"type": "integer",
|
|
398
|
+
"minimum": 1,
|
|
399
|
+
"maximum": 100
|
|
400
|
+
},
|
|
401
|
+
"cursor": {
|
|
402
|
+
"type": "string",
|
|
403
|
+
"minLength": 1,
|
|
404
|
+
"maxLength": 2048
|
|
405
|
+
},
|
|
406
|
+
"from": {
|
|
407
|
+
"type": "string",
|
|
408
|
+
"minLength": 1,
|
|
409
|
+
"maxLength": 40
|
|
410
|
+
},
|
|
411
|
+
"to": {
|
|
412
|
+
"type": "string",
|
|
413
|
+
"minLength": 1,
|
|
414
|
+
"maxLength": 40
|
|
415
|
+
}
|
|
416
|
+
},
|
|
417
|
+
"required": []
|
|
418
|
+
}
|
|
419
|
+
},
|
|
420
|
+
"required": [
|
|
421
|
+
"operation",
|
|
422
|
+
"environment",
|
|
423
|
+
"input"
|
|
424
|
+
]
|
|
425
|
+
},
|
|
426
|
+
{
|
|
427
|
+
"type": "object",
|
|
428
|
+
"additionalProperties": false,
|
|
429
|
+
"properties": {
|
|
430
|
+
"operation": {
|
|
431
|
+
"const": "events.audit",
|
|
432
|
+
"description": "分页读取事件恢复操作审计"
|
|
433
|
+
},
|
|
434
|
+
"environment": {
|
|
435
|
+
"type": "string",
|
|
436
|
+
"enum": [
|
|
437
|
+
"test",
|
|
438
|
+
"production"
|
|
439
|
+
]
|
|
440
|
+
},
|
|
441
|
+
"input": {
|
|
442
|
+
"type": "object",
|
|
443
|
+
"additionalProperties": false,
|
|
444
|
+
"properties": {
|
|
445
|
+
"limit": {
|
|
446
|
+
"type": "integer",
|
|
447
|
+
"minimum": 1,
|
|
448
|
+
"maximum": 100
|
|
449
|
+
},
|
|
450
|
+
"cursor": {
|
|
451
|
+
"type": "string",
|
|
452
|
+
"minLength": 1,
|
|
453
|
+
"maxLength": 2048
|
|
454
|
+
}
|
|
455
|
+
},
|
|
456
|
+
"required": []
|
|
457
|
+
}
|
|
458
|
+
},
|
|
459
|
+
"required": [
|
|
460
|
+
"operation",
|
|
461
|
+
"environment",
|
|
462
|
+
"input"
|
|
463
|
+
]
|
|
464
|
+
},
|
|
465
|
+
{
|
|
466
|
+
"type": "object",
|
|
467
|
+
"additionalProperties": false,
|
|
468
|
+
"properties": {
|
|
469
|
+
"operation": {
|
|
470
|
+
"const": "events.replay",
|
|
471
|
+
"description": "恢复指定原投递；可显式选择已修复的当前订阅"
|
|
472
|
+
},
|
|
473
|
+
"environment": {
|
|
474
|
+
"type": "string",
|
|
475
|
+
"enum": [
|
|
476
|
+
"test",
|
|
477
|
+
"production"
|
|
478
|
+
]
|
|
479
|
+
},
|
|
480
|
+
"input": {
|
|
481
|
+
"type": "object",
|
|
482
|
+
"additionalProperties": false,
|
|
483
|
+
"properties": {
|
|
484
|
+
"deliveryId": {
|
|
485
|
+
"type": "string",
|
|
486
|
+
"minLength": 1,
|
|
487
|
+
"maxLength": 36,
|
|
488
|
+
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
|
|
489
|
+
},
|
|
490
|
+
"reason": {
|
|
491
|
+
"type": "string",
|
|
492
|
+
"minLength": 1,
|
|
493
|
+
"maxLength": 500,
|
|
494
|
+
"description": "操作原因；保留到平台审计"
|
|
495
|
+
},
|
|
496
|
+
"idempotencyKey": {
|
|
497
|
+
"type": "string",
|
|
498
|
+
"minLength": 1,
|
|
499
|
+
"maxLength": 128,
|
|
500
|
+
"description": "同一次操作及未知结果重试保持原键和完整请求"
|
|
501
|
+
},
|
|
502
|
+
"useCurrentSubscription": {
|
|
503
|
+
"type": "boolean"
|
|
504
|
+
}
|
|
505
|
+
},
|
|
506
|
+
"required": [
|
|
507
|
+
"deliveryId",
|
|
508
|
+
"reason",
|
|
509
|
+
"idempotencyKey",
|
|
510
|
+
"useCurrentSubscription"
|
|
511
|
+
]
|
|
512
|
+
}
|
|
513
|
+
},
|
|
514
|
+
"required": [
|
|
515
|
+
"operation",
|
|
516
|
+
"environment",
|
|
517
|
+
"input"
|
|
518
|
+
]
|
|
519
|
+
},
|
|
520
|
+
{
|
|
521
|
+
"type": "object",
|
|
522
|
+
"additionalProperties": false,
|
|
523
|
+
"properties": {
|
|
524
|
+
"operation": {
|
|
525
|
+
"const": "secrets.list",
|
|
526
|
+
"description": "读取当前环境凭据元信息和修订，不读取明文"
|
|
527
|
+
},
|
|
528
|
+
"environment": {
|
|
529
|
+
"type": "string",
|
|
530
|
+
"enum": [
|
|
531
|
+
"test",
|
|
532
|
+
"production"
|
|
533
|
+
]
|
|
534
|
+
},
|
|
535
|
+
"input": {
|
|
536
|
+
"type": "object",
|
|
537
|
+
"additionalProperties": false,
|
|
538
|
+
"properties": {},
|
|
539
|
+
"required": []
|
|
540
|
+
}
|
|
541
|
+
},
|
|
542
|
+
"required": [
|
|
543
|
+
"operation",
|
|
544
|
+
"environment",
|
|
545
|
+
"input"
|
|
546
|
+
]
|
|
547
|
+
},
|
|
548
|
+
{
|
|
549
|
+
"type": "object",
|
|
550
|
+
"additionalProperties": false,
|
|
551
|
+
"properties": {
|
|
552
|
+
"operation": {
|
|
553
|
+
"const": "secrets.copy",
|
|
554
|
+
"description": "从同应用另一个环境原子复制所选加密凭据"
|
|
555
|
+
},
|
|
556
|
+
"environment": {
|
|
557
|
+
"type": "string",
|
|
558
|
+
"enum": [
|
|
559
|
+
"test",
|
|
560
|
+
"production"
|
|
561
|
+
]
|
|
562
|
+
},
|
|
563
|
+
"input": {
|
|
564
|
+
"type": "object",
|
|
565
|
+
"additionalProperties": false,
|
|
566
|
+
"properties": {
|
|
567
|
+
"sourceEnvironment": {
|
|
568
|
+
"type": "string",
|
|
569
|
+
"enum": [
|
|
570
|
+
"test",
|
|
571
|
+
"production"
|
|
572
|
+
]
|
|
573
|
+
},
|
|
574
|
+
"reason": {
|
|
575
|
+
"type": "string",
|
|
576
|
+
"minLength": 1,
|
|
577
|
+
"maxLength": 500,
|
|
578
|
+
"description": "操作原因；保留到平台审计"
|
|
579
|
+
},
|
|
580
|
+
"idempotencyKey": {
|
|
581
|
+
"type": "string",
|
|
582
|
+
"minLength": 1,
|
|
583
|
+
"maxLength": 128,
|
|
584
|
+
"description": "同一次操作及未知结果重试保持原键和完整请求"
|
|
585
|
+
},
|
|
586
|
+
"secrets": {
|
|
587
|
+
"type": "array",
|
|
588
|
+
"minItems": 1,
|
|
589
|
+
"maxItems": 50,
|
|
590
|
+
"items": {
|
|
591
|
+
"type": "object",
|
|
592
|
+
"additionalProperties": false,
|
|
593
|
+
"properties": {
|
|
594
|
+
"name": {
|
|
595
|
+
"type": "string",
|
|
596
|
+
"minLength": 1,
|
|
597
|
+
"maxLength": 128
|
|
598
|
+
},
|
|
599
|
+
"sourceRevision": {
|
|
600
|
+
"type": "integer",
|
|
601
|
+
"minimum": 1,
|
|
602
|
+
"maximum": 9007199254740991
|
|
603
|
+
},
|
|
604
|
+
"expectedRevision": {
|
|
605
|
+
"type": "integer",
|
|
606
|
+
"minimum": 0,
|
|
607
|
+
"maximum": 9007199254740991
|
|
608
|
+
}
|
|
609
|
+
},
|
|
610
|
+
"required": [
|
|
611
|
+
"name",
|
|
612
|
+
"sourceRevision",
|
|
613
|
+
"expectedRevision"
|
|
614
|
+
]
|
|
615
|
+
}
|
|
616
|
+
}
|
|
617
|
+
},
|
|
618
|
+
"required": [
|
|
619
|
+
"sourceEnvironment",
|
|
620
|
+
"reason",
|
|
621
|
+
"idempotencyKey",
|
|
622
|
+
"secrets"
|
|
623
|
+
]
|
|
624
|
+
}
|
|
625
|
+
},
|
|
626
|
+
"required": [
|
|
627
|
+
"operation",
|
|
628
|
+
"environment",
|
|
629
|
+
"input"
|
|
630
|
+
]
|
|
631
|
+
},
|
|
632
|
+
{
|
|
633
|
+
"type": "object",
|
|
634
|
+
"additionalProperties": false,
|
|
635
|
+
"properties": {
|
|
636
|
+
"operation": {
|
|
637
|
+
"const": "notifications.diagnostics",
|
|
638
|
+
"description": "诊断默认通道、凭据、收件人绑定及失败投递"
|
|
639
|
+
},
|
|
640
|
+
"environment": {
|
|
641
|
+
"type": "string",
|
|
642
|
+
"enum": [
|
|
643
|
+
"test",
|
|
644
|
+
"production"
|
|
645
|
+
]
|
|
646
|
+
},
|
|
647
|
+
"input": {
|
|
648
|
+
"type": "object",
|
|
649
|
+
"additionalProperties": false,
|
|
650
|
+
"properties": {},
|
|
651
|
+
"required": []
|
|
652
|
+
}
|
|
653
|
+
},
|
|
654
|
+
"required": [
|
|
655
|
+
"operation",
|
|
656
|
+
"environment",
|
|
657
|
+
"input"
|
|
658
|
+
]
|
|
659
|
+
},
|
|
660
|
+
{
|
|
661
|
+
"type": "object",
|
|
662
|
+
"additionalProperties": false,
|
|
663
|
+
"properties": {
|
|
664
|
+
"operation": {
|
|
665
|
+
"const": "notifications.channels",
|
|
666
|
+
"description": "读取渠道配置、能力、健康及修订"
|
|
667
|
+
},
|
|
668
|
+
"environment": {
|
|
669
|
+
"type": "string",
|
|
670
|
+
"enum": [
|
|
671
|
+
"test",
|
|
672
|
+
"production"
|
|
673
|
+
]
|
|
674
|
+
},
|
|
675
|
+
"input": {
|
|
676
|
+
"type": "object",
|
|
677
|
+
"additionalProperties": false,
|
|
678
|
+
"properties": {},
|
|
679
|
+
"required": []
|
|
680
|
+
}
|
|
681
|
+
},
|
|
682
|
+
"required": [
|
|
683
|
+
"operation",
|
|
684
|
+
"environment",
|
|
685
|
+
"input"
|
|
686
|
+
]
|
|
687
|
+
},
|
|
688
|
+
{
|
|
689
|
+
"type": "object",
|
|
690
|
+
"additionalProperties": false,
|
|
691
|
+
"properties": {
|
|
692
|
+
"operation": {
|
|
693
|
+
"const": "notifications.rules",
|
|
694
|
+
"description": "读取通知规则及修订"
|
|
695
|
+
},
|
|
696
|
+
"environment": {
|
|
697
|
+
"type": "string",
|
|
698
|
+
"enum": [
|
|
699
|
+
"test",
|
|
700
|
+
"production"
|
|
701
|
+
]
|
|
702
|
+
},
|
|
703
|
+
"input": {
|
|
704
|
+
"type": "object",
|
|
705
|
+
"additionalProperties": false,
|
|
706
|
+
"properties": {},
|
|
707
|
+
"required": []
|
|
708
|
+
}
|
|
709
|
+
},
|
|
710
|
+
"required": [
|
|
711
|
+
"operation",
|
|
712
|
+
"environment",
|
|
713
|
+
"input"
|
|
714
|
+
]
|
|
715
|
+
},
|
|
716
|
+
{
|
|
717
|
+
"type": "object",
|
|
718
|
+
"additionalProperties": false,
|
|
719
|
+
"properties": {
|
|
720
|
+
"operation": {
|
|
721
|
+
"const": "notifications.bootstrap",
|
|
722
|
+
"description": "初始化缺少的标准通知模板和规则"
|
|
723
|
+
},
|
|
724
|
+
"environment": {
|
|
725
|
+
"type": "string",
|
|
726
|
+
"enum": [
|
|
727
|
+
"test",
|
|
728
|
+
"production"
|
|
729
|
+
]
|
|
730
|
+
},
|
|
731
|
+
"input": {
|
|
732
|
+
"type": "object",
|
|
733
|
+
"additionalProperties": false,
|
|
734
|
+
"properties": {},
|
|
735
|
+
"required": []
|
|
736
|
+
}
|
|
737
|
+
},
|
|
738
|
+
"required": [
|
|
739
|
+
"operation",
|
|
740
|
+
"environment",
|
|
741
|
+
"input"
|
|
742
|
+
]
|
|
743
|
+
},
|
|
744
|
+
{
|
|
745
|
+
"type": "object",
|
|
746
|
+
"additionalProperties": false,
|
|
747
|
+
"properties": {
|
|
748
|
+
"operation": {
|
|
749
|
+
"const": "notifications.configure-external-http",
|
|
750
|
+
"description": "配置 External HTTP 通道；鉴权仅接受 Secret 引用"
|
|
751
|
+
},
|
|
752
|
+
"environment": {
|
|
753
|
+
"type": "string",
|
|
754
|
+
"enum": [
|
|
755
|
+
"test",
|
|
756
|
+
"production"
|
|
757
|
+
]
|
|
758
|
+
},
|
|
759
|
+
"input": {
|
|
760
|
+
"type": "object",
|
|
761
|
+
"additionalProperties": false,
|
|
762
|
+
"properties": {
|
|
763
|
+
"bindingCode": {
|
|
764
|
+
"type": "string",
|
|
765
|
+
"minLength": 1,
|
|
766
|
+
"maxLength": 128
|
|
767
|
+
},
|
|
768
|
+
"expectedRevision": {
|
|
769
|
+
"type": "integer",
|
|
770
|
+
"minimum": 0,
|
|
771
|
+
"maximum": 9007199254740991
|
|
772
|
+
},
|
|
773
|
+
"status": {
|
|
774
|
+
"type": "string",
|
|
775
|
+
"enum": [
|
|
776
|
+
"active",
|
|
777
|
+
"paused"
|
|
778
|
+
]
|
|
779
|
+
},
|
|
780
|
+
"confirmProduction": {
|
|
781
|
+
"type": "boolean"
|
|
782
|
+
},
|
|
783
|
+
"config": {
|
|
784
|
+
"type": "object",
|
|
785
|
+
"additionalProperties": false,
|
|
786
|
+
"properties": {
|
|
787
|
+
"schemaVersion": {
|
|
788
|
+
"const": "openxiangda.notification.external-http-channel/v2"
|
|
789
|
+
},
|
|
790
|
+
"providerCode": {
|
|
791
|
+
"type": "string",
|
|
792
|
+
"minLength": 1,
|
|
793
|
+
"maxLength": 128
|
|
794
|
+
},
|
|
795
|
+
"baseUrl": {
|
|
796
|
+
"type": "string",
|
|
797
|
+
"minLength": 1,
|
|
798
|
+
"maxLength": 2048
|
|
799
|
+
},
|
|
800
|
+
"identityRealm": {
|
|
801
|
+
"type": "string",
|
|
802
|
+
"minLength": 1,
|
|
803
|
+
"maxLength": 255
|
|
804
|
+
},
|
|
805
|
+
"auth": {
|
|
806
|
+
"oneOf": [
|
|
807
|
+
{
|
|
808
|
+
"type": "object",
|
|
809
|
+
"additionalProperties": false,
|
|
810
|
+
"properties": {
|
|
811
|
+
"mode": {
|
|
812
|
+
"const": "HMAC_SHA256"
|
|
813
|
+
},
|
|
814
|
+
"keyId": {
|
|
815
|
+
"type": "string",
|
|
816
|
+
"minLength": 1,
|
|
817
|
+
"maxLength": 128
|
|
818
|
+
},
|
|
819
|
+
"secretRef": {
|
|
820
|
+
"type": "string",
|
|
821
|
+
"minLength": 1,
|
|
822
|
+
"maxLength": 128
|
|
823
|
+
}
|
|
824
|
+
},
|
|
825
|
+
"required": [
|
|
826
|
+
"mode",
|
|
827
|
+
"keyId",
|
|
828
|
+
"secretRef"
|
|
829
|
+
]
|
|
830
|
+
},
|
|
831
|
+
{
|
|
832
|
+
"type": "object",
|
|
833
|
+
"additionalProperties": false,
|
|
834
|
+
"properties": {
|
|
835
|
+
"mode": {
|
|
836
|
+
"const": "OAUTH2_CLIENT_CREDENTIALS"
|
|
837
|
+
},
|
|
838
|
+
"tokenUrl": {
|
|
839
|
+
"type": "string",
|
|
840
|
+
"minLength": 1,
|
|
841
|
+
"maxLength": 2048
|
|
842
|
+
},
|
|
843
|
+
"clientIdSecretRef": {
|
|
844
|
+
"type": "string",
|
|
845
|
+
"minLength": 1,
|
|
846
|
+
"maxLength": 128
|
|
847
|
+
},
|
|
848
|
+
"clientSecretSecretRef": {
|
|
849
|
+
"type": "string",
|
|
850
|
+
"minLength": 1,
|
|
851
|
+
"maxLength": 128
|
|
852
|
+
},
|
|
853
|
+
"scope": {
|
|
854
|
+
"type": "string",
|
|
855
|
+
"minLength": 1,
|
|
856
|
+
"maxLength": 500
|
|
857
|
+
},
|
|
858
|
+
"audience": {
|
|
859
|
+
"type": "string",
|
|
860
|
+
"minLength": 1,
|
|
861
|
+
"maxLength": 500
|
|
862
|
+
}
|
|
863
|
+
},
|
|
864
|
+
"required": [
|
|
865
|
+
"mode",
|
|
866
|
+
"tokenUrl",
|
|
867
|
+
"clientIdSecretRef",
|
|
868
|
+
"clientSecretSecretRef"
|
|
869
|
+
]
|
|
870
|
+
},
|
|
871
|
+
{
|
|
872
|
+
"type": "object",
|
|
873
|
+
"additionalProperties": false,
|
|
874
|
+
"properties": {
|
|
875
|
+
"mode": {
|
|
876
|
+
"const": "MTLS"
|
|
877
|
+
},
|
|
878
|
+
"certSecretRef": {
|
|
879
|
+
"type": "string",
|
|
880
|
+
"minLength": 1,
|
|
881
|
+
"maxLength": 128
|
|
882
|
+
},
|
|
883
|
+
"keySecretRef": {
|
|
884
|
+
"type": "string",
|
|
885
|
+
"minLength": 1,
|
|
886
|
+
"maxLength": 128
|
|
887
|
+
},
|
|
888
|
+
"caSecretRef": {
|
|
889
|
+
"type": "string",
|
|
890
|
+
"minLength": 1,
|
|
891
|
+
"maxLength": 128
|
|
892
|
+
}
|
|
893
|
+
},
|
|
894
|
+
"required": [
|
|
895
|
+
"mode",
|
|
896
|
+
"certSecretRef",
|
|
897
|
+
"keySecretRef"
|
|
898
|
+
]
|
|
899
|
+
}
|
|
900
|
+
]
|
|
901
|
+
},
|
|
902
|
+
"callback": {
|
|
903
|
+
"type": "object",
|
|
904
|
+
"additionalProperties": false,
|
|
905
|
+
"properties": {
|
|
906
|
+
"enabled": {
|
|
907
|
+
"type": "boolean"
|
|
908
|
+
},
|
|
909
|
+
"hmacKeyId": {
|
|
910
|
+
"type": "string",
|
|
911
|
+
"minLength": 1,
|
|
912
|
+
"maxLength": 128
|
|
913
|
+
},
|
|
914
|
+
"hmacSecretRef": {
|
|
915
|
+
"type": "string",
|
|
916
|
+
"minLength": 1,
|
|
917
|
+
"maxLength": 128
|
|
918
|
+
},
|
|
919
|
+
"maxSkewSeconds": {
|
|
920
|
+
"type": "integer",
|
|
921
|
+
"minimum": 1,
|
|
922
|
+
"maximum": 9007199254740991
|
|
923
|
+
},
|
|
924
|
+
"actionTokenTtlMinutes": {
|
|
925
|
+
"type": "integer",
|
|
926
|
+
"minimum": 1,
|
|
927
|
+
"maximum": 9007199254740991
|
|
928
|
+
}
|
|
929
|
+
},
|
|
930
|
+
"required": [
|
|
931
|
+
"enabled",
|
|
932
|
+
"maxSkewSeconds",
|
|
933
|
+
"actionTokenTtlMinutes"
|
|
934
|
+
]
|
|
935
|
+
},
|
|
936
|
+
"features": {
|
|
937
|
+
"type": "object",
|
|
938
|
+
"additionalProperties": false,
|
|
939
|
+
"properties": {
|
|
940
|
+
"interactiveActions": {
|
|
941
|
+
"type": "boolean"
|
|
942
|
+
},
|
|
943
|
+
"readReceipt": {
|
|
944
|
+
"type": "boolean"
|
|
945
|
+
},
|
|
946
|
+
"todoSemantics": {
|
|
947
|
+
"type": "boolean"
|
|
948
|
+
}
|
|
949
|
+
},
|
|
950
|
+
"required": [
|
|
951
|
+
"interactiveActions",
|
|
952
|
+
"readReceipt",
|
|
953
|
+
"todoSemantics"
|
|
954
|
+
]
|
|
955
|
+
},
|
|
956
|
+
"requestTimeoutMs": {
|
|
957
|
+
"type": "integer",
|
|
958
|
+
"minimum": 1,
|
|
959
|
+
"maximum": 60000
|
|
960
|
+
}
|
|
961
|
+
},
|
|
962
|
+
"required": [
|
|
963
|
+
"schemaVersion",
|
|
964
|
+
"providerCode",
|
|
965
|
+
"baseUrl",
|
|
966
|
+
"identityRealm",
|
|
967
|
+
"auth",
|
|
968
|
+
"callback",
|
|
969
|
+
"features",
|
|
970
|
+
"requestTimeoutMs"
|
|
971
|
+
]
|
|
972
|
+
}
|
|
973
|
+
},
|
|
974
|
+
"required": [
|
|
975
|
+
"bindingCode",
|
|
976
|
+
"expectedRevision",
|
|
977
|
+
"status",
|
|
978
|
+
"config"
|
|
979
|
+
]
|
|
980
|
+
}
|
|
981
|
+
},
|
|
982
|
+
"required": [
|
|
983
|
+
"operation",
|
|
984
|
+
"environment",
|
|
985
|
+
"input"
|
|
986
|
+
]
|
|
987
|
+
},
|
|
988
|
+
{
|
|
989
|
+
"type": "object",
|
|
990
|
+
"additionalProperties": false,
|
|
991
|
+
"properties": {
|
|
992
|
+
"operation": {
|
|
993
|
+
"const": "notifications.configure-dingtalk-oa",
|
|
994
|
+
"description": "配置钉钉 OA 工作通知通道；仅使用 Secret 引用"
|
|
995
|
+
},
|
|
996
|
+
"environment": {
|
|
997
|
+
"type": "string",
|
|
998
|
+
"enum": [
|
|
999
|
+
"test",
|
|
1000
|
+
"production"
|
|
1001
|
+
]
|
|
1002
|
+
},
|
|
1003
|
+
"input": {
|
|
1004
|
+
"type": "object",
|
|
1005
|
+
"additionalProperties": false,
|
|
1006
|
+
"properties": {
|
|
1007
|
+
"bindingCode": {
|
|
1008
|
+
"type": "string",
|
|
1009
|
+
"minLength": 1,
|
|
1010
|
+
"maxLength": 128
|
|
1011
|
+
},
|
|
1012
|
+
"expectedRevision": {
|
|
1013
|
+
"type": "integer",
|
|
1014
|
+
"minimum": 0,
|
|
1015
|
+
"maximum": 9007199254740991
|
|
1016
|
+
},
|
|
1017
|
+
"status": {
|
|
1018
|
+
"type": "string",
|
|
1019
|
+
"enum": [
|
|
1020
|
+
"active",
|
|
1021
|
+
"paused"
|
|
1022
|
+
]
|
|
1023
|
+
},
|
|
1024
|
+
"config": {
|
|
1025
|
+
"type": "object",
|
|
1026
|
+
"additionalProperties": false,
|
|
1027
|
+
"properties": {
|
|
1028
|
+
"schemaVersion": {
|
|
1029
|
+
"const": "openxiangda.notification.dingtalk-work-notice-oa-channel/v2"
|
|
1030
|
+
},
|
|
1031
|
+
"corpId": {
|
|
1032
|
+
"type": "string",
|
|
1033
|
+
"minLength": 1,
|
|
1034
|
+
"maxLength": 255
|
|
1035
|
+
},
|
|
1036
|
+
"agentId": {
|
|
1037
|
+
"type": "string",
|
|
1038
|
+
"minLength": 1,
|
|
1039
|
+
"maxLength": 255
|
|
1040
|
+
},
|
|
1041
|
+
"clientIdSecretRef": {
|
|
1042
|
+
"type": "string",
|
|
1043
|
+
"minLength": 1,
|
|
1044
|
+
"maxLength": 128
|
|
1045
|
+
},
|
|
1046
|
+
"clientSecretSecretRef": {
|
|
1047
|
+
"type": "string",
|
|
1048
|
+
"minLength": 1,
|
|
1049
|
+
"maxLength": 128
|
|
1050
|
+
},
|
|
1051
|
+
"requestTimeoutMs": {
|
|
1052
|
+
"type": "integer",
|
|
1053
|
+
"minimum": 1,
|
|
1054
|
+
"maximum": 60000
|
|
1055
|
+
},
|
|
1056
|
+
"decorationImage": {
|
|
1057
|
+
"type": "string",
|
|
1058
|
+
"enum": [
|
|
1059
|
+
"NONE",
|
|
1060
|
+
"PLATFORM_WORKFLOW"
|
|
1061
|
+
]
|
|
1062
|
+
}
|
|
1063
|
+
},
|
|
1064
|
+
"required": [
|
|
1065
|
+
"schemaVersion",
|
|
1066
|
+
"corpId",
|
|
1067
|
+
"agentId",
|
|
1068
|
+
"clientIdSecretRef",
|
|
1069
|
+
"clientSecretSecretRef",
|
|
1070
|
+
"requestTimeoutMs",
|
|
1071
|
+
"decorationImage"
|
|
1072
|
+
]
|
|
1073
|
+
}
|
|
1074
|
+
},
|
|
1075
|
+
"required": [
|
|
1076
|
+
"bindingCode",
|
|
1077
|
+
"expectedRevision",
|
|
1078
|
+
"status",
|
|
1079
|
+
"config"
|
|
1080
|
+
]
|
|
1081
|
+
}
|
|
1082
|
+
},
|
|
1083
|
+
"required": [
|
|
1084
|
+
"operation",
|
|
1085
|
+
"environment",
|
|
1086
|
+
"input"
|
|
1087
|
+
]
|
|
1088
|
+
},
|
|
1089
|
+
{
|
|
1090
|
+
"type": "object",
|
|
1091
|
+
"additionalProperties": false,
|
|
1092
|
+
"properties": {
|
|
1093
|
+
"operation": {
|
|
1094
|
+
"const": "notifications.test",
|
|
1095
|
+
"description": "检查渠道凭据与外部协议健康；不发送实际收件通知"
|
|
1096
|
+
},
|
|
1097
|
+
"environment": {
|
|
1098
|
+
"type": "string",
|
|
1099
|
+
"enum": [
|
|
1100
|
+
"test",
|
|
1101
|
+
"production"
|
|
1102
|
+
]
|
|
1103
|
+
},
|
|
1104
|
+
"input": {
|
|
1105
|
+
"type": "object",
|
|
1106
|
+
"additionalProperties": false,
|
|
1107
|
+
"properties": {
|
|
1108
|
+
"bindingCode": {
|
|
1109
|
+
"type": "string",
|
|
1110
|
+
"minLength": 1,
|
|
1111
|
+
"maxLength": 128
|
|
1112
|
+
},
|
|
1113
|
+
"channel": {
|
|
1114
|
+
"type": "string",
|
|
1115
|
+
"enum": [
|
|
1116
|
+
"external-http",
|
|
1117
|
+
"dingtalk-work-notice-oa",
|
|
1118
|
+
"dingtalk-card"
|
|
1119
|
+
]
|
|
1120
|
+
}
|
|
1121
|
+
},
|
|
1122
|
+
"required": [
|
|
1123
|
+
"bindingCode",
|
|
1124
|
+
"channel"
|
|
1125
|
+
]
|
|
1126
|
+
}
|
|
1127
|
+
},
|
|
1128
|
+
"required": [
|
|
1129
|
+
"operation",
|
|
1130
|
+
"environment",
|
|
1131
|
+
"input"
|
|
1132
|
+
]
|
|
1133
|
+
},
|
|
1134
|
+
{
|
|
1135
|
+
"type": "object",
|
|
1136
|
+
"additionalProperties": false,
|
|
1137
|
+
"properties": {
|
|
1138
|
+
"operation": {
|
|
1139
|
+
"const": "notifications.set-default",
|
|
1140
|
+
"description": "为当前环境 workflow.standard 规则选择默认渠道"
|
|
1141
|
+
},
|
|
1142
|
+
"environment": {
|
|
1143
|
+
"type": "string",
|
|
1144
|
+
"enum": [
|
|
1145
|
+
"test",
|
|
1146
|
+
"production"
|
|
1147
|
+
]
|
|
1148
|
+
},
|
|
1149
|
+
"input": {
|
|
1150
|
+
"type": "object",
|
|
1151
|
+
"additionalProperties": false,
|
|
1152
|
+
"properties": {
|
|
1153
|
+
"bindingCode": {
|
|
1154
|
+
"type": "string",
|
|
1155
|
+
"minLength": 1,
|
|
1156
|
+
"maxLength": 128
|
|
1157
|
+
},
|
|
1158
|
+
"expectedRevision": {
|
|
1159
|
+
"type": "integer",
|
|
1160
|
+
"minimum": 1,
|
|
1161
|
+
"maximum": 9007199254740991
|
|
1162
|
+
},
|
|
1163
|
+
"expectedBindingRevision": {
|
|
1164
|
+
"type": "integer",
|
|
1165
|
+
"minimum": 1,
|
|
1166
|
+
"maximum": 9007199254740991
|
|
1167
|
+
}
|
|
1168
|
+
},
|
|
1169
|
+
"required": [
|
|
1170
|
+
"bindingCode",
|
|
1171
|
+
"expectedRevision",
|
|
1172
|
+
"expectedBindingRevision"
|
|
1173
|
+
]
|
|
1174
|
+
}
|
|
1175
|
+
},
|
|
1176
|
+
"required": [
|
|
1177
|
+
"operation",
|
|
1178
|
+
"environment",
|
|
1179
|
+
"input"
|
|
1180
|
+
]
|
|
1181
|
+
},
|
|
1182
|
+
{
|
|
1183
|
+
"type": "object",
|
|
1184
|
+
"additionalProperties": false,
|
|
1185
|
+
"properties": {
|
|
1186
|
+
"operation": {
|
|
1187
|
+
"const": "notifications.messages",
|
|
1188
|
+
"description": "按业务关联或收件人分页查询原通知"
|
|
1189
|
+
},
|
|
1190
|
+
"environment": {
|
|
1191
|
+
"type": "string",
|
|
1192
|
+
"enum": [
|
|
1193
|
+
"test",
|
|
1194
|
+
"production"
|
|
1195
|
+
]
|
|
1196
|
+
},
|
|
1197
|
+
"input": {
|
|
1198
|
+
"type": "object",
|
|
1199
|
+
"additionalProperties": false,
|
|
1200
|
+
"properties": {
|
|
1201
|
+
"limit": {
|
|
1202
|
+
"type": "integer",
|
|
1203
|
+
"minimum": 1,
|
|
1204
|
+
"maximum": 100
|
|
1205
|
+
},
|
|
1206
|
+
"offset": {
|
|
1207
|
+
"type": "integer",
|
|
1208
|
+
"minimum": 0,
|
|
1209
|
+
"maximum": 9007199254740991
|
|
1210
|
+
},
|
|
1211
|
+
"status": {
|
|
1212
|
+
"type": "string",
|
|
1213
|
+
"minLength": 1,
|
|
1214
|
+
"maxLength": 50
|
|
1215
|
+
},
|
|
1216
|
+
"correlationId": {
|
|
1217
|
+
"type": "string",
|
|
1218
|
+
"minLength": 1,
|
|
1219
|
+
"maxLength": 255
|
|
1220
|
+
},
|
|
1221
|
+
"recipientUserId": {
|
|
1222
|
+
"type": "string",
|
|
1223
|
+
"minLength": 1,
|
|
1224
|
+
"maxLength": 255
|
|
1225
|
+
}
|
|
1226
|
+
},
|
|
1227
|
+
"required": []
|
|
1228
|
+
}
|
|
1229
|
+
},
|
|
1230
|
+
"required": [
|
|
1231
|
+
"operation",
|
|
1232
|
+
"environment",
|
|
1233
|
+
"input"
|
|
1234
|
+
]
|
|
1235
|
+
},
|
|
1236
|
+
{
|
|
1237
|
+
"type": "object",
|
|
1238
|
+
"additionalProperties": false,
|
|
1239
|
+
"properties": {
|
|
1240
|
+
"operation": {
|
|
1241
|
+
"const": "notifications.message",
|
|
1242
|
+
"description": "读取原消息、收件人、投递尝试和审计"
|
|
1243
|
+
},
|
|
1244
|
+
"environment": {
|
|
1245
|
+
"type": "string",
|
|
1246
|
+
"enum": [
|
|
1247
|
+
"test",
|
|
1248
|
+
"production"
|
|
1249
|
+
]
|
|
1250
|
+
},
|
|
1251
|
+
"input": {
|
|
1252
|
+
"type": "object",
|
|
1253
|
+
"additionalProperties": false,
|
|
1254
|
+
"properties": {
|
|
1255
|
+
"messageId": {
|
|
1256
|
+
"type": "string",
|
|
1257
|
+
"minLength": 1,
|
|
1258
|
+
"maxLength": 36,
|
|
1259
|
+
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
|
|
1260
|
+
}
|
|
1261
|
+
},
|
|
1262
|
+
"required": [
|
|
1263
|
+
"messageId"
|
|
1264
|
+
]
|
|
1265
|
+
}
|
|
1266
|
+
},
|
|
1267
|
+
"required": [
|
|
1268
|
+
"operation",
|
|
1269
|
+
"environment",
|
|
1270
|
+
"input"
|
|
1271
|
+
]
|
|
1272
|
+
},
|
|
1273
|
+
{
|
|
1274
|
+
"type": "object",
|
|
1275
|
+
"additionalProperties": false,
|
|
1276
|
+
"properties": {
|
|
1277
|
+
"operation": {
|
|
1278
|
+
"const": "notifications.dead-letters",
|
|
1279
|
+
"description": "分页查询通知死信，可限定原 messageId"
|
|
1280
|
+
},
|
|
1281
|
+
"environment": {
|
|
1282
|
+
"type": "string",
|
|
1283
|
+
"enum": [
|
|
1284
|
+
"test",
|
|
1285
|
+
"production"
|
|
1286
|
+
]
|
|
1287
|
+
},
|
|
1288
|
+
"input": {
|
|
1289
|
+
"type": "object",
|
|
1290
|
+
"additionalProperties": false,
|
|
1291
|
+
"properties": {
|
|
1292
|
+
"limit": {
|
|
1293
|
+
"type": "integer",
|
|
1294
|
+
"minimum": 1,
|
|
1295
|
+
"maximum": 100
|
|
1296
|
+
},
|
|
1297
|
+
"offset": {
|
|
1298
|
+
"type": "integer",
|
|
1299
|
+
"minimum": 0,
|
|
1300
|
+
"maximum": 9007199254740991
|
|
1301
|
+
},
|
|
1302
|
+
"messageId": {
|
|
1303
|
+
"type": "string",
|
|
1304
|
+
"minLength": 1,
|
|
1305
|
+
"maxLength": 36,
|
|
1306
|
+
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
|
|
1307
|
+
}
|
|
1308
|
+
},
|
|
1309
|
+
"required": []
|
|
1310
|
+
}
|
|
1311
|
+
},
|
|
1312
|
+
"required": [
|
|
1313
|
+
"operation",
|
|
1314
|
+
"environment",
|
|
1315
|
+
"input"
|
|
1316
|
+
]
|
|
1317
|
+
},
|
|
1318
|
+
{
|
|
1319
|
+
"type": "object",
|
|
1320
|
+
"additionalProperties": false,
|
|
1321
|
+
"properties": {
|
|
1322
|
+
"operation": {
|
|
1323
|
+
"const": "notifications.replay",
|
|
1324
|
+
"description": "修复配置后仅恢复指定原通知死信"
|
|
1325
|
+
},
|
|
1326
|
+
"environment": {
|
|
1327
|
+
"type": "string",
|
|
1328
|
+
"enum": [
|
|
1329
|
+
"test",
|
|
1330
|
+
"production"
|
|
1331
|
+
]
|
|
1332
|
+
},
|
|
1333
|
+
"input": {
|
|
1334
|
+
"type": "object",
|
|
1335
|
+
"additionalProperties": false,
|
|
1336
|
+
"properties": {
|
|
1337
|
+
"deadLetterId": {
|
|
1338
|
+
"type": "string",
|
|
1339
|
+
"minLength": 1,
|
|
1340
|
+
"maxLength": 36,
|
|
1341
|
+
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
|
|
1342
|
+
}
|
|
1343
|
+
},
|
|
1344
|
+
"required": [
|
|
1345
|
+
"deadLetterId"
|
|
1346
|
+
]
|
|
1347
|
+
}
|
|
1348
|
+
},
|
|
1349
|
+
"required": [
|
|
1350
|
+
"operation",
|
|
1351
|
+
"environment",
|
|
1352
|
+
"input"
|
|
1353
|
+
]
|
|
1354
|
+
}
|
|
1355
|
+
]
|
|
1356
|
+
}
|
|
1357
|
+
```
|
|
1358
|
+
|
|
239
1359
|
## workflow_node_configurations
|
|
240
1360
|
|
|
241
1361
|
查看流程有效参数。修改已部署流程前，读取管理员维护的节点配置。已有任务和后续节点进入使用各自适用版本。
|
|
@@ -496,8 +496,11 @@ return <WorkflowSubmissionPage workflowCode="reinstatement" variant="mobile" for
|
|
|
496
496
|
|
|
497
497
|
初值仅在当前匹配的发起合同内应用到未触碰字段，每字段一次；后到资料和父组件重新渲染
|
|
498
498
|
不会覆盖已填写或手动清空的内容。日期和范围使用canonical值，标准页通过原codec转换。
|
|
499
|
-
|
|
499
|
+
条件隐藏同步也读取表单当前值，避免预填或联动刚写入的来源行被旧显隐投影清空。
|
|
500
|
+
`fieldState`读取canonical值，`required`只能增加校验，不能撤销原必填；
|
|
500
501
|
可选字段隐藏时清为`hiddenValue`或undefined，提交也使用同一投影，不发送旧材料/人员。
|
|
502
|
+
|
|
503
|
+
必填字段也可以隐藏，但必须提供非null/undefined的规范`hiddenValue`，例如表单外已经选定的业务对象。0与false是有效输入；平台仍核验类型、必填和授权，应用须重新核验对象。未提供值时表单继续阻断。
|
|
501
504
|
初值或规则引用范围外字段会阻断表单。`intro`只提供页面说明，不拥有身份、授权或提交。
|
|
502
505
|
资料加载/失败或业务资格提示可传`preparation`内容，它仅阻断尚未提交的表单；原请求查询
|
|
503
506
|
及已接受命令的展示优先于该提示。应用应始终挂载标准页，避免当前资格变化遮蔽原结果恢复。
|
|
@@ -511,6 +514,10 @@ return <WorkflowSubmissionPage workflowCode="reinstatement" variant="mobile" for
|
|
|
511
514
|
联动；PC/手机规则一致。异常保留输入并阻断新提交，下一次成功输入可恢复，原提交结果
|
|
512
515
|
查询及已接受命令仍优先。异步资料读取放准备阶段，服务器仍校验资格和业务不变量。
|
|
513
516
|
|
|
517
|
+
对已有台账等来源固定的子表，可以传 `subtableFixedRows: ['existingPositions']`，关闭新增、删除和导入，并保留允许字段的编辑、上传和分页。此项仅限制页面操作；业务动作仍须后台重读来源，核验行集合与来源版本，不能把它作为数据授权或防篡改守卫。
|
|
518
|
+
|
|
519
|
+
当只读来源标识或版本需要发给后台核对时，使用 `subtableReadonlyInputFields: { existingPositions: ['ledgerId', 'ledgerRevision'] }`。字段必须属于当前操作的子表白名单；这些值仅在页面只读，仍是未经信任的输入，后台必须重读并执行版本／集合守卫。不得与同字段的 `subtableReadonlyFields` 混用，后者会省略派生输入。
|
|
520
|
+
|
|
514
521
|
具名owned新建表单可传`subtableReadonlyFields: { lines: ['employeeNumber'] }`，
|
|
515
522
|
把当前子行的派生值显示为只读，并从提交输入排除。表名与字段必须属于当前sealed
|
|
516
523
|
owned闭包；配置错误会拒绝新表单。值仍可供应用联动展示，Server应重新计算可信值。
|
|
@@ -1121,3 +1128,18 @@ nodes: {
|
|
|
1121
1128
|
自动协商 `workflow.correction-business-command@1.0.0`，无需额外开启功能。
|
|
1122
1129
|
本人标量补正支持 Native 写入，owned 子表补正仍不支持；原已成功结果先于当前资料重验
|
|
1123
1130
|
恢复，不因日期推移或资料后来停用而被误报为失败。接入方法见[后端](backend.md#correction-business-command)。
|
|
1131
|
+
|
|
1132
|
+
具名来源行需要展示原资源的材料时，表单可提供 `fileResourceCodes: { [fileId]: resourceCode }`。PC/手机按来源选择 Native 附件读取入口；这是展示提示，平台仍检查当前用户对每个原文件的权限。新上传保留声明的目标资源，提交后台仍须验证来源并使用原复制回执，不能直接绑定另一资源文件。
|
|
1133
|
+
|
|
1134
|
+
角色绑定 `app_role` / `app_role_in_scope` 可声明 `selectedInputPath`，从固定代码步骤输出或流程事实中读取人员数组（用户ID或 `{ value, label }`）。平台按当前角色和范围重新核验，再按输入顺序保留其职责出处。越权、失效或重复人员整体拒绝；缺值阻断，只有显式 `[]` 可以消费节点已声明的无人策略。不可与 `routing`、`candidateField`、`inputPath` 混用。编译器要求 `workflow.role-input-selection@1.0.0`；该路径属于代码定义，不是管理员可改的连接或条件。
|
|
1135
|
+
|
|
1136
|
+
### 申请人补正中的非流转子表
|
|
1137
|
+
|
|
1138
|
+
固定 `correction` 任务可以包含一层 owned 子表，只要这些子表不在
|
|
1139
|
+
`subject.factProjection` 中。页内的 `subtable.create/delete/reorder` 和子字段
|
|
1140
|
+
白名单、只读、必填及模型 `minRows/maxRows` 仍生效。使用原任务的
|
|
1141
|
+
`key/state/values/id/revision` 编辑，不把新建申请的 `data` 行结构套到原行。
|
|
1142
|
+
平台把父子修改与 `resubmit` 放在同一授权、版本校验和事务中，应用的业务重提
|
|
1143
|
+
只需重核自身业务不变量，不能另写一次子行。投影为流程事实的子表暂不支持此
|
|
1144
|
+
补正形式，仍返回 `WORKFLOW_CORRECTION_OWNED_FACTS_UNSUPPORTED`；不能通过
|
|
1145
|
+
移除真实流转事实来绕过。原返回、重走首节点、职责和原命令恢复规则保持。
|