Skip to content
Ayman NABIH edited this page Sep 19, 2026 · 3 revisions

GitDock Platform — Wiki

GitDock is a multi-tenant SaaS platform that centralises and analyses Git contributions. It is built as twelve polyglot microservices — Spring Boot, FastAPI, ASP.NET Core and Symfony — with an applied-AI layer: a multi-agent RAG assistant and a real-time security audit of commit diffs.

The README explains how to install and deploy the platform. This wiki explains what it does, how it is built, and why.

Academic project. Built as a fourth-year engineering project at EHEIM Oujda (2025–2026).


Contents

Page What you will find
What GitDock does The problem, the users, and the end-to-end workflow: from sign-up to a commit audited in real time
Architecture The services, how they talk (HTTP, RabbitMQ, Kafka, WebSocket), where the data lives, and the sequence diagrams of the main flows
Design patterns Every pattern the code actually uses — saga, circuit breaker, event-driven messaging, strategy, decorator, RAG, semantic routing… — where it lives and why it was chosen
AI services YAM (multi-agent RAG), Sentinel (diff audit), anomaly detection and task-risk prediction, in detail
CI/CD The GitHub Actions pipelines, the security checks, the supply-chain rules and the list of pinned actions

At a glance

flowchart LR
    U(("Users")) --> FE["Vue 3 frontend"]
    FE --> GW["API Gateway"]
    GW --> CORE["Core services<br/>auth · project · sync · task<br/>gamification · notification"]
    GW --> AI["AI services<br/>YAM · Sentinel"]
    GH(("GitHub")) -->|webhooks| CORE
    CORE <-->|events| MQ[["RabbitMQ"]]
    CORE -->|commit stream| K[["Kafka"]]
    K --> AI
    AI <--> V[("ChromaDB")]
    AI --> LLM["Ollama → Gemini"]
Loading
Services 12, in four languages
Messaging RabbitMQ (business events), Kafka (commit stream)
Storage PostgreSQL, MySQL, MongoDB, Redis, ChromaDB
AI RAG, multi-agent routing, LLM cascade (local first), classical ML
Delivery Docker Compose, GitHub Actions, images published to GHCR

About the diagrams

Most diagrams on these pages are written in Mermaid and follow the code as it stands. The UML and sequence diagrams shown as images come from the project report, and their labels are in French.


Ayman NABIH — github.com/NABIHAyman · linkedin.com/in/nabihayman · nabih.ayman.ai@gmail.com

Clone this wiki locally