新增值集表#

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

用途与 App 场景#

新增一条值集表（同租户内按typeCode+row+key（精确匹配）做存在性检查）。当前 Web 新增表单在客户端生成资源 ID 后提交。

Web 使用位置#

协议身份#

前置条件与权限#

需要有效登录态，并满足 administrator 角色或 value-set-table:create。 资源表受 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 表示保存请求已按合同处理完成；save 以"无异常完成即返回 true"为合同，需要受影响行数语义的调用方应改用 update 接口。结果可随后用 getById/list 读回验证。

示例#

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

请求：

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

成功响应：

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（精确匹配） 已存在，ApiException 默认 422）：

1{
2  "timestamp": 1789142400000,
3  "status": 422,
4  "error": "Value set table exists",
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 exists，HTTP 200 / body 422）适用业务拒绝；重复提交同一业务键会因该检查被拒，但 ID 不同、键不同不算重复。 公共 Web helper 默认 15 分钟超时（app/.common/lib/fetch-timeouts.ts:4-76 fetchTimeout/fetchTimeoutResponseJson）。本组写/导入操作没有幂等键，超时后须先读取资源状态再决定是否重试，不能仅凭超时盲重试。

调用关系与资源清理#

成功后 toast 并返回列表；列表数据经 page/list 直读数据库立即可见，但字典选择器依赖的 listCache 在缓存过期前可能不刷新。

已知缺口#

无已知会阻止按当前源码调用的关键契约缺口。 仅完成双仓静态源码核验，未执行真实 HTTP、数据库或权限矩阵联调。

验证状态与依据#