功能文档汇总

# 2-在线商城系统 - 功能说明

# 项目概述

在线商城系统（智慧商城管理系统）是一个功能完善的电商平台，集商品管理、购物车、订单处理、支付集成、AI智能推荐于一体的综合性Web应用系统。采用前后端分离架构，基于Django和Vue 2技术栈，为商家和用户提供完整的电商解决方案。

# 项目概览

# ✨ 创新点

# 1. AI智能推荐系统

  • 智谱AI集成：集成智谱AI，提供智能商品推荐功能。
  • 用户行为分析：基于用户浏览、购买、收藏等行为数据进行分析。
  • 个性化推荐：为每个用户生成个性化的商品推荐列表。

# 2. 支付宝支付集成

  • 在线支付：集成支付宝SDK，支持在线支付功能。
  • 订单追踪：支持支付宝交易号追踪，订单状态实时同步。
  • 支付回调：完善的支付回调处理机制，确保订单状态准确。

# 3. 完整的电商业务流程

  • 购物车系统：支持商品加入购物车、数量调整、批量结算。
  • 订单管理：完整的订单流程，从创建到支付、发货、收货。
  • 地址管理：支持多地址管理，选择收货地址。
  • 评论系统：支持商品评论和回复，构建用户互动。

# 4. 双端界面设计

  • 管理端：功能完善的后台管理系统，支持商品、订单、用户等全方位管理。
  • 用户端：简洁直观的购物界面，流畅的购物体验。
  • 响应式布局：基于Element UI，适配多种屏幕尺寸。

# 5. 数据可视化统计

  • ECharts图表：集成ECharts，提供销售数据、用户行为等多维度统计。
  • 实时数据：管理端首页实时展示关键业务数据。
  • 数据分析：支持数据导出和分析功能。

# ✨ 项目亮点

# 一、 业务功能亮点

  1. 完整的电商闭环：从商品浏览、加购、下单、支付到发货、收货、评价全流程。
  2. 智能推荐引擎：基于AI的商品推荐，提升用户购物体验和转化率。
  3. 多维度商品组织：分类管理、搜索功能、收藏功能，便于用户快速找到商品。
  4. 用户反馈系统：意见反馈功能，及时收集用户建议和问题。

# 二、 技术实现亮点

  1. 现代化前端技术栈：采用 Vue 2.6.11 + Element UI 2.15.9 + Axios 0.27.2，开发高效。
  2. 稳定可靠的后端架构：基于 Django 3.2 + DRF 3.14.0，配合JWT认证，构建稳健后端。
  3. 完善的数据库设计：9张核心表，支持MySQL数据库，数据结构清晰。
  4. 丰富的第三方集成：支付宝SDK、智谱AI、WangEditor（富文本）、ECharts（图表）。
  5. 安全性设计：密码加盐加密、JWT Token认证、角色权限控制、白名单机制。

# 三、 用户体验亮点

  1. 双界面设计：管理端和用户端分离，各自优化，体验流畅。
  2. 响应式布局：基于Element UI栅格系统，适配多种设备。
  3. 交互优化：
    • 友好的加载提示和错误提示。
    • 重要操作的确认弹窗。
    • 及时的全局消息提示。
    • 严谨的前后端表单验证。
  4. 富文本编辑：商品详情支持富文本编辑，图文并茂。

# 管理员

# 系统管理

用户管理：管理全部用户账号，支持新增、编辑、删除、启用/禁用操作，可查看用户余额、年龄段、性别等信息

地址管理：管理全部用户的收货地址，可查看、编辑、删除地址信息

# 商品管理

分类管理：管理商品分类，支持新增、编辑、删除、启用/禁用操作，可上传分类图片

商品管理：管理全部商品，支持新增、编辑、删除、上下架操作，可设置商品价格、库存、详情（富文本）

# 订单管理

订单管理：管理全部订单，可查看订单详情（商品信息、地址信息、支付状态），可发货、处理订单

# 互动管理

评论管理：管理全部商品评论，可查看评论详情、删除不当评论

反馈管理：管理用户反馈，可查看反馈详情、标记反馈状态（未采纳/已采纳）

收藏管理：查看全部用户的收藏记录，可删除收藏记录

# 普通用户

# 商品浏览

商品列表：浏览全部商品，可按分类筛选，可搜索商品，查看商品价格、库存、浏览量

商品详情：查看商品完整信息（标题、详情、价格、库存），查看商品评论

分类浏览：按分类浏览商品，快速找到目标商品

# 购物功能

加入购物车：将商品加入购物车，可调整商品数量

购物车：查看购物车商品，可修改数量、删除商品、批量结算

下单结算：选择收货地址，确认订单信息，使用支付宝支付

# 订单管理

订单列表：查看自己的全部订单，可查看订单详情（商品信息、地址信息、支付状态、配送状态）

确认收货：订单发货后，可确认收货

订单评价：订单完成后，可对商品进行评价

# 个人中心

收货地址：管理收货地址，支持新增、编辑、删除地址（姓名、电话、地区、详细地址）

我的收藏：查看收藏的商品，可取消收藏

意见反馈：提交意见反馈，可查看反馈状态

个人信息：修改个人信息（昵称、邮箱、手机号、年龄段、性别）

账户余额：查看账户余额（当前需联系管理员充值）

# 智能推荐

推荐商品：基于AI分析的个性化商品推荐，提升购物体验

# 功能权限对照表

功能模块 管理员 普通用户
管理端首页 ✓ -
用户管理 ✓ -
地址管理 ✓(全部) ✓(仅自己的)
分类管理 ✓ -
商品管理 ✓ -
订单管理 ✓(全部) ✓(仅自己的)
评论管理 ✓(全部) ✓(仅自己的)
反馈管理 ✓(全部) ✓(仅自己的)
收藏管理 ✓(全部) ✓(仅自己的)
商品浏览 ✓ ✓
购物车 ✓ ✓
下单购买 ✓ ✓
AI推荐 ✓ ✓

# 订单状态说明

# 订单状态

  • 待支付：订单已创建，等待支付（status=0）
  • 已支付：订单已支付，等待发货（status=1, delivery=0）
  • 已发货：商家已发货，等待用户确认收货（status=1, delivery=1）
  • 已收货：用户已确认收货，订单完成（status=1, delivery=2）

# 购物车状态

  • 未付款：商品在购物车中，未关联订单（status=0）
  • 已关联订单：商品已加入订单，不可修改（status=1）

# 反馈状态

  • 已反馈：用户已提交反馈，等待处理（status=-1）
  • 未采纳：管理员已查看，未采纳（status=0）
  • 已采纳：管理员已采纳，将进行改进（status=1）

# 默认账号

# 管理员

用户名: admin
密码: admin123
角色: ROLE_ADMIN
余额: 10000元
1
2
3
4

# 测试用户

用户名: user
密码: user123
角色: ROLE_USER
余额: 1000元
1
2
3
4

# 核心业务流程

# 用户注册流程

1. 填写注册信息(用户名、密码、邮箱、手机号)
2. 系统对密码进行加盐加密
3. 创建用户账号(角色:ROLE_USER、初始余额:0元)
4. 跳转到登录页
1
2
3
4

# 购物下单流程

1. 浏览商品列表 → 查看商品详情
2. 点击"加入购物车" → 选择数量 → 加入购物车
3. 进入购物车 → 选择商品 → 点击"去结算"
4. 选择收货地址 → 确认订单信息
5. 点击"提交订单" → 跳转支付宝支付
6. 支付成功 → 订单状态变为"已支付"
7. 购物车商品状态变为"已关联订单"
8. 扣减商品库存
1
2
3
4
5
6
7
8

# 订单发货流程

1. 管理员查看订单列表 → 筛选"已支付"订单
2. 点击"发货" → 订单状态变为"已发货"(delivery=1)
3. 用户在订单列表看到"已发货"状态
4. 用户收到商品后，点击"确认收货"
5. 订单状态变为"已收货"(delivery=2)
6. 订单完成，用户可进行评价
1
2
3
4
5
6

# 商品评价流程

1. 用户进入商品详情页 → 点击"发表评论"
2. 填写评论内容 → 提交评论
3. 系统记录评论(商品ID、用户ID、内容、IP地址)
4. 评论显示在商品详情页
5. 其他用户可回复该评论(parent_id指向父评论)
1
2
3
4
5

# AI推荐流程

1. 用户访问"推荐商品"页面
2. 系统收集用户行为数据(浏览、购买、收藏记录)
3. 调用智谱AI接口进行分析
4. AI返回推荐商品列表
5. 展示推荐商品给用户
1
2
3
4
5

# 技术说明

# 系统架构

  • 前端：Vue 2.6.11 + Element UI 2.15.9 + Axios 0.27.2
  • 后端：Django 3.2 + Django REST Framework 3.14.0
  • 数据库：MySQL 5.7+
  • 认证：JWT Token（PyJWT 2.7.0）
  • 支付：支付宝SDK（alipay-sdk-python 3.6.733）
  • AI：智谱AI（zhipuai 1.0.7）

# 访问地址

  • 后端API：http://localhost:8000
  • 前端页面：http://localhost:8080（开发环境）
  • API文档：http://localhost:8000/swagger/

# 数据库

  • 数据库名：django_mall
  • 字符集：utf8mb4
  • 总表数：9张表（sys_user、goods、category、cart、user_order、address、comment、feedback、collect）

# API接口规范

RESTful风格：
GET    /module/page          # 分页查询
POST   /module/add           # 新增
PUT    /module/update        # 更新
DELETE /module/delBatch      # 批量删除

响应格式：
{
    "code": 200,
    "msg": "success",
    "data": {...}
}

主要API端点：
/sysUser/         - 用户相关接口
/goods/           - 商品相关接口
/category/        - 分类相关接口
/cart/            - 购物车接口
/userOrder/       - 订单接口
/address/         - 地址接口
/comment/         - 评论接口
/feedback/        - 反馈接口
/collect/         - 收藏接口
/pay/             - 支付接口
/recommend/       - 推荐接口
/love             - AI推荐
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# JWT Token配置

有效期: 30天
传递方式: HTTP请求头 token 字段
包含信息: user_id, username, role_type
白名单路径: /sysUser/login, /sysUser/register, /goods/uPage, /category/list
1
2
3
4

# 系统特色

# AI智能推荐

  • 组件：智谱AI 1.0.7
  • 应用：个性化商品推荐
  • 功能：基于用户行为分析，生成推荐列表

# 支付宝支付

  • 组件：alipay-sdk-python 3.6.733
  • 应用：在线支付、订单追踪
  • 功能：支持支付宝在线支付，支付回调处理

# 富文本编辑

  • 组件：WangEditor 5.1.14
  • 应用：商品详情编辑
  • 功能：支持文本格式化、图片插入、链接插入

# 数据可视化

  • 组件：ECharts 5.4.2
  • 图表：销售数据统计（柱状图）、用户行为分析（折线图）
  • 位置：管理端首页

# 文件上传

  • 上传路径：static/uploads/
  • 访问格式：http://localhost:8000/static/uploads/{文件名}
  • 支持接口：/uploads（通用上传）、/wangeditorUploads（富文本上传）

# 地区选择

  • 组件：element-china-area-data 6.0.2
  • 应用：收货地址地区选择
  • 功能：省市区三级联动选择

# 二维码生成

  • 组件：qrcodejs2 0.0.2
  • 应用：订单二维码、商品分享二维码
  • 功能：快速生成二维码

# 项目优化亮点

根据项目文档，该项目已完成以下优化：

  1. 配置管理现代化：使用环境变量和配置分离，敏感信息不再硬编码
  2. 代码规范化：统一的命名、文档和组织规范
  3. 工具类封装：消除重复代码，提高复用性
  4. 日志系统完善：日志轮转和级别分离，按类型分文件记录
  5. 安全性提升：密码加盐加密、JWT Token认证、角色权限控制
  6. 异常处理完善：统一的错误处理机制
Java导航网   |