本项目立项背景是美国国内物流行业中，中小型货主（Shipper）在寄件时面临运费不透明、需要在多个承运商（FedEx、UPS、USPS等）之间反复比价、下单流程繁琐等痛点。同时，承运商（Carrier）也缺乏高效的线上获客和订单管理渠道。Flexhaul.ai 作为一个B2B物流平台，旨在连接货主与承运商，提供一站式的比价、下单、追踪、理赔和计费服务，覆盖包裹快递（Parcel）和零担货运（LTL）两大业务场景，并集成了Amazon、领星ERP、易仓WMS等主流电商和仓储系统，服务于跨境电商及国内物流的业务背景。
项目包含以下核心功能模块：货主端——支持多承运商实时比价与报价、包裹/零担运单创建与管理、物流追踪、运费账单与历史、理赔提交与进度跟踪、取件调度、AI智能助手、批量报价工具；承运商端——提供多步骤入驻流程、运价管理、订单接单与管理、通过Stripe Connect实现自动分账与提现；管理后台——涵盖用户与承运商管理、全局运单监控、争议订单处理、理赔审核、GOFO/GreatWay承运商网络运价配置与对账、领星ERP集成与告警、博客内容管理、结算与归因分析等。整体平台的主要功能是为货主提供透明高效的物流比价下单体验，为承运商提供线上化的运营管理工具，为管理员提供全局业务监控与运营支撑能力
负责该项目前端的整体架构设计与核心功能开发。技术栈采用React 18 + TypeScript + Vite构建，使用Redux Toolkit管理全局状态（鉴权、用户信息、侧边栏等），TanStack Query（React Query v5）管理服务端数据缓存与同步，React Router实现基于角色的路由守卫与全量懒加载。UI层基于MUI封装了内部FH组件库（FHButton、FHTable、FHModal等），结合Styled Components实现主题定制。表单采用React Hook Form + Zod做校验。架构亮点包括：按领域划分的Feature-based目录结构、Axios拦截器统一鉴权与错误处理、Vite手动分包优化首屏加载、构建后自动生成SEO静态页面、Sentry全链路错误监控、30分钟无操作自动登出机制、以及Firebase鉴权+Stripe支付的完整集成。项目部署在Google App Engine上，开发流程通过Husky + Commitlint + ESLint + Prettier保障代码质量
评论