Qolee

Qolee TMS AI

Monorepo project using Nx, following Domain-Driven Design (DDD) principles.

📌 Description

Qolee TMS AI is a modular, domain-driven application built using the Nx monorepo structure. It combines an Angular frontend and a NestJS backend, supported by MongoDB. The purpose of this project is to serve as a scalable, maintainable foundation for a Transport Management System enhanced with AI capabilities.

  • Frontend: Angular
  • Backend: NestJS
  • Database: MongoDB

Note: Most business logic is implemented in reusable libraries and not in application folders directly.

🚀 Getting Started

To get started as a developer:

1. Clone the repository

Example :
git clone https://github.com/ORCHIS-INTERNATIONAL/qolee-tms-ai.git
cd qolee-tms-ai

2. Install dependencies

Example :
npm install

3. Explore the project graph

Example :
npx nx graph

4. Serve an application

Example :
npx nx serve <app-name>

📁 Folder Structure

Folder Description
apps/ Entry-point applications acting as simple executors or launchers for microservices. No business logic here, only the app modules adapted for deployment and scaling needs. Allows flexible microservice boundaries and rapid creation of new microservices if needed.
libs/ Core business domain code organized by bounded contexts, aggregates, and functional zones. Independent from microservice technical boundaries, this is where domain logic lives and evolves purely by business needs. Developers spend most of their time here.
shared/ Utilities and cross-domain libraries dedicated to reusable technical assets such as constants, DTOs, types, helpers, shared styles, and common service clients. Organized for ease of use, not strictly layered.

Subfolders inside each of these are illustrative and may evolve as the architecture gets refined.

✅ Useful Commands

  • Generate a library

    Example :
    npx nx g @nx/js:lib libs/my-lib

  • Build a project

    Example :
    npx nx build <project-name>

  • Run tests

    Example :
    npx nx test <project-name>

  • Check affected projects

    Example :
    npx nx affected:graph

📄 License

This project is proprietary and not open source. All rights reserved by ORCHIS INTERNATIONAL.

👤 Authors

  • Razafindramiarina Etienne – Initial work

🔮 Project Status

This project is actively maintained. Architecture is evolving.

results matching ""

    No results matching ""