月底一问：「老王这个月上了几天？」桌上是皱巴巴的纸表，群里是对不上号的聊天记录。小作坊、电工班、装修队真正缺的，往往不是一套上云的「智能考勤机 」，而是一台 放在车上、通电就能刷卡、数据留在本地 的小机器。
CrewTrack 干的就是这件事：ESP32 加 RFID 刷卡、小屏和 SD 卡，再开一个本机 Wi‑Fi，手机连上去就能管人、导出表格。没有订阅费，也不依赖公网。
- 项目：https://github.com/0x-Shadow/CrewTrack
- 主页：https://0x-shadow.github.io/CrewTrack/
- 许可：MIT
- 形态：Arduino 单文件固件（
CrewTrack.ino）+ 板载 Web 看板
一句话：CrewTrack = 给小团队用的离线 RFID 考勤终端------刷一下记一天，月底打开看板就算得清。
一、它到底是什么
它不是去「破解」公司大堂那台中控指纹机，而是 自己做一台门口终端：
| 关键词 | 含义 |
|---|---|
| RFID 刷卡 | RC522 读出 MIFARE 卡的 UID，对上员工就记一笔 |
| 本地存储 | MicroSD 按天写 CSV，数据在卡里 |
| 本机热点 | ESP32 开 Wi‑Fi AP，手机浏览器访问 192.168.4.1 |
| 防重复 | 短时间连刷两次，不会重复算出勤 |
| 月汇总 | 出勤天数 × 日薪，给出简单估算 |
更贴切的说法是：工地或厢式货车里的电子签到本------硬件是嵌入式，账本在 SD 卡，管理页在手机浏览器。
| 纸表 / 群聊 | 商用考勤机 + 闭源软件 | CrewTrack | |
|---|---|---|---|
| 成本 | 低，但易丢、易扯皮 | 设备 + 软件，还可能按月订阅 | 首套零件大约几十欧元量级 |
| 网络 | 不需要 | 常要装客户端或上云 | 可以不连公网 |
| 数据 | 难汇总 | 锁在厂家生态里 | CSV 在本地，可导出 |
| 适合 | 临时记一笔 | 公司大门、多网点 | 小班组、流动作业 |
二、三个常见误解
≠ 用来替代写字楼大厅那台人脸闸机。
人脸、指纹门禁、多网点考勤同步，是另一条产品线。CrewTrack 瞄准的是 小团队点名、算工天。
≠ 必须一直连着家里的路由器。
看板跑在设备自己的热点上。工地没网，照样能刷卡；手机临时连上设备 Wi‑Fi，就能管人、看表、校时间。
≠ 「开源」等于「免维护」。
默认管理密码要改；时间要在看板里自己校；外壳、供电、防雨，都还得现场收尾。
三、硬件长什么样
核心就几块常见模块，SPI 总线复用：
| 模块 | 典型型号 | 干什么 |
|---|---|---|
| 主控 | ESP32 DevKit | 跑固件、开热点、提供 Web |
| 读卡 | RC522 | 读卡号 |
| 显示 | ST7789，约 2 寸 IPS | 显示刷卡结果、姓名、时间 |
| 存储 | MicroSD | 按天写 CSV |
| 反馈 | 有源蜂鸣器 | 「嘀」一声确认 |
| 卡片 | MIFARE Classic 等 | 一人一卡 |
接线在项目 README / BOM 里写得很全：RFID、屏幕、SD 共用 SPI，各用不同的片选脚；蜂鸣器单独占一根 GPIO。第一套含运费，作者估算大约 40～50 欧元------国内采购通常还能更便宜。
四、刷一下之后发生了什么
路径可以记成四步：
- 读 UID ------ RC522 读到卡号
- 查人 ------ 和本地员工表比对；未登记会提示未知卡
- 落盘并反馈 ------ 写入当天 CSV，屏上显示 OK 和姓名，蜂鸣器响一声；重复刷卡会被挡住
- 看板 ------ 手机连上设备 Wi‑Fi，打开
192.168.4.1：看今日统计、员工、出勤、薪资估算，导出 CSV，手动校时
五、谁适合用、谁不适合
多半会对上号的：
- 电工班、装修队、小作坊、维保小队------人不多、点位常换、月底要算工天
- 想练手 ESP32 + RFID + 小屏 + 板载 Web 的嵌入式爱好者
- 不想上云、也不想按月交 SaaS 的场景
建议别硬套的：
- 写字楼多门禁、人脸识别、法务级考勤------上正规方案
- 要强安全、防克隆卡、国密门禁------RC522 + MIFARE Classic 不是那条路
- 指望「刷完自动同步到钉钉 / 企业微信」------当前版本主打本地，MQTT 等还在路线图里
六、怎么动手
- 按 BOM 备件：ESP32、RC522、ST7789、SD 模块、蜂鸣器、卡
- 用 Arduino IDE 安装 ESP32 板支持，再装
MFRC522、TFT_eSPI、ArduinoJson - 按仓库说明改好 TFT_eSPI 的 User_Setup ，烧录
CrewTrack.ino - 上电 ：在串口里看热点名和密码；手机连上后，浏览器打开
192.168.4.1 - 先改默认管理密码，再校时、录入员工、发卡
- 试刷卡：看屏幕、听蜂鸣器，确认 SD 或看板上多了一条记录
第一里程碑很简单：刷一张已登记的卡，屏上显示 OK，看板里能看见这条记录。
七、优缺点
优点
- 场景清楚：离线、本地、小团队
- 硬件常见，Arduino 上手路径短
- MIT 许可，个人和商用都相对宽松（以仓库 LICENSE 为准）
- 看板加 CSV，月底对账够用
缺点
- 仓库还比较新，星不多，生态不如老牌大项目
- 当前偏「每天刷一次记出勤」；进出打卡、加班等还在路线图里
- 门禁级安全和外壳防护要自己补
- 多车队、多工地统一后台，要么等后续版本，要么自己加同步
八、写在最后
下次再听见「这个月到底上了几天」，不妨想一句：是再撕一张纸表，还是在车厢里放一台会自己记账的刷卡机？
CrewTrack 把路走窄了，也走实了：窄在不做企业级门禁全家桶；实在把 RFID、屏幕、SD、板载 Web 收成一个能上工地的终端。它不靠刷星证明自己，靠的是------月底打开看板，天数和估算薪资就在那里。
真要动手： BOM → 接线烧录 → 改密码校时 → 发卡试刷 → 导出 CSV。别第一天就对接云平台和人脸算法------先让「刷一下，留下一条」在板子上跑通。
