https://github.com/grayoj/boardend
A microservice for a logistics application in Java.
https://github.com/grayoj/boardend
Last synced: 11 months ago
JSON representation
A microservice for a logistics application in Java.
- Host: GitHub
- URL: https://github.com/grayoj/boardend
- Owner: grayoj
- Created: 2024-01-06T14:09:46.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-06T14:10:05.000Z (over 2 years ago)
- Last Synced: 2025-06-06T06:30:24.275Z (about 1 year ago)
- Language: Java
- Size: 102 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Logistics
Have you ever heard the saying "if it works, don't break it?" Maybe I just invented that to excuse some awful code? Haha. But it works.
> It's not really awful code per-say. I intend to clean it up and re-organize it in my free time.
This is an open-sourced Spring Boot + Java microservice that could be used to power a logistics application.
## Features
- Authenticate Users, Riders and Companies via JWT.
- OTP Verification via Email.
- Approve Company accounts before onboarding. You can extend the API to an admin interface.
- Companies can onboard riders, and supply them login credentials.
- Paystack Integration on creating a delivery. Option for Cash.
- Riders being able to accept, pickup, cancel and order. Fundamentally some tweaked CRUD operations.
- API to supply reports, analytics to the companies on deliveries being done.
- Sending receipts and confirmation emails.
So much stuff, really. I cannot cover it all.
## The Stack
- Java 19
- Maven for managing dependencies.
- Spring Boot
- Postgres
- Docker
## Setup
- Clone this current repository.
- Next `cd boardend`
- Run `docker-compose up`
- Access the application on port 5000.
- Have fun.
## Contributing
Feel free, MIT License anyway.