Skip to content

arvl130/rrg-freight-services-web

Repository files navigation

🚚 Package Tracking System for RRG Freight Services

Screenshot of the home page Screenshot of the Admin dashboard page

This is the package tracking system for RRG Freight Services—a logistics company from North Fairview, Quezon City.

This project is developed as a capstone project, in compliance with the requirements of CAP101 and CAP102 subject of the Bachelor of Science in Information Technology program of Quezon City University.

The driver app is available here.

Features

  • GPS-based location tracking and route optimization
  • Delivery time estimation and precise location search
  • Automatic load planning for delivery vehicles
  • Optimized batching and dispatch of packages
  • Capacity planning and monitoring for warehouses
  • Automated status updates and reminders
  • Secure sign in with biometrics and FIDO2 security keys

Tech Stack

Setup

This project requires at least Node.js v20 to be installed and uses pnpm for package management.

You will need a running PostgreSQL database and a Firebase project with Cloud Storage configured for object storage.

Take the following steps to setup this project:

  1. Clone this repository.
$ git clone https://github.com/arvl130/rrg-freight-services-web.git
  1. Install the project dependencies.
$ cd rrg-freight-services-web
$ pnpm install
  1. Setup the API keys and database secrets.
$ cp .env.template .env
$ vi .env # type :wq! to exit
  1. Obtain a copy of the seed script and save it as db-seed.ts in the scripts folder.

  2. Push the schema to the database and run the seeder.

$ pnpm db:push

This command may fail if your database has existing tables.

  1. Run the project.
$ pnpm dev
  1. Build for production. (optional)
$ pnpm build

License

This project is licensed under the MIT License.

Copyright © 2023 Angelo Geulin, Wally Boy Gaynor, Arlene Joy Nacion, Florence Gobilab, Rommel Rivera