修改人脸门禁管理，更改相关目录

需求/绘管家/人脸门禁管理/人脸门禁设备管理.md

@@ -1,142 +0,0 @@
-# 人脸门禁设备管理需求文档
-
-人脸门禁系统是服务住户，方便住户出入小区，直接刷脸，不需带任何设备。便捷，安全。
-
-### 业务说明
-
-人脸门禁设备是厂商给我们提供硬件，我们对接接口，安装到小区后，为小区用户提供便捷安全的服务。
-
-# [原型地址](https://org.modao.cc/app/e6901721256b50fa80884755fcf42250e875e733)
-
-### 流程图
-
- ![image/流程图](image/流程图.png)
-
-### 平台管理
-
-![image/平台列表页](image/平台列表页.png)
-
-![image/添加门禁对接平台](image/添加门禁对接平台.png)
-**表字段说明** 
-
-| 字段名称     | 字段类型   | 备注                  | 是否必填 |
-| -------- | ------ | ------------------- | ---- |
-| 平台方      | enum   | 目前是 宇松 GAT 海康威视 这三家 | 是    |
-| 平台应用分配id | string |                     | 是    |
-| 平台应用密钥   | string | 脱敏处理                | 是    |
-| 应用编号     | string | 第三方反馈的              | 否    |
-
-删除记录时判断此平台是否关联有数据，如果关联数据不能删除。
-![image/平台删除否](image/平台删除否.png)
-
-### 小区管理员
-
-![image/小区管理员列表](image/小区管理员列表.png)
-
-**表字段说明**
-
-| 字段名称  | 字段类型   | 备注            | 是否必填 |
-| ----- | ------ | ------------- | ---- |
-| 平台方   | enum   |               | 是    |
-| 小区名称  | string |               | 是    |
-| 管理员姓名 | string |               | 是    |
-| 联系电话  | string |               | 是    |
-| 管理员编号 | string | 厂商反馈          | 否    |
-| 账号    | string | 此账户用于管理设备信息用的 | 是    |
-| 密码    | string | 脱敏            | 否    |
-| 状态    | int    | 1 正常 0 异常     | 否    |
-
-小区管理员是负责小区门禁设备的维护和运行。
-
-### 门禁管理
-
-![image/门禁管理列表](image/门禁管理列表.png)
-
-操作说明
-
-| 操作  | 备注                                                      |
-| --- | ------------------------------------------------------- |
-| 编辑  | 修改基础数据                                                  |
-| 安装  | 安装时判断"云之讯令牌"、 "云之讯用户编号"、 "人脸认证识别码"  这三个字段是否有数据，都有数据才能安装 |
-| 更换  | 更换设备序列号，更换新的门禁数据，移绑门禁组、通行信息，老数据删除                       |
-
-**表字段说明**
-
-| 字段名称    | 字段类型     | 备注                 | 是否必填 |
-| ------- | -------- | ------------------ | ---- |
-| 门禁名称    | string   |                    | 是    |
-| 供应商     | string   | 宇松、 海康威视、 GAT      | 是    |
-| 厂商编号    | string   |                    | 是    |
-| 云之讯令牌   | string   | 安装时需填              | 否    |
-| 云之讯用户编号 | string   | 安装时需填              | 否    |
-| 人脸认证识别码 | string   | 安装时需填              | 否    |
-| 设备MAC地址 | string   |                    | 否    |
-| 软件版本    | string   |                    | 否    |
-| 购买日期    | datetime |                    | 否    |
-| 免费保修截止日 | datetime |                    | 否    |
-| 说明      | string   |                    | 是    |
-| 业务状态    | string   | 报废、返厂、已上线、出库、在库、预检 | 是    |
-
-### 门禁组管理
-
-![image/门禁组管理](image/门禁组管理.png)
-**表字段说明**
-
-| 字段名称  | 字段类型     | 备注  | 是否必填 |
-| ----- | -------- | --- | ---- |
-| 小区名称  | string   |     | 是    |
-| 组名称   | string   |     | 是    |
-| 门禁组成员 | string   |     | 是    |
-| 创建时间  | datetime |     | 是    |
-
-以门禁组为单位便于住户通行，物业服务。审核通行证人员是按门禁组给住户分配的。
-
-### 小区门禁安装管理
-
-![image/门禁安装列表](image/门禁安装列表.png)
-**表字段说明**
-
-| 字段名称  | 字段类型     | 备注    | 是否必填 |
-| ----- | -------- | ----- | ---- |
-| 小区名称  | string   |       | 是    |
-| 门禁名称  | string   |       | 是    |
-| 安装位置  | string   |       | 是    |
-| 楼栋    | string   |       | 否    |
-| 单元    | string   |       | 否    |
-| 故障联系人 | string   |       | 是    |
-| 联系电话  | string   |       | 是    |
-| 设备序列号 | string   |       | 是    |
-| 网络状态  | string   | 在线、离线 | 是    |
-| 安装时间  | datetime |       | 是    |
-
-安装记录便于后期维护
-
-### 通行记录
-
-![image/通行记录](image/通行记录.png)
-
-### 访客管理
-
-![image/访客管理](image/访客管理.png)
-
-| 字段名称 | 字段类型     | 备注                | 是否必填 |
-| ---- | -------- | ----------------- | ---- |
-| 小区名称 | string   |                   | 是    |
-| 房号   | string   |                   | 是    |
-| 门禁名称 | string   | 同住户的通行门禁组一样       | 是    |
-| 访客姓名 | string   |                   | 否    |
-| 联系电话 | string   |                   | 是    |
-| 失效时间 | datetime | 系统生成，不同关系的访客时间不一样 | 是    |
-| 密码   | string   | 系统生成              | 是    |
-| 访客是由 | string   |                   | 是    |
-| 业主关系 | string   | 亲戚、朋友、外卖、快递、其他    | 否    |
-
-外卖、快递、其他 失效时间是半个小时，亲戚、朋友是8个小时。
-
-### 心跳记录
-
-![image/心跳记录](image/心跳记录.png)
-
-### 掉线记录
-
-![image/掉线记录](image/掉线记录.png)

需求/绘管家/智能硬件/人脸门禁管理/人脸门禁设备管理.md

@@ -0,0 +1,97 @@
+# 人脸门禁设备管理需求文档
+
+## 背景介绍
+
+人脸门禁设备是采用人脸比对的方式，如果人脸比对通过则可以刷脸进出，如果比对失败则无法进出，从而实现刷脸通行。人脸门禁一般安装在小区的主出入口，单元门。
+
+目前人脸门禁设备供应商有三家，分别是宇松科技，海康威视和GAT。
+
+* 宇松科技设备为定制安卓系统，为我司定制软件，软件直接与绘管家后台进行API数据对接；
+
+* 海康威视设备分为两种，一种是基于8700平台，一种是基于云眸社区平台。其中8700平台为局域网的设备管理平台，接入的小区需要在本地部署服务器，安装8700安防软件才可以管理，如果小区接入专线网络，本地服务器拥有独立IP，也可以对外提供接口（目前蓝岛康城，柳州项目即采用这种方式），因此使用8700平台的小区需要单独设置小区对应的对接服务器地址。云眸社区是海康于2019年推出的云平台，人脸门禁管理可以通过对接其云平台完成。
+
+* GAT：早期试用的一个厂家，目前仅在东方吉祥康郡使用，采用接口对接方式完成人脸门禁管理。
+
+## 业务说明 [原型地址](https://org.modao.cc/app/e6901721256b50fa80884755fcf42250e875e733)
+
+### 流程图
+
+门禁设备统一由平台集中管理，具体业务行为（人脸审核，通行证管理）由客户系统负责。
+
+#### 平台业务流程
+
+ ![平台维护部分流程](image/platformWorkflow.png)
+
+* 配置对接平台：宇松门禁设备，GAT和海康云眸社区设备只需要配置一次，所有设备都是通用的。8700平台需要针对每个小区设置一次，因为每个小区的服务器对接地址，appId和appSecret都不同。
+
+* 小区门禁配置：主要针对宇松门禁设备，GAT（海康云眸社区接口尚未提供），其中GAT需求配置小区的管理员账号和密码。宇松门禁需要配置客服中心电话，密码（用于输入密码直接查看设备信息，排查问题）。一个小区对应一条配置记录。
+
+* 设备信息录入：录入设备的基本信息，以便后续查看和集中管理，录入的信息包括设备名称，厂商编号（唯一），厂商名称，型号等信息。其中人脸激活码（用于人脸比对算法SDK），云之讯用户编号和令牌（用于拨打网络电话）均为宇松门禁专用属性。
+
+* 设备安装：设备安装指的是在线将门禁设备分配到对应小区对应的出入口门禁，为了方便分组和降低业务系统的侵入性，要求门禁名称与对应的小区的出入口门禁一致，例如蓝岛康城大门门禁应当录入为大门门禁，2号楼门禁应当录入为2号楼门禁。一个门禁设备只能安装一次，如果要重复安装，需要将之前的安装记录删除。
+
+* 门禁分组：考虑部分小区出入口很多，单元门禁也很多，为简化审核和统一访客密码（即多个门禁共用一个访客密码），需要对小区已安装的门禁设备进行分组。审核下发通行证时按门禁组下发，申请访客密码时也是按门禁组申请。同一个门禁可以在多个门禁组内，但不同门禁组内的门禁设备不能完全相同。
+
+* 设备监控：设备需要监控心跳（网络连接情况），掉线记录，通行记录，方便及时掌控设备状态和使用情况。
+
+* 设备更换：当设备发生损坏时，为不影响小区正常通行，需要更换设备，更换设备涉及如下操作：
+
+  * 录入新设备信息：更换前必须要要先录入新设备信息才可以进行更换（手动录入）
+
+  * 删除旧设备安装记录：将更换掉的旧设备安装记录删除
+
+  * 添加新设备安装记录：将旧设备的安装信息复制一份到新设备的安装记录（厂商编号不变）
+
+  * 更新新设备安装记录到对应的门禁组：所有旧设备所在门禁组的信息都需要替换为新设备的安装
+
+  * 将通行证人脸迁移到新设备
+
+  * 标记旧设备为返厂（维修）或报废（无法维修）
+
+  #### 业务系统流程（自助录入人脸）
+
+  # 
+
+  ### 
+
+  ### 
+
+  ## 
+
+  ![人脸审核业务流程](image/reviewFlow.png)
+
+* 入住房屋：未确保申请审核的人脸是本小区住户，用户在小区服务中申请通行时需要先入住房屋，如果已经入住则无需再次入住。
+
+* 添加人脸：用户添加人脸，已经添加过的人脸的用户可以使用之前的人脸也可以修改人脸。
+
+* 申请通行：用户申请在当前小区通行，即创建一条待审核的记录供物业方审核。申请通行后需要推送消息给相应的物业人员，提醒该人员及时审核。
+
+* 物业审核：物业人员审核时，需要判断照片是否合格（如不是人脸），是不是本小区住户；如果不满足通行条件可以直接拒绝，拒绝时需要填写拒绝理由，以便用户查看。拒绝时需要推送消息到用户，提示其提交的审核被拒绝及拒绝原因。
+
+* 允许通行：如物业人员核实用户提交的人脸符合通行条件，则下发给用户通行证，通行证通过门禁组下发。可一次下发多个门禁组，如果存在相同门禁，则只下发一次。
+
+* 设备审核：人脸照片下发后，设备需要下载对应图片进行特征码提取，可能存在特征码提取失败（如人脸照片不合格，不是人脸）或者照片下载失败，此时设备或第三方会告知平台人脸审核失败，系统也需要通知用户人脸审核失败，并标记审核记录为审核失败（__只要有一个门禁失败即视为审核失败__）。对于失败的通行证，物业也可以选择重新下发（如照片下载失败时，可以让设备重新下载）。如果__全部通行证__审核通过则标记对应的审核记录为成功，并推送消息告知用户审核成功。
+
+* 通行证审核通过后，用户即可通过相应门禁，用户刷脸通行时，设备会将刷脸信息（通行证编号，刷脸时间）上传给平台。
+
+#### 业主添加家人
+
+业主添加家人人脸通行和自助添加类似，只是添加家人时需要按表单填写家人姓名，手机号（考虑老人小孩没有手机，手机号可以与用户手机号相同，但是不能同时手机号和姓名都相同），与本人关系，录入家人人脸（家人信息存储在平台，以便重复使用），然后再提交审核。
+
+审核结果也需要推送消息告知业主。
+
+#### 物业录入人脸
+
+物业帮助住户录入人脸可通过绘管家App，Web端或绘管家公众号进行。流程如下：
+
+![物业录入人脸](image/addReviewByEmployee.png)
+
+物业录入人脸的流程相对简单，因为是物业人员录入，无需审核过程。只是录入的人脸人员信息必须从小区的住户表读取，如果没有住户信息则需先添加该住户。此举是为了帮助物业完善住户信息。
+
+### 业务说明
+
+* 住户人脸审核通过，分配通行证后方可申请访客密码供访客使用。
+
+* 家人和物业协助添加的住户由于无法关联到对应的终端(App，微信服务号，小程序)的用户，因此无法使用访客功能。数据表需考虑预留字段方便未来绑定对应的用户。
+
+* 表单字段可参照原型说明。

需求/绘管家/通行证审核/人脸通行证管理需求文档.md

@@ -1,47 +0,0 @@
-# 人脸通行证管理需求文档
-
-## 业务说明
-
-人脸通行证主要由住户通过绘服务app申请或者物业人员辅助后台添加，物业人员审核确认是否下发通行证。审核成功后，住户出入小区直接刷脸通行，无需带任何设备，物业也能有效的净化出入小区人口，带住户便捷安全的体验。
-
-# [原型地址](https://org.modao.cc/app/pKC7StsBjjWljraSVl4sKyiI4YoI8NM)
-
-## 流程图
-
-![image/流程图](image/流程图.png)
-
-## 人脸通行管理
-
-![image/通行证管理列表](image/通行证管理列表.png)
-
-表字段说明
-
-| 字段说明 | 类型       | 备注                    | 是否必填 |
-| ---- | -------- | --------------------- | ---- |
-| 小区   | string   |                       | 是    |
-| 房号   | string   |                       | 是    |
-| 门禁名称 | string   |                       | 是    |
-| 人脸照片 | string   |                       | 是    |
-| 姓名   | string   |                       | 是    |
-| 手机号  | string   |                       | 是    |
-| 类型   | emun     | 本人、家属、亲戚、朋友、员工        | 是    |
-| 审核状态 | emun     | 待审核、审核中、审核通过、被拒绝、禁止通行 | 是    |
-| 添加时间 | datetime |                       | 是    |
-
-## 人脸审核记录
-
-![image/审核记录](image/审核记录.png)
-
-## 审核员工管理
-
-![image/审核员工列表](image/审核员工管理列表.png)
-表字段说明
-
-| 字段说明 | 类型       | 备注           | 是否必填 |
-| ---- | -------- | ------------ | ---- |
-| 小区   | string   |              | 是    |
-| 账户   | string   |              | 否    |
-| 所属公司 | string   |              | 是    |
-| 姓名   | string   | 根据所属公司自动筛选员工 | 是    |
-| 审核状态 | emun     | 允许、禁止        | 是    |
-| 添加时间 | datetime |              | 是    |