引言\n\n隨著信息技術與農業現代化的深度融合，糧食倉儲管理的信息化、智能化轉型已成為保障國家糧食安全、提升管理效率的關鍵環節。傳統的糧庫管理多依賴人工記錄與紙質單據，存在數據易錯、查詢繁瑣、統計滯后、監管困難等諸多弊端。因此，開發一套高效、穩定、易用的糧庫商品管理系統，對于實現糧食入庫、存儲、出庫、盤點、監控的全流程數字化管理具有重要的現實意義。\n\n本畢業設計旨在設計并實現一個基于前后端分離架構的“糧庫商品管理系統”。系統后端采用Python的Django框架，以其強大的ORM、清晰的項目結構和高度的安全性著稱，便于快速構建穩健的數據模型與業務邏輯API。系統前端采用現代化的Vue.js框架，配合Element UI等組件庫，能夠構建出交互流暢、用戶體驗良好的單頁面應用（SPA）。前后端通過RESTful API進行數據交互，實現了關注點分離，提升了系統的可維護性與可擴展性。\n\n## 系統需求分析\n\n### 1. 功能性需求\n 權限管理模塊：實現基于角色的訪問控制（RBAC），包括系統管理員、倉庫管理員、普通查詢員等角色，不同角色具有不同的數據操作與視圖權限。\n 商品基礎信息管理：對糧食品種（如小麥、稻谷、玉米）、規格、產地、等級等基礎信息進行增刪改查。\n 倉庫與貨位管理：維護糧庫中倉庫、倉房、貨位的物理信息與狀態（如空置、滿載、熏蒸中）。\n 入庫管理：記錄糧食收購或調入的詳細信息，包括供應商、車輛信息、質檢報告（水分、雜質、不完善粒等）、過磅重量、入庫倉房、操作員等，自動生成入庫單。\n 在庫管理：實時監控各貨位糧食的庫存數量、存儲時間、當前溫度濕度等環境數據（需與物聯網設備接口對接），支持庫存盤點與損溢處理。\n 出庫管理：根據銷售或調撥計劃，執行出庫操作，記錄提貨單位、出庫倉房、出庫數量、運輸車輛等信息，自動生成出庫單并扣減庫存。\n 統計與報表模塊：按時間、品種、倉庫等維度生成庫存報表、出入庫流水報表、盤點報表等，支持數據可視化展示（如圖表）。\n 系統設置與日志：進行基礎參數配置，并詳細記錄用戶的關鍵操作日志，便于審計與追溯。\n\n### 2. 非功能性需求\n 性能：系統應能支持多用戶并發操作，關鍵查詢響應時間應在可接受范圍內。\n 安全性：數據傳輸需加密，密碼需哈希存儲，嚴格防范SQL注入、跨站腳本（XSS）等常見Web攻擊。\n 易用性：界面設計應簡潔直觀，符合業務流程，降低用戶學習成本。\n 可擴展性：系統架構應便于未來與財務系統、物聯網監測平臺等第三方系統集成。\n\n## 系統設計與實現\n\n### 1. 系統架構\n本系統采用經典的前后端分離架構。\n 前端：使用Vue.js構建單頁面應用，通過Axios庫調用后端API。路由管理使用Vue Router，狀態管理可采用Vuex。UI層選用Element UI組件庫，快速搭建規范界面。\n 后端：使用Django框架，遵循MTV模式。利用Django REST framework（DRF）快速構建RESTful API，提供JSON數據接口。數據庫選用關系型數據庫MySQL或PostgreSQL，用于存儲結構化業務數據。\n 交互：前后端通過HTTP/HTTPS協議進行通信，數據格式為JSON。\n\n### 2. 數據庫設計\n核心實體關系模型（ER）主要包括：用戶、角色、權限、糧食品種、倉庫、貨位、入庫單、入庫明細、出庫單、出庫明細、庫存記錄、盤點單等。例如：\n User 與 Role 是多對多關系。\n Warehouse（倉庫）與 StorageLocation（貨位）是一對多關系。\n Stock（庫存記錄）與 GrainType（糧食品種）、StorageLocation 關聯。\n InboundOrder（入庫單）包含多條 InboundDetail（入庫明細），每條明細關聯一個 Stock 記錄。\n\n### 3. 關鍵功能模塊實現\n Django后端實現：\n 使用 django.contrib.auth 系統進行擴展，實現RBAC模型。\n 定義序列化器（Serializers）將模型實例轉換為JSON數據。\n 編寫視圖集（ViewSets）和通用視圖（APIView）處理各項業務請求，如創建入庫單時，需在一個事務內同時創建單據頭和更新庫存數量。\n 配置JWT（JSON Web Token）或Session機制進行用戶認證與狀態保持。\n 使用Django Signals或重寫模型Save方法實現復雜的業務邏輯鉤子，如庫存變化時自動記錄日志。\n Vue前端實現：\n 通過路由守衛實現頁面級權限控制，根據用戶角色動態生成導航菜單。\n 構建可復用的業務組件，如“商品選擇器”、“倉庫樹形選擇器”。\n 在入庫、出庫頁面，實現動態表單，能夠添加多行商品明細。\n 使用ECharts等庫在儀表盤頁面繪制庫存總量趨勢圖、倉庫容量占比圖等。\n 對API請求進行統一攔截處理，添加請求頭（如Token）、處理錯誤響應。\n\n### 4. 系統安全\n Django后端：使用CSRF保護，對用戶輸入進行嚴格驗證和清理，利用DRF的權限類（Permission Classes）進行接口訪問控制。\n 數據傳輸：部署時啟用HTTPS。\n 密碼存儲：使用Django內置的PBKDF2算法進行哈希。\n\n## 測試與部署\n\n 測試：后端可使用Django的TestCase進行單元測試和集成測試，確保核心業務邏輯正確。前端可進行功能測試和界面測試。\n 部署：前端項目通過npm run build打包成靜態文件，可部署至Nginx服務器。后端Django應用可部署在Gunicorn或uWSGI應用服務器上，由Nginx作為反向代理。數據庫單獨部署。\n\n## 結論與展望\n\n本文設計并實現的基于Django和Vue.js的糧庫商品管理系統，有效整合了現代Web開發技術，構建了一個功能完整、界面友好、安全性高的數字化管理平臺。系統實現了糧庫核心業務流程的信息化，能夠顯著提升工作效率、數據準確性和管理透明度，具有較好的實用價值。\n\n未來工作可從以下幾方面展開：進一步集成物聯網硬件，實現糧情溫濕度、氣體濃度的自動采集與異常報警。引入大數據分析技術，對庫存周轉、糧食品質變化進行預測分析。可擴展移動端應用（如微信小程序），方便管理人員隨時隨地監控與審批。