本项目面向厂区访客、外来施工及应聘人员等入场管理场景,建设了一套“身份证核验/扫码验证 + 安全培训视频学习 + 在线答题 + 门禁放行 + 记录追踪”的一体化门禁安全准入系统,目标是替代传统人工登记、口头核验和纸质考试流程,提升入厂审核效率、身份校验准确率与现场通行管理水平。系统由 PC 管理后台、微信小程序端和 C# 门禁刷证终端组成。后台支持访客报备录入、Excel 批量导入、题库维护、入厂记录查询、异常进出日志追踪等功能;小程序支持访客登录验证、培训视频学习、在线考试、考试结果查看、报备记录查询,以及审批、公司名录、黑名单、管理员仪表盘等功能;门禁终端负责读取身份证信息、调用云端校验接口、根据校验结果进行语音播报并记录刷卡历史。整体业务流程为:管理员先在后台录入或批量导入报备信息并维护题库;访客到场后通过手机号、姓名、身份证号在小程序验证身份,按规则完成培训视频学习和安全考试;门岗处再通过身份证读卡器读取证件信息,系统联动云端判断是否已报备、是否考试合格、是否存在未签退或需重考等状态;校验通过后提示可入厂,否则进行原因播报和拦截,从而形成“报备-学习-考试-核验-入场-留痕”的完整闭环。
项目整体采用多端协同设计:使用 Next.js + React 构建 PC 管理后台,承担报备管理、Excel 导入、题库版本维护、访客详情及进出日志查询等能力;使用 Taro + React 构建微信小程序,负责访客登录、视频学习、考试答题、结果反馈、记录查询及部分管理能力;使用 .NET Framework WinForms 对接身份证读卡器和现场门岗设备,完成证件读取、刷卡去重、云接口调用、结果播报和本地刷卡历史持久化。我的工作重点放在核心链路打通和稳定性落地,包括报备导入校验、考试流程状态管理、门禁刷证校验联动以及多端数据一致性处理;例如后台实现了 Excel 模板校验、分块导入与失败行反馈,题库支持按人员属性区分并带版本升级;小程序实现了静默登录、考试草稿保存、断点续答、视频完成后进入考试、考试结果回跳等流程;门禁端实现了身份证读取、重复刷卡拦截、云函数鉴权调用、按不同放行原因语音播报及历史记录归档。项目难点主要在于硬件终端与云端业务状态联动、考试状态跨端同步,以及异常场景下的用户体验稳定性。针对这些问题,我通过统一云函数调用封装、增加答题草稿与会话缓存、引入刷卡时间窗去重、补充日志与本地历史记录、按“未报备/未考试/未签退/需重新学习”等原因细化状态反馈等方式解决,保证了现场刷证、学习考试和后台管理三端流程能够稳定协同。