# 03-待确认问题清单

## SDD 模式：提问模式
**矛盾点池状态：未闭合**

> **门禁**：本文件为「未闭合」时，AI **只能**改本文件，禁止生成 01/02/04/05，**禁止**改 `src/` 等业务代码。  
> **给用户**：澄清完成后，在对话里**直接粘贴确认点**即可，无需加任何前缀口令。

---

## 分析依据与扫描结论

- 扫描记录：`source/analysis-input-scan.md`
- 后端代码：已扫描并对照 `adi-operation-api` 的 Controller、枚举与权限注解。
- Mock 数据：已扫描项目 mock/fixture 数据；未发现可复用 mock 时，以后端实现与 PRD 的差异作为问题依据。
- PRD 与前端代码：已对照 PRD 规则、现有前端路由和权限实现。

---

## 一、断点（Breakpoint）- 现有代码与 PRD 冲突或缺失

### 1.1 账期依据枚举：PRD 章节间不一致
**问题**：PRD 存在两处描述冲突：
- §账期规则配置（约 L1536）：账期依据下拉仅 **2 项**——「投放结束次月1号 / 项目结束+1天」
- §字段名称修改及合同账期逻辑更新（约 L59-67）：账期依据扩展为 **4 项**，新增「结算日期 / 开票日期」
- 后端 `AccountPeriodBasisEnum` 已实现 **4 项**（`NEXT_MONTH_FIRST_DAY_AFTER_DELIVERY_END` / `PROJECT_END_PLUS_ONE_DAY` / `SETTLEMENT_DATE` / `INVOICE_DATE`）

**影响范围**：账期规则配置页下拉选项、项目详情合同信息只读展示、账期到期日/已逾期天数计算、导出字段「账期依据」

**代码位置**：后端 `/Users/lixinxin/Desktop/Huanwang/adi-operation-api/.../AccountPeriodBasisEnum.java`；前端待建 `src/views/finance/contractPeriod/`

**需要确认**：
1. 账期规则配置页与项目详情「账期依据」展示，是否统一采用 **4 项枚举**（与后端一致）？
2. 「结算日期」「开票日期」两项是否仅欢聚合同可用，还是 ADI 手工合同同样可选？

---

### 1.2 权限码：PRD 权限树 vs 后端 @PreAuthorize 粒度不一致
**问题**：
- PRD §权限树列出 **20+ 条**中文权限（如「项目财务报表-修改上游开票状态」「详情页面-编辑BD预估」「账期规则配置-编辑按钮」等）
- 后端当前仅见 **4 个** `@PreAuthorize`：`financeReport:page`、`financeReport:detail`、`financeReport:import`、`financeReport:importConfirm`
- `ContractAccountRuleController`、`HuanjuFinanceSyncController` 及状态修改、详情编辑、红票 CRUD 等接口 **未见**细粒度权限注解

**影响范围**：按钮显隐、无权限时点击拦截、路由 `meta.code` 配置

**代码位置**：`adi-operation-api/.../finance/controller/*.java`；前端 `layout.config.ts` / `v-permissions`

**需要确认**：
1. 细粒度权限是否已在权限系统配置但 Controller 未加注解（前端按 code 控制即可）？
2. 还是 V2.3.4 仅落地上述 4 个 code，其余 PRD 权限树条目延后？
3. 账期规则配置页的查看/编辑权限 code 具体是什么？（如 `contractAccountRule:page` / `contractAccountRule:edit`？）

---

### 1.3 前端财务模块：目录脚手架存在但零实现
**问题**：`src/views/finance/projectReport/`、`contractPeriod/` 仅有空目录（`use/`、`components/` 子目录），**无任何 `.vue`/`.ts` 文件**；`config/api/modules/finance/` 不存在；路由与侧栏菜单均无「财务」入口。

**影响范围**：本次版本为 **全新页面开发**，非增量改造

**代码位置**：
- `frontend/src/views/finance/`（空脚手架）
- `frontend/src/config/router/index.ts`（无 finance 路由）
- `frontend/src/components/layout/config/layout.config.ts`（无财务菜单）

**需要确认**：
1. 是否确认按 PRD 新建一级菜单「财务」，下设「项目财务报表」「账期规则配置」两个叶子入口？
2. 目录命名是否采用现有脚手架 `projectReport` / `contractPeriod`，还是改为 `financeReport` / `accountPeriodRule`？

---

### 1.4 合同管理 vs 账期规则配置：功能边界
**问题**：系统已有 `系统 → 基础设置 → 合同管理`（`src/views/sys/base/contract/`，权限 `contract:page`）。PRD 新增独立的「账期规则配置」页，数据源为「OMS 欢聚合同 + ADI 萃汀合同」，支持内联编辑账期字段。

**影响范围**：避免与现有合同 CRUD 页职责混淆；路由/菜单落位

**需要确认**：
1. 「账期规则配置」确认为 **独立页面**（挂在「财务」下），不在「合同管理」内嵌 Tab？
2. 合同管理页是否 **不做** 账期依据/合同账期的编辑（仅账期规则配置页可改）？

---

## 二、起点缺失（Missing Starting Point）- PRD 中的流程在代码中找不到入口

### 2.1 财务一级菜单与路由
**问题**：PRD 描述「财务-项目财务报表」「账期规则配置」，但前端无对应路由、菜单、`meta.code`。

**影响范围**：需同步修改 `router/index.ts`、`layout.config.ts`、`layout-teambition.vue` 的 `default-expanded-keys`

**需要确认**：
1. 一级菜单 key/name：`finance` / 标签「财务」？
2. 子菜单与路由 name 建议：
   - 项目财务报表：`financeProjectReport`，path `/finance/project-report`，code `financeReport:page`
   - 账期规则配置：`financeContractPeriod`，path `/finance/contract-period`，code 待确认
3. 侧栏图标是否有指定（或沿用 `icon-zhihangshuju` 类报表图标）？

---

### 2.2 项目详情抽屉入口
**问题**：PRD 规定列表「项目ID」蓝色链接点击 → **右侧 Drawer** 打开详情（摘要 / 项目信息 / 回款奖励 / 合同 / BD预估 / 财务明细 Tab）。当前无列表页，无 Drawer 组件。

**影响范围**：详情壳层选型、列表与详情状态共享

**需要确认**：
1. 详情确认为 **右侧 Drawer**（非全屏弹窗、非独立路由页）？
2. Drawer 内 Tab 结构是否固定为：摘要（顶部）+ Tab（项目信息 / 财务明细 等）——以原型 `source/image/image_2.png` 为准？
3. 点击 Drawer 外遮罩关闭，是否 **不** 刷新列表（仅保存类操作后局部刷新）？

---

### 2.3 导入数据 / 导入历史入口
**问题**：PRD 描述「导入数据」主按钮 → 弹窗上传 → 确认覆盖弹窗；导入历史在弹窗内或独立区域。当前无入口。

**需要确认**：
1. 「导入历史」是导入弹窗内的 Tab/链接，还是项目财务报表页内的二级入口？
2. 导入权限：无 `financeReport:import` 时隐藏「导入数据」按钮；无 `financeReport:importConfirm` 时禁用「确认覆盖」——是否按此实现？

---

### 2.4 欢聚手动拉取按钮
**问题**：PRD §拉取欢聚最新数据按钮：列表页触发 OMS 拉取，成功 toast + 刷新列表，30 分钟冷却。后端已有 `POST /huanju-finance-sync/manual-trigger`、`GET /cooldown-remaining`。

**需要确认**：
1. 按钮放置位置：项目财务报表操作栏右侧（与筛选/导出并列）？
2. 冷却提示文案是否严格按 PRD：`已拉取成功，X分X秒后可再次拉取`？
3. 该按钮是否需要独立权限 code，还是随 `financeReport:page` 即可见？

---

## 三、推测缺口（Speculative Gap）- 基于代码的假设，需验证

### 3.1 演示原型可达性与 UI 参照优先级
**假设**：PRD §六 原型链接 `http://192.168.22.11:3000/` 为内网演示，开发期可访问并对照实现。

**推测风险**：无法访问时代码只能依赖 PRD 文字 + `source/image/image_1~5.png`，列配置等新样式可能偏差。

**需要确认**：
1. 开发环境是否可访问该原型？若不可，是否以 PRD 截图 + Confluence 图为唯一 visual 基线？
2. PRD 写明列配置「交互与现有样式不同」——是否有单独设计稿，还是完全按原型站实现？

---

### 3.2 列表表格组件基线
**假设**：项目财务报表列表沿用全局 `wTable`（`@/components/table/index.vue`），列拖拽参考 `demo/resize-table-header-demo.vue`。

**推测风险**：PRD 要求列配置 Drawer「与现有样式不同」，可能不能复用 `wTable` 默认列配置抽屉。

**需要确认**：
1. 列表主体是否 **必须** 使用 `wTable`？
2. 自定义列配置是否新建 Drawer 组件（对照原型），而非复用现有表格内置列配置？

---

### 3.3 CT 项目下游金额「编辑前/编辑后」存储
**假设**：PRD §财务明细 下游卡片写「从 OMS 取原始值，也可在 ADI 存两份数据（编辑前/后）」——存储策略由后端决定，前端只消费接口字段。

**推测风险**：若后端只返回一份合并值，前端无法实现「修改后不被 OMS 覆盖」的展示与编辑。

**需要确认**：
1. 下游可编辑字段（实际收入、应收余额、业绩净收入等）接口是否已区分「系统值 / 人工覆盖值」？
2. 前端保存走 `POST /finance/edit/saveCTFinance` 还是 `POST /finance-subject/edit-subject-detail`？字段契约是否有接口文档？

---

### 3.4 移动营销项目同步后的编辑置灰
**假设**：PRD §移动营销模块同步 要求「同步至 ADI 后编辑页所有字段置灰、删除按钮禁用」——改动点在现有 `mobileProject/addOrUpdateMobile.vue`，非财务报表页。

**推测风险**：若仅做财务报表而不同步改移动营销编辑页，验收不通过。

**需要确认**：
1. V2.3.4 前端范围是否 **包含** 移动营销项目编辑页置灰改造？
2. 置灰判定条件：项目已同步至财务报表表（后端字段标识）还是移动营销审核通过即置灰？

---

### 3.5 OTT 项目「被标记」支持修改投放金额
**假设**：PRD §编辑项目投放金额 指 OTT 项目详情中某类「被标记」项目可改投放金额，与财务报表「下单总价」联动。

**需要确认**：
1. 「被标记」的业务规则是什么（字段/状态值）？
2. 该能力是否在 **OTT 项目编辑页** 实现，还是仅在财务报表详情可改？

---

### 3.6 导出统计汇总表
**假设**：导出由后端 `POST /finance-subject/export` 生成 Excel，前端负责触发 + loading + 失败 toast；模板格式由后端按 Confluence 附件实现。

**需要确认**：
1. 导出是否 **纯后端生成**（前端不调模板）？
2. 导出埋点（操作人、时间、筛选条件）由前端上报还是后端日志即可？

---

## 四、前端专项问题 - 页面结构、交互、路由设计

### 4.1 页面结构与路由设计
**问题**：PRD 涉及 2 个主页面 + 多个弹窗/抽屉，壳层需明确。

**需要确认**（**P0 闭合前必须逐条有结论**）：
1. **项目财务报表**：独立列表页 + 右侧详情 Drawer（宽度假设为 60%~70% 视口？）
2. **账期规则配置**：独立列表页，行内双击编辑（无双击权限时无反应）
3. **导入数据**：Modal 弹窗 → 确认覆盖 Modal（嵌套或分步）
4. **修改开票/回款状态**：Modal 弹窗（列表与详情共用同一组件）
5. **BD 预估编辑**：详情 Drawer 内 Modal
6. **红票及其他**：详情 Drawer 内 Tab 区域行内编辑（非弹窗）
7. 面包屑：`财务 / 项目财务报表` 两级？

---

### 4.2 交互流程与状态反馈
**需要确认**：
1. 列表页状态矩阵：loading（表格骨架/遮罩）/ empty（无数据文案）/ error（重试）是否按全局 `wTable` 约定？
2. 保存类操作：按钮 `loading` + `v-preventReClick`（项目规范）？
3. 状态修改成功后：toast「保存成功」+ 列表行局部刷新 + 若详情 Drawer 打开则同步刷新？
4. 导入「部分成功」：右上角 **notification** 长显（PRD 原文）还是 `window.$message`？
5. 金额字段行内编辑：同一时间仅允许编辑一个字段（PRD 回款奖励模块明确要求）——是否扩展到所有可编辑金额字段？

---

### 4.3 列表页改造方案
**需要确认**：
1. 默认可见列是否按 PRD 表格「默认可见」列初始化（项目ID 固定左侧）？
2. 筛选项 14 项是否与 PRD §筛选条件 完全一致？广告主筛选是否复用 OTT 项目列表同一接口？
3. 「签约类型」标签：萃汀=紫色、欢网=蓝色——色值是否以原型为准（如 `#a855f7` / `#3b82f6`）？
4. 应收余额：正数红色、零或负数绿色——是否与 PRD 一致使用 `#ef4444` / `#10b981`？

---

### 4.4 表单设计与校验
**需要确认**：
1. 百分比输入：是否封装复用 PRD §变更记录 规则（0-100，小数最多 10 位，右侧固定 `%`）——新建 `FinancePercentInput` 还是项目级指令？
2. 金额输入：整数 9 位、小数 2 位、非负——是否与现有 `v-amount` 一致？
3. 账期规则配置「合同账期」：步进 30、最小 0——数字输入框是否用 `n-input-number`？

---

### 4.5 组件复用与设计规范
**需要确认**：
1. 列表单元格：是否按 `fe-datatable-render-component` skill 将项目ID、金额、状态、签约类型拆为独立 cell 组件（`components/cells/`）？
2. 详情摘要区 CT 双卡片 / HW 单卡片：是否独立 `FinanceDetailSummary.vue`？
3. 搜索框：关键词搜索是否复用 `ime-aware-search-input` 规范（IME 组字兼容）？

---

### 4.6 状态同步与数据标识
**需要确认**：
1. HW / CT 数据来源差异：是否在 UI 用签约类型标签区分即可，无需额外「数据来源」列？
2. 开票/回款状态「历史圆点」hover 展示变更记录：接口 `POST /finance-subject/select-modify-records` 是否已含自动切换与人工修改两种格式？
3. 用户手动改状态后系统不再自动切换——前端是否仅展示后端返回状态，无需本地状态机？

---

## 五、知识库缺口 - 需要补充的架构文档

### 5.1 财务模块 API 契约文档
**需要**：补充 `source/接口文档.md`（或后端 Swagger 导出），明确：
- `/finance-subject/page` 请求/响应字段（列表 40+ 列）
- `/finance/subject-detail` 详情结构（摘要、Tab 分区、CT 上下游）
- 导入解析预览与确认接口路径
- 错误码与 toast 文案映射

### 5.2 权限码完整映射表
**需要**：研发提供 PRD 中文权限名 → 后端 authority code 对照表，供 `layout.config.ts` 与 `v-permissions` 使用。

---

## 六、总结

**矛盾点数量**：**15** 个（断点 4 + 起点缺失 4 + 推测缺口 6 + 前端专项 0 单列 + 知识库 2；前端专项已分布在第四节各小节）

**阻塞优先级**：
1. **P0（必须闭合才能继续）**：
   - 1.1 账期依据 2 项 vs 4 项
   - 1.2 权限码粒度与 code 命名
   - 1.3 菜单/路由/目录命名确认
   - 2.1 财务一级菜单路由方案
   - 2.2 详情 Drawer 壳层与 Tab 结构
   - 3.1 原型/视觉基线参照来源
   - 4.1 各功能壳层（页/Drawer/Modal）确认

2. **P1（影响技术方案设计）**：
   - 1.4 合同管理 vs 账期规则边界
   - 3.2 列表 wTable vs 新列配置 Drawer
   - 3.3 CT 下游字段接口契约
   - 3.4 移动营销编辑页置灰范围
   - 3.5 OTT 投放金额「被标记」规则
   - 5.1 接口文档补齐

3. **P2（可边做边调整）**：
   - 3.6 导出埋点实现方
   - 4.2~4.6 交互细节色值、组件命名
   - 5.2 权限映射表文档化

---

## 七、下一步行动

1. **请人工核查确认**以上问题点
2. 提供补充信息或澄清业务规则（可直接按编号回复）
3. 待所有 P0/P1 问题闭合后，进入「交付模式」
4. 产出 `05-验收清单.md` → `04-技术文档草稿.md` → `01/02` → 闭环 `03`

---

**当前状态**：等待人工确认  
**预期回复格式**：逐条回答或提供相关文档链接（示例：`1.1 采用 4 项枚举；2.1 菜单 key=finance ...`）
