# 11-社区养老院管理系统 - 功能说明
# 项目概述
面向养老院日常照护的管理平台，提供老人档案、床位、护理、健康、膳食、费用、探访和活动等记录。实际登录角色为管理员、护工、家属和老人，老人使用前台个人服务入口。
# 项目概览
# 创新点
- 老人独立使用入口：老人可登录前台查看本人服务信息，区别于由家属代操作的设计。
- 照护记录集中管理：健康、护理、膳食、床位和探访分别记录，方便追溯日常服务。
- 家属关系维护：通过家属关联表组织家属与老人的对应关系。
# 项目亮点
- 角色分工：提供管理员、护工、家属、老人等业务入口。
- 业务数据组织：主初始化脚本包含 16 张表，围绕该系统的核心对象与业务记录建模。
- 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
- 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。
# 管理员
# 账号与关系
维护管理员、护工、家属、老人及家属关联关系。
# 照护管理
管理床位、护理记录、健康档案、膳食和探访记录。
# 费用管理
维护老人费用记录及支付状态。
# 服务活动
维护服务项目、活动与活动报名审核。
# 信息管理
维护通知公告和意见反馈。
# 护工
# 日常照护
通过老人、床位、护理、健康、探访、膳食和费用入口维护日常记录。
# 意见处理
查看意见反馈，填写回复；查看通知公告。
# 家属
# 家属账号
支持家属登录及个人资料、密码维护。
# 通知查看
当前后台菜单开放首页和通知公告；家属与老人关联由管理员维护。
# 老人
# 照护查询
查看自己的健康档案、护理记录、床位、膳食与探访记录。
# 费用查询
查看本人费用及支付状态，通过费用页面执行支付操作。
# 活动参与
浏览活动、查看活动详情并查询我的活动。
# 家属与反馈
查看我的家属，提交意见反馈并查看回复。
# 个人资料
维护个人信息与密码。
# 功能权限对照表
下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。
| 功能模块 | 管理员 | 护工 | 家属 | 老人 |
|---|---|---|---|---|
| 账号、家属关联 | 管理 | 老人资料维护 | 个人资料 | 查看我的家属 |
| 床位、健康、护理、膳食 | 管理 | 维护 | 未提供相应菜单 | 本人查询 |
| 探访记录 | 管理 | 维护 | 未提供相应菜单 | 本人查询 |
| 费用记录 | 管理 | 维护 | 未提供相应菜单 | 本人查询及支付登记 |
| 活动与报名 | 管理审核 | — | 未提供相应菜单 | 浏览参与 |
| 公告与反馈 | 管理 | 公告与反馈处理 | 公告查看 | 公告查看与反馈提交 |
# 业务状态说明
- 费用支付：待支付、已支付、已退款；支付方法将待处理的本人费用登记为已支付。
- 意见反馈：待处理、已回复。
# 默认账号
以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。
| 登录角色 | 角色标识 | 用户名 | 初始密码 |
|---|---|---|---|
| 管理员 | ADMIN | admin | 123456 |
| 护工 | NURSE | nurse | 123456 |
| 家属 | FAMILY | family | 123456 |
| 老人 | ELDERLY | elderly | 123456 |
# 核心业务流程
# 档案管理
- 维护老人资料。
- 配置床位与家属关系。
- 护工记录日常护理、健康和膳食信息。
- 老人查询个人记录。
# 费用处理
- 后台登记费用。
- 老人查看待支付记录。
- 点击支付。
- 服务校验费用归属并登记支付时间、已支付状态。
# 活动参与
- 查看活动列表和详情。
- 提交报名。
- 后台查看并审核报名。
- 老人查看我的活动。
# 技术说明
# 系统架构
| 项目 | 当前源码配置 |
|---|---|
| Vue | ^3.4.29 |
| Element Plus | ^2.8.4 |
| Pinia | ^2.2.2 |
| Axios | ^1.7.5 |
| Vite | ^5.3.1 |
| Spring Boot | 3.2.10 |
| Java | 17 |
| MyBatis 集成组件 | 3.0.4 |
| 数据库 | MySQL；具体运行版本以实际部署为准 |
| 身份认证 | JWT；通过登录接口生成令牌 |
前端版本按 package.json 中的声明范围记录，不将依赖范围等同于已安装的精确版本。
# 访问地址
- 后端接口：http://localhost:1000 (opens new window)，对应服务端端口配置。
- 前端开发页面：http://localhost:5173 (opens new window)，项目未显式覆盖 Vite 默认端口，实际以启动日志为准。
- 登录入口：前端
/login；管理端基础路由/admin。
# 数据库
- 配置数据库名：
a_2026_11_nursing_system。 - 主初始化脚本：
sql/sql.sql。 - 主脚本建表数量：16 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
- 字符集：主脚本采用 utf8mb4。
- 数据表清单：
activity、activity_signup、admin、bed、care_record、diet、elderly、family、family_elderly、fee_record、feedback、health_record、notice、nurse、service_item、visit_record。
# 文件上传
- 上传接口：
POST /file/upload。 - 文件访问：
GET /file/{fileName}。 - 配置限制：单文件 100MB，单次请求 1000MB。
- 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。
# 系统特色
# 老人独立使用入口
老人可登录前台查看本人服务信息，区别于由家属代操作的设计。
# 照护记录集中管理
健康、护理、膳食、床位和探访分别记录，方便追溯日常服务。
# 家属关系维护
通过家属关联表组织家属与老人的对应关系。
# 当前实现说明
- 没有独立医生登录角色，也未核实独立处方、用药提醒或设备健康监测模块。
- 家属当前后台菜单主要为首页和公告，不能把老人前台全部功能直接写成家属可用功能。
- 费用支付服务仅更新支付状态与时间，没有实际扣款逻辑；“已退款”选项不代表已实现自动退款。
- 源码保留部分通用 USER、余额页面或服务，但主初始化 SQL 没有对应 user 表，不作为本系统可直接使用的余额功能介绍。
本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。