---

一、摘要

1.1 項目介紹

基于Vue+SpringBoot+MySQL的社區買菜系統包含菜品分類模塊、菜品檔案模塊、菜品訂單模塊、菜品收藏模塊、收貨地址模塊，還包含系統自帶的用戶管理、部門管理、角色管理、菜單管理、日志管理、數據字典管理、文件管理、圖表展示等基礎模塊，社區買菜系統基于角色的訪問控制，給買菜者、菜品管理員使用，可將權限精確到按鈕級別，您可以自定義角色并分配權限，系統適合設計精確的權限約束需求。

隨著計算機技術和網絡技術的日益普及，給社區菜市場信息化建設帶來了機遇，利用先進技術建立多種方式的社區買菜系統，這是一個明智的選擇。通過電子屏和網站兩種方式發布市場管理信息、商品信息（包括價格、質量等），能夠起到增強市場和市民之間的信息交流，達到繁榮市場，更好的為市民服務之目的。本文采用B/S 模式相結合的架構，設計和實現了基于 Java EE 的社區買菜系統。

1.2 項目錄屏

---

二、系統設計

2.1 功能模塊設計

社區買菜系統的功能性需求主要包含數據中心模塊、菜品分類模塊、菜品檔案模塊、菜品訂單模塊、菜品收藏模塊、收貨地址模塊這六大模塊，系統是基于瀏覽器運行的web管理后端，其中各個模塊詳細說明如下。

2.1.1 數據中心模塊

數據中心模塊包含了社區買菜系統的系統基礎配置，如登錄用戶的管理、運營公司組織架構的管理、用戶菜單權限的管理、系統日志的管理、公用文件云盤的管理。

其中登錄用戶管理模塊，由管理員負責運維工作，管理員可以對登錄用戶進行增加、刪除、修改、查詢操作。

組織架構，指的是高校的組織架構，該模塊適用于管理這些組織架構的部門層級和教師的部門歸屬情況。

用戶菜單權限管理模塊，用于管理不同權限的用戶，擁有哪些具體的菜單權限。

系統日志的管理，用于維護用戶登入系統的記錄，方便定位追蹤用戶的操作情況。

公用云盤管理模塊，用于統一化維護社區買菜系統中的圖片，如合同簽訂文件、合同照片等等。

2.1.2 菜品分類模塊

不同的菜品有著不同的類型，不同類型的菜品往往需要區分管理，所以需要建立菜品分類模塊，菜品分類的數據包括類型名稱、類型狀態、排序值、備注、創建人、創建時間、更新人、更新時間，管理員可以新增、刪除、編輯和條件查詢角色數據，用戶可以查詢管理員發布的角色數據。

2.1.3 菜品檔案模塊

菜品是社區買菜系統的核心實體，需要建立菜品檔案模塊對系統上架的菜品數據進行管理，菜品的字段包括菜品名稱、菜品介紹、菜品分類、剩余庫存、創建人、創建時間、更新人、更新時間，管理員可以新增、刪除、編輯和條件查詢菜品數據，用戶可以查詢管理員發布的菜品數據。

2.1.4 菜品訂單模塊

有了菜品數據之后，用戶就可以在社區買菜系統中下單了，菜品訂單的數據包括菜品、下單數量、總價、收貨地址、創建人、創建時間、更新人、更新時間，用戶可以發起下單申請，管理員可以處理用戶發起的菜品訂單。

2.1.5 菜品收藏模塊

為了更好的服務用戶，社區買菜系統支持對菜品進行收藏，以便于用戶更方便快捷的下單自己喜歡的菜品，菜品收藏字段包括菜品ID、菜品名稱、菜品圖片、收藏人、創建人、創建時間、更新人、更新時間，用戶可以發起菜品收藏申請，管理員可以查詢用戶的菜品收藏信息。

2.1.6 收貨地址模塊

為了方便用戶更快捷的下單，用戶可以對自己的收貨地址進行管理，在菜品下單時可以快捷選擇自己維護的收貨地址。收貨地址字段包括掛靠人、收貨地址、聯系人、聯系電話、創建人、創建時間、更新人、更新時間，用戶可以新增、編輯、刪除和條件查詢自己的收貨地址，管理員可以查詢全部用戶的收貨地址。

2.2 可行性分析

我將首先調查同類型市場的社區買菜系統，了解其優缺點，然后詢問一些與系統和買菜相關的專家，并與他們討論我們的初步想法。然后，我將對客戶進行實地調查，以了解他們對這類社區買菜系統的具體要求。最后，我們將總結上述所有要點，以澄清我們的系統與類似產品之間的區別，并確定我們將開發的社區買菜系統的特點，使其在推出后在市場上更有前景。

2.3 用例分析

UML是面向對象的圖形化建模語言，具有表示容易，定義友好，適用范疇廣泛，功能強大。

用例圖是用例模型的一種，需求分析人員可采用用例圖表示用戶操作行為。社區買菜系統的用例圖設計主要包括用戶用例設計和管理員用例設計。

2.4 實體類設計

2.4.1 菜品分類模塊

2.4.2 菜品檔案模塊

2.4.3 菜品訂單模塊

2.4.4 菜品收藏模塊

2.4.5 收貨地址模塊

---

三、系統實現

---

四、核心代碼展示

4.1 菜品實體類設計

@Table(name = "a_dish")
@TableName("a_dish")
@ApiModel(value = "菜品")
public class Dish extends ZwzBaseEntity {private static final long serialVersionUID = 1L;@ApiModelProperty(value = "菜品名稱")private String title;@ApiModelProperty(value = "菜品介紹")private String content;@ApiModelProperty(value = "菜品分類")private String type;@ApiModelProperty(value = "單價")private BigDecimal unit;@ApiModelProperty(value = "剩余庫存")private BigDecimal stock;@ApiModelProperty(value = "供應商")private String supplier;@ApiModelProperty(value = "圖片")private String image;@Transient@TableField(exist=false)@ApiModelProperty(value = "是否收藏")private Boolean collectionFlag;
}

4.2 收貨地址實體類設計

@Table(name = "a_shipping_address")
@TableName("a_shipping_address")
@ApiModel(value = "收貨地址")
public class ShippingAddress extends ZwzBaseEntity {private static final long serialVersionUID = 1L;@ApiModelProperty(value = "掛靠人ID")private String userId;@ApiModelProperty(value = "掛靠人")private String userName;@ApiModelProperty(value = "收貨地址")private String address;@ApiModelProperty(value = "收貨人")private String consignee;@ApiModelProperty(value = "聯系電話")private String mobile;
}

4.3 查詢菜品接口設計

@RequestMapping(value = "/getByPage", method = RequestMethod.GET)
@ApiOperation(value = "查詢菜品")
public Result<IPage<Dish>> getByPage(@ModelAttribute Dish dish ,@ModelAttribute PageVo page){QueryWrapper<Dish> qw = new QueryWrapper<>();if(!ZwzNullUtils.isNull(dish.getTitle())) {qw.like("title",dish.getTitle());}if(!ZwzNullUtils.isNull(dish.getContent())) {qw.like("content",dish.getContent());}if(!ZwzNullUtils.isNull(dish.getSupplier())) {qw.like("supplier",dish.getSupplier());}User currUser = securityUtil.getCurrUser();IPage<Dish> data = iDishService.page(PageUtil.initMpPage(page),qw);for (Dish vo : data.getRecords()) {QueryWrapper<DishCollection> collQw = new QueryWrapper<>();collQw.eq("user_id",currUser.getId());collQw.eq("dish_id",vo.getId());vo.setCollectionFlag(iDishCollectionService.count(collQw) > 0L);}return new ResultUtil<IPage<Dish>>().setData(data);
}

4.4 菜品下單接口設計

@RequestMapping(value = "/addOneOrder", method = RequestMethod.POST)
@ApiOperation(value = "從購物車下單")
public Result<Object> addOneOrder(@RequestParam String[] ids){List<DishOrderItem> itemList = new ArrayList<>();List<ShoppingCart> cartList = new ArrayList<>();BigDecimal sumMoney = BigDecimal.ZERO;for(String id: ids) {ShoppingCart sc = iShoppingCartService.getById(id);if(sc == null) {return ResultUtil.error("購物車已被刪除");}cartList.add(sc);Dish dish = iDishService.getById(sc.getDishId());if(dish == null) {return ResultUtil.error("菜品已下架");}DishOrderItem item = new DishOrderItem();item.setDishId(dish.getId());item.setDishName(dish.getTitle());item.setUnit(dish.getUnit());item.setImage(dish.getImage());item.setNumber(sc.getNumber());item.setSumMoney(item.getUnit().multiply(item.getNumber()));itemList.add(item);sumMoney = sumMoney.add(item.getSumMoney());}User currUser = securityUtil.getCurrUser();DishOrder order = new DishOrder();order.setUserId(currUser.getId());order.setUserName(currUser.getNickname());order.setOrderTime(DateUtil.now());order.setSumMoney(sumMoney);order.setOrderSize(BigDecimal.valueOf(itemList.size()));order.setStatus("已下單");iDishOrderService.saveOrUpdate(order);for (DishOrderItem item : itemList) {item.setOrderId(order.getId());iDishOrderItemService.saveOrUpdate(item);}for (ShoppingCart vo : cartList) {iShoppingCartService.removeById(vo.getId());}return ResultUtil.success();
}

4.5 菜品收藏接口設計

@RequestMapping(value = "/addOne", method = RequestMethod.GET)
@ApiOperation(value = "添加單條收藏")
public Result<Object> addOne(@RequestParam String id){Dish dish = iDishService.getById(id);if(dish == null) {return ResultUtil.error("菜品不存在");}User currUser = securityUtil.getCurrUser();QueryWrapper<DishCollection> qw = new QueryWrapper<>();qw.eq("user_id",currUser.getId());qw.eq("dish_id",dish.getId());if(iDishCollectionService.count(qw) > 0L) {return ResultUtil.error("您已收藏");}DishCollection dc = new DishCollection();dc.setDishId(dish.getId());dc.setDishName(dish.getTitle());dc.setUserId(currUser.getId());dc.setUserName(currUser.getNickname());dc.setCollectionTime(DateUtil.now());iDishCollectionService.saveOrUpdate(dc);return ResultUtil.success();
}

---

五、免責說明

• 本項目僅供個人學習使用，商用授權請聯系博主，否則后果自負。
• 博主擁有本軟件構建后的應用系統全部內容所有權及獨立的知識產權，擁有最終解釋權。
• 如有問題，歡迎在倉庫 Issue 留言，看到后會第一時間回復，相關意見會酌情考慮，但沒有一定被采納的承諾或保證。

下載本系統代碼或使用本系統的用戶，必須同意以下內容，否則請勿下載！

1. 出于自愿而使用/開發本軟件，了解使用本軟件的風險，且同意自己承擔使用本軟件的風險。
2. 利用本軟件構建的網站的任何信息內容以及導致的任何版權糾紛和法律爭議及后果和博主無關，博主對此不承擔任何責任。
3. 在任何情況下，對于因使用或無法使用本軟件而導致的任何難以合理預估的損失（包括但不僅限于商業利潤損失、業務中斷與業務信息丟失），博主概不承擔任何責任。
4. 必須了解使用本軟件的風險，博主不承諾提供一對一的技術支持、使用擔保，也不承擔任何因本軟件而產生的難以預料的問題的相關責任。