[OWL] Add collaboration guide for multi-agent workflow
This commit is contained in:
parent
1a4eaaa040
commit
924a0381b3
1 changed files with 41 additions and 0 deletions
41
COLLAB.md
Normal file
41
COLLAB.md
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
# 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
|
||||
Loading…
Reference in a new issue