在电子线束、线材加工行业，人力成本往往占制造成本的大头，而考勤排班又比一般制造业复杂得多：同一车间里上午班、下午班、晚上加班三段接力，同一班次下不同拉线还要错峰吃饭；直接人工与间接人工的应出勤天数不同，计件与计时并存。这些特点决定了通用的考勤软件很难直接套用——它必须能按部门、拉线、人员三级粒度排班，能在打卡数据进入薪资之前，把"迟到、早退、缺卡、请假、加班"逐日归档成可审计的日结数据。

本文介绍电子线材线束行业 ERP 中的 HR 人事考勤模块，包括完整功能清单、核心算法能力、平台技术栈与配套考勤设备，供同行业选型与实施参考。

一、模块定位：把打卡变成可算薪的日结数据

HR 模块位于 ERP 主框架的「人力资源」，向下与生产（部门、拉线、岗位）衔接，向上与薪资（考勤工资调整、薪资调整）衔接。整条链路是一条单向数据流：

环节	做什么	产出
① 采集	考勤机自动同步、Excel 导入、HR 补卡	原始打卡记录 tb_AttendTime
② 计算	匹配班次与节假日，逐日逐班次判定迟到/早退/缺卡	考勤归档 tb_AttendArchive
③ 报表	基于归档逐日重算工时，汇总到人、到部门	个人/部门考勤报表
④ 薪资	迟到早退、缺勤、请假、加班工时进入工资核算	考勤工资、薪资调整

这套设计的核心是中间那层「归档」：原始打卡与薪资之间插入一层可审计的日结结果，任何一笔工资都能追溯到"哪一天、哪个班次、哪几笔卡、哪几分钟迟到"。相比"报表直接读原始打卡现算"的做法，归档让结果稳定、可复核、可封账。

二、功能清单

模块共 4 组、20 余个功能点，覆盖从入职档案到月度考勤报表的全过程。

1. 人力资源

• 员工档案：工号、姓名、部门、岗位、拉线、属性（直接/间接）、状态（在职/离职）、入职与离职日期、离职原因、班次组；支持身份证阅读器直接读卡录入
• 员工合同：合同编号、起止日期、续签记录，合同到期可查询提醒
• 岗位调整记录：调岗留痕（原部门/岗位 → 新部门/岗位、生效日期、原因）
• 薪资调整记录：调薪留痕（原薪资 → 新薪资、生效日期、原因）
• 员工异动日志：把调岗、辞职、自离、辞退、劝离、急辞、开除、停薪留职 8 类异动统一写入日志表，记录异动前后部门/岗位/状态、原因与生效日期，形成完整的人事履历
• 恢复在职：离职操作有误可一键恢复在职，同时写异动日志，避免直接改库造成履历断档
• 考勤工资调整：按人、按月的考勤工资项目调整，供薪资核算取数

2. 考勤配置

• 考勤参数配置：14 项算法参数集中维护，保存即生效（详见第四节）
• 班次管理：班次编号、上下班时间、是否跨天、班次类型（白班/晚上加班）
• 排班管理：一张排班单 = 一个时段的班次序列（上午 → 下午 → 加班），适用范围支持部门 / 拉线 / 人员三级
• 特殊考勤日：按日期区间 + 班次 + 部门 + 拉线，单独放宽允许迟到/早退分钟数（周例会、错峰吃饭、端午彩排等）
• 节假日管理：维护法定节假日与调休日，支持按年批量生成
• 考勤设备管理：设备编号、型号、IP、端口、MAC、启用标志，支持「按 IP 取 MAC / 按 MAC 取 IP」与 SDK 登录测试
• 考勤设备绑定：员工与设备绑定，多车间多台机时确定从哪台设备取卡

3. 考勤处理

• 原始考勤记录：查询原始打卡，按工号、日期、来源（考勤机/导入/补卡）筛选
• 导入考勤数据：支持考勤机直接拉取与钉钉考勤 Excel 导入，导入前可预览原始明细
• 考勤计算：按月或按日期区间执行归档运算，生成逐日考勤结果
• 补卡管理：HR 补录忘打卡记录，受「每人每月补卡次数上限」参数约束，补卡与原始打卡一同参与计算
• 请假管理：请假单登记（假别、开始/结束时间、时长），按班次区间自动折算工时

4. 报表

• 个人考勤报表（含横向版）：单人单月的逐日明细 + 月度汇总
• 部门考勤报表：按部门汇总出勤、异常、加班
• 原始考勤记录表：打卡明细原始凭证，用于争议复核

三、核心能力详解

1. 排班：三级适用范围 + 班次槽位

线束厂的排班难点有两个：同一个班次要按拉线错峰，个别人员要单独排。模块的排班单在原有「部门」基础上扩展到三个维度：

• 适用范围：部门 / 拉线 / 人员，优先级 人员 > 拉线 > 部门，命中即整单替换（保证"下一班次"指向唯一）
• 范围值留空 = 不限：选拉线或人员但未勾选具体值，等同于部门级，老数据零影响
• 班次槽位：班次编号首字母决定槽位——A 表示上午、B 表示下午、C 表示晚上加班、X 表示特殊班；数字只表示错峰分组。因此可以顺利扩出 A2/B2/C2 错峰班次，而不必改动取卡算法

举例：A 拉线排 A1/B1/C1（08:00–12:00 / 13:30–17:30 / 18:00–22:00），FQC 拉线错峰吃饭，排 A2/B2/C2（08:30–12:30 / 13:00–17:00 / 17:30–21:30）。两张单互不干扰，计算时按员工所属拉线自动命中。

2. 打卡匹配：把"刷卡"翻译成"第几段班的上下班"

考勤计算的实质是把一天里零散的打卡，配到具体班次的上班/下班节点上。模块按以下规则链取值：

• 取值窗口：以班次标准时间为基准，前后各 15 分钟（参数 ValidTimeRangeMinutes）为有效范围，窗口内取最靠近标准时间的一张卡
• 迟到/早退：超出标准时间但仍在"允许迟到/早退分钟数"内视为正常；超出则记迟到/早退分钟
• 连班：上午下班卡与下午上班卡时间接近时，按「连班允许分钟」参数复用（一张卡既是下班也是上班）
• 缺卡：节点无有效卡记缺卡；整天无有效卡按缺勤
• 收尾分配：常规取值跑完后，当天剩余未消费的卡按"与班次标准时间最接近"做统一配对，并受时序约束（不能插到已归档卡之前/之后），保证极端打卡（严重迟到、临下班才来）也能归位，而不是被静默丢弃

3. 请假与加班

• 请假工时 = 请假区间 ∩ 班次区间的时长；跨天假自动跳过休息日与法定节假日，半天假按班次区间精确切分
• 加班：按加班班次与节假日属性区分「法定加班」与「其他加班」，两者在薪资中的倍率不同，报表分开统计
• 半小时制：每日工时、请假、加班均可配置为按半小时向下取整，贴合行业计薪习惯

4. 14 项算法参数集中可调

参数	作用
宽松窗口 GracePeriodMinutes	标准时间前后若干分钟内不判迟到/早退
有效范围 ValidTimeRangeMinutes	打卡取值窗口半径（默认 15 分钟）
连班允许分钟 ContinueWorkAllowMinutes	上午下班与下午上班卡可复用的时间间隔
月补卡次数上限	控制补卡被滥用，超限提示
有薪假类型	指定哪些假别按有薪假计算
半小时制开关	请假/加班/每日工时是否按半小时取整
月应出勤工时类型	固定标准 or 按当月工作日浮动
自动同步考勤机	客户端启动即自动拉取考勤机数据
报表显示异常提示	报表是否显示请假/补卡/缺勤提示

5. 考勤报表指标

个人与部门报表统一输出以下口径，直接对接薪资：

分类	指标
应出勤	标准工作日、标准工时（直接人工按 22 天 × 8 小时、间接人工按 24 天 × 8 小时，可按参数调整）
实出勤	日工时、班次工时、实际总工时
异常	迟到次数/分钟、早退次数/分钟、缺卡次数/缺卡工时、补卡次数
请假	请假次数、请假工时（含落在加班时段的请假）
加班	加班次数、法定加班工时、其他加班工时、加班合计
节假日	节假日天数、节假日工时

四、平台技术栈

层次	选型
开发语言	C#
运行时	.NET 8（net8.0-windows）
客户端界面	WinForms + DevExpress 22.1.13（表格、编辑控件、打印）
数据访问	Entity Framework Core 8.0.6（SQL Server Provider，Database First）
数据库	SQL Server（单库多账套，账套间数据隔离）
报表引擎	FastReport 2023.1.8
系统架构	C/S 架构：客户端 + 服务端 API + 统一登录与在线升级
权限体系	模块权限 + 功能权限 + 数据权限（支持按部门/角色/人员限定可见范围，敏感列可按权限隐藏）
审计	数据日志（价格、金额等敏感字段变更留痕）+ 员工异动日志

选择 C/S 而非纯 Web 的原因很直接：考勤机 SDK 是原生动态库，只有在客户端进程内才能稳定调用；而车间/门卫室的网络环境往往不稳定，客户端本地缓存与断点重传比浏览器更可靠。

五、配套考勤设备

1. 主用设备：海康威视人脸识别门禁考勤一体机

模块以海康威视（Hikvision）人脸识别门禁考勤一体机为主用采集设备，兼容人脸、刷卡两种识别方式。接入分两条通道：

通道	技术	用途
设备 SDK	HCNetSDK（C# P/Invoke 封装）	设备登录/登出、网络参数读取、考勤事件查询、员工信息下发、人脸照片下发
ISAPI	HTTP + JSON 接口	人员信息分页查询/批量拉取、人脸照片设置与获取、考勤事件（人脸识别通过）按时间与工号检索

设备侧可完成的操作：

• 员工登记：向设备下发工号、姓名、权限计划（卡号/人脸），支持批量
• 人脸照片管理：下发、读取、删除设备端人脸照片，支持设备现场拍照或截图粘贴
• 全量人员拉取：分页读取设备上全部人员名单（工号、姓名、权限），用于设备与 ERP 档案核对
• 考勤事件导出：按日期范围 + 工号（支持多工号）查询"人脸识别通过"事件，导出明细

2. 备用通道：钉钉考勤导入

对异地办公、外派驻厂或尚未安装考勤机的场景，模块支持导入钉钉考勤 Excel：按模板映射工号、打卡时间、打卡方向，导入前可预览原始记录并做异常行提示。导入数据与设备采集数据进入同一张原始打卡表，后续计算口径完全一致。

3. 设备与人员的绑定关系

多车间、多门口部署多台设备时，通过「考勤设备绑定」把员工与设备建立对应关系。这样在拉取事件时可按设备过滤，避免同名同姓或跨厂区串卡；设备管理界面还提供「按 IP 取 MAC / 按 MAC 取 IP」与 SDK 登录测试，方便现场快速定位网络或账号问题。

六、上线实施要点

1. 先配参数、再算数据：14 项考勤参数、班次、排班单、节假日是计算的前提，任何一项缺失都会让结果失去意义
2. 员工属性必须维护准确：「直接/间接人工」直接影响应出勤天数、周末是否算加班、法定假期是否休假——这是行业口径，不是开关
3. 拉线字典与员工拉线字段同步：错峰吃饭与按拉线排班都依赖这个字段，建议与车间实际拉线一一对应
4. 上线顺序：建表 → 参数 → 班次/排班 → 设备绑定 → 取一个月数据试算 → 与手工台账逐人逐日比对 → 差异归零后再封账
5. 保留手工台账至少两个月：首次切换考勤系统，双轨运行是最稳的验收方式

七、小结

HR 考勤模块的价值不在于"能打卡"，而在于把线束行业那些说不清道不明的排班规矩——多班次接力、拉线错峰、直接/间接人工不同口径、请假与加班交叉——沉淀成可配置、可追溯、可复核的日结数据。有了这层数据，薪资核算才有据可依，人事争议才有原始凭证，管理改进才有量化依据。

本模块已在多账套生产环境中稳定运行，支持 JLM、HD 等账套独立配置，可与采购、生产、库存、财务模块共用同一套基础资料与权限体系。