立项背景:净菜从产地到餐桌链路长、损耗高,消费者缺少查看产地与冷链信息的渠道,中小商家也缺少低成本的线上经营工具。项目为省级大学生创新创业训练计划立项,目标是把"商品经营—下单履约—冷链溯源—商家治理"打通,做一套用户、商家、平台三端一体的净菜电商系统,并用单包部署压低落地成本。
核心功能:用户端是移动优先的 H5(可安装为 PWA,也有安卓客户端),覆盖首页推荐、商品列表与详情、购物车、地址管理、下单支付、订单跟踪、评价晒单、溯源查询和个人中心;商家端提供注册码入驻、商品与库存维护、接单发货、评价回复和经营看板;平台端提供数据看板、用户与角色管理、商户审核与信用分、流量奖励与月度排名、商品强制上下架、注册码发放和评价处置。
业务流程:用户浏览商品、加入购物车、填写收货信息并计算优惠与配送费、在线支付;支付成功后系统按商品逐条生成溯源码,商家备货发货,用户签收后评价。溯源页可按溯源码或订单号查看氮气冷链的温度、湿度与运输节点。订单状态按"待支付—已付款—备货中—已发货—已签收/已退款"流转,商家侧另有信用评分与月度排名参与平台侧排序。
整体架构:Spring Boot 3 与 Vue 3 前后端分离。前端由 Vite 构建,产物与安卓安装包一并打进 jar 的 static 目录,最终交付物是一个 64MB 的可执行 jar,前端 history 路由由服务端回退到 index.html。后端按 Controller—Service—Repository 分层,DTO 与实体解耦;Spring Security 配合 JWT 过滤器做无状态鉴权,按 USER/MERCHANT/ADMIN 三种角色划分接口权限,令牌 24 小时、刷新 7 天;数据层用 MySQL + Spring Data JPA,Hikari 连接池上限 20;接口文档由 SpringDoc 自动生成。
我的负责模块与结果:作为项目负责人独立完成后端从 0 到 1——11 个控制器、64 个 REST 接口、9 个核心实体(用户、商户、商品、订单、购物车、地址、评价、溯源记录、注册码)与 6 个 Service 实现;设计订单状态机与溯源联动,下单时按商品逐条生成溯源码,发货后写入温湿度与运输节点;实现可解释的规则推荐,按用户偏好、购买历史、产地、销量与浏览量加权打分排序;实现注册码准入、商家信用分与流量奖励、月度排名;并把前端与安卓包整合进同一个 jar 完成统一部署,项目按期结项。
难点与解决:一是购物车可能跨商户下单,订单取不到归属商户——改为从订单明细反解析商户,并以首个商品兜底;二是 JWT 过滤器会误拦静态资源导致页面白屏——把放行清单(登录注册、商品与溯源公开查询、静态资源)集中到 SecurityConfig 声明;三是前端 history 路由在 jar 内刷新 404——用 ViewController 把非接口路径统一转发到 index.html;四是上传目录若放在 jar 内不可写——改为外置目录并映射到 /uploads/**。