ernestoko/LCM

Liberty Cargo Movers Logistics Platform is designed to bring transparency, efficiency, accountability, and professionalism to international cargo operations between the United States, Ghana, and other supported destinations. # Liberty & Liberty Logistics — Logistics Platform A production-ready logistics management platform for **Liberty & Liberty Logistics** — global logistics and international shipping to and from the USA, to and from Ghana, and across Africa and the world (with multi-directional lanes for Liberia, Nigeria, Cameroon, Kenya, South Africa and beyond). Liberty **owns the platform, customer records and business intelligence**; an **operations partner performs cargo handling** (intake, manifests, dispatch) through controlled, role-scoped access, with pricing governed by approved rate cards. Customers self-serve — onboarding, pickup requests, ship-to-warehouse pre-alerts, package consolidation and tracking. > **New here? Read `SETUP.md` to install, configure Firebase, seed > data, and deploy.** ⚠️ Do not run `npm install` inside a Google Drive folder — > see the note at the top of `SETUP.md`. --- ## Tech stack | Layer | Choice | | --- | --- | | Framework | **Next.js 14** (App Router) + React 18 + TypeScript | | Styling | **Tailwind CSS** (custom Liberty brand palette), mobile-first PWA | | Database | **Cloud Firestore** (live `onSnapshot` listeners) | | Auth | **Firebase Auth** (email/password) + custom-claim RBAC | | Storage | **Firebase Storage** (package photos, ID docs, attachments) | | Server | Next.js **route handlers** + **Firebase Admin SDK** | | Notifications | **mNotify** SMS · email (Resend/SMTP/console) · in-app | | Hosting | Firebase App Hosting or Vercel | ## Key capabilities - **Role-based access control** for 6 roles — Liberty Super Admin, Liberty Admin/Ops, SEAL Admin, SEAL Staff, Finance, Customer — enforced in the UI **and** in Firestore security rules (defense-in-depth). - **SEAL rate-card engine** — item-based + weight-based pricing, configurable per-route service fee (waived for Nigeria), draft → pending → **Super-Admin approval** → active workflow, immutable active cards, full change/audit log. - **Automatic invoicing** from the active rate car …