# guard

**Repository Path**: Targerr/guard

## Basic Information

- **Project Name**: guard
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: springboot3
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-02
- **Last Updated**: 2026-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">勐海椿龄守护</h1>
<h4 align="center">居家上门服务管理平台 — 微信小程序 + 管理后台</h4>
<p align="center">
	<img src="https://img.shields.io/badge/Spring%20Boot-3.5.11-brightgreen.svg">
	<img src="https://img.shields.io/badge/Vue-3.x-brightgreen.svg">
	<img src="https://img.shields.io/badge/MyBatis--Plus-3.5.10-blue.svg">
	<img src="https://img.shields.io/badge/JDK-17+-orange.svg">
</p>

## 项目简介

**勐海椿龄守护** 是面向云南省勐海县的居家上门养老服务管理平台。采用类 Uber 模式：老人/家属发布服务需求，服务人员接单上门，平台管理质量与结算。平台同时作为政府补贴通道，服务于社会救助人员。

平台包含三个前端应用，共享一个后端：

| 平台 | 目标用户 | 技术方案 |
|---|---|---|
| 客户端小程序 | 老人/家属（发起服务） | 微信小程序 |
| 服务人员端小程序 | 服务人员及志愿者 | 微信小程序 |
| 管理后台 | 运营人员/民政监管部门 | PC Web（Vue 3 + Element Plus） |

## 核心业务

### 用户与身份

- **普通用户**：微信支付自费
- **社会救助人员**：通过预导入政府台账自动匹配识别（手机号优先于身份证号），服务免费，平台与政府结算
- **代预约**：子女/家属可代替老人下单，系统记录预约人与被服务人的关系

### 服务目录

两级分类，每项固定价格，后台配置：

| 一级分类 | 服务项目 |
|---|---|
| 助洁 | 日常打扫、厨房深度清洁、卫浴清洁、洗衣 |
| 助餐 | 上门做饭、营养配餐、送餐 |
| 助浴 | 居家助浴、卧床擦浴 |
| 助医 | 测量血压/血糖、陪同就医、代购药品 |
| 精神慰藉 | 陪伴聊天、心理疏导 |
| 专项守护 | 日间照料、夜间看护、紧急呼叫响应 |

### 订单生命周期

```
用户下单 → 需求单（待接单）→ 指派服务人员 → 确认/支付 → 正式订单（待服务）
→ 服务人员打卡（出发→到达→服务中→完工）→ 用户评价 → 已完成
```

- 救助订单用户端显示 ¥0，服务人员端显示标准价格
- 72 小时未评价自动确认

### 服务人员打卡流程

1. 出发 GPS 打卡
2. 1 张到达照片（门口/入户）
3. 3+ 张服务过程照片
4. 1-3 张完工照片
5. 反馈清单（老人情绪、安全隐患、后续需求）

## 管理后台功能

### 核心业务

| 模块 | 功能 |
|---|---|
| 数据概览 | 今日订单、待接需求单、救助订单占比、代预约占比、7 天趋势图、服务类型分布 |
| 需求单管理 | 卡片式展示、按类型/状态筛选、人工指派、取消、查看详情 |
| 订单管理 | 完整订单列表、多状态筛选（待服务/服务中/待评价/已完成/已取消）、详情/重分配/中止 |
| 用户管理 | 用户列表、被服务人管理（含关系）、救助身份设置、订单数统计 |
| 救助人员管理 | 政府补贴台账管理、人员列表/匹配日志/Excel 批量导入 |
| 服务人员管理 | 工号/技能/工时/好评率、入驻审核、冻结账户 |

### 业务配置

| 模块 | 功能 |
|---|---|
| 服务项目管理 | 两级分类管理、服务项配置（价格/时长/所需技能）、类别专属自定义字段 |
| 技能标签管理 | 服务技能/护理资质/语言能力/专项认证标签 |
| 资讯管理 | 政策通知/招募公告/服务指南/活动通知/健康科普发布 |

### 财务报表

| 模块 | 功能 |
|---|---|
| 财务结算 | 普通收入/政府补贴统计、服务人员结算单生成、明细查看 |

## 技术栈

### 后端

- Java 17+、Spring Boot 3.5.11、Spring Security
- MyBatis + MyBatis-Plus 3.5.10（guard 业务模块使用 MyBatis-Plus）
- MySQL + Druid 连接池、Redis（Lettuce）
- JWT 认证、PageHelper 分页、FastJSON2
- SpringDoc OpenAPI、Quartz 定时任务

### 前端（管理后台 guard-ui）

- Vue 3 + TypeScript + Vite
- Element Plus + Pinia + Vue Router 4
- unplugin-auto-import 自动导入

### 小程序

- 微信小程序原生开发
- 微信支付 JSAPI、GCJ-02 坐标系

## 模块结构

```
guard-admin       — Web 入口，REST 控制器，Spring Boot 启动类，配置文件
guard-framework   — Spring Security 配置，JWT 过滤器，数据源，AOP 切面，异常处理
guard-system      — 系统管理：用户/角色/菜单/部门/字典/日志 + Guard 业务域
guard-common      — 公共模块：注解、基础类、工具类、常量、Redis 封装、异常
guard-quartz      — Quartz 定时任务管理
guard-generator   — 代码生成器
guard-ui          — Vue 3 管理后台前端
```

依赖链：`common ← system ← framework ← admin`，`quartz` 和 `generator` 也依赖 `common`。

## 构建与运行

```bash
# 后端构建
mvn package -DskipTests

# 启动后端（端口 8080）
cd guard-admin && mvn spring-boot:run

# 启动管理后台前端
cd guard-ui && npm install && npm run dev
```

前置条件：Java 17+、MySQL、Redis（localhost:6379）。SQL 初始化脚本在 `sql/` 目录下。

## 配置

后端配置文件在 `guard-admin/src/main/resources/`：

- `application.yml` — 服务端口、Redis、JWT、MyBatis-Plus 扫描
- `application-druid.yml` — MySQL 数据源配置
- `mybatis/mybatis-config.xml` — MyBatis 全局设置

## 许可证

基于 [RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue)（MIT License）二次开发。