# 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