ContractsFlow contract management app
The port’s contracts, vendors and deadlines, tracked live.
The need
The port’s departments needed one place for contracts and agreements, a clear view of every vendor, and no more missed deadlines.
What we built
An internal app in French, by role (admin, employee, legal), that works out each contract’s status and warns the team before it expires.
- Next.js
- NestJS
- PostgreSQL
- Redis
- Socket.io
The results
- 300+
- vendors
- 30, 7, 1
- days before expiry: an alert each time
- 6
- contract statuses worked out from the dates
What the app does, screen by screen
Built and delivered from August to October 2023, two months.
ContractFlow project thumbnail
- Internal contract and convention management platform built for a client's departments.
- Centralizes vendor relationships, execution statuses, deadline visibility, and role-based workflows.
- Built with NestJS, Next.js, PostgreSQL, Redis, Socket.io, and Turborepo.
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
- 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
- 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
- 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
- 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
- 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.
A project like this one?
Describe it in two lines on WhatsApp, and we reply directly.
Next projectTechEco DZ