未发布正本与保留项

本页列出全部"有 Web 调用记录、但没有以完整契约正本发布"的 inventory 操作,以及整个 effort 的具名缺口统计。这些条目不获得"已源码核验接口页"状态,不能当作 App 可调用的完整契约;mock/静态与兼容候选更不能当作真实后端 API。全部 385 项的反查入口见页面与操作双向索引

未发布正本(2 项)

已确认的真实调用,因关键冲突或责任端缺证未发布操作正本;契约处置由责任票交接给覆盖页:

operationId 身份 Web 使用方 未发布原因
http-dynamic-user-portrait GET {user.portraitUrl} 5 个(个人中心与用户管理头像页) 责任端缺口(票 08,票 17 收敛后保留):上传只证明本地 filesStoragePath 写入并返回 /files/user/{username}/avatar.*;票 16 在部署样例定位 nginx location /files(alias、autoindex on、无鉴权),静态服务与鉴权缺失已收敛,但多节点一致性、缓存与有效期仍无证据
http-post-main-service-main-api-basedata-employee-importlist-b5da0725 POST /main-service/main-api/basedata/employee/importList 1 个(雇员列表页导入) 关键契约冲突(票 09,票 17 复核维持):当前 Web XLSX 模板不生成 username/password/confirmPassword,而后端 EmployeeSavePlusRequestDTO 对三者 @NotBlank,导入请求会在发布 JMS 前校验失败;见基础数据业务 · employee 员工

mock 与静态资源(25 项)

Web 功能消费 mock 或静态文件,只证明前端功能形态,不证明存在可调用的真实后端 API。合并口径与规格一致(Dashboard 20 + GPS 演示 1 + 数据字典 mock 1 + 静态语言包/法务协议/国家 GeoJSON 3):

operationId 身份 Web 使用方 说明与责任票
http-get-v2-geojson-maps-custom-geo-json-86cc2bd3 GET /v2/geojson-maps/custom.geo.json 国家边界 GeoJSON 静态资源,非业务 API(票 16 保留)
http-get-v2-mock-dashboard-device-kpi-json-da6325df GET /v2/mock/dashboard/device-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-device-page-json-1306b7a9 GET /v2/mock/dashboard/device-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-kpi-json-cb04c437 GET /v2/mock/dashboard/kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-online-device-kpi-json-486a0cff GET /v2/mock/dashboard/online-device-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-online-device-page-json-5b48e20c GET /v2/mock/dashboard/online-device-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-online-server-kpi-json-26bc8ebd GET /v2/mock/dashboard/online-server-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-online-server-page-json-7e202826 GET /v2/mock/dashboard/online-server-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-resource-battery-kpi-json-de614b0d GET /v2/mock/dashboard/resource-battery-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-resource-battery-page-json-c4b4cb48 GET /v2/mock/dashboard/resource-battery-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-resource-storage-kpi-json-23a93936 GET /v2/mock/dashboard/resource-storage-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-resource-storage-page-json-11bbd4e5 GET /v2/mock/dashboard/resource-storage-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-resource-upload-kpi-json-f4ac7562 GET /v2/mock/dashboard/resource-upload-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-resource-upload-page-json-a934eb68 GET /v2/mock/dashboard/resource-upload-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-server-kpi-json-cf1f764c GET /v2/mock/dashboard/server-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-server-page-json-fdeba863 GET /v2/mock/dashboard/server-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-trend-json-9df5740f GET /v2/mock/dashboard/trend.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-warning-detail-kpi-json-a9fa3982 GET /v2/mock/dashboard/warning-detail-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-warning-detail-page-json-cacd4706 GET /v2/mock/dashboard/warning-detail-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-warning-ranking-kpi-json-7fec2fab GET /v2/mock/dashboard/warning-ranking-kpi.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-dashboard-warning-ranking-page-json-98ae790b GET /v2/mock/dashboard/warning-ranking-page.json Dashboard 正式接口未就绪,Web 消费 /v2/mock/dashboard 静态样本(票 16 保留)
http-get-v2-mock-gps-trajectory-map-gps-track-1-json-001b3dc0 GET /v2/mock/gps-trajectory-map/gps_track-1.json 回放演示页消费 public/ 静态轨迹样本(票 14 保留)
http-get-v2-mock-main-service-system-api-configuration-data-dictionary-getvaluejson-var-a1b8f650 GET /v2/mock/main-service/system-api/configuration/data-dictionary/getValueJson/{path} 数据字典取值当前消费 /v2/mock 静态字典,真实服务合同缺证(票 08 记录、票 15 维持)
http-static-language-resources GET /files/locales/default/{language}/{namespace}.json i18n 静态资源 /files/locales/...,非业务 API(票 16 保留)
http-static-legal-agreement GET /v2/md/{lng}/{filePath}.md 法务协议 Markdown 静态资源,非业务 API(票 16 保留)

兼容待核(6 项)

webrtc-p2p-pull-2 组件文件通路的兼容候选:实现存在,但当前 flat route/导入链未闭合(callConfirmed=false),票 14 已复核该组件在当前 Web 代码库无任何路由/导入引用。不计入 379 项已确认调用:

operationId 身份 Web 使用方(兼容组件内) 说明
mqtt-byefn-server-var-file-webrtc-57b9b2fd MQTT server/{deviceNo}/file/webrtc 兼容候选;须采集服务器协议/实现证明载荷、回复及副作用,保留覆盖页(票 14 登记)
mqtt-callfn-server-var-file-webrtc-380bc073 MQTT server/{deviceNo}/file/webrtc 兼容候选;须采集服务器协议/实现证明载荷、回复及副作用,保留覆盖页(票 14 登记)
mqtt-candidatefn-server-var-file-webrtc-e04aeb78 MQTT server/{deviceNo}/file/webrtc 兼容候选;须采集服务器协议/实现证明载荷、回复及副作用,保留覆盖页(票 14 登记)
mqtt-listiceserverfn-server-center-server-iot-v1-list-ice-server-01b49a17 MQTT server/center-server/iot/v1/list-ice-server 兼容候选;须采集服务器协议/实现证明载荷、回复及副作用,保留覆盖页(票 14 登记)
mqtt-pingfn-server-var-file-webrtc-cdfaaa8e MQTT server/{deviceNo}/file/webrtc 兼容候选;须采集服务器协议/实现证明载荷、回复及副作用,保留覆盖页(票 14 登记)
mqtt-sdpfn-server-var-file-webrtc-64474064 MQTT server/{deviceNo}/file/webrtc 兼容候选;须采集服务器协议/实现证明载荷、回复及副作用,保留覆盖页(票 14 登记)

具名缺口统计

以下缺口在正本页"已知缺口"小节逐页标注,此处按责任端归并统计,供发布门与后续补票使用:

  • 设备固件(最终消费者缺证)device/{deviceNo}/iot/configs/v1 get/set/bcplus 分支与 webrtc/deliver/v1 接收方、device/{deviceNo}/webrtc/v1 九操作(ping/media/call/sdp/candidate/bye/play/idr)、device/{deviceNo}/ptt/deliver/v1 join/kick 执行、retrieve 设备侧断链——影响设备远控/对讲 12 页"存在关键缺口"标注;权威 struct 字段、错误应答、执行确认均需设备协议/固件补证(票 11/12/13,票 18 复核维持)。
  • 采集服务器(最终消费者缺证)server/{deviceNo}/data/v1 八 topic 的应答权威 schema、错误形态、完成语义缺证(8 页关键缺口);新增采集服务器 retrieve 变体(server retrieve 正本)同样以采集服务器执行断链为关键缺口(票 11/14,票 18 复核维持;票 20 补充)。
  • Janus 服务器实现缺证:AudioBridge/VideoRoom 插件事件字段全集、错误码、attached 是否回显 transaction(Web SDP 分支依赖)、handle_info schema、会话超时与媒体面指标;监看/对讲 Janus 各页维持"已源码核验、未联调 + 具名缺口"(票 12/13,票 18 复核把 Janus 缺证计入关键缺口汇总)。
  • MQTT 账号与 Broker ACL(部署侧)user-{username} 账号供给方与 Broker 校验机制缺证、ACL user/{username}/web/{sessionId}/# 最终授权、默认 user/# = all 与按用户隔离的差距、TLS 与部署订阅清单一致性——影响 MQTT 连接与用户会话订阅关键缺口标注(票 16,票 19 复核维持)。
  • 文件静态服务鉴权/files nginx alias + autoindex on、无鉴权(部署样例证实);设备文件下载持 URL 即可访问的业务影响未评估(票 16,票 19 复核维持)。
  • changeBaseInfo wire 可达性:前端模板串尾随空格 vs 服务端无空格映射,需联调或网关 URI 规范化证据;同类尾随空格还出现在未入清单的 forgetPassword API(票 16 newDiscoveries,覆盖评估结论:无当前确认调用,不发布正本,留待后续 Web 变更时补证)。
  • 配置导入仓外消费:data-dictionary importList 发布 JMS 受理后是否落库/upsert/失败回传/幂等缺证(8 个 configuration import 通道在 EXTERNAL_CONSUMER_BOUNDARY 清单);translation importList 仓内消费成立、但 remove 通道缺证与落库时延未联调(票 15/16,票 19 复核维持)。
  • listCache 与分页边界:listCache TTL 陈旧窗口(10 分钟/10 秒)、多实例远程缓存行为、page pageSize 服务端边界未联调;value-set-map/table 前后端权限串不一致(前端 configuration-* vs 后端 value-set-*)已在页面如实记录(票 15,票 19 复核维持)。
  • 第三方服务边界:Meilisearch 服务器本体、11 个瓦片服务器、ipinfo.io、Photon/Nominatim 的字段全集/SLA/配额/CORS/隐私缺证;瓦片模板含写死时点参数(百度 udt=20230105、腾讯 version=376)可能随第三方升级漂移(票 16,票 19 复核维持)。
  • Agent 部署一致性:token prefix 部署值、备份脚本内部行为、并发触发语义未联调;WASM 签名与 Agent 校验的运行时一致性未验证(票 16,票 19 复核维持)。
  • Tus 上传部署上限:Web 整文件 PATCH + Nginx client_max_body_size 形成 10G 上限、proxy_read_timeout 300 秒;磁盘配额、无 ownerKey 的临时上传隔离边界维持(票 10,票 17 复核维持)。
  • 清单外新发现端点(票 12 交接、票 20 确认不发布正本)GET /main-api/basedata/talk-group-data-acquisition-device/getByTalkGroupId(房间页加载群组详情,响应含强制 samplingRate/codec)与 POST /main-api/basedata/talk-group-data-acquisition-device/pageForDevice(工作台设备面板)有当前 Web 调用但不在冻结清单;补票前不得假设其契约(对讲流程页已标注)。
  • 全部页面未执行真实联调:HTTP/MQTT/JMS/Janus/媒体/部署均为静态源码核验;任何"已源码核验、未联调"标注不得读作生产验证通过。

英文镜像

本栏目按规格只交付中文(docs/v1/zh/),票 08–21 的全部中文页均无英文镜像;这不是翻译完成,而是语言策略下的显式保留。无镜像中文文件的全量精确清单与计数由最终验收票 21 交接物按当前工作树产出,可直接登记进 pnpm verify-en 放行清单(scripts/verify-en-allowlist.mjs);后续翻译票补齐后须逐项从放行清单删除,verify-en 会对已满足的放行项输出清理提醒。