bug问题修护

docs/对外开放接口-images.md

@@ -0,0 +1,443 @@
+# 对外开放接口文档（ImagesOpenController）
+
+## 目录
+
+- [接口概览](#接口概览)
+- [通用说明](#通用说明)
+- [用户接口（Account）](#用户接口account)
+- [机构信息接口（OrgInfo）](#机构信息接口orginfo)
+- [数据模型](#数据模型)
+
+---
+
+## 接口概览
+
+> 所有接口统一前缀：`/safetyEval/images`  
+> **免登录、免鉴权**，适用于注册、短信验证等对外开放场景。
+
+| 模块 | 方法 | 路径 | 说明 |
+|------|------|------|------|
+| 用户 | `POST` | `/safetyEval/images/account/save` | 新增用户（注册） |
+| 用户 | `GET` | `/safetyEval/images/account/get` | 查询用户详情 |
+| 用户 | `POST` | `/safetyEval/images/account/modify` | 修改用户 |
+| 用户 | `POST` | `/safetyEval/images/account/delete` | 删除用户 |
+| 用户 | `GET` | `/safetyEval/images/account/page` | 分页查询用户 |
+| 用户 | `GET` | `/safetyEval/images/account/syncUserToGBS` | 用户同步 GBS |
+| 用户 | `GET` | `/safetyEval/images/account/verificationCode` | 验证码校验 |
+| 用户 | `GET` | `/safetyEval/images/account/checkTerminalType` | 校验终端类型 |
+| 用户 | `POST` | `/safetyEval/images/account/sendMessage` | 发送短信验证码 |
+| 机构 | `POST` | `/safetyEval/images/org-info/save` | 新增机构信息（注册） |
+
+---
+
+## 通用说明
+
+### 基础路径
+
+```
+开发环境: http://{host}:{port}/safetyEval/images
+生产环境: http://{gateway}/safetyEval/images
+```
+
+### 鉴权说明
+
+- 无需携带 Token / Cookie
+- 已配置 GBS 白名单：`/**/images/**`
+- 与 `/safetyEval/account/**` 内部接口功能相同，但路径不同；内部接口仍需登录
+
+### 统一响应体（SingleResponse）
+
+大部分接口返回项目自定义 `SingleResponse`：
+
+```json
+{
+  "success": true,
+  "code": "0",
+  "message": null,
+  "errMessage": null,
+  "data": {}
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `success` | boolean | 是否成功 |
+| `code` | string | 响应码，`0` 表示成功 |
+| `message` | string | 响应消息 |
+| `errMessage` | string | 错误消息（失败时） |
+| `data` | object | 业务数据 |
+
+### 分页响应体（PageResponse）
+
+```json
+{
+  "success": true,
+  "code": "0",
+  "data": [],
+  "total": 100
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `data` | array | 当前页数据列表 |
+| `total` | long | 总条数 |
+
+### 短信接口响应体（COLA SingleResponse）
+
+`sendMessage` 接口返回 GBS COLA 格式：
+
+```json
+{
+  "success": true,
+  "errCode": null,
+  "errMessage": null,
+  "data": true
+}
+```
+
+---
+
+## 用户接口（Account）
+
+### 1. 新增用户（注册）
+
+```
+POST /safetyEval/images/account/save
+Content-Type: application/json
+```
+
+**请求体（AccountAddCmd）**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `userName` | string | 否 | 用户名称/姓名 |
+| `account` | string | 否 | 账号 |
+| `phone` | string | 否 | 手机号 |
+| `password` | string | 否 | 密码 |
+| `profileUrl` | string | 否 | 头像地址 |
+| `verificationCode` | string | 否 | 短信验证码 |
+| `type` | integer | 否 | 类型：`1` 机构端，`2` 监管端（默认 `1`） |
+
+**请求示例**
+
+```json
+{
+  "userName": "张三",
+  "account": "zhangsan",
+  "phone": "13800138000",
+  "password": "a123456",
+  "verificationCode": "123456",
+  "type": 1
+}
+```
+
+**响应示例**
+
+```json
+{
+  "success": true,
+  "code": "0",
+  "data": {
+    "id": 1001,
+    "userName": "张三",
+    "account": "zhangsan",
+    "phone": "13800138000",
+    "profileUrl": null,
+    "type": 1,
+    "tenantId": 1001
+  }
+}
+```
+
+---
+
+### 2. 查询用户详情
+
+```
+GET /safetyEval/images/account/get?id={id}
+```
+
+**Query 参数**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `id` | long | 是 | 用户主键 ID |
+
+**响应**：`SingleResponse<AccountCO>`
+
+---
+
+### 3. 修改用户
+
+```
+POST /safetyEval/images/account/modify
+Content-Type: application/json
+```
+
+**请求体（AccountModifyCmd）**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `id` | long | 是 | 主键 ID |
+| `userName` | string | 否 | 用户名称/姓名 |
+| `account` | string | 否 | 账号 |
+| `phone` | string | 否 | 手机号 |
+| `password` | string | 否 | 密码 |
+| `profileUrl` | string | 否 | 头像地址 |
+| `type` | integer | 否 | 类型：`1` 机构端，`2` 监管端 |
+
+**响应**：`SingleResponse<AccountCO>`
+
+---
+
+### 4. 删除用户
+
+```
+POST /safetyEval/images/account/delete
+Content-Type: application/json
+```
+
+**请求体**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `data` | long | 是 | 用户主键 ID |
+
+**请求示例**
+
+```json
+{
+  "data": 1001
+}
+```
+
+**响应**：`SingleResponse<Void>`
+
+---
+
+### 5. 分页查询用户
+
+```
+GET /safetyEval/images/account/page
+```
+
+**Query 参数（AccountPageQuery）**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `current` | long | 否 | 当前页，默认 `1` |
+| `size` | long | 否 | 每页条数，默认 `10` |
+| `orders` | string | 否 | 排序，格式：`column:asc\|desc`，多个逗号分隔 |
+| `startTime` | datetime | 否 | 开始时间，格式 `yyyy-MM-dd HH:mm:ss` |
+| `endTime` | datetime | 否 | 结束时间，格式 `yyyy-MM-dd HH:mm:ss` |
+| `userName` | string | 否 | 用户名称（模糊） |
+| `account` | string | 否 | 账号 |
+| `phone` | string | 否 | 手机号 |
+| `type` | integer | 否 | 类型：`1` 机构端，`2` 监管端 |
+
+**请求示例**
+
+```
+GET /safetyEval/images/account/page?current=1&size=10&userName=张&type=1
+```
+
+**响应**：`PageResponse<AccountCO>`
+
+---
+
+### 6. 用户同步 GBS
+
+```
+GET /safetyEval/images/account/syncUserToGBS?account={account}
+```
+
+**Query 参数**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `account` | string | 是 | 用户账号 |
+
+**响应**：`SingleResponse<AccountCO>`
+
+---
+
+### 7. 验证码校验
+
+```
+GET /safetyEval/images/account/verificationCode?phone={phone}&code={code}
+```
+
+**Query 参数**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `phone` | string | 是 | 手机号 |
+| `code` | string | 是 | 短信验证码 |
+
+**响应**：`SingleResponse<AccountCO>`
+
+---
+
+### 8. 校验终端类型
+
+```
+GET /safetyEval/images/account/checkTerminalType
+```
+
+**说明**：校验当前用户是机构端还是监管端。
+
+**响应**：`SingleResponse<Integer>`
+
+| 返回值 | 说明 |
+|--------|------|
+| `1` | 机构端 |
+| `2` | 监管端 |
+
+---
+
+### 9. 发送短信验证码
+
+```
+POST /safetyEval/images/account/sendMessage
+Content-Type: application/json
+```
+
+**请求体（SendMessageCmd）**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `mobile` | string | **是** | 手机号 |
+| `params` | object | 否 | 消息模板参数 |
+
+**请求示例**
+
+```json
+{
+  "mobile": "13800138000"
+}
+```
+
+**响应示例**
+
+```json
+{
+  "success": true,
+  "data": true
+}
+```
+
+---
+
+## 机构信息接口（OrgInfo）
+
+### 10. 新增机构信息（注册）
+
+```
+POST /safetyEval/images/org-info/save
+Content-Type: application/json
+```
+
+**请求体（OrgInfoAddCmd）**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `unitName` | string | 否 | 生产经营单位名称 |
+| `creditCode` | string | 否 | 统一社会信用代码 |
+| `safetyIndustryCategoryCode` | string | 否 | 安全生产监管行业类别编码 |
+| `safetyIndustryCategoryName` | string | 否 | 安全生产监管行业类别名称 |
+| `districtCode` | string | 否 | 所属县区编码 |
+| `districtName` | string | 否 | 所属县区名称 |
+| `townStreet` | string | 否 | 所属镇街道 |
+| `villageCommunity` | string | 否 | 属村社区 |
+| `longitude` | decimal | 否 | 经度 |
+| `latitude` | decimal | 否 | 纬度 |
+| `registerAddress` | string | 否 | 注册地址 |
+| `businessAddress` | string | 否 | 经营地址 |
+| `ownershipTypeCode` | string | 否 | 归属类型编码 |
+| `ownershipTypeName` | string | 否 | 归属类型名称 |
+| `legalRepresentative` | string | 否 | 法定代表人 |
+| `legalRepresentativePhone` | string | 否 | 法定代表人联系电话 |
+| `principalName` | string | 否 | 主要负责人 |
+| `principalPhone` | string | 否 | 主要负责人联系电话 |
+| `safetyDeptManager` | string | 否 | 安全管理部门负责人 |
+| `safetyDeptManagerPhone` | string | 否 | 安全管理部门负责人联系电话 |
+| `safetyDeputyPhone` | string | 否 | 主管安全副总联系电话 |
+| `productionDate` | date | 否 | 投产日期，格式 `yyyy-MM-dd` |
+| `businessStatusCode` | integer | 否 | 企业经营状态编码 |
+| `businessStatusName` | string | 否 | 企业经营状态名称 |
+| `infoDisclosureUrl` | string | 否 | 信息公开网址 |
+| `workplaceArea` | decimal | 否 | 工作场所建筑面积（平方米） |
+| `archiveRoomArea` | decimal | 否 | 档案室面积（平方米） |
+| `fulltimeEvaluatorCount` | integer | 否 | 专职安全评价师数量 |
+| `registeredEngineerCount` | integer | 否 | 注册安全工程师数量 |
+| `economyIndustryCode` | string | 否 | 国民经济行业分类编码 |
+| `economyIndustryName` | string | 否 | 国民经济行业分类名称 |
+| `authStatusCode` | integer | 否 | 认证状态：`1` 填写信息，`2` 审核中，`3` 通过 |
+| `authStatusName` | string | 否 | 认证状态名称 |
+| `enterpriseStatusCode` | integer | 否 | 企业状态：`1` 正常，`2` 停业，`3` 注销 |
+| `enterpriseStatusName` | string | 否 | 企业状态名称 |
+| `enterpriseScaleCode` | string | 否 | 企业规模编码 |
+| `enterpriseScaleName` | string | 否 | 企业规模名称（大/中/小/微型） |
+| `filingTypeCode` | string | 否 | 备案类型：`1` 审核备案，`2` 确认备案 |
+| `filingTypeName` | string | 否 | 备案类型名称 |
+| `filingRecordStatusCode` | integer | 否 | 备案状态：`1` 已备案，`2` 未备案 |
+| `filingRecordStatusName` | string | 否 | 备案状态名称 |
+| `attachmentUrls` | string | 否 | 上传附件地址（多个逗号分隔） |
+| `registerUserId` | long | 否 | 注册用户 ID |
+
+**响应**：`SingleResponse<OrgInfoCO>`
+
+---
+
+## 数据模型
+
+### AccountCO
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | long | 主键 ID |
+| `userName` | string | 用户名称/姓名 |
+| `account` | string | 账号 |
+| `phone` | string | 手机号 |
+| `profileUrl` | string | 头像地址 |
+| `type` | integer | `1` 机构端，`2` 监管端 |
+| `tenantId` | long | 租户 ID |
+
+### OrgInfoCO（主要字段）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | long | 主键 ID |
+| `unitName` | string | 单位名称 |
+| `creditCode` | string | 统一社会信用代码 |
+| `authStatusCode` | integer | 认证状态编码 |
+| `enterpriseStatusCode` | integer | 企业状态编码 |
+| `filingRecordStatusCode` | integer | 备案状态编码 |
+| `state` | integer | 状态：`0` 启用，`1` 禁用 |
+| `tenantId` | long | 租户 ID |
+| `orgId` | long | 单位 ID |
+| `createTime` | datetime | 创建时间 |
+
+> `OrgInfoCO` 完整字段见 `OrgInfoAddCmd` 请求体字段及代码 `OrgInfoCO.java`。
+
+---
+
+## 与内部接口对照
+
+| 开放接口（免鉴权） | 内部接口（需登录） |
+|--------------------|--------------------|
+| `/safetyEval/images/account/save` | `/safetyEval/account/save` |
+| `/safetyEval/images/account/get` | `/safetyEval/account/get` |
+| `/safetyEval/images/account/modify` | `/safetyEval/account/modify` |
+| `/safetyEval/images/account/delete` | `/safetyEval/account/delete` |
+| `/safetyEval/images/account/page` | `/safetyEval/account/page` |
+| `/safetyEval/images/account/syncUserToGBS` | `/safetyEval/account/syncUserToGBS` |
+| `/safetyEval/images/account/verificationCode` | `/safetyEval/account/verificationCode` |
+| `/safetyEval/images/account/checkTerminalType` | `/safetyEval/account/checkTerminalType` |
+| `/safetyEval/images/account/sendMessage` | —（仅开放接口） |
+| `/safetyEval/images/org-info/save` | `/safetyEval/org-info/save` |
+
+---
+
+*文档来源：`ImagesOpenController.java`，生成时间：2026-07-08*

safety-eval-adapter/src/main/java/org/qinan/safetyeval/adapter/web/ImagesOpenController.java

@@ -8,9 +8,13 @@ import org.qinan.safetyeval.client.api.OrgInfoApi;
 import org.qinan.safetyeval.client.co.AccountCO;
 import org.qinan.safetyeval.client.co.OrgInfoCO;
 import org.qinan.safetyeval.client.dto.AccountAddCmd;
+import org.qinan.safetyeval.client.dto.AccountModifyCmd;
+import org.qinan.safetyeval.client.dto.AccountPageQuery;
 import org.qinan.safetyeval.client.dto.OrgInfoAddCmd;
+import org.qinan.safetyeval.client.dto.PageResponse;
 import org.qinan.safetyeval.client.dto.SendMessageCmd;
 import org.qinan.safetyeval.client.dto.SingleResponse;
+import org.qinan.safetyeval.infrastructure.dataobject.base.Req;
 import org.qinan.safetyeval.infrastructure.remote.SmsRemote;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -42,22 +46,36 @@ public class ImagesOpenController {
     @Resource
     private OrgInfoApi orgInfoApi;
 
-    @ApiOperation("发送短信")
+    // ==================== 用户（Account） ====================
-    @PostMapping("/sendMessage")
-    public com.alibaba.cola.dto.SingleResponse<Boolean> sendMessage(@Validated @RequestBody SendMessageCmd cmd) {
-        return smsRemote.sign(cmd.getMobile());
-    }
 
-    @ApiOperation("新增用户（注册）")
+    @ApiOperation("新增用户")
     @PostMapping("/account/save")
-    public SingleResponse<AccountCO> register(@Validated @RequestBody AccountAddCmd cmd) {
+    public SingleResponse<AccountCO> add(@Validated @RequestBody AccountAddCmd cmd) {
         return accountApi.add(cmd);
     }
 
-    @ApiOperation("新增机构信息（注册）")
+    @ApiOperation("查询用户详情")
-    @PostMapping("/org-info/save")
+    @GetMapping("/account/get")
-    public SingleResponse<OrgInfoCO> orgInfoSave(@Validated @RequestBody OrgInfoAddCmd cmd) {
+    public SingleResponse<AccountCO> get(@ApiParam("主键ID") @RequestParam Long id) {
-        return orgInfoApi.add(cmd);
+        return accountApi.get(id);
+    }
+
+    @ApiOperation("修改用户")
+    @PostMapping("/account/modify")
+    public SingleResponse<AccountCO> modify(@Validated @RequestBody AccountModifyCmd cmd) {
+        return accountApi.modify(cmd);
+    }
+
+    @ApiOperation("删除用户")
+    @PostMapping("/account/delete")
+    public SingleResponse<Void> delete(@ApiParam("主键ID") @RequestBody Req<Long> req) {
+        return accountApi.delete(req.getData());
+    }
+
+    @ApiOperation("分页查询用户")
+    @GetMapping("/account/page")
+    public PageResponse<AccountCO> page(@Validated AccountPageQuery query) {
+        return accountApi.page(query);
     }
 
     @ApiOperation("用户同步 GBS")
@@ -66,9 +84,32 @@ public class ImagesOpenController {
         return accountApi.syncUserToGBS(account);
     }
 
+    @ApiOperation("验证码校验")
+    @GetMapping("/account/verificationCode")
+    public SingleResponse<AccountCO> verificationCode(
+            @ApiParam("手机号") @RequestParam String phone,
+            @ApiParam("验证码") @RequestParam String code) {
+        return accountApi.verificationCode(phone, code);
+    }
+
+    @ApiOperation("校验用户是监管或机构: 1-机构端,2监管端")
+    @GetMapping("/account/checkTerminalType")
+    public SingleResponse<Integer> checkTerminalType() {
+//        return SingleResponse.success(1);
+        return accountApi.checkTerminalType();
+    }
+
     @ApiOperation("发送短信")
-    @PostMapping("/test")
+    @PostMapping("/account/sendMessage")
-    public SingleResponse test() {
+    public com.alibaba.cola.dto.SingleResponse<Boolean> sendMessage(@Validated @RequestBody SendMessageCmd cmd) {
-        return SingleResponse.success("hello word");
+        return smsRemote.sign(cmd.getMobile());
+    }
+
+    // ==================== 机构信息（OrgInfo） ====================
+
+    @ApiOperation("新增机构信息")
+    @PostMapping("/org-info/save")
+    public SingleResponse<OrgInfoCO> orgInfoSave(@Validated @RequestBody OrgInfoAddCmd cmd) {
+        return orgInfoApi.add(cmd);
     }
 }

safety-eval-start/src/main/resources/sdk-prod.yml

@@ -28,7 +28,18 @@
             uri: http://jjb-saas-base
             path: /${application.gateway}/container/**
             order: -2
-
+        - client:
+            system-code: ${application.name}-h5
+            name: ${application.cn-name}-h5-前端
+            group-code: public_api
+          service:
+            system-code: ${application.name}-h5
+            name: ${application.cn-name}-h5-前端
+            group-code: public_api
+            strip-prefix: 0
+            uri: http://${application.name}
+            path: /${application.gateway}-h5/**
+            order: -3
 openapi:
   appId: 2070081274042777600
   appKey: dd367066994a4e93a49e847f26462f60

safety-eval-start/src/main/resources/sdk.yml

@@ -28,6 +28,19 @@ sdk:
             uri: http://jjb-saas-base
             path: /${application.gateway}/container/**
             order: -2
+
+        - client:
+            system-code: ${application.name}-h5
+            name: ${application.cn-name}-h5-前端
+            group-code: public_api
+          service:
+            system-code: ${application.name}-h5
+            name: ${application.cn-name}-h5-前端
+            group-code: public_api
+            strip-prefix: 0
+            uri: http://${application.name}
+            path: /${application.gateway}-h5/**
+            order: -3
 openapi:
   appId: 2070081274042777600
   appKey: dd367066994a4e93a49e847f26462f60

safety-eval-start/src/main/resources/templates/safetyEval-h5.html

@@ -0,0 +1,23 @@
+<!doctype html><html lang="zh"><head data-built-info="@cqsjjb/scripts@2.0.0-rspack.2 Frontend_Env[production] Build_Date[2026/7/8 20:39:31] App_Identifier[safetyEval-h5]"><meta charset="UTF-8"/><meta name="renderer" content="webkit"/><meta http-equiv="X-UA-Compatible" content="IE=edge,Chrome=1"/><meta name="viewport" content="width=device-width,minimum-scale=1,maximum-scale=1,user-scalable=no,viewport-fit=cover"><meta charset="UTF-8" name="referrer" content="strict-origin-when-cross-origin"/><title>大屏</title><script>(function () {
+      const APP_ENV = {
+        antd: {
+          'ant-prefix': 'micro-temp',
+          fontFamily: 'PingFangSC-Regular',
+          colorPrimary: '#1677ff',
+          borderRadius: parseInt('2')
+        },
+        appKey: '',
+        basename: 'safetyEval-h5',
+        API_HOST: 'https://gbs-gateway.qhdsafety.com'
+      };
+      APP_ENV.API_HOST = sessionStorage.API_HOST || APP_ENV.API_HOST || window.location.origin;
+      window.process = {
+        env: { app: APP_ENV },
+        NODE_ENV: 'production'
+      };
+      window.__JJB_ENVIRONMENT__ = {
+        API_HOST: APP_ENV.API_HOST,
+        redirect: '',
+        FRAMEWORK: APP_ENV.antd
+      };
+    })();</script><script defer="defer" src="/safetyEval-h5/static/js/612.e6ed01a8a90b740f.js"></script><script defer="defer" src="/safetyEval-h5/static/js/923.1ecdc96702c3dc37.js"></script><script defer="defer" src="/safetyEval-h5/static/js/338.f3a903b2f40406b3.js"></script><script defer="defer" src="/safetyEval-h5/static/js/main.d348ab89e3805d77.js"></script><link href="/safetyEval-h5/static/css/main.dc38da3713049724.css" rel="stylesheet"></head><body><noscript>此网页需要开启JavaScript功能。</noscript><div id="root" style="width: 100%; height: 100%; position: relative;overflow-y: auto;"></div><script type="text/javascript">/* @cqsjjb/script 输出当前应用基本信息 */console.log("%c@cqsjjb/scripts@2.0.0-rspack.2 Frontend_Env[production] Build_Date[2026/7/8 20:39:31] App_Identifier[safetyEval-h5] Frontend_Branch[master] Backend_Branch[<branch-name>]", "color: #1890ff; border-radius: 2px; padding: 0 4px; border: 1px solid #1890ff; background: #f9fcff")</script></body><script src="https://cesium.com/downloads/cesiumjs/releases/1.91/Build/Cesium/Cesium.js"></script><link href="https://cesium.com/downloads/cesiumjs/releases/1.91/Build/Cesium/Widgets/widgets.css" rel="stylesheet"></html>