政策相关

2026-01-11 16:48:40 +08:00
parent 110bc88462
commit b4fdcfd804
14 changed files with 1154 additions and 0 deletions
--- a/docs/app-policy-info-api.md
+++ b/docs/app-policy-info-api.md
@@ -0,0 +1,153 @@
+# 政策信息移动端接口文档
+
+## 1. 获取政策列表
+
+**接口地址：** `GET /app/policyInfo/portalList`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| pageNum | Number | 是 | 页码，默认 1 |
+| pageSize | Number | 是 | 每页条数，默认 10 |
+| searchValue | String | 否 | 政策名称搜索关键词 |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+| total | Number | 总记录数 |
+| rows | Array | 政策列表数据 |
+
+**rows 数组元素字段：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| id | Number | 政策ID |
+| zcmc | String | 政策名称 |
+| zclx | String | 政策类型 |
+| zcLevel | String | 政策级别 |
+| sourceUnit | String | 发文单位 |
+| acceptUnit | String | 受理单位 |
+| publishTime | String | 发文时间 |
+| viewNum | Number | 浏览数 |
+| createTime | String | 创建时间 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "total": 100,
+  "rows": [
+    {
+      "id": 1,
+      "zcmc": "就业见习补贴",
+      "zclx": "就业政策",
+      "zcLevel": "自治区级",
+      "sourceUnit": "新疆维吾尔自治区人力资源和社会保障厅",
+      "acceptUnit": "石河子市人社局",
+      "publishTime": "2021-09-24",
+      "viewNum": 1234,
+      "createTime": "2025-01-10"
+    }
+  ]
+}
+```
+
+---
+
+## 2. 获取政策详情
+
+**接口地址：** `GET /app/policyInfo/detail/{id}`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| id | Number | 是 | 政策ID（路径参数） |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+| data | Object | 政策详情数据 |
+
+**data 字段：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| id | Number | 政策ID |
+| zcmc | String | 政策名称 |
+| zclx | String | 政策类型 |
+| zcLevel | String | 政策级别 |
+| sourceUnit | String | 发文单位 |
+| acceptUnit | String | 受理单位 |
+| publishTime | String | 发文时间 |
+| zcContent | String | 政策内容 |
+| subsidyStandard | String | 补贴标准 |
+| handleChannel | String | 经办渠道 |
+| applyCondition | String | 申报条件 |
+| fileUrl | String | 政策文件URL |
+| fileName | String | 政策文件名称 |
+| viewNum | Number | 浏览数 |
+| createTime | String | 创建时间 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {
+    "id": 1,
+    "zcmc": "就业见习补贴",
+    "zclx": "就业政策",
+    "zcLevel": "自治区级",
+    "sourceUnit": "新疆维吾尔自治区人力资源和社会保障厅",
+    "acceptUnit": "石河子市人社局",
+    "publishTime": "2021-09-24",
+    "zcContent": "支持高校毕业生和失业青年参加就业见习，提升就业能力。",
+    "subsidyStandard": "按当地最低工资标准给予见习补贴，见习单位按不低于当地最低工资标准的50%为见习人员发放岗位补助。",
+    "handleChannel": "石河子市人力资源和社会保障局就业服务窗口",
+    "applyCondition": "人社部门认定的见习单位，吸纳离校2年内未就业高校毕业生和16-24岁新疆籍失业青年参加就业见习。",
+    "fileUrl": "https://example.com/files/policy_001.pdf",
+    "fileName": "就业见习补贴政策文件.pdf",
+    "viewNum": 1234,
+    "createTime": "2025-01-10"
+  }
+}
+```
+
+---
+
+## 3. 浏览数加1
+
+**接口地址：** `POST /app/policyInfo/addViewNum/{id}`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| id | Number | 是 | 政策ID（路径参数） |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功"
+}
+```
--- a/docs/cms-policy-info-api.md
+++ b/docs/cms-policy-info-api.md
@@ -0,0 +1,335 @@
+# 政策信息CMS管理接口文档
+
+## 1. 查询政策列表
+
+**接口地址：** `GET /cms/policyInfo/list`
+
+**权限标识：** `cms:policyInfo:list`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| pageNum | Number | 否 | 页码，默认 1 |
+| pageSize | Number | 否 | 每页条数，默认 10 |
+| searchValue | String | 否 | 政策名称搜索关键词 |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+| total | Number | 总记录数 |
+| rows | Array | 政策列表数据 |
+
+**rows 数组元素字段：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| id | Number | 政策ID |
+| zcmc | String | 政策名称 |
+| zclx | String | 政策类型 |
+| zcLevel | String | 政策级别 |
+| sourceUnit | String | 发文单位 |
+| acceptUnit | String | 受理单位 |
+| publishTime | String | 发文时间 |
+| viewNum | Number | 浏览数 |
+| createTime | String | 创建时间 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "查询成功",
+  "total": 100,
+  "rows": [
+    {
+      "id": 1,
+      "zcmc": "就业见习补贴",
+      "zclx": "就业政策",
+      "zcLevel": "自治区级",
+      "sourceUnit": "新疆维吾尔自治区人力资源和社会保障厅",
+      "acceptUnit": "石河子市人社局",
+      "publishTime": "2021-09-24",
+      "viewNum": 1234,
+      "createTime": "2025-01-10 10:00:00"
+    }
+  ]
+}
+```
+
+---
+
+## 2. 获取政策详情
+
+**接口地址：** `GET /cms/policyInfo/{id}`
+
+**权限标识：** `cms:policyInfo:query`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| id | Number | 是 | 政策ID（路径参数） |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+| data | Object | 政策详情数据 |
+
+**data 字段：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| id | Number | 政策ID |
+| zcmc | String | 政策名称 |
+| zclx | String | 政策类型 |
+| zcLevel | String | 政策级别 |
+| sourceUnit | String | 发文单位 |
+| acceptUnit | String | 受理单位 |
+| publishTime | String | 发文时间 |
+| zcContent | String | 政策内容 |
+| subsidyStandard | String | 补贴标准 |
+| handleChannel | String | 经办渠道 |
+| applyCondition | String | 申报条件 |
+| fileUrl | String | 政策文件URL |
+| fileName | String | 政策文件名称 |
+| viewNum | Number | 浏览数 |
+| createBy | String | 创建者 |
+| createTime | String | 创建时间 |
+| updateBy | String | 更新者 |
+| updateTime | String | 更新时间 |
+| remark | String | 备注 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {
+    "id": 1,
+    "zcmc": "就业见习补贴",
+    "zclx": "就业政策",
+    "zcLevel": "自治区级",
+    "sourceUnit": "新疆维吾尔自治区人力资源和社会保障厅",
+    "acceptUnit": "石河子市人社局",
+    "publishTime": "2021-09-24",
+    "zcContent": "支持高校毕业生和失业青年参加就业见习，提升就业能力。",
+    "subsidyStandard": "按当地最低工资标准给予见习补贴",
+    "handleChannel": "石河子市人力资源和社会保障局就业服务窗口",
+    "applyCondition": "人社部门认定的见习单位",
+    "fileUrl": "https://example.com/files/policy_001.pdf",
+    "fileName": "就业见习补贴政策文件.pdf",
+    "viewNum": 1234,
+    "createBy": "admin",
+    "createTime": "2025-01-10 10:00:00",
+    "updateBy": null,
+    "updateTime": null,
+    "remark": null
+  }
+}
+```
+
+---
+
+## 3. 新增政策
+
+**接口地址：** `POST /cms/policyInfo`
+
+**权限标识：** `cms:policyInfo:add`
+
+**请求参数（Body JSON）：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| zcmc | String | 是 | 政策名称 |
+| zclx | String | 否 | 政策类型 |
+| zcLevel | String | 否 | 政策级别 |
+| sourceUnit | String | 否 | 发文单位 |
+| acceptUnit | String | 否 | 受理单位 |
+| publishTime | String | 否 | 发文时间（yyyy-MM-dd） |
+| zcContent | String | 否 | 政策内容 |
+| subsidyStandard | String | 否 | 补贴标准 |
+| handleChannel | String | 否 | 经办渠道 |
+| applyCondition | String | 否 | 申报条件 |
+| fileUrl | String | 否 | 政策文件URL |
+| fileName | String | 否 | 政策文件名称 |
+| remark | String | 否 | 备注 |
+
+**请求示例：**
+
+```json
+{
+  "zcmc": "就业见习补贴",
+  "zclx": "就业政策",
+  "zcLevel": "自治区级",
+  "sourceUnit": "新疆维吾尔自治区人力资源和社会保障厅",
+  "acceptUnit": "石河子市人社局",
+  "publishTime": "2021-09-24",
+  "zcContent": "支持高校毕业生和失业青年参加就业见习",
+  "subsidyStandard": "按当地最低工资标准给予见习补贴",
+  "handleChannel": "石河子市人力资源和社会保障局就业服务窗口",
+  "applyCondition": "人社部门认定的见习单位",
+  "fileUrl": "https://example.com/files/policy.pdf",
+  "fileName": "政策文件.pdf"
+}
+```
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功"
+}
+```
+
+---
+
+## 4. 修改政策
+
+**接口地址：** `PUT /cms/policyInfo`
+
+**权限标识：** `cms:policyInfo:edit`
+
+**请求参数（Body JSON）：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| id | Number | 是 | 政策ID |
+| zcmc | String | 否 | 政策名称 |
+| zclx | String | 否 | 政策类型 |
+| zcLevel | String | 否 | 政策级别 |
+| sourceUnit | String | 否 | 发文单位 |
+| acceptUnit | String | 否 | 受理单位 |
+| publishTime | String | 否 | 发文时间（yyyy-MM-dd） |
+| zcContent | String | 否 | 政策内容 |
+| subsidyStandard | String | 否 | 补贴标准 |
+| handleChannel | String | 否 | 经办渠道 |
+| applyCondition | String | 否 | 申报条件 |
+| fileUrl | String | 否 | 政策文件URL |
+| fileName | String | 否 | 政策文件名称 |
+| remark | String | 否 | 备注 |
+
+**请求示例：**
+
+```json
+{
+  "id": 1,
+  "zcmc": "就业见习补贴（修订版）",
+  "subsidyStandard": "按当地最低工资标准的120%给予见习补贴"
+}
+```
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功"
+}
+```
+
+---
+
+## 5. 删除政策
+
+**接口地址：** `DELETE /cms/policyInfo/{ids}`
+
+**权限标识：** `cms:policyInfo:remove`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| ids | String | 是 | 政策ID，多个用逗号分隔（路径参数） |
+
+**请求示例：**
+
+```
+DELETE /cms/policyInfo/1,2,3
+```
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功"
+}
+```
+
+**说明：** 删除为逻辑删除，将 del_flag 字段置为 '2'。
+
+---
+
+## 6. 上传政策文件
+
+**接口地址：** `POST /cms/policyInfo/upload`
+
+**权限标识：** `cms:policyInfo:add`
+
+**Content-Type：** `multipart/form-data`
+
+**请求参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| file | File | 是 | 上传的文件 |
+
+**响应参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | Number | 状态码，200 表示成功 |
+| msg | String | 提示信息 |
+| data | Object | 文件信息 |
+
+**data 字段：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| fileUrl | String | 文件访问URL（域名/file/+文件路径） |
+| fileName | String | 原始文件名 |
+| filePath | String | 文件相对路径 |
+
+**响应示例：**
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {
+    "fileUrl": "https://your-domain.com/file/2026/01/11/abc123def456.pdf",
+    "fileName": "就业见习补贴政策文件.pdf",
+    "filePath": "2026/01/11/abc123def456.pdf"
+  }
+}
+```
+
+**配置说明：**
+
+在 `application.yml` 中配置上传目录和域名：
+
+```yaml
+policy:
+  upload:
+    # 文件上传目录
+    path: /data/policy/files
+    # 访问域名
+    domain: https://your-domain.com
+```
+
+**Nginx配置示例：**
+
+```nginx
+location /file/ {
+    alias /data/policy/files/;
+}
+```