小程序开发-服务端

9.0 KiB

Raw Permalink Blame History

收货信息设计方案

概述

本文档详细说明了电商系统中收货信息的设计方案，采用地址快照 + 地址引用混合模式，确保订单收货信息的完整性和一致性。

设计原则

数据一致性：用户下单时保存收货地址快照，避免后续地址修改影响历史订单
用户体验：自动读取用户默认地址，减少用户输入
灵活性：支持用户在下单时临时修改收货信息
可追溯性：保留地址ID引用关系，便于数据分析和问题排查

数据库设计

1. 用户地址表 (shop_user_address)

CREATE TABLE `shop_user_address` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `name` varchar(100) DEFAULT NULL COMMENT '姓名',
  `phone` varchar(20) DEFAULT NULL COMMENT '手机号码',
  `country` varchar(50) DEFAULT NULL COMMENT '所在国家',
  `province` varchar(50) DEFAULT NULL COMMENT '所在省份',
  `city` varchar(50) DEFAULT NULL COMMENT '所在城市',
  `region` varchar(50) DEFAULT NULL COMMENT '所在辖区',
  `address` varchar(500) DEFAULT NULL COMMENT '收货地址',
  `full_address` varchar(500) DEFAULT NULL COMMENT '完整地址',
  `lat` varchar(50) DEFAULT NULL COMMENT '纬度',
  `lng` varchar(50) DEFAULT NULL COMMENT '经度',
  `gender` int(11) DEFAULT NULL COMMENT '1先生 2女士',
  `type` varchar(20) DEFAULT NULL COMMENT '家、公司、学校',
  `is_default` tinyint(1) DEFAULT 0 COMMENT '默认收货地址',
  `sort_number` int(11) DEFAULT NULL COMMENT '排序号',
  `user_id` int(11) DEFAULT NULL COMMENT '用户ID',
  `tenant_id` int(11) DEFAULT NULL COMMENT '租户id',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '注册时间',
  PRIMARY KEY (`id`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_is_default` (`is_default`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='收货地址';

2. 订单表收货信息字段 (shop_order)

-- 订单表中的收货信息字段
`address_id` int(11) DEFAULT NULL COMMENT '收货地址ID（引用关系）',
`address` varchar(500) DEFAULT NULL COMMENT '收货地址快照',
`real_name` varchar(100) DEFAULT NULL COMMENT '收货人姓名快照',
`address_lat` varchar(50) DEFAULT NULL COMMENT '地址纬度',
`address_lng` varchar(50) DEFAULT NULL COMMENT '地址经度',

业务流程设计

1. 下单时收货地址处理流程

flowchart TD
    A[用户下单] --> B{前端是否传入完整地址?}
    B -->|是| C[使用前端传入地址]
    B -->|否| D{是否指定地址ID?}
    D -->|是| E[根据地址ID获取地址]
    E --> F{地址是否存在且属于当前用户?}
    F -->|是| G[使用指定地址]
    F -->|否| H[获取用户默认地址]
    D -->|否| H[获取用户默认地址]
    H --> I{是否有默认地址?}
    I -->|是| J[使用默认地址]
    I -->|否| K[获取用户第一个地址]
    K --> L{是否有地址?}
    L -->|是| M[使用第一个地址]
    L -->|否| N[抛出异常：请先添加收货地址]
    C --> O[创建地址快照]
    G --> O
    J --> O
    M --> O
    O --> P[保存订单]

2. 地址优先级

前端传入的完整地址信息（最高优先级）
指定的地址ID对应的地址
用户默认收货地址
用户的第一个收货地址
无地址时抛出异常

核心实现

1. 收货地址处理方法

/**
 * 处理收货地址信息
 * 优先级：前端传入地址 > 指定地址ID > 用户默认地址
 */
private void processDeliveryAddress(ShopOrder shopOrder, OrderCreateRequest request, User loginUser) {
    // 1. 如果前端已经传入了完整的收货地址信息，直接使用
    if (isAddressInfoComplete(request)) {
        return;
    }

    // 2. 如果指定了地址ID，获取该地址信息
    if (request.getAddressId() != null) {
        ShopUserAddress userAddress = shopUserAddressService.getById(request.getAddressId());
        if (userAddress != null && userAddress.getUserId().equals(loginUser.getUserId())) {
            copyAddressToOrder(userAddress, shopOrder, request);
            return;
        }
    }

    // 3. 获取用户默认收货地址
    ShopUserAddress defaultAddress = shopUserAddressService.getDefaultAddress(loginUser.getUserId());
    if (defaultAddress != null) {
        copyAddressToOrder(defaultAddress, shopOrder, request);
        return;
    }

    // 4. 如果没有默认地址，获取用户的第一个地址
    List<ShopUserAddress> userAddresses = shopUserAddressService.getUserAddresses(loginUser.getUserId());
    if (!userAddresses.isEmpty()) {
        copyAddressToOrder(userAddresses.get(0), shopOrder, request);
        return;
    }

    // 5. 如果用户没有任何收货地址，抛出异常
    throw new BusinessException("请先添加收货地址");
}

2. 地址快照创建

/**
 * 将用户地址信息复制到订单中（创建快照）
 */
private void copyAddressToOrder(ShopUserAddress userAddress, ShopOrder shopOrder, OrderCreateRequest request) {
    // 保存地址ID引用关系
    shopOrder.setAddressId(userAddress.getId());
    request.setAddressId(userAddress.getId());

    // 创建地址信息快照
    if (request.getAddress() == null || request.getAddress().trim().isEmpty()) {
        StringBuilder fullAddress = new StringBuilder();
        if (userAddress.getProvince() != null) fullAddress.append(userAddress.getProvince());
        if (userAddress.getCity() != null) fullAddress.append(userAddress.getCity());
        if (userAddress.getRegion() != null) fullAddress.append(userAddress.getRegion());
        if (userAddress.getAddress() != null) fullAddress.append(userAddress.getAddress());
        
        shopOrder.setAddress(fullAddress.toString());
        request.setAddress(fullAddress.toString());
    }

    // 复制收货人信息
    if (request.getRealName() == null || request.getRealName().trim().isEmpty()) {
        shopOrder.setRealName(userAddress.getName());
        request.setRealName(userAddress.getName());
    }

    // 复制经纬度信息
    if (request.getAddressLat() == null && userAddress.getLat() != null) {
        shopOrder.setAddressLat(userAddress.getLat());
        request.setAddressLat(userAddress.getLat());
    }
    if (request.getAddressLng() == null && userAddress.getLng() != null) {
        shopOrder.setAddressLng(userAddress.getLng());
        request.setAddressLng(userAddress.getLng());
    }
}

前端集成建议

1. 下单页面地址选择

// 获取用户地址列表
const getUserAddresses = async () => {
  const response = await api.get('/api/shop/user-address/my');
  return response.data;
};

// 获取默认地址
const getDefaultAddress = async () => {
  const addresses = await getUserAddresses();
  return addresses.find(addr => addr.isDefault) || addresses[0];
};

// 下单时的地址处理
const createOrder = async (orderData) => {
  // 如果用户没有选择地址，使用默认地址
  if (!orderData.addressId && !orderData.address) {
    const defaultAddress = await getDefaultAddress();
    if (defaultAddress) {
      orderData.addressId = defaultAddress.id;
    }
  }
  
  return api.post('/api/shop/order/create', orderData);
};

2. 地址选择组件

<template>
  <div class="address-selector">
    <div v-if="selectedAddress" class="selected-address">
      <div class="address-info">
        <span class="name">{{ selectedAddress.name }}</span>
        <span class="phone">{{ selectedAddress.phone }}</span>
      </div>
      <div class="address-detail">{{ selectedAddress.fullAddress }}</div>
    </div>
    <button @click="showAddressList = true">选择收货地址</button>
  </div>
</template>

优势分析

1. 数据一致性

订单创建时保存地址快照，确保历史订单信息不受用户后续地址修改影响
同时保留地址ID引用，便于数据关联和分析

2. 用户体验

自动读取用户默认地址，减少用户操作步骤
支持临时修改收货信息，满足特殊需求
智能地址选择逻辑，确保总能找到合适的收货地址

3. 系统稳定性

完善的异常处理机制，避免因地址问题导致下单失败
详细的日志记录，便于问题排查和系统监控

4. 扩展性

支持多种地址类型（家、公司、学校等）
预留经纬度字段，支持地图定位功能
灵活的排序和默认地址设置

注意事项

地址验证：建议在前端和后端都进行地址完整性验证
默认地址管理：确保用户只能有一个默认地址
地址数量限制：建议限制用户地址数量，避免数据冗余
隐私保护：敏感信息如手机号需要适当脱敏处理
性能优化：对于高频查询的地址信息，可考虑适当缓存

总结

本设计方案通过地址快照机制确保了订单数据的一致性，通过智能地址选择提升了用户体验，通过完善的异常处理保证了系统稳定性。该方案已在 OrderBusinessService 中实现，可以直接投入使用。

9.0 KiB Raw Permalink Blame History

收货信息设计方案

概述

设计原则

数据库设计

1. 用户地址表 (shop_user_address)

2. 订单表收货信息字段 (shop_order)

业务流程设计

1. 下单时收货地址处理流程

2. 地址优先级

核心实现

1. 收货地址处理方法

2. 地址快照创建

前端集成建议

1. 下单页面地址选择

2. 地址选择组件

优势分析

1. 数据一致性

2. 用户体验

3. 系统稳定性

4. 扩展性

注意事项

总结

9.0 KiB

Raw Permalink Blame History