Hammond：您的自托管车辆费用追踪系统

项目介绍

Hammond 是一款自托管的车辆费用追踪系统，旨在帮助用户管理和追踪与车辆相关的所有费用，包括燃油和其他开支。它支持多用户共享多车辆，是 Clarkson 项目的逻辑继承者。Hammond 由资深开发者 Akhil Gupta 开发，目前版本为 2022.07.06。

项目技术分析

技术栈

• 后端：使用 Go 语言开发，采用了 Go-Gin 框架和 GORM 数据库操作库。
• 数据库：SQLite，轻量级且易于管理。
• 前端：Vue.js 框架，结合 Vuex 状态管理和 Buefy UI 组件库，提供流畅的用户体验。

架构设计

Hammond 最初设计为 NestJS 后端，但为了减小容器体积，最终选择了 Go 语言重写后端。项目采用单容器设计，简化了部署和维护的复杂性。

项目及技术应用场景

应用场景

• 个人用户：管理个人车辆的燃油和维护费用。
• 家庭用户：多用户共享车辆，共同管理费用。
• 小型车队管理：追踪和管理多辆车的费用。

技术应用

• Docker 部署：推荐使用 Docker 容器部署，简化安装和更新流程。
• 自托管：适合有一定技术基础的用户，可以在本地或私有服务器上部署。

项目特点

主要功能

• 数据迁移：支持从 Clarkson 项目迁移数据。
• 多车辆管理：添加和管理多辆车辆。
• 多用户支持：支持多用户共享车辆。
• 费用追踪：记录燃油和其他车辆相关费用。
• 附件管理：保存与车辆相关的附件。
• 快速录入：通过拍照快速记录费用。
• 报告生成：生成车辆级别和整体费用报告。
• 数据导入：支持从 Fuelly 等应用导入数据（更多应用即将支持）。

安装与使用

Docker 安装

docker run -d -p 3000:3000 --name=hammond akhilrex/hammond

Docker-Compose 安装

version: '2.1'
services:
  hammond:
    image: akhilrex/hammond
    container_name: hammond
    volumes:
      - /path/to/config:/config
      - /path/to/data:/assets
    ports:
      - 3000:3000
    restart: unless-stopped

源码构建

对于不熟悉 Docker 的用户，Hammond 也提供了源码构建的指南，详见 Ubuntu 安装指南。

开发者支持

Hammond 是一个开源项目，欢迎开发者贡献代码。项目采用 GPL-3.0 许可证，确保了代码的自由使用和分发。

结语

Hammond 不仅是一个功能强大的车辆费用追踪系统，更是一个开源社区的结晶。无论您是个人用户还是车队管理者，Hammond 都能为您提供高效、便捷的车辆费用管理解决方案。立即访问 Hammond 项目主页，开始您的车辆管理之旅吧！