宇泛 Uface 门禁管理项目

宇泛 Uface 门禁管理项目方案书

杭州宇泛智能科技有限公司 1 / 19

宇泛 Uface 门禁管理项目

方案书

文件状态：[ ] 草稿

[√] 正式发布

[ ] 正在修改

当前版本： 1.0 模板版本 1.0

作者：宇泛智能

完成日期： 2017年 05月 031日



版本控制

日期版本修订章节修订原因修订者

2017-05-31 1.0 发布宇泛智能



目录

1. 文档说明 ........................................................................................................................... 4

1.1. 编写目的 ........................................................................................................................... 4

1.2. 系统概述 ........................................................................................................................... 4

1.3. 术语与缩写解释 ............................................................................................................... 4

2. UFACE门禁系统优点........................................................................................................ 6

3. 门禁系统整体介绍 ........................................................................................................... 8

3.1. 门禁系统服务接口 ........................................................................................................... 8

3.1.1. 接口设计 ....................................................................................................................... 8

3.1.2. 系统架构图 ................................................................................................................. 10

3.1.3. 系统总体模块图 ......................................................................................................... 10

3.1.4. 模块总体介绍 ............................................................................................................. 11

3.2. 门禁系统网站 ................................................................................................................. 13

3.3. 身份识别设备 ................................................................................................................. 15

4. 部署视图 ......................................................................................................................... 18

4.1. 运行环境 ......................................................................................................................... 18

4.2. 部署图 ............................................................................................................................. 19



1. 文档说明

1.1. 编写目的

本文档是《宇泛 Uface 门禁管理项目方案书》，主要对系统的核心流程、功能划分、模

块划分、程序的总体结构、输入输出和接口设计、运行设计等方面作全面概括性的说明，为

该软件的详细设计奠定基础。

1.2. 系统概述

宇泛 Uface 门禁管理项目（以下简称“门禁系统”）针对门禁的用户进行人脸识别门禁

统一管理，人员管理（录入、更新、删除、查询等）、照片管理（照片注册、照片下发）、授

权管理（授权、销权）、识别记录管理（保存、查询、统计、报表、回调上传）等功能。

1.3. 术语与缩写解释

表 1. 术语表

缩写、术语解释

宇泛 Uface门禁

管理项目

门禁系统

HTTP HTTP 是一个客户端和服务器端请求和应答的标准（TCP）。客户端是终端用户，

服务器端是网站。通过使用 Web 浏览器、网络爬虫或者其它的工具，客户端发

起一个到服务器上指定端口（默认端口为 80）的 HTTP请求。

B/S 即 Browser/Server（浏览器/服务器）结构，是随着互联网 Web2.0 技术的兴起，

对 C/S 结构的一种变化或者改进的结构。在这种结构下，用户界面完全通过浏

览器呈现，前端实现简单的业务参数校验和接口请求，主要的功能业务逻辑在

服务器端实现。B/S 结构充分利用前端 JavaScript 技术，让普通浏览器提供了

客户所需的强大功能，极大节约了开发成本，也优化了用户体验。

C/S 即 Client/Server(客户机/服务器)结构，是大家熟知的软件系统体系结构，通

过将任务合理分配到客户端和服务端，降低了系统的通讯开销，可以充分利用

两端硬件环境的优势。在这种体系架构下，客户端即使不能连接网络，也能完

成相当大一部分的业务逻辑。

MySQL MySQL 是目前最流行的关系型数据库管理系统之一，在 WEB 应用方面，MySQL

是最好的 RDBMS (Relational Database Management System，关系数据库管理

系统) 应用软件。MySQL 所使用的 SQL 语言是用于访问数据库的最常用标准化

语言。



Redis Redis 是一个开源的使用 ANSI C 语言编写、支持网络、可基于内存亦可持久化

的日志型、Key-Value 数据库，通常用于高并发请求的缓存

MQ 消息队列（MQ）是一种应用程序对应用程序的通信方法。应用程序通过写和检

索出入列队的针对应用程序的数据（消息）来通信，而无需专用连接来链接它

们。消息传递指的是程序之间通过在消息中发送数据进行通信，而不是通过直

接调用彼此来通信，直接调用通常是用于诸如远程过程调用的技术。排队指的

是应用程序通过队列来通信。队列的使用除去了接收和发送应用程序同时执行

的要求。通常用于缓冲峰值时期的请求。



2. Uface 门禁系统优点

宇泛 Uface 系统使用业内领先的人脸识别算法，目前达到弱配合（未来达到无配合）的

人脸识别体验，可应用于门禁、小区、学校、商超等场景的考勤、门禁、签到等诸多领域。

服务端采用微服务+容器的架构体系，解耦了核心业务和应用业务，使得业务接口和应

用功能能够方便地独立更新升级，且接口与应用可以相互独立地执行分布式的部署，在性能

不满足要求时可快速执行扩容部署，提升整体性能。且微服务架构对于服务间通信、熔断等

都有强大支持，Docker 容器化部署更精简了系统的部署步骤和难度，易于运维。

门禁系统的优势主要有如下优点：

表 2. Uface 系统优势表

算法采用世界领先的人脸检测、跟踪、识别算法

支持活体检测技术

识别速度快，误识率低

基于深度学习理论，自学习让识别效果越来越好

设备硬件 200 万像素摄像头

光敏传感器

雷达

补光灯

适应多种光线环境

外观时尚酷炫，提升形象

服务接口提供丰富的服务接口

适应多种业务需求

可对行为数据进行大数据分析

深度挖掘客户需求，进一步提升用户体验

网站 UI 设计精美、交互优良，远超传统门禁产品

扩展设备应用扩展

支持设备固件自升级，持续享受新功能和新算法

后续可增加移动端管理平台支持

业务扩展

门禁



访客预约

店内客人年龄、性别等属性分析

陌生人预警

贵宾服务



3. 门禁系统整体介绍

门禁系统包括系统服务接口（HTTP）、门禁网站系统（B/S）、身份识别设备，系统组成

图如下所示：

图 1. 门禁系统组成

3.1. 门禁系统服务接口

门禁系统服务接口提供业务功能所需的 HTTP 接口供客户端（门禁系统网站、门禁 DMS

系统等）调用，此外可选择性依赖短信、邮箱等服务作为辅助，提升用户体验。

3.1.1. 接口设计

1. 身份识别设备管理类：

➢ 设备录入接口

➢ 设备信息变更接口

➢ 设备状态查询接口

➢ 设备配置更新接口

➢ 设备远程操控（重置、升级）接口

2. 人员/照片管理类：

➢ 人员信息录入接口



➢ 人员信息变更接口

➢ 人员信息查询接口

➢ 人员删除接口

➢ 人员照片注册接口

➢ 人员照片删除接口

3. 授权管理类：

➢ 设备授权人员识别接口

➢ 设备授权批量人员识别接口

➢ 设备销权人员识别接口

➢ 设备销权批量人员识别接口

4. 识别管理类：

➢ 识别记录保存接口

➢ 识别记录查询接口

➢ 识别记录统计接口

➢ 识别记录报表导出接口



3.1.2. 系统架构图

图 2. 门禁系统服务接口体系架构图

接口服务层：提供设备管理类、人员/照片管理类、授权管理类、识别管理类等接口。

业务逻辑层：实现参数验证、数据转换、业务跳转、服务调用。

数据访问层：封装数据访问方式 MyBatis、Hibernate 等 ORM框架。

数据存储层：数据存储方式包括四个，即关系型数据库（使用 MySQL）、内存数据库（使

用 Redis）、数据队列（MQ）和磁盘，其中关系型数据库存储设备、识别数据等信息，内存

数据库存储设备状态以作缓存，MQ 利于请求峰值期间的平缓处理和稳定，磁盘存储配置文

件、图片等。

3.1.3. 系统总体模块图

描述系统的模块划分情况及模块层次结构，给出总体功能图。



图 3. 门禁系统服务接口模块功能图

门禁系统主要分为设备管理模块、人员/照片管理模块、授权管理模块、识别管理模块。

设备管理模块：即对身份识别设备进行管理，门禁所使用的设备需录入系统方可使用

和控制，录入需使用设备序列号，是根据由 IEEE 备案的厂商 ID（我司为 84E0F42）申请的

设备基准码计算设备唯一序列号。设备的识别显示、语音播报、串口输出，以及允许识别距

离等参数都可配置，设备的联网状态可通过接口查询展示。

人员/照片管理模块：即对需进行身份识别的用户进行管理，人员数据由门禁系统网站

录入，支持读取身份证录入信息，支持使用身份证中的照片或者其他照片完成照片注册，同

时设备本身具备人脸注册功能，在设备前独立完成人脸注册。

授权管理模块：即对设备和人员的权限进行管理。一个人可在多台设备上完成身份识

别，通过授权和销权实现人员及照片在设备上的下发和回收。

识别管理模块：即对识别记录的存储、统计和导出等进行管理。识别记录上传后，将

保存在库中，供用户随时查看和导出，同时支持外部接口对接，将识别记录上传到指定的接

口。

3.1.4. 模块总体介绍

表 3. 门禁系统服务接口模块介绍表

设备管理模块 A

子模块编号子模块名称简述

A1 设备录入客户端通过提交设备序列号及设备个性化名称，接口将完成设

备的录入。



A2 设备变更接口只提供变更设备名称的功能，对于设备序列号，不支持更

新，如果需更新，需删除无效设备，重新录入。

A3 设备状态查询接口提供设备在线/离线状态的查询接口，在部分操作的时候可

能涉及到设备是否在线的状态。

A4 设备配置更新接口提供显示模式、语音播报模式、串口输出模式的配置定制

功能，用户根据个性化需求完成设置。

A5 设备远程操控设备本身具备升级的功能，在算法升级、功能丰富等情况下，

用户可以控制系统升级，提升体验。

人员/照片管理模块 B


B1 人员信息录入接口提供人员信息录入的功能，人员参数可手动填写，也可通

过身份证读卡器完成录入。

B2 人员信息更新在输入错误或者信息变更时，可修改人员信息。

B3 人员信息查询可查询具体某人的人员信息。

B4 人员删除当该人员搬离门禁时，可删除该人员，取消其授权。

B5 人员照片注册服务接口提供人员的照片注册功能，支持注册多张照片。注册

方式包括：身份证读取的照片注册，普通生活照，以及在设备

前自助注册。

B6 人员照片查询网站上可查询具体人员的注册照片，以供审核。

B7 人员照片删除网站上浏览人员照片，如果该照片不符合规范，可删除，重新

注册。

授权模块 C


C1 设备授权人员将某人授权到某设备上，允许其在此设备上刷脸和刷身份证识

别。

C2 设备授权批量人员将某些人授权到某设备上，允许这些人在此设备上刷脸和刷身

份证识别开门。

C3 设备销权人员将某人从某设备上注销权限，不再允许其在此设备上刷脸和刷

身份证识别。



C4 设备销权批量人员将某些人从某设备上注销权限，不再允许这些人在此设备上刷

脸。

识别管理模块 D


D1 识别记录保存人员在识别设备完成人脸或身份证识别后，通过调用接口完成

识别记录的保存。

D2 识别记录查询查询某时段内某人员的识别记录。

D3 识别记录统计按照设备码、时间段等条件查询人员的识别汇总数据和明细。

D4 识别记录报表导出按照设备码、时间段等条件导出人员的识别汇总数据和明细报

表供查阅审核。

D5 识别记录上传对于有特殊上传需求的用户，支持识别记录的回调上传，将识

别记录上传至指定的服务器。

3.2. 门禁系统网站

门禁系统网站提供给门禁管理员使用，用户可使用浏览器访问网站使用相关功能。网站

系统通过调用门禁系统服务接口完成所需功能，主要包括以下功能（部分功能提供实例截图）：

1. 门禁管理员登录

图 4. 门禁系统网站登录



2. 门禁管理员密码重置/找回

图 5. 门禁系统网站密码找回

3. 设备管理

图 6. 门禁系统网站设备录入和管理

4. 人员管理（查询、模糊搜索等）



图 7. 门禁系统网站人员管理

5. 人员、照片录入

图 8. 门禁系统网站人员照片注册

6. 授权与销权

7. 识别记录详情查询

8. 时段内识别明细查询

9. 时段内识别报表导出和下载

3.3. 身份识别设备

身份识别设备具备人员信息（由门禁系统中数据同步下发）接收及人员照片注册功能。

设备可支持 3000以下人脸库，内置高性能、高稳定的人脸识别算法，完成人员的人脸识别。

在全球最具权威的人脸检测评测平台 FDDB 2015年公布的最新数据中，杭州宇泛智能科技有

限公司(Uni-Ubi)在人脸检测的连续性（Continuous）评分排名世界第三，超过国内腾讯优

图（Tencent-BestImage）及国内专业人脸识别云服务提供商 Face++。

识别记录在设备联网情况下实时上传到服务器，供网站查询和统计，同时上传到第三方

服务器，且可永久保存，无需覆盖，若设备未联网，则每隔一段时间（如 1分钟）将检查网

络状态，当设备联网时可补推至服务器。



设备无密码识别功能。设备拥有唯一的设备序列号，联网后自动配置 IP。

设备界面新颖酷炫，优越于传统门禁设备，且能显示联网状态，时间同步服务器时间，

不可手动调整。设备支持固件升级。

设备套件包括：硬件设备、电源设配器、底座和支架（此两者和产品安装有关，可根据

现场实际情况进行调整）；

硬件设备技术规格：

基本参数

处理器 4核@1.8G

内存 2GB DDR3 @528M

闪存 16GB eMMC

操作系统 Android 5.1

摄像头 200W像素，1/3英寸图像传感器，6mm 焦距，F2.4光圈

电源输入 DC12V±10%

产品尺寸

外形尺寸 21.2cm*21.2cm（对角线长度）

厚度 23.8mm（最薄），40.8mm（最厚）

重量 338g

底座尺寸 61.3mm（最高处）

多媒体

屏幕特性 IPS 170°视角

屏幕大小 5英寸

屏幕分辨率 480*854

音频输入麦克风 1个

音频输出 2W扬声器 1个

接口

电源 DC12V 5.5mm接口 1个

网络 10M/100M自适应以太网 RJ45接口 1个

显示 HDMI2.0 Type-A接口 1个

扩展 RS232 接线端子 1个



产品硬件特色：

➢ 光敏传感器和雷达配合，当光照条件恶劣且前方有人移动时，设备下方的 20 颗正

白补光灯柔光会点亮，对人脸区域补光；

➢ 巧妙的外观设计，可支持壁挂式和桌面式两种安装方式。

➢ 硬件预留 HDMI 及门禁控制器接口，可外接大屏幕和门禁适用不同场合。



4. 部署视图

4.1. 运行环境

表 4. 运行环境表

服务接口端

操作系统 Linux 64 位，8 核 CPU，32G 内存，500G

硬盘，10M 外网宽带

语言包/工具集 JDK8

数据库（独立服务器

或云端数据库） MySQL5.6、Redis

中间件 MQ

网站端

操作系统 Linux/Windows 64 位，8 核 CPU，32G

内存，500G 硬盘，10M 外网宽带

语言包/工具集 JDK8

客户端

浏览器 IE、Firefox、Opera、Google Chrome

等主流浏览器

身份识别设备 Uface 人脸识别设备，采用 4 核@1.8G

处理器，搭载安卓 5.1 系统。



4.2. 部署图

门禁系统接口服务器数据库

门禁系统网站服务器

识别设备识别设备识别设备

客户端

客户端

客户端

客户端

客户端

客户端

HTTP请求 HTTP请求

数据库驱动

HTTP请求

HTTP请求消息

门禁系统接口服务器数据库

门禁系统网站服务器

识别设备识别设备识别设备

客户端

客户端

客户端

HTTP请求 HTTP请求

数据库驱动

HTTP请求

HTTP请求消息

公寓管理DMS

消息、邮件等系统

图 9. 门禁系统部署图

Documents

宇泛 Uface 门禁管理项目