CargoFlow

CargoFlow is a full-stack cargo management system for tracking shipments, managing vendors, routing deliveries, and handling logistics workflows.

Tech Stack

• Frontend: Vue 3
• Backend: Spring Boot
• Database: PostgreSQL
• Event Bus: Aiven Kafka
• Frontend Hosting: Vercel
• Backend Hosting: Render

Project Structure

.
├── client/  # Vue frontend
├── docs/    # Documentation
└── server/  # Spring Boot backend

System Overview

The application uses a layered backend, a Vue single-page app, PostgreSQL for persistence, and Kafka for event-driven updates.

flowchart TB
    subgraph Frontend [Frontend: Vercel]
        Vue[Vue.js SPA]
    end

    subgraph Backend [Backend: Render]
        Spring[Spring Boot Service]
    end

    subgraph Data [Database: PostgreSQL]
        PG[(PostgreSQL)]
    end

    subgraph Streaming [Event Bus: Aiven Kafka]
        Kafka[(Aiven Kafka)]
    end

    Vue --> Spring
    Spring --> PG
    Spring --> Kafka
    Kafka --> Spring

Loading

For implementation details, see ARCHITECTURE.md.

Getting Started

Prerequisites

• Java 17+
• Maven
• Node.js and Bun
• PostgreSQL

Backend

cd server
mvn clean install
mvn spring-boot:run

Frontend

cd client
bun install
bun run dev

Documentation

• ARCHITECTURE.md
• docs/