Home Blog Projects Resume Contact
Client Work

Contracts Management System

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
Stack
NestJSNext.jsPostgreSQLTypeORMRedisSocket.ioTurborepo
ContractFlow project thumbnail
01

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.
Role-based access control
02

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.
Automated expiry alerts
03

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.
Contract status tracking
04

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.
Direction hierarchy management
05

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.
Guided onboarding tour
06

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.
Vendor management