修改值集表#

验证状态：已源码核验、未联调；适用基线：Web 7fe6dd10、services 89bd222c；核验日期：2026-09-12

用途与 App 场景#

按 ID 修改值集表（改写前按typeCode+row+key（精确匹配）做排除自身的重复检查）。注意本操作按请求字段无条件改写，不是增量补丁。

Web 使用位置#

协议身份#

前置条件与权限#

需要有效登录态，并满足 administrator 角色或 value-set-table:write。 资源表受 MyBatis 租户拦截器按当前认证租户上下文约束（es-center-server-main-service/src/main/java/com/es/center/server/config/MybatisPlusConfig.java:72-88；configuration 表不在 tenant-id-ignore-tables 白名单），请求中的租户筛选字段不能代替空间切换。认证与空间。

输入#

输出、应答或事件#

完成判据#

status=200 && data=true 表示同租户内命中并已改写；data=false 表示未命中。改写是否生效可随后用 getById 读回验证。

示例#

以下均为按已核验契约构造的示例，不是真实联调记录；ID、时间与租户为占位值。

请求：

1{
2  "valueSetTableId": "vstab-01",
3  "valueSetTypeCode": "region",
4  "row": "gd",
5  "key": "city",
6  "value": "深圳",
7  "sort": 1,
8  "revision": 1
9}

成功响应：

1{
2  "timestamp": 1789142400000,
3  "status": 200,
4  "error": null,
5  "localizedError": null,
6  "path": null,
7  "extraData": {},
8  "data": true
9}

按已核实重复检查出口构造的代表失败（排除自身后 typeCode+row+key（精确匹配） 仍存在）：

1{
2  "timestamp": 1789142400000,
3  "status": 422,
4  "error": "Value set table repeat",
5  "localizedError": null,
6  "path": "<request-path>",
7  "extraData": {},
8  "data": null
9}

信封字段证据：gt-common-core/src/main/java/tech/gt/api/ApiResult.java（成功/失败信封）与 es-center-server-main-service/src/main/java/com/es/center/server/config/JsonFormatConfig.java:20-113（时间序列化）。

错误与边界#

认证失败/权限失败：认证与资源权限拒绝的 wire 形态见错误差异页对应锚点。 Bean Validation（@NotBlank/@Size）与参数绑定失败适用请求校验（HTTP 200，body 400/1002-1004）。 改写前按 typeCode+row+key（精确匹配） 做排除自身的重复检查，冲突时 Value set table repeat（200/422）适用业务拒绝。 本操作对业务字段是"无条件 set"：省略或 null 的键会把库中值改写为 NULL，不是保持不变；也没有乐观锁校验（revision 仅是普通字段）。 公共 Web helper 默认 15 分钟超时（app/.common/lib/fetch-timeouts.ts:4-76 fetchTimeout/fetchTimeoutResponseJson）。本组写/导入操作没有幂等键，超时后须先读取资源状态再决定是否重试，不能仅凭超时盲重试。

调用关系与资源清理#

成功后 toast 并返回列表；同 save 的缓存滞后边界。

已知缺口#

无已知会阻止按当前源码调用的关键契约缺口。updateById 的 NULL 改写语义与无乐观锁是现行行为，App 需按此设计。 仅完成双仓静态源码核验，未执行真实 HTTP、数据库或权限矩阵联调。

验证状态与依据#