From 8a77d88f53d9c0cf40eed9300aae92bc031bfb3e Mon Sep 17 00:00:00 2001
From: pans <pans@454eff88-639b-444f-9e54-f578c98de674>
Date: 星期五, 10 二月 2017 17:19:41 +0800
Subject: [PATCH]
---
VisitFace/document/接口需求描述.txt | 121 ++++++++++++++++++++++++++++++++++++++++
VisitFace/document/人脸识别及考勤系统.docx | 0
2 files changed, 121 insertions(+), 0 deletions(-)
diff --git "a/VisitFace/document/\344\272\272\350\204\270\350\257\206\345\210\253\345\217\212\350\200\203\345\213\244\347\263\273\347\273\237.docx" "b/VisitFace/document/\344\272\272\350\204\270\350\257\206\345\210\253\345\217\212\350\200\203\345\213\244\347\263\273\347\273\237.docx"
index 1ba60b3..6844d4a 100644
--- "a/VisitFace/document/\344\272\272\350\204\270\350\257\206\345\210\253\345\217\212\350\200\203\345\213\244\347\263\273\347\273\237.docx"
+++ "b/VisitFace/document/\344\272\272\350\204\270\350\257\206\345\210\253\345\217\212\350\200\203\345\213\244\347\263\273\347\273\237.docx"
Binary files differ
diff --git "a/VisitFace/document/\346\216\245\345\217\243\351\234\200\346\261\202\346\217\217\350\277\260.txt" "b/VisitFace/document/\346\216\245\345\217\243\351\234\200\346\261\202\346\217\217\350\277\260.txt"
new file mode 100644
index 0000000..4d2e594
--- /dev/null
+++ "b/VisitFace/document/\346\216\245\345\217\243\351\234\200\346\261\202\346\217\217\350\277\260.txt"
@@ -0,0 +1,121 @@
+接口需求描述
+1.实时监控
+1.1.人员分类分类列表(VisitorType)
+访客
+员工
+1.2.ImageTypeID
+人脸照片
+证件照片
+1.2.StatusID
+状态
+1.3.人脸识别
+#todo 考虑封装一个整体api
+通过图像获得faceID
+
+1.4.人脸总体信息查询
+通过faceID获得Person简要信息
+需要支持批量查询
+
+1.5.访客注册（见2 人员注册）
+2.3注册人员
+1.6.更改人员考勤状态（签到、签退）
+需要支持批量查询
+查询员工的签到情况，并修改签到状态
+
+1.6.1. 人脸识别及状态修改
+整合：通过人脸图像，完成状态修改，返回当前状态
+（整合1.3. 1.4. 1.6.）
+Request:
+{
+ placeID : 123, // 若为-1则只搜索VisitFaceDB
+ imgs : [ "image base64" ] // 对应多个人的人脸图像
+}
+Response:
+[
+ {
+ personID : 123,
+ visitStatusID : 1 // 更新之后的访问状态
+ },
+ {
+ faceID : -1, // 人脸搜索无结果
+ },
+ {
+ //业务错误： 9.1. 通用成功/错误结果
+ }
+]
+1.7.查询人员来访/签离状态
+需要支持批量查询
+查询访客是否 在访问流程中；若不在，则提醒进行来访登记，否则认为已签离。
+1.8.更改人员来访状态（来访登记）
+见3 添加来访记录
+
+2.人员注册
+2.1.国籍列表
+获取国籍列表key-value
+2.2.证件类型
+获取证件类型列表key-value
+2.3.注册人员
+根据业务资料注册，先进行人员查重，若存在身份为员工的相同记录，则只增加对应关系。
+若无相同记录，则新增业务记录及对应关系。
+
+2.4.注册人脸
+发送图片给人脸识别服务。返回注册在人脸数据库的人脸id
+3.来访登记
+左侧“来访人员”列表，显示最近一周该学校的来访者，默认以姓名升序排序，分页查询。
+左侧“访问人员”列表，显示该学校的员工，默认以姓名升序排序，分页查询。
+右侧“来访被访”，当由”实时监控“界面中某人的来访登记，跳转到本页面，默认填充该用户的资料。
+当手动新增时。默认都为空，点击某来访者时，填充该来访者资料。点击被访者，填充被访者资料。
+3.1.获得来访人员列表
+显示最近一周该学校的来访者，默认以姓名升序排序，分页查询。数据主要来源Person及Visit
+3.2.获得被访人员列表
+显示该学校的员工，默认以姓名升序排序，分页查询。
+可选择以部门排序。
+3.3.搜索
+(3.4.5.6.)
+传入参数不同返回结果不同。
+3.3.1 搜索用户
+ 以姓名模糊搜索，
+ ①搜索访客(范围:最近七天访问过该学校的访客)
+ ②搜索员工(范围:该学校的员工)
+ ③搜索考勤员工(范围:该学校最近七天进行过考勤的员工)
+#todo 被访考虑和人员列表合并
+#todo 来访人员，如果没有给出搜索字段时，显示本校曾经来访人员列表VisitStat；如果给出关键字，则搜索全部人员
+被访人员，员工列表
+
+3.3.获得来访/被访人员详细信息（visitor/visitee）
+来访者的部分信息，数据主要来源Person、Company
+被访者的部分信息，数据主要来源Person、Department、Post
+3.4.添加来访记录
+相关数据表 person、Visit、VisitMatter
+(若添加的“拜访事由”为新建的，则先将“拜访事由”添加到VisitMatter)
+3.5.获得拜访事由选项列表
+拜访事由可修改，可增加。(拜访事由，区分公共和学校私有)相关数据表 Company、VisitMatter
+4.电话呼叫
+4.1.获得人员列表（同被访人员列表）
+同3.2
+4.2.添加呼叫记录
+保存呼叫记录
+5.访客管理
+5.1.获得来访列表
+同3.1
+5.2.访客信息
+获取访客的全部信息
+5.2.获得来访详细信息
+来访信息
+6.考勤记录
+6.1.获得考勤列表
+根据日期、personID聚类
+
+6.1.1获得考勤详细信息
+#返回人员详细信息API
+考勤记录
+
+6.2. 返回人员详细信息API
+见 3.3.获得来访/被访人员详细信息
+7.配置
+
+8.其他实体操作
+
+9.总体接口
+9.1.通用成功/错误结果
+
--
Gitblit v1.8.0