Skip to content

lmmoreira/tms

Repository files navigation

TMS

A Transportation Management System that automates quotation, order orchestration and volume tracking to reduce freight costs and improve on-time delivery for shippers and carriers.

Target customers

  • Shippers with medium to high shipment frequency
  • 3PLs and carriers needing centralized order orchestration
  • Commercial teams that price and sell transport services

Modules

  • Company — onboarding customers and partners with business configuration
  • Quotation — generate, compare and accept transport quotes
  • Shipment order — creation, assignment, tracking, delivery confirmation
  • Volume tracking — monitor capacity and utilization across time windows

Database Migrations

Database schema changes are managed via Flyway migrations in /infra/database/migration/. Migrations are applied automatically during docker compose up. See HELP.md for details.

High Level

graph TD
    Client((Client))
    PostgreSQLW[(Write-Database)]
    PostgreSQLR[(Read-Database)]
    RabbitMQ[[RabbitMQ]]
    
    Client -->|Sends Request| NGINX
    NGINX -->|Validated API Key| TMS
    NGINX -->|Returns Response| Client

    NGINX -->|Forward Bearer Token| OAuth2-Proxy
    OAuth2-Proxy -->|Forward Bearer Token| Keycloak
    Keycloak -->|Verify Token and Authenticate| OAuth2-Proxy
    OAuth2-Proxy -->|Send Authentication Response| NGINX
    NGINX -->|Forward Authenticated Request| TMS
    
    subgraph "TMS Modules"
        TMS -->|Accesses| CompanyModule
        TMS -->|Accesses| ShipmentOrderModule
    end

    CompanyModule -->|domain-event| RabbitMQ
    ShipmentOrderModule -->|domain-event| RabbitMQ
    CompanyModule -->|persistence| PostgreSQLW
    ShipmentOrderModule -->|persistence| PostgreSQLW
    CompanyModule -->|read| PostgreSQLR
    ShipmentOrderModule -->|read| PostgreSQLR
Loading

Glossary

For more detailed and technical information, please refer to the GLOSSARY.md file.

To Engineers

For more detailed and technical information, please refer to the HELP.md file.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages