此项目暂未在产品展厅公开展示,你正在通过直链访问。在 管理看板勾选「在产品展厅展示」即可公开。
核心亮点
- 员工不用打卡:手机在班次内自动记轨迹,服务端按围栏与班次自己判迟到早退,人到了就算到岗
- 多个工作地点各自一个圈:点落在任一圈内即算在岗,外勤单列不与缺勤混算,改地点后近 45 天立刻重算
- 「免考勤」是打标记而不是不建号:老板/合伙人不判迟到缺勤、不进应到分母,但轨迹照记、地图上照看得见
- 员工只登手机:网页登录密码在 App 里自己设(不收旧密码,令牌即本人),不用记两个密码
- 装在手机里的更新通道:版本页直接看到线上新版与更新说明,点一下下载安装;装不上时按华为/小米那几步给出提示
技术栈
产品界面
开发成果 10/14
- 手机端自动采集与上传(班次闸门 −25/+2 分钟)
- 服务端考勤判定:围栏命中 / 迟到早退 / 外勤≠缺勤
- 网页后台:今日看板、月报、轨迹回看
- 员工账号与激活码(一人一码一机)
- 多工作地点:轻煮时光 / 川北小区东区25号楼 / 文成国际
- 双通道改密:网页与手机各一条(员工只登手机)
- 「免考勤」标记:只记轨迹、不判迟到缺勤
- 角色白名单:挡掉伴迹 C 端的种子账号「女儿」
- 应用内更新 + /dl/ 下载落地页 + 意见反馈
- 品牌独立:图标、文案、导出文件名统一为「乐活圈OA」
- 全员真机铺开(华为启动管理 / 小米省电策略逐机设置)
- App「我的」页按 OA 精简(去掉家人守护等 C 端功能)
- 试用一周后与客户对账:出勤率 / 外勤判定 / 轨迹密度
- 华为、小米安装四步做成图文指引发群
项目简介
采集端(Android,与伴迹同代码、独立品牌):班次内自动采样,档位随速度切换,锁屏/被杀有看门狗与电池白名单引导。员工不用打卡——轨迹到了就算「到了」。
服务端(Node + better-sqlite3):轨迹落库顺手触发当天考勤重算(60 秒节流);围栏 + 班次判迟到早退,外勤单列、不与缺勤混为一谈;早退只在当天走完之后才判。
网页后台(原生 JS,1280 宽优先):今日看板、月报、看轨迹、员工管理(建号/改密码/重发激活码/授权/离职/免考勤/改地点)、设置(班次/工作地点/围栏)。
分发:应用内更新(版本页看到线上新版 → 下载 → 拉起安装器)+ /dl/ 落地页(识别微信 UA 提示「在浏览器打开」)+ 意见反馈(写好机型版本,拉系统分享发微信)。
三条设计取舍:① 不做「打卡按钮」——打卡会被遗忘、会被代打,轨迹不会;② 免考勤不是不建号——没设备令牌就传不上点,连轨迹都没了;③ 意见反馈不做服务端收件箱——多一个要记得去看的网页,就多一个会漏的地方。
开发历程 3 条
首次提交 b54a221 + 部署 1.61.13:OA 独立成项目
- 首次提交:
b54a221(分支lehuoquan-oa),86 个文件 / +10901 行。提交前逐个文件看过,全是 OA 这条线(含品牌从「如影随形」改「乐活圈OA」、把keystore.properties加进.gitignore);只写显式路径,没用-A。 - 部署:
bash scripts/deploy-oa.sh→ 线上1.61.13;oa.js/oaRoutes.js/oa.html三份文件本地↔线上 md5 逐字一致。 - 当前线上:App
1.61.7(versionCode 147);服务端1.61.13;下载页https://oa.filebreeze.cn/dl/。 - 分发两条路各自到位:已装的人走 App 内更新(
/api/app/version鉴权),没装的人走/dl/静态落地页;先传包后传清单,避开「清单说有、包没到」的 404 窗口。 - 回归:
test-oa131 /test-workplaces57 /test-exempt31 /test-oa-roles23 /test-change-password25 /test-web-password29,全过。 - 口头待定:
/dl/下 145/146/147 三个包(约 140MB)只留最新?App「我的」页按 OA 精简要不要做(要重新出包)?
- 首次提交:
几个不报错的坑:坐标差 538 米、华为装包四步、种子账号「女儿」
- 高德给的是 GCJ-02、库里存的是 WGS-84,延庆实测差 538 米 —— 而围栏半径只有 100 米。后果:人站在门口也被判外勤,而且任何地方不报错,只能看报表时才发现全员外勤。
- 修法:入库前一律
gcj2wgs(),转换算法只在server/src/gcj.js一份;后台另给一个「高德坐标转 WGS」按钮(拿高德抄回来的坐标先转再存)。 - 华为 HBN-AL00 装包四步(微信发 apk 装不上的真因):① 提示「应用备案状态未知」;② 底部「已了解此应用未经检测」不勾,「继续安装」是灰的、点不动;③ 勾完才能继续;④ 还要输手机锁屏密码。原来文案只写「点安装 → 允许」,而那台机上根本没有「允许」这个按钮 ⇒ 同事找不到就以为包坏了。已把这四步写进更新弹窗与
/dl/落地页。 - 会话与密码两个坑:登录查
SELECT *而会话查指定列 ⇒pw_must_change读不到,刷新一下就绕过了强制改密(两处必须同源);/api/auth/me会话失效返回 200 + user:null(不是 401),拿状态码当判据会漏。 - 伴迹种子账号「女儿」删不掉:
db.js每次启动INSERT OR IGNORE ... VALUES (2,'女儿','child')。之前靠「已标离职」这个巧合挡住,谁点一下恢复她就进考勤表、变成天天缺勤的员工。改成按角色白名单(只认employee/self),花名册 / 员工表 / 看板共用一份。
考勤从 0 到 1:不打卡靠轨迹,服务端算,网页上看
- 判据在
server/src/oa.js文件头写死:窗口[上班, 下班),上班打卡 = 窗内第一个点、下班 = 最后一个点;迟到/早退的量已扣宽限;早退只在当天走完之后才判(否则上午 10 点全员早退)。 - 外勤 ≠ 缺勤:围栏没命中但窗内有轨迹 ⇒ 外勤单列;无点分三档(未上报 / 当天未完 / 缺勤),三种都不是同一件事,不能合成一个红字。
- 重算时机:轨迹同步进来就在
/api/trace/sync里顺手重算今天(minAgeMs60 秒节流)。打卡时刻取自轨迹点时间,不是重算时刻 ⇒ 节流不会把 8:31 变成 8:32;算失败只记日志,绝不让轨迹同步失败。 - 多工作地点:
workplaces+user_workplaces,点落在任一所分配围栏算在岗;没分配回落旧单围栏。改地点或分配立刻重算近 45 天,否则历史那几十天挂着旧结论,管理员以为开关没生效。 - 班次 8:30–17:30 周一至周五;端侧采集时段 = 班次 −25 / +2 分钟(
ShiftGate),网页后台只是复述同一份规则、改一处必同步。 - 免考勤不是不建号:没设备令牌就传不上点、连轨迹都没了,正好把客户要的「也要记录轨迹」做没。改成打标记:只记轨迹、不判迟到缺勤、不进「应到」分母。
- 验证:
test-oa131 /test-workplaces57 /test-exempt31 全过。
- 判据在
周期
2026-11-15 → 未定
