# 采购、销售台账增加总合同号字段

## 涉及页面

- 采购台账管理页面
- 销售台账管理页面

## 数据库变更

执行 `docs/master_contract_no.sql` 脚本，新增以下字段：

### purchase_ledger（采购台账表）

| 字段 | 类型 | 说明 |
|------|------|------|
| master_contract_no | VARCHAR(100) | 总合同号 |

### sales_ledger（销售台账表）

| 字段 | 类型 | 说明 |
|------|------|------|
| master_contract_no | VARCHAR(100) | 总合同号 |

## API

### 采购台账分页查询

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /purchase/purchaseLedger/listPage | 采购台账分页查询 |

**新增请求参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| masterContractNo | String | 否 | 总合同号（模糊查询） |

**响应变更：**

响应数据中新增 `masterContractNo` 字段。

### 销售台账分页查询

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /sales/salesLedger/listPage | 销售台账分页查询 |

**新增请求参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| masterContractNo | String | 否 | 总合同号（模糊查询） |

**响应变更：**

响应数据中新增 `masterContractNo` 和 `purchaseMasterContractNo` 字段。

## 前端修改点

### 1. 采购台账管理页面

#### 查询表单增加字段

```html
<el-form-item label="总合同号">
  <el-input
    v-model="queryParams.masterContractNo"
    placeholder="请输入总合同号"
    clearable
    @keyup.enter="handleQuery"
  />
</el-form-item>
```

#### 表格增加列

```html
<el-table-column prop="masterContractNo" label="总合同号" min-width="150" show-overflow-tooltip />
```

#### 新增/编辑表单增加字段

```html
<el-form-item label="总合同号" prop="masterContractNo">
  <el-input v-model="form.masterContractNo" placeholder="请输入总合同号" />
</el-form-item>
```

#### data 数据

```js
data() {
  return {
    queryParams: {
      // ... 原有字段
      masterContractNo: ''
    },
    form: {
      // ... 原有字段
      masterContractNo: ''
    }
  }
}
```

### 2. 销售台账管理页面

#### 查询表单增加字段

```html
<el-form-item label="总合同号">
  <el-input
    v-model="queryParams.masterContractNo"
    placeholder="请输入总合同号"
    clearable
    @keyup.enter="handleQuery"
  />
</el-form-item>
```

#### 表格增加列

```html
<el-table-column prop="masterContractNo" label="销售总合同号" min-width="150" show-overflow-tooltip />
<el-table-column prop="purchaseMasterContractNo" label="采购总合同号" min-width="150" show-overflow-tooltip />
```

#### 新增/编辑表单增加字段

```html
<el-form-item label="总合同号" prop="masterContractNo">
  <el-input v-model="form.masterContractNo" placeholder="请输入总合同号" />
</el-form-item>
```

#### data 数据

```js
data() {
  return {
    queryParams: {
      // ... 原有字段
      masterContractNo: ''
    },
    form: {
      // ... 原有字段
      masterContractNo: ''
    }
  }
}
```

## 导出功能

导出 Excel 时会自动包含总合同号字段，无需额外修改。

## 注意事项

- 总合同号支持模糊查询，输入部分内容即可查询
- 销售台账列表页面会同时展示销售总合同号和关联采购台账的总合同号
- 新增和编辑时总合同号为非必填项，用户可根据实际情况填写