Client Work

ContractsFlow

Real-time dashboard for Béjaïa's harbor company with Clean Architecture, DDD, and Redis Pub/Sub to horizontally scale WebSockets. Full unit & integration test coverage.

Role
Full-stack developer
Timeline
Aug 2023 – Oct 2023
Stack
NestJS, Next.js, PostgreSQL, TypeORM, Redis, Socket.io, Turborepo

GitHub

ContractFlow project thumbnail
Role-based access control

Role-based access control

  • Supports Admin, Employee, and Juridical user flows with scoped access.
  • Protects contract operations by role instead of exposing one flat dashboard.
  • Fits the client's multi-department contract approval and oversight model.
Automated expiry alerts

Automated expiry alerts

  • Sends 30/7/1-day expiry alerts without manual follow-up.
  • Daily cron emits domain events that become Redis-brokered Socket.io notifications.
  • Gives juridical staff earlier deadline awareness across active agreements.
Contract status tracking

Contract status tracking

  • Computes 6 contract statuses from date fields instead of storing stale state.
  • Covers the lifecycle from NOT_EXECUTED to EXECUTED_WITH_DELAY.
  • Lets managers monitor execution state without manual status maintenance.
Direction hierarchy management

Direction hierarchy management

  • Models directions, departments, and internal ownership boundaries.
  • Makes contract visibility match the organization structure.
  • Supports multi-department oversight from one central platform.
Guided onboarding tour

Guided onboarding tour

  • Helps internal users understand the dashboard without training overhead.
  • Introduces core contract, vendor, alert, and status workflows in context.
  • Reduces friction for non-technical staff using the system.
Vendor management

Vendor management

  • Centralizes 300+ vendor records and their related agreements.
  • Connects vendor relationships to contract oversight and execution tracking.
  • Gives staff one place to inspect supplier context before acting.

Implementation notes

  • Built a real-time contracts and organizational management dashboard for juridicals, employees and admins at BMT
  • Designed the backend using NestJS, Clean Architecture and Domain Driven Design (DDD)
  • Used Redis Pub/Sub for horizontal scaling of WebSockets for real-time state sync
  • Developed Feature-Sliced Next.js frontend with unit and integration tests

Featured Projects

  • Open Source

    8086 Processor Web Emulator

    Open-source Intel 8086 emulator and assembler for the browser (Vanilla JS), built as a second year university project in a team of 6, featuring instruction set simulation and interactive debugging.

    • JavaScript
    • HTML
    • CSS
  • Thesis Project

    IMRaD Analyzer: Distributed Microservices for Scientific Text Classification

    An 8-node microservices platform leveraging BERT and Gemini Pro to classify scientific papers, using a custom 169k-sentence dataset to achieve a 98.21% peak F1-score.

    • Next.js
    • FastAPI
    • BERT
    • Gemini Pro
    • TF Serving

Let's work together

I'm currently open to new roles, remote-first or international. If you're building something ambitious, I'd love to hear about it.

Get in TouchLinkedIn