2023-08-09 22:21:28 +00:00
|
|
|
## About The Project
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
Hammond is a self hosted vehicle management system to track fuel and other expenses related to all of your vehicles.
|
|
|
|
|
It supports multiple users sharing multiple vehicles.
|
|
|
|
|
It is the logical successor to Clarkson which has not been updated for quite some time now.
|
|
|
|
|
This repo is again a fork of akhilrex's great [project](https://github.com/akhilrex/hammond).
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
### Motivation and Developer Notes
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
As mentioned, this project is a fork of akhilrex's [project](https://github.com/akhilrex/hammond) which is no longer active.
|
|
|
|
|
To prevent the same from happeing to this project, we are seeking to add more maintainers/collaborators who have access to merge PRs.
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
We are trying our best to update with new features and feedback is very welcome.
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
The project is written using Go for the backend and Vuejs for the front end.
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
### Built With
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
- [Go](https://golang.org/)
|
|
|
|
|
- [Go-Gin](https://github.com/gin-gonic/gin)
|
|
|
|
|
- [GORM](https://github.com/go-gorm/gorm)
|
|
|
|
|
- [SQLite](https://www.sqlite.org/index.html)
|
|
|
|
|
- [VueJS](https://vuejs.org/)
|
|
|
|
|
- [Vuex](https://vuex.vuejs.org/)
|
|
|
|
|
- [Buefy](https://buefy.org/)
|
|
|
|
|
|
|
|
|
|
#### Fresh setup
|
|
|
|
|
|
|
|
|
|
You will have to provide your name, email and password so that an admin user can be created for you.
|
|
|
|
|
|
|
|
|
|
Once done you will be taken to the login page.
|
|
|
|
|
|
|
|
|
|
Go through the settings page once and change relevant settings before you start adding vehicles and expenses.
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
Distributed under the GPL-3.0 License. See `LICENSE` for more information.
|
|
|
|
|
|
|
|
|
|
## Roadmap
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
- [ ] More reports
|
|
|
|
|
- [ ] Vehicle specific reminders (servicing etc)
|
|
|
|
|
- [ ] Native installer for Windows/Linux/MacOS
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
## Contact
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
Project Link: [https://github.com/AlfHou/hammond](https://github.com/AlfHou/hammond)
|
2023-04-17 21:41:51 +00:00
|
|
|
|
2023-08-09 22:21:28 +00:00
|
|
|
[product-screenshot]: images/screenshot.jpg
|
