422 lines
16 KiB
Markdown
422 lines
16 KiB
Markdown
# 信息维护页面搜索区四列栅格统一 Implementation Plan
|
||
|
||
> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**Goal:** 将信息维护同批页面的搜索区统一为每行 4 个字段位的栅格布局，超过 4 个字段自动换行，字段内部控件在所属字段位内铺满。
|
||
|
||
**Architecture:** 本次只改前端查询区模板和最小必要样式，不新增公共搜索组件，不改查询逻辑。所有目标页统一使用 `el-row` + `el-col :span="6"` 包裹查询项，最后一行不足 4 项时保留空白字段位，不对现有字段做横向拉伸。实施前先写一个临时结构校验脚本，先跑出失败，再逐类页面改造并回归真实页面。
|
||
|
||
**Tech Stack:** Vue 2, Element UI, JavaScript, Node.js, Playwright, Markdown
|
||
|
||
---
|
||
|
||
## 文件结构与职责
|
||
|
||
- `ruoyi-ui/src/views/ccdiBaseStaff/index.vue`
|
||
员工信息维护页，5 个查询字段，目标结构为 `4 + 1`。
|
||
- `ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue`
|
||
招聘信息维护页，6 个查询字段，目标结构为 `4 + 2`。
|
||
- `ruoyi-ui/src/views/ccdiStaffTransfer/index.vue`
|
||
员工调动记录页，6 个查询字段，包含日期范围控件，目标结构为 `4 + 2`。
|
||
- `ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue`
|
||
员工亲属关系维护页，4 个查询字段，目标结构为单行 4 列。
|
||
- `ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue`
|
||
员工实体关系维护页，4 个查询字段，目标结构为单行 4 列。
|
||
- `ruoyi-ui/src/views/ccdiCreditInfo/index.vue`
|
||
征信维护页，2 个查询字段，目标结构为 `2 + 2 个空白字段位`，不拉伸。
|
||
- `ruoyi-ui/src/views/ccdiEnterpriseBaseInfo/index.vue`
|
||
实体库管理页，8 个查询字段，目标结构为 `4 + 4`。
|
||
- `ruoyi-ui/src/views/ccdiIntermediary/index.vue`
|
||
中介库管理父页，保持查询逻辑与统一操作行，不接管字段渲染。
|
||
- `ruoyi-ui/src/views/ccdiIntermediary/components/SearchForm.vue`
|
||
中介库管理查询子组件，4 个查询字段，改为单行 4 列栅格。
|
||
- `ruoyi-ui/src/views/ccdiAccountInfo/index.vue`
|
||
账户库管理页，9 个查询字段，目标结构为 `4 + 4 + 1`，并清理局部查询区样式覆盖。
|
||
- `ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue`
|
||
信贷客户家庭关系页，4 个查询字段，目标结构为单行 4 列。
|
||
- `ruoyi-ui/src/views/ccdiCustEnterpriseRelation/index.vue`
|
||
信贷客户实体关联页，4 个查询字段，目标结构为单行 4 列。
|
||
- `ruoyi-ui/src/views/ccdiPurchaseTransaction/index.vue`
|
||
招投标信息维护页，4 个查询字段，包含日期范围控件，目标结构为单行 4 列。
|
||
- `output/playwright/info-maintenance-search-grid-check.js`
|
||
临时结构校验脚本，只用于本轮实现前后的失败/通过校验，不提交到 git。
|
||
- `docs/reports/implementation/2026-04-23-info-maintenance-search-grid-implementation.md`
|
||
实施记录，记录改动范围、验证命令、真实页面回归结果与进程清理情况。
|
||
|
||
## 实施原则
|
||
|
||
- 不新增公共搜索组件，不扩大为整页重构。
|
||
- 不改 `queryParams`、`handleQuery`、`resetQuery`、回车查询、权限和业务按钮逻辑。
|
||
- 搜索区字段统一改为四列栅格：每个查询项固定占 `span=6`。
|
||
- 日期范围按 1 个字段位处理，只在所属列内铺满。
|
||
- 清理查询区内联 `style="width: ...px"` 与局部查询区宽度覆盖样式，但不动弹窗和详情表单。
|
||
- 临时测试脚本放在 `output/playwright/`，不提交到 git。
|
||
- 每个阶段完成后做小步提交，提交说明使用中文。
|
||
|
||
## Task 1: 建立搜索区结构校验基线
|
||
|
||
**Files:**
|
||
- Create: `output/playwright/info-maintenance-search-grid-check.js`
|
||
- Verify: `ruoyi-ui/src/views/ccdiBaseStaff/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiStaffTransfer/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiCreditInfo/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiEnterpriseBaseInfo/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiIntermediary/components/SearchForm.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiAccountInfo/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiCustEnterpriseRelation/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiPurchaseTransaction/index.vue`
|
||
|
||
- [ ] **Step 1: 编写临时结构校验脚本**
|
||
|
||
```js
|
||
const pages = [
|
||
{ file: "ruoyi-ui/src/views/ccdiBaseStaff/index.vue", expectedFields: 5 },
|
||
{ file: "ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue", expectedFields: 6 },
|
||
{ file: "ruoyi-ui/src/views/ccdiStaffTransfer/index.vue", expectedFields: 6 },
|
||
{ file: "ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue", expectedFields: 4 },
|
||
{ file: "ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue", expectedFields: 4 },
|
||
{ file: "ruoyi-ui/src/views/ccdiCreditInfo/index.vue", expectedFields: 2 },
|
||
{ file: "ruoyi-ui/src/views/ccdiEnterpriseBaseInfo/index.vue", expectedFields: 8 },
|
||
{ file: "ruoyi-ui/src/views/ccdiIntermediary/components/SearchForm.vue", expectedFields: 4 },
|
||
{ file: "ruoyi-ui/src/views/ccdiAccountInfo/index.vue", expectedFields: 9 },
|
||
{ file: "ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue", expectedFields: 4 },
|
||
{ file: "ruoyi-ui/src/views/ccdiCustEnterpriseRelation/index.vue", expectedFields: 4 },
|
||
{ file: "ruoyi-ui/src/views/ccdiPurchaseTransaction/index.vue", expectedFields: 4 }
|
||
];
|
||
```
|
||
|
||
脚本至少检查：
|
||
- 只解析页面头部的查询表单：优先圈定首个同时包含 `ref="queryForm"` 与 `v-show="showSearch"` 的表单块；若为子组件场景，则只解析 `SearchForm.vue` 顶层查询表单
|
||
- 查询区中是否出现 `el-col :span="6"`
|
||
- 查询项数量是否匹配预期
|
||
- 查询区内是否仍保留任何 `style="width: Npx"` 的固定像素宽度
|
||
- 账户库管理页是否仍存在旧的查询区局部宽度覆盖
|
||
|
||
- [ ] **Step 2: 运行脚本，确认当前结构先失败**
|
||
|
||
Run:
|
||
```bash
|
||
source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use >/dev/null && cd .. && node output/playwright/info-maintenance-search-grid-check.js
|
||
```
|
||
|
||
Expected: FAIL，至少提示目标页面尚未统一为 `span=6` 的四列栅格，且仍存在旧的内联宽度。
|
||
|
||
- [ ] **Step 3: 不提交临时脚本**
|
||
|
||
说明：
|
||
- 脚本只用于本轮校验
|
||
- 保持在 `output/playwright/` 未跟踪状态
|
||
|
||
## Task 2: 改造字段较多的 5 个页面
|
||
|
||
**Files:**
|
||
- Modify: `ruoyi-ui/src/views/ccdiBaseStaff/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiStaffTransfer/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiEnterpriseBaseInfo/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiAccountInfo/index.vue`
|
||
|
||
- [ ] **Step 1: 将员工信息维护页查询区改为四列栅格**
|
||
|
||
```vue
|
||
<el-form ...>
|
||
<el-row :gutter="16">
|
||
<el-col :span="6">
|
||
<el-form-item label="姓名" prop="name">
|
||
<el-input v-model="queryParams.name" />
|
||
</el-form-item>
|
||
</el-col>
|
||
</el-row>
|
||
</el-form>
|
||
```
|
||
|
||
要求：
|
||
- 5 个字段落为 `4 + 1`
|
||
- 最后一行保留空白字段位，不拉伸现有字段
|
||
- 输入框、下拉框、树选择等控件在所属字段位内铺满，避免保留旧的固定像素宽度
|
||
|
||
- [ ] **Step 2: 将招聘信息维护页查询区改为四列栅格**
|
||
|
||
Run after edit:
|
||
```bash
|
||
rg -n "<el-col :span=\"6\">|style=\"width: 240px\"" ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue
|
||
```
|
||
|
||
Expected:
|
||
- 查询区出现 `el-col :span="6"`
|
||
- 查询区不再保留旧的 `240px` 固定宽度
|
||
- `el-input`、`el-select` 等控件已改为在列内铺满
|
||
|
||
- [ ] **Step 3: 将员工调动记录页查询区改为四列栅格**
|
||
|
||
要求：
|
||
- `调动日期` 的 `daterange` 只占 1 个字段位
|
||
- 仍保留 `value-format="yyyy-MM-dd"`
|
||
- `el-select`、`el-date-picker` 等控件在所属字段位内铺满
|
||
|
||
- [ ] **Step 4: 将实体库管理页查询区改为四列栅格**
|
||
|
||
要求：
|
||
- 8 个字段严格排成 `4 + 4`
|
||
- 清掉查询区的 `240px` 固定宽度
|
||
- 下拉与输入控件在各自字段位内统一铺满
|
||
|
||
- [ ] **Step 5: 将账户库管理页查询区改为四列栅格**
|
||
|
||
要求：
|
||
- 9 个字段排成 `4 + 4 + 1`
|
||
- 清理查询区中所有 `style="width: Npx"` 固定像素宽度，包括 `160px / 180px / 220px`
|
||
- 检查并同步清理底部 `.query-form ::v-deep .el-form-item` 这类会干扰四列布局的局部宽度覆盖
|
||
- `el-select` 与输入控件全部在所属字段位内铺满
|
||
|
||
- [ ] **Step 6: 运行临时结构校验脚本，确认这 5 个页面通过**
|
||
|
||
Run:
|
||
```bash
|
||
source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use >/dev/null && cd .. && node output/playwright/info-maintenance-search-grid-check.js
|
||
```
|
||
|
||
Expected: 这 5 个页面不再报栅格和固定宽度相关失败，其余未改页面仍失败。
|
||
|
||
- [ ] **Step 7: 提交第一批页面改动**
|
||
|
||
```bash
|
||
git add \
|
||
ruoyi-ui/src/views/ccdiBaseStaff/index.vue \
|
||
ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue \
|
||
ruoyi-ui/src/views/ccdiStaffTransfer/index.vue \
|
||
ruoyi-ui/src/views/ccdiEnterpriseBaseInfo/index.vue \
|
||
ruoyi-ui/src/views/ccdiAccountInfo/index.vue
|
||
git commit -m "统一信息维护复杂页面搜索区四列栅格"
|
||
```
|
||
|
||
## Task 3: 改造其余常规页面
|
||
|
||
**Files:**
|
||
- Modify: `ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiCreditInfo/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiCustEnterpriseRelation/index.vue`
|
||
- Modify: `ruoyi-ui/src/views/ccdiPurchaseTransaction/index.vue`
|
||
|
||
- [ ] **Step 1: 将员工亲属关系维护页改为单行四列**
|
||
|
||
要求：
|
||
- 4 个字段刚好占满一行
|
||
- 不改原有按钮行和表格逻辑
|
||
- 输入框和下拉框在字段位内铺满
|
||
|
||
- [ ] **Step 2: 将员工实体关系维护页改为单行四列**
|
||
|
||
要求：
|
||
- 保持现有 `label-width="120px"`
|
||
- 只替换查询区结构
|
||
- 输入框和下拉框在字段位内铺满
|
||
|
||
- [ ] **Step 3: 将征信维护页改为两字段栅格**
|
||
|
||
要求：
|
||
- 查询区仍只显示 2 个字段
|
||
- 结构上仍使用 4 列栅格
|
||
- 不把 2 个字段拉伸为 50% + 50%
|
||
- 两个输入框在各自字段位内铺满
|
||
|
||
- [ ] **Step 4: 将信贷客户家庭关系与信贷客户实体关联页改为单行四列**
|
||
|
||
Run after edit:
|
||
```bash
|
||
rg -n "<el-col :span=\"6\">|style=\"width: 240px\"" \
|
||
ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue \
|
||
ruoyi-ui/src/views/ccdiCustEnterpriseRelation/index.vue
|
||
```
|
||
|
||
Expected:
|
||
- 查询区出现 `el-col :span="6"`
|
||
- 查询区不再保留旧的 `240px` 固定宽度
|
||
- 输入框和下拉框在字段位内铺满
|
||
|
||
- [ ] **Step 5: 将招投标信息维护页改为单行四列**
|
||
|
||
要求：
|
||
- `申请日期` 的日期范围只占 1 个字段位
|
||
- 仍保留原有 `dateRange` 查询逻辑
|
||
- 输入框与日期范围控件在字段位内铺满
|
||
|
||
- [ ] **Step 6: 提交第二批页面改动**
|
||
|
||
```bash
|
||
git add \
|
||
ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue \
|
||
ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue \
|
||
ruoyi-ui/src/views/ccdiCreditInfo/index.vue \
|
||
ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue \
|
||
ruoyi-ui/src/views/ccdiCustEnterpriseRelation/index.vue \
|
||
ruoyi-ui/src/views/ccdiPurchaseTransaction/index.vue
|
||
git commit -m "统一信息维护常规页面搜索区四列栅格"
|
||
```
|
||
|
||
## Task 4: 改造中介库管理搜索组件
|
||
|
||
**Files:**
|
||
- Modify: `ruoyi-ui/src/views/ccdiIntermediary/components/SearchForm.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiIntermediary/index.vue`
|
||
|
||
- [ ] **Step 1: 将 `SearchForm.vue` 查询区改为单行四列栅格**
|
||
|
||
要求：
|
||
- 4 个查询项各占一个 `span=6`
|
||
- 保留现有 `query` 事件发射，不改父子通信
|
||
- 输入框和下拉框在字段位内铺满
|
||
|
||
- [ ] **Step 2: 清理 `SearchForm.vue` 内的固定宽度**
|
||
|
||
Run:
|
||
```bash
|
||
rg -n "width: 220px|width: 180px|width: 260px" ruoyi-ui/src/views/ccdiIntermediary/components/SearchForm.vue
|
||
```
|
||
|
||
Expected: 无结果。
|
||
|
||
- [ ] **Step 3: 确认父页 `ccdiIntermediary/index.vue` 不需要额外接管布局逻辑**
|
||
|
||
Run:
|
||
```bash
|
||
rg -n "<search-form|@query|queryParams|showSearch" ruoyi-ui/src/views/ccdiIntermediary/index.vue
|
||
```
|
||
|
||
Expected: 父页仍只负责查询参数、按钮行和列表刷新，不新增字段渲染职责。
|
||
|
||
- [ ] **Step 4: 提交中介库页面改动**
|
||
|
||
```bash
|
||
git add ruoyi-ui/src/views/ccdiIntermediary/components/SearchForm.vue
|
||
git commit -m "统一中介库管理搜索区四列栅格"
|
||
```
|
||
|
||
## Task 5: 构建校验与真实页面验证
|
||
|
||
**Files:**
|
||
- Verify: `ruoyi-ui/src/views/ccdiBaseStaff/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiEnterpriseBaseInfo/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiAccountInfo/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiCreditInfo/index.vue`
|
||
- Verify: `ruoyi-ui/src/views/ccdiIntermediary/components/SearchForm.vue`
|
||
|
||
- [ ] **Step 1: 再次运行临时结构校验脚本，确认全部页面通过**
|
||
|
||
Run:
|
||
```bash
|
||
source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use >/dev/null && cd .. && node output/playwright/info-maintenance-search-grid-check.js
|
||
```
|
||
|
||
Expected: PASS，输出“信息维护搜索区四列栅格结构校验通过”。
|
||
|
||
- [ ] **Step 2: 使用 nvm 切换前端 Node 版本**
|
||
|
||
Run:
|
||
```bash
|
||
source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use
|
||
```
|
||
|
||
Expected: 命中项目 `.nvmrc`，不使用系统默认 Node。
|
||
|
||
- [ ] **Step 3: 执行前端构建**
|
||
|
||
Run:
|
||
```bash
|
||
source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use >/dev/null && npm run build:prod
|
||
```
|
||
|
||
Expected: 构建成功，无新增模板语法错误。
|
||
|
||
- [ ] **Step 4: 启动真实前端页面**
|
||
|
||
Run:
|
||
```bash
|
||
source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use >/dev/null && npm run dev
|
||
```
|
||
|
||
Expected: 前端开发服务启动成功，可访问真实业务页面。
|
||
|
||
说明：
|
||
- 该命令需在单独终端中运行，或以后台会话方式启动后保留服务
|
||
- 不要在唯一执行终端里前台挂起后继续不下去
|
||
|
||
- [ ] **Step 5: 准备真实业务页验证所需后端**
|
||
|
||
要求：
|
||
- 优先复用已在运行的本地后端
|
||
- 若当前没有可用后端，使用 `sh bin/restart_java_backend.sh` 启动后端，不要手工执行 `java -jar`
|
||
- 若需要本轮新启动后端，同样在单独终端或后台会话中运行，确保后续还能继续执行 Playwright 验证
|
||
- 记录本轮是否由本次验证启动了后端；若是，则验证结束后要一并关闭
|
||
- 使用真实登录页完成登录，不打开 prototype 页面
|
||
- 默认测试账号可使用 `admin / admin123`（若本地环境已变更，则以当前可用测试账号为准）
|
||
|
||
- [ ] **Step 6: 使用 @playwright 打开真实业务页面验证代表页**
|
||
|
||
至少覆盖以下路由：
|
||
- `/maintain/baseStaff`
|
||
- `/maintain/enterpriseBaseInfo`
|
||
- `/maintain/accountInfo`
|
||
- `/maintain/creditInfo`
|
||
- `/maintain/intermediary`
|
||
- `/maintain/staffTransfer`
|
||
- `/maintain/purchaseTransaction`
|
||
|
||
验证点：
|
||
- 每行固定 4 个字段位
|
||
- 超过 4 个字段自动换行
|
||
- 最后一行不足 4 项时不拉伸已有字段
|
||
- 日期范围仍只占 1 个字段位
|
||
- 搜索、重置仍可正常工作
|
||
|
||
- [ ] **Step 7: 测试结束后关闭验证过程中启动的进程**
|
||
|
||
Expected:
|
||
- 不保留 `npm run dev` 相关端口占用
|
||
- 如果本轮验证启动了后端，也使用 `sh bin/restart_java_backend.sh stop` 同步关闭对应后端进程
|
||
|
||
## Task 6: 补实施记录
|
||
|
||
**Files:**
|
||
- Create: `docs/reports/implementation/2026-04-23-info-maintenance-search-grid-implementation.md`
|
||
|
||
- [ ] **Step 1: 记录改动范围**
|
||
|
||
至少包括：
|
||
- 12 个页面文件 + 1 个中介库搜索组件
|
||
- 四列栅格规则
|
||
- 最后一行不足 4 项时保留空白字段位
|
||
- 查询区固定宽度清理范围
|
||
|
||
- [ ] **Step 2: 记录验证命令与结果**
|
||
|
||
至少包括：
|
||
- `node output/playwright/info-maintenance-search-grid-check.js`
|
||
- `source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use`
|
||
- `npm run build:prod`
|
||
- Playwright 真实页面验证
|
||
- 测试结束后的进程清理
|
||
|
||
- [ ] **Step 3: 提交实施记录**
|
||
|
||
```bash
|
||
git add docs/reports/implementation/2026-04-23-info-maintenance-search-grid-implementation.md
|
||
git commit -m "补充信息维护搜索区四列栅格实施记录"
|
||
```
|
||
|
||
## 完成标准
|
||
|
||
- 范围内页面全部改为四列栅格查询区。
|
||
- 每个查询项固定占一个 `span=6` 字段位。
|
||
- 日期范围不占双列。
|
||
- 最后一行不足 4 项时保留空白字段位，不拉伸已有字段。
|
||
- 查询区不再保留任何 `style="width: Npx"` 这类旧固定像素宽度。
|
||
- 搜索、重置、回车查询、业务按钮和 `right-toolbar` 行为不变。
|
||
- 构建通过，真实页面验证通过，测试进程已清理。
|