康颐智慧养老院面向入住长者家属的移动应用，家属可查看长者的健康数据、护理记录、服务订单，在线预约院内增值服务、报名活动、与护理员及院方沟通-我爱数钱钱

# 康颐智慧养老院

## 一、项目定位

**智慧养老家属端**：面向入住长者家属的移动应用，家属可查看长者的健康数据、护理记录、服务订单，在线预约院内增值服务、报名活动、与护理员及院方沟通、提交投诉反馈。
院方一侧通过 **Laravel Nova** 后台统一管理长者档案、护理员、服务项目、订单、护理记录、活动公告与反馈处理。

### 技术栈（实况）

| 层 | 技术 | 版本 |
| — | — | — |
| 后端 | Laravel | 13.29.0 |
| PHP | phpEnv 自带 | 8.4.23（满足 `^8.3`） |
| 数据库 | MySQL | 5.7（库名 `nova_admin`） |
| 管理后台 | Laravel Nova | 5.x（已随项目安装） |
| 前端 | uni-app（Vue3 + Vite） | compiler 4.84 / vite 5.2.8 |

—

## 二、目录结构

“`
G:\work\养老院\
├── app/
│ ├── Http/
│ │ ├── Controllers/Api/ # 移动端 API 控制器（14 个）
│ │ │ ├── BaseApiController.php 统一响应/分页/当前用户
│ │ │ ├── AuthController.php 认证
│ │ │ ├── HomeController.php 首页聚合 + 站点配置
│ │ │ ├── ElderlyController.php 老人档案
│ │ │ ├── CaregiverController.php 护理员 + 排班
│ │ │ ├── ServiceController.php 服务分类/列表/详情
│ │ │ ├── OrderController.php 服务订单
│ │ │ ├── CareRecordController.php护理记录
│ │ │ ├── HealthController.php 健康数据 + 趋势
│ │ │ ├── NotificationController.php 通知中心
│ │ │ ├── ActivityController.php 活动 + 报名
│ │ │ ├── AnnouncementController.php 公告
│ │ │ ├── FeedbackController.php 投诉反馈
│ │ │ ├── ChatController.php 在线沟通
│ │ │ └── UploadController.php 图片上传
│ │ └── Middleware/
│ │ ├── ApiAuth.php Token 鉴权
│ │ └── Cors.php 跨域（OPTIONS 预检直返 204）
│ ├── Models/ 18 个 Eloquent 模型
│ ├── Services/
│ │ ├── OrderService.php 订单业务（事务 + 乐观锁，API/后台共用）
│ │ └── NotificationService.php 站内通知（单发/广播）
│ ├── Support/Image.php 图片 URL / 多图数组处理
│ └── Nova/ Nova 后台资源
├── bootstrap/app.php 路由注册 / 中间件 / 异常统一响应
├── config/
│ ├── app.php timezone=Asia/Shanghai
│ └── database.php mysql engine=InnoDB
├── database/
│ ├── migrations/ 5 个业务迁移（16 张业务表）
│ ├── seeders/DatabaseSeeder.php 全量演示数据
│ └── seeders/gen_seed_images.py 占位图生成脚本
├── public/uploads/seed/ 35 张本地 SVG 占位图
├── routes/
│ ├── api.php 移动端 API（60 条路由）
│ └── web.php
├── scripts/ ★ 运维与验证脚本
│ ├── serve.sh 后端 dev server 启停（绕过 artisan serve 限制）
│ ├── api-smoke.sh API 全量冒烟测试（60 项断言）
│ ├── db-reset.sh 演示数据重置
│ └── e2e-screenshots.cjs 前端端到端巡检 + 截图
├── screenshots/app/ 26 张页面截图 + report.json
├── base-uni-app/ ★ 前端（Vue3 + Vite）
│ ├── src/
│ │ ├── config/index.js BASE_URL / token key / 主题色
│ │ ├── utils/request.js 请求封装 + 上传
│ │ ├── utils/format.js 格式化与状态映射
│ │ ├── api/index.js 接口模块（与后端一一对应）
│ │ ├── store/index.js 轻量全局状态
│ │ ├── styles/common.scss 全局样式与原子类
│ │ ├── uni.scss 设计令牌
│ │ ├── components/yy-*/ 7 个自研组件
│ │ └── pages/ 26 个页面
│ └── dist/build/h5/ 构建产物
├── PROJECT_ANALYSIS.md 本文件
└── handoff.md 交接状态
“`