docs: README 重写对齐现状（Java17+Solon、延安 TLS1.0 启动命令、外挂配置与安全注意事项）；tls10.security 移入 resources 随 jar 打包留底
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
Claude Code
@@ -1,10 +1,8 @@
|
||||
# Hospital Front — 医院前置机程序
|
||||
|
||||
> 基于 Kotlin + Solon 4.0.6 重构的医院前置机对接系统
|
||||
> 基于 Java 17 + Solon 4.0.6 的医院前置机对接系统
|
||||
>
|
||||
> 重构源：[hospitalmiddle](../hospitalmiddle)（SpringBoot 2.7 + MyBatis-Plus + Oracle/SqlServer）
|
||||
>
|
||||
> 完整方案：[E:\data\ob_data\myob\11 健康长庆\医院前置机重构\](../ob_data)
|
||||
> 重构源：hospitalmiddle（SpringBoot 2.7 + MyBatis-Plus + Oracle/SqlServer）
|
||||
|
||||
---
|
||||
|
||||
@@ -12,34 +10,35 @@
|
||||
|
||||
体检预约系统通过本程序与多家医院 HIS 系统对接，实现：
|
||||
- 体检预约的提交、取消
|
||||
- 体检项目查询、状态查询
|
||||
- 体检项目 / 组合查询、体检状态查询
|
||||
- 体检结果 / 结论 / 建议的获取
|
||||
- 单位信息同步
|
||||
|
||||
**支持 5 家医院**（拼音编码）：
|
||||
| 编码 | 医院名 | 数据库 |
|
||||
|---|---|---|
|
||||
| `xinglongyuan` | 兴隆园医院 | Oracle |
|
||||
| `qingyang` | 庆阳医院 | Oracle |
|
||||
| `ningxia` | 宁夏宝石花医院 | SqlServer |
|
||||
| `yanan` | 延安医院 | SqlServer |
|
||||
| `jinghe` | 泾河医院 | Oracle |
|
||||
**支持医院**（拼音编码，由 `hospital.active` 指定激活）：
|
||||
|
||||
| 编码 | 医院名 | 数据库 | Adapter |
|
||||
|---|---|---|---|
|
||||
| `xinglongyuan` | 兴隆园医院 | Oracle | `XingLongYuanAdapter` |
|
||||
| `qingyang` | 庆阳医院 | Oracle | `QingyangAdapter` |
|
||||
| `ningxia` | 宁夏宝石花医院 | SqlServer | `NingxiaAdapter` |
|
||||
| `yanan` | 延安医院 | SqlServer | `YananAdapter` |
|
||||
| `jinghe` | 泾河医院 | Oracle | `JingheAdapter` |
|
||||
|
||||
医院通过 `HospitalAdapter` 接口 + `HospitalRouter` 路由（策略模式），方言基类：
|
||||
- `BsmAdapterBase`：Oracle 方言（bsm Mapper）
|
||||
- `NxAdapterBase`：SqlServer 方言（nx Mapper）
|
||||
|
||||
---
|
||||
|
||||
## 2. 技术栈
|
||||
|
||||
- **语言**：Kotlin 2.0.21（`jvmTarget=17`）
|
||||
- **框架**：Solon 4.0.6（国产轻量级 Java 框架）
|
||||
- **JDK**：17 LTS（推荐）或 21 LTS
|
||||
- **语言**：Java 17
|
||||
- **框架**：Solon 4.0.6
|
||||
- **ORM**：MyBatis-Plus 3.5.9
|
||||
- **数据库**：Oracle / SqlServer（直连医院库，不可修改）
|
||||
- **日志**：Logback 1.5.12
|
||||
- **HTTP/WS**：OkHttp 4.12.0
|
||||
- **数据库**：Oracle（ojdbc11 + orai18n，ZHS16GBK 字符集支持）/ SqlServer（直连医院库，只读对接，不可修改表结构）
|
||||
- **日志**：Logback（异步 appender，info.log / error.log 分文件滚动）
|
||||
- **构建**：Maven 3.9+
|
||||
|
||||
> ✅ **依赖瘦身**：不接入 Knife4j / Druid / Lombok / Jasypt（详见 [01-技术栈选型.md](../ob_data/01-技术栈选型.md)）
|
||||
|
||||
---
|
||||
|
||||
## 3. 项目结构
|
||||
@@ -48,31 +47,22 @@
|
||||
hospital-front/
|
||||
├── pom.xml
|
||||
├── README.md
|
||||
├── .gitignore
|
||||
├── src/
|
||||
│ ├── main/
|
||||
│ │ ├── kotlin/com/hospital/front/
|
||||
│ │ │ ├── HospitalFrontApp.kt # @SolonMain 启动类
|
||||
│ │ │ ├── adapter/ # 医院适配器（策略模式）
|
||||
│ │ │ ├── api/ # HTTP 接口层（按业务域）
|
||||
│ │ │ ├── service/ # 业务服务层
|
||||
│ │ │ ├── mapper/ # 数据访问层
|
||||
│ │ │ ├── vo/ # 值对象
|
||||
│ │ │ ├── dto/ # 数据传输对象
|
||||
│ │ │ ├── infra/ # 基础设施
|
||||
│ │ │ └── task/ # 定时任务
|
||||
│ │ └── resources/
|
||||
│ │ ├── app.yml # Solon 主配置
|
||||
│ │ ├── logback.xml # 日志配置
|
||||
│ │ └── mapper/ # MyBatis XML
|
||||
│ └── test/kotlin/ # 单元测试
|
||||
└── pac/ # 部署包（运行时外置）
|
||||
├── bin/ # 启动脚本
|
||||
├── conf/ # 外置配置
|
||||
├── backup/ # 历史版本
|
||||
├── log/ # 日志
|
||||
├── pid/ # PID 文件
|
||||
└── tmp/ # 临时文件
|
||||
├── conf/ # 各医院外置配置（含生产凭据，不入 Git）
|
||||
└── src/main/
|
||||
├── java/com/hospital/front/
|
||||
│ ├── HospitalFrontApp.java # 启动类
|
||||
│ ├── adapter/ # 医院适配器（策略模式 + 方言基类）
|
||||
│ ├── api/ # HTTP 接口（order / admin）
|
||||
│ ├── service/ # 业务服务层
|
||||
│ ├── mapper/bsm|nx/ # 数据访问层（按方言分包）
|
||||
│ ├── vo/ dto/ # 值对象 / 传输对象
|
||||
│ ├── infra/ # 基础设施（过滤器、异常处理、扫描器）
|
||||
│ └── task/ # 定时任务（Uptime-Kuma 上报）
|
||||
└── resources/
|
||||
├── app.yml # 主配置（框架级 + 公共配置）
|
||||
├── logback.xml # 日志配置
|
||||
├── tls10.security # 延安专用 JDK 安全策略（放开 TLSv1/弱算法）
|
||||
└── mapper/ # MyBatis XML
|
||||
```
|
||||
|
||||
---
|
||||
@@ -89,57 +79,61 @@ mvn clean package -DskipTests
|
||||
## 5. 启动（开发环境）
|
||||
|
||||
```bash
|
||||
# 拷贝外置配置（首次启动）
|
||||
cp -r pac/conf-example pac/conf
|
||||
# 编辑配置
|
||||
vim pac/conf/app-jinghe.yml
|
||||
|
||||
# 启动（默认加载 app.yml + conf/app-{HOSPITAL}.yml）
|
||||
HOSPITAL=jinghe java -jar target/hospital-front-1.0.0.jar
|
||||
# 方式一：默认加载 classpath 的 app.yml（hospital.active 默认 jinghe）
|
||||
java -jar target/hospital-front-1.0.0.jar
|
||||
```
|
||||
|
||||
数据源等医院差异配置在 `app-{医院}.yml` 中，开发期可用 `--solon.config.add` 外挂。
|
||||
|
||||
---
|
||||
|
||||
## 6. 部署
|
||||
## 6. 生产部署注意事项（重要）
|
||||
|
||||
详细部署、升级、回滚 SOP：[05-部署运维.md](../ob_data/05-部署运维.md)
|
||||
### 6.1 外挂医院配置
|
||||
|
||||
**Windows Server 简版**：
|
||||
```batch
|
||||
D:
|
||||
cd D:\hospital-front\bin
|
||||
call start.bat start
|
||||
生产环境配置文件**外置于 jar 同级或 `conf/` 目录**，通过 `--solon.config.add` 追加加载，
|
||||
修改数据库地址 / 鉴权等无需重新打包：
|
||||
|
||||
```bash
|
||||
java -jar hospital-front.jar --solon.config.add=conf/app-yanan.yml --server.port=8003
|
||||
```
|
||||
|
||||
- 配置模板见仓库 `conf/` 目录（app-jinghe / app-ningxia / app-yanan）
|
||||
- `--server.port` 覆盖默认端口 8082
|
||||
- 外挂文件中必须指定 `hospital.active` 与 `hm.type`（bsm / nx / ya），并定义 `solon.dataSources.db1`
|
||||
|
||||
### 6.2 延安医院：TLS 1.0 特殊处理
|
||||
|
||||
延安 SqlServer 为老版本（仅支持 TLS 1.0 / 弱加密算法），JDK 17 默认禁用，
|
||||
必须外挂 JDK 安全属性文件启动，否则连接报 `handshake failure` / `No appropriate protocol`：
|
||||
|
||||
```bash
|
||||
java -Dfile.encoding=UTF-8 -Djava.security.properties=tls10.security -jar hospital-front.jar --solon.config.add=conf/app-yanan.yml --server.port=8003
|
||||
```
|
||||
|
||||
- `tls10.security` 已打包在 jar 内（`src/main/resources/`），上述命令按 classpath 加载，无需单独分发文件；也可用文件系统绝对路径覆盖
|
||||
- `-Dfile.encoding=UTF-8`：Windows 服务器默认 GBK，防止日志与接口中文乱码
|
||||
- 其余医院**不要**带 `tls10.security`（会全局放开弱算法，降低安全基线）
|
||||
|
||||
### 6.3 安全配置（生产必读）
|
||||
|
||||
`app.yml` 中以下配置生产环境必须核对（可在外挂配置中覆盖）：
|
||||
|
||||
| 配置 | 说明 |
|
||||
|---|---|
|
||||
| `order.basic` | `/order/**` 的 HTTP Basic 认证（`user:password`），生产必须配置 |
|
||||
| `admin.token` | `/api/admin/**` 的 `X-Admin-Token`，Agent 环回调用 |
|
||||
| `security.ipWhitelistEnabled` / `ipWhitelist` | IP 白名单（支持精确 IP / 通配段 / CIDR），端口暴露公网时务必开启 |
|
||||
| `security.trustProxy` | nginx 反代部署时开启，从 X-Forwarded-For 取真实客户端 IP |
|
||||
|
||||
### 6.4 日志
|
||||
|
||||
- 日志目录默认 `./log`（`-Dlog.path=xxx` 可覆盖）
|
||||
- `info.log`（INFO 及以上）/ `error.log`（仅 ERROR）分文件，50MB 按天滚动，保留 30 天
|
||||
- pattern 不含 `%file:%line`（AsyncAppender 下取不到调用者信息，会打成 `?:?`）
|
||||
|
||||
---
|
||||
|
||||
## 7. 文档
|
||||
|
||||
完整设计文档位于：`E:\data\ob_data\myob\11 健康长庆\医院前置机重构\`
|
||||
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
| [00-总体方案.md](../ob_data/00-总体方案.md) | 整体方案 |
|
||||
| [01-技术栈选型.md](../ob_data/01-技术栈选型.md) | Solon 选型、版本、注解对照 |
|
||||
| [02-医院差异化矩阵.md](../ob_data/02-医院差异化矩阵.md) | 5 家医院差异、Adapter 拆分 |
|
||||
| [03-架构设计.md](../ob_data/03-架构设计.md) | 系统架构、模块、时序 |
|
||||
| [04-数据流与接口契约.md](../ob_data/04-数据流与接口契约.md) | 接口清单、入参出参 |
|
||||
| [05-部署运维.md](../ob_data/05-部署运维.md) | 部署、升级、回滚 SOP |
|
||||
| [06-变更记录.md](../ob_data/06-变更记录.md) | 所有变更登记 |
|
||||
|
||||
---
|
||||
|
||||
## 8. 任务进度
|
||||
|
||||
| Step | 内容 | 状态 |
|
||||
|---|---|---|
|
||||
| 1 | 工程骨架 | ✅ |
|
||||
| 2 | 5 医院配置中心 | ⏳ |
|
||||
| 3 | 业务接口 Kotlin 重写 | ⏳ |
|
||||
| 4 | 5 套 Mapper 适配 | ⏳ |
|
||||
| 5 | 主程序被控端 API | ⏳ |
|
||||
| 6 | Agent 工程 | ⏳ |
|
||||
| 7 | 升级流程 | ⏳ |
|
||||
| 8 | 日志推送 | ⏳ |
|
||||
| 9 | B 端管理后台 | ⏳ |
|
||||
| 10 | 联调 + 文档 | ⏳ |
|
||||
@@ -0,0 +1,3 @@
|
||||
# 重新允许 TLSv1/TLSv1.1（仅本进程生效，为兼容老版 SQL Server 的登录加密）
|
||||
jdk.tls.disabledAlgorithms=SSLv3, RC4, DES, MD5withRSA, \
|
||||
DH keySize < 1024, EC keySize < 224, 3DES_EDE_CBC, anon, NULL
|
||||
Reference in New Issue
Block a user