Skip to content

About

A web application that allows users to book rides, send parcels, and manage transportation requests in a simple and convenient way.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

76 Commits

Folders and files

Repository files navigation

Marcus-Logistics-System

License Build Status Version .NET Contributions Welcome PRs Welcome Maintenance

A comprehensive web application that allows users to book rides, send parcels, and manage transportation requests in a simple and convenient way. Marcus Logistics System is designed to streamline your transportation and delivery needs, providing a seamless experience for both individual users and businesses.


📋 Table of Contents


📖 About the Project

Marcus Logistics System is an all-in-one transportation management platform built to address the growing needs of modern logistics. Whether you need to book a ride to the airport, send a parcel across town, or manage a fleet of delivery vehicles, Marcus Logistics System has you covered.

Our platform combines cutting-edge technology with user-friendly design to deliver:

  • Efficiency: Streamlined booking and management processes
  • Reliability: Real-time tracking and status updates
  • Flexibility: Support for various transportation and delivery needs
  • Scalability: Built to grow with your business

Built With


✨ Features

🚗 Ride Booking

  • Book rides instantly or schedule for later
  • Choose from various vehicle types (economy, standard, premium)
  • Real-time driver tracking
  • In-app messaging with drivers
  • Fare estimation before booking

📦 Parcel Delivery

  • Send packages of various sizes
  • Same-day and scheduled delivery options
  • Package tracking from pickup to delivery
  • Proof of delivery with signature capture
  • Insurance options for valuable items

📊 Transportation Management

  • Dashboard for managing all requests
  • Request history and analytics
  • Automated notifications and reminders
  • Multi-user account support
  • Role-based access control

🔐 Security & Reliability

  • Secure payment processing
  • Driver background verification
  • 24/7 customer support
  • Data encryption and privacy protection
  • Regular security audits

📱 User Experience

  • Intuitive and responsive design
  • Mobile-friendly interface
  • Dark/Light mode support
  • Multi-language support
  • Accessibility compliant

🚀 Getting Started

Follow these instructions to get a local copy of the project up and running.

Prerequisites

Before you begin, ensure you have the following installed:

Installation

  1. Clone the repository

    git clone https://github.com/ZamaTech/Marcus-Logistics-System.git
  2. Navigate to the project directory

    cd Marcus-Logistics-System
  3. Restore dependencies

    dotnet restore
  4. Update the database connection string

    Update the connection string in appsettings.json to match your SQL Server configuration.

  5. Apply database migrations

    dotnet ef database update
  6. Run the application

    dotnet run
  7. Open your browser

    Navigate to https://localhost:5001 or http://localhost:5000


💻 Usage

Booking a Ride

  1. Sign in to your account or create a new one
  2. Click on "Book a Ride" from the dashboard
  3. Enter your pickup and drop-off locations
  4. Select your preferred vehicle type
  5. Choose immediate pickup or schedule for later
  6. Confirm your booking and track your driver

Sending a Parcel

  1. Navigate to "Send Parcel" from the main menu
  2. Enter sender and recipient details
  3. Specify package dimensions and weight
  4. Select delivery speed and any additional services
  5. Review the quote and confirm
  6. Track your parcel in real-time

Managing Transportation Requests

  1. Access the "Dashboard" to view all active requests
  2. Use filters to sort by type, status, or date
  3. Click on any request to view details or take action
  4. Generate reports from the "Analytics" section

🗺️ Roadmap

  • Initial release with core features
  • Ride booking functionality
  • Parcel delivery system
  • Mobile application (iOS and Android)
  • Integration with third-party delivery services
  • AI-powered route optimization
  • Fleet management module
  • Corporate accounts and billing
  • API for external integrations

See the open issues for a full list of proposed features and known issues.


🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

How to Contribute

  1. Fork the Project
  2. Create your Feature Branch
    git checkout -b feature/AmazingFeature
  3. Commit your Changes
    git commit -m 'Add some AmazingFeature'
  4. Push to the Branch
    git push origin feature/AmazingFeature
  5. Open a Pull Request

Contribution Guidelines

  • Follow the existing code style and conventions
  • Write meaningful commit messages
  • Include tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting PR

📄 License

Distributed under the MIT License. See LICENSE for more information.


📞 Contact

ZamaTech - @ZamaTech

Project Link: https://github.com/ZamaTech/Marcus-Logistics-System


🙏 Acknowledgments


Made with ❤️ by ZamaTech

About

A web application that allows users to book rides, send parcels, and manage transportation requests in a simple and convenient way.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages