# hleath

**Repository Path**: zhuimengning/hleath

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-31
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 员工健康疗休养管理系统

基于Frappe框架的员工健康疗休养信息查询系统，包含微信小程序前端。

## 功能特性

- ✅ 微信小程序登录认证
- ✅ 员工信息查询
- ✅ 疗养资格查询
- ✅ 疗养费用查询
- ✅ 历史记录查询
- ✅ 数据权限隔离

## 技术栈

### 后端
- Frappe Framework v15
- Python 3.8+
- MariaDB

### 前端
- uni-app
- Vue 3
- 微信小程序

## 安装部署

### 1. 安装应用到Frappe

```bash
# 进入frappe-bench目录
cd /home/frappe/frappe-bench

# 安装应用
bench get-app https://gitee.com/zhuimengning/hleath.git

# 安装到站点
bench --site your-site install-app health

# 运行迁移
bench --site your-site migrate

# 重启服务
bench restart
```

### 2. 配置微信小程序

#### 方式一：修改代码配置（开发测试）

编辑文件 `health/api/wechat.py`：

```python
WECHAT_APPID = "你的小程序AppID"
WECHAT_SECRET = "你的小程序AppSecret"
```

#### 方式二：使用环境变量（推荐生产环境）

```bash
export WECHAT_APPID="你的小程序AppID"
export WECHAT_SECRET="你的小程序AppSecret"
```

#### 方式三：创建配置DocType（最安全）

创建"Health Settings" Singleton DocType，在后台配置密钥。

### 3. 配置小程序前端

编辑文件 `miniprogram/api/request.js`：

```javascript
const BASE_URL = 'http://你的服务器地址:端口'
```

编辑文件 `miniprogram/manifest.json`：

```json
{
  "mp-weixin": {
    "appid": "你的小程序AppID"
  }
}
```

### 4. 创建测试数据

访问 Frappe 后台：`http://你的服务器地址:8000/desk`

创建员工记录：
- ERP编号
- 姓名
- 身份证号
- 参加工作时间
- 员工状态

## 微信小程序开发

### 使用微信开发者工具

1. 下载微信开发者工具：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
2. 导入项目：`miniprogram` 目录
3. 配置AppID
4. 关闭域名校验（开发阶段）
5. 开始调试

### 测试流程

1. 创建测试员工数据
2. 测试登录API
3. 测试绑定流程
4. 测试数据查询
5. 真机调试

## API接口

### 登录接口

```
POST /api/method/health.api.wechat.login
参数: code (微信登录code)
返回: { success, is_bound, openid, message }
```

### 绑定手机

```
POST /api/method/health.api.wechat.bind_phone
参数: openid, phone_number
返回: { success, message, employee_name, erp_no, token }
```

### 查询员工信息

```
GET /api/method/health.api.wechat.get_employee_info
请求头: Authorization: {token}
返回: { success, data }
```

### 查询疗养资格

```
GET /api/method/health.api.wechat.get_rest_info
请求头: Authorization: {token}
返回: { success, data }
```

### 查询疗养费用

```
GET /api/method/health.api.wechat.get_fee_info
请求头: Authorization: {token}
返回: { success, data }
```

## 项目结构

```
health/
├── health/
│   ├── api/                    # API接口
│   │   └── wechat.py          # 微信相关API
│   ├── health/
│   │   ├── doctype/           # DocType定义
│   │   │   ├── employee_health_rest_record/
│   │   │   ├── attendance_record/
│   │   │   ├── honor_record/
│   │   │   ├── rest_fee_payment/
│   │   │   └── wechat_user_binding/
│   │   └── workflow/          # 工作流
├── miniprogram/               # 微信小程序
│   ├── pages/                # 页面
│   │   ├── login/           # 登录页
│   │   ├── bind-phone/     # 绑定手机页
│   │   ├── index/          # 首页
│   │   ├── rest-info/     # 疗养资格页
│   │   ├── fee-info/      # 疗养费用页
│   │   ├── history/       # 历史记录页
│   │   └── profile/       # 个人中心页
│   ├── api/                 # API封装
│   └── static/              # 静态资源
└── 开发文档/                  # 开发文档
    ├── 微信小程序开发计划.md
    ├── 小程序部署文档.md
    ├── 完整测试指南.md
    └── 配置说明.md
```

## 安全注意事项

⚠️ **重要：不要将敏感信息提交到代码仓库**

- AppSecret 不要硬编码在代码中
- 使用环境变量或配置文件存储密钥
- 生产环境必须使用HTTPS
- 配置服务器域名白名单

## 开发文档

- [微信小程序开发计划](开发文档/微信小程序开发计划.md)
- [小程序部署文档](开发文档/小程序部署文档.md)
- [完整测试指南](开发文档/完整测试指南.md)
- [配置说明](开发文档/配置说明.md)

## 许可证

MIT License

## 联系方式

如有问题，请提交Issue或联系开发团队。

---

**版本**：v1.0.0  
**更新日期**：2026-04-04