**在线演示**：[管理端后台](https://gitee.com/link?target=http%3A%2F%2Fyiyang.51ehealth.com)
**标签**：#Java #Spring Boot #状态机 #事务 #养老系统 #入住管理


----
## 1. 机构入住子模块：先看 care_checkin 再改房态

养老院信息化里，「老人是否在住、住哪张床」不能写在 `care_older` 上一个 `bed_id` 字段——历史入住、预订、办理中、退住中会全部丢失。全链式智慧养老云平台把 **在住真相源** 放在 `care_checkin` 表，用 `status` 整型状态机描述全生命周期；`care_bed` 记录床位占用；`care_older` 只做集团档案主档。
下文完整拆解 **institution 模块入住子域**：`CareCheckinDO` → `CareCheckinMapper` → `CareCheckinServiceImpl`（`getCheckinPage` / `assign` / `vacate`）→ `CareCheckinController`，每段代码来自 `zhijian-module-institution`，并说明与房态图、账户开户、评估 flow Tab 的衔接。适合二次开发时快速定位「改一个状态要动哪几个类」。
![入住老人一览](https://developer.qcloudimg.com/http-save/yehe-12101878/6271ceac3ee76a316c74ca5b34b78f45.png)
图1 入住老人一览 · status 2/3/5/6/7 默认进入 DEFAULT_LIVE_STATUS 筛选
## 2. status 状态码：对齐旧系统 /live 列表

`CareCheckinDO` 字段注释是业务与报表的**唯一真相源**，前端 Tab 是否可点、月账单是否生成，都依赖它。
```
@TableName("care_checkin")
public class CareCheckinDO extends CareOrgBaseDO {

    @TableId
    private Long id;
    private Long olderId;
    private Long bedId;
    private Long roomId;
    /** 0意向 1预订 2入住申请/办理中 3在住 4退订 5退住申请 6已退住 7入住待审批 */
    private Integer status;
    private String careLevel;
    private LocalDateTime checkInTime;
    private LocalDateTime checkOutTime;
    /** RESERVE / TRY_LIVE / DIRECT */
    private String source;
    private String remark;
}
```

|code|业务含义|典型入口|房态/账户|
|:-:|:-:|:-:|:-:|
|0|意向|接待登记|不占床|
|1|预订|预订管理、缴订金|床可标预订|
|2|办理中|预订/试住转入住、新建申请|flow 可编辑费用/评估|
|3|在住|assign 成功、合同生效|占床、可月扣|
|4|已退订|取消预订|释放预订床|
|5|退住中|退住审批通过待结算|床仍占，停新费|
|6|已退住|结算完成|腾床|
|7|入住待审批|合同提交审批|待院办批|
`CareCheckinServiceImpl` 内常量与床态常量配合使用：
```
private static final int STATUS_INTENT = 0;
private static final int STATUS_IN_HOUSE = 3;
private static final int STATUS_CHECKED_OUT = 6;

private static final int BED_IDLE = 0;
private static final int BED_RESERVED = 1;
private static final int BED_OCCUPIED = 2;
private static final int BED_TRYLIVE = 5;
```
展示文案统一走 Service 层 `buildRespList` 里对 status 的翻译，**禁止**前端每个页面自建 map，否则院办看到的「办理中」与财务报表不一致。
![房态图](https://developer.qcloudimg.com/http-save/yehe-12101878/5d1f2c6ff9be8f1aee56f4af0fd16c97.png)
图2 房态图 · 颜色来自 care_bed.status + 当前 checkin 关联
## 3. CareCheckinMapper：列表筛选与互斥查询

### 3.1 DEFAULT_LIVE_STATUS

院办打开「入住老人一览」，默认不应看到纯意向(0)、纯预订(1)——与旧 `check-in-system` 的 `/live` 一致。
```
List<Integer> DEFAULT_LIVE_STATUS = Arrays.asList(2, 3, 5, 6, 7);

default PageResult<CareCheckinDO> selectLivePage(CareCheckinPageReqVO reqVO,
        Collection<Long> olderIds, Collection<Long> roomIds) {
    LambdaQueryWrapperX<CareCheckinDO> wrapper = new LambdaQueryWrapperX<CareCheckinDO>()
            .eqIfPresent(CareCheckinDO::getOlderId, reqVO.getOlderId())
            .eqIfPresent(CareCheckinDO::getBedId, reqVO.getBedId())
            .likeIfPresent(CareCheckinDO::getCareLevel, reqVO.getCareLevel())
            .betweenIfPresent(CareCheckinDO::getCheckInTime, reqVO.getCheckInTime())
            .orderByDesc(CareCheckinDO::getId);
    // olderIds / roomIds 空集合 → id=-1 快速空页
    if (reqVO.getStatus() != null) {
        wrapper.eq(CareCheckinDO::getStatus, reqVO.getStatus());
    } else if (!Boolean.TRUE.equals(reqVO.getAllStatus())) {
        wrapper.in(CareCheckinDO::getStatus, DEFAULT_LIVE_STATUS);
    }
    return selectPage(reqVO, wrapper);
}
```
`selectPage(reqVO, wrapper)` 走 MyBatis Plus 分页插件，返回 `PageResult` 给 Controller 包装 `CommonResult`（分页细节见专栏第 15 篇）。
### 3.2 selectActiveByOlderId：防止双人床、双入住单

新建入住或预订转入住前，必须查该老人是否已有「在办」单：
```
default CareCheckinDO selectActiveByOlderId(Long olderId) {
    return selectOne(new LambdaQueryWrapperX<CareCheckinDO>()
            .eq(CareCheckinDO::getOlderId, olderId)
            .in(CareCheckinDO::getStatus, Arrays.asList(1, 2, 3, 5, 7))
            .orderByDesc(CareCheckinDO::getId)
            .last("LIMIT 1"));
}
```
状态 1/2/3/5/7 互斥——已有一条时不允许再开预订、试住、新入住，除非走退住/退订闭环。
![床位统计](https://developer.qcloudimg.com/http-save/yehe-12101878/7c26837bdbf17abf75b5984c9e1dd143.png)
图3 床位统计大屏 · 汇总依赖 checkin.status 与 bed 表一致
## 4. getCheckinPage：区域、合同到期与姓名联查

Controller 只收 `CareCheckinPageReqVO`；复杂筛选在 Service：
```
@Override
public PageResult<CareCheckinRespVO> getCheckinPage(CareCheckinPageReqVO pageReqVO) {
    Collection<Long> olderFilter = resolveOlderFilter(pageReqVO);
    Collection<Long> roomFilter = null;
    if (pageReqVO.getAreaId() != null) {
        List<CareSpaceDO> rooms = careSpaceMapper.selectList(
                new LambdaQueryWrapperX<CareSpaceDO>()
                        .eq(CareSpaceDO::getAreaId, pageReqVO.getAreaId()));
        roomFilter = rooms.stream().map(CareSpaceDO::getId).collect(Collectors.toSet());
        if (roomFilter.isEmpty()) {
            return PageResult.empty();
        }
    }
    Collection<Long> expireOlderIds = null;
    if (Boolean.TRUE.equals(pageReqVO.getExpire())) {
        expireOlderIds = resolveExpiringOlderIds();
        if (expireOlderIds.isEmpty()) {
            return PageResult.empty();
        }
    }
    // expire 与 olderFilter 求交 ...
    PageResult<CareCheckinDO> page = careCheckinMapper.selectLivePage(
            pageReqVO, olderFilter, roomFilter);
    return new PageResult<>(buildRespList(page.getList()), page.getTotal());
}
```
**设计要点**：
1. `areaId` 先解析为 `roomId` 集合，避免 Mapper 七表 JOIN。
2. `resolveOlderFilter` 按园号、姓名模糊查 `care_older` 得 id 列表。
3. `buildRespList` 填充老人姓名、床路径、区域名、status 中文——列表 VO 一次给齐，前端只渲染。

## 5. assign：占床 + 写入住单的原子事务（核心）

房态图点「入住」、flow 费用 Tab 提交后，最终常落到 `POST /care/checkin/assign`。源码中该方法约 90 行，核心是 **床态校验 → 预订/试住关联校验 → 写 checkin → 占床 → 同步通道**。
```
@Override
@Transactional(rollbackFor = Exception.class)
@LogRecord(type = CARE_CHECKIN_TYPE, subType = CARE_CHECKIN_ASSIGN_SUB_TYPE, bizNo = "{{#checkinId}}",
        success = CARE_CHECKIN_ASSIGN_SUCCESS)
public Long assign(CareCheckinAssignReqVO reqVO) {
    validateOlder(reqVO.getOlderId());
    CareBedDO bed = careBedMapper.selectById(reqVO.getBedId());
    if (bed == null) {
        throw exception(BED_NOT_EXISTS);
    }
    boolean idle = Objects.equals(bed.getStatus(), BED_IDLE) && bed.getOlderId() == null;
    boolean reservedSameOlder = Objects.equals(bed.getStatus(), BED_RESERVED)
            && Objects.equals(bed.getOlderId(), reqVO.getOlderId());
    boolean tryliveSameOlder = Objects.equals(bed.getStatus(), BED_TRYLIVE)
            && Objects.equals(bed.getOlderId(), reqVO.getOlderId());
    if (!idle && !reservedSameOlder && !tryliveSameOlder) {
        throw exception(BED_NOT_IDLE);
    }

    CareCheckinDO placement;
    if (reqVO.getCheckinId() != null) {
        placement = validateExists(reqVO.getCheckinId());
    } else {
        CareCheckinDO active = careCheckinMapper.selectActiveByOlderId(reqVO.getOlderId());
        if (active != null) {
            if (Objects.equals(active.getStatus(), STATUS_IN_HOUSE)) {
                throw exception(CHECKIN_ALREADY_ACTIVE);
            }
            placement = active;
        } else {
            placement = new CareCheckinDO();
            placement.setOlderId(reqVO.getOlderId());
        }
    }

    // 有效预订/试住：必须关联同一 checkinId + 同一 bedId
    CareReserveDO activeReserve = careReserveMapper.selectActiveByOlderId(reqVO.getOlderId());
    if (activeReserve != null) {
        boolean linked = placement.getId() != null
                && Objects.equals(activeReserve.getCheckinId(), placement.getId());
        boolean sameBed = Objects.equals(activeReserve.getBedId(), reqVO.getBedId());
        if (!linked || !sameBed) {
            throw exception(CHECKIN_HAS_RESERVE);
        }
    }
    // 试住同理 CareTryliveDO ...

    placement.setBedId(bed.getId());
    placement.setRoomId(bed.getRoomId());
    placement.setStatus(STATUS_IN_HOUSE);
    placement.setCheckInTime(LocalDateTime.now());
    placement.setCheckOutTime(null);
    if (placement.getId() == null) {
        careCheckinMapper.insert(placement);
    } else {
        careCheckinMapper.updateById(placement);
    }

    CareBedDO bedUpdate = new CareBedDO();
    bedUpdate.setId(bed.getId());
    bedUpdate.setStatus(BED_OCCUPIED);
    bedUpdate.setOlderId(reqVO.getOlderId());
    careBedMapper.updateById(bedUpdate);

    careReserveService.markCheckedInByCheckinId(placement.getId());
    careTryliveService.markConvertedByCheckinId(placement.getId());
    syncInstitutionChannel(reqVO.getOlderId());
    careHubBusinessContactService.syncOlderRoot(reqVO.getOlderId(), 2);
    return placement.getId();
}
```
逐段说明：

|步骤|代码位置|业务含义|
|:-:|:-:|:-:|
|床态校验|`BED_IDLE` / `BED_RESERVED`|空床、本人预订床、本人试住床才可 assign|
|互斥单|`selectActiveByOlderId`|已在住则 `CHECKIN_ALREADY_ACTIVE`|
|预订链|`CHECKIN_HAS_RESERVE`|有预订不能换床偷偷入住|
|写入住|`status=3`|在住真相写入 care_checkin|
|占床|`bedUpdate`|房态图变蓝「在住」|
|通道|`syncInstitutionChannel`|中台档案显示机构通道|
`@Transactional(rollbackFor = Exception.class)` **必须写全**。只写 `@Transactional` 时，受检异常可能导致「床已占、入住单未更新」。
![资金账户](https://developer.qcloudimg.com/http-save/yehe-12101878/46427b9926df063314b13bca59c6c489.png)
图4 资金账户 · 合同生效后 openAccount，与 status 3 衔接
## 6. vacate：退住腾床与 status 6

```
@Override
@Transactional(rollbackFor = Exception.class)
public void vacate(CareCheckinVacateReqVO reqVO) {
    CareCheckinDO placement = validateExists(reqVO.getCheckinId());
    if (!Objects.equals(placement.getStatus(), STATUS_IN_HOUSE)) {
        throw exception(CHECKIN_NOT_IN_HOUSE);
    }
    CareCheckinDO update = new CareCheckinDO();
    update.setId(placement.getId());
    update.setStatus(STATUS_CHECKED_OUT);
    update.setCheckOutTime(LocalDateTime.now());
    careCheckinMapper.updateById(update);
    // 释放床位 care_bed → BED_IDLE, olderId=null
}
```
完整退住业务走 `CareOutService` 审批→结算→腾床；`vacate` 多用于行政腾空或数据修复。生产路径必须保证 **结算与 status 6、床态空闲** 同一事务或严格顺序。
## 7. CareCheckinController：写操作与权限码

```
@PostMapping("/assign")
@Operation(summary = "分配床位（入住）")
@PreAuthorize("@ss.hasPermission('care:checkin:assign')")
public CommonResult<Long> assign(@Valid @RequestBody CareCheckinAssignReqVO reqVO) {
    return success(careCheckinService.assign(reqVO));
}

@PostMapping("/vacate")
@Operation(summary = "退住腾空")
@PreAuthorize("@ss.hasPermission('care:checkin:vacate')")
public CommonResult<Boolean> vacate(@Valid @RequestBody CareCheckinVacateReqVO reqVO) {
    careCheckinService.vacate(reqVO);
    return success(true);
}
```

|接口|权限码|说明|
|:-:|:-:|:-:|
|GET `/page`|`care:checkin:query`|一览分页|
|POST `/apply`|`care:checkin:create`|建档+办理中|
|POST `/assign`|`care:checkin:assign`|占床在住|
|POST `/vacate`|`care:checkin:vacate`|腾空|
## 8. flow 多 Tab 与 status 门禁（前端配合）


|status|概况|评估|费用计算|床位调整|
|:-:|:-:|:-:|:-:|:-:|
|2 办理中|可编辑|可做题|可提交核算|禁用|
|3 在住|只读|可再评估|只读|可换床|
|5 退住中|只读|—|结算|禁用|
Vue3 `flow.vue` 用 `checkin.status` 控制 Tab `disabled`；后端 assign/vacate 仍须校验 status，防止绕过 UI 直接调 API。
![能力评估](https://developer.qcloudimg.com/http-save/yehe-12101878/47d2c0f6697bb96b38b74298313269a1.png)
图5 flow 评估 Tab · 办理中 status=2 可开始评估
![照护计划](https://developer.qcloudimg.com/http-save/yehe-12101878/fae0a7953946556c229d1c882369a54a.png)
图6 在住老人生成照护计划 · 依赖 status=3
## 9. 与预订、试住、合同的状态协作

```
CareReserveServiceImpl  预订占床 → 转入住 status=2 → assign → 3
CareTryliveServiceImpl  试住占床 → 转入住 status=2 → assign → 3
CareContractServiceImpl 提交审批 status=7 → 通过 → 2/3 + 合同生效 + 开户
CareOutServiceImpl      在住 3 → 退住中 5 → 结算 → 6 + 腾床
```
不要在 `CareOlderDO` 上缓存「当前床号」；中台用户档案通过 `CareHubUserInstitutionBridge.getLiveCheckin(olderId)` 读最新在住单。
![用户档案](https://developer.qcloudimg.com/http-save/yehe-12101878/23e197e1564bce674ece5f3ed8b18fe9.png)
图7 中台用户档案 · SPI 读机构在住，不直连 institution Mapper
## 10. curl 与联调

```
# 分页
curl -G "http://localhost:48080/admin-api/care/checkin/page" \
  -H "Authorization: Bearer {token}" \
  -H "tenant-id: 1" \
  --data-urlencode "pageNo=1" \
  --data-urlencode "pageSize=10"

# assign（JSON 体示意）
curl -X POST "http://localhost:48080/admin-api/care/checkin/assign" \
  -H "Authorization: Bearer {token}" \
  -H "tenant-id: 1" \
  -H "Content-Type: application/json" \
  -d '{"olderId":1001,"bedId":2001,"checkinId":3001}'
```
成功：`{"code":0,"data":3001}`。业务失败：`code` 为 `1-031-xxx`，`msg` 如「该床位非空闲」。
## 11. 排错清单

1. **一览缺在住**：status 是否在 `DEFAULT_LIVE_STATUS`；tenant-id 是否正确。
2. **assign 后房态仍空**：`care_bed` 是否 update；事务是否回滚。
3. **双入住**：`selectActiveByOlderId` 是否在 create/apply 前调用。
4. **预订转入住失败**：是否 `CHECKIN_HAS_RESERVE`——必须同一 bedId。
5. **中台无在住**：`CareInstitutionHubUserBridge` 是否注册。

## 12. 小结

`care_checkin.status` 是机构域的状态机中心；`assign`/`vacate` 必须与 `care_bed` 同事务。读懂 `CareCheckinServiceImpl` 这一段，就掌握了房态图、入住一览、flow 费用、账户开户的衔接点。


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


在线演示：管理端后台标签：#Java #Spring Boot #状态机 #事务 #养老系统 #入住管理

Java养老系统源码详解：入住状态机 care_checkin 与 assign 事务实践

编程语言

后端

数据库

基于Spring Boot与状态机设计，该养老系统将老人入住全生命周期建模于care_checkin表，以status字段管理0-7各阶段状态，通过assign与vacate事务确保床位与入住单原子同步，并支持预订、试住及合同流程衔接，实现房态图、入住列表与财务数据统一驱动。

代码解释

JSON

Java

2026上云采购 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

Java养老系统源码详解：入住状态机 care_checkin 与 assign 事务实践-腾讯云开发者社区-腾讯云

Java养老系统源码详解：入住状态机 care_checkin 与 assign 事务实践

Java养老系统源码详解：入住状态机 care_checkin 与 assign 事务实践

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐