乐购商城产品系统

旨在解决什么问题
从业务层面，它解决的是"商家与消费者在线完成购物闭环"的问题：把商品展示、搜索比价、加购下单、订单流转、评价反馈、售后咨询、消息通知整合到一套系统里，让用户足不出户完成从"逛"到"买"到"评"的全流程，商家则通过后台管理商品与订单。
从工程/教学层面（这是它的直接定位），它解决的问题是"如何用主流前后端分离技术栈搭出一套完整电商系统"：演示 JWT 无状态认证、RBAC 角色权限、RESTful API 设计、Axios 拦截器、Pinia 状态持久化、Vue Router 路由守卫等工程实践，面向课程设计、毕业设计、教学演示等场景。

行业场景
B2C 电子商务（网上商城 / 零售电商），业务领域是在线购物，覆盖电子产品、服装、图书、家居生活、美妆护肤五大品类。属于"消费者通过浏览器下单、平台撮合交易"的典型场景，对标淘宝、京东这类综合商城模式。

行业背景
中国已是全球第一大网络零售市场、第二大商品消费市场 。2025 年实物商品网上零售额达 13.1 万亿元，占社会消费品零售总额的 26.1%，比 2020 年提高 3.3 个百分点 ；全国网上零售额约 15.97 万亿元，网络购物用户规模约 9.37 亿人，占网民整体的 83.2% 。
在交易结构上，B2C 模式约占网络零售的 73.4%，是绝对主力；竞争格局呈"三超多强"——淘宝天猫、京东、拼多多占据主导，抖音电商、快手、小红书等社交/内容电商快速崛起，直播电商与 AI 推荐已成为行业标配能力。

模块 功能
用户模块 注册、登录（账号/手机号/OAuth）、忘记密码、JWT 认证、基于角色权限（USER/ADMIN）
商品模块 60 种商品、5 大分类；搜索、筛选、分页；详情含适用年龄、上市季节、7 天无理由退货、评价
购物车模块 加购、改数量、删除、清空、合计金额、一键结算
订单模块 创建订单、订单列表/详情、状态流转（待付款→已发货→已完成）、后台管理
收藏夹模块 收藏/取消收藏、收藏列表
评价模块 查看评价（均分、星级）、登录用户发表 1–5 星评价
消息中心模块 系统/订单/优惠三类消息、未读角标、已读、删除
推荐模块 基于收藏分类个性化推荐，匿名随机推荐，支持「换一批」
客服咨询模块 商品详情页「咨询客服」弹窗，关键词自动回复
后台管理模块 管理员：订单、商品、分类、用户管理

后端（Spring Boot 3.2.5，Java 17） 采用经典三层架构 + DTO 隔离：
Controller 层（REST 接口，接收/校验请求）
↓
Service 层（业务逻辑 + @Transactional 事务）
↓
Repository 层（Spring Data JPA 数据访问）
↓
Entity 层（10 个 JPA 实体）
数据模型共 10 个实体：User、Category、Product、Cart、CartItem、Order、OrderItem、Favorite、Review、Message。
安全与横切关注点：SecurityConfig 放行规则、JwtAuthFilter 解析 Token、@JsonIgnore 屏蔽敏感字段、CorsConfig 跨域、GlobalExceptionHandler 统一异常响应。
用 DTO（AuthResponse、OrderResponse 等）隔离实体，避免无限递归、懒加载异常和密码泄露。
前端（Vue 3.4 + Vite 5）：
api/ Axios 接口封装、views/ 14 个页面、components/ 复用组件、stores/ Pinia 状态、router/ 路由 + 守卫。
登录 Token 存入 localStorage，Axios 拦截器自动携带，路由守卫拦截未登录/非管理员访问。