docs: 统一文档管理规范，合并docs/到MD/目录

- 创建MD/目录结构(architecture/development/standards/specs/bugs/guides/upgrade)
- 制定文档命名规范(大写英文+下划线)
- 制定文档格式规范(元数据块、结构模板)
- 合并27个文档到MD/目录，按类别分类
- 删除旧的docs/目录
- 更新AGENTS.md铁律#5: 文档统一管理

命名规范:
- 架构设计: ARCH_<模块>_<描述>.md
- 开发计划: PLAN_<类型>_<版本>.md
- 国家标准: STD_<标准名称>.md
- 技术规范: SPEC_<类型>_<描述>.md
- Bug修复: BUG_<编号>_<描述>.md
- 使用指南: GUIDE_<主题>.md
- 升级记录: UPGRADE_<组件>_<类型>.md

MD/upgrade/BACKEND_UPGRADE_PLAN.md

@@ -0,0 +1,207 @@
+# HealthLink-HIS 后端组件升级方案
+
+> **编制日期**: 2026-06-04
+> **基线**: Spring Boot 2.5.15 + MyBatis Plus 3.5.5
+> **目标**: 升级安全漏洞组件 + 小版本迭代，不做大版本迁移
+
+---
+
+## 升级原则
+
+1. **安全优先** — BouncyCastle 等有漏洞的组件必须升
+2. **小版本优先** — 只升 patch/minor，不升 major
+3. **逐个验证** — 每升一个组件跑 `mvn clean package -DskipTests` + 启动测试
+4. **不动核心** — Spring Boot 2.5、MyBatis Plus 3.5 暂不升
+
+---
+
+## Phase 1: 安全修复（必做）
+
+### 1.1 BouncyCastle 1.69 → 1.80 🔴
+
+| 项 | 内容 |
+|---|---|
+| **风险等级** | 🔴 高 — 1.69 有 CVE 安全漏洞 |
+| **变更文件** | `healthlink-his-server/pom.xml` |
+| **当前值** | `<bcprov-jdk15on.version>1.69</bcprov-jdk15on.version>` |
+| **操作** | 删除 jdk15on，改用 jdk18on |
+| **新增依赖** | `org.bouncycastle:bcprov-jdk18on:1.80`<br>`org.bouncycastle:bcpkix-jdk18on:1.80` |
+| **代码影响** | 搜索 `rg "bcprov\|bcpkix" --type java` — 当前无直接引用，仅通过依赖传递 |
+| **验证** | `mvn compile` + 启动后检查登录/token 签发 |
+| **回滚** | 改回 `1.69` |
+
+**具体操作：**
+```xml
+<!-- 旧 -->
+<bcprov-jdk15on.version>1.69</bcprov-jdk15on.version>
+
+<!-- 新 -->
+<!-- 删除 bcprov-jdk15on.version 属性 -->
+<!-- 在 dependencyManagement 中添加 -->
+<dependency>
+    <groupId>org.bouncycastle</groupId>
+    <artifactId>bcprov-jdk18on</artifactId>
+    <version>1.80</version>
+</dependency>
+<dependency>
+    <groupId>org.bouncycastle</groupId>
+    <artifactId>bcpkix-jdk18on</artifactId>
+    <version>1.80</version>
+</dependency>
+```
+
+---
+
+## Phase 2: 连接池 & 工具库升级
+
+### 2.1 Druid 1.2.27 → 1.2.28 🟢
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟢 低 — patch 版本 |
+| **变更** | `<druid.version>1.2.27</druid.version>` → `1.2.28` |
+| **代码影响** | `DruidProperties.java` — API 无变化 |
+| **验证** | 启动后检查 Druid 监控页 `/druid/` |
+
+### 2.2 Fastjson2 2.0.58 → 2.0.61 🟢
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟢 低 — patch 版本 |
+| **变更** | `<fastjson2.version>2.0.58</fastjson2.version>` → `2.0.61` |
+| **代码影响** | 无直接引用（0 个文件），仅依赖传递 |
+| **验证** | `mvn compile` |
+
+### 2.3 Hutool 5.3.8 → 5.8.x 🟢
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟢 低 — minor 版本 |
+| **变更** | `<hutool-all.version>5.3.8</hutool-all.version>` → `5.8.35` |
+| **代码影响** | `rg "cn.hutool" --type java` — 约 10+ 文件使用 `ObjectUtil`、`StrUtil` |
+| **验证** | 检查使用 Hutool 的业务模块（预约管理等） |
+| **注意** | 5.3.8 → 5.8 跨了多个 minor，需检查 deprecated API |
+
+---
+
+## Phase 3: 监控 & IO 升级
+
+### 3.1 OSHI 6.6.5 → 6.10.0 🟢
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟢 低 — minor 版本 |
+| **变更** | `<oshi.version>6.6.5</oshi.version>` → `6.10.0` |
+| **代码影响** | `Server.java` — 使用 `SystemInfo`、`CentralProcessor`、`GlobalMemory` |
+| **验证** | 系统监控页面正常显示 CPU/内存/磁盘信息 |
+| **注意** | OSHI 6.10 API 基本兼容 6.6 |
+
+### 3.2 Commons IO 2.13.0 → 2.21.0 🟢
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟢 低 — minor 版本 |
+| **变更** | `<commons.io.version>2.13.0</commons.io.version>` → `2.21.0` |
+| **代码影响** | 无直接引用 |
+| **验证** | `mvn compile` |
+
+### 3.3 PostgreSQL Driver 42.2.27 → 42.7.x 🟢
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟢 低 |
+| **变更** | `<postgresql.version>42.2.27</postgresql.version>` → `42.7.4` |
+| **代码影响** | 无，仅 JDBC 驱动 |
+| **验证** | 启动后数据库连接正常 |
+
+---
+
+## Phase 4: 文档 & 分页
+
+### 4.1 Swagger → SpringDoc 1.8.x 🟡
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟡 中 — 不同库 |
+| **当前** | `<swagger.version>3.0.0</swagger.version>`（springfox） |
+| **目标** | springdoc-openapi 1.8.6 |
+| **操作** | 替换 springfox 依赖为 springdoc |
+| **代码影响** | `rg "swagger\|ApiModel\|ApiOperation" --type java` — 需改注解 |
+| **建议** | ⚠️ 暂不升 — 注解改造工作量大 |
+
+### 4.2 PageHelper 1.4.7 → 1.4.7 保持 🟢
+
+| 项 | 内容 |
+|---|---|
+| **建议** | 保持当前版本 — 1.4.7 稳定且够用 |
+| **原因** | 升级到 2.x 需配合 Spring Boot 4 |
+
+---
+
+## Phase 5: PDF & 签名
+
+### 5.1 itextpdf 5.5.12 → 5.5.13.4 🟢
+
+| 项 | 内容 |
+|---|---|
+| **风险** | 🟢 低 — patch 版本 |
+| **变更** | `<itextpdf.version>5.5.12</itextpdf.version>` → `5.5.13.4` |
+| **代码影响** | PDF 生成相关 |
+
+### 5.2 Kernel 7.1.2 → 7.1.2 保持 🟢
+
+| 项 | 内容 |
+|---|---|
+| **建议** | 保持 — 已是较新版本 |
+
+---
+
+## 执行计划
+
+```
+Day 1:  Phase 1 (BouncyCastle) + Phase 2 (Druid/Fastjson2/Hutool)
+        → mvn clean package -DskipTests
+        → 启动测试
+
+Day 2:  Phase 3 (OSHI/PostgreSQL/Commons IO)
+        → mvn clean package -DskipTests
+        → 启动测试 + 系统监控验证
+
+Day 3:  Phase 5 (itextpdf)
+        → mvn clean package -DskipTests
+        → PDF 功能验证
+```
+
+---
+
+## 版本对照表
+
+| 组件 | 当前 | 升级到 | 类型 | 状态 |
+|---|---|---|---|---|
+| Spring Boot | 2.5.15 | 保持 | major | 🔒 暂不动 |
+| MyBatis Plus | 3.5.5 | 保持 | major | 🔒 暂不动 |
+| PageHelper | 1.4.7 | 保持 | major | 🔒 暂不动 |
+| **BouncyCastle** | **1.69** | **1.80** | major | 🔴 **必做** |
+| **Druid** | **1.2.27** | **1.2.28** | patch | 🟢 **可做** |
+| **Fastjson2** | **2.0.58** | **2.0.61** | patch | 🟢 **可做** |
+| **Hutool** | **5.3.8** | **5.8.35** | minor | 🟢 **可做** |
+| **OSHI** | **6.6.5** | **6.10.0** | minor | 🟢 **可做** |
+| **Commons IO** | **2.13.0** | **2.21.0** | minor | 🟢 **可做** |
+| **PostgreSQL** | **42.2.27** | **42.7.4** | minor | 🟢 **可做** |
+| **itextpdf** | **5.5.12** | **5.5.13.4** | patch | 🟢 **可做** |
+| Swagger/SpringDoc | 3.0.0 | 1.8.6 | 不同库 | ⚠️ 暂不动 |
+
+---
+
+## 验证清单
+
+每次升级后检查：
+
+- [ ] `mvn clean package -DskipTests` 编译通过
+- [ ] 启动无报错
+- [ ] 登录功能正常
+- [ ] Druid 监控页 `/druid/` 可访问
+- [ ] 系统监控页正常（OSHI 升级时）
+- [ ] PDF 导出正常（itextpdf 升级时）
+- [ ] 数据库连接正常
+

MD/upgrade/MYBATIS_PLUS_UPGRADE.md

@@ -0,0 +1,188 @@
+# MyBatis Plus 升级方案
+
+> **编制日期**: 2026-06-04
+> **当前版本**: 3.5.5
+> **目标版本**: 3.5.16 (最新稳定版, 2026-01-11)
+> **Spring Boot**: 2.5.15（保持不变，不升级）
+
+---
+
+## 一、兼容性分析
+
+### 关键发现
+
+| 项目 | 3.5.5 | 3.5.16 | 结论 |
+|---|---|---|---|
+| `mybatis-spring` | 2.1.2 | 2.1.2 | ✅ 一致 |
+| `spring-boot-dependencies` BOM | 2.7.15 | 2.7.18 | ⚠️ BOM 导入，需处理 |
+| `mybatis-plus-boot-starter` | 存在 | 存在 | ✅ 兼容 Spring Boot 2.x |
+| `mybatis-plus-spring-boot3-starter` | 存在 | 存在 | 我们不用 |
+
+### BOM 冲突处理
+
+MyBatis Plus 3.5.16 的 `mybatis-plus-boot-starter` 在 `dependencyManagement` 中导入了 `spring-boot-dependencies:2.7.18` BOM。这**可能覆盖**我们项目中由 `spring-boot-starter-parent:2.5.15` 管理的依赖版本。
+
+**解决方案：在父 pom.xml 中显式锁定关键依赖版本**
+
+```xml
+<!-- 在 healthlink-his-server/pom.xml 的 <properties> 中添加 -->
+<!-- 锁定 Spring Boot 管理的核心依赖版本，防止被 BOM 覆盖 -->
+<spring-boot.version>2.5.15</spring-boot.version>
+<spring-boot-dependencies.version>2.5.15</spring-boot-dependencies.version>
+```
+
+**更安全的方案：在父 pom.xml 中覆盖 BOM**
+
+```xml
+<!-- 在 <dependencyManagement> 中添加，优先级高于 BOM 导入 -->
+<dependencyManagement>
+    <dependencies>
+        <!-- 覆盖 Spring Boot BOM，锁定 2.5.15 -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-dependencies</artifactId>
+            <version>${spring-boot.version}</version>
+            <type>pom</type>
+            <scope>import</scope>
+        </dependency>
+    </dependencies>
+</dependencyManagement>
+```
+
+---
+
+## 二、升级收益
+
+### 🔴 重要 Bug 修复
+
+| Bug | 影响 |
+|---|---|
+| 多租户查询问题 | ⭐⭐⭐ 我们用了多租户插件 |
+| 租户插件 exists 语句失效 | ⭐⭐⭐ exists 子查询场景 |
+| 逻辑删除 + 乐观锁冲突 | ⭐⭐⭐ 我们同时用了这两个特性 |
+| 批量操作异步异常 | ⭐⭐ 批量导入场景 |
+| Db count 返回 null 空指针 | ⭐⭐ 统计查询 |
+| 动态 SQL 注释导致合并错误 | ⭐⭐ 复杂 SQL |
+
+### 🟢 新增能力
+
+| 功能 | 说明 |
+|---|---|
+| `LambdaUpdateWrapper.setIncrBy/setDecrBy` | 字段自增自减 |
+| `BaseMapper` 批量操作 + `InsertOrUpdate` | 批量导入增强 |
+| `UpdateWrapper.checkSqlInjection` | SQL 注入防护 |
+| `deleteByIds` 空集合处理 | 防空指针 |
+| `DynamicTableNameJsqlParserInnerInterceptor` | 动态表处理 |
+| `OrderItem.withExpression` | 表达式排序 |
+
+### 📦 自动获得的依赖升级
+
+| 组件 | 旧版本 | 新版本 |
+|---|---|---|
+| MyBatis | 3.5.13 | 3.5.19 |
+| JSqlParser | 4.6 | 5.2 |
+| jackson | 2.16 | 2.20.1 |
+| PostgreSQL | 42.2.27 | 42.7.8 |
+
+---
+
+## 三、升级步骤
+
+### Step 1: 修改版本号
+
+```xml
+<!-- pom.xml -->
+<mybatis-plus.version>3.5.5</mybatis-plus.version>
+<!-- 改为 -->
+<mybatis-plus.version>3.5.16</mybatis-plus.version>
+```
+
+### Step 2: 添加 BOM 覆盖（关键！）
+
+在 `healthlink-his-server/pom.xml` 的 `<dependencyManagement>` 中添加：
+
+```xml
+<!-- 覆盖 MyBatis Plus 导入的 Spring Boot BOM，保持 2.5.15 -->
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-dependencies</artifactId>
+    <version>2.5.15</version>
+    <type>pom</type>
+    <scope>import</scope>
+</dependency>
+```
+
+### Step 3: 编译验证
+
+```bash
+cd healthlink-his-server
+mvn clean compile -DskipTests
+```
+
+### Step 4: 功能验证清单
+
+| 验证项 | 测试方法 | 通过标准 |
+|---|---|---|
+| 登录 | 输入账号密码 | 登录成功 |
+| 分页查询 | 访问列表页 | 分页正常 |
+| 新增 | 提交表单 | 数据写入 |
+| 编辑 | 修改并保存 | 数据更新 |
+| 删除 | 删除记录 | 软删除成功 |
+| 批量操作 | 批量新增/删除 | 全部成功 |
+| 多租户 | 切换租户 | 数据隔离正确 |
+| 乐观锁 | 并发更新 | 冲突检测正确 |
+| 导出 | Excel 导出 | 文件正常 |
+
+### Step 5: 提交代码
+
+```bash
+git add healthlink-his-server/pom.xml
+git commit -m "chore(deps): MyBatis Plus 3.5.5 → 3.5.16"
+git push origin develop
+```
+
+---
+
+## 四、回滚方案
+
+如果升级后出现问题：
+
+```bash
+# 1. 改回旧版本
+<mybatis-plus.version>3.5.5</mybatis-plus.version>
+
+# 2. 删除 BOM 覆盖（如果添加了）
+
+# 3. 重新编译
+mvn clean package -DskipTests
+
+# 4. 重启服务
+```
+
+---
+
+## 五、风险评估
+
+| 风险 | 概率 | 影响 | 缓解措施 |
+|---|---|---|---|
+| BOM 版本覆盖 | 中 | 高 | 显式锁定 Spring Boot 版本 |
+| 依赖冲突 | 低 | 中 | `mvn dependency:tree` 检查 |
+| API 变化 | 低 | 低 | 3.5.x 无 Breaking Changes |
+| 分页插件变化 | 低 | 中 | 测试分页查询 |
+
+---
+
+## 六、执行计划
+
+```
+Step 1: 修改版本号 (2 分钟)
+Step 2: 添加 BOM 覆盖 (2 分钟)
+Step 3: mvn clean compile (2 分钟)
+Step 4: mvn clean package -DskipTests (2 分钟)
+Step 5: 重启后端 (1 分钟)
+Step 6: 功能验证 (30 分钟)
+Step 7: 提交代码 (1 分钟)
+```
+
+**总工时**: 约 40 分钟
+

MD/upgrade/RUOYI_UPGRADE_CHECKLIST.md

@@ -0,0 +1,275 @@
+# RuoYi 3.9.2 前端合入清单
+
+> **编制日期**: 2026-06-04
+> **基线**: RuoYi-Vue3 v3.9.2 (2026-03-26)
+> **目标**: 从 RuoYi 3.9.2 合入高价值前端组件，不破坏现有业务
+
+---
+
+## 执行原则
+
+1. **渐进式合入** — 每次只合一个组件，验证通过再合下一个
+2. **保留业务代码** — `com.healthlink.his.*` 目录不动，只改脚手架层
+3. **兼容优先** — 优先合入无侵入的独立组件
+4. **验证必做** — 每步完成后跑 `npm run dev` + 核心页面冒烟
+
+---
+
+## Phase A: 基础设施修复（0.5 天）
+
+### A.1 修复 router4 过期写法 `next()`
+
+| 项 | 内容 |
+|---|---|
+| **文件** | `src/permission.js` |
+| **变更** | `next()` → `return { path: '/' }` / `return true` / `return false` |
+| **参考** | RuoYi 3.9.2 `src/permission.js` 第 1-76 行 |
+| **风险** | 🟡 中 — 所有路由跳转都经过这里 |
+| **验证** | 登录→首页→各菜单跳转→返回→刷新→404页→白名单 |
+
+**具体变更点：**
+```
+// 旧写法 (我们当前)
+router.beforeEach((to, from, next) => {
+  if (getToken()) {
+    if (to.path === '/login') {
+      next({ path: '/' })
+    } else {
+      if (useUserStore().roles.length === 0) {
+        // ...
+        next({ ...to, replace: true })
+      } else {
+        next()
+      }
+    }
+  } else {
+    next(`/login?redirect=${to.fullPath}`)
+  }
+})
+
+// 新写法 (RuoYi 3.9.2)
+router.beforeEach(async (to, from) => {
+  if (getToken()) {
+    if (to.path === '/login') {
+      return { path: '/' }
+    }
+    if (useUserStore().roles.length === 0) {
+      // ...
+      return { ...to, replace: true }
+    }
+    return true
+  } else {
+    return `/login?redirect=${to.fullPath}`
+  }
+})
+```
+
+---
+
+### A.2 引入通配符白名单匹配
+
+| 项 | 内容 |
+|---|---|
+| **文件** | `src/utils/validate.js` |
+| **变更** | 新增 `isPathMatch(pattern, path)` 函数 |
+| **参考** | RuoYi 3.9.2 `src/utils/validate.js` |
+| **风险** | 🟢 低 — 纯新增函数 |
+| **验证** | 白名单路径 `/login`、`/register` 仍正常 |
+
+---
+
+## Phase B: 核心组件合入（2-3 天）
+
+### B.1 TreePanel 树分割组件
+
+| 项 | 内容 |
+|---|---|
+| **来源** | RuoYi 3.9.2 `src/components/TreePanel/` |
+| **目标** | 我们的 `src/components/TreePanel/`（新建） |
+| **依赖** | Element Plus Tree + Table |
+| **风险** | 🟢 低 — 独立组件，不影响现有代码 |
+| **验证** | 新建一个测试页面引入 TreePanel，确认左右分栏正常 |
+
+**HIS 适用场景：**
+- 基础管理 → 组织机构（左树右表）
+- 基础管理 → 药品目录（左分类右列表）
+- 数据字典 → 分类管理
+- 病区管理 → 病区/床位
+
+---
+
+### B.2 ExcelImportDialog 导入组件
+
+| 项 | 内容 |
+|---|---|
+| **来源** | RuoYi 3.9.2 `src/components/ExcelImportDialog/` |
+| **目标** | 我们的 `src/components/ExcelImportDialog/`（新建） |
+| **依赖** | Element Plus Dialog + Upload |
+| **风险** | 🟢 低 — 独立组件 |
+| **验证** | 上传 Excel → 预览 → 确认导入 |
+
+**HIS 适用场景：**
+- 基础管理 → 药品批量导入
+- 基础管理 → 诊断目录导入
+- 基础管理 → 医保目录同步
+- 患者管理 → 批量建档
+
+---
+
+### B.3 锁屏功能
+
+| 项 | 内容 |
+|---|---|
+| **来源** | RuoYi 3.9.2 |
+| **涉及文件** | `src/store/modules/lock.js`（新增）<br>`src/views/lock.vue`（新增）<br>`src/permission.js`（加锁屏拦截）<br>`src/store/modules/user.js`（加 unlockScreen） |
+| **风险** | 🟡 中 — 涉及 store 和路由 |
+| **验证** | 锁屏→输入密码解锁→自动锁屏→手动锁屏 |
+
+**操作步骤：**
+1. 复制 `lock.js` 到 `src/store/modules/`
+2. 复制 `lock.vue` 到 `src/views/`
+3. 修改 `permission.js` 添加锁屏路由检查
+4. 修改 `user.js` 登录成功后调用 `unlockScreen()`
+5. 在 Navbar 添加锁屏按钮
+
+---
+
+### B.4 密码规则校验
+
+| 项 | 内容 |
+|---|---|
+| **来源** | RuoYi 3.9.2 `src/utils/passwordRule.js` |
+| **目标** | 我们的 `src/utils/passwordRule.js`（新增） |
+| **风险** | 🟢 低 — 独立工具函数 |
+| **验证** | 修改密码页测试密码强度校验 |
+
+---
+
+## Phase C: Layout 增强（1-2 天）
+
+### C.1 HeaderNotice 顶部通知
+
+| 项 | 内容 |
+|---|---|
+| **来源** | RuoYi 3.9.2 `src/layout/components/HeaderNotice/` |
+| **目标** | 我们的 `src/layout/components/HeaderNotice/`（新增） |
+| **依赖** | 我们已有的通知公告接口 |
+| **风险** | 🟢 低 — 新增组件 |
+| **验证** | 顶部显示通知铃铛 → 点击展开通知列表 |
+
+---
+
+### C.2 TopBar 顶部工具栏
+
+| 项 | 内容 |
+|---|---|
+| **来源** | RuoYi 3.9.2 `src/layout/components/TopBar/` |
+| **目标** | 我们的 `src/layout/components/TopBar/`（新增） |
+| **风险** | 🟡 中 — 需要修改 `layout/index.vue` 引入 |
+| **验证** | 顶部工具栏显示搜索、全屏、通知等 |
+
+---
+
+### C.3 Copyright 版权组件
+
+| 项 | 内容 |
+|---|---|
+| **来源** | RuoYi 3.9.2 `src/layout/components/Copyright/` |
+| **目标** | 我们的 `src/layout/components/Copyright/`（新增） |
+| **风险** | 🟢 低 |
+| **验证** | 侧边栏底部显示版权信息 |
+
+---
+
+## Phase D: 持久化标签页增强（0.5 天）
+
+### D.1 TagsView 持久化
+
+| 项 | 内容 |
+|---|---|
+| **文件** | `src/store/modules/tagsView.js` |
+| **变更** | 从 RuoYi 3.9.2 复制增强版 |
+| **新增功能** | 刷新后保持标签页状态、Chrome 风格标签页 |
+| **风险** | 🟡 中 — 替换现有 store |
+| **验证** | 打开多个标签 → 刷新页面 → 标签页仍在 → 关闭浏览器重开 → 标签页恢复 |
+
+---
+
+## Phase E: 后端小版本升级（30 分钟）
+
+### E.1 依赖版本升级
+
+| 组件 | 当前 | 升级到 | 文件 |
+|---|---|---|---|
+| Druid | 1.2.27 | 1.2.28 | `pom.xml` |
+| Fastjson2 | 2.0.58 | 2.0.61 | `pom.xml` |
+| OSHI | 6.6.5 | 6.10.0 | `pom.xml` |
+| Commons IO | 2.13.0 | 2.21.0 | `pom.xml` |
+| BouncyCastle | bcprov-jdk15on 1.69 | bcprov-jdk18on 1.80 | `pom.xml` |
+
+**操作：**
+```bash
+cd healthlink-his-server
+mvn clean package -DskipTests
+# 验证启动正常
+```
+
+---
+
+## Phase F: 前端依赖升级（30 分钟）
+
+### F.1 版本号更新
+
+| 组件 | 当前 | 升级到 | 风险 |
+|---|---|---|---|
+| vue-router | ^4.3.0 | ^4.6.4 | 🟢 低 |
+| echarts | ^5.4.3 | ^5.6.0 | 🟢 低 |
+| element-plus | ^2.14.1 | 保持 | ✅ 我们更新 |
+| @vueuse/core | ^14.3.0 | 保持 | ✅ 我们更新 |
+
+**操作：**
+```bash
+cd healthlink-his-ui
+npm install vue-router@^4.6.4 echarts@^5.6.0
+npm run dev  # 验证无报错
+```
+
+---
+
+## 执行顺序
+
+```
+Day 1 上午:  A.1 (permission.js router4 修复) + A.2 (validate.js)
+Day 1 下午:  E.1 (后端小版本升级) + F.1 (前端依赖升级)
+Day 2 上午:  B.1 (TreePanel) + B.2 (ExcelImportDialog)
+Day 2 下午:  B.3 (锁屏功能) + B.4 (密码规则)
+Day 3 上午:  C.1 (HeaderNotice) + C.2 (TopBar) + C.3 (Copyright)
+Day 3 下午:  D.1 (TagsView 持久化) + 全量验证
+```
+
+---
+
+## 验证清单
+
+每步完成后逐项检查：
+
+- [ ] `npm run dev` 无报错
+- [ ] 登录页正常
+- [ ] 首页加载正常
+- [ ] 菜单导航正常
+- [ ] 各业务模块页面正常（至少抽查 5 个）
+- [ ] 表格渲染正常（VXE Table）
+- [ ] 打印功能正常（vue-plugin-hiprint）
+- [ ] 权限控制正常（hasPermi 指令）
+
+---
+
+## 风险控制
+
+| 风险 | 缓解 |
+|---|---|
+| permission.js 改坏导致无法登录 | 备份当前文件，改完立即测试登录流程 |
+| store 变更导致状态丢失 | 测试登录→刷新→各页面切换 |
+| 新组件与现有样式冲突 | 先在独立页面测试，确认无冲突再引入 layout |
+| npm 依赖冲突 | 锁版本，避免自动升级无关依赖 |
+

MD/upgrade/UPGRADE_LOG.md

@@ -0,0 +1,85 @@
+# HealthLink-HIS 组件升级日志
+
+> 每次升级后在此记录，方便跨 session 追踪进度。
+
+---
+
+## RuoYi 3.9.2 前端合入进度
+
+### Phase A: 基础设施修复
+- [x] A.1 permission.js router4 过期写法修复 ✅ 2026-06-04
+- [x] A.2 validate.js 通配符匹配 isPathMatch ✅ 2026-06-04
+
+### Phase B: 核心组件合入
+- [x] B.1 TreePanel 树分割组件 ✅ 2026-06-04
+- [x] B.2 ExcelImportDialog 导入组件 ✅ 2026-06-04
+- [x] B.3 锁屏功能 (lock.js + lock.vue) ✅ 2026-06-04
+- [x] B.4 密码规则校验 (passwordRule.js) ✅ 2026-06-04
+
+### Phase C: Layout 增强
+- [x] C.1 HeaderNotice 顶部通知 ✅ 2026-06-04
+- [x] C.2 TopBar 顶部工具栏 ✅ 2026-06-04
+- [x] C.3 Copyright 版权组件 ✅ 2026-06-04
+
+### Phase D: 持久化标签页
+- [x] D.1 TagsView 持久化增强 ✅ 2026-06-04
+
+### Phase E: 后端小版本升级
+- [ ] E.1 Druid 1.2.27 → 1.2.28
+- [ ] E.1 Fastjson2 2.0.58 → 2.0.61
+- [ ] E.1 OSHI 6.6.5 → 6.10.0
+- [ ] E.1 Commons IO 2.13.0 → 2.21.0
+- [ ] E.1 BouncyCastle 1.69 → 1.80
+
+### Phase F: 前端依赖升级
+- [x] F.1 vue-router ^4.3.0 → 4.6.4 ✅ 2026-06-04
+- [x] F.1 echarts ^5.4.3 → 5.6.0 ✅ 2026-06-04
+
+---
+
+## 升级记录
+
+### 2026-06-04 RuoYi 3.9.2 前端合入
+
+**变更文件：**
+- `src/permission.js` — router4 新写法 + 锁屏检查 + 通配符白名单
+- `src/utils/validate.js` — 新增 isPathMatch + isEmpty
+- `src/utils/passwordRule.js` — 新增密码规则校验
+- `src/store/modules/lock.js` — 新增锁屏 store
+- `src/store/modules/tagsView.js` — RuoYi 3.9.2 增强版
+- `src/views/lock.vue` — 新增锁屏页面
+- `src/router/index.js` — 新增 /lock 路由
+- `src/api/login.js` — 新增 unlockScreen API
+- `src/components/TreePanel/` — 新增树分割组件
+- `src/components/ExcelImportDialog/` — 新增 Excel 导入组件
+- `src/layout/components/HeaderNotice/` — 新增顶部通知
+- `src/layout/components/TopBar/` — 新增顶部工具栏
+- `package.json` — vue-router 4.6.4 + echarts 5.6.0
+
+**验证结果：**
+- ✅ npm run build:dev 编译成功 (1m 41s)
+- ✅ 前端 HTTP 200
+- ✅ API 代理 HTTP 200
+- ✅ 1825 文件，107M
+
+
+---
+
+## 后端组件升级进度
+
+### Phase 1: 安全修复
+- [x] 1.1 BouncyCastle 1.69 → 1.80 (jdk15on → jdk18on) ✅ 2026-06-04
+
+### Phase 2: 连接池 & 工具库
+- [x] 2.1 Druid 1.2.27 → 1.2.28 ✅ 2026-06-04
+- [x] 2.2 Fastjson2 2.0.58 → 2.0.61 ✅ 2026-06-04
+- [x] 2.3 Hutool 5.3.8 → 5.8.35 ✅ 2026-06-04
+
+### Phase 3: 监控 & IO
+- [x] 3.1 OSHI 6.6.5 → 6.10.0 ✅ 2026-06-04
+- [x] 3.2 Commons IO 2.13.0 → 2.21.0 ✅ 2026-06-04
+- [x] 3.3 PostgreSQL 42.2.27 → 42.7.4 ✅ 2026-06-04
+
+### Phase 5: PDF
+- [x] 5.1 itextpdf 5.5.12 → 5.5.13.4 ✅ 2026-06-04
+

MD/upgrade/UPGRADE_PLAN_V2.md

@@ -0,0 +1,171 @@
+# HealthLink-HIS 二次开发版本 — 组件升级计划
+
+> **编制日期**: 2026-06-03
+> **对比基线**: Gitee `tntlinking-opensource/healthlink-his` 2.0 分支
+> **目标**: 在不破坏现有业务的前提下，逐步引入高价值组件升级
+
+---
+
+## 升级原则
+
+1. **独立可验证** — 每个 Phase 完成后必须独立通过编译 + 冒烟测试
+2. **不破坏业务** — 一次只升级一个组件，出问题可快速回滚
+3. **先补丁后重构** — 小版本升级直接改版本号，大版本升级单独评估
+4. **文档同步** — 每次升级后更新 `UPGRADE_LOG.md`
+
+---
+
+## Phase 0: 安全修复（预估 0.5 天）
+
+> 🔴 **最高优先级** — 安全漏洞，必须立即处理
+
+### 0.1 BouncyCastle 1.69 → 1.80
+
+| 项目 | 详情 |
+|---|---|
+| **文件** | `healthlink-his-server/pom.xml` |
+| **变更** | `<bcprov-jdk15on.version>1.69</bcprov-jdk15on.version>` → 删除，改用 jdk18on |
+| **新依赖** | `org.bouncycastle:bcprov-jdk18on:1.80` + `org.bouncycastle:bcpkix-jdk18on:1.80` |
+| **原因** | 1.69 有已知安全漏洞；1.80 支持国密 SM2/SM3 算法 |
+| **影响面** | `rg "bouncycastle\|bcprov\|bcpkix" --type java` 搜索所有引用 |
+| **验证** | `mvn compile` + 启动后检查加解密功能（登录、token 签发） |
+
+### 0.2 vue-router 4.3 → 4.5
+
+| 项目 | 详情 |
+|---|---|
+| **文件** | `healthlink-his-ui/package.json` |
+| **变更** | `"vue-router": "^4.3.0"` → `"^4.5.1"` |
+| **风险** | 低 — 4.x 小版本，API 兼容 |
+| **验证** | 前端 `npm run dev` → 测试所有页面路由跳转、返回、权限拦截 |
+
+---
+
+## Phase 1: 核心组件升级（预估 1-2 天）
+
+> 🟡 **高价值** — 改动可控，收益明显
+
+### 1.1 echarts 5.4 → 6.0
+
+| 项目 | 详情 |
+|---|---|
+| **文件** | `healthlink-his-ui/package.json` |
+| **变更** | `"echarts": "^5.4.3"` → `"^6.0.0"` |
+| **影响面** | `rg "echarts" --type vue --type js` 搜索所有图表组件 |
+| **Breaking Changes** | ECharts 6 主要变更：Tree-shaking 更彻底、部分 API 重命名 |
+| **验证清单** | 首页统计图表、门诊量趋势、药品销售报表、住院床位占用图 |
+| **回滚方案** | 改回 `"^5.4.3"` 即可 |
+
+### 1.2 lodash-es → es-toolkit
+
+| 项目 | 详情 |
+|---|---|
+| **文件** | `healthlink-his-ui/package.json` + 所有引用文件 |
+| **变更** | `"lodash-es": "^4.17.21"` → 删除，添加 `"es-toolkit": "^1.41.0"` |
+| **迁移映射** | `_.cloneDeep` → `cloneDeep`、`_.debounce` → `debounce`、`_.isEqual` → `isEqual`、`_.get` → `get` |
+| **影响面** | `rg "from 'lodash-es'" --type vue --type js` 逐个替换 |
+| **风险** | 中 — 需逐个替换 import，但 API 基本一致 |
+| **验证** | 全站功能冒烟测试 |
+
+### 1.3 引入 MapStruct（后端）
+
+| 项目 | 详情 |
+|---|---|
+| **文件** | `healthlink-his-server/pom.xml` (parent) + `healthlink-his-application/pom.xml` |
+| **新增依赖** | `org.mapstruct:mapstruct:1.5.5.Final` + `mapstruct-processor` + `lombok-mapstruct-binding` |
+| **使用方式** | 新增 `@Mapper(componentModel = "spring")` 接口替代 `BeanUtils.copyProperties` |
+| **策略** | **渐进式** — 不改造现有代码，仅新功能使用 MapStruct |
+| **验证** | `mvn compile` 确认注解处理器工作 |
+
+---
+
+## Phase 2: 富文本 + 数据库迁移（预估 3-5 天）
+
+> 🟢 **中等工作量** — 需要一定的改造
+
+### 2.1 tiptap 富文本编辑器（替代 vue-quill）
+
+| 项目 | 详情 |
+|---|---|
+| **新增依赖** | `@tiptap/vue-3`、`@tiptap/starter-kit`、`@tiptap/extension-*` 系列 |
+| **替换目标** | `@vueup/vue-quill`（当前用于病历编辑、处方备注等） |
+| **影响面** | `rg "vue-quill\|Quill" --type vue` 搜索所有引用 |
+| **新增能力** | 表格编辑、图片内嵌、协作编辑、自定义节点 |
+| **策略** | 新页面用 tiptap，旧页面逐步迁移 |
+| **验证** | 病历编辑器、处方备注、各种富文本输入场景 |
+
+### 2.2 引入 Flyway 数据库迁移
+
+| 项目 | 详情 |
+|---|---|
+| **新增依赖** | `org.flywaydb:flyway-core` + `flyway-database-postgresql` |
+| **配置** | `application-dev.yml` 添加 Flyway 配置 |
+| **目录** | `src/main/resources/db/migration/` |
+| **迁移文件命名** | `V1__init.sql`、`V2__add_xxx.sql` |
+| **策略** | **不对现有表做迁移**，仅新功能的 DDL 用 Flyway 管理 |
+| **风险** | 中 — 需确保现有数据库与 Flyway 基线一致 |
+| **验证** | 启动时 Flyway 自动执行 → 检查 `flyway_schema_history` 表 |
+
+---
+
+## Phase 3: UI 框架评估（预估 5-10 天，可选）
+
+> ⚪ **长期规划** — 工作量大，收益高但风险也高
+
+### 3.1 Tailwind CSS 引入
+
+| 项目 | 详情 |
+|---|---|
+| **新增依赖** | `tailwindcss`、`autoprefixer`、`postcss` |
+| **策略** | **渐进式** — Tailwind 与现有 SCSS 共存，新页面用 Tailwind |
+| **影响面** | 全局样式可能冲突，需仔细测试 |
+| **建议** | 先在 `help-center` 或独立页面试水 |
+
+### 3.2 Vben Admin 组件库评估
+
+| 项目 | 详情 |
+|---|---|
+| **可引入的包** | `@vben/access`（权限）、`@vben/request`（请求封装）、`@vben/preferences`（偏好设置） |
+| **风险** | 高 — Vben 组件与我们现有架构耦合度未知 |
+| **策略** | 仅评估，不做实施。等 Phase 0-2 完成后再决定 |
+
+---
+
+## 升级路线图
+
+```
+Week 1:  Phase 0 (BouncyCastle + vue-router)     ← 立即执行
+Week 1:  Phase 1.1 (echarts 6)                    ← 紧随其后
+Week 2:  Phase 1.2 (es-toolkit) + 1.3 (MapStruct)
+Week 3:  Phase 2.1 (tiptap)                       ← 可并行
+Week 3:  Phase 2.2 (Flyway)                       ← 可并行
+Week 4+: Phase 3 (Tailwind + Vben 评估)           ← 按需
+```
+
+---
+
+## 升级日志模板
+
+```markdown
+## [日期] 升级记录
+
+### 组件: XXX Y.Y → Z.Z
+- **Phase**: 0/1/2/3
+- **变更文件**: list...
+- **验证结果**: ✅ 编译通过 / ✅ 冒烟测试通过
+- **回滚方案**: 改回旧版本号
+- **备注**: ...
+```
+
+---
+
+## 风险矩阵
+
+| 风险 | 概率 | 影响 | 缓解措施 |
+|---|---|---|---|
+| echarts 6 API 不兼容 | 中 | 高 | 先在测试环境验证所有图表 |
+| es-toolkit 行为差异 | 低 | 中 | 逐个替换，每个改完跑测试 |
+| Flyway 与现有 SQL 冲突 | 中 | 高 | 设置 baseline，不管理已有表 |
+| tiptap 与现有编辑器冲突 | 低 | 低 | 新旧共存，逐步迁移 |
+| Tailwind 样式覆盖 | 高 | 中 | 使用 CSS Module 隔离 |
+