freightdesk/COLLAB.md

FreightDesk — Collaboration Guide

Project Overview

Freight forwarding commission agent management platform. Stack: Node.js + Express + EJS + Supabase PostgreSQL.

Branch Strategy

• master — stable, production-ready
• agent-<name> — individual agent work branches
• Feature branches for specific features

Conventions

• Commit prefix: [OWL] or [AGENT-NAME] to identify who made changes
• EJS views: use partials/header.ejs and partials/footer.ejs includes
• CSS: government-app aesthetic (tricolor: saffron, white, green, navy)
• Routes: RESTful, all protected by requireAuth middleware
• DB: Supabase, use services/supabase.js client

Key Files

• src/server.js — Express app entry
• src/routes/ — Route handlers
• src/views/ — EJS templates
• src/public/css/style.css — Main stylesheet
• src/services/parser.js — WhatsApp message parser
• supabase/migrations/ — DB schema

Current Features

• Auth (username/password)
• Dashboard with stats
• Load CRUD + filters
• WhatsApp parser
• Payment tracking
• Shipper/vehicle management
• Reports

Pending / TODO

• Client portal (shipper/driver login)
• Invoice PDF generation
• React charts on dashboard
• WhatsApp parser improvements
• Mobile-responsive polish