Skip to content

A modern shipping and logistics management system built with Angular and Spring Boot. This application streamlines shipping operations and enhances customer experience through digital tracking services.

Notifications You must be signed in to change notification settings

alexistdev/mykurir

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MyKurir - Shipping Management System

A modern shipping management system with integrated tracking capabilities.

Features

  • Package tracking system
  • Shipment management
  • User authentication and authorization
  • RESTful API integration

Technology Stack

Frontend

  • Angular 15
  • Porto Admin Template

Backend

  • Spring Boot 3
  • Java JDK 21
  • MySQL Database

Installation Guide

Frontend Setup

  1. Install dependencies:
      npm install
  2. Start development server:
      ng serve

The application will be available at http://localhost:4200

Backend Setup

  1. Create an empty MySQL database named mykurir

  2. Configure database credentials in src/main/resources/application.properties:

      spring.datasource.username=your_username
      spring.datasource.password=your_password
  3. Start the Spring Boot application:

      bash mvn spring-boot:run

The server will start at http://localhost:8082

Initial Admin Setup

  1. Create an admin account using the registration API http://localhost:8082/v1/api/auth/register method POST:
      {
        "fullName": "Admin Name",
        "email": "admin@example.com",
        "password": "your_password"
      }
  2. Update the user role to ADMIN in the database

API Authentication

  • The API uses Basic Authentication
  • Configure your API client (Insomnia/Postman) with the registered email and password
  • Include the authentication header in all API requests

API Documentation

The following endpoints are available:

  • Authentication APIs
  • Shipping Management APIs
  • Tracking APIs
  • User Management APIs

For detailed API documentation, please refer to the API specification in your Insomnia/Postman client.

License

[License Type] - See LICENSE.md for details

Contact

For support or queries, please open an issue in this repository.

About

A modern shipping and logistics management system built with Angular and Spring Boot. This application streamlines shipping operations and enhances customer experience through digital tracking services.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •