53 lines
7.3 KiB
Markdown
53 lines
7.3 KiB
Markdown
# 配置中心与专项质检迭代规格
|
||
|
||
## 1. 需求与术语
|
||
来源：用户确认两类角色、四类卡片、方案发布、概率依据与沙盘联动、助手查询及可替换 Jev，并明确要求开发跑起来。配置管理员管理能力；客户经理使用已发布方案。正式通过指公司评审会通过。模拟情景值不是校准审批概率，证据雷达表示核验阶段，模型质检结果不是审批。
|
||
范围：统一配置入口、模板/数据卡创建、卡片隐藏、真实目录助手、自然案例展示、轨迹专项质检。真实历史校准、自动训练/自动发布不在本轮。
|
||
|
||
## 2. 数据与接口契约 / 架构
|
||
复用 assistant_objects：component_availability 按组件稳定 ID 保存 hidden:boolean；component_draft/component_version 原治理不变。隐藏是独立可用性状态，不篡改历史版本。
|
||
新增 /library/configuration/cards（管理员创建 data_card/template 草稿，复用 registry.draft）；/cards/{id}/visibility（管理员 PATCH）；/inventory（项目授权目录查询）；/quality/settings（管理员 GET/PUT）；/quality/probe（管理员 POST）；/projects/{id}/quality（读历史、POST 指定 run_id）。请求 extra=forbid，非法配置422、权限403、无对象404。
|
||
新增质量配置只写 backend/xingbang_data/quality-settings.private.json（受管、忽略提交）；公开配置不含 Key。quality_review 追加冻结 provider/model/revision/rubric/input_hash、检查结果，不改 run。模型配置修改只影响新检查。服务 owner 为 catalog_configuration、trajectory_quality；API owner 为 workbench_configuration；不进入主审 tool 白名单。
|
||
本地模式支持 loopback/内网 OpenAI-compatible 服务（Ollama/vLLM），不依赖 Jev Key；Jev 使用官方 systemone typed questions，仅模拟域明确允许外发时发送白名单技术摘要（步骤状态、核查码、证据引用计数），不发送材料原文。无 Key/未允许外发明确失败，不默默切换。
|
||
|
||
## 3. 表面规格与 UI 决策
|
||
沿用已批准深色导航＋浅色工作区；新增配置中心资产/评审方案/模型与质检三个区，四类卡片标签、来源文字和颜色、发布/隐藏动作。业务页显示实际卡片与动态维度、当前情景组合及对照。现有42/58/51/64暂保留人工情景表，给出表口径与对应 Skills 依据，绝不编造每卡贡献百分比。模板仅影响报告结构。
|
||
轨迹增加“专项质检”页签：选运行→检查→定位问题步骤→回到过程；规则审计即时执行，可选本地/Jev补充窄问题判断，结果与会议标签分开。助手查询依据后端授权目录，客户经理只读已发布可见卡片，管理员可见草稿与隐藏。
|
||
状态：loading/ready/empty/error/submitting；提交中保留内容禁用按钮；错误由 API code/message 绑定；颜色兼有来源和状态文字，focus-visible 与 reduced-motion 沿用业务 CSS。中文文案就近维护，未建设统一 i18n 不宣称已有。
|
||
Superdesign旧原型为已批准视觉来源；本轮源码外发上下文最初被自动审批拒绝；用户随后明确授权，已完成 Superdesign 同一草稿 v4 替换迭代。实际页面遵循既定方向；浏览器视觉验收仍未观测。
|
||
|
||
## 4. 业务规则
|
||
- BR-72：隐藏组件禁止进入新方案装配/运行，冻结历史仍可回放。
|
||
- BR-73：四类卡片创建/发布/隐藏仅配置管理员执行，发布保留原独立评测审核。
|
||
- BR-74：方案可选发布模板；模板不改变核查和概率。
|
||
- BR-75：助手卡片查询按项目与角色筛选真实目录，不使用通用主机工具。
|
||
- BR-76：案例展示自然企业名称与业务记录，数据域与来源仍明确为虚构，不改已存选择快照/历史轨迹；旧的未确认查询预览若内容哈希变化会失效，须重新筛选。
|
||
- BR-77：质检配置凭据私有，按版本冻结，失败不补分，关闭不生成模型判断。
|
||
- BR-78：质检不改审批概率、主审结论或自动发布经验。
|
||
- BR-79：概率解释显示实际组件维度和模拟情景表，禁止声称卡片贡献是真实统计因果。
|
||
|
||
## 5. 异常
|
||
- E-45 COMPONENT_HIDDEN（装配异常文案标识；既有运行 API 保留原错误信封）：新装配引用隐藏组件；“评审方案存在隐藏组件，请更新配置后重试”。
|
||
- E-46 CONFIGURATION_INVALID：格式、地址、类型非法；“配置不合法，请检查必填项与受信模型地址”。
|
||
- E-47 QUALITY_UNAVAILABLE：无Key/外发未允许/模型不可用/输出非法；“专项判断未完成，主审记录保持不变”。
|
||
- E-48 HTTP 403（沿用既有 HTTP detail 身份错误形状，不新增 JSON code）：客户经理修改配置或访问其他项目；配置入口沿用“当前身份无权进行经验加工”，项目范围沿用“无权访问该项目”。
|
||
|
||
## 6. Given/When/Then 验收
|
||
- AC-84（BR-72/E-45）：Given 已发布方案，When 隐藏依赖，Then 新装配拒绝而旧版本读取与回放不变。
|
||
- AC-85（BR-73/74/E-46/48）：Given 两类身份，When 创建模板/数据卡及修改可见性，Then 仅管理员成功，非法内容拒绝；模板可选且仍需评测和独立发布。
|
||
- AC-86（BR-75/E-48）：Given 项目草稿、隐藏与发布卡，When 经理/管理员询问 Skills 数目，Then 经理仅见已发布可见范围，管理员见其授权全目录，跨项目不泄漏。
|
||
- AC-87（BR-76）：Given 240条虚构案例，When 再次初始化/展示，Then 名称自然且唯一、财务值与历史快照不改、来源仍标模拟。
|
||
- AC-88（BR-77/E-46/47）：Given disabled/local/Jev配置，When 保存、检查及模型畸形输出，Then Key不返回；关闭跳过、缺Key失败、有效窄问题输出保存版本。
|
||
- AC-89（BR-78）：Given 冻结运行，When 质检完成或失败，Then 原运行哈希、概率和组件版本保持相同。
|
||
- AC-90（BR-79）：Given 任意方案，When 展示/勾选沙盘，Then 实际维度和卡片关联保留、固定情景值标明模拟、真实概率为空。
|
||
|
||
## 7. 决策与阶段证据
|
||
用户已确认产品方向和实施授权；接口、权限、存储、状态与边界已按现状定案，①–④门禁由本规格与调用方核对提供。⑤实现后必须测试全部对应规则并执行 scripts/verify.py，⑥–⑧证据另记交付记录。概率校准 owner 数据试点、需要真实历史与独立时间留出集，不阻塞模拟环境；Jev实时质量验证需有效Key，未接入不能标有效。
|
||
|
||
|
||
## 实施补充事实
|
||
- 内置只读数据源 source.project-facts 与数据卡 data.initial-finance 只投影当前项目已确认的财务事实；不把初步材料猜测变成已确认字段。已有方案不被自动加入新卡片，管理员选择并发布新方案后才使用。
|
||
- 模板选择进入冻结方案，业务助手生成报告使用该运行选定模板，并保留其冻结版本，后续模板发布不改变旧报告。
|
||
- 卡片治理/方案治理的旧测试身份已从审核员迁移为两位独立配置管理员；经理仍可查看和运行预审，但不得创建、修订、评测或发布卡片方案。
|
||
- Jev HTTP 契约来源：[官方 API](https://docs.typesafe.ai/api)、[官方快速开始](https://docs.typesafe.ai/introduction/quickstart)。模型输出严格验证；本地判断为布尔结果，Jev Noul 的单题概率不转换为审批概率。
|