03 结构配置与共享引用

结构定义了一个项目有哪些配置项：分组 → 配置项（key、类型、必填、敏感、共享引用）。发布结构后对所有分支同时生效，各分支再填不同的值。

3.1 结构页

项目内切到「结构」页签：

3.2 分组与配置项

1. 「添加组」创建分组（如 redis）
2. 组内「添加配置项」：填写 key、选类型、勾选 required / secret
3. 「保存草稿」→「发布结构」

支持的类型：

• required：发布前该配置项必须有值，否则发布被拦截（校验策略可改为 warn 仅警告）
• secret：值加密存储；数据面 / 渲染输出恒为 ***，仅管理面 reveal=true 且审计后才解密

3.3 共享引用

配置项可以引用共享库中的共享项（详见 06 共享库）——结构只声明「这是引用共享项」，选哪个共享项由每个分支自己决定：

1. 先在「共享库」创建并发布共享项（如 timeout）
2. 结构编辑器里给配置项勾选「引用共享」（类型列保留真实类型，作为分支下拉的类型约束）
3. 发布结构后，各分支在草稿页为该项下拉选择引用的共享项（值由共享库物化、只读；共享项更新发布后自动级联到绑定它的分支）

草稿页中引用共享项显示「引用共享」徽章 + 下拉 + 物化值：

不同分支可以引用不同的共享项（如 dev 引 dev-timeout、prod 引 prod-timeout）；引用项的值由所选共享项决定（含 secret 属性），分支不可写本地值；被分支绑定的共享项不可直接删除（需先在相关分支解除绑定）。

3.4 结构版本与编辑

• 结构编辑器显示「基于 svN」：保存草稿时 base_version 必须等于当前已发布结构版本
• 其他管理员发布了新结构后，本页会出现「结构已更新」提示，点「载入当前」重新加载再编辑
• 「发布结构」会推进全部分支的版本；结构中已删除的配置项，其未发布草稿值会被自动清理

下一步

• 04 草稿与发布：为各分支填值、校验、发布版本