wkc/ccdi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b126b43e2c0b9ec8dc158ad778ab2340087de07f
ccdi/docs/plans/2026-02-11-cust-fmy-relation-frontend.md

1085 lines
32 KiB
Markdown
Raw Normal View History

feat: 优化信贷客户家庭关系页面与员工亲属关系保持一致 - 添加状态筛选条件 - 添加详情查看功能 - 添加表单状态编辑功能 - 添加查看导入失败记录按钮 - 统一按钮顺序和颜色(新增/导入/导出/查看失败记录) - 统一表单布局(分隔线、gutter、宽度800px) - 优化导入失败记录功能(分页、清除历史记录) - 统一操作按钮文字(详情/编辑/删除) - 添加创建时间格式化显示 - 添加完整导入状态管理和轮询机制
2026-02-11 16:44:28 +08:00
# 信贷客户家庭关系维护功能 - 前端实施计划
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
**目标:** 开发信贷客户家庭关系维护功能的完整前端实现,包括API接口、页面组件和交互功能
**架构:** 完全复用员工亲属关系维护功能的实现逻辑,创建独立页面组件 `ccdiCustFmyRelation`
**技术栈:** Vue 2.6.12 + Element UI 2.15.14 + Vuex 3.6.0 + Axios 0.28.1
---
## 前置条件
### 环境要求
- Node.js 14+
- npm 6+
- 现代浏览器(Chrome/Edge/Firefox)
### 依赖服务
- 后端服务已启动并运行在 `http://localhost:8080`
- 菜单权限SQL已执行,菜单已添加到系统
### 参考模块
- `ruoyi-ui/src/api/ccdiStaffFmyRelation.js` - 员工亲属关系API(参考模板)
- `ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue` - 员工亲属关系页面(参考模板)
---
## 任务列表
### Task 10: 创建API接口文件
**Files:**
- Create: `ruoyi-ui/src/api/ccdiCustFmyRelation.js`
- Reference: `ruoyi-ui/src/api/ccdiStaffFmyRelation.js`
**Step 1: 创建API文件**
创建 `ruoyi-ui/src/api/ccdiCustFmyRelation.js`:
```javascript
import request from '@/utils/request'
// 查询信贷客户家庭关系列表
export function listRelation(query) {
return request({
url: '/ccdi/custFmyRelation/list',
method: 'get',
params: query
})
}
// 查询信贷客户家庭关系详细
export function getRelation(id) {
return request({
url: '/ccdi/custFmyRelation/' + id,
method: 'get'
})
}
// 新增信贷客户家庭关系
export function addRelation(data) {
return request({
url: '/ccdi/custFmyRelation',
method: 'post',
data: data
})
}
// 修改信贷客户家庭关系
export function updateRelation(data) {
return request({
url: '/ccdi/custFmyRelation',
method: 'put',
data: data
})
}
// 删除信贷客户家庭关系
export function delRelation(ids) {
return request({
url: '/ccdi/custFmyRelation/' + ids,
method: 'delete'
})
}
// 导出信贷客户家庭关系
export function exportRelation(query) {
return request({
url: '/ccdi/custFmyRelation/export',
method: 'post',
params: query
})
}
// 下载导入模板
export function importTemplate() {
return request({
url: '/ccdi/custFmyRelation/importTemplate',
method: 'post'
})
}
// 导入信贷客户家庭关系
export function importData(file) {
const formData = new FormData()
formData.append('file', file)
return request({
url: '/ccdi/custFmyRelation/importData',
method: 'post',
data: formData
})
}
// 查询导入状态
export function getImportStatus(taskId) {
return request({
url: '/ccdi/custFmyRelation/importStatus/' + taskId,
method: 'get'
})
}
// 查询导入失败记录
export function getImportFailures(taskId, pageNum, pageSize) {
return request({
url: '/ccdi/custFmyRelation/importFailures/' + taskId,
method: 'get',
params: { pageNum, pageSize }
})
}
```
**Step 2: Commit**
```bash
git add ruoyi-ui/src/api/ccdiCustFmyRelation.js
git commit -m "feat: 添加信贷客户家庭关系API接口"
```
---
### Task 11: 创建主页面组件
**Files:**
- Create: `ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue`
- Reference: `ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue`
**Step 1: 创建页面组件**
复制 `ccdiStaffFmyRelation/index.vue`,进行以下关键修改:
1. **移除员工姓名相关功能** - 只保留信贷客户身份证号输入
2. **简化查询条件** - 移除状态下拉框
3. **修改表单** - personId改为普通输入框,不使用远程搜索
4. **修改权限标识** - 全部 `staffFmyRelation` → `custFmyRelation`
5. **修改localStorage键** - `cust_fmy_relation_import_last_task`
6. **修改字典类型引用**
完整代码结构:
```vue
<template>
<div class="app-container">
<!-- 查询条件 -->
<el-form :model="queryParams" ref="queryForm" size="small" :inline="true" v-show="showSearch">
<el-form-item label="信贷客户身份证号" prop="personId">
<el-input
v-model="queryParams.personId"
placeholder="请输入信贷客户身份证号"
clearable
style="width: 240px"
@keyup.enter.native="handleQuery"
/>
</el-form-item>
<el-form-item label="关系类型" prop="relationType">
<el-select v-model="queryParams.relationType" placeholder="请选择关系类型" clearable style="width: 240px">
<el-option
v-for="dict in dict.type.ccdi_relation_type"
:key="dict.value"
:label="dict.label"
:value="dict.value"
/>
</el-select>
</el-form-item>
<el-form-item label="关系人姓名" prop="relationName">
<el-input
v-model="queryParams.relationName"
placeholder="请输入关系人姓名"
clearable
style="width: 240px"
@keyup.enter.native="handleQuery"
/>
</el-form-item>
<el-form-item>
<el-button type="primary" icon="el-icon-search" size="mini" @click="handleQuery">搜索</el-button>
<el-button icon="el-icon-refresh" size="mini" @click="resetQuery">重置</el-button>
</el-form-item>
</el-form>
<!-- 操作按钮 -->
<el-row :gutter="10" class="mb8">
<el-col :span="1.5">
<el-button
type="primary"
plain
icon="el-icon-plus"
size="mini"
@click="handleAdd"
v-hasPermi="['ccdi:custFmyRelation:add']"
>新增</el-button>
</el-col>
<el-col :span="1.5">
<el-button
type="danger"
plain
icon="el-icon-delete"
size="mini"
:disabled="multiple"
@click="handleDelete"
v-hasPermi="['ccdi:custFmyRelation:remove']"
>删除</el-button>
</el-col>
<el-col :span="1.5">
<el-button
type="warning"
plain
icon="el-icon-download"
size="mini"
@click="handleExport"
v-hasPermi="['ccdi:custFmyRelation:export']"
>导出</el-button>
</el-col>
<el-col :span="1.5">
<el-button
type="info"
plain
icon="el-icon-upload2"
size="mini"
@click="handleImport"
v-hasPermi="['ccdi:custFmyRelation:import']"
>导入</el-button>
</el-col>
<right-toolbar :showSearch.sync="showSearch" @queryTable="getList"></right-toolbar>
</el-row>
<!-- 数据列表 -->
<el-table v-loading="loading" :data="relationList" @selection-change="handleSelectionChange">
<el-table-column type="selection" width="55" align="center" />
<el-table-column label="序号" type="index" width="50" align="center" />
<el-table-column label="信贷客户身份证号" align="center" prop="personId" width="180"/>
<el-table-column label="关系类型" align="center" prop="relationType" width="100">
<template slot-scope="scope">
<dict-tag :options="dict.type.ccdi_relation_type" :value="scope.row.relationType"/>
</template>
</el-table-column>
<el-table-column label="关系人姓名" align="center" prop="relationName" width="120"/>
<el-table-column label="性别" align="center" prop="gender" width="80">
<template slot-scope="scope">
<dict-tag :options="dict.type.ccdi_indiv_gender" :value="scope.row.gender"/>
</template>
</el-table-column>
<el-table-column label="关系人证件号码" align="center" prop="relationCertNo" width="180"/>
<el-table-column label="手机号码" align="center" prop="mobilePhone1" width="120"/>
<el-table-column label="状态" align="center" prop="status" width="80">
<template slot-scope="scope">
<el-tag :type="scope.row.status === 1 ? 'success' : 'danger'">
{{ scope.row.status === 1 ? '有效' : '无效' }}
</el-tag>
</template>
</el-table-column>
<el-table-column label="创建时间" align="center" prop="createTime" width="160"/>
<el-table-column label="操作" align="center" class-name="small-padding fixed-width" fixed="right" width="180">
<template slot-scope="scope">
<el-button
size="mini"
type="text"
icon="el-icon-edit"
@click="handleUpdate(scope.row)"
v-hasPermi="['ccdi:custFmyRelation:edit']"
>修改</el-button>
<el-button
size="mini"
type="text"
icon="el-icon-delete"
@click="handleDelete(scope.row)"
v-hasPermi="['ccdi:custFmyRelation:remove']"
>删除</el-button>
</template>
</el-table-column>
</el-table>
<!-- 分页 -->
<pagination
v-show="total>0"
:total="total"
:page.sync="queryParams.pageNum"
:limit.sync="queryParams.pageSize"
@pagination="getList"
/>
<!-- 添加/修改对话框 -->
<el-dialog :title="title" :visible.sync="open" width="900px" append-to-body>
<el-form ref="form" :model="form" :rules="rules" label-width="140px">
<el-row>
<el-col :span="12">
<el-form-item label="信贷客户身份证号" prop="personId">
<el-input
v-model="form.personId"
placeholder="请输入信贷客户身份证号"
:disabled="!isAdd"
maxlength="18"
/>
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="关系类型" prop="relationType">
<el-select v-model="form.relationType" placeholder="请选择关系类型">
<el-option
v-for="dict in dict.type.ccdi_relation_type"
:key="dict.value"
:label="dict.label"
:value="dict.value"
/>
</el-select>
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="关系人姓名" prop="relationName">
<el-input v-model="form.relationName" placeholder="请输入关系人姓名" />
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="性别" prop="gender">
<el-select v-model="form.gender" placeholder="请选择性别">
<el-option
v-for="dict in dict.type.ccdi_indiv_gender"
:key="dict.value"
:label="dict.label"
:value="dict.value"
/>
</el-select>
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="出生日期" prop="birthDate">
<el-date-picker
v-model="form.birthDate"
type="date"
placeholder="选择出生日期"
value-format="yyyy-MM-dd"
/>
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="关系人证件类型" prop="relationCertType">
<el-select v-model="form.relationCertType" placeholder="请选择证件类型">
<el-option
v-for="dict in dict.type.ccdi_certificate_type"
:key="dict.value"
:label="dict.label"
:value="dict.value"
/>
</el-select>
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="关系人证件号码" prop="relationCertNo">
<el-input v-model="form.relationCertNo" placeholder="请输入证件号码" />
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="手机号码1" prop="mobilePhone1">
<el-input v-model="form.mobilePhone1" placeholder="请输入手机号码1" />
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="手机号码2" prop="mobilePhone2">
<el-input v-model="form.mobilePhone2" placeholder="请输入手机号码2" />
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="微信名称1" prop="wechatNo1">
<el-input v-model="form.wechatNo1" placeholder="请输入微信名称1" />
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="微信名称2" prop="wechatNo2">
<el-input v-model="form.wechatNo2" placeholder="请输入微信名称2" />
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="微信名称3" prop="wechatNo3">
<el-input v-model="form.wechatNo3" placeholder="请输入微信名称3" />
</el-form-item>
</el-col>
<el-col :span="24">
<el-form-item label="详细联系地址" prop="contactAddress">
<el-input v-model="form.contactAddress" type="textarea" placeholder="请输入详细联系地址" />
</el-form-item>
</el-col>
<el-col :span="24">
<el-form-item label="关系详细描述" prop="relationDesc">
<el-input v-model="form.relationDesc" type="textarea" placeholder="请输入关系详细描述" />
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="生效日期" prop="effectiveDate">
<el-date-picker
v-model="form.effectiveDate"
type="datetime"
placeholder="选择生效日期"
value-format="yyyy-MM-dd HH:mm:ss"
/>
</el-form-item>
</el-col>
<el-col :span="12">
<el-form-item label="失效日期" prop="invalidDate">
<el-date-picker
v-model="form.invalidDate"
type="datetime"
placeholder="选择失效日期"
value-format="yyyy-MM-dd HH:mm:ss"
/>
</el-form-item>
</el-col>
<el-col :span="24">
<el-form-item label="备注" prop="remark">
<el-input v-model="form.remark" type="textarea" placeholder="请输入备注" />
</el-form-item>
</el-col>
</el-row>
</el-form>
<div slot="footer" class="dialog-footer">
<el-button type="primary" @click="submitForm">确 定</el-button>
<el-button @click="cancel">取 消</el-button>
</div>
</el-dialog>
<!-- 导入对话框 -->
<el-dialog :title="upload.title" :visible.sync="upload.open" width="400px" append-to-body>
<el-upload
ref="upload"
:limit="1"
accept=".xlsx, .xls"
:headers="upload.headers"
:action="upload.url + '?updateSupport=' + upload.updateSupport"
:disabled="upload.isUploading"
:on-progress="handleFileUploadProgress"
:on-success="handleFileSuccess"
:auto-upload="false"
drag
>
<i class="el-icon-upload"></i>
<div class="el-upload__text">将文件拖到此处,或<em>点击上传</em></div>
<div class="el-upload__tip text-center" slot="tip">
<div class="el-upload__tip">
<el-checkbox v-model="upload.updateSupport" />是否更新已经存在的关系数据
</div>
<span>仅允许导入xls、xlsx格式文件。</span>
<el-link type="primary" :underline="false" style="font-size:12px;vertical-align:baseline;" @click="importTemplate">下载模板</el-link>
</div>
</el-upload>
<div slot="footer" class="dialog-footer">
<el-button type="primary" @click="submitFileForm">确 定</el-button>
<el-button @click="upload.open = false">取 消</el-button>
</div>
</el-dialog>
<!-- 导入状态对话框 -->
<el-dialog title="导入结果" :visible.sync="importResultDialogVisible" width="800px" append-to-body>
<el-alert
:title="importResult.title"
:type="importResult.type"
:description="importResult.description"
:closable="false"
show-icon>
</el-alert>
<div v-if="importResult.failures.length > 0" style="margin-top: 20px;">
<el-divider content-position="left">失败记录</el-divider>
<el-table :data="importResult.failures" max-height="400">
<el-table-column label="行号" prop="rowNum" width="80" align="center"/>
<el-table-column label="信贷客户身份证号" prop="personId" width="180"/>
<el-table-column label="关系类型" prop="relationType" width="100"/>
<el-table-column label="关系人姓名" prop="relationName" width="120"/>
<el-table-column label="错误信息" prop="errorMessage" show-overflow-tooltip/>
</el-table>
</div>
<div slot="footer" class="dialog-footer">
<el-button @click="importResultDialogVisible = false">关 闭</el-button>
</div>
</el-dialog>
</div>
</template>
<script>
import { listRelation, getRelation, addRelation, updateRelation, delRelation, exportRelation, importTemplate, importData, getImportStatus, getImportFailures } from "@/api/ccdiCustFmyRelation";
import { getToken } from "@/utils/auth";
const STORAGE_KEY = 'cust_fmy_relation_import_last_task';
export default {
name: "CustFmyRelation",
dicts: ['ccdi_relation_type', 'ccdi_indiv_gender', 'ccdi_certificate_type'],
data() {
return {
// 遮罩层
loading: true,
// 选中数组
ids: [],
// 非单个禁用
single: true,
// 非多个禁用
multiple: true,
// 显示搜索条件
showSearch: true,
// 总条数
total: 0,
// 信贷客户家庭关系表格数据
relationList: [],
// 弹出层标题
title: "",
// 是否显示弹出层
open: false,
// 是否为新增操作
isAdd: true,
// 查询参数
queryParams: {
pageNum: 1,
pageSize: 10,
personId: null,
relationType: null,
relationName: null
},
// 表单参数
form: {},
// 表单校验
rules: {
personId: [
{ required: true, message: "信贷客户身份证号不能为空", trigger: "blur" }
],
relationType: [
{ required: true, message: "关系类型不能为空", trigger: "change" }
],
relationName: [
{ required: true, message: "关系人姓名不能为空", trigger: "blur" }
],
relationCertType: [
{ required: true, message: "关系人证件类型不能为空", trigger: "change" }
],
relationCertNo: [
{ required: true, message: "关系人证件号码不能为空", trigger: "blur" }
]
},
// 导入参数
upload: {
// 是否显示弹出层
open: false,
// 弹出层标题
title: "",
// 是否禁用上传
isUploading: false,
// 是否更新已经存在的数据
updateSupport: 0,
// 设置上传的请求头部
headers: { Authorization: "Bearer " + getToken() },
// 上传的地址
url: process.env.VUE_APP_BASE_API + "/ccdi/custFmyRelation/importData"
},
// 导入结果对话框
importResultDialogVisible: false,
importResult: {
title: '',
type: 'success',
description: '',
failures: []
}
};
},
created() {
this.getList();
},
methods: {
/** 查询信贷客户家庭关系列表 */
getList() {
this.loading = true;
listRelation(this.queryParams).then(response => {
this.relationList = response.rows;
this.total = response.total;
this.loading = false;
});
},
// 取消按钮
cancel() {
this.open = false;
this.reset();
},
// 表单重置
reset() {
this.form = {
id: null,
personId: null,
relationType: null,
relationName: null,
gender: null,
birthDate: null,
relationCertType: null,
relationCertNo: null,
mobilePhone1: null,
mobilePhone2: null,
wechatNo1: null,
wechatNo2: null,
wechatNo3: null,
contactAddress: null,
relationDesc: null,
status: 1,
effectiveDate: null,
invalidDate: null,
remark: null
};
this.resetForm("form");
},
/** 搜索按钮操作 */
handleQuery() {
this.queryParams.pageNum = 1;
this.getList();
},
/** 重置按钮操作 */
resetQuery() {
this.resetForm("queryForm");
this.handleQuery();
},
// 多选框选中数据
handleSelectionChange(selection) {
this.ids = selection.map(item => item.id);
this.single = selection.length !== 1;
this.multiple = !selection.length;
},
/** 新增按钮操作 */
handleAdd() {
this.reset();
this.open = true;
this.isAdd = true;
this.title = "添加信贷客户家庭关系";
},
/** 修改按钮操作 */
handleUpdate(row) {
this.reset();
const id = row.id || this.ids[0];
getRelation(id).then(response => {
this.form = response.data;
this.open = true;
this.isAdd = false;
this.title = "修改信贷客户家庭关系";
});
},
/** 提交按钮 */
submitForm() {
this.$refs["form"].validate(valid => {
if (valid) {
if (this.form.id != null) {
updateRelation(this.form).then(response => {
this.$modal.msgSuccess("修改成功");
this.open = false;
this.getList();
});
} else {
addRelation(this.form).then(response => {
this.$modal.msgSuccess("新增成功");
this.open = false;
this.getList();
});
}
}
});
},
/** 删除按钮操作 */
handleDelete(row) {
const ids = row.id || this.ids;
this.$modal.confirm('是否确认删除选中的数据项？').then(function() {
return delRelation(ids);
}).then(() => {
this.getList();
this.$modal.msgSuccess("删除成功");
}).catch(() => {});
},
/** 导出按钮操作 */
handleExport() {
this.download('ccdi/custFmyRelation/export', {
...this.queryParams
}, `信贷客户家庭关系_${new Date().getTime()}.xlsx`)
},
/** 导入按钮操作 */
handleImport() {
this.upload.title = "信贷客户家庭关系导入";
this.upload.open = true;
},
/** 下载模板操作 */
importTemplate() {
this.download('ccdi/custFmyRelation/importTemplate', {}, `信贷客户家庭关系导入模板_${new Date().getTime()}.xlsx`)
},
// 文件上传中处理
handleFileUploadProgress(event, file, fileList) {
this.upload.isUploading = true;
},
// 文件上传成功处理
handleFileSuccess(response, file, fileList) {
this.upload.isUploading = false;
this.upload.open = false;
this.$modal.msgSuccess("导入任务已提交,正在后台处理...");
// 保存任务ID并轮询状态
const taskId = response.data || response.taskId;
if (taskId) {
localStorage.setItem(STORAGE_KEY, taskId);
this.pollImportStatus(taskId);
}
},
// 提交上传文件
submitFileForm() {
this.$refs.upload.submit();
},
// 轮询导入状态
pollImportStatus(taskId) {
const poll = async () => {
try {
const status = await getImportStatus(taskId);
const statusData = status.data;
if (statusData && statusData.startsWith('COMPLETED')) {
const parts = statusData.split(':');
const successCount = parseInt(parts[1]);
const failureCount = parseInt(parts[2]);
// 获取失败记录
if (failureCount > 0) {
const failures = await getImportFailures(taskId, 1, 1000);
this.showImportResult(successCount, failureCount, failures.data || []);
} else {
this.showImportResult(successCount, failureCount, []);
}
this.getList();
localStorage.removeItem(STORAGE_KEY);
} else if (statusData && statusData.startsWith('FAILED')) {
this.$modal.msgError("导入失败:" + statusData.substring(6));
localStorage.removeItem(STORAGE_KEY);
} else {
// 继续轮询
setTimeout(poll, 2000);
}
} catch (error) {
console.error('查询导入状态失败', error);
}
};
poll();
},
// 显示导入结果
showImportResult(successCount, failureCount, failures) {
this.importResult.failures = failures;
if (failureCount === 0) {
this.importResult.title = '导入成功';
this.importResult.type = 'success';
this.importResult.description = `成功导入 ${successCount} 条数据`;
} else {
this.importResult.title = '导入完成';
this.importResult.type = 'warning';
this.importResult.description = `成功 ${successCount} 条,失败 ${failureCount} 条`;
}
this.importResultDialogVisible = true;
}
},
mounted() {
// 检查是否有未完成的导入任务
const lastTaskId = localStorage.getItem(STORAGE_KEY);
if (lastTaskId) {
this.pollImportStatus(lastTaskId);
}
}
};
</script>
```
**Step 2: Commit**
```bash
git add ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue
git commit -m "feat: 添加信贷客户家庭关系页面组件"
```
---
### Task 13: 配置字典数据
**前置条件:**
- 已登录系统
- 具有系统管理权限
**Step 1: 确认字典类型存在**
1. 登录系统
2. 导航到: 系统管理 → 字典管理
3. 确认以下字典类型已存在:
- `ccdi_relation_type`: 关系类型
- `ccdi_indiv_gender`: 性别
- `ccdi_certificate_type`: 证件类型
**Step 2: 添加字典数据(如不存在)**
如果字典类型不存在,参考以下数据添加:
**关系类型 (ccdi_relation_type):**
```
配偶 | 配偶
父亲 | 父亲
母亲 | 母亲
子女 | 子女
其他 | 其他
```
**性别 (ccdi_indiv_gender):**
```
M | 男
F | 女
O | 其他
```
**证件类型 (ccdi_certificate_type):**
```
身份证 | 身份证
护照 | 护照
军官证 | 军官证
其他 | 其他
```
---
## 测试验证
### Task 15: 前端功能测试
**前置条件:**
- 后端服务已启动并运行正常
- 前端服务已启动 (`npm run dev`)
- 菜单权限已配置
- 已登录系统(admin/admin123)
**Step 1: 启动前端服务**
```bash
cd ruoyi-ui
npm run dev
```
**预期结果:** 服务启动成功,访问 http://localhost
**Step 2: 登录系统**
用户名: `admin`
密码: `admin123`
**Step 3: 导航到信贷客户家庭关系页面**
路径: 信息维护 → 信贷客户家庭关系
**预期结果:** 页面正常加载,显示查询条件和列表
**Step 4: 测试新增功能**
1. 点击"新增"按钮
2. 填写表单:
- 信贷客户身份证号: `110101199001011234`
- 关系类型: `配偶`
- 关系人姓名: `张三`
- 性别: `男`
- 证件类型: `身份证`
- 证件号码: `110101199001015678`
- 手机号码1: `13800138000`
3. 点击"确定"
**预期结果:** 新增成功,列表显示新记录,弹出成功提示
**Step 5: 测试查询功能**
1. 在查询条件中输入:
- 信贷客户身份证号: `110101199001011234`
2. 点击"搜索"
**预期结果:** 列表显示符合条件的记录
**Step 6: 测试编辑功能**
1. 点击记录的"编辑"按钮
2. 修改关系人姓名为 `张三丰`
3. 点击"确定"
**预期结果:** 修改成功,列表显示更新后的数据
**Step 7: 测试删除功能**
1. 勾选一条记录
2. 点击"删除"按钮
3. 确认删除
**预期结果:** 删除成功,列表不再显示该记录
**Step 8: 测试导出功能**
1. 添加几条测试数据
2. 点击"导出"按钮
**预期结果:** 下载Excel文件,数据正确
**Step 9: 测试导入模板下载**
1. 点击"导入"按钮
2. 在导入对话框中点击"下载模板"
**预期结果:** 下载Excel模板文件,包含所有必填字段
**Step 10: 测试导入功能**
1. 准备测试数据Excel文件
2. 点击"导入"按钮
3. 上传准备好的Excel文件
4. 等待异步导入完成
**预期结果:**
- 显示导入任务已提交提示
- 导入完成后显示导入结果对话框
- 成功数据出现在列表中
- 失败数据显示在失败记录表格中
**Step 11: 测试字典显示**
验证以下字段正确显示字典标签:
- 关系类型: 显示"配偶"、"父亲"等
- 性别: 显示"男"、"女"等
- 证件类型: 显示"身份证"、"护照"等
**预期结果:** 所有字典字段正确显示标签值
**Step 12: 测试权限控制**
1. 退出登录,使用没有权限的账号登录
2. 导航到信贷客户家庭关系页面
**预期结果:** 相应的操作按钮不显示或禁用
---
### Task 16: 浏览器控制台测试
**Step 1: 打开浏览器开发者工具**
按 `F12` 打开开发者工具
**Step 2: 检查网络请求**
切换到 Network 标签,执行以下操作并检查请求:
1. **列表请求:**
- Method: `GET`
- URL: `/ccdi/custFmyRelation/list`
- Status: `200`
- Response: 包含 `rows` 和 `total`
2. **新增请求:**
- Method: `POST`
- URL: `/ccdi/custFmyRelation`
- Status: `200`
- Response: `{ "code": 200, "msg": "操作成功" }`
3. **修改请求:**
- Method: `PUT`
- URL: `/ccdi/custFmyRelation`
- Status: `200`
- Response: `{ "code": 200, "msg": "操作成功" }`
4. **删除请求:**
- Method: `DELETE`
- URL: `/ccdi/custFmyRelation/{ids}`
- Status: `200`
- Response: `{ "code": 200, "msg": "操作成功" }`
**Step 3: 检查控制台错误**
切换到 Console 标签,确认没有JavaScript错误
**预期结果:** 控制台无红色错误信息
**Step 4: 检查页面性能**
1. 切换到 Performance 标签
2. 录制页面操作
3. 检查页面渲染性能
**预期结果:** 页面响应流畅,无明显卡顿
---
## 完成检查清单
### API接口
- [ ] API文件创建完成
- [ ] 所有接口方法定义正确
- [ ] 请求路径正确(`/ccdi/custFmyRelation`)
- [ ] 请求方法正确(GET/POST/PUT/DELETE)
### 页面组件
- [ ] 页面组件创建完成
- [ ] 查询条件显示正确
- [ ] 列表数据显示正确
- [ ] 新增对话框正常
- [ ] 编辑对话框正常
- [ ] 表单验证规则正确
- [ ] 字典数据正确显示
- [ ] 权限标识正确
### 导入导出
- [ ] 导出功能正常
- [ ] 导入模板下载正常
- [ ] 导入对话框正常
- [ ] 文件上传功能正常
- [ ] 异步导入状态轮询正常
- [ ] 导入结果显示正常
- [ ] 失败记录显示正常
### 交互功能
- [ ] 分页功能正常
- [ ] 搜索功能正常
- [ ] 重置功能正常
- [ ] 多选功能正常
- [ ] 批量删除功能正常
- [ ] 单条删除功能正常
- [ ] 新增功能正常
- [ ] 编辑功能正常
- [ ] 表单验证正常
### 权限控制
- [ ] 菜单权限已配置
- [ ] 按钮权限控制生效
- [ ] 无权限时按钮不显示
### 用户体验
- [ ] 页面加载速度正常
- [ ] 操作响应及时
- [ ] 错误提示清晰
- [ ] 成功提示友好
- [ ] 控制台无错误
---
## 预期结果
完成后,前端将提供以下功能:
1. **完整的CRUD界面**
- 列表展示(分页)
- 简化查询(身份证号、关系类型、关系人姓名)
- 新增/编辑/删除/详情
2. **导入导出界面**
- 一键导出Excel
- 下载导入模板
- 文件拖拽上传
- 异步导入状态轮询
- 导入结果可视化展示
- 失败记录详细显示
3. **用户体验优化**
- 响应式布局
- 字典下拉选择
- 表单验证提示
- 加载状态提示
- 操作结果反馈
4. **权限控制**
- 菜单级权限
- 按钮级权限
- 操作前权限校验
Reference in New Issue Copy Permalink