提交
This commit is contained in:
1 parent
417d6c9c51
commit
c8fe0cdc20
102 files changed
+19847
-12224
No files matched your search
@@ -0,0 +1,52 @@
|
||||
# 发起审批钉钉式最终路径预览 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)
|
||||
|
||||
---
|
||||
@@ -73,13 +73,14 @@
|
||||
|
||||
**可勾选 type(实现时映射现有 FormCreate type 名):**
|
||||
|
||||
- 输入框:如 `input`(运算符仅 `==` / `!=`)
|
||||
- 数字:如 `inputNumber`
|
||||
- 金额:如项目内金额控件 type(若与数字共用则同一逻辑)
|
||||
- 单选:如 `radio`
|
||||
- 下拉:如 `select`
|
||||
- 日期:如 `datePicker` / `date`
|
||||
|
||||
附件、说明、布局、公式展示等控件**不展示**该开关。
|
||||
附件、说明、布局、公式展示等控件**不展示**该开关。开关位于右侧「组件配置」Tab 的基础字段区(`baseRule`),非浮层。
|
||||
|
||||
### 4.2 条件分支组(`flow_tree_json`)
|
||||
|
||||
@@ -103,7 +104,7 @@ interface ConditionGroup {
|
||||
|
||||
| 字段类型 | 可用 op |
|
||||
|----------|---------|
|
||||
| 数字 / 金额 / 日期 | `>` `>=` `<` `<=` `==` `!=` |
|
||||
| 数字 / 金额 / 日期 / 输入框 | `>` `>=` `<` `<=` `==` `!=` |
|
||||
| 单选 / 下拉 | `==` `!=` |
|
||||
|
||||
同组多条 `rules`:引擎现有逻辑拼为 **AND**(与 `oa_engine._match_condition_group` 一致)。
|
||||
|
||||
Reference in new issue
Block a user