簡(jiǎn)介本資源是一個(gè)基于Django框架開(kāi)發(fā)的商品銷售進(jìn)銷存管理系統(tǒng)完整項(xiàng)目源碼包面向計(jì)算機(jī)專業(yè)本科生、Python初學(xué)者及Web開(kāi)發(fā)入門者適用于課程設(shè)計(jì)、期末大作業(yè)或小型企業(yè)庫(kù)存管理原型開(kāi)發(fā)。系統(tǒng)涵蓋商品管理、采購(gòu)入庫(kù)、銷售出庫(kù)、庫(kù)存查詢與統(tǒng)計(jì)報(bào)表等核心業(yè)務(wù)模塊代碼結(jié)構(gòu)清晰、功能完整評(píng)審得分達(dá)95分以上經(jīng)多輪調(diào)試確?？芍苯舆\(yùn)行。壓縮包共2000個(gè)文件以1623個(gè)JavaScript前端交互邏輯、261個(gè)HTML頁(yè)面模板、51個(gè)CSS樣式文件為主輔以少量Python后端視圖與配置文件5個(gè).py整體體積僅6.08MB輕量易部署。目前已有120人學(xué)習(xí)下載配套數(shù)據(jù)庫(kù)文件開(kāi)箱即用前端采用BootstrapFont Awesome日期選擇器等主流組件兼顧實(shí)用性與教學(xué)示范性是理解Django MTV架構(gòu)與典型業(yè)務(wù)系統(tǒng)集成的優(yōu)質(zhì)實(shí)踐案例。1. 項(xiàng)目背景與核心價(jià)值為什么是Django進(jìn)銷存如果你是一個(gè)正在尋找畢業(yè)設(shè)計(jì)、課程設(shè)計(jì)項(xiàng)目或者想通過(guò)一個(gè)完整項(xiàng)目來(lái)鞏固Python Web開(kāi)發(fā)技能的開(kāi)發(fā)者那么一個(gè)“商品銷售進(jìn)銷存系統(tǒng)”絕對(duì)是一個(gè)經(jīng)典且實(shí)用的選擇。我見(jiàn)過(guò)太多同學(xué)在項(xiàng)目選題上犯難要么選得太簡(jiǎn)單幾天就做完了簡(jiǎn)歷上寫(xiě)不出東西要么選得太復(fù)雜涉及自己不熟悉的領(lǐng)域最后爛尾。而這個(gè)基于Django的進(jìn)銷存系統(tǒng)恰恰踩在了那個(gè)“黃金平衡點(diǎn)”上它足夠復(fù)雜能覆蓋Web開(kāi)發(fā)的核心流程用戶認(rèn)證、數(shù)據(jù)增刪改查、關(guān)聯(lián)查詢、報(bào)表統(tǒng)計(jì)又足夠經(jīng)典有成熟的業(yè)務(wù)邏輯可以參考不至于讓你在業(yè)務(wù)設(shè)計(jì)上無(wú)從下手。為什么我特別推薦用Django來(lái)實(shí)現(xiàn)在國(guó)內(nèi)的Python Web開(kāi)發(fā)領(lǐng)域Django的“江湖地位”非常穩(wěn)固。它不像某些輕量級(jí)框架需要你從零開(kāi)始拼裝各種組件Django自帶了一個(gè)“全家桶”強(qiáng)大的ORM對(duì)象關(guān)系映射讓你用Python類就能操作數(shù)據(jù)庫(kù)無(wú)需寫(xiě)繁瑣的SQL自帶的后臺(tái)管理界面Admin你花幾分鐘配置一下就能得到一個(gè)功能完善的數(shù)據(jù)管理后臺(tái)這在項(xiàng)目初期或者演示時(shí)非常有用清晰的MVT模型-視圖-模板架構(gòu)強(qiáng)迫你寫(xiě)出結(jié)構(gòu)清晰的代碼。對(duì)于“進(jìn)銷存”這種以數(shù)據(jù)處理為核心的系統(tǒng)Django的ORM和Admin能幫你省下至少30%的開(kāi)發(fā)時(shí)間。你搜索“python django國(guó)內(nèi)使用廣泛么”答案幾乎是肯定的尤其是在教育、企業(yè)后臺(tái)管理系統(tǒng)等領(lǐng)域這意味著你學(xué)會(huì)它相關(guān)的教程、社區(qū)問(wèn)答和就業(yè)機(jī)會(huì)都會(huì)更多。這個(gè)“高分項(xiàng)目”的價(jià)值不僅僅在于那一份可以運(yùn)行的源碼和數(shù)據(jù)庫(kù)文件。它的真正價(jià)值在于提供了一個(gè)完整的、可解剖的學(xué)習(xí)樣本。你可以看到如何設(shè)計(jì)“商品”、“供應(yīng)商”、“客戶”、“采購(gòu)單”、“銷售單”、“庫(kù)存”這些核心模型Model以及它們之間復(fù)雜的一對(duì)多、多對(duì)多關(guān)系是如何通過(guò)Django ORM建立的。你可以學(xué)習(xí)到如何編寫(xiě)視圖View來(lái)處理表單提交、實(shí)現(xiàn)復(fù)雜的多條件查詢以及如何利用模板Template和模板標(biāo)簽來(lái)渲染動(dòng)態(tài)頁(yè)面。更進(jìn)一步你可以研究它如何實(shí)現(xiàn)基本的權(quán)限控制比如普通員工和經(jīng)理看到不同的菜單以及如何生成簡(jiǎn)單的銷售報(bào)表。這些都是你從零開(kāi)始獨(dú)立完成一個(gè)項(xiàng)目時(shí)必須掌握的技能而這個(gè)項(xiàng)目源碼為你提供了一個(gè)可靠的參考藍(lán)圖。2. 系統(tǒng)核心模塊設(shè)計(jì)與業(yè)務(wù)邏輯拆解拿到一個(gè)完整的項(xiàng)目源碼最忌諱的就是直接運(yùn)行起來(lái)看看界面就完事了。我們應(yīng)該像解剖一樣深入其內(nèi)部理解每個(gè)模塊為什么這樣設(shè)計(jì)。一個(gè)標(biāo)準(zhǔn)的進(jìn)銷存系統(tǒng)其核心業(yè)務(wù)邏輯圍繞著“進(jìn)”采購(gòu)入庫(kù)、“銷”銷售出庫(kù)、“存”庫(kù)存管理三個(gè)環(huán)節(jié)展開(kāi)數(shù)據(jù)流必須形成閉環(huán)且要保證庫(kù)存數(shù)量的準(zhǔn)確性這是系統(tǒng)的生命線。2.1 數(shù)據(jù)模型層構(gòu)建系統(tǒng)的基石所有的業(yè)務(wù)都始于數(shù)據(jù)模型的定義。在Django中這體現(xiàn)在models.py文件里。一個(gè)設(shè)計(jì)良好的模型層是項(xiàng)目成功的一半。商品與分類模型這是最基礎(chǔ)的模型。Product商品模型通常會(huì)包含字段如名稱、編號(hào)、規(guī)格、單位、采購(gòu)價(jià)、銷售價(jià)、庫(kù)存預(yù)警值等。它通過(guò)ForeignKey關(guān)聯(lián)到一個(gè)Category商品分類模型實(shí)現(xiàn)樹(shù)狀分類管理。這里的一個(gè)設(shè)計(jì)要點(diǎn)是采購(gòu)價(jià)和銷售價(jià)是直接存在商品模型里還是通過(guò)歷史記錄來(lái)管理在簡(jiǎn)單的系統(tǒng)中直接存儲(chǔ)當(dāng)前價(jià)格是可行的。但在嚴(yán)謹(jǐn)?shù)纳虡I(yè)系統(tǒng)中價(jià)格會(huì)變動(dòng)通常會(huì)有獨(dú)立的“價(jià)格歷史”表商品模型只存儲(chǔ)一個(gè)參考價(jià)或最新價(jià)。合作伙伴模型Supplier供應(yīng)商和Customer客戶模型。它們有很多共性字段如名稱、聯(lián)系人、電話、地址等。有些設(shè)計(jì)會(huì)用一個(gè)通用的Partner合作伙伴模型通過(guò)一個(gè)type字段來(lái)區(qū)分是供應(yīng)商還是客戶。這兩種設(shè)計(jì)各有優(yōu)劣通用模型減少了代碼重復(fù)但查詢時(shí)需要增加過(guò)濾條件分開(kāi)設(shè)計(jì)則更清晰直觀。在源碼中你需要關(guān)注它采用了哪種方式并思考為什么。核心業(yè)務(wù)單據(jù)模型這是業(yè)務(wù)邏輯的載體包括PurchaseOrder采購(gòu)單和SalesOrder銷售單。它們的設(shè)計(jì)模式通常類似單據(jù)頭包含單據(jù)編號(hào)、日期、關(guān)聯(lián)的供應(yīng)商或客戶、總金額、狀態(tài)如“草稿”、“已審核”、“已完成”、經(jīng)辦人等。單據(jù)明細(xì)這是一個(gè)獨(dú)立的模型例如PurchaseOrderItem。它通過(guò)ForeignKey關(guān)聯(lián)到對(duì)應(yīng)的單據(jù)頭同時(shí)也關(guān)聯(lián)到具體的Product。明細(xì)表里會(huì)記錄商品、數(shù)量、單價(jià)、金額等。這里的關(guān)鍵在于“單價(jià)”的存儲(chǔ)。明細(xì)里記錄的單價(jià)應(yīng)該是下單時(shí)的“快照”而不是實(shí)時(shí)去商品表里查。因?yàn)樯唐返闹鲀r(jià)格可能變更但歷史單據(jù)的價(jià)格必須固定不變否則財(cái)務(wù)報(bào)表就亂套了。這就是業(yè)務(wù)系統(tǒng)中的“歷史數(shù)據(jù)一致性”原則。庫(kù)存模型這是系統(tǒng)的中樞。Inventory或Stock模型記錄每個(gè)商品的實(shí)時(shí)庫(kù)存數(shù)量。它的每一次變動(dòng)都必須有據(jù)可查通常由采購(gòu)入庫(kù)和銷售出庫(kù)操作來(lái)驅(qū)動(dòng)。庫(kù)存模型的設(shè)計(jì)可以很簡(jiǎn)單就是一個(gè)Product和一個(gè)quantity字段。但更完善的系統(tǒng)會(huì)引入“倉(cāng)庫(kù)”Warehouse的概念甚至區(qū)分“可用庫(kù)存”、“鎖定庫(kù)存”已下單未出庫(kù)等。庫(kù)存數(shù)量的更新必須是“原子操作”在并發(fā)情況下比如兩個(gè)銷售單同時(shí)處理同一商品需要使用數(shù)據(jù)庫(kù)事務(wù)或Django的F表達(dá)式F(quantity) - sold_amount來(lái)避免臟讀和更新丟失這是實(shí)戰(zhàn)中一個(gè)重要的坑點(diǎn)。2.2 視圖與業(yè)務(wù)邏輯層驅(qū)動(dòng)系統(tǒng)運(yùn)轉(zhuǎn)模型定義好了數(shù)據(jù)結(jié)構(gòu)和關(guān)系視圖則負(fù)責(zé)處理用戶的請(qǐng)求執(zhí)行業(yè)務(wù)邏輯并返回響應(yīng)。在進(jìn)銷存系統(tǒng)中幾個(gè)核心視圖的邏輯至關(guān)重要。采購(gòu)入庫(kù)流程創(chuàng)建采購(gòu)單視圖接收表單數(shù)據(jù)創(chuàng)建PurchaseOrder對(duì)象狀態(tài)為“草稿”和多個(gè)PurchaseOrderItem對(duì)象。此時(shí)庫(kù)存不變。審核采購(gòu)單這是一個(gè)關(guān)鍵操作。通常有一個(gè)單獨(dú)的視圖來(lái)處理“審核”動(dòng)作。審核時(shí)系統(tǒng)會(huì)遍歷采購(gòu)單的所有明細(xì)項(xiàng)為每一項(xiàng)執(zhí)行Inventory.objects.update_or_create(productitem.product, defaults{quantity: F(quantity) item.quantity})。這里必須使用事務(wù)transaction.atomic來(lái)確保所有商品的庫(kù)存更新和單據(jù)狀態(tài)更新從“草稿”改為“已審核”要么全部成功要么全部回滾。審核后總庫(kù)存增加。銷售出庫(kù)流程創(chuàng)建銷售單類似采購(gòu)創(chuàng)建銷售單和明細(xì)狀態(tài)“草稿”。審核銷售單出庫(kù)這是業(yè)務(wù)邏輯最復(fù)雜的地方之一。在扣減庫(kù)存前必須檢查庫(kù)存是否充足。視圖需要先遍歷所有明細(xì)項(xiàng)查詢對(duì)應(yīng)商品的當(dāng)前庫(kù)存如果任何一項(xiàng)的item.quantity inventory.quantity則必須阻止審核并給出明確提示如“商品XXX庫(kù)存不足當(dāng)前庫(kù)存僅剩Y”。只有全部檢查通過(guò)才能在一個(gè)事務(wù)內(nèi)扣減庫(kù)存并更新單據(jù)狀態(tài)。如果系統(tǒng)支持“倉(cāng)庫(kù)”還需要檢查指定倉(cāng)庫(kù)的庫(kù)存。庫(kù)存查詢與報(bào)表除了簡(jiǎn)單的列表進(jìn)銷存系統(tǒng)需要提供有價(jià)值的統(tǒng)計(jì)視圖。例如實(shí)時(shí)庫(kù)存查詢展示所有商品及其當(dāng)前庫(kù)存并能按分類、按低庫(kù)存預(yù)警過(guò)濾。流水/日志記錄每一次庫(kù)存變動(dòng)的詳細(xì)信息時(shí)間、關(guān)聯(lián)單據(jù)、變動(dòng)數(shù)量、操作員。這通常通過(guò)創(chuàng)建一個(gè)InventoryTransaction模型來(lái)實(shí)現(xiàn)在每次審核入庫(kù)或出庫(kù)單時(shí)除了更新Inventory表還同步創(chuàng)建一條流水記錄。這是后期對(duì)賬和排查數(shù)據(jù)差異的“鐵證”。銷售/采購(gòu)報(bào)表基于SalesOrder和PurchaseOrder按日、周、月統(tǒng)計(jì)總銷售額、采購(gòu)額、毛利銷售額-成本額。這里會(huì)大量用到Django ORM的annotate和aggregate函數(shù)以及日期過(guò)濾__date。注意在實(shí)現(xiàn)審核、庫(kù)存扣減等核心業(yè)務(wù)邏輯時(shí)務(wù)必把“檢查”和“執(zhí)行”放在同一個(gè)數(shù)據(jù)庫(kù)事務(wù)中。我早期的一個(gè)項(xiàng)目就曾因?yàn)橄葯z查庫(kù)存然后在更新庫(kù)存前有一小段其他邏輯導(dǎo)致在高并發(fā)下出現(xiàn)超賣。使用transaction.atomic裝飾器包裹整個(gè)視圖函數(shù)或邏輯塊是避免這類問(wèn)題的標(biāo)準(zhǔn)做法。3. 從源碼到運(yùn)行環(huán)境搭建與部署詳解假設(shè)你已經(jīng)下載了“Python實(shí)現(xiàn)基于Django商品銷售進(jìn)銷存系統(tǒng)源碼數(shù)據(jù)庫(kù)文件高分項(xiàng)目.zip”這個(gè)壓縮包。接下來(lái)我將帶你一步步把它運(yùn)行起來(lái)并解釋其中關(guān)鍵配置。這個(gè)過(guò)程本身就是學(xué)習(xí)項(xiàng)目結(jié)構(gòu)的最佳途徑。3.1 項(xiàng)目結(jié)構(gòu)與依賴分析解壓后你通常會(huì)看到一個(gè)標(biāo)準(zhǔn)的Django項(xiàng)目結(jié)構(gòu)。核心文件和目錄包括manage.pyDjango的命令行工具入口。requirements.txt或Pipfile項(xiàng)目依賴包列表。這是你搭建環(huán)境的路線圖。主應(yīng)用目錄可能叫inventory、crm或與項(xiàng)目同名里面包含settings.py項(xiàng)目設(shè)置、urls.pyURL路由、wsgi.py等。各個(gè)子應(yīng)用目錄如goods/,purchase/,sales/,stock/按照功能模塊劃分每個(gè)子應(yīng)用有自己的models.py,views.py,urls.py,templates/等。static/和media/存放靜態(tài)文件CSS, JS, 圖片和用戶上傳的文件?？赡艽嬖诘膕ql腳本或.sqlite3文件初始數(shù)據(jù)庫(kù)文件。首先打開(kāi)requirements.txt你會(huì)看到類似以下的內(nèi)容Django3.2.18 pillow9.5.0 django-crispy-forms1.14.0 ...這告訴你項(xiàng)目使用的Django版本是3.2.18一個(gè)長(zhǎng)期支持版本用到了Pillow處理圖片以及django-crispy-forms來(lái)美化表單。第一步就是根據(jù)這個(gè)文件安裝所有依賴。強(qiáng)烈建議使用虛擬環(huán)境venv來(lái)隔離項(xiàng)目環(huán)境避免包沖突。# 創(chuàng)建虛擬環(huán)境 python -m venv venv # 激活虛擬環(huán)境 (Windows) venv\Scripts\activate # 激活虛擬環(huán)境 (Linux/macOS) source venv/bin/activate # 安裝依賴 pip install -r requirements.txt如果項(xiàng)目沒(méi)有提供requirements.txt你可以嘗試運(yùn)行pip freeze requirements.txt來(lái)生成但更可靠的方法是查看settings.py中的INSTALLED_APPS推斷出主要依賴然后手動(dòng)安裝Django和這些App的對(duì)應(yīng)版本。3.2 數(shù)據(jù)庫(kù)配置與初始化接下來(lái)打開(kāi)項(xiàng)目主目錄下的settings.py文件找到DATABASES配置項(xiàng)。高分項(xiàng)目為了開(kāi)箱即用很可能使用的是SQLite數(shù)據(jù)庫(kù)配置如下DATABASES { default: { ENGINE: django.db.backends.sqlite3, NAME: BASE_DIR / db.sqlite3, } }如果壓縮包里附帶了一個(gè).sqlite3或.db文件你需要把它放到項(xiàng)目根目錄與manage.py同級(jí)并確保NAME的路徑指向這個(gè)文件。如果提供的是SQL腳本.sql你可能需要先創(chuàng)建一個(gè)空數(shù)據(jù)庫(kù)然后用數(shù)據(jù)庫(kù)工具導(dǎo)入。更常見(jiàn)的情況是項(xiàng)目源碼里包含了數(shù)據(jù)庫(kù)遷移文件migrations目錄。這時(shí)你只需要運(yùn)行Django的命令來(lái)創(chuàng)建數(shù)據(jù)庫(kù)表結(jié)構(gòu)# 創(chuàng)建數(shù)據(jù)庫(kù)SQLite文件會(huì)自動(dòng)生成 python manage.py migrate這個(gè)命令會(huì)依據(jù)migrations文件夾下的文件在數(shù)據(jù)庫(kù)中生成所有定義好的表。然后你需要?jiǎng)?chuàng)建一個(gè)超級(jí)用戶來(lái)登錄Django Admin后臺(tái)和管理系統(tǒng)前臺(tái)python manage.py createsuperuser按照提示輸入用戶名、郵箱和密碼。3.3 運(yùn)行開(kāi)發(fā)服務(wù)器與初步探索完成上述步驟后就可以啟動(dòng)開(kāi)發(fā)服務(wù)器了python manage.py runserver在瀏覽器中打開(kāi)http://127.0.0.1:8000你應(yīng)該能看到系統(tǒng)的登錄頁(yè)或首頁(yè)。同時(shí)訪問(wèn)http://127.0.0.1:8000/admin用剛才創(chuàng)建的超級(jí)用戶登錄可以進(jìn)入Django Admin后臺(tái)。在這里你可以看到所有注冊(cè)到后臺(tái)的數(shù)據(jù)模型并進(jìn)行增刪改查操作。這是你快速熟悉系統(tǒng)數(shù)據(jù)結(jié)構(gòu)和添加測(cè)試數(shù)據(jù)的入口。首次運(yùn)行常見(jiàn)問(wèn)題排查端口占用如果8000端口被占用可以用runserver 8080指定其他端口。靜態(tài)文件404開(kāi)發(fā)模式下Django能伺服靜態(tài)文件但需要確保settings.py中DEBUG True并且你執(zhí)行過(guò)python manage.py collectstatic如果項(xiàng)目有預(yù)編譯的靜態(tài)文件。更常見(jiàn)的問(wèn)題是前端頁(yè)面引用了/static/路徑下的CSS/JS但你的項(xiàng)目static目錄可能不在默認(rèn)位置需要檢查STATIC_URL和STATICFILES_DIRS設(shè)置。數(shù)據(jù)庫(kù)連接錯(cuò)誤如果使用提供的數(shù)據(jù)庫(kù)文件確保文件路徑正確且Django進(jìn)程有讀寫(xiě)權(quán)限。如果使用遷移確保所有遷移文件無(wú)誤有時(shí)需要先運(yùn)行python manage.py makemigrations生成遷移文件再執(zhí)行migrate。4. 深入源碼關(guān)鍵技術(shù)與代碼片段解析要讓這個(gè)項(xiàng)目不僅僅是“能運(yùn)行”更要成為你知識(shí)的一部分就必須深入關(guān)鍵代碼。我們挑幾個(gè)核心片段來(lái)分析。4.1 模型關(guān)系定義示例我們來(lái)看一個(gè)典型的models.py片段比如在purchase應(yīng)用里from django.db import models from goods.models import Product from partner.models import Supplier class PurchaseOrder(models.Model): ORDER_STATUS ( (draft, 草稿), (confirmed, 已確認(rèn)), (done, 已完成), (canceled, 已取消), ) order_number models.CharField(采購(gòu)單號(hào), max_length50, uniqueTrue) supplier models.ForeignKey(Supplier, on_deletemodels.PROTECT, verbose_name供應(yīng)商) order_date models.DateField(訂單日期, auto_now_addTrue) total_amount models.DecimalField(總金額, max_digits10, decimal_places2, default0) status models.CharField(狀態(tài), max_length20, choicesORDER_STATUS, defaultdraft) created_by models.ForeignKey(User, on_deletemodels.PROTECT, related_namepurchase_orders) created_at models.DateTimeField(auto_now_addTrue) def __str__(self): return self.order_number def save(self, *args, **kwargs): if not self.order_number: # 自動(dòng)生成單號(hào)規(guī)則如 PO-20231001-001 prefix PO- date_str timezone.now().strftime(%Y%m%d) last_order PurchaseOrder.objects.filter(order_number__startswithf{prefix}{date_str}).order_by(order_number).last() if last_order: last_num int(last_order.order_number.split(-)[-1]) new_num last_num 1 else: new_num 1 self.order_number f{prefix}{date_str}-{new_num:03d} super().save(*args, **kwargs) class PurchaseOrderItem(models.Model): order models.ForeignKey(PurchaseOrder, on_deletemodels.CASCADE, related_nameitems) product models.ForeignKey(Product, on_deletemodels.PROTECT, verbose_name商品) quantity models.PositiveIntegerField(數(shù)量, default1) unit_price models.DecimalField(單價(jià), max_digits10, decimal_places2) amount models.DecimalField(金額, max_digits10, decimal_places2) def save(self, *args, **kwargs): # 自動(dòng)計(jì)算金額 self.amount self.quantity * self.unit_price super().save(*args, **kwargs) # 更新主單總金額 (這里可以優(yōu)化避免每次保存明細(xì)都更新主單) self.order.total_amount self.order.items.aggregate(totalmodels.Sum(amount))[total] or 0 self.order.save(update_fields[total_amount])代碼解讀與技巧ForeignKey與on_deletePurchaseOrder關(guān)聯(lián)Supplier和User使用on_deletemodels.PROTECT是一種保護(hù)性刪除策略。這意味著如果試圖刪除一個(gè)已被采購(gòu)單引用的供應(yīng)商或用戶Django會(huì)阻止刪除并拋出ProtectedError。這比默認(rèn)的CASCADE級(jí)聯(lián)刪除更符合業(yè)務(wù)邏輯因?yàn)闅v史單據(jù)必須保留關(guān)聯(lián)信息。而PurchaseOrderItem關(guān)聯(lián)PurchaseOrder用了CASCADE表示刪除采購(gòu)單時(shí)其明細(xì)項(xiàng)也一并刪除這是合理的。related_name在PurchaseOrder中定義了created_by的related_namepurchase_orders。這樣你可以通過(guò)user.purchase_orders.all()反向查詢這個(gè)用戶創(chuàng)建的所有采購(gòu)單非常方便。重寫(xiě)save方法在PurchaseOrder中重寫(xiě)save方法用于自動(dòng)生成有規(guī)則的訂單號(hào)這是業(yè)務(wù)系統(tǒng)的常見(jiàn)需求。注意生成邏輯要考慮并發(fā)情況在高并發(fā)下可能產(chǎn)生重復(fù)單號(hào)更嚴(yán)謹(jǐn)?shù)淖龇ㄊ鞘褂脭?shù)據(jù)庫(kù)序列或分布式ID生成器。在PurchaseOrderItem中重寫(xiě)save來(lái)自動(dòng)計(jì)算amount并更新主單的total_amount。但注意這里每次保存明細(xì)都重新聚合計(jì)算并更新主單在性能上不是最優(yōu)的。更好的做法是在主單上定義一個(gè)方法如update_total在需要時(shí)如所有明細(xì)保存完后調(diào)用或者使用Django的信號(hào)post_save,post_delete在明細(xì)變動(dòng)后異步更新主單。4.2 包含事務(wù)與庫(kù)存檢查的銷售出庫(kù)視圖這是整個(gè)系統(tǒng)最核心、最需要嚴(yán)謹(jǐn)對(duì)待的視圖之一。我們來(lái)看一個(gè)簡(jiǎn)化的示例from django.db import transaction from django.shortcuts import render, get_object_or_404, redirect from django.contrib import messages from .models import SalesOrder, SalesOrderItem, Inventory transaction.atomic def confirm_sales_order(request, order_id): 審核銷售單出庫(kù) sales_order get_object_or_404(SalesOrder, idorder_id, statusdraft) # 1. 預(yù)檢查庫(kù)存是否充足 insufficient_items [] for item in sales_order.items.all(): try: inventory Inventory.objects.get(productitem.product) if inventory.quantity item.quantity: insufficient_items.append({ product: item.product.name, required: item.quantity, available: inventory.quantity }) except Inventory.DoesNotExist: insufficient_items.append({ product: item.product.name, required: item.quantity, available: 0 }) if insufficient_items: # 返回錯(cuò)誤信息提示具體哪些商品庫(kù)存不足 error_msg 庫(kù)存不足無(wú)法出庫(kù)br for insuf in insufficient_items: error_msg f- {insuf[product]}: 需要{insuf[required]} 僅剩{insuf[available]}br messages.error(request, error_msg) return redirect(sales_order_detail, order_idorder_id) # 2. 執(zhí)行出庫(kù)操作在一個(gè)事務(wù)內(nèi) try: for item in sales_order.items.all(): # 使用F表達(dá)式原子操作扣減庫(kù)存避免并發(fā)問(wèn)題 Inventory.objects.filter(productitem.product).update( quantitymodels.F(quantity) - item.quantity ) # 可選記錄庫(kù)存流水 # InventoryTransaction.objects.create(...) # 更新單據(jù)狀態(tài) sales_order.status confirmed sales_order.confirmed_by request.user sales_order.confirmed_at timezone.now() sales_order.save() messages.success(request, f銷售單 {sales_order.order_number} 已成功出庫(kù)) return redirect(sales_order_list) except Exception as e: # 事務(wù)會(huì)自動(dòng)回滾 messages.error(request, f出庫(kù)過(guò)程中發(fā)生錯(cuò)誤{e}) return redirect(sales_order_detail, order_idorder_id)關(guān)鍵點(diǎn)分析transaction.atomic裝飾器這是生命線。它確保從函數(shù)開(kāi)始到結(jié)束的所有數(shù)據(jù)庫(kù)操作包括循環(huán)中的多次update和最后的save在一個(gè)數(shù)據(jù)庫(kù)事務(wù)中。如果中間任何一步出錯(cuò)所有修改都會(huì)回滾庫(kù)存數(shù)量不會(huì)處于一個(gè)“部分扣減”的中間狀態(tài)保證了數(shù)據(jù)的一致性。兩階段操作先檢查后執(zhí)行。檢查階段只讀數(shù)據(jù)庫(kù)不修改任何數(shù)據(jù)。只有所有檢查都通過(guò)才進(jìn)入執(zhí)行階段。檢查結(jié)果用列表收集最后統(tǒng)一反饋給用戶體驗(yàn)更好。使用F表達(dá)式Inventory.objects.filter(...).update(quantityF(quantity) - item.quantity)。這是Django ORM提供的原子更新操作。它直接在數(shù)據(jù)庫(kù)層面執(zhí)行UPDATE inventory SET quantity quantity - ? WHERE ...避免了“先讀取、再計(jì)算、再寫(xiě)回”這個(gè)非原子過(guò)程可能引發(fā)的并發(fā)競(jìng)爭(zhēng)問(wèn)題。如果兩個(gè)請(qǐng)求同時(shí)讀到庫(kù)存為10都計(jì)算10-28然后寫(xiě)回最終庫(kù)存是8而不是6。F表達(dá)式完美解決了這個(gè)問(wèn)題。異常處理與用戶反饋用try...except包裹執(zhí)行邏輯一旦出錯(cuò)事務(wù)回滾并向用戶展示友好的錯(cuò)誤信息。使用Django的messages框架來(lái)傳遞成功或失敗的消息這是Web應(yīng)用的標(biāo)準(zhǔn)做法。4.3 使用Django Admin進(jìn)行快速數(shù)據(jù)管理對(duì)于進(jìn)銷存系統(tǒng)的后臺(tái)管理即使有獨(dú)立開(kāi)發(fā)的前端Django Admin依然是一個(gè)強(qiáng)大的內(nèi)部工具。在admin.py中你可以進(jìn)行深度定制from django.contrib import admin from .models import PurchaseOrder, PurchaseOrderItem class PurchaseOrderItemInline(admin.TabularInline): # 或 StackedInline model PurchaseOrderItem extra 1 # 默認(rèn)顯示的空行數(shù) readonly_fields (amount,) # 金額自動(dòng)計(jì)算設(shè)為只讀 admin.register(PurchaseOrder) class PurchaseOrderAdmin(admin.ModelAdmin): list_display (order_number, supplier, order_date, total_amount, status, created_by) list_filter (status, order_date, supplier) search_fields (order_number, supplier__name) # 支持關(guān)聯(lián)字段搜索 inlines [PurchaseOrderItemInline] # 內(nèi)聯(lián)編輯明細(xì) actions [confirm_order] def confirm_order(self, request, queryset): 自定義Admin動(dòng)作批量審核采購(gòu)單 for order in queryset.filter(statusdraft): # 這里應(yīng)調(diào)用前面提到的審核邏輯更新庫(kù)存等 # 為簡(jiǎn)化示例僅更新?tīng)顟B(tài) order.status confirmed order.save() self.message_user(request, f已審核 {queryset.count()} 個(gè)采購(gòu)單。) confirm_order.short_description 審核選中的采購(gòu)單通過(guò)這樣的配置你可以在Admin界面中直接創(chuàng)建采購(gòu)單并在同一個(gè)頁(yè)面添加、編輯其明細(xì)項(xiàng)通過(guò)TabularInline非常高效。list_filter和search_fields極大地提升了數(shù)據(jù)查找效率。自定義actionconfirm_order則可以將復(fù)雜的業(yè)務(wù)流程封裝成一個(gè)按鈕方便管理員批量操作。5. 項(xiàng)目擴(kuò)展與生產(chǎn)環(huán)境部署思考一個(gè)課程或畢業(yè)設(shè)計(jì)項(xiàng)目在本地跑起來(lái)只是第一步。如何讓它更完整、更接近真實(shí)應(yīng)用這里有幾個(gè)擴(kuò)展方向。5.1 功能擴(kuò)展建議權(quán)限系統(tǒng)精細(xì)化Django自帶的權(quán)限系統(tǒng)auth比較基礎(chǔ)。你可以引入django-guardian來(lái)實(shí)現(xiàn)對(duì)象級(jí)別的權(quán)限控制例如銷售員只能看到自己創(chuàng)建的客戶。或者根據(jù)業(yè)務(wù)角色如采購(gòu)員、銷售員、倉(cāng)管員、經(jīng)理設(shè)計(jì)不同的菜單和操作權(quán)限。報(bào)表與數(shù)據(jù)分析實(shí)現(xiàn)更豐富的統(tǒng)計(jì)報(bào)表。儀表盤在首頁(yè)展示關(guān)鍵指標(biāo)如當(dāng)日銷售額、采購(gòu)額、低庫(kù)存商品列表、近30天銷售趨勢(shì)圖?？梢允褂肅hart.js或ECharts等前端圖表庫(kù)后端提供聚合數(shù)據(jù)的API。利潤(rùn)分析計(jì)算毛利需要成本價(jià)。這需要你在采購(gòu)入庫(kù)時(shí)記錄商品的“移動(dòng)加權(quán)平均成本”或“批次成本”并在銷售出庫(kù)時(shí)確定成本結(jié)轉(zhuǎn)方式。這是進(jìn)銷存系統(tǒng)從“記錄”走向“管理”的關(guān)鍵一步。打印與導(dǎo)出增加打印銷售單、采購(gòu)單、庫(kù)存盤點(diǎn)單的功能?？梢允褂肳easyPrint或ReportLab生成PDF或者直接優(yōu)化HTML模板進(jìn)行打印。數(shù)據(jù)導(dǎo)出為Excel使用openpyxl或pandas也是一個(gè)很實(shí)用的功能。API接口為未來(lái)可能的移動(dòng)端或第三方系統(tǒng)集成做準(zhǔn)備。使用Django REST framework (DRF) 快速構(gòu)建一套R(shí)ESTful API提供商品、庫(kù)存、訂單的查詢和創(chuàng)建能力。5.2 部署上線從開(kāi)發(fā)到生產(chǎn)在本地開(kāi)發(fā)時(shí)我們使用runserver和SQLite。但要對(duì)外提供服務(wù)這遠(yuǎn)遠(yuǎn)不夠。更換數(shù)據(jù)庫(kù)SQLite不適合高并發(fā)的生產(chǎn)環(huán)境。首選是PostgreSQL或MySQL。修改settings.py中的DATABASES配置安裝對(duì)應(yīng)的數(shù)據(jù)庫(kù)適配器psycopg2或mysqlclient并使用python manage.py migrate重新初始化數(shù)據(jù)庫(kù)。收集靜態(tài)文件開(kāi)發(fā)時(shí)Django動(dòng)態(tài)伺服靜態(tài)文件生產(chǎn)環(huán)境需要由Web服務(wù)器如Nginx來(lái)處理。運(yùn)行python manage.py collectstatic命令將所有靜態(tài)文件收集到STATIC_ROOT指定的目錄。選擇WSGI服務(wù)器runserver性能很差。使用Gunicorn或uWSGI作為應(yīng)用服務(wù)器。例如用Gunicorn啟動(dòng)gunicorn your_project.wsgi:application -b 0.0.0.0:8000 -w 4。使用Nginx作為反向代理Nginx處理靜態(tài)文件、SSL加密HTTPS、負(fù)載均衡并將動(dòng)態(tài)請(qǐng)求轉(zhuǎn)發(fā)給Gunicorn。一個(gè)簡(jiǎn)單的Nginx配置片段如下server { listen 80; server_name your_domain.com; location /static/ { alias /path/to/your/static_root/; } location /media/ { alias /path/to/your/media_root/; } location / { proxy_pass http://127.0.0.1:8000; # 轉(zhuǎn)發(fā)給Gunicorn proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }環(huán)境變量與安全設(shè)置絕不要將SECRET_KEY、數(shù)據(jù)庫(kù)密碼等敏感信息硬編碼在settings.py里。使用python-decouple或django-environ庫(kù)從環(huán)境變量中讀取。同時(shí)確保生產(chǎn)環(huán)境中DEBUG False并正確配置ALLOWED_HOSTS。進(jìn)程管理使用Systemd或Supervisor來(lái)管理Gunicorn進(jìn)程確保應(yīng)用在服務(wù)器重啟后能自動(dòng)運(yùn)行。從學(xué)習(xí)這個(gè)Django進(jìn)銷存項(xiàng)目源碼開(kāi)始到理解其設(shè)計(jì)再到擴(kuò)展功能并最終部署上線這是一個(gè)完整的全棧開(kāi)發(fā)學(xué)習(xí)路徑。這個(gè)項(xiàng)目提供的不僅僅是一份代碼更是一個(gè)理解業(yè)務(wù)邏輯、框架運(yùn)用和軟件工程實(shí)踐的優(yōu)秀范本。我建議你在運(yùn)行通讀源碼后嘗試在不看源碼的情況下自己從頭實(shí)現(xiàn)一個(gè)簡(jiǎn)化版過(guò)程中再回頭對(duì)照這樣的收獲會(huì)是最大的。本文還有配套的精品資源點(diǎn)擊獲取