架构校园考勤签到平台

校园考勤签到平台

面向校园与幼儿园、千万级用户规模的考勤签到平台:教师与家长通过 App 与考勤机在集中时段完成签到,按学校与班级隔离,考勤记录、统计与异常提醒全程可追溯。

产品功能架构图Capability Map

六大产品能力域:签到与打卡、考勤规则、组织与权限、统计与分析、通知与审批、接入与开放。

签到与打卡从身份校验到签到成功考勤规则班次、课表与例外组织与权限学校、班级与家长统计与分析出勤、异常与报表通知与审批提醒、审批与升级接入与开放多端入口与系统对接学生签到App 定位 · 设备打卡高峰并发校验教师签到班次内校区打卡设备与定位校验请假申请事假 · 病假 · 调休审批流补签申请漏签补录证据与审批定位校验校区围栏比对电子围栏设备与人脸校验刷卡 · 人脸 · 指纹考勤机终端班次设置上下学时间与窗口规则配置课表关联按课程签到课表同步节假日与调休工作日例外校历配置弹性与固定规则迟到早退宽限规则参数多校区规则校区差异化配置规则继承规则版本与灰度变更可回滚版本化发布学校与校区多租户隔离组织树年级与班级班级归属与调整组织架构师生档案学生 · 教师 · 教职工档案中心家长绑定监护人关系绑定校验角色权限管理员 · 教师 · 家长RBAC数据隔离校区与班级维度租户隔离实时出勤当前签到进度秒级聚合日报月报出勤率与趋势预聚合班级对比出勤排名指标计算异常明细缺勤 · 迟到 · 代签明细下钻数据导出报表与对账单异步导出考勤大屏全校态势可视化缺勤提醒家长即时触达多渠道通知请假审批教师审批与销假审批流异常通知迟到与代签提醒模板消息消息模板文案与变量模板管理催办与升级未处理自动升级超时策略通知记录送达与回执通道回执家长与教师 App签到 · 请假 · 查看iOS / Android教师工作台班级考勤管理Web 工作台管理后台规则与报表配置管理控制台学校大屏校园态势展示大屏可视化开放 API学校系统对接REST · 回调第三方对接教育平台集成SSO · WebhookProduct: 校园考勤签到平台

核心业务流程图Business Flow

一次签到从提交到统计归档:身份与位置校验、幂等去重、削峰入队、规则判定、状态生成与通知,最终进入统计与归档。

提交校验通过首次签到异步消费规则匹配缺勤迟到写入事件日终汇总直接返回提交签到App 定位 · 考勤机打卡App / 考勤机身份与位置校验登录态 · 围栏 · 设备网关 + 校验服务幂等去重一次签到只记一次幂等键消息入队削峰缓冲消息队列落库与规则判定班次 · 迟到 · 早退分片写入出勤状态生成正常 / 迟到 / 缺勤状态机异常通知缺勤与迟到提醒模板消息统计聚合日聚合 · 出勤率预聚合报表归档月报与对账归档存储Flow: 一次签到记录

系统总体架构图System Overview

分层视角下的系统组成:终端与渠道、接入与通信、业务应用、平台服务、数据与中间件、基础设施六层,以及贯穿各层的安全、可观测与研发交付能力。

终端与渠道层App · 考勤机 · 大屏接入与通信层网关 · 认证 · 推送业务应用层面向考勤的业务功能平台服务层可复用的领域服务数据与中间件层缓存 · 分片 · 消息 · 分析基础设施层计算 · 网络 · 存储横向支撑能力贯穿全部六层家长与教师 App签到 · 请假 · 查看App: iOS / Android考勤机刷卡 · 人脸 · 指纹硬件终端教师工作台班级考勤与审批App: Web管理后台规则 · 报表 · 权限App: 管理端学校大屏校园出勤态势App: 可视化设备接入考勤机协议适配MQTT · HTTPAPI 网关鉴权 · 限流 · 路由网关集群身份认证登录态与令牌JWT · SSO推送网关长连接与消息下发WebSocket文件服务请假凭证与导出对象存储直传开放接口学校系统对接OpenAPI签到打卡签到 · 补签 · 请假幂等与规则校验考勤规则班次 · 课表 · 例外规则配置组织班级学校 · 班级 · 家长组织与关系统计报表出勤率与异常预聚合查询通知审批提醒 · 审批 · 升级审批流幂等服务键生成与去重Redis · 唯一索引规则引擎班次匹配与判定规则缓存任务调度聚合与补算任务分布式调度消息服务事件发布与消费消费幂等权限中心角色与数据范围RBACRedis 集群幂等 · 位图 · 缓存内存集群MySQL 分片考勤明细与档案分库分表消息队列签到事件削峰多分区ClickHouse统计分析明细列式存储对象存储导出与归档冷备负载均衡流量分发四层 / 七层容器集群弹性扩容K8s · HPA监控告警指标与告警Prometheus日志中心全链路检索ELK容灾备份跨区备份定期演练安全合规鉴权 · 审计 · 加密等保要求可观测性指标 · 日志 · 链路全链路追踪容量与压测基线压测与容量规划峰值模型研发交付持续集成 · 灰度CI/CD 流水线System: 校园考勤签到平台

核心技术架构图Technical Architecture

千万级用户规模下的五个核心技术领域:高并发签到接入、签到幂等与一致性、海量数据存储、异步消息与削峰、考勤规则与统计。

高并发签到接入集中时段峰值流量的稳定接入签到幂等与一致性重复提交只记一次考勤海量数据存储分片、冷热与压缩存储异步消息与削峰事件驱动的可靠落库考勤规则与统计规则判定与指标口径统一网关限流入口统一限流与鉴权令牌桶 · 滑动窗口无状态服务副本水平扩容承接峰值容器 · HPA热点隔离校区与班级热点拆分逻辑分片批量合并集中签到合并处理批量写入降级兜底过载时排队与只读开关与熔断幂等键设计学校 + 学生 + 日期 + 班次版本化键Redis 原子去重键存在即视为重复SETNX 与过期控制唯一索引兜底数据库层最终防线唯一键冲突冲突回读重复请求返回原结果结果缓存最终一致事件补偿与对账定时校验分库分表按学校与学期拆分分片中间件冷热分离当期热存 · 历史冷存分层存储位图存储日签到状态压缩Bitmap归档与分区按月分区与归档分区表读写分离查询走从库主从复制消息队列签到事件先入队多分区 · 顺序键批量消费合并落库降低压力批量拉取消费幂等位点与业务键去重消费位点死信重试失败退避与转存死信队列积压观测堆积与滞后监控告警阈值规则引擎班次与例外判定规则缓存状态机正常 / 迟到 / 缺勤流转状态流转实时聚合当日出勤秒级更新增量聚合离线重算口径修正与补算批处理指标口径统计规则统一口径文档 · 校验Tech: 五大技术领域

核心交互时序图Interaction Sequence

「家长 App 提交一次签到」完整交互时序:鉴权限流、幂等去重、位图置位、异步落库与统计回显。

家长 AppActor接入网关鉴权 · 限流签到服务幂等 · 规则Redis去重 · 位图消息队列削峰统计服务聚合提交签到(定位 · 设备)鉴权与限流放行幂等键 SETNX首次签到当日位图置位受理成功,待判定发布考勤事件批量消费并聚合结果与异常提醒超阈值排队提示Sequence: App 提交一次签到

系统部署架构图Deployment

多可用区部署:接入区承接流量,应用区无状态扩容,数据区按分片与消息集群托管考勤数据。

接入区流量入口应用区K8s 无状态服务数据区存储与中间件HTTPS转发鉴权放行查询幂等读写明细落库消费批量写入模板推送App 与考勤机多端入口App · 考勤机 · 工作台负载均衡流量分发四层 / 七层接入网关 ×2鉴权 · 限流Deployment签到服务 ×N幂等 · 规则校验HPA 弹性统计服务 ×N聚合 · 报表Deployment通知服务 ×2模板消息消费者组消费服务 ×N位点与批量落库消费者组Redis去重 · 位图ClusterMySQL 分片考勤明细分片 + 主从消息队列削峰缓冲多分区Deploy: 接入 + 应用 + 数据

高并发签到接入Sign-in Ingest

集中签到时段的接入设计:App 与考勤机同时上报,网关限流与无状态扩容承接峰值,热点拆分与批量合并降低后端压力,过载时排队降级并保留观测口径。

转发分片路由聚合同班过载保护水位指标阈值排队提示压测校准指标汇聚接入网关鉴权 · 限流 · 路由网关集群无状态服务副本水平扩容承接峰值容器 · HPA热点隔离校区与班级热点拆分逻辑分片批量合并集中签到合并处理批量写入降级兜底过载时排队与只读削峰开关容量观测峰值水位与耗时指标看板限流规则按校区与入口配置令牌桶 · 并发上限排队提示高峰进度与稍后重试端内提示容量压测峰值基线持续校准全链路压测监控看板QPS · 耗时 · 错误率实时大盘Special: 高并发签到接入

签到幂等与防重Check-in Idempotency

一次签到只记一次:幂等键先过 Redis 原子去重,数据库唯一索引兜底,考勤机离线补传与重复上报都返回首次结果,异步补写与对账保证最终一致。

生成键首次请求冲突回读返回结果异步补写规则落库校验记录对账幂等键学校 + 学生 + 日期 + 班次版本化键Redis 原子去重键存在即视为重复SETNX · 过期唯一索引数据库层最终防线唯一键冲突冲突回读重复请求返回原结果结果缓存重复返回幂等成功不报错状态一致补写校验位图与明细对账补写任务键规则键组成与版本约定接口规范去重记录请求指纹与结果短期留存冲突日志重复来源与占比离线分析对账任务位图与明细比对定时补偿Special: 签到幂等与防重

考勤规则与状态机Attendance Rule

考勤判定由班次与例外规则驱动:规则版本化并按校区灰度生效,状态机处理正常、迟到、缺勤与请假,异常判定保留证据供复核。

配置发布灰度生效装载规则异常分支例外修正校历缓存命中审计回滚重算班次与课表上下学与课程时段规则配置规则版本变更可追溯版本化发布灰度发布按校区逐步生效灰度开关考勤状态机正常 / 迟到 / 缺勤状态流转异常判定迟到 · 早退 · 代签规则 + 证据请假与补签规则内的例外审批结果回写校历与节假日工作日与调休校历配置规则缓存高频规则本地缓存版本校验变更审计谁改了哪条规则审计日志回滚预案异常版本快速回退一键回滚Special: 考勤规则与状态机

连续签到与统计Streak & Stats

签到数据按位图压缩存储,连续天数用区间计算,日聚合支撑实时出勤,离线重算修正口径并做一致性校验。

逐日读取汇总增量更新偏差修正口径校验位图读取明细回刷定时触发缓存命中位图存储每人每天一位Bitmap连续区间连续签到天数前缀和 · 区间统计日聚合班级与年级出勤率预聚合实时指标当前签到进度秒级更新离线重算口径修正与补算批处理口径校验统计规则一致性对账校验Redis 位图当月签到状态按日偏移ClickHouse历史明细与聚合列式存储聚合任务定时滚动聚合分布式调度报表缓存常用报表预生成热点缓存Special: 连续签到与统计

海量数据存储与分片Storage & Sharding

考勤数据按学校与学期分片,路由层屏蔽分片细节,当期热存与历史归档分层,跨分片查询由聚合层并行完成。

路由规则读写分流历史迁移归档索引查询下推分片读写热数据冷热分层归档读取分片键学校 + 学期维度分片策略路由层读写请求路由分片中间件冷热分离当期与历史数据分层存储归档与分区按月分区与归档分区表索引设计覆盖高频查询联合索引查询聚合跨分片并行聚合并行查询MySQL 分片考勤明细与档案分片 + 主从Redis 热数据当期状态与缓存内存集群ClickHouse分析型明细列式存储对象存储归档与导出文件低频访问Special: 海量数据存储与分片

异步消息与削峰Async Messaging

签到事件先入队再落库:批量消费降低数据库压力,消费幂等避免重复写入,失败退避转死信,积压与限速联动保护下游。

拉取逐条校验失败转存积压限速入队死信入队消费速率回放消息入队签到事件先入队分区 · 顺序键批量消费合并落库降压力批量拉取消费幂等重复消费不重写位点 · 业务键死信重试失败退避与转存死信队列积压观测堆积与滞后监控告警阈值削峰限速保护下游写入令牌桶消息队列签到事件缓冲多分区死信队列多次失败留档隔离存储消费监控速率与耗时消费大盘补偿任务死信回放与人工介入定时任务Special: 异步消息与削峰