系统参数、字典与个性化配置¶
适用基线:测试环境目标 /
dev分支 / 2026-07-15。 阅读对象:测试、实施、运维(主);需要维护下拉选项与参数开关的配置人员(顺带)。
业务目的与适用范围¶
本页说明跨模块复用的三类配置:
- 数据字典:为页面下拉、状态标签等提供统一选项;
- 系统/基础设施参数:键值型运行参数(可见性可控);
- 个性化:用户级页面偏好(如按用户与页面保存的配置)。
读完本页,应能:判断下拉缺项该查字典还是业务过滤;参数改了无效该查键名/租户/缓存;并区分字典与 DBC 业务策略/单据开关,避免用字典模拟复杂策略。业务含义强的策略、业务类型、单据开关仍归 DBC/业务页。
本页与相邻能力的边界¶
| 能力 | 本页管什么 | 不管什么(去哪看) |
|---|---|---|
| 字典与参数 | 字典类型/项、配置管理键值、个性化保存 | 业务策略/单据开关 → DBC 策略设置 |
| 开发平台入口 | 配置管理可与开发平台交叉引用 | 开发平台 |
| 消息模板 | 仅作相关入口提示 | 消息通知、基础设施消息页 |
| 菜单/权限 | 不展开 | RBAC |
如何使用本组文档¶
| 你的目的 | 建议阅读 |
|---|---|
| 理解字典/参数如何传导到业务页,并验收变更影响 | 本页:准备 → 字典/参数 → 建议验证点 |
| 改基础设施参数键值 | 本页 + 开发平台 |
| 理解列表筛选如何用字典 | 查询、筛选与用户视图 |
| 改业务策略/开关 | DBC 策略设置等业务页 |
使用前准备¶
| 需要确认什么 | 为什么重要 |
|---|---|
| 字典编码是否已被业务引用 | 改值/删项可能导致页面选项异常或历史数据难读。 |
| 参数是否对前端可见 | 不可见参数通常仅后端使用,勿当页面开关乱改。 |
| 变更环境 | 生产改字典/参数需评审与回滚预案。 |
| 租户范围 | 多租户下确认是否改到目标租户。 |
📷 截图占位
字典类型列表与字典数据项;参数配置列表。
数据字典¶
flowchart LR
A["字典类型"] --> B["字典数据项"]
B --> C["业务页面下拉/标签"]
| 对象 | 业务含义 | 维护注意 |
|---|---|---|
| 字典类型 | 一组选项的编码与名称、启停状态。 | 类型编码稳定后不宜随意改名改码。 |
| 字典数据 | 标签、值、排序、颜色样式、启停。 | 值被持久化引用时,停用优于删除。 |
常见用途:状态、类型、业务细分等下拉。业务页应写清使用了哪个字典语义,而不是只写“下拉可选”。
📝 示例数据占位
某一状态字典类型下的启用/停用数据项;业务单据仍展示历史停用值标签。
写实示例:给定配置 → 期望行为
给定: 字典类型「单据状态」中某选项值 HOLD 被停用(非删除);历史单据已存该值;新单下拉不再提供该选项。
期望: 新单不能再选 HOLD;历史单据仍能展示对应标签(或按环境回退文案)。若直接删除仍被引用的值,历史单据可能难读——验收应优先停用而非删除。
系统参数¶
| 能力 | 当前结论 |
|---|---|
| 参数配置入口 | 基础设施“配置管理”维护分类、键、值、类型、是否可见、备注。 |
| 可见性 | 不可见参数一般不暴露给前端读取。 |
| 与业务策略区别 | 参数是通用键值;业务策略/单据开关有独立业务模型。 |
变更后若页面不生效,应检查缓存、重新登录与是否改错键名。
个性化与相关配置¶
| 能力 | 当前结论 |
|---|---|
| 用户页面配置 | 支持按用户与页面组件保存/查询页面级配置。 |
| 多语言配置 | 存在多语言配置管理菜单;❓ 启用范围与覆盖字段待环境确认。 |
| 统一用户视图中心 | ❓ 未证实为全站共享默认视图平台(见查询页);勿把旧规划直接写成现状。 |
| 个人中心 | 用户可维护个人资料类信息(密码/头像等以实际页面为准)。 |
建议验证点¶
- 停用字典项:新单下拉不可选;历史展示仍可读。
- 改可见参数键值后:目标租户在刷新/重登后行为变化;改错租户则无变化。
- 个性化:同一页面配置不跨用户共享(除非另有共享能力——❓ 未证实全站默认视图中心)。
- 业务开关找不到时:先查 DBC 单据开关/业务类型,不要只在字典里翻。
- ❓ 参数变更强制审计与审批流未证实为通用能力。
其它相关配置入口¶
| 入口 | 用途 | 详见 |
|---|---|---|
| 错误码管理 | 维护业务错误码与提示文案。 | 本页联查;变更需评估前端提示一致性。 |
| 敏感词管理 | 内容过滤类配置。 | ❓ 启用范围待业务确认。 |
| 短信/邮件/站内信模板 | 通知渠道配置。 | 消息、通知与待办。 |
关键判断¶
| 判断点 | 应先确认什么 | 影响 |
|---|---|---|
| 下拉缺项 | 字典项是否停用、类型是否正确、缓存。 | 先查字典再改业务代码预期。 |
| 参数改了无效 | 键名、可见性、租户、是否需重启/刷缓存。 | 避免重复改值。 |
| 个性化丢了 | 是否换浏览器/清缓存、是否换账号。 | 用户级配置不跨人共享(除非另有共享能力)。 |
关键字段业务角色(字典 / 参数如何传导到业务页)¶
| 字段/配置点 | 在系统中的作用 | 关键行为要点 | 警惕什么 |
|---|---|---|---|
| 字典类型 + 字典项 | 业务页下拉与状态标签的选项来源 | 业务存的是字典值;展示用标签;停用优于删除 | 删仍被引用的值 → 历史难读 |
| 字典项启停 | 新单能否再选该值 | 已持久化历史值通常仍展示 | 停用≠清除历史 |
| 系统/Infra 参数键值 | 运行时行为开关/频率等 | 可见参数可被前端读;不可见仅后端 | 改错键、错租户 |
| 业务策略/单据开关 | 强业务分流 | 不在本页字典里配;见 DBC 策略 | 用字典模拟复杂策略 |
| 用户页面个性化 | 个人列表偏好 | 按用户+页面保存 | 误当全站默认视图 |
传导链:字典/参数维护 →(缓存/登录会话)→ 业务页下拉或运行读取。字段写法见页面数据字典规范;选择器过滤通例见通用选择器过滤惯例。
查询与联查¶
| 场景 | 建议看什么 | 联查 |
|---|---|---|
| 状态显示不对 | 字典标签与值、业务存的是值还是标签。 | 业务页字段说明。 |
| 参数争议 | 配置管理中的键值与备注、变更审计。 | 操作日志。 |
| 业务开关找不到 | 是否在单据开关/业务类型而非字典。 | DBC 策略设置。 |
常见问题与处理¶
| 情况 | 建议处理 |
|---|---|
| 删除仍被引用的字典值 | 改为停用;评估历史单据展示。 |
| 用字典模拟复杂策略 | 改走业务策略/规则配置。 |
| 把 Infra 参数当成租户业务参数随意改 | 先确认影响范围与备份。 |
当前限制与待确认事项¶
- ❓ 字典引用检查与导入规则的完整约束待抽样;
- ❓ 参数变更强制审计与审批流未证实为通用能力;
- ❓ 全站共享默认视图/字段权限配置台未证实;
- ❓ 多语言覆盖范围与运行时切换体验待测试环境确认。
待补充的图示与示例¶
| 类型 | 后续补充 | 目的 |
|---|---|---|
| 字典样例 | 某一状态字典类型与数据项。 | 培训。 |
| 参数样例 | 一条可见/不可见参数对照。 | 实施。 |