# 发起审批钉钉式最终路径预览 Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 条件字段未齐时底部占位「必填信息填写后，流程将自动显示」；齐后只展示命中审批链。

**Architecture:** `preview_start_flow` 收集条件字段做 `resolved` 门闩；通过后 `_match_condition_group` 单路 walk。API 改为 POST 传 `formData`。前端防抖刷新 + `OaFlowPreview` 占位态。

**Tech Stack:** FastAPI / SQLAlchemy；Vue 3 + Element Plus；pytest

**Spec:** `docs/superpowers/specs/2026-07-17-oa-start-flow-preview-resolved-path-design.md`

---

## File map

| File | Responsibility |
|------|----------------|
| `backend/app/services/oa_engine.py` | 字段收集、有值判定、单路 preview walk、`resolved` 返回 |
| `backend/app/api/oa_approval.py` | POST `/templates/{id}/flow-preview` |
| `backend/tests/test_oa_flow_preview.py` | 纯函数 + preview 逻辑单测 |
| `web-admin/src/api/oaApproval.ts` | POST 客户端与类型 |
| `web-admin/src/components/oa-approval/OaFlowPreview.vue` | 待确定占位 UI |
| `web-admin/src/views/oa-approval/start/index.vue` | formData 防抖刷新 |

---

### Task 1: 后端门闩与单路 walk + 单测

**Files:**
- Modify: `backend/app/services/oa_engine.py`
- Create: `backend/tests/test_oa_flow_preview.py`
- Modify: `backend/app/api/oa_approval.py`

- [x] **Step 1:** 实现 `_collect_condition_fields`、`_form_value_present`；改 `_walk_preview_nodes` 条件分支为匹配单路；`preview_start_flow` 返回 `{resolved, message, steps}`
- [x] **Step 2:** API 改为 POST，body 含 `formData` / `initiatorSelectUserIds`；保留 GET 转调空 formData（可选兼容）
- [x] **Step 3:** 单测覆盖：无条件 resolved；有条件字段空；命中条件1；走默认
- [x] **Step 4:** `pytest backend/tests/test_oa_flow_preview.py` 通过

### Task 2: 前端 API + 预览组件 + 发起页

**Files:**
- Modify: `web-admin/src/api/oaApproval.ts`
- Modify: `web-admin/src/components/oa-approval/OaFlowPreview.vue`
- Modify: `web-admin/src/views/oa-approval/start/index.vue`

- [x] **Step 1:** `fetchOaFlowPreview` 改为 POST；类型加 `resolved` / `message`
- [x] **Step 2:** `OaFlowPreview` 支持 `resolved===false` 占位文案
- [x] **Step 3:** `start/index.vue` 传入 formData、防抖 watch、绑定 resolved/message
- [x] **Step 4:** 更新 graphify（backend + frontend）

---