business-assistant/docs/dms-schema.md

DMS 栏目与字段配置

五个已接入栏目的默认 ID、栏目名称和业务字段名统一保存在 config/dms_schema.json。records（助手问答记录）、sessions（助手会话）、demands（诉求词）、basic（企业基础信息）、honor（企业荣誉信息）是程序内部固定别名。

每个栏目中，id 是 DMS 栏目 ID，name 是启动时核对的栏目名称；fields 左侧为程序内部字段键，右侧为 DMS 模型中的实际字段名。修改 DMS 字段时只改右侧，不改左侧。types 只需列出非默认 text 类型，键使用程序内部字段键。父栏目名称在顶层 parent。DMS 内置的 id、state、column_id、create_time、update_time、title 是接口协议字段，不作为业务字段重命名。

会话三个栏目原有环境变量 DMS_RECORDS_COLUMN_ID、DMS_SESSIONS_COLUMN_ID、DMS_DEMANDS_COLUMN_ID 仍可覆盖配置文件里的 ID；若要统一从文件维护，应移除这些旧覆盖项。企业两栏只从配置文件取 ID。配置变更后重启进程；已创建的 DMS 内容不会自动迁移或改名。严格作用域开启时，还须同步调整 DMS_ALLOWED_SCOPES_JSON 中允许的栏目名称。

程序仍先按栏目 ID 读取元数据，核对栏目名、父栏目和模型字段类型，再访问内容。字段名映射应用于查询条件、写入内容和读取结果；配置非法或服务端模型不符会停止相应 DMS 操作。sh deploy-offline.sh check-dms也读取本文件及现有环境变量，按实际映射只读核对五个栏目的元数据。修改配置不能替代服务端栏目、模型和历史数据迁移。离线部署须重新生成单包，旧包不会自动包含新配置。

新环境可在.env中设置DMS_BASE_URL为服务主机、AUTH_PORT为认证端口、DMS_PORT为数据端口。客户端向认证端口的/proxy_oauth/user/login获取token，再向数据端口的/proxy_dms访问栏目与模型；未设置端口时沿用DMS_BASE_URL的端口。check-dms只验证栏目元数据和字段类型，不因栏目暂无记录而失败。当前配置中3043为诉求词、3037为企业基础信息；其他栏目保留原ID。