孙亮亮
返回 小企业信息化系统开发

小企业信息化系统开发

小微企业用 Kimai 搭建工时与项目成本核算系统:打卡、费率、报表与导出实战

2026年11月21日

用 Kimai 落地工时记录、费率建模、毛利报表与客户对账

小微企业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 的价值不在于"打卡",而在于把每个项目的人力投入变成结构化数据。先把活动和费率定准,再约束权限与描述规范,月底的毛利核算和客户对账自然就有据可查。

本模块其他文章

小微企业自建企业邮箱实战:Mailcow 部署、SPF/DKIM/DMARC 与反垃圾邮件配置小微企业自建 CRM 客户管理实战:用 EspoCRM 落地线索跟进与销售漏斗小微企业用 Snipe-IT 搭建 IT 资产与设备台账管理:采购入库、领用归还、折旧与盘点实战小微企业用 Taiga 搭建敏捷项目管理:需求池、看板与迭代冲刺实战小微企业用 Stirling-PDF 自建 PDF 工具箱:合并拆分压缩水印 OCR 与本地化部署避坑小微企业自建在线文档协作实战:用 OnlyOffice 替代 Office、多人编辑与权限管控小微企业自托管团队即时通讯:用 Rocket.Chat 搭建内部沟通、频道分组与 Webhook 机器人小微企业用 Jitsi Meet 自建视频会议系统:Docker Compose 部署、JWT 鉴权与 TURN 穿透安全接入小微企业内部系统统一登录实战:Authelia 单点登录、MFA 与反向代理访问控制小微企业用 Paperless-ngx 搭建智能文档归档系统:发票合同 OCR 识别、标签检索与权限管理小微企业用 PostgREST 把 PostgreSQL 直接变成 REST API:只读接口、行级权限与内部数据对接小微企业用 Uptime Kuma 自建服务监控与宕机告警:网站、接口、SSL 证书与心跳检测小微企业用 Gitea 自建内网代码与文档版本管理:Git 服务、Issues 跟踪与 Webhook 自动部署小微企业用 FreeScout 自建客服工单系统:邮件转工单、SLA 与协作回复实战小微企业用 Odoo 搭建一体化 ERP:进销存、CRM 与财务模块落地实战小微企业用 Nextcloud 自建企业网盘:文件同步、权限分级与异地容灾小微企业用 Metabase 做业务数据分析:连接数据库、可视化图表与定时报表小微企业内部知识库搭建实战:用 Wiki.js 实现文档协作、权限分级与全文检索小微企业用 Appsmith 搭建零代码内部管理后台:数据看板、工单与权限小微企业用 n8n 搭建业务自动化工作流:表单收集到消息通知实战小微企业用 Docker + NocoDB 搭建轻量业务数据库:零代码管理客户与订单小企业进销存轻量化落地:用 SQL + 轻量 Web 替代 Excel 的实操路径小企业业务系统数据备份实战:从每日自动备份到异地容灾小企业自建系统的权限设计实战:从“谁都能改”到 RBAC 与数据范围隔离小企业库存管理怎么起步:从 Excel 到轻量进销存的平滑迁移从 Excel 进销存到一套能演进的系统小企业 CRM:买现成还是自己搭?
小微企业用 Kimai 搭建工时与项目成本核算系统:打卡、费率、报表与导出实战 · 孙亮亮