后端第一步开发完成,第一版回归测试完成

This commit is contained in:
Your Name
2026-01-31 19:09:48 +08:00
parent 11cef531bd
commit c9e75030af
26 changed files with 1686 additions and 184 deletions
+11 -7
View File
@@ -58,7 +58,7 @@
| 项目 | 说明 |
|------|------|
| **接口** | `POST /api/projects/list` |
| **说明** | 分页获取项目列表,支持按名称/编号搜索、按进度/费用筛选 |
| **说明** | 分页获取项目列表,支持按名称/编号搜索、按进度/费用筛选、时间筛选、日期异常筛选 |
| **权限** | 已登录,所有角色可访问 |
#### 请求参数
@@ -71,6 +71,10 @@
| keyword | string | 否 | 搜索关键词,与 searchType 配合使用 |
| progress | string | 否 | 项目进度筛选,取值与业务枚举一致 |
| cost | string | 否 | 项目费用筛选,取值与业务枚举一致 |
| dateFilterType | string | 否 | 时间筛选维度:`signDate`(签订日期)、`startDate`(开工日期)、`plannedCompletionDate`(计划竣工日期)、`actualCompletionDate`(实际竣工日期);仅对「日期正常」项目按 DATE 筛选 |
| dateFrom | string | 否 | 时间范围起(YYYY-MM-DD),与 dateFilterType 配合 |
| dateTo | string | 否 | 时间范围止(YYYY-MM-DD),与 dateFilterType 配合 |
| dateAbnormal | boolean | 否 | 为 true 时只返回「日期异常」项目(四个日期中任意一个非「日期正常」) |
#### 响应参数(成功,HTTP 200
@@ -261,7 +265,7 @@
| subItemCount | number | 子项个数 |
| subItemCode | string | 子项编码 |
| totalInvestment | number | 项目总投资(万元) |
| bidContractAmount | number | 中标合同金额(万元) |
| bidContractAmount | string | 中标合同金额(万元,字符串存储 |
| warrantyRatio | string \| number | 质保金比例 |
| settlementAmount | number | 结算金额(万元) |
| totalCostEstimate | number | 总成本测算 |
@@ -270,12 +274,12 @@
| ownerUnit | string | 业主单位 |
| ownerContact | string | 业主联系人及电话 |
| bidType | string | 中标形式 |
| signDate | string | 签订日期YYYY-MM-DD |
| startDate | string | 开工日期 |
| plannedCompletionDate | string | 计划竣工日期 |
| actualCompletionDate | string | 实际竣工日期 |
| signDate | string | 签订日期:有有效日期时返回 YYYY-MM-DD,否则返回原文(如「在建中」「未开工」 |
| startDate | string | 开工日期:同上 |
| plannedCompletionDate | string | 计划竣工日期:同上 |
| actualCompletionDate | string | 实际竣工日期:同上 |
| warrantyAmount | number | 质保金(万元) |
| warrantyEndDate | string | 质保期截止日 |
| warrantyEndDate | string | 质保期截止日(字符串存储) |
| actualWarrantyRefundDate | string | 实际退质保金日期 |
| projectDepartment | string | 所属项目部 |
| projectLeaderContact | string | 项目负责人及电话 |