一、实际应用场景描述场景某互联网公司项目组员工经常在下班后、周末加班。加班时长由员工自行申报主管审批后录入 HR 系统月底统一核算加班费。典型流程1. 员工提交加班申请时间、事由2. 主管审批3. HR 根据审批结果计算加班费4. 财务发放问题点- 加班记录容易被“误删 / 修改”- 不同人对“是否算加班”标准不一- 加班费计算公式复杂工作日 / 休息日 / 节假日倍率不同- 员工担心“被悄悄抹掉加班时长”二、引入痛点工程视角痛点 技术映射加班记录可被事后修改 数据缺乏不可篡改性人工计算易出错 缺乏自动化规则引擎规则不透明 业务逻辑未标准化信任成本高 多方员工 / 主管 / HR互不信任解决思路- 用区块链式哈希链保存加班记录不依赖公链- 用纯函数规则计算加班费- 所有关键数据可审计、可追溯三、核心逻辑讲解设计思想1️⃣ 加班记录上链Hash Chain每条加班记录包含- 员工ID- 开始时间- 结束时间- 审批状态- 前一条记录的 hashrecord_n hash(record_{n-1} data)✅ 特点- 本地即可运行- 不需要挖矿- 不依赖第三方公链- 一旦写入无法“悄无声息”修改2️⃣ 加班费计算规则自动化规则示例可配置- 工作日加班1.5 倍时薪- 休息日加班2 倍- 法定节假日3 倍overtime_pay hours * hourly_rate * multiplier3️⃣ 防克扣机制- 加班记录不可删除- 修改必须生成新记录- 历史记录可导出审计四、代码模块化结构overtime_system/│├── models.py # 数据模型├── chain.py # 简易哈希链├── calculator.py # 加班费计算├── storage.py # 本地存储├── main.py # CLI 入口└── README.md五、核心代码示例简化版1️⃣ 加班记录模型models.pyfrom dataclasses import dataclassfrom datetime import datetimeimport hashlibdataclassclass OvertimeRecord:employee_id: strstart_time: datetimeend_time: datetimeapproved: boolprev_hash: strdef compute_hash(self) - str:data f{self.employee_id}{self.start_time}{self.end_time}{self.approved}{self.prev_hash}return hashlib.sha256(data.encode()).hexdigest()2️⃣ 简易区块链chain.pyfrom models import OvertimeRecordclass HashChain:def __init__(self):self.chain []def add_record(self, record: OvertimeRecord):record_hash record.compute_hash()self.chain.append((record, record_hash))return record_hash3️⃣ 加班费计算器calculator.pyfrom datetime import datetimeWEEKDAY_MULTIPLIER 1.5WEEKEND_MULTIPLIER 2.0HOLIDAY_MULTIPLIER 3.0def calculate_multiplier(dt: datetime) - float:weekday dt.weekday()if weekday 5:return WEEKEND_MULTIPLIERreturn WEEKDAY_MULTIPLIERdef calculate_overtime_pay(hours: float, hourly_rate: float, multiplier: float) - float:return round(hours * hourly_rate * multiplier, 2)4️⃣ 存储与调用main.pyfrom datetime import datetimefrom chain import HashChainfrom calculator import calculate_multiplier, calculate_overtime_payfrom models import OvertimeRecordchain HashChain()record OvertimeRecord(employee_idE1001,start_timedatetime(2025, 1, 10, 20, 0),end_timedatetime(2025, 1, 11, 0, 0),approvedTrue,prev_hash0)chain.add_record(record)hours 4rate 50multiplier calculate_multiplier(record.start_time)pay calculate_overtime_pay(hours, rate, multiplier)print(f加班费: {pay} 元)六、README 文件精简版# 加班记录与加班费计算系统Demo## 功能- 加班记录上链Hash Chain- 加班费自动计算- 防篡改审计支持## 使用方法bashpip install -r requirements.txtpython main.py## 适用人群- 企业内部工具 Demo- 教学 / 课程作业- 区块链应用入门学习七、使用说明中立化1. 本系统不连接公链2. 数据存储在本地3. 适合作为- 企业加班制度数字化原型- 区块链思维教学案例4. 可扩展为- Web API- 数据库存储- 智能合约版本如 Solidity八、核心知识点卡片去营销化模块 知识点数据结构 哈希链、不可篡改日志算法 SHA-256、时间判断工程思维 模块化、单一职责区块链思维 去中心化记账、审计可追溯职场应用 规则自动化、减少人为干预九、总结工程师视角这个项目的价值不在于“炫技”而在于- ✅ 用低成本技术解决真实职场信任问题- ✅ 把模糊的加班规则变成可执行代码- ✅ 展示区块链在非金融场景下的工程价值它不是万能的但能成为“加班争议的客观证据层”如果你愿意可以下一步- 改成 Web API 版本- 或 对接真实数据库- 或 改写为 Solidity 智能合约版本利用AI解决实际问题如果你觉得这个工具好用欢迎关注长安牧笛