41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
# 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
|