小企业信息化系统开发
小微企业用 Kimai 搭建工时与项目成本核算系统:打卡、费率、报表与导出实战
2026年11月21日
用 Kimai 落地工时记录、费率建模、毛利报表与客户对账
小微企业用 Kimai 搭建工时与项目成本核算系统:打卡、费率、报表与导出实战
安装队、设计工作室、软件外包团队最常见的账,不是记不住收入,而是算不清"这单到底赚了多少"。Excel 里散着打卡表、报销单和合同报价,月底对不上工时是常态。Kimai 是开源的工时追踪工具,能把客户、项目、活动、费率和成本串成一条链,部署在自家服务器上即可用。
先明确它能解决什么
Kimai 的核心模型是"用户—客户—项目—活动—时间记录"。一条记录包含谁、为哪个客户、在哪个项目、做了什么活动、起止时间和费率。有了这层结构,才能按客户出对账单、按项目看毛利、按成员看产能。它不替代财务软件,也不做考勤打卡机,定位是把"人力投入"变成可核算的数据。
部署与初始化
用 Docker Compose 起 MariaDB 和 Kimai,注意端口只绑本地,域名访问交给 Nginx 反代:
services:
db:
image: mariadb:10.11
environment:
MARIADB_ROOT_PASSWORD: change-me
MARIADB_DATABASE: kimai
MARIADB_USER: kimai
MARIADB_PASSWORD: change-me
volumes: ["./db:/var/lib/mysql"]
kimai:
image: kimai/kimai2:apache
depends_on: [db]
environment:
APP_ENV: prod
DATABASE_URL: "mysql://kimai:change-me@db:3306/kimai?charset=utf8mb4"
TRUSTED_HOSTS: "^kimai\\.example\\.com$"
ports: ["127.0.0.1:8080:8000"]
volumes: ["./data:/opt/kimai/var/data"]
首次启动后进容器执行 bin/console kimai:install -n 建表并创建管理员,登录第一件事就是改默认密码。三个高频坑:数据库密码含 @ # 等符号必须 URL 编码,否则连接失败;TRUSTED_HOSTS 要和实际访问域名正则一致,不匹配会直接报 400;服务器时区若是 UTC,跨零点记录会错一天,要在用户设置里统一为 Asia/Shanghai。
建模:先定活动与费率,再让人用
不要一上来就建几十个项目。建议先建 5–8 个标准活动:现场安装、远程调试、方案设计、售后响应、差旅、内部会议。每个活动设默认小时费率,差旅单独设成"不计费或成本价"。客户对应甲方,项目对应一份合同或一张工单,工单号和设备序列号可作为自定义字段加上,导出报表时非常有用。
权限按角色收口:普通成员只看和登记自己的记录,组长看本组,管理员维护费率与客户。务必不要让业务人员拿到超级管理员权限,否则费率可随意改动,成本核算就失去意义。已审批的月份用期间锁定功能关掉,避免事后被"补录"改写。
日常使用:计时器与补录的边界
现场作业适合用计时器:到点位点开始,离开点暂停,中途等待客户签字就暂停,避免把非工作时间算进去。办公室工作常用补录,颗粒度控制在 15 分钟,描述写清"地点 + 对象 + 结果",例如"客户机房,交换机固件升级,已验证端口转发正常"。描述规范比功能强大更重要,否则对账时客户不认。
移动端不必装 App,把 Kimai 页面"添加到主屏幕"即可。网络差的现场先暂停记录,等有网再导出或补录,不要让页面长时间挂起。
报表与对账
报表按客户、项目、活动三个维度筛选,导出 CSV 后在表格里做透视:收入等于计费时长乘费率,成本用内部成本率另算,两者之差除以收入就是项目毛利率。建议每月固定跑一次"已锁定期间的客户汇总",和客户确认后导出对账单。需要发票时可用导出模板或发票插件,注意含税与未税口径统一,别把税率藏进费率里。
维护清单
- 备份要包含数据库和
var/data目录,只备份数据库会丢附件和上传文件。 - 反代改域名后同步修改
TRUSTED_HOSTS并重启容器。 - 配好 SMTP,否则审批与提醒邮件会静默丢失。
- 每季度清理一次未使用的项目,防止成员选错归属。
小结
Kimai 的价值不在于"打卡",而在于把每个项目的人力投入变成结构化数据。先把活动和费率定准,再约束权限与描述规范,月底的毛利核算和客户对账自然就有据可查。