1、业务综述
功能简介
校外人员进出校也称访客管理,该应用提供对外来人员进校实行申请、审批和备案管理流程,校外人员需进出校时,由校内归口单位教职工或本人发起审批流程,经部门负责人审核,保卫处备案后系统会给访客推送一个入校二维码,访客可凭电子二维码进出校园。
对校外人员进校、出校实行"一人一码",凭二维码出入校门,进出校由门卫对二维码的有效性进行验证,并保留进出校记录,系统中可查询访客进出校台帐。
模块简介
菜单名称 |
用户角色 |
支持终端 |
功能说明 |
基础信息 |
应用管理员 |
PC |
应用管理员配置系统运行基本参数和数据字典。 |
入校申请 |
教职工 |
PC、移动 |
教职工填写校外人员信息、入校信息提交单位和保卫处审核。 |
入校审核 |
单位管理员、保卫处 |
PC、移动 |
审核校外人员入校申请;审核通过后向校外人员发送入校电子凭证。 |
校外人员进出校 |
校外人员 |
移动 |
校外人员出示进出校二维码。 |
进出校核验 |
保卫人员 |
移动 |
扫描校外人员进出校二维码,核验进出校信息。 |
校外人员管理 |
应用管理员 |
PC |
管理员管理和查询校外人员,可取消校外人员进校凭证 |
进出校查询 |
应用管理员 |
PC |
管理员查询校外人员进出校记录。 |
校外人员统计 |
应用管理员 |
移动 |
可统计校外人员申请人数、申请车辆、进校人数、出校人数和异常人数等 |
访客登录 |
访客 |
移动 |
访客可自行提交入校申请,同时也可以查看审批记录,最终审批通过后会以短信的形式将二维码发送给访客。 |
2、业务表数据说明
T_OFFCAMPUS_PERSON_SYSTEM (系统配置表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(32) |
√ |
|
|
FXEWMYXQ |
分享二维码有效期 |
VARCHAR(32) |
|
√ |
|
SQSM |
申请说明 |
VARCHAR(3000) |
|
√ |
|
SQSMYDSJ |
申请说明阅读时间 |
VARCHAR(32) |
|
√ |
|
AQCNS |
安全承诺书 |
VARCHAR(3000) |
|
√ |
|
T_OFFCAMPUS_FLOW_PROMPT (提示信息表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(50) |
√ |
|
|
PROMPT_TITLE |
提示标题 |
VARCHAR(100) |
|
√ |
|
PROMPT_FLOW_NODE |
提示节点 |
VARCHAR(50) |
|
√ |
|
PROMPT_INFO |
提示内容 |
BLOB |
|
√ |
|
IS_USE |
是否使用 |
VARCHAR(10) |
|
√ |
|
T_OFFCAMPUS_PERSON_CHECKIN_DIC (字典表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(64) |
√ |
|
|
CODE |
代码 |
VARCHAR(32) |
|
√ |
|
NAME |
名称 |
VARCHAR(256) |
|
√ |
|
TYPE |
类别 |
VARCHAR(100) |
|
√ |
|
IS_USE |
是否使用 |
VARCHAR(32) |
|
√ |
|
SEQ |
排序 |
DOUBLE(19) |
|
|
|
T_OFFCAMPUS_PERSON_CHECKIN (申请信息表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(32) |
√ |
|
|
USER_ID |
学工号 |
VARCHAR(64) |
|
√ |
|
USER_NAME |
申请人 |
VARCHAR(64) |
|
√ |
|
DEPT_CODE |
单位代码 |
VARCHAR(64) |
|
√ |
|
DEPT_NAME |
单位 |
VARCHAR(128) |
|
√ |
|
PHONE_NUMBER |
联系方式 |
VARCHAR(64) |
|
√ |
|
PERSON_TYPE |
外来人员类别 |
VARCHAR(15) |
|
√ |
|
CAMPUS |
进出校区 |
VARCHAR(32) |
|
√ |
|
IN_SCHOOL_TIME |
预计进校时间 |
DATETIME(7) |
|
√ |
|
OFF_SCHOOL_TIME |
预计离校时间 |
DATETIME(7) |
|
√ |
|
REASON |
来校事由 |
VARCHAR(512) |
|
√ |
|
PERSON_NUMBER |
人数 |
VARCHAR(32) |
|
√ |
|
ATTACHMENTS |
附件 |
VARCHAR(50) |
|
√ |
|
CREATED_AT |
登记时间 |
DATETIME(7) |
|
√ |
|
CZR |
操作人 |
VARCHAR(32) |
|
√ |
|
CZZXM |
操作者姓名 |
VARCHAR(64) |
|
√ |
|
CZRQ |
操作日期 |
DATETIME(7) |
|
√ |
|
T_OFFCAMPUS_PERSON_INFO (校外人员信息表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(32) |
√ |
|
|
USER_ID |
学工号 |
VARCHAR(64) |
|
√ |
|
USER_NAME |
申请人 |
VARCHAR(64) |
|
√ |
|
GENDER_CODE |
性别 |
VARCHAR(32) |
|
√ |
|
PHONE_NUMBER |
手机号 |
VARCHAR(32) |
|
√ |
|
ID_TYPE |
联系方式 |
VARCHAR(64) |
|
√ |
|
ID_NO |
身份证件号 |
VARCHAR(64) |
|
√ |
|
HAS_CAR |
是否有车 |
VARCHAR(15) |
|
√ |
|
CAR_COLOR |
车辆颜色 |
VARCHAR(30) |
|
√ |
|
PLATE_NO |
车牌号 |
VARCHAR(32) |
|
√ |
|
CHECKIN_WID |
申请表WID |
VARCHAR(64) |
|
√ |
|
IS_PASS |
审核状态 |
VARCHAR(32) |
|
√ |
|
ABNORMAL_STATE |
异常状态 |
VARCHAR(10) |
|
√ |
|
REMARK |
备注 |
VARCHAR(3000) |
|
√ |
|
INTERVENE_TYPE |
干预方式 |
VARCHAR(20) |
|
√ |
|
CZR |
操作人 |
VARCHAR(64) |
|
√ |
|
CZSJ |
操作时间 |
VARCHAR(40) |
|
√ |
|
T_OFFCAMPUS_PERSON_MESSAGE (短信记录表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(32) |
√ |
|
|
PERSON_WID |
校外人员标识 |
VARCHAR(64) |
|
√ |
|
LONG_URL |
长链接 |
VARCHAR(150) |
|
√ |
|
SHORT_URL |
短链接 |
VARCHAR(150) |
|
√ |
|
TYPE |
类别 |
VARCHAR(50) |
|
√ |
|
RECEIVER_USER_ID |
短信接收人工号 |
VARCHAR(65) |
|
√ |
|
RECEIVER_PHONE |
短信接收人电话号码 |
VARCHAR(50) |
|
√ |
|
RECEIVER_NAME |
短信接收人姓名 |
VARCHAR(50) |
|
√ |
|
MESSAGE_CONTENT |
短信内容 |
VARCHAR(200) |
|
√ |
|
SEND_AT |
发送时间 |
VARCHAR(32) |
|
√ |
|
SHORT_URL_SUFFIX |
短链接后缀 |
VARCHAR(20) |
|
√ |
|
T_OFFCAMPUS_PERSON_QRREC (二维码表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(64) |
√ |
|
|
USER_ID |
学工号 |
VARCHAR(64) |
|
√ |
|
USER_NAME |
申请人 |
VARCHAR(64) |
|
√ |
|
DEPT_CODE |
单位代码 |
VARCHAR(64) |
|
√ |
|
DEPT_NAME |
单位 |
VARCHAR(128) |
|
√ |
|
PHONE_NUMBER |
手机号 |
VARCHAR(64) |
|
√ |
|
CZZ |
操作人 |
VARCHAR(64) |
|
√ |
|
CZZXM |
操作者姓名 |
VARCHAR(128) |
|
√ |
|
CZRQ |
操作日期 |
DATETIME(7) |
|
√ |
|
T_OFFCAMPUS_PERSON_RECORD (通行记录表)
字段名 |
中文名 |
类型 |
主键 |
可空 |
备注 |
WID |
主键 |
VARCHAR(64) |
√ |
|
|
PERSON_WID |
人员标识 |
VARCHAR(64) |
|
√ |
|
IN_SCHOOL_TIME |
入校时间 |
DATETIME(7) |
|
√ |
|
OFF_SCHOOL_TIME |
离校时间 |
DATETIME(7) |
|
√ |
|
TYPE |
类别 |
VARCHAR(32) |
|
√ |
|
CZZ |
操作人 |
VARCHAR(64) |
|
√ |
|
CZZXM |
操作者姓名 |
VARCHAR(64) |
|
√ |
|
CZRQ |
操作日期 |
DATETIME(7) |
|
√ |
|
3、配置说明
3.1、权限配置
功能权限 |
建议群组 |
基础信息 |
应用管理员 |
入校申请 |
教职工 |
入校审核 |
单位管理员、保卫处 |
校外人员进出校 |
校外人员 |
进出校核验 |
保卫人员 |
校外人员管理 |
应用管理员 |
进出校查询 |
应用管理员 |
校外人员统计 |
应用管理员 |
3.2、底座基础配置(重要)
1、emap.properties
1.1 配置文件,增加匿名配置:
# 自定义认证 auth.loginHelpers=header,special auth.special.authHelper=emapfunauth/speFunAuth
# 轻服务域名及文根 lwpub.context.url=http://xwfw.wisedu.com/qljfwapp
# 匿名配置 auth.ignores=/sys/emapcomponent/*/*/*,/sys/lwWiseduOffcampusPerCheckin/*default/guest.do,/sys/emapflow/tasks/queryFlowState.do,/sys/lwWiseduOffcampusPerCheckin/modules/guest/*,/sys/lwWiseduOffcampusPerCheckin/modules/guest.do,/sys/lwWiseduOffcampusPerCheckin/api/*,/sys/lwWiseduOffcampusPerCheckin/w/*,/sys/lwWiseduOffcampusPerCheckin/mob/*,/sys/lwpub/mobile/api/public/*
#微信公众号的配置,对应appId、appSecret lwpub.wechat.type=mp lwpub.wechat.corpid= lwpub.wechat.corpsecret= |
1.2 参数说明
参数名 |
可选值 |
参数说明 |
auth.loginHelpers |
header、special、debug、cas |
认证方法,这里需要配置为 |
auth.special.authHelper |
emapfunauth/speFunAuth |
自定义认证实现类 |
lwpub.context.url |
http://ehall.xx.edu.cn |
轻服务域名及文根 |
auth.ignores |
|
毋须认证的地址 |
lwpub.wechat.type |
mp、qy |
微信类型,mp=微信服务号,qy=微信企业号 注:通常qy是用于审批端,mp用于访客端 |
lwpub.wechat.corpid |
|
应用id、企业应用ID |
lwpub.wechat.corpsecret |
|
应用密钥 |
2、app.properties
2.1 配置文件
文件位置:lwWiseduOffcampusPerCheckin/classes/app.properties
# 短信验证码内容 message_content= \u0024\u007b\u006e\u0061\u006d\u0065\u007d\u0020\u60a8\u597d\u0021\u0020\u60a8\u7684\u5165\u6821\u7533\u8bf7\u5df2\u5ba1\u6838\u901a\u8fc7\uff0c\u8bf7\u70b9\u51fb\u94fe\u63a5\u83b7\u53d6\u51fa\u5165\u6821\u51ed\u8bc1\u3002\u0024\u007b\u0075\u0072\u006c\u007d lwWiseduOffcampusPerCheckin.dept.leader.groupid= url.referercheck.ignore=/sys/lwWiseduOffcampusPerCheckin/api/saveSetting.do antisamy.ignores=/sys/lwWiseduOffcampusPerCheckin/api/saveSetting.do validatePattern=(?:')|(?:--)|(/\\*(?:.|[\\n\\r])*?\\*/)|(\\b(select|update|union|and|or|delete|insert|trancate|char|into|substr|ascii|declare|exec|count|master|into|drop|execute|script|alert|img|src|link|href|div|span)\\b) guest.login.cookie.maxAge=3600 api.sign.timestampInterval=300
# 验证码发送方式 message.sendTypes=sms
# 校园一码通集成所需参数 lwWiseduOffcampusPerCheckin.Sm4= lwWiseduOffcampusPerCheckin.Sm2=
# 微信认证方式 guest.login.wx.oAuth.enable=0 |
2.2 参数说明
参数名 |
可选值 |
参数说明 |
message_content |
|
短信验证码消息模板,unicode格式,可在线编译后设置 |
lwWiseduOffcampusPerCheckin.dept.leader.groupid |
|
受访人领导审批组ID,一定是在授权中的用户组,基于所在部门寻找上级领导 |
antisamy.ignores |
/sys/lwWiseduOffcampusPerCheckin/api/saveSetting.do |
需要XSS漏洞检查的URL |
validatePattern |
|
XSS漏洞检查表达式,正则表达式 |
guest.login.cookie.maxAge |
3600 |
访客登录会话时长 单位:秒 |
api.sign.timestampInterval |
300 |
api接口请求的签名超时时间 用于第三方门禁集成在线鉴权所需参数 单位:毫秒 |
message.sendTypes |
sms |
发送验证码方式 sms-短信验证码 |
lwWiseduOffcampusPerCheckin.Sm4 |
|
IDS7中身份码所需配置密钥 |
lwWiseduOffcampusPerCheckin.Sm2 |
|
IDS7中身份码所需配置密钥 |
guest.login.wx.oAuth.enable |
1、2 |
访客认证方式,默认值0 0-手机号+短信验证码的形式; 1-微信公众号oauth登录方式 |
3、校区码报表配置
将lwWiseduOffcampusPerCheckin/web/cpt/lwWiseduOffcampusPerCheckin.cpt文件复制到/opt/wiseduAppGroups/qljfwapp/frReport2/WEB-INF/reportlets目录下,报表存放的路径可以自行指定,以底座frReport2/WEB-INF/resources/JZReportletConfig.xml配置为准。
可以参考下面命令。
cp /opt/wiseduAppGroups/qljfwapp/lwWiseduOffcampusPerCheckin/web/cpt/lwWiseduOffcampusPerCheckin.cpt /opt/wiseduAppGroups/qljfwapp/frReport2/WEB-INF/reportlets |
3.3、访客预约功能配置(重要)
1、访客预约入口
http://ehall.xxx.edu.cn/qljfwapp/sys/lwWiseduOffcampusPerCheckin/*default/guest.do |
2、匿名配置
因为访客预约是不需要过IDS、底座认证,所以需要修改qljfw_location、emap.properties文件,开放匿名功能。
需开放URL清单
/sys/lwWiseduOffcampusPerCheckin/mob/* /sys/lwWiseduOffcampusPerCheckin/api/* /sys/lwWiseduOffcampusPerCheckin/w/* /sys/lwWiseduOffcampusPerCheckin/modules/guest.do /sys/lwWiseduOffcampusPerCheckin/modules/guest/* /sys/lwWiseduOffcampusPerCheckin/*default/guest.do /sys/lwWiseduOffcampusPerCheckin/*default/mobile/* /sys/lwpub/mobile/api /sys/lwpub/public/mob /sys/emapflow/* /sys/emapcomponent/* /code/* 新增地址(xmq.20231103) /qljfwapp/sys/lwWiseduOffcampusPerCheckin/wxLogin/getAppId.do
/qljfwapp/sys/lwWiseduOffcampusPerCheckin/wxLogin/getOpenId.do
/qljfwapp/sys/lwWiseduOffcampusPerCheckin/wxLogin/callback.do |
emap.properties 展开源码
注意检查nginx配置,有些匿名url可能已经开启过了
qljfw_location.conf 展开源码
3、审核通后短信相关配置
路径:lwWiseduOffcampusPerCheckin/classes/app.properties
注:下面的 参数message_content是审核通过后向申请人发送预约成功的短信模板。
# 验证码发送方式 message.sendTypes=sms # 短信验证码内容 message_content= \u0024\u007b\u006e\u0061\u006d\u0065\u007d\u0020\u60a8\u597d\u0021\u0020\u60a8\u7684\u5165\u6821\u7533\u8bf7\u5df2\u5ba1\u6838\u901a\u8fc7\uff0c\u8bf7\u70b9\u51fb\u94fe\u63a5\u83b7\u53d6\u51fa\u5165\u6821\u51ed\u8bc1\u3002\u0024\u007b\u0075\u0072\u006c\u007d |
4、访客登录页logo修改
文件地址:/qljfwapp/lwWiseduOffcampusPerCheckin/web/public/images/loginGuestLogo.png
5、微信服务号oauth集成
-
root/emap.properties
lwpub.wechat.type=mp #微信公众号的配置,对应appId lwpub.wechat.corpid= #微信公众号的配置,对应secret lwpub.wechat.corpsecret= |
-
lwWiseduOffcampusPerCheckin/classes/app.properties
访客微信扫描二维码后是否开启oauth认证,默认0不开启 guest.login.wx.oAuth.enable=1
注:配置0默认的手机号+短信验证码的形式;1为微信公众号集成登录方式。 |
3.4、门禁集成方案
1、宇视道闸
(1)、修改数据库
T_OFFCAMPUS_PERSON_SYSTEM里的QTMJCS的值改为1
(2)、修改配置文件app.properties
具体配置文件在classes/app.properties
|
3.5、一码通集成
校外人员进出校是支持与一码通行集成使用的,但在使用前需要先做系统集成才可使用。
1、配置身份二维码基本信息
针对访客,配置好访客通行口令,不同闸机的口令不同,此口令可用于“策略服务器”时,下发通行指令。
路径:系统配置->认证服务配置->身份二维码配置
2、从minos中获取集成参数
2.1 获取appId、appSecret
路径:应用管理->轻量级服务->详情
2.2 获取网关路径
学校部署网关的域名,格式:协议[http、https] + 域名
http/https://gataway.xxx.edu.cn
3、应用中配置
3.1、对应身份二维码的口令
不同校区的事项权限代码、口令应该不一致,所以需要在访客系统中关联上通行指令。
路径:访客系统->基础信息管理->校区信息设置。
3.2 配置集成参数
启用“校园身份码”,将API地址、appId、appSecret填入表单中。
3.6、使用手册
3.6.1、校外人员基础配置
基础信息配置–基础配置功能
可配置校外人员申请须知、发送短信验证码发送模板等。
3.6.2、访客申请入口
5.1.2版本中新增了访客可以自行发起入校申请的功能,若客户希望将这个地址开放到公众号时,可以提供此地址。
入校申请:http://域名/qljfwapp/sys/lwWiseduOffcampusPerCheckin/*default/guest.do
3.6.3、外来人员类别
适用角色
应用管理员
支持终端
PC
功能描述
提供外来人员类别的管理,管理员可根据学校相关管理规定对外来人员进行分类管理。
3.6.4、校区信息
适用角色
应用管理员
支持终端
PC
功能描述
提供校区信息的管理,管理员需根据学校实际情况维护学校校区信息,同时会为校区生成固定二维码,管理可以下载后打印,也可以批量打印此二维码用于贴在校区的出入口,访客可通过今日校园、微信等扫码后查询自己的通行信息。
图:校区管理列表页
图:出入校二维码下载页
图:新增表单页
图:批量打印出入校二维码
3.6.5、干预方式
适用角色
应用管理员
支持终端
PC
功能描述
校外人员入校后,如未按照规定时间出校或未按规定进行离校登记,系统就认为该外来人员为异常人员,管理员或保卫处需要对这类异常进行处理并标记处理方式。干预方式维护功能提供异常人员的处理方式。
3.6.6、外来人员入校申请
适用角色
教职工
支持终端
PC、移动端
功能描述
校外人员需进出校时,由校内归口单位教职工通过该功能进行线上提交申请,同时可以将下载二维码或截图分享给访客,有访客识别后自行申请入校。
-
申请:填写校外人员基本信息,提交单位和保卫处审核。
-
编辑:申请若被撤回、草稿、驳回时,用户可重新编辑申请内容并重新提交。
-
删除:申请若被撤回、草稿、驳回时,用户可直接删除数据。
-
撤回:当第一个审批人还未进行审批时,申请人可撤销申请,可重新编辑申请内容后再次提交。
-
查询校外人员:查询本人已经提交进出校的校外人员信息。
3.6.7、外来人员入校审核
适用角色
部门负责人、保卫处
支持终端
PC、移动端
功能描述
系统将获取到当前登录用户所需要办理和已办理的申请记录,办理人可对需要审核的数据进行审核操作;
-
通过:若审批人认为情况属实,即可同意进入下一步。
-
退回:将申请记录驳回至申请人;
-
不通过:将终止流程,申请人将无法再次编辑发起申请。
3.6.8、校外人员入校申请
适用角色
校外人员
支持终端
移动
功能描述
管理员可以将访客入校申请的链接挂在公众号、门户等便于查看的地方,也可以通过校内人员将申请链接以二维码的形式分享给访客,方便访客能自行申请入校信息,待相关人员审批通过后,系统会以短信的形式将出入校电子通行证推送给访客;访客也可再次登入系统查看入校申请的审批情况,若审批通过后可直接打开出入校通行证。
图:访客信息登录
图:访客入校登记页
图:出入校电子够通行证
3.6.9、校外人员扫码入校
适用角色
校外人员
支持终端
移动
功能描述
校外人员出入校时可通过今日校园、微信等客户端扫描出入校的固定二维码,系统识别通过后会给出通行的指示,并用于给保卫人员核验,系统上将显示当前用户离校的倒计时及相关重要信息,避免用户伪造,方便保卫人员能快速侦别通行的权限。
图:出入校扫码查询通行权限
图:允许通行 图:不允许通行
3.6.10、校外人员入校通行证
适用角色
校外人员
支持终端
移动
功能描述
校外人员出入校申请审批通过后,系统会通过短信向校外人员发送进校凭证,校外人员凭进校凭证入校。
3.6.11、保卫人员核验
适用角色
保卫人员
支持终端
移动
功能描述
校外人员进出校时向保卫人员出示本人进出校二维码由保卫人员核验并记录进出校时间。
3.6.12、外来人员信息查询
适用角色
保卫处
支持终端
PC、移动端
功能描述
校外人员进出校审核通过后,通过该功能可查询所有已经申请的校外人员基本信息和审核情况。
-
取消预约:保卫处可取消该校外人员的入校申请,取消后校外人员无法打开入校凭证。
-
发送预约短信:校外人员进出校审批通过系统向校外人员发送入校凭证短信,如遇到特殊情况校外人员没有接收短信或短信丢失时,可通过该功能重复向校外人员发送短信。
-
干预:校外人员入校后,如未按照规定时间出校或未按规定进行离校登记,系统就认为该外来人员为异常人员,管理员或保卫处通过该功能对这类异常进行处理并标记处理方式。
3.6.13、校外人员进出校查询
适用角色
保卫处
支持终端
PC
功能描述
保卫处可查询到校外人员的进出校记录。
3.6.14、校外人员统计
适用角色
保卫处
支持终端
PC
功能描述
保卫处可查询到校外人员的数据统计结果。可统计校外人员申请人数、申请车辆、进校人数、出校人数和异常人数等。