README.md · zzx/health_assistant

## 交流QQ群：965617357

# 健康助手

学生健康报备、员工防疫筛查、个人健康打卡、社区管理、政府汇总等

## 介绍

这是健康助手的说明文档，适用于任何的团体，如班级、部门、学校、公司、地区政府等，自由创建，自助建立从属关系，对学生、员工、个人进行健康登记、防疫排查等功能。

- 可以先建立班级，进行统计，之后再建立学校，进行汇总；
- 可以直接创建公司，再创建所属部门，人员分部门管理；
- 可以只创建部门，汇总之后再上报公司；
- 地方政府也可以创建团体，汇总各部门、所管辖地区企业的信息；
- 社区使用，按楼建立团体（如19栋），再做成社区。

创建好团体之后，开放成员注册，即可以自助录入部门员工信息、班级学生信息、楼层住户信息等，之后可以关闭成员注册，减少管理员的工作量。
管理员也可以录入成员，修改、删除成员。
在填写报备时，输入的个人信息可以和之前注册的信息对比，非团体成员不能提交报备。

项目来源于DCloud的“学生健康报备管理系统”项目，重新设计数据表、页面、云函数，便于扩展和迭代开发。

抗击肺炎，中国加油！

## 截图

## 软件架构

### 网页形式（一期实现）

> 页面名称：user_login<br/>
> 数据表：ha_user_account<br/>
> 云函数：ha_check_account<br/>
> END

> 页面名称：user_register<br/>
> 数据表：ha_user_account<br/>
> 云函数：ha_add_account<br/>
> END

> 页面名称：index<br/>
> 数据表：多个数据表<br/>
> 云函数：<br/>
>> 链接：<a href="#mk21">个人中心（原个人设置改为个人中心）</a>
>
>> 分栏：我的团体
>>> 我管理的团体列表：<a href="#mk06">团体详情</a><br/>
>>> 链接：<a href="#mk03">创建团体</a>
>
>> 链接：<a href="#mk13">我的模板</a>
>
> END

> 页面名称：user_nest<br/>
> 数据表：ha_user_account<br/>
> 云函数：<br/>
> 修改密码、手机号、Email等功能，为后期找回密码服务<br/>
>
> <a href="#mk01">个人设置</a><br/>
> <a href="#mk22">修改密码</a><br/>
>
> END

> 页面名称：user_setting<br/>
> 数据表：ha_user_account<br/>
> 云函数：ha_update_account<br/>
> 设置个人手机号、Email等功能
>
> END

> 页面名称：user_chg_password<br/>
> 数据表：ha_user_account<br/>
> 云函数：<br/>
> 修改密码功能
>
> END

> 页面名称：create_group<br/>
> 数据表：ha_group_list<br/>
> 云函数：ha_add_group<br/>
> 参见ha_group_list
>
> END

> 页面名称：group_detail<br/>
> 数据表：ha_group_list、ha_report_list<br/>
> 云函数：ha_get_group、ha_update_report
>> 链接：<a href="#mk09">成员管理</a><br/>
>> 已建报备列表：<a href="#mk12">复制链接</a>、<a href="#mk08">查看统计</a>、<a>开启/关闭</a>、删除<br/>
>> 链接：<a href="#mk07">新建报备</a><br/>
>> 团体操作：<a>修改</a>、删除<br/>
>> 修改、删除只能由本团体所有者操作<br/>
>> <a href="#mk17">加入申请</a>
>
>> <a href="#mk18">出入管理</a>
>
>> 分栏：下属团体
>>> 下属团体列表：<a href="#mk06">团体详情</a>、<a>断开关系（仅对第一层下属有效）</a><br/>
>>> 需要记录进入下属团体的层级信息<br/>
>>> 是否可以点击进入下属团体，受<a href="#mk16">团体作用域</a>影响<br/>
>
> END

> 页面名称：create_report<br/>
> 数据表：ha_user_template、ha_template_list、ha_report_list<br/>
> 云函数：ha_add_report
>> 单选框，选择自有的还是公共的模板<br/>
>> 下拉菜单选择模板，并预览<br/>
>>
>> 根据ha_group_person的人员信息，选择报备首页的验证信息<br/>
>> 如勾选名字和身份证号，则在点开报备链接时，首先要输入名字和身份证，确认正确后，进行实际报备的填写<br/>
>>
>> 选择是否激活，以及报备间隔时间，参见ha_report_list<br/>
>>
>> 同时新建下属团体的报备，参见<a href="#mk16">作用域</a>。<br/>
>
> END

> 页面名称：report_detail<br/>
> 数据表：ha_report_list、ha_report_record<br/>
> 云函数：
>> 多种方式显示
>> 导出成excel功能
>
> END

> 页面名称：member_manage<br/>
> 数据表：ha_group_person<br/>
> 云函数：ha_add_member、ha_update_member
>> 人员列表：<a>查看</a>、<a>修改</a>、删除<br/>
>> 链接：<a href="#mk10">新增成员</a><br/>
>> 是否开放成员注册？<a href="#mk11">成员注册</a><br/>

>
> END

> 页面名称：create_member<br/>
> 数据表：ha_group_person<br/>
> 云函数：ha_add_member
> 参见ha_group_person
>
> END

> 页面名称：member_register<br/>
> 数据表：ha_group_person<br/>
> 云函数：ha_add_member
> 参见ha_group_person
>
> END

> 页面名称：do_report<br/>
> 数据表：ha_report_record<br/>
> 云函数：ha_check_member、ha_add_record
>> 首先填写成员信息，检查是否是本团体的成员<br/>
>> 再填写报备信息，最后提交
>
> END

### 网页形式（续）

> 页面名称：my_template<br/>
> 数据表：ha_user_template<br/>
> 云函数：ha_get_my_tpl
>> 分栏：模板列表(get_way != 2)<br/>
>> 分栏：收到的模板(get_way == 2)<br/>
>> 每个项：<a href="#mk14">查看模板</a>、删除<br/>
>>
>> <a href="#mk15">查看公共模板</a>
>>
>> <a href="#mk14">导入模板</a>按钮（json格式），选择后进入预览模板页面，如格式错要提示并终止
>
> END

> 页面名称：tpl_review<br/>
> 数据表：ha_template_list<br/>
> 云函数：ha_get_tpl<br/>
> 查看现有的模板，则只有返回按钮<br/>
> 由导入按钮进行的预览，有确定导入和返回按钮
>
> END

<h2 id="mk15">公共模板列表</h2>

> 页面名称：tpl_pub_list<br/>
> 数据表：ha_template_list<br/>
> 云函数：ha_get_pub_tpl<br/>
> 下拉菜单选择，下面预览<br/>
> <a>收藏</a>按钮
>
> END

<h2>关于有从属关系的团体说明：</h2>

* 下属团体<span id="mk16">作用域</span>：是往下三级，第四级将不受作用
* 当前团体->第一级->第二级->第三级，往下不受作用
* 如碰到下属团体is_split==true时，则往下的团体不受作用
* 报备与团体有关，参见ha_report_list，当一个团体有下属团体时，新建报备，将在所有作用域中的团体，新建相同的报备。

> 页面名称：join_group<br/>
> 数据表：ha_group_list<br/>
> 云函数：ha_update_group<br/>
> 这个页面包含group的ID<br/>
> 分享这个页面给下属团体<br/>
> 获得已登录用户账号的团体<br/>
> 下拉菜单选择当前用户账号的团体<br/>
> <a>申请加入</a>
>
> END

> 页面名称：access_manage<br/>
> 数据表：ha_access_list<br/>
> 云函数：<br/>
>
> 出入登记点列表：<a href="#mk19">查看</a>、删除<br/>
> <a href="#mk20">创建出入登记点</a><br/>
>
> END

> 页面名称：access_detail<br/>
> 数据表：ha_access_list<br/>
> 云函数：<br/>
>
> 出入点是否开启<br/>
>
> 生成管理人员二维码：含出入登记点id的<a href="#mk23">access_admin</a>页面二维码<br/>
> 扫码后需要输入8位校验码进行验证<br/>
> 显示和更新管理人员校验码<br/>
>
> 生成人员登记二维码：含出入登记点id的<a href="#mk24">access_checkin</a>页面二维码<br/>
>
> END

<h2 id="mk20">创建出入登记点</h2>

> 页面名称：create_access<br/>
> 数据表：ha_access_list<br/>
> 云函数：<br/>
> 创建出入登记点<br/>
>
> END

<h2 id="mk23">出入登记管理员页面</h2>

> 页面名称：access_admin<br/>
> 数据表：ha_access_list<br/>
> 云函数：<br/>
>
> 扫码后，输入校验码check_code，成功后进入本页面<br/>
>
> 本出入点出入人员列表：<a>同意进入</a>、<a>离开</a><br/>
> 可以按access_state分类显示<br/>
> 可以按时间（天）显示<br/>
>
> 可以搜索出入人员（含本团体其它出入口的）<br/>
>
> END

<h2 id="mk24">进入登记页面</h2>

> 页面名称：access_checkin<br/>
> 数据表：ha_access_list<br/>
> 云函数：<br/>
> 进入人员扫码后进入本页面，填写相关内容后，提交登记<br/>
>
> END

<!-- <h2 id="mk02">添加人员</h2>

> 页面名称：<br/>
> 数据表：ha_user_person、ha_relation_user<br/>
> 云函数：<br/>
>
> END -->

<!-- <h2 id="mk04">健康打卡</h2>

> 页面名称：<br/>
> 数据表：<br/>
> 云函数：<br/>
>
> END -->

<!-- <h2 id="mk05">人员详情</h2>

> 页面名称：<br/>
> 数据表：<br/>
> 云函数：<br/>
>
> END -->

软件架构说明

- 注册登录
- 团体管理
- 健康上报
- 数据查看

### 底部导航形式（二期实现）

```
- 底部导航
  |__ 主页（home）
  |__ xxx
  |__ xxx
  |__ 个人中心（user_nest）

- 主页（home）
  |__ xxx

- 个人中心（user_nest）
  |__ xxx
```

Tips：页面可以重建，请保持名称不变

## 参与贡献

参考DCloud提出的方式，请在文件开始处填写开发者名字、所处城市、邮箱等信息

开发者报名要参与开发哪些文件。具体方式如下：
    
    - 首先要参与哪个项目，就把哪个项目git先fork，然后导入本地开发环境。注意不要fork xinguan2020 这个汇总项目，要fork具体的项目。
    - 注意不要直接导入git项目，要先fork，修改自己本地的git，然后提交pr。
    - 如果不了解提pr的方法，参考[码云教程](https://gitee.com/help/articles/4128#article-header0)
    - 然后打开你要编辑的文件，在开头以注释方式编写你的信息，声明你在做这个文件。比如
    ```javascript
    // 我在做这个文件，我的群昵称是xxx。（如果是vue文件，注释要用)
    ```
    - 然后把这个修改提交pr。意思就是你报名要修改这个文件，且公知给其他人。
    - 项目负责人会合并这个报名的pr。
    - 等你开发文件完毕后，再把这个文件再次提交pr。项目负责人会合并pr。
    - 如果你是参与项目的核心开发者，也可以把你的码云账户发到项目负责人那里，申请直接加为项目组成员，就可以直接提交而不是通过pr方式提交了。

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

## 发布方式

- Saas方式，不需要另外部署，直接多用户使用
- 基于uni-app的技术支撑，多端、多形态发布，H5、小程序、app等
- 所用端口，不同形态的接口，共享数据，同一账号在用不同的方式登录都可以

### 体验链接

无

## 数据库设计

参考 [db.md](db.md)

### 空间与小程序appID设置
- 在`main.js`中设置空间的`spaceId`、`clientSecret`；
- 在`manifest.json`中设置微信小程序的`appID`，否则微信端获取的code为：`the code is a mock one`；
- 在`cloudfunctions-dev/src/utils/constants.js`中设置`AppId`、`AppSecret`、`passSecret`字段，否则不能获取`openid`;

### token获取详情
获取用户信息需要根据token获取，方法如下，成功后，`res.data`为详细信息，对应信息如下。

```JS
validateToken() {
				uni.showLoading({
					title: '加载中...'
				});
				uniCloud.callFunction({
					name: 'validateToken',
					data: {
						token: uni.getStorageSync('token')
					}
				}).then((res) => {
					uni.hideLoading()
					uni.showModal({
						content: res.result.msg,
						showCancel: false
					})
				}).catch((err) => {
					uni.hideLoading()
					uni.showModal({
						content: '请求云函数发生错误，' + err.message,
						showCancel: false
					})
				})
			},
```

## 码云特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  码云官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解码云上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是码云最有价值开源项目，是码云综合评定出的优秀开源项目
5.  码云官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  码云封面人物是一档用来展示码云会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

## 捐赠说明

捐赠将用于加快项目开发、优化项目，以及其他开源公益项目。
桌面版可进行捐赠。

zzx/health_assistant

简介

发行版

贡献者

近期动态

zzx/health_assistant .gitee-modal { width: 500px !important; }

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

zzx/health_assistant