1. 立项原因（解决什么产品问题）
传统门禁依赖刷卡/钥匙，存在卡片易丢失、代刷、人卡不一致、无法防疫情期无接触通行等问题；市面单机版人脸门禁设备又是"数据孤岛"——设备品牌杂（闸机、门禁、通道机、可视门铃）、数据不回传、黑名单不能实时下发。
本项目要解决的正是：人脸识别终端的云化管理 ——一套"云—管—端"体系，把分散的门禁/闸机/人脸终端统一接入平台，实现人员/黑名单/通行规则云端统一管理、实时下发，通行记录/告警实时上报汇聚。
2. 行业场景与业务背景
智慧园区/智慧社区/智慧工地的人脸考勤与门禁通行：员工、访客、黑名单人员管理。
典型链路：管理后台录入人员（Excel 批量导入/照片采集）→ 平台按组织/通道路由下发到终端设备 → 终端本地人脸比对（离线可用）→ 通行记录、黑名单命中、陌生人告警经 MQTT 网关上云 → 大屏/报表展示、异常告警。
配套场景：微信小程序访客预约（wx-visitororder）、钉钉集成（wisdom-park-ding）、广告/通知公告下发到门禁屏（advertisement、banner-manage）、身份证读卡（ZK 身份证 SDK）用于工地实名。
主要功能描述
人员中心：员工/访客档案、人脸底图采集与质量检测、按组织维护（person 模块 + /wx/visitor），支持 zip/Excel 批量导入及导入结果回查（/importZip、/batchImport、/getImportStatus 等路由）。
黑名单管理：增删黑名单并强制下发全终端（版本号为 0 时强制同步，保证黑名单实时到达）。
通行规则（traffic-rules）：设备×人员×时段×验证方式的通行策略（DeviceAccessRule / DeviceAccessRulePerson / VerificationMode），下发到设备生效。
设备管理：设备注册、在线状态/心跳检测、远程开门、远程配置下发（mqtt_issue_config）、操作留痕（DeviceOperationRecord）。
通行记录与告警：终端上报通行流水（含抓拍图，存 SeaweedFS）、黑名单命中/陌生人/设备异常告警（DeviceAlarmMessage）集中展示与处理。
数据看板 + 多租户 + 系统管理：ECharts 统计大屏、租户/角色/权限（auth/usercenter）。
1. 负责的具体任务
项目整体框架及各模块配置
核心通行模块开发
基础及公共模块开发
2. 技术栈与架构
架构：**云(Maven 多模块 Spring Cloud 微服务)-管(C++ MQTT 接入网关+Kafka)-端(Android 人脸终端/小程序/Vue 后台)**四层分布式；后端服务经 Seata 之外的常用组件齐全：Nacos(注册+配置中心)、Sentinel(限流熔断)、gateway、OpenFeign(服务间调用)、Redis、MySQL + MyBatis-Plus、SeaweedFS(图片对象存储)、Swagger、JWT+Kaptcha。
设备协议 protobuf/gRPC：ImiMultiwayMQTTService 定义 mqtt_add/delete/update_person、add/update/delete_passrule、门控指令、配置下发、心跳等 13 个 RPC；Java brake 侧生成 DeviceAlarmMessage 等 gRPC 类，与 C++ 网关跨语言对接（图里 196 条 GRPC_CALLS 边可证）。
声明：本文仅代表作者观点，不代表本站立场。如果侵犯到您的合法权益，请联系我们删除侵权资源！如果遇到资源链接失效，请您通过评论或工单的方式通知管理员。未经允许，不得转载，本站所有资源文章禁止商业使用运营!
下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态
评论