# V3陪诊

**Repository Path**: ha-lang/pz-v3

## Basic Information

- **Project Name**: V3陪诊
- **Description**: v3陪诊系统是一个面向医院、陪诊公司及患者用户的全流程陪诊服务平台。项目采用前后端分离架构，分为用户端（C端，pzH5）和管理端（B端，pzadmin）两大部分，分别满足不同角色的业务需求。

pzH5：面向患者/家属等终端用户，提供陪诊服务预约、订单管理、个人中心等功能的H5移动端应用。
pzadmin：面向医院/陪诊公司工作人员，提供订单管理、人员管理、权限分配、数据统计等功能的后台管理系统。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-10-11
- **Last Updated**: 2025-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# v3陪诊系统项目说明

## 一、项目简介

v3陪诊系统是一个面向医院、陪诊公司及患者用户的全流程陪诊服务平台。项目采用前后端分离架构，分为用户端（C端，pzH5）和管理端（B端，pzadmin）两大部分，分别满足不同角色的业务需求。

- **pzH5**：面向患者/家属等终端用户，提供陪诊服务预约、订单管理、个人中心等功能的H5移动端应用。
- **pzadmin**：面向医院/陪诊公司工作人员，提供订单管理、人员管理、权限分配、数据统计等功能的后台管理系统。

---

## 二、主要功能

### 1. pzH5（用户端）

- **用户注册/登录**：支持手机号验证码注册、登录，保障账户安全。
- **陪诊服务浏览**：展示陪诊服务类型、服务介绍、价格等信息。
- **在线下单**：填写陪诊需求，选择服务类型、时间、陪诊员等，提交订单。
- **订单管理**：查看订单列表、订单详情、订单状态（待支付、已支付、进行中、已完成、已取消等）。
- **支付功能**：集成第三方支付（如微信支付、支付宝等，具体视后端实现）。
- **订单进度跟踪**：实时查看陪诊进度，支持订单状态推送提醒。
- **个人中心**：管理个人信息、历史订单、评价反馈等。
- **消息通知**：订单状态变更、服务提醒等消息推送。
- **移动端适配**：自适应各类手机屏幕，流畅体验。

### 2. pzadmin（管理端）

- **系统登录/权限管理**：多角色支持（管理员、陪诊员、客服等），权限分级分配。
- **订单管理**：查看、筛选、分配、处理所有陪诊订单，支持订单状态流转。
- **陪诊员管理**：增删改查陪诊员信息，分配订单，查看服务记录。
- **用户管理**：管理平台用户，查看用户信息、历史订单、评价等。
- **数据统计与报表**：订单量、收入、服务评价等多维度数据统计与导出。
- **服务配置**：管理服务类型、价格、时间段等基础配置。
- **系统设置**：菜单管理、角色权限分配、公告发布等。
- **操作日志**：记录关键操作，便于追溯和审计。

---

## 三、技术栈说明

### 前端

#### pzH5（用户端）

- 框架：Vue 3
- 构建工具：Vite
- UI组件库：Vant 4
- 状态管理：Pinia
- 路由管理：Vue Router
- 网络请求：Axios
- 移动端适配：flex布局、rem自适应
- 代码规范：ESLint、Prettier

#### pzadmin（管理端）

- 框架：Vue 3
- 构建工具：Vite
- UI组件库：Element Plus
- 状态管理：Pinia
- 路由管理：Vue Router
- 网络请求：Axios
- 代码规范：ESLint、Prettier

### 后端

> 本项目仓库仅包含前端代码，后端服务需单独部署（如 Node.js、Java、Python 等，需对接 RESTful API，具体接口文档请联系开发者）。

---

## 四、项目结构

```
v3陪诊系统/
├── pzH5/                # 用户端H5应用
│   ├── src/            
│   │   ├── api/        # API接口封装
│   │   ├── assets/     # 静态资源
│   │   ├── components/ # 公共组件
│   │   ├── pages/      # 页面组件
│   │   ├── router/     # 路由配置
│   │   └── utils/      # 工具函数
│   └── vite.config.js  # Vite配置
│
└── pzadmin/            # 管理后台
    ├── src/
    │   ├── api/        
    │   ├── assets/
    │   ├── components/
    │   ├── router/
    │   ├── store/      # 状态管理
    │   ├── utils/
    │   └── views/      # 业务页面
    └── vite.config.js
```

---

## 五、用户角色与适用场景

- **患者/家属（C端）**：通过H5端预约陪诊服务，管理订单，获取服务进度。
- **陪诊员（B端）**：通过管理后台接收、处理订单，管理服务记录。
- **管理员/运营（B端）**：管理平台用户、陪诊员、订单，配置服务，查看统计报表。

---

## 六、运行与部署说明

### 1. 环境准备

- Node.js 16 及以上版本
- npm 8 及以上版本（或 yarn/pnpm）

### 2. 安装依赖

分别进入 pzadmin 和 pzH5 目录，执行依赖安装：

```bash
# 进入后台管理端
cd pzadmin
npm install

# 进入H5端
cd ../pzH5
npm install
```

### 3. 启动开发环境

分别启动两个端口：

```bash
# 启动后台管理端
cd pzadmin
npm run dev

# 启动H5端
cd ../pzH5
npm run dev
```

- 启动后，后台管理端（pzadmin）和H5端（pzH5）会分别在本地不同端口运行（如 http://localhost:5173）。
- 具体访问端口请以终端输出为准。

### 4. 生产环境打包

```bash
# 后台管理端打包
cd pzadmin
npm run build

# H5端打包
cd ../pzH5
npm run build
```

打包后会生成 dist 目录，可用于部署到服务器。

---