实战Node.js：构建功能完备的物流追踪系统

创作时间:

2025-01-22 01:07:51

作者:

@小白创作中心

实战Node.js：构建功能完备的物流追踪系统

随着电子商务的蓬勃发展，物流追踪系统已成为电商、仓储和配送等行业不可或缺的重要组成部分。一个高效、实时的物流追踪系统不仅能提升用户体验，还能优化供应链管理。本文将手把手教你使用Node.js和Express框架，结合MongoDB和Mongoose，搭建一个功能完备的实时物流追踪系统。

环境搭建

首先，确保你的开发环境中已经安装了Node.js。接下来，按照以下步骤初始化项目：

mkdir logistics-tracker
cd logistics-tracker
npm init -y

安装必要的依赖包：

npm install express mongoose body-parser

启动MongoDB数据库服务（确保你已经安装了MongoDB）：

mongod

数据库设计

在本系统中，我们将使用MongoDB存储订单信息，并通过Mongoose进行数据建模。在项目目录下创建models文件夹，并在其中创建order.js文件，定义订单模型：

// models/order.js
const mongoose = require('mongoose');

const orderSchema = new mongoose.Schema({
  orderNumber: { type: String, required: true, unique: true },
  customerName: { type: String, required: true },
  address: { type: String, required: true },
  status: {
    type: String,
    enum: ['Pending', 'Shipped', 'In Transit', 'Delivered'],
    default: 'Pending',
  },
  location: {
    type: {
      type: String,
      enum: ['Point'],
      default: 'Point',
    },
    coordinates: {
      type: [Number],
      default: [0, 0],
    },
  },
  createdAt: { type: Date, default: Date.now },
});

// 创建索引以支持地理位置查询
orderSchema.index({ location: '2dsphere' });

const Order = mongoose.model('Order', orderSchema);
module.exports = Order;

API开发

接下来，使用Express创建订单管理的RESTful API。在项目目录下创建routes文件夹，并在其中创建orders.js文件：

// routes/orders.js
const express = require('express');
const router = express.Router();
const Order = require('../models/order');

// 创建新订单
router.post('/create', async (req, res) => {
  try {
    const { orderNumber, customerName, address } = req.body;
    const newOrder = new Order({ orderNumber, customerName, address });
    await newOrder.save();
    res.status(201).json(newOrder);
  } catch (error) {
    res.status(500).json({ message: error.message });
  }
});

// 获取所有订单
router.get('/', async (req, res) => {
  try {
    const orders = await Order.find();
    res.json(orders);
  } catch (error) {
    res.status(500).json({ message: error.message });
  }
});

// 根据订单号获取订单状态
router.get('/:orderNumber', async (req, res) => {
  try {
    const order = await Order.findOne({ orderNumber: req.params.orderNumber });
    if (!order) return res.status(404).json({ message: '订单未找到' });
    res.json(order);
  } catch (error) {
    res.status(500).json({ message: error.message });
  }
});

// 更新订单状态
router.put('/update/:orderNumber', async (req, res) => {
  try {
    const order = await Order.findOne({ orderNumber: req.params.orderNumber });
    if (!order) return res.status(404).json({ message: '订单未找到' });

    order.status = req.body.status;
    await order.save();
    res.json(order);
  } catch (error) {
    res.status(500).json({ message: error.message });
  }
});

module.exports = router;

在主服务器入口文件server.js中引入路由：

// server.js
const express = require('express');
const bodyParser = require('body-parser');
const mongoose = require('mongoose');
const ordersRouter = require('./routes/orders');

const app = express();
app.use(bodyParser.json());

// 连接MongoDB数据库
mongoose.connect('mongodb://localhost:27017/logistics', {
  useNewUrlParser: true,
  useUnifiedTopology: true,
});

// 使用订单管理路由
app.use('/api/orders', ordersRouter);

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`服务器运行在 http://localhost:${PORT}`);
});

地图API集成

为了实现位置追踪功能，我们可以集成Google Maps API、Mapbox API或高德地图API。这里以Google Maps API为例，展示如何获取订单当前位置：

首先在Google Cloud Console中创建项目并启用Maps JavaScript API和Geocoding API。
在前端页面中引入Google Maps API：

<!DOCTYPE html>
<html>
<head>
  <title>物流追踪系统</title>
  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY"></script>
</head>
<body>
  <div id="map" style="height: 400px; width: 100%;"></div>
  <script>
    function initMap() {
      const map = new google.maps.Map(document.getElementById('map'), {
        center: { lat: -34.397, lng: 150.644 },
        zoom: 8,
      });

      // 假设我们已经通过API获取到了订单的地理位置信息
      const orderLocation = { lat: -34.397, lng: 150.644 };
      const marker = new google.maps.Marker({
        position: orderLocation,
        map: map,
        title: '包裹当前位置',
      });
    }

    initMap();
  </script>
</body>
</html>