# 03-待确认问题清单

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

> **门禁**：本文件为「未闭合」时，AI **只能**改本文件，禁止生成 01/02/04，**禁止**改 `src/` 等业务代码。  
> **结构门禁**：`gate --expect questions-open` 会校验 `doc03-structure`（五章段落版、4.1–4.6、代码路径引用、P0/P1/P2 总结）；禁止 Q1–Q10 简表。详见 `docs/DOC03-QUALITY-GATE.md`。  
> **给用户**：澄清完成后，在对话里**直接粘贴确认点**即可，无需加任何前缀口令。

## 分析依据与扫描结论

> 必须引用 `source/analysis-input-scan.md`，说明后端代码、mock 数据、PRD 与现有前端代码如何共同用于本清单。

- 后端代码与接口：（填写“已发现并对照的接口/字段”，或“已扫描未发现后端代码”）
- Mock 数据：（填写“已发现并参考的文件/字段”，或“已扫描未发现 mock 数据”）
- PRD 与前端代码：（填写本次实际读取的 PRD 小节、原型及代码路径）

---

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

### 1.1 [分类名称]
**问题**：（描述现有代码与 PRD 之间的冲突、缺失或不一致）

**影响范围**：（说明这会影响哪些模块、功能或接口）

**代码位置**：（如 `src/features/project/api/project-api.ts`）

**需要确认**：
1. （具体待确认的问题点 1）
2. （具体待确认的问题点 2）

---

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

### 2.1 [功能模块名称]
**问题**：（PRD 描述了某功能，但现有代码中找不到对应的页面/路由/组件入口）

**影响范围**：（需要新增页面、新增路由、新增 API 模块等）

**需要确认**：
1. （页面入口位置、菜单位置建议）
2. （路由路径建议）
3. （权限配置需求）

---

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

### 3.1 [推测场景名称]
**假设**：（基于现有代码的推测）

**推测风险**：（这个假设可能带来的问题）

**需要确认**：
1. （验证这个假设的具体问题）

---

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

### 4.1 页面结构与路由设计
**问题**：PRD 中涉及的前端页面在现有系统中的位置、结构、路由不明确。

**需要确认**（**P0 闭合前必须逐条有结论**）：
1. 新增页面的菜单位置建议？（如：项目管理 → XXX 导入）
2. 路由路径建议？（如：`/project/xxx/import`）
3. **壳层（强制）**：独立页面 / Tab 切换 / 全屏弹窗 / Drawer？**禁止模糊「看实现方便」**
4. 若含「历史/明细/配置」子面：是同壳层 Tab，还是独立路由？
5. 面包屑导航层级？
6. 权限配置（哪些角色可访问）？

---

### 4.2 交互流程与状态反馈
**问题**：PRD 对交互细节、状态提示、异常处理的描述不够细致。

**需要确认**（**有原型/演示时对照截图逐条确认**）：
1. 数据提交后的校验反馈是实时还是提交时？
2. 按钮的 loading 状态如何展示？（按钮 loading / 全屏遮罩 / 进度条）
3. 异常数据的展示方式？（Modal 弹窗 / Drawer 抽屉 / inline 提示）
4. 是否需要预览功能？（如上传文件后预览解析结果再确认）
5. **关键交互原语（强制）**：是否存在双击编辑、行内保存、Tab 切换、历史详情入口等？须可写成 AC
6. 是否支持批量操作？
7. 异常数据是否支持导出为 Excel？

---

### 4.3 列表页改造方案
**问题**：PRD 中涉及列表页新增字段，但字段位置、筛选、排序等细节不明确。

**需要确认**：
1. 新增列的位置和顺序建议？（在哪几列之后插入）
2. 是否需要新增筛选项？（如数据来源：欢聚同步 / 萃汀导入 / 手动录入）
3. 新增字段是否支持排序？
4. 是否需要批量导出功能？
5. 是否需要行级状态标识？（如同步中 / 同步失败的 Badge）
6. **工程表格基线**：是否使用项目约定列表组件（见 `openspec/ui-engineering-baseline.json`，如有）？偏离须记 Intentional 偏差

---

### 4.4 表单设计与校验
**问题**：PRD 中涉及表单，但表单布局、必填项、联动关系、保存反馈不明确。

**需要确认**：
1. 表单展示方式？（行内编辑 / Modal 弹窗 / Drawer 抽屉）
2. 必填项、禁用逻辑、字段联动关系？
3. 保存后的反馈机制？（toast 提示 / 页面刷新 / 静默更新）
4. 是否需要表单草稿保存功能？
5. 取消操作是否需要二次确认？

---

### 4.5 组件复用与设计规范
**问题**：PRD 中描述的输入框、展示组件，是否需要封装为全局组件或遵循特定规范。

**需要确认**：
1. 是否需要封装全局组件？（如 `PercentInput`、`AmountInput`）
2. 组件命名建议？（基于现有 UI 库扩展还是独立组件）
3. 是否需要统一的数据展示组件？（如财务数据展示组件）
4. 输入框规范是否与现有系统一致？（百分比格式、金额格式）
5. 是否需要提供 composable 供表单复用？
6. **列表/表格**：是否必须复用工程基线表格（配置化，非写死某一需求）？

---

### 4.6 状态同步与数据标识
**问题**：PRD 涉及跨系统数据同步，前端如何展示同步状态、如何标识数据来源不明确。

**需要确认**：
1. 数据同步中/失败时，前端如何展示？（列表行级提示 / 详情页警告条）
2. 是否提供"重新同步"按钮？
3. 如何区分数据来源？（标签、颜色、图标）
4. 是否需要展示数据更新时间和更新来源？
5. 是否需要数据版本记录功能？

---

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

### 5.1 [文档名称]
**需要**：补充 `openspec/architecture/[文档名].md`，明确：
- （需要补充的内容 1）
- （需要补充的内容 2）

---

## 六、总结

**矛盾点数量**：X 个（断点 N1 + 起点缺失 N2 + 推测缺口 N3 + 前端专项 N4 + 知识库缺口 N5）

**阻塞优先级**：
1. **P0（必须闭合才能继续）**：
   - （列出 P0 级别的问题）

2. **P1（影响技术方案设计）**：
   - （列出 P1 级别的问题）

3. **P2（可边做边调整）**：
   - （列出 P2 级别的问题）

---

## 七、下一步行动

1. **请人工核查确认**以上问题点
2. 提供补充信息或澄清业务规则
3. 待所有 P0/P1 问题闭合后，进入"交付模式"
4. 产出最终版 `01-需求分析报告.md`、`02-改动点清单.md`、`04-技术文档草稿.md`、`05-验收清单.md`

---

**当前状态**：等待人工确认  
**预期回复格式**：逐条回答或提供相关文档链接