Skip to content
LogxFlow

LogxFlow

by Arnold F. Haban

A personal SaaS project in active development for logistics and fleet management.

Status: Work-In-Progress

LogxFlow ERP is built to assist companies in logistics and fleet management by providing real-time insights into operations, tools for route planning, and features for tracking inventory.

It seeks to minimize downtime with maintenance notifications, enhance delivery times through improved resource utilization, and streamline reporting with centralized dashboards — facilitating smoother and more informed decision-making as operations expand.

Currently a work in progress, this project reflects hands-on learning in creating scalable solutions for everyday supply chain needs.

Demo:

You can explore the interactive demo here. Please note this is a work-in-progress.

LogxFlow – Live Demo (WIP)

https://logxflow.hsbyte.org

Demo Credentials:

  • username: guest@example.com
  • password: password
Demo

GOAL

Develop a Dockerized full-stack ERP system for managing logistics, storage, delivery tracking, and invoicing of liquid products such as oil, fuel, milk, etc. with:

  • 3D real-time visualization of truck/trailer loads using React Three Fiber.
  • Backend powered by FastAPI and PostgreSQL.
  • Frontend built with React and TypeScript (Vite).
  • GitLab CI/CD compatible with ARM64 and AMD64.
  • Comprehensive developer documentation and mock data.

BACKEND

Framework: FastAPI (Python 3.11+)
DB/ORM: PostgreSQL + SQLAlchemy + Alembic
Auth: JWT + Refresh Tokens Validation: Pydantic
Features:

  • CRUD APIs for Users, Customers, Trucks, Trailers, Bill of Lading, Trailer Assignments, Invoices and other related entities.

    • Async routes for loading data and GPS updates.
    • /docs auto-generated OpenAPI.
    • Environment configs: .env per environment.
    • Delivery tracking mock: /docs/gps_mock_data.json.

Swagger:

Swagger-Demo

FRONTEND

Stack: React (Vite + TypeScript)
UI: Module SCSS
State: MobX Networking: Axios with JWT interceptors
Visualization: React Three Fiber R3F Testing: Vitest Testing Library
Features:

  • Pages and modules for Dashboard, Load Management, Truck and Trailer Assignments, Entity Administration, Bill of Lading, Invoices and other related entities.
    • Responsive Admin Dashboard + Map View
    • Live Delivery Tracker (mock GPS)
    • 3D Trailer Load Visualizer
    • Export visualization as PNG/SVG
    • Axios + MobX stores

DEVOPS

Containerization: Docker + Docker Compose
CI/CD: .gitlab-ci.yml pipeline → Lint → Test → Build → Deploy
Architectures: ARM64 + AMD64
Artifacts: Tagged containers, coverage reports, zipped source.

OUTPUT REQUIREMENTS

  • Project builds & runs fully (Docker).
  • Mock DB seeded automatically.
  • /docs OpenAPI available.
  • Include exported trailer visualization PNG/SVG snapshot.
  • Documentation (docs/ folder).

PROJECT EVOLUTION & OPTIMIZATION ROADMAP

I am committed to a roadmap of continuous improvement to ensure this SaaS remains high-performing, inclusive, and industry-compliant.

Performance & Speed

I am prioritizing infrastructure scalability to ensure a lightning-fast user experience. My upcoming updates will focus on optimizing Core Web Vitals, reducing server latency, and streamlining frontend assets for sub-second load times.

Accessibility (WCAG Compliance)

Inclusivity is a core focus of my development process. I am actively transitioning all UI components to meet WCAG 2.1/2.2 AA standards, specifically enhancing screen reader compatibility, keyboard navigation, and color contrast.

Technical SEO & Discoverability

To maximize organic reach, I am implementing a robust technical SEO framework. My next sprints will focus on structured data implementation, optimized metadata, and improved site architecture to ensure peak search engine visibility.

Industry Best Practices

I adhere to a philosophy of continuous refactoring. By aligning with the latest web governance standards, I will consistently update the codebase to ensure high security, maintainability, and clean UI/UX design patterns.

Current Status

I am currently conducting a comprehensive audit of the existing codebase to prioritize these enhancements. My focus is on sustainable, high-quality implementation rather than a fixed timeline, ensuring that each update provides a stable and polished experience for all users.