This Luggage Management System is designed to facilitate the management of luggage for trips, particularly in the context of bus transportation services. It enables the recording and billing of luggages associated with specific customers and trips.
This is designed for transportation companies offering bus services, and some of its features are listed below:
-
Customer Management: Allows the creation and management of customer profiles.
-
Bus Management: Facilitates the addition and management of bus details, including plate numbers and driver information.
-
Trip Management: Enables the creation and scheduling of trips, specifying departure, destination, and date of journey amongst other relevant information.
-
Luggage Recording: Record luggage details such as weight, type, and quantity associated with specific trips and customers.
- Billing: Generates bills for luggage based on weight categories and quantities for the traveling customers.
Staff members of the bus company will be assigned to make use of the administrative interface to manage luggage-related data, and also register customer details.
For every intending customer that wants to travel, the admin staff will record the details of whatever luggage the customer intends to carry alongside the trip information and bus they are scheduled to go with. This will generate a luggage bill for the intending passenger to know the cost for their luggages.
- Django: This Python web framework is used for building the backend logic, including models for storing customer and luggage-related data. The in-built Django Admin Interface is the primary interface used to manage the functionalities of this application.
Follow the steps below to get the program working on your system locally. These steps are tailored for users developing on Linux OS with Python installed already.
-
Clone the repo
git clone https://github.com/Pythonian/django_luggage.git
-
Change into the directory of the cloned repo
cd django_luggage
-
Setup a Python virtual environment and activate it
make venv source venv/bin/activate
-
Install project requirements
make install
-
Copy and edit environment variables with desired values
cp .env.example .env
-
Run database migrations
make migrate
-
Create an admin superuser
make admin
Note: Use
admin
for both theusername
andpassword
, and skip entering theemail
. Also typey
to bypass Password validation. -
Populate the database with fake data (Optional)
make populatedb
-
Run the development server
make run
-
Visit the Admin dashboard in your browser, and login with the credentials created in step (7)
127.0.0.1:8000/admin/
To run tests, run the following command
make test
Contributions are always welcome! Any contributions you make are greatly appreciated.
If you have a suggestion that would make this project better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
If you encounter any bug or problem while using the project, please open an issue
This project is licensed under the MIT License.
If you have any questions, suggestions, or feedback, feel free to reach out to me
Seyi Pythonian - @Ajibel - seyipythonian@gmail.com