新建对讲群组（含成员绑定）
验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14
用途与场景
创建一个对讲群组，并在同一事务内写入群组与记录仪（数据采集设备）的初始绑定关系。本页是 http-post-main-service-main-api-basedata-talk-group-savewithdataacquisitiondevices-7cba1e89 的唯一操作正本。保存成功只表示群组与绑定数据已落库；AudioBridge 房间创建和设备 PTT 配置刷新由后端内部消息链异步联动，本页不承诺媒体可用。
使用位置
| 页面/功能 | 角色或空间分支 |
|---|---|
| 群组编辑器新建模式确认保存 | 前端可见性要求 basedata-talk-group:create 或 administrator；后端独立鉴权 |
端点
POST /main-service/main-api/basedata/talk-group/saveWithDataAcquisitionDevices — 创建一个对讲群组，并在同一事务内写入群组与记录仪（数据采集设备）的初始绑定关系。
端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 basedata · talk-group 对讲组；业务语义（wire 惯例、限频、租户声明等）见基础数据业务 · talk-group 对讲组。
动线与完成判据
| 层级 | 判据 |
|---|---|
| 传输成功 | HTTP 响应返回 JSON |
| 业务成功 | status=200 && data=true；前端要求 data===true 才提示成功 |
| 数据可见 | 事务提交后可由 getByTalkGroupId 族读接口读回；本票未发布该读正本（见已知缺口） |
| 房间可用 | 不由本接口判定：房间创建是异步内部动作，可能因 SFU 离线被丢弃，由 5 分钟周期补偿任务收敛 |
错误与边界
- 群组 ID 已存在（含已删除记录）→ 业务拒绝（
Talk group exists），wire 形态见业务拒绝。 - 字段校验失败（如
roomPin格式、talkGroupId字符集）适用请求校验。 - 认证/权限失败适用认证失败与权限失败。
- 写操作无幂等键；超时后须先查询群组是否存在再决定是否重试。公共 Web helper 默认 900 秒（15 分钟）超时。
- 保存与成员绑定在同一数据库事务；绑定写入异常会整体回滚。
调用关系与资源清理
- 成功后进入编辑页导航。
- 异步链：
ROOM_ENSURE（见ensureRoom 正本的内部链说明）+PTT_CONFIG_REFRESH（见pushPttConfig 正本）。 - 后续编辑使用 updateByIdWithDataAcquisitionDevices 正本。
已知缺口
- 群组详情读取接口
GET /main-service/main-api/basedata/talk-group-data-acquisition-device/getByTalkGroupId有当前 Web 调用但不在已确认调用清单（inventory）中，本票未为其发布场景正本；契约事实已可查清单层 · talk-group-data-acquisition-device。 - 未执行真实 HTTP、数据库、JMS 与部署联调；房间最终创建结果（AudioBridge
created/ 幂等）只核验到中心归档监听器，未核验真实 Janus 环境。
目录