做畢業(yè)設(shè)計(jì)選方向的時(shí)候我在選題表上看到編號(hào)20167這個(gè)課題——“基于Python的企業(yè)資產(chǎn)管理系統(tǒng)”第一反應(yīng)是這不就是又一個(gè)XX管理系統(tǒng)換皮嗎后來真正動(dòng)手做才發(fā)現(xiàn)資產(chǎn)管理這類系統(tǒng)難的不是增刪改查而是“資產(chǎn)的狀態(tài)流轉(zhuǎn)”和“賬實(shí)一致”。如果用一句話總結(jié)這個(gè)項(xiàng)目它就是一個(gè)給企業(yè)管“家底”的系統(tǒng)把公司所有固定資產(chǎn)從登記入庫、領(lǐng)用歸還、維修保養(yǎng)到報(bào)廢處置的全過程管起來讓每一臺(tái)電腦、每一張辦公桌在哪個(gè)部門、誰手上、狀態(tài)如何都能實(shí)時(shí)查得到賬本和實(shí)物對(duì)得上。這套系統(tǒng)從需求角度來說很有代表性技術(shù)棧又非常舒服Python 3 Flask SQLite/MySQL全是畢業(yè)設(shè)計(jì)和中小型企業(yè)信息化的主流選擇。不管你是計(jì)算機(jī)專業(yè)的應(yīng)屆生還是想自己搭一套內(nèi)網(wǎng)工具的非專業(yè)開發(fā)者這個(gè)項(xiàng)目都有很強(qiáng)的參考價(jià)值。我這次把這套系統(tǒng)的設(shè)計(jì)邏輯、數(shù)據(jù)庫結(jié)構(gòu)、核心功能實(shí)現(xiàn)、部署過程以及我踩過的坑完整復(fù)盤一遍源碼相關(guān)的使用方式也會(huì)一并說明白。1. 項(xiàng)目整體定位這個(gè)畢設(shè)到底要解決什么問題1.1 課題編號(hào)和表象之下的真實(shí)需求先說個(gè)實(shí)在話很多同學(xué)一看到“XX管理系統(tǒng)”就本能地覺得簡(jiǎn)單但實(shí)際上管理類系統(tǒng)的難點(diǎn)從來不是技術(shù)而是業(yè)務(wù)建模。這個(gè)課題編號(hào)20167的企業(yè)資產(chǎn)管理系統(tǒng)表面上要求的模塊很常規(guī)——資產(chǎn)信息管理、資產(chǎn)分類、領(lǐng)用歸還、維修記錄、報(bào)廢管理和統(tǒng)計(jì)報(bào)表但把這些模塊串起來以后它真正要回答的問題是企業(yè)里任何一件資產(chǎn)能不能在任意時(shí)刻回答出“它是什么、在誰手里、什么狀態(tài)、經(jīng)歷了什么”。做項(xiàng)目之前我特意翻了一些企業(yè)固定資產(chǎn)管理的實(shí)際場(chǎng)景。中小企業(yè)最常見的痛點(diǎn)是Excel臺(tái)賬和實(shí)物脫節(jié)公司買了一百臺(tái)電腦行政Excel里記錄著“大概在哪個(gè)部門”但實(shí)際誰在用、有沒有壞、有沒有丟完全靠腦子記。等到年底盤點(diǎn)要么資產(chǎn)找不到要么賬上還在用的設(shè)備其實(shí)早就報(bào)廢了。所以這個(gè)系統(tǒng)在設(shè)計(jì)時(shí)就不能做成“純記錄工具”至少要做到每一筆變動(dòng)都有流水、狀態(tài)能追蹤、賬實(shí)能核對(duì)這才是“管理”的價(jià)值所在。1.2 看懂企業(yè)資產(chǎn)管理的業(yè)務(wù)全貌拋開代碼先梳理業(yè)務(wù)企業(yè)資產(chǎn)管理EAM其實(shí)可以拆成兩條線一條是資產(chǎn)的靜態(tài)檔案另一條是資產(chǎn)的動(dòng)態(tài)流轉(zhuǎn)。靜態(tài)檔案就是資產(chǎn)的基本信息資產(chǎn)編號(hào)、名稱、分類、購置日期、金額、供應(yīng)商、存放位置、當(dāng)前責(zé)任人動(dòng)態(tài)流轉(zhuǎn)則是從入庫那一刻開始到領(lǐng)用、退庫、維修、調(diào)撥、報(bào)廢每一個(gè)動(dòng)作都會(huì)改變資產(chǎn)的狀態(tài)也都應(yīng)該留下可追溯的日志。以最常見的電腦管理舉例公司新采購50臺(tái)筆記本行政先錄入資產(chǎn)臺(tái)賬每臺(tái)電腦生成唯一資產(chǎn)編號(hào)員工領(lǐng)用時(shí)系統(tǒng)記錄領(lǐng)用人、部門、領(lǐng)用時(shí)間電腦狀態(tài)從“在庫”變成“在用”如果電腦壞了進(jìn)入維修流程狀態(tài)變成“維修中”修好之后回到“在用”最終這臺(tái)電腦太舊了發(fā)起報(bào)廢審批狀態(tài)變成“已報(bào)廢”。這一套走下來資產(chǎn)生命周期才算完整。系統(tǒng)的表結(jié)構(gòu)、代碼邏輯、頁面流程本質(zhì)上都是在服務(wù)這套狀態(tài)機(jī)。1.3 為什么選Python而不是Java或Go選型這件事我是在對(duì)比過同學(xué)用的方案之后才想明白的。Java做管理系統(tǒng)確實(shí)是傳統(tǒng)選項(xiàng)Spring Boot加MyBatis一套下來很規(guī)范但問題在于學(xué)生時(shí)期接觸Spring全家桶很容易被配置和概念淹沒一個(gè)過濾器、一個(gè)事務(wù)注解能折騰半天最后項(xiàng)目成了“背框架”業(yè)務(wù)反而沒吃透。Go則是資料相對(duì)少班級(jí)里能討論的人也少遇到問題求助成本高。Python的Python優(yōu)點(diǎn)恰恰是“上手快、生態(tài)全、表達(dá)直接”。這個(gè)系統(tǒng)最重的部分——Web框架、數(shù)據(jù)庫操作、Excel導(dǎo)入導(dǎo)出、登錄認(rèn)證——在Python生態(tài)里都有極其成熟的現(xiàn)成方案Flask處理路由和請(qǐng)求SQLAlchemy操作數(shù)據(jù)庫openpyxl讀寫Excel一條龍下來代碼量比Java少三分之一不止。而且畢業(yè)設(shè)計(jì)的核心目標(biāo)是證明你理解了業(yè)務(wù)建模和軟件工程流程Python的表達(dá)足夠清晰不會(huì)因?yàn)榇a繁瑣而把業(yè)務(wù)邏輯淹沒掉。2. 技術(shù)選型復(fù)盤框架、數(shù)據(jù)庫、前端方案怎么定2.1 Flask、Django、FastAPI三選一技術(shù)選型是答辯時(shí)老師最容易追問的部分所以每一個(gè)決定都要能說出理由。當(dāng)時(shí)Python的Web框架集中在三個(gè)選項(xiàng)里Django、Flask、FastAPI。Django是“全家桶”路線自帶Admin后臺(tái)、ORM、認(rèn)證系統(tǒng)開發(fā)效率極高但它太重了而且Django自帶Admin和自定義業(yè)務(wù)頁面兩者并存時(shí)項(xiàng)目的定制復(fù)雜度反而上升FastAPI性能好、類型提示現(xiàn)代但異步和Pydantic這些概念對(duì)于一個(gè)資管系統(tǒng)來說屬于過度設(shè)計(jì)且資料更新太快學(xué)生階段容易被帶偏。最后選了Flask理由特別樸素Flask足夠輕路由、模板、會(huì)話這些都自己可控學(xué)習(xí)曲線平滑它給開發(fā)者留了自由度所有業(yè)務(wù)代碼都在自己的項(xiàng)目結(jié)構(gòu)里答辯時(shí)能講清楚每一條路由、每一個(gè)視圖函數(shù)做了什么。我需要特別說明一點(diǎn)Flask本身不強(qiáng)制項(xiàng)目結(jié)構(gòu)所以源碼包里有Blueprint的應(yīng)用方式這是一種非常值得學(xué)習(xí)的分層組織方法后面會(huì)詳細(xì)講。2.2 SQLite起步、MySQL兼容的數(shù)據(jù)庫路線數(shù)據(jù)庫也是踩過坑之后才堅(jiān)定路線的。一開始直接上MySQL結(jié)果光是本地安裝、配置字符集、賬號(hào)授權(quán)就勸退了好幾個(gè)同學(xué)。這個(gè)項(xiàng)目源碼默認(rèn)使用的是SQLite理由不用多說文件即數(shù)據(jù)庫零配置文件隨手就能跑起來對(duì)不同操作系統(tǒng)都很友好。但畢業(yè)設(shè)計(jì)不能只停留在“能跑”還要體現(xiàn)數(shù)據(jù)庫設(shè)計(jì)能力。所以在表結(jié)構(gòu)設(shè)計(jì)上從一開始就按照MySQL的規(guī)范來字段類型、主鍵外鍵、唯一約束、索引規(guī)劃全部按標(biāo)準(zhǔn)寫。后期如果想切換到MySQL只需要改配置里的連接串和數(shù)據(jù)庫驅(qū)動(dòng)即可業(yè)務(wù)代碼不需要?jiǎng)印＿@種“SQLite開發(fā)、MySQL部署”的思路在中小型項(xiàng)目里非常實(shí)用也讓我在答辯時(shí)能落落大方地講清楚開發(fā)環(huán)境與生產(chǎn)環(huán)境的差異處理。2.3 前端不搞花活模板渲染優(yōu)先前端方案是這個(gè)項(xiàng)目里被問得最多的一項(xiàng)也是需要明確取舍的地方。這套系統(tǒng)采用了服務(wù)端模板渲染Jinja2模板搭配Bootstrap 5頁面樣式中規(guī)中矩但沒有花里胡哨的過度設(shè)計(jì)。為什么不拆前后端原因很現(xiàn)實(shí)資產(chǎn)管理系統(tǒng)的用戶是行政、財(cái)務(wù)、IT管理員不是追求炫酷交互的C端用戶核心訴求是表格清晰、表單順手、統(tǒng)計(jì)直觀而且前后端分離意味著要同時(shí)維護(hù)兩套代碼、處理跨域、考慮Token鑒權(quán)復(fù)雜度會(huì)翻倍對(duì)畢設(shè)來說未必是加分項(xiàng)。當(dāng)然模板渲染不代表完全放棄交互體驗(yàn)項(xiàng)目中一些需要局部刷新的場(chǎng)景比如資產(chǎn)篩選、狀態(tài)切換適度引入了一些原生JavaScript和簡(jiǎn)單的Fetch請(qǐng)求讓頁面不必整個(gè)刷新體驗(yàn)上更接近現(xiàn)代網(wǎng)頁。這個(gè)折中策略在答辯論證時(shí)比較站得住腳既有傳統(tǒng)服務(wù)端渲染的穩(wěn)定性又有適度的前端交互亮點(diǎn)。3. 數(shù)據(jù)庫設(shè)計(jì)與核心邏輯實(shí)現(xiàn)3.1 數(shù)據(jù)表設(shè)計(jì)先把資產(chǎn)“戶口”立好打開源碼的schema.sql或者models.py你會(huì)看到這套系統(tǒng)的數(shù)據(jù)表并不是只建一張“資產(chǎn)表”就完事。我的設(shè)計(jì)思路是把資產(chǎn)、人員、分類、流轉(zhuǎn)記錄拆開再用外鍵關(guān)聯(lián)避免在一個(gè)表里塞爆所有信息。先給核心的表結(jié)構(gòu)做一個(gè)梳理表名用途關(guān)鍵字段user系統(tǒng)用戶表id, username, password_hash, role, real_name, departmentcategory資產(chǎn)分類表id, name, code, remarkasset資產(chǎn)臺(tái)賬表id, asset_code, name, category_id, status, price, purchase_date, location, holder_idassign_log領(lǐng)用歸還流水表id, asset_id, user_id, action_type, create_time, remarkrepair_log維修記錄表id, asset_id, reason, cost, result, create_timescrap_log報(bào)廢記錄表id, asset_id, reason, approve_user, create_timecheck_record盤點(diǎn)記錄表id, asset_id, check_time, result, operator這張表結(jié)構(gòu)看起來不復(fù)雜但它解決了一個(gè)核心問題資產(chǎn)臺(tái)賬表里只保留“當(dāng)前狀態(tài)”和“當(dāng)前持有人”所有的歷史動(dòng)作都放到流水表里。剛開始做的時(shí)候我犯過一個(gè)典型錯(cuò)誤想用一張字段超級(jí)多的表記錄領(lǐng)用歷史結(jié)果數(shù)據(jù)冗余嚴(yán)重查一次列表要寫十幾行條件判斷。后來改成“一賬一流水”的設(shè)計(jì)查詢瞬間清爽查當(dāng)前持有人看asset表查歷史記錄看assign_log表按資產(chǎn)ID一搜就有。3.2 用戶認(rèn)證與權(quán)限控制邏輯權(quán)限設(shè)計(jì)是管理系統(tǒng)逃不開的環(huán)節(jié)這套系統(tǒng)的權(quán)限模型雖然簡(jiǎn)單但結(jié)構(gòu)很正規(guī)。用戶表里有個(gè)role字段區(qū)分admin和管理員這類角色普通用戶則只能查看與自己相關(guān)的資產(chǎn)。登錄成功之后服務(wù)端把用戶ID和角色寫入Session然后通過裝飾器統(tǒng)一做登錄校驗(yàn)和權(quán)限校驗(yàn)。核心代碼思路大致是這樣from functools import wraps from flask import session, redirect, url_for, abort def login_required(func): wraps(func) def wrapper(*args, **kwargs): if not session.get(user_id): return redirect(url_for(auth.login)) return func(*args, **kwargs) return wrapper def admin_required(func): wraps(func) def wrapper(*args, **kwargs): if session.get(role) ! admin: abort(403) return func(*args, **kwargs) return wrapper密碼存儲(chǔ)用的是哈希而不是明文代碼里不寫硬編碼密碼初始化管理員賬號(hào)時(shí)調(diào)用generate_password_hash生成哈希值存庫。這個(gè)細(xì)節(jié)在答辯時(shí)非常加分直接證明了對(duì)信息安全的認(rèn)知。登錄頁面還有簡(jiǎn)單的驗(yàn)證碼機(jī)制雖然只是基礎(chǔ)的數(shù)字驗(yàn)證碼但能把“防止暴力破解”這個(gè)意識(shí)體現(xiàn)出來。3.3 資產(chǎn)生命周期一張狀態(tài)圖管住全流程資產(chǎn)生命周期是這套系統(tǒng)最核心的邏輯也是和普通“信息登記系統(tǒng)”拉開差距的地方。資產(chǎn)表里的status字段我設(shè)計(jì)用了可讀性強(qiáng)的字符串常量in_stock代表在庫in_use代表在用repairing代表維修中scrapped代表已報(bào)廢。每次執(zhí)行領(lǐng)用、歸還、維修、報(bào)廢操作時(shí)都要做狀態(tài)校驗(yàn)確保流程合法在庫資產(chǎn)才能被領(lǐng)用在用資產(chǎn)不能直接報(bào)廢報(bào)廢需要走審批字段。為了讓狀態(tài)流轉(zhuǎn)可控封裝了一個(gè)簡(jiǎn)單函數(shù)def change_asset_status(asset_id, new_status, operator_id, action_type, remark): asset Asset.query.get_or_404(asset_id) # 狀態(tài)機(jī)校驗(yàn) valid_transitions { in_stock: [in_use, scrapped], in_use: [in_stock, repairing], repairing: [in_use, scrapped], scrapped: [] } if new_status not in valid_transitions.get(asset.status, []): raise ValueError(非法的狀態(tài)流轉(zhuǎn)) asset.status new_status db.session.commit() log AssignLog(asset_idasset_id, user_idoperator_id, action_typeaction_type, remarkremark) db.session.add(log) db.session.commit()把狀態(tài)流轉(zhuǎn)集中在一個(gè)函數(shù)里比在視圖里散落各種if判斷要安全得多。后來排查問題的時(shí)候我發(fā)現(xiàn)大部分?jǐn)?shù)據(jù)錯(cuò)亂都來源于某些視圖函數(shù)直接改了status字段卻忘記寫日志所以統(tǒng)一入口這招非常重要。這也是我從這個(gè)項(xiàng)目里學(xué)到的最值錢的經(jīng)驗(yàn)之一。4. 從零跑通核心流程目錄結(jié)構(gòu)、資產(chǎn)臺(tái)賬與盤點(diǎn)實(shí)操4.1 項(xiàng)目目錄結(jié)構(gòu)與源碼文件說明拿到源碼之后第一件事是看懂目錄結(jié)構(gòu)不要急著運(yùn)行。這套項(xiàng)目的目錄組織用的是Flask的Blueprint分層結(jié)構(gòu)源碼包一般長這樣asset_system/ ├── app.py # 應(yīng)用入口注冊(cè)藍(lán)圖和配置 ├── config.py # 配置信息含數(shù)據(jù)庫連接、安全密鑰 ├── requirements.txt # Python依賴列表 ├── init_db.py # 初始化數(shù)據(jù)庫腳本 ├── utils/ │ ├── decorators.py # 登錄/權(quán)限裝飾器 │ └── helpers.py # 通用工具函數(shù) ├── modules/ │ ├── auth/ # 登錄認(rèn)證模塊 │ ├── asset/ # 資產(chǎn)管理模塊臺(tái)賬、領(lǐng)用、歸還 │ ├── repair/ # 維修管理模塊 │ ├── scrap/ # 報(bào)廢管理模塊 │ ├── statistics/ # 統(tǒng)計(jì)和報(bào)表模塊 │ └── check/ # 盤點(diǎn)模塊 ├── templates/ # Jinja2模板目錄 ├── static/ # CSS/JS/圖片等靜態(tài)資源 └── uploads/ # Excel導(dǎo)入導(dǎo)出臨時(shí)目錄這樣組織的用意是讓每個(gè)業(yè)務(wù)模塊獨(dú)立成包路由都注冊(cè)在Blueprint上。例如資產(chǎn)管理模塊里有一個(gè)asset_bp對(duì)象資產(chǎn)臺(tái)賬的列表、新增、編輯、導(dǎo)入、導(dǎo)出全部在asset模塊內(nèi)部完成不會(huì)和其他模塊的代碼攪在一起。答辯時(shí)老師如果問到“項(xiàng)目可維護(hù)性”這個(gè)結(jié)構(gòu)本身就是答案。4.2 資產(chǎn)登記與Excel批量導(dǎo)入的實(shí)現(xiàn)思路系統(tǒng)最基本的操作是“新增資產(chǎn)”單個(gè)新增的頁面很簡(jiǎn)單就是一個(gè)Form表單包含資產(chǎn)編號(hào)、名稱、分類、金額、購置日期、存放位置等信息。但企業(yè)場(chǎng)景里更常用的是批量導(dǎo)入否則幾百條資產(chǎn)一條條錄再好的系統(tǒng)也沒人愿意用。這個(gè)項(xiàng)目的Excel導(dǎo)入功能用的是openpyxl庫流程是上傳Excel文件讀取Sheet內(nèi)容逐行校驗(yàn)必填項(xiàng)和格式然后批量寫入數(shù)據(jù)庫。這里有一個(gè)值得說的細(xì)節(jié)資產(chǎn)編號(hào)的生成策略不能依賴用戶手動(dòng)輸入否則很容易重復(fù)。這個(gè)系統(tǒng)采用的是“分類編碼日期序列號(hào)”的規(guī)則比如IT類資產(chǎn)生成“IT-20250618-001”下次再添加就自動(dòng)遞增。這個(gè)規(guī)則在代碼里單獨(dú)寫了一個(gè)函數(shù)維護(hù)新增資產(chǎn)時(shí)不要求用戶填編號(hào)系統(tǒng)自動(dòng)生成既保證了唯一性也讓臺(tái)賬看起來非常規(guī)整。批量導(dǎo)入時(shí)如果Excel里沒有編號(hào)列系統(tǒng)也會(huì)自動(dòng)補(bǔ)全。4.3 盤點(diǎn)、折舊和統(tǒng)計(jì)報(bào)表的演示效果資產(chǎn)盤點(diǎn)是年終最頭疼的事情這個(gè)系統(tǒng)把盤點(diǎn)邏輯做得比較實(shí)用。盤點(diǎn)模塊可以按分類、部門、保管人篩選資產(chǎn)生成盤點(diǎn)清單線下清點(diǎn)過后把結(jié)果錄入系統(tǒng)與庫里的記錄做比對(duì)自動(dòng)生成“賬實(shí)相符”和“盤盈盤虧”兩類結(jié)果。盤虧的資產(chǎn)會(huì)被標(biāo)記待處理并關(guān)聯(lián)到對(duì)應(yīng)的責(zé)任人字段方便后續(xù)追蹤。統(tǒng)計(jì)報(bào)表部分用了ECharts做圖表。打開統(tǒng)計(jì)頁面首先看到的是總資產(chǎn)金額、總資產(chǎn)數(shù)量、在用數(shù)量、維修中數(shù)量這幾個(gè)核心卡片下面是按分類統(tǒng)計(jì)的柱狀圖和各狀態(tài)的餅圖。數(shù)據(jù)不是從某一張表直接count出來的而是通過SQLAlchemy的聚合查詢比如group_by(category.name)之后配合func.sum、func.count得到。這里想提醒一下統(tǒng)計(jì)查詢的SQL寫法要自己真正跑一下很多同學(xué)在這里直接把全表數(shù)據(jù)load到內(nèi)存里做統(tǒng)計(jì)資產(chǎn)數(shù)據(jù)量上來之后頁面會(huì)非?？?。5. 源碼使用與本地部署手記5.1 環(huán)境準(zhǔn)備Python版本、依賴安裝、數(shù)據(jù)庫初始化這個(gè)項(xiàng)目對(duì)環(huán)境的寬容度很高Python 3.8到3.10實(shí)測(cè)都能正常運(yùn)行。我建議直接用3.10這個(gè)版本兼容性和坑的解決方案都比較齊全。環(huán)境準(zhǔn)備的第一步是創(chuàng)建虛擬環(huán)境再用requirements.txt安裝依賴python -m venv venv source venv/bin/activate # Windows系統(tǒng)執(zhí)行 venv\Scripts\activate pip install -r requirements.txtrequirements.txt里包含的核心庫就那么幾個(gè)Flask、Flask-SQLAlchemy、openpyxl、pandas、pyecharts或echarts相關(guān)、pillow驗(yàn)證碼生成用。安裝的時(shí)候如果網(wǎng)絡(luò)波動(dòng)導(dǎo)致下載失敗隨便換一個(gè)鏡像源就好這不是項(xiàng)目本身的問題。依賴裝完后執(zhí)行初始化腳本創(chuàng)建數(shù)據(jù)庫文件和管理員賬號(hào)python init_db.py init_db.py # 內(nèi)部會(huì)創(chuàng)建SQLite文件asset.db并寫入默認(rèn)管理員賬號(hào)有個(gè)細(xì)節(jié)值得說一下初始化腳本執(zhí)行完后終端會(huì)打印默認(rèn)管理員用戶名和初始密碼第一次登錄系統(tǒng)后應(yīng)該立刻修改密碼。這個(gè)點(diǎn)雖然小但體現(xiàn)了項(xiàng)目在交付時(shí)對(duì)“開箱即用”和“安全可用”的兼顧。5.2 啟動(dòng)項(xiàng)目從命令行到瀏覽器啟動(dòng)方式非常簡(jiǎn)單不需要額外配置python app.py看到類似 * Running on http://127.0.0.1:5000 的輸出后瀏覽器訪問本機(jī)5000端口就能打開登錄頁面。F12打開開發(fā)者工具能看到登錄請(qǐng)求返回的Session Cookie這說明會(huì)話管理已經(jīng)生效。下面用表格把啟動(dòng)階段最高頻的幾個(gè)問題列一下方便對(duì)號(hào)入座現(xiàn)象原因解法ModuleNotFoundError: No module named flask依賴沒有在虛擬環(huán)境安裝或裝到了別的環(huán)境確認(rèn)venv已激活重新執(zhí)行pip installsqlite3.OperationalError: table user already exists重復(fù)執(zhí)行了init_db.py刪除asset.db文件后重新初始化Port 5000 already in use端口被占用改端口app.run(port5001)頁面中文亂碼模板或系統(tǒng)編碼問題統(tǒng)一使用UTF-8檢查保存文件時(shí)的編碼驗(yàn)證碼圖片不顯示缺少Pillow依賴安裝Pillow后重啟5.3 可選的MySQL切換與部署擴(kuò)展如果想讓項(xiàng)目看上去更有“企業(yè)級(jí)”的質(zhì)感把SQLite切到MySQL是一個(gè)性價(jià)比極高的小改造。步驟很簡(jiǎn)單MySQL里先建一個(gè)數(shù)據(jù)庫在config.py里把連接串改成SQLALCHEMY_DATABASE_URI mysqlpymysql://root:密碼localhost:3306/asset_db?charsetutf8mb4然后加上PyMySQL依賴重新執(zhí)行數(shù)據(jù)庫初始化。唯一需要留意的坑是MySQL的排序規(guī)則統(tǒng)一用utf8mb4避免中文檢索出問題。這個(gè)切換證明了項(xiàng)目的數(shù)據(jù)訪問層封裝得足夠好不會(huì)因?yàn)閾Q數(shù)據(jù)庫導(dǎo)致大規(guī)模改動(dòng)。更進(jìn)一步的擴(kuò)展方向還包括支持多部門獨(dú)立數(shù)據(jù)權(quán)限、增加資產(chǎn)二維碼標(biāo)簽生成、對(duì)接企業(yè)微信通知等等這些方向在論文的“展望”部分寫出來會(huì)非常自然。6. 調(diào)試實(shí)錄我踩過的坑和排查方法6.1 狀態(tài)流轉(zhuǎn)校驗(yàn)缺失導(dǎo)致的數(shù)據(jù)錯(cuò)亂開發(fā)中途出現(xiàn)過一次比較嚴(yán)重的邏輯問題某次直接在視圖里寫了asset.status scrapped但沒有調(diào)用統(tǒng)一的狀態(tài)變更函數(shù)也沒有寫報(bào)廢日志結(jié)果盤點(diǎn)上出了“已報(bào)廢資產(chǎn)還有領(lǐng)用人”的矛盾數(shù)據(jù)。排查方式是把a(bǔ)ssign_log流水導(dǎo)出來按資產(chǎn)ID和時(shí)間排序發(fā)現(xiàn)狀態(tài)跳過了維修和歸還兩個(gè)環(huán)節(jié)。這次的經(jīng)驗(yàn)給我一個(gè)很深的教訓(xùn)業(yè)務(wù)規(guī)則必須收斂到一個(gè)入口不能讓每個(gè)視圖自己隨便改核心字段。修復(fù)方式就是前面講的change_asset_status統(tǒng)一封裝并且在入庫前做狀態(tài)機(jī)校驗(yàn)。從那以后我再也沒有被類似的數(shù)據(jù)錯(cuò)亂問題困擾過。如果你是拿了源碼自己二次開發(fā)強(qiáng)烈建議保留這個(gè)設(shè)計(jì)不要圖省事在多個(gè)地方改status。6.2 Excel導(dǎo)入與文件上傳的隱蔽問題Excel導(dǎo)入功能剛做完時(shí)測(cè)試人員反饋“數(shù)量多的時(shí)候容易卡”我第一反應(yīng)是代碼循環(huán)太慢。后來定位發(fā)現(xiàn)瓶頸在逐條commit1000條數(shù)據(jù)commit了1000次數(shù)據(jù)庫IO開銷巨大。優(yōu)化方案很簡(jiǎn)單構(gòu)造好對(duì)象列表后一次性db.session.add_all再提交速度直接提升到原來的五倍以上。這也是實(shí)際開發(fā)中很常見的一個(gè)性能優(yōu)化點(diǎn)。文件上傳還有一個(gè)隱蔽坑接收UploadFile時(shí)沒有校驗(yàn)擴(kuò)展名導(dǎo)致有人傳了非Excel文件程序直接崩潰。修復(fù)方式是先用safe_join處理文件路徑再用filename.endswith校驗(yàn)擴(kuò)展名白名單。安全方面也要提醒一句凡是用戶上傳的內(nèi)容路徑穿越和非法文件類型這兩道校驗(yàn)必須做否則系統(tǒng)很容易被攻擊利用。6.3 答辯復(fù)盤老師最關(guān)注的幾個(gè)點(diǎn)做完這個(gè)項(xiàng)目之后我的感受是一套畢業(yè)設(shè)計(jì)系統(tǒng)的好壞七分在設(shè)計(jì)三分在實(shí)現(xiàn)而答辯就是把你設(shè)計(jì)時(shí)的思考講清楚。我遇到的幾個(gè)高頻提問和對(duì)應(yīng)的答題思路是這樣。老師問“為什么資產(chǎn)狀態(tài)不直接用數(shù)字而用字符串”我就回答字符串可讀性強(qiáng)、日志直觀、不容易發(fā)生枚舉值映射混亂配合狀態(tài)機(jī)的合法流轉(zhuǎn)校驗(yàn)數(shù)據(jù)的正確性才有保證。老師問“系統(tǒng)能支撐多少資產(chǎn)量級(jí)”我如實(shí)回答基于SQLite在幾千條以下非常流暢切到MySQL后支撐幾萬條也沒有問題因?yàn)榱斜砗徒y(tǒng)計(jì)都走了分頁沒有一次性全量查詢。還有一個(gè)印象很深的問題“如果一家公司有多個(gè)分公司這個(gè)系統(tǒng)怎么辦”。我當(dāng)時(shí)坦誠地講現(xiàn)在的設(shè)計(jì)是針對(duì)單組織的但表結(jié)構(gòu)里預(yù)留了部門字段和權(quán)限角色擴(kuò)展成多組織只需要增加company_id來隔離數(shù)據(jù)即可。這個(gè)回答雖然沒有真正實(shí)現(xiàn)但老師對(duì)我的設(shè)計(jì)思路比較認(rèn)可。能把“現(xiàn)狀”和“擴(kuò)展”兩個(gè)維度講清楚項(xiàng)目就能立住。最后如果再分享一點(diǎn)個(gè)人體會(huì)畢業(yè)設(shè)計(jì)技術(shù)本身并沒有多么高深真正賺錢的是“把業(yè)務(wù)梳理清楚、把邊界劃明白”的能力。這套資產(chǎn)管理系統(tǒng)的開發(fā)過程讓我從拿著Excel表格記錄資產(chǎn)到理解什么是狀態(tài)機(jī)、什么是數(shù)據(jù)一致性、什么是權(quán)限控制這些認(rèn)知是刷一百道算法題都換不來的。如果你也想拿這個(gè)課題練手建議不要只滿足于把源碼跑起來把狀態(tài)流轉(zhuǎn)和報(bào)表統(tǒng)計(jì)這兩個(gè)核心環(huán)節(jié)親手改一遍收獲會(huì)大得多。