# 信贷客户家庭关系维护功能 - 前端实施计划

> **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. **权限控制**
   - 菜单级权限
   - 按钮级权限
   - 操作前权限校验