docs/v2/09-decisions.md

# 决策、未决项与学习记录

日期：2026-09-28。状态区分“用户已明确的方向”和“工程候选待评审”。

## 1. ADR

| ID | 决策 / 状态 | 被否方案 / 理由 | 影响 |
|---|---|---|---|
| ADR-01 | 复用 Next.js+FastAPI 与现有组件，工程候选 | 全面换框架；无法复用已验证链路 | 先迁移可运行基座，再逐步拆模块 |
| ADR-02 | 主审综合意见、专项模型局部判断（Jev或本地），用户已明确 | Jev单题直接决定通过；缺乏整体研判 | 证据与硬规则约束最终有效输出 |
| ADR-03 | 历史评审过程是核心资产，用户已明确 | 只存通过/不通过标签；丢失核查和判断变化 | 优先收集问询、补件、修改和批复条件 |
| ADR-04 | 经验经审核、有适用范围，工程候选 | 自动把任意反馈变成规则；会固化错误 | 复用现有经验治理，建立历史过程关联 |
| ADR-05 | 无真实校准前不宣称审批概率，已讨论方向 | 分数/Noul直接转通过率；没有业务验证 | P0概率字段为空；先做可追溯预审和试点 |
| ADR-06 | 独立v2代码目录待迁移，当前先备份与文档，用户最新顺序 | 直接覆盖现有部署；难回退 | 旧版Gitea恢复点先核验；v2目录尚未建立 |
| ADR-07 | 按用户最新要求直接适配流程正文，原文保留在Gitea恢复点 | 照搬Electron路径/发布命令；无法执行 | AGENTS统一入口，正文按兴邦事实执行 |
| ADR-08 | 专项判断支持 Jev 官方服务、本地开源模型和关闭；可切换方向用户已明确，契约细节为工程候选 | 把 Jev Key 作为产品依赖或用通用模型自评分伪装等效概率；供应依赖和指标口径不可控 | 统一业务题库/接口，独立适配/验收；本地路径先交付，Jev 接入不阻塞 |

## 2. Open Questions

needed-by 是明确阶段门，不虚构双方尚未约定的日历时间。

| ID | 待定内容 | 当前处理 | owner | needed-by |
|---|---|---|---|---|
| OQ-01 | 首批业务类型、关键核查项、正式硬规则 | 只使用标注演示规则；不宣称兴邦制度 | 项目负责人+兴邦评审专家 | M2真实经验建模前 |
| OQ-02 | 经验发布资格、独立复核、真实身份体系 | 演示角色明确标示；生产数据入口不开启 | 兴邦业务负责人+系统管理员 | M2生产权限实现前 |
| OQ-03 | 专项/主审模型端点、本地模型与硬件、客户数据出口、保留策略 | mock/合成样本；先验证本地路径，缺 Jev Key 不阻塞；不发送真实材料 | 兴邦数据负责人+技术负责人 | 任何真实材料模型调用前 |
| OQ-04 | 验收阈值、时延预算、资源/费用上限 | 文档工程限制仅提案，报告耗时不承诺效果 | 产品+测试+实施负责人 | M3配置定案及M5盲测前 |
| OQ-05 | “通过”阶段、预测时点、样本量与选择偏差 | probability=null | 兴邦审批负责人+建模负责人 | M6概率需求进入架构前 |
| OQ-06 | v2新仓库、云端目录、端口、容器/卷 | 暂用当前独立文档分支；不复用旧生产资源 | 项目负责人+运维 | M1迁移及任何v2部署前 |

以上待定不阻止当前文档交付；阻止相应业务实现/真实数据阶段越过门禁。用户新指令可直接关闭或调整范围，不重复请求已授权事项。

## 3. 当前阶段门检查

| 门 | 状态 / 证据缺口 |
|---|---|
| Term | 草案已列术语，待业务评审 |
| Contract | 已有候选字段/状态/错误；未生成类型或确认DDL |
| Rule | BR-01–20已拆分并标职责，待评审 |
| Exception | E-01–15有错误和文案，契约校验仍待实现 |
| Coverage | 文档AC覆盖机械检查本轮执行；新功能行为测试未实现 |
| Decision | OQ项按里程碑阻断，未宣告需求阶段全过 |

## 4. 学习与持久缺口

- 流程适配：来源文档含项目特例，最小owner是 XINGBANG-ADAPTATION.md 和根AGENTS入口；以后每次新增规范检查失效路径。当前完成文件与链接核验，不等同长期遵守效果。
- 经验数据：默认团队模式和简化案例检索容易被误认为真实学习；owner为架构/产品说明，后续演示必须标来源。
- Gitea CI：仅有GitHub YAML，runner与门禁未核验；owner运维，在首次v2合并前确认。
- 历史文档密钥：旧DELIVERY.md有遗留凭据，当前恢复快照不改历史；新仓库迁移禁止携带；凭据有效性与轮换由凭据owner另行处理，本轮未访问验证。
- 本地工具：沙箱进程初始化失败，已通过受审的升权命令完成工作；不将该环境问题误判为代码故障。