工作台

按组织、功能、权限分区操作

未登录

工作台

登录后按左侧菜单进入员工、考勤、薪资、考勤机管理、客户组织等模块。

-
员工数量
-
最后使用日期
-
部门数量
-
考勤机数量
-
工资记录

移动打卡

统一响应式 PC + Mobile Web 打卡入口；保留原 Telegram 一次性链接，不建立第二套 H5 页面。

手机打卡验证

本页面属于统一前端架构，不从 URL 中读取 employee_id，只使用一次性 token 调后端校验身份。提交时会采集设备指纹、GPS，必要时要求现场自拍。

打卡类型-
设备指纹待生成
GPS 状态待定位
员工身份待校验

          

        

      


      

        
Telegram 员工绑定
从 Telegram Bot 打开本页面后，输入员工编号或手机号完成账号绑定。

        

          

            
绑定账号

            
一个 Telegram 账号只能绑定一个在职员工；一个员工也只能绑定一个 Telegram 账号。绑定成功后 Bot 会发送“绑定成功”。

            

              

              

              

            

            

            

          

        

      


      

        

        
      



      

        
用户与权限
客户管理员可在本组织内新增用户、维护权限，并绑定本客户组织自己的 Telegram Bot。

        

        

        

          

            
新增 / 更新用户

            
账号信息

            
            
            

              

              

              

              

              

            

            
功能权限

            
权限按一级菜单、二级菜单、三级功能分层设置；三级功能下的列表“编辑”“删除”也可单独授权。

            

              
              
            

            

            

            

          

          
用户列表
点击列表中的“编辑”可把该用户资料和权限带回上方表单继续维护；删除按钮用于删除不再使用的用户账号。

        

        

        

          

            

              
绑定 TeleGram BOT

              
为当前客户组织绑定自己的 Telegram Bot。今天下午开发的员工绑定码、Telegram 菜单、一次性 Mobile Web 打卡链接、消息队列和后续移动打卡功能都会优先使用这里启用的 Bot。Token 和 webhook secret 只保存，不在页面回显。

              

                

                

                

                

                

                

              

              

              

            

            

              
已绑定 Bot 列表

              
同一客户组织只能有一个启用的默认 Bot；保存新的启用 Bot 后，系统会自动把本组织其它 Bot 置为停用，避免移动打卡链接和队列消息走错 Bot。

              

            

          

        

      



      

        
客户组织管理
平台超级管理员专用：创建客户组织、设置启用/结束时间、到期提醒和启停状态。

        

          

            
创建客户组织

            
默认进入创建客户组织状态；点击下方组织列表“编辑”后，资料会带入上方表单进行更新。

            

              

              

              

              

              

              

              

              

              

              

              

              

              

              

              

              

              

              

            

            

            

          

          

            
组织列表
选择“编辑”会回填到上方表单；列表区只做查找、编辑、启停和删除。

            

          

        

      




      

        
正式版升级/回滚
平台超级管理员专用：将 8000 测试环境中已验证通过的代码、前端构建和 migration 按版本发布到正式环境，并支持正式环境回滚。

        

          

            
环境隔离状态

            
测试环境与正式环境使用独立前端目录、后端目录、SQLite 数据库、配置文件、日志目录和异步队列命名空间。发布不会复制测试数据库，也不会覆盖 .env.prod。

            
请点击刷新发布状态。

          

          

            
从测试版发布到正式版

            

              

              

              

              

              

            

            

            

          

          

            
回滚正式版本

            
回滚会将 /opt/hr-system/prod/current 软链接切回指定版本，并恢复对应数据库备份，然后重启正式服务。

            

            

            

          

          

            
发布记录

            
暂无数据

          

        

      


      
基础资料
维护员工资料中可选的基础字典，包括组织管理、职位和离职类型。
组织管理
第一级为当前登录公司名称，默认存在且不可编辑；上方集中新增 / 编辑部门资料，下方实时查看组织架构。英文名、中文名、高棉名任意填写一个即可保存。
组织架构
下方以树状架构展示公司和部门层级，可直接编辑、增加下级或删除未使用部门。
未被员工、异动或离职记录使用，且没有下级部门的部门可以删除；已使用部门会提示“有些数据在使用，不能删除”。
职位管理
职位列表
使用列表上方统一模糊查找筛选职位；员工资料里的“职位”从这里选择。
EXCEL 字段：code,name,description。请先下载模板，填写后直接导入。
离职类型
离职类型列表
使用列表上方统一模糊查找筛选离职类型；员工离职里的“离职类型”从这里选择。
EXCEL 字段：code,name,description。请先下载模板，填写后直接导入。


      

员工管理
新增员工并维护员工编号，考勤机同步时使用员工编号匹配。
新增员工 / 编辑员工
上方集中录入 / 编辑员工资料，下方列表即时查找和维护，减少来回切换。
编辑时员工编号不可修改。
仅限数字；9位按 3-3-3，10位按 3-3-4，11位按 3-4-4 分隔显示。
年龄 -
司龄 -
请从下方组织架构选择部门
部门必须从基础资料 → 组织管理中点选，按从左到右的层级列选择。
PC 和手机 H5 可选择相册文件，也可在手机端直接调用相机即时拍照；照片会统一转换为 JPG，并按最大 250KB、分辨率不超过 1280×720 处理后再以 Base64 数据保存。预览区按标准 2 寸照片比例显示；服务器检测到清晰标准2寸正脸、可供考勤机正常识别时辅助框显示绿色，否则红色闪烁提示。
未选择照片
员工标准2寸照片预览
标准2寸预览
请上传标准2寸正脸照片；服务器检测到清晰可用于考勤机识别的人脸时辅助框显示绿色，否则红色闪烁。
员工在 Telegram Bot 发送 /TG-839214 后完成绑定。
H5 / APP 员工照片采集
支持 H5 / APP 调用摄像头现场拍照；换设备人脸验证时只允许现场拍照，不允许上传本地相册图片。
设备下发
下载到考勤机
只在这里选择员工要下发到的目标；考勤机分组请到“考勤机管理 → 考勤机分组”统一维护。
下发规则单个设备与设备分组二选一；多选分组时重复设备自动去重。
适合临时选择几台设备；系统按每台设备一条任务排队下发。
员工列表
支持模糊查询、分页浏览和每页显示数量设置。员工列表每 2 分钟自动刷新一次；批量导入照片可上传 .xlsx（可在员工行插入图片）或 .zip（内含 Excel/CSV + 照片文件，照片文件名填 standard_photo_file）。


      
办理异动
上方集中选择一个或多个在职员工、调入部门、职位和生效日期；保存后可在下方异动记录列表立即查询确认。
使用系统标准员工多选窗口，可按工号、姓名、部门、职位、电话等信息快速勾选。
异动记录列表
下方集中查看、搜索和导出异动记录，列表使用系统统一分页。


      
办理离职
上方集中选择一个或多个在职员工、离职日期和离职原因；保存后可在下方离职记录列表立即查询确认。
使用系统标准员工多选窗口，可按工号、姓名、部门、职位、电话等信息快速勾选。
离职记录列表
下方集中查看、搜索和导出离职记录，列表使用系统统一分页。


      
选择异动员工
从下方在职员工列表中勾选，可一次选择多名员工办理异动。
0 人
支持工号、姓名、部门、职位、电话、证件号、性别、地址


      
选择离职员工
从下方在职员工列表中勾选，可一次选择多名员工办理离职。
0 人
支持工号、姓名、部门、职位、电话、证件号、性别、地址


      
班次管理
设置上下班时间、休息时间、第二工作时段和加班时段。
新增班次
第一段正常上班请选择有效时间，工作时间自动换算为分钟。
允许打卡时间：提前/延后分钟用于有效班次考勤记录统计。
提前XX分
延后XX分
提前XX分
延后XX分
第二段正常上班可为空；填写后自动计算第二段工作分钟数。
允许打卡时间：提前/延后分钟用于有效班次考勤记录统计。
提前XX分
延后XX分
提前XX分
延后XX分
第一段加班通过时间点选避免格式错误，支持跨天计算。
允许打卡时间：提前/延后分钟用于有效班次考勤记录统计。
提前XX分
延后XX分
提前XX分
延后XX分
第二段加班可为空；用于同一天第二段加班或夜间加班。
允许打卡时间：提前/延后分钟用于有效班次考勤记录统计。
提前XX分
延后XX分
提前XX分
延后XX分
第三段加班可为空；用于第三段加班时间，保存时会累加到总工作/加班分钟。
允许打卡时间：提前/延后分钟用于有效班次考勤记录统计。
提前XX分
延后XX分
提前XX分
延后XX分
时间字段已改为系统时间点选，避免手工输入无效格式；工作时间默认按对应下班时间减去上班时间自动换算为分钟，也可以根据实际情况手动修改分钟数，跨天时会自动按次日计算。备注用于记录本班次文字说明。
班次列表
支持编辑和删除；只有仍有在职员工使用的班次不能删除，离职员工和历史考勤不再阻止删除。
分配班次给员工 / 部门
先选择班次，再选择单个或多个员工；也可以选择部门，一次性把该部门所有员工绑定到此班次。考勤机数据会按员工班次计算迟到、出勤和加班。
可按部门分配，或点击“选择员工”打开统一多选员工界面。


            

      

        

          

            合同管理
            
合同管理

            
统一办理员工合同的新增、续签与结束；先选择上方功能卡片，再在下方表单操作。

          

          
        

        

          
          
          
        

        

          

            

              

                
操作说明

                
    
                  
  1. 选择一名在职员工。
    2. 
                  
  2. 填写合同类型、开始日期和结束日期。
    3. 
                  
  3. 系统自动计算合同天数，确认后点击保存。
    4. 
                

                
适用于员工第一次签合同或需要新增一份独立合同记录。

              

              

                
新增加合同表单

                

                  

                  

                  

                  

                  

                  

                

                

                

              

            

          

          

            

              

                
续签规则

                
    
                  
  1. 选择员工后先读取上一份合同。
    2. 
                  
  2. 续签开始日期由系统自动生成，不能手动改。
    3. 
                  
  3. 填写续签结束日期后保存续签合同。
    4. 
                

                
页面会显示此员工已经签过多少次合同，便于确认续签次数。

              

              

                
续签合同表单

                

                  

                  

                  

                  

                  

                  

                  

                

                

                

              

            

          

          

            

              

                
结束合同说明

                
    
                  
  1. 选择员工后自动提取最后一份有效合同。
    2. 
                  
  2. 结束日期默认今天，也可根据实际情况调整。
    3. 
                  
  3. 确认后该合同会标记为已结束。
    4. 
                

                
请先核对“最后有效合同”信息，避免结束错误合同。

              

              

                
结束合同表单

                

                  

                  

                  

                  

                

                

                

              

            

          

          

            
合同列表
查看所有合同记录，支持按合同所有信息模糊查询。

            

            

            

          

        

      


            
      
合同另存为 PDF
请选择已维护的合同模板，系统会把员工资料和合同资料字段替换到模板中；点击打印后会自动打开浏览器打印/另存为 PDF 界面。多合同打印会按已勾选的合同逐份生成并连续打印。


      

        
合同基础资料
维护合同类型和合同模板，供合同办理时选择和导出 PDF 使用。

        

        
自定义合同类型
合同类型列表

        
合同模板编辑器
劳动合同
甲方与 {{employee_name}} 签订 {{contract_type}}，合同期限为 {{start_date}} 至 {{end_date}}。
合同模板列表

      


      
考勤排班
在考勤管理下先维护公共日历，再维护考勤组，绑定已有班次、部门、员工和打卡方式。
公共休息日 / 公共假期日历
一年 12 个月按日历卡展示。先选择日期，再用下方按钮批量标记为工作日期、正常休息或公共假期；颜色会立即区分。
工作日期正常休息公共假期
排班管理
选择班次、适用部门/员工和打卡开关即可完成排班；COMPANY_ID 数据隔离由系统自动处理。日期规则统一来自左侧“公共日历”。
默认开启全部打卡方式
可选择一个或多个组织部门。
可选择特定员工；部门和员工可同时设置。
新建排班时全部默认打开；如需禁用某个渠道，取消对应勾选即可。
公共假期默认随“公共日历”启用；若要调整，请返回公共日历。
排班列表
列表显示每个排班绑定班次、部门/员工、公共日历概要和打卡方式。


      
打卡地点设置
在考勤管理下维护 GPS 打卡地点；一个考勤组可绑定多个地点，员工处于任意有效地点范围内即可打卡成功。
新增打卡地点
后续打卡来源支持 GPS 定位、Telegram location、H5 浏览器定位；当前地点校验统一使用经纬度和允许打卡范围。
GPS 定位手机/设备上传经纬度后按半径判断。
Telegram location接收 Telegram 位置消息后复用同一校验接口。
H5 浏览器定位浏览器 geolocation 获取坐标后校验任意有效地点。
打卡地点列表
一个考勤组可以绑定多个打卡地点；启用地点会参与任意范围命中校验。


      
考勤补卡/考勤记录
按标准上下结构处理手动补卡，并集中查看移动端、考勤机记录和考勤处理结果。

        
手动考勤补卡
用于 HR 对员工漏打卡进行补录。保存后系统会按员工班次或指定班次重新计算迟到、出勤和加班小时。
可一次选择多名在职员工，系统会按相同日期和打卡时间批量补卡。
手动补卡记录
列表支持工号、姓名、部门、日期、班次、状态、备注等模糊查询，并使用系统标准分页。
0 条手动补卡
考勤汇总

        
移动端打卡记录
显示 H5 移动端、Telegram 打卡入口提交的详细记录；默认读取最近 2000 条，选择日期范围后按范围完整查询，导出当前显示数据。
0 条H5Telegram默认最近2000条

        
考勤机打卡记录
显示从考勤机进入系统的详细记录；默认读取最近 2000 条，选择日期范围后按范围完整查询，导出当前显示数据。
0 条考勤机默认最近2000条

        
考勤处理
按日期范围汇总 H5、Telegram、手动补卡、考勤设备数据，并结合排班、班次、请假、出差/外勤与公共假期统一计算。
不选择员工时，考勤计算默认处理日期范围内全部在职员工；选择后只重新计算所选员工，不影响其他员工已计算结果。
0 条正常工作迟到/早退/旷工/请假/出差按部门排序

        
月度考勤汇总
按开始年月、结束年月、组织管理部门多选和员工多选，汇总“考勤处理”已计算结果；支持跨月查看，同一员工不同月份按月份先后显示。
部门来自“组织管理”，可按住 Ctrl/Command 多选；不选部门时可只按员工选择查询。
部门员工和手工选择员工取并集；部门和员工都不选时显示所选月份内全部已计算员工。
0 条按员工/月度排序来源：考勤处理计算结果
考勤异常查看
显示所选日期范围内所有不正常考勤记录；默认按组织管理部门排序，便于导出 Excel 后分发给各部门确认。
0 条

      
考勤机打卡照片
列表默认不加载照片和 raw_json；只有点击“查看照片”时才读取单条记录照片。


      
考勤机管理
先登记设备档案，再允许 MQTT/HTTP 通讯；未登记或禁用设备会记录为异常。
MQTT 通讯

        
MQTT Broker 配置
系统启动后自动连接 MQTT Broker。固定协议：设备应用层心跳 30 秒、三次未收到心跳（120 秒内）判定离线；QoS=0、Retain=0、CleanSession=1、设备重连间隔 10 秒；TLS/SSL 字段已预留。
MQTT Topic 规范
普通指令必须发送到 iot/device/{device_sn}；禁止默认使用广播 Topic。服务端订阅设备响应为固定 iot/service/deviceid，不是 iot/service/{设备号}。
系统发布普通指令iot/device/{device_sn}
系统广播iot/device/all（只允许明确广播时使用）
订阅设备响应iot/service/deviceid
订阅全部响应iot/service/all

        
新增设备
只有登记且启用的 device_sn 才允许 MQTT/HTTP 通讯。设备类型已预留门禁、闸机、考勤机；列表支持新增设备、编辑设备、启用/禁用设备、查看设备在线状态、查看最近通讯时间、查看 MQTT 消息日志和 HTTP 上传日志。
使用提示设备号必须与设备上传 JSON 中的 sn 一致。
设备档案列表
列表按“设备信息 / 网络位置 / 状态 / 最近通讯 / 操作”分组展示，操作按钮集中在同一行，便于快速维护和同步。
MQTT 消息日志
记录 publish / subscribe，每条日志含 topic、direction、device_sn、message_id、payload、created_at；异常设备也会标红。
HTTP 上传日志
未登记或禁用设备的 HTTP 上传会记录为异常。



        
分组管理
考勤机分组
把多台考勤机按区域、车间、楼层或用途组成分组；员工下发时选择分组即可自动展开设备并按 device_sn 去重。
按 Ctrl/Shift 可选择多台设备；显示格式为 设备名称 / 位置 / device_sn / 在线状态。
考勤机分组列表
列表右侧提供编辑、删除；员工新增/编辑界面的“下载到考勤机”会直接使用这里维护的分组。



        
设备同步任务
打开本界面后每5秒刷新一次；只显示未成功任务、成功列表和失败/超时列表，支持重试。
正在排队/下发
已经下发成功
下发超时/失败

      
请假 / 加班 / 出差
维护假期类型、审核流程，按员工编号批量提交请假、加班和出差申请。

        
假期类型
自定义员工假别；勾选“薪资扣减”后填写扣减公式，支持拖拉考勤字段和 Excel 常用函数。
假期类型列表

        
审核流程
按单据类型、提交者账号、假期类型、部门匹配流程；条件为空表示“所有”。单据提交者和审核人员均从“用户与权限”的用户列表中已启用账号模糊查找选择；匹配时优先按条件更具体、优先级更高的流程执行。
弹窗中勾选多个已启用用户账号后确认，系统按当前勾选顺序保存为多级审核流。
审核流程列表

        
请假申请
使用员工编号操作，支持选择多个在职员工批量提交；时间只能选择整点或半点，并与员工班次上/下班时间范围联动。
根据员工正常上班班次自动计算。
请假审核
请假记录
按工号、姓名、假期类型、日期、审核流程、状态、原因模糊查找请假记录。

        
加班申请
使用员工编号操作，支持选择多个在职员工批量提交；加班时间按班次工作/加班时间范围联动。
根据员工班次的加班时间自动计算。
加班审核
加班记录
按工号、姓名、日期、小时、倍率、审核流程、状态、原因模糊查找加班记录。
出差申请
使用员工编号操作，支持选择多个在职员工批量提交出差申请；时间只能选择整点或半点。
根据员工正常上班班次和排班时间自动计算。
出差审核
出差申请记录
按工号、姓名、日期、小时、审核流程、状态、原因模糊查找出差记录。

        
      

      
选择在职员工
从下方在职员工列表中勾选，可一次选择多名员工。
0 人

      
考勤机员工人脸数据
读取考勤机当前保存的人脸员工数据；可勾选一条或多条后下发删除命令。
0 条


      
薪资管理
维护薪资基础资料、薪资规则、计件工资、奖励录入和惩罚录入；工资生成和工资记录列表已停止在本界面显示。
薪资基础资料
设置每月发薪次数和发薪日。第一次发薪日默认 10 日，用于发放上个月未发放的薪资；第二次发薪日默认 25 日。
可从下面拖拉 EXCEL 函数和考勤/薪资字段到公式框。
函数：SUM、IF、ROUND、MIN、MAX、ABS、AND、OR
计件工资录入
按员工工号、工序、产品型号、数量、单价录入。保存后记录直接显示在下方计件工资记录列表。
计件工资记录
奖励录入
使用标准多员工选择；录入日期默认为当天且不可修改，生效月份用于薪资计算读取当月已审核奖励累计。
奖励审核
显示当前登录用户需要审核的奖励录入单据；审核逻辑与请假审核一致。
奖励录入记录
惩罚录入
使用标准多员工选择；录入日期默认为当天且不可修改，生效月份用于薪资计算读取当月已审核惩罚累计（负数）。
惩罚审核
显示当前登录用户需要审核的惩罚录入单据；审核逻辑与请假审核一致。
惩罚录入记录
自定义薪资项目
自定义薪资项目保存启用后，会作为可拖拉字段显示在“薪资规则”的“薪资基础字段”中，供薪资计算规则使用。后台会自动生成 cu 前缀公式字段编码，使用者只需维护项目编号和项目名称。
语法与“薪资规则”一致，可拖拉 EXCEL 函数和薪资/考勤字段组合公式。
自定义薪资项目列表
可编辑、删除已新增项目。若删除项目已被薪资规则公式使用，系统会先提示使用中的薪资规则名称。
自定义薪资规则（拖拉字段/函数组合公式）
可拖拉字段
薪资规则列表
列表支持统一模糊查找、字段升降序和导出 EXCEL；每条规则可编辑或删除。
批量分配薪资计算规则
适合同一部门或多名员工统一调整：可选择部门，也可使用统一员工多选界面勾选员工后批量更新薪资规则。
可按部门选择，或点击“选择员工”打开统一多选员工界面。


      
      
薪资计算
按月计算员工薪资，依据发薪次数自动显示第一次/第二次薪资计算序列。
按月计算
计算前请先确认薪资规则、计件工资、奖励、惩罚、请假、加班、出差和考勤均已录入并审核生效。
薪资计算结果
只读结果表，可上下左右拖动查看。
计算操作记录列表
默认列表只显示每次按月计算的操作记录，包含计算年月、薪资计算序列、员工结果数量和计算时间；员工薪资明细请点击“查看计算结果”。
薪资报表自定义及导出
先选择计算年月和薪资计算序列，再把左侧字段拖拉到右侧自定义区域；表头支持三行：高棉文、中文、英文。
来源：按月计算列表中的计算年月、薪资计算序列。
可拖拉字段
格式操作
导出工资条
把字段拖拉到这里。可编辑每列三行表头后导出。