**在线演示**：[管理端后台](https://gitee.com/link?target=http%3A%2F%2Fyiyang.51ehealth.com)
**标签**：#Java #Spring Boot #Maven #SPI #养老系统 #模块拆分


----
## 1. 为什么养老系统要拆成五个 Maven 模块

全链式智慧养老云平台不是「一个 jar 包塞全部业务」。交付合同常只买 **机构版**，却需要演示 **社区驿站、医养科室、监管大屏**——若代码焊死在一个模块，裁剪等于删源码、改 import，风险极高。
项目根 `pom.xml` 激活 `zhijian-module-hub`、`zhijian-module-institution`、`zhijian-module-community`、`zhijian-module-medical`、`zhijian-module-bi`；运行时仍由 `zhijian-server` **单进程**启动，前端只调 `/admin-api`。编译期可注释未购业态依赖，侧栏菜单 SQL 同步隐藏。
![图1 系统中台 · 跨业态 KPI](https://developer.qcloudimg.com/http-save/yehe-12101878/d19fed3d593d5007a4ad08c8bbec526d.png)
图1 系统中台 · 跨业态 KPI
## 2. zhijian-server：交付壳与依赖勾选

### 2.1 真实 pom 片段

```
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
    <parent>
        <groupId>cn.zhijian.boot</groupId>
        <artifactId>zhijian</artifactId>
        <version>${revision}</version>
    </parent>
    <artifactId>zhijian-server</artifactId>
    <dependencies>
        <dependency>
            <groupId>cn.zhijian.boot</groupId>
            <artifactId>zhijian-module-hub</artifactId>
            <version>${revision}</version>
        </dependency>
        <dependency>
            <groupId>cn.zhijian.boot</groupId>
            <artifactId>zhijian-module-institution</artifactId>
            <version>${revision}</version>
        </dependency>
        
    </dependencies>
</project>
```
- **第 5 行**：`parent` 指向根 BOM，版本 `${revision}` 由 flatten 插件统一
- **第 9 行**：`zhijian-server` 几乎无业务代码，只做依赖聚合
- **第 11 行**：hub 中台：档案/评估/通道
- **第 16 行**：institution：入住、账户、月账单、照护
- **第 20 行**：community/medical/bi 按合同注释 | Maven 模块 | 业务域 | 典型菜单 | |---|---|---| | zhijian-module-hub | 中台、档案、评估 | 系统中台、档案管理 | | zhijian-module-institution | 入住、费用、照护 | 入住一览、资金账户 | | zhijian-module-community | 社区居家 | 关爱地图、经营统计 | | zhijian-module-medical | 医养 | 患者管理、康复理疗 | | zhijian-module-bi | 监管大屏 | 数据概况、床位统计 | ![图2 机构入住一览](https://developer.qcloudimg.com/http-save/yehe-12101878/a98e385fef3c7057cd194e60c36003b8.png)

图2 机构入住一览
## 3. SPI：CareHubUserInstitutionBridge 与 CareInstitutionHubUserBridge

hub **禁止**依赖 institution。中台读在住人数走 SPI：接口在 hub，实现在 institution。
### 3.1 接口（hub）

```
public interface CareHubUserInstitutionBridge {

    @Getter
    @AllArgsConstructor
    class InstitutionCheckinInfo {
        private final Long checkinId;
        private final Integer status;
        private final String careLevel;
        private final String bedPath;
        private final String areaName;
    }

    default long countInHouseCheckins() { return 0; }

    default Map<Long, InstitutionCheckinInfo> loadInstitutionCheckinByOlderIds(
            Collection<Long> olderIds) { return Collections.emptyMap(); }
}
```
- **第 1 行**：接口包路径 `service.hub`
- **第 4 行**：内嵌 DTO 避免依赖 institution VO
- **第 12 行**：default 返回 0/空 Map

### 3.2 实现（institution）

```
@Component
public class CareInstitutionHubUserBridge implements CareHubUserInstitutionBridge {

    private static final int CHECKIN_LIVE = 3;

    @Resource
    private CareCheckinMapper careCheckinMapper;
    @Resource
    private CareCheckinService careCheckinService;
    @Resource
    private CareCareExecMapper careCareExecMapper;

    @Override
    public long countInHouseCheckins() {
        return careCheckinMapper.selectCount(CareCheckinDO::getStatus, CHECKIN_LIVE);
    }

    @Override
    public Map<Long, InstitutionCheckinInfo> loadInstitutionCheckinByOlderIds(Collection<Long> olderIds) {
        if (olderIds == null || olderIds.isEmpty()) {
            return Collections.emptyMap();
        }
        Map<Long, CareCheckinDO> activeCheckinMap = new HashMap<>();
        for (CareCheckinDO checkin : careCheckinMapper.selectActiveListByOlderIds(olderIds)) {
            activeCheckinMap.merge(checkin.getOlderId(), checkin,
                    (a, b) -> a.getId() >= b.getId() ? a : b);
        }
        Map<Long, InstitutionCheckinInfo> result = new HashMap<>();
        for (Map.Entry<Long, CareCheckinDO> entry : activeCheckinMap.entrySet()) {
            CareCheckinRespVO detail = careCheckinService.getCheckinDetail(entry.getValue().getId());
            result.put(entry.getKey(), new InstitutionCheckinInfo(
                    entry.getValue().getId(), entry.getValue().getStatus(),
                    detail != null ? detail.getCareLevel() : null,
                    detail != null ? detail.getBedPath() : null,
                    detail != null ? detail.getAreaName() : null));
        }
        return result;
    }
}
```
- **第 1 行**：@Component 随 institution JAR 注册
- **第 4 行**：CHECKIN_LIVE=3 在住
- **第 9 行**：countInHouseCheckins 供中台 KPI
- **第 18 行**：批量 load 床位路径给用户总览 ![图3 社区居家 · 与 hub 共用档案](https://developer.qcloudimg.com/http-save/yehe-12101878/e495831d66d032b116be698b6abab969.png)

图3 社区居家 · 与 hub 共用档案
## 4. 包内分层与 URL

```
zhijian-module-institution/.../checkin/CareCheckinController.java  → /care/checkin/*
zhijian-module-hub/.../assess/CareAssessServiceImpl.java           → /care/assess/*
```
### 4.1 本地切换业态

```
./script/shell/set_server_care_packages.ps1 -Mode institution-iot
```
```
mvn compile -pl zhijian-server -am -DskipTests
```
![图4 医养模块独立 JAR](https://developer.qcloudimg.com/http-save/yehe-12101878/5502ea3a17391ea157242b4d2195da5d.png)
图4 医养模块独立 JAR
## 5. hub 侧注入示例

```
@Autowired(required = false)
private CareHubUserInstitutionBridge institutionBridge;
```

|方式|未购业态|
|:-:|:-:|
|required=false|null，走 default|
|@Resource 强依赖|启动失败|
|![图5 监管大屏 · BI Bridge](https://developer.qcloudimg.com/http-save/yehe-12101878/47dc1d1cda5f874df7791148646fd645.png)||
图5 监管大屏 · BI Bridge
## 6. 交付自检

1. 根 pom modules 与 server 依赖一致
2. 执行 `care_maven_delivery_menu_crop.sql`
3. Bridge 实现类在 Spring 扫描路径
4. 侧栏菜单与 JAR 一致
	![图6 中台用户总览 · SPI 读机构在住](https://developer.qcloudimg.com/http-save/yehe-12101878/04a1327af9b90fb6b2f5ed47e3b9655c.png)

图6 中台用户总览 · SPI 读机构在住
## 排错与常见坑

1. hub 反向依赖 institution → 循环依赖。
2. SPI 忘 @Component → KPI 全 0。
3. server 注释 institution 但菜单未裁 → 404。
4. 包名用 out → IDE 排除目录。
5. Bridge @Resource 强依赖 → 未购业态启动失败。

### curl 联调示例

```
curl -G "http://localhost:48080/admin-api/care/hub-user/page" \
  -H "Authorization: Bearer {token}" \
  -H "tenant-id: 1" \
  --data-urlencode "pageNo=1"
```
正常响应体 `code` 为 `0`；`401` 查 Token；`403` 查 `@PreAuthorize` 权限码；`1_031_xxx` 为业务 `ServiceException`。
### application-local.yaml 片段

```
spring:
  profiles:
    active: local
yudao:
  tenant:
    enable: true
  security:
    mock-enable: false   # 生产务必 false
```
本地库密码放 `application-local.yaml`，勿提交 Git。 ![图7 资金账户 · institution 模块](https://developer.qcloudimg.com/http-save/yehe-12101878/628094d153a7dce28a1228477ea61311.png)
图7 资金账户 · institution 模块
## 附录 A：仓库路径索引

**文章文件**：`blog/articles/14-springboot-maven-modules-elderly-care.md`

|路径|说明|
|:-:|:-:|
|`cn.zhijian.care.module.care`|康养业务根包|
|`zhijian-module-hub`|中台与评估引擎|
|`zhijian-module-institution`|机构入住费用照护|
|`zhijian-server/pom.xml`|运行时依赖聚合|
|`zhijian-ui/zhijian-ui-admin-vue3`|Vue3 管理端|
|![图8 照护计划 · 机构域业务](https://developer.qcloudimg.com/http-save/yehe-12101878/b3f0a416e988b69a2bfbde496f17850e.png)||
图8 照护计划 · 机构域业务
## 附录 B：推荐阅读顺序

1. Maven 模块 → CommonResult → 入住状态机 → SPI Bridge
2. Token 权限 → 自动填充 → 账户月账单 → 前端 flow → 评估状态机

## 工程配置与联调（通用）

### application-local.yaml

```
spring:
  profiles:
    active: local
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/zhijian_care?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai

yudao:
  tenant:
    enable: true
  security:
    mock-enable: false
```
`application-local.yaml` 含数据库账号，加入 `.gitignore`，勿提交 Git。生产启动：`--spring.profiles.active=prod`。
### .gitignore 片段

```
target/
.idea/
*.iml
application-local.yaml
application-my.yaml
```
### 统一请求头


|头|说明|
|:-:|:-:|
|`Authorization`|`Bearer {accessToken}`|
|`tenant-id`|SaaS 租户编号|
### 响应约定

成功：`{"code":0,"msg":"","data":{...}}`。业务失败：`code` 为模块错误码（如 `1-031-xxx`），`msg` 可直接弹窗。
### IDEA 定位源码

1. 全局搜索类名（如 `CareCheckinServiceImpl`）
2. 确认模块：`zhijian-module-institution` / `hub`
3. 改接口时同步看 `zhijian-ui-admin-vue3/src/api/care/`

### Maven 编译（本地）

```
mvn compile -pl zhijian-server -am -DskipTests
```
改 `zhijian-server/pom.xml` 业态依赖后 IDEA **Reimport** 再编译。
### 常见排错

1. **程序包不存在**：包路径是否含 IDE 保留目录名（如 `out`）。
2. **401/403**：Token 过期或 `@PreAuthorize` 权限码与菜单不一致。
3. **租户数据为空**：请求是否带 `tenant-id`；租户插件是否在分页插件前。
4. **审计字段为空**：DO 是否继承 `BaseDO`；定时任务线程无登录用户需手动 set。
5. **SPI 指标为 0**：业态 JAR 是否引入；Bridge 是否 `@Component`。


----
**Gitee 社区版源码**：https://gitee.com/xinzexingjian-data_0/older_care

在线演示：管理端后台标签：#Java #Spring Boot #Maven #SPI #养老系统 #模块拆分

Java 养老系统源码详解：Spring Boot Maven 多模块拆分

编程语言

后端

架构设计

基于Spring Boot与Maven的多模块智慧养老平台，采用SPI机制实现模块解耦，支持按合同灵活裁剪机构、社区、医养、BI等业态，解决交付时模块定制难题。通过zhijian-server聚合依赖，SPI桥接跨模块数据，实现高效开发部署与业务扩展。

代码解释

数据库

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Java 养老系统源码详解：Spring Boot Maven 多模块拆分-腾讯云开发者社区-腾讯云

Java 养老系统源码详解：Spring Boot Maven 多模块拆分

Java 养老系统源码详解：Spring Boot Maven 多模块拆分

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐