Portfolio / Learning Project • Static Dispatching MVP

Warehouse dispatch optimization, documented clearly.

Lift Nexus API is a Spring Boot backend MVP for warehouse dispatch optimization. It combines domain modeling, asynchronous job handling, PostgreSQL/Flyway persistence, integration testing, and Timefold-based constraint solving.

Explore Documentation API Reference Check Repo

Project Overview

This project was built to go beyond simple CRUD applications and explore how optimization can be integrated into a maintainable backend architecture.

  • Warehouse domain model with forklifts, load units, storage bins, and transport orders
  • Asynchronous dispatch jobs with status tracking
  • Constraint-based assignment planning with Timefold
  • PostgreSQL persistence, Flyway migrations, and integration testing

Tech Stack

Java 21 Spring Boot Timefold PostgreSQL Flyway Docker JUnit 5 Testcontainers

Project Documentation

Documentation pages describing the current system, architecture decisions, domain model, optimization approach, API usage, testing strategy, and roadmap.

🏠

Documentation Home

Start here for an overview of the project and the available documentation.

Docs
🏗️

Architecture

Learn about the modular monolith structure, module boundaries, and key architectural decisions.

Docs
📦

Domain Model

Understand forklifts, load units, storage bins, transport orders, and dispatch jobs.

Docs
🧠

Optimization Approach

See how Timefold is used for assignment planning and how constraints are structured.

Docs
🔌

API Usage

Follow the typical flow: prepare data, start a dispatch job, poll status, and inspect results.

Docs
🧪

Testing Strategy

Read about unit tests, integration tests with PostgreSQL/Testcontainers, and code quality checks.

Docs
⚠️

Known Limitations

See the current MVP scope, simplifications, and the areas that are intentionally still incomplete.

Docs
🗺️

Roadmap

See the current milestones and how the project is planned to evolve over time.

Docs

Generated Reports

Automatically generated documentation and reports from the current build pipeline.

📖

API Reference

Interactive OpenAPI documentation with request details and endpoint exploration.

Live Docs
📊

Test Coverage

JaCoCo coverage report showing which code paths are exercised by the test suite.

CI Report
📚

Javadoc

Generated class and method documentation for the current codebase.

CI Report
✅

Test Results

Surefire test output from the latest build, including executed tests and pass/fail results.

CI Report