做畢業(yè)設(shè)計(jì)選方向的時(shí)候我在選題表上看到編號20167這個(gè)課題——“基于Python的企業(yè)資產(chǎn)管理系統(tǒng)”第一反應(yīng)是這不就是又一個(gè)XX管理系統(tǒ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)廢處置的全過程管起來讓每一臺電腦、每一張辦公桌在哪個(gè)部門、誰手上、狀態(tài)如何都能實(shí)時(shí)查得到賬本和實(shí)物對得上。這套系統(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)的使用方式也會一并說明白。1. 項(xiàng)目整體定位這個(gè)畢設(shè)到底要解決什么問題1.1 課題編號和表象之下的真實(shí)需求先說個(gè)實(shí)在話很多同學(xué)一看到“XX管理系統(tǒng)”就本能地覺得簡單但實(shí)際上管理類系統(tǒng)的難點(diǎn)從來不是技術(shù)而是業(yè)務(wù)建模。這個(gè)課題編號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í)際場景。中小企業(yè)最常見的痛點(diǎn)是Excel臺賬和實(shí)物脫節(jié)公司買了一百臺電腦行政Excel里記錄著“大概在哪個(gè)部門”但實(shí)際誰在用、有沒有壞、有沒有丟完全靠腦子記。等到年底盤點(diǎn)要么資產(chǎn)找不到要么賬上還在用的設(shè)備其實(shí)早就報(bào)廢了。所以這個(gè)系統(tǒng)在設(shè)計(jì)時(shí)就不能做成“純記錄工具”至少要做到每一筆變動都有流水、狀態(tài)能追蹤、賬實(shí)能核對這才是“管理”的價(jià)值所在。1.2 看懂企業(yè)資產(chǎn)管理的業(yè)務(wù)全貌拋開代碼先梳理業(yè)務(wù)企業(yè)資產(chǎn)管理EAM其實(shí)可以拆成兩條線一條是資產(chǎn)的靜態(tài)檔案另一條是資產(chǎn)的動態(tài)流轉(zhuǎn)。靜態(tài)檔案就是資產(chǎn)的基本信息資產(chǎn)編號、名稱、分類、購置日期、金額、供應(yīng)商、存放位置、當(dāng)前責(zé)任人動態(tài)流轉(zhuǎn)則是從入庫那一刻開始到領(lǐng)用、退庫、維修、調(diào)撥、報(bào)廢每一個(gè)動作都會改變資產(chǎn)的狀態(tài)也都應(yīng)該留下可追溯的日志。以最常見的電腦管理舉例公司新采購50臺筆記本行政先錄入資產(chǎn)臺賬每臺電腦生成唯一資產(chǎn)編號員工領(lǐng)用時(shí)系統(tǒng)記錄領(lǐng)用人、部門、領(lǐng)用時(shí)間電腦狀態(tài)從“在庫”變成“在用”如果電腦壞了進(jìn)入維修流程狀態(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選型這件事我是在對比過同學(xué)用的方案之后才想明白的。Java做管理系統(tǒng)確實(shí)是傳統(tǒng)選項(xiàng)Spring Boot加MyBatis一套下來很規(guī)范但問題在于學(xué)生時(shí)期接觸Spring全家桶很容易被配置和概念淹沒一個(gè)過濾器、一個(gè)事務(wù)注解能折騰半天最后項(xiàng)目成了“背框架”業(yè)務(wù)反而沒吃透。Go則是資料相對少班級里能討論的人也少遇到問題求助成本高。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處理路由和請求SQLAlchemy操作數(shù)據(jù)庫openpyxl讀寫Excel一條龍下來代碼量比Java少三分之一不止。而且畢業(yè)設(shè)計(jì)的核心目標(biāo)是證明你理解了業(yè)務(wù)建模和軟件工程流程Python的表達(dá)足夠清晰不會因?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后臺、ORM、認(rèn)證系統(tǒng)開發(fā)效率極高但它太重了而且Django自帶Admin和自定義業(yè)務(wù)頁面兩者并存時(shí)項(xiàng)目的定制復(fù)雜度反而上升FastAPI性能好、類型提示現(xiàn)代但異步和Pydantic這些概念對于一個(gè)資管系統(tǒng)來說屬于過度設(shè)計(jì)且資料更新太快學(xué)生階段容易被帶偏。最后選了Flask理由特別樸素Flask足夠輕路由、模板、會話這些都自己可控學(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í)的分層組織方法后面會詳細(xì)講。2.2 SQLite起步、MySQL兼容的數(shù)據(jù)庫路線數(shù)據(jù)庫也是踩過坑之后才堅(jiān)定路線的。一開始直接上MySQL結(jié)果光是本地安裝、配置字符集、賬號授權(quán)就勸退了好幾個(gè)同學(xué)。這個(gè)項(xiàng)目源碼默認(rèn)使用的是SQLite理由不用多說文件即數(shù)據(jù)庫零配置文件隨手就能跑起來對不同操作系統(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ū)動即可業(yè)務(wù)代碼不需要動。這種“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ù)雜度會翻倍對畢設(shè)來說未必是加分項(xiàng)。當(dāng)然模板渲染不代表完全放棄交互體驗(yàn)項(xiàng)目中一些需要局部刷新的場景比如資產(chǎn)篩選、狀態(tài)切換適度引入了一些原生JavaScript和簡單的Fetch請求讓頁面不必整個(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你會看到這套系統(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)臺賬表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)臺賬表里只保留“當(dāng)前狀態(tài)”和“當(dāng)前持有人”所有的歷史動作都放到流水表里。剛開始做的時(shí)候我犯過一個(gè)典型錯(cuò)誤想用一張字段超級多的表記錄領(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é)構(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密碼存儲用的是哈希而不是明文代碼里不寫硬編碼密碼初始化管理員賬號時(shí)調(diào)用generate_password_hash生成哈希值存庫。這個(gè)細(xì)節(jié)在答辯時(shí)非常加分直接證明了對信息安全的認(rèn)知。登錄頁面還有簡單的驗(yàn)證碼機(jī)制雖然只是基礎(chǔ)的數(shù)字驗(yàn)證碼但能把“防止暴力破解”這個(gè)意識體現(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è)簡單函數(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)臺賬與盤點(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)用入口注冊藍(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)管理模塊臺賬、領(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ú)立成包路由都注冊在Blueprint上。例如資產(chǎn)管理模塊里有一個(gè)asset_bp對象資產(chǎn)臺賬的列表、新增、編輯、導(dǎo)入、導(dǎo)出全部在asset模塊內(nèi)部完成不會和其他模塊的代碼攪在一起。答辯時(shí)老師如果問到“項(xiàng)目可維護(hù)性”這個(gè)結(jié)構(gòu)本身就是答案。4.2 資產(chǎn)登記與Excel批量導(dǎo)入的實(shí)現(xiàn)思路系統(tǒng)最基本的操作是“新增資產(chǎn)”單個(gè)新增的頁面很簡單就是一個(gè)Form表單包含資產(chǎn)編號、名稱、分類、金額、購置日期、存放位置等信息。但企業(yè)場景里更常用的是批量導(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)編號的生成策略不能依賴用戶手動輸入否則很容易重復(fù)。這個(gè)系統(tǒng)采用的是“分類編碼日期序列號”的規(guī)則比如IT類資產(chǎn)生成“IT-20250618-001”下次再添加就自動遞增。這個(gè)規(guī)則在代碼里單獨(dú)寫了一個(gè)函數(shù)維護(hù)新增資產(chǎn)時(shí)不要求用戶填編號系統(tǒng)自動生成既保證了唯一性也讓臺賬看起來非常規(guī)整。批量導(dǎo)入時(shí)如果Excel里沒有編號列系統(tǒ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)與庫里的記錄做比對自動生成“賬實(shí)相符”和“盤盈盤虧”兩類結(jié)果。盤虧的資產(chǎn)會被標(biāo)記待處理并關(guān)聯(lián)到對應(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ù)量上來之后頁面會非?？?。5. 源碼使用與本地部署手記5.1 環(huán)境準(zhǔn)備Python版本、依賴安裝、數(shù)據(jù)庫初始化這個(gè)項(xiàng)目對環(huán)境的寬容度很高Python 3.8到3.10實(shí)測都能正常運(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ǎo)致下載失敗隨便換一個(gè)鏡像源就好這不是項(xiàng)目本身的問題。依賴裝完后執(zhí)行初始化腳本創(chuàng)建數(shù)據(jù)庫文件和管理員賬號python init_db.py init_db.py # 內(nèi)部會創(chuàng)建SQLite文件asset.db并寫入默認(rèn)管理員賬號有個(gè)細(xì)節(jié)值得說一下初始化腳本執(zhí)行完后終端會打印默認(rèn)管理員用戶名和初始密碼第一次登錄系統(tǒng)后應(yīng)該立刻修改密碼。這個(gè)點(diǎn)雖然小但體現(xiàn)了項(xiàng)目在交付時(shí)對“開箱即用”和“安全可用”的兼顧。5.2 啟動項(xiàng)目從命令行到瀏覽器啟動方式非常簡單不需要額外配置python app.py看到類似 * Running on http://127.0.0.1:5000 的輸出后瀏覽器訪問本機(jī)5000端口就能打開登錄頁面。F12打開開發(fā)者工具能看到登錄請求返回的Session Cookie這說明會話管理已經(jīng)生效。下面用表格把啟動階段最高頻的幾個(gè)問題列一下方便對號入座現(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è)級”的質(zhì)感把SQLite切到MySQL是一個(gè)性價(jià)比極高的小改造。步驟很簡單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ù)訪問層封裝得足夠好不會因?yàn)閾Q數(shù)據(jù)庫導(dǎo)致大規(guī)模改動。更進(jìn)一步的擴(kuò)展方向還包括支持多部門獨(dú)立數(shù)據(jù)權(quán)限、增加資產(chǎn)二維碼標(biāo)簽生成、對接企業(yè)微信通知等等這些方向在論文的“展望”部分寫出來會非常自然。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í)測試人員反饋“數(shù)量多的時(shí)候容易卡”我第一反應(yīng)是代碼循環(huán)太慢。后來定位發(fā)現(xiàn)瓶頸在逐條commit1000條數(shù)據(jù)commit了1000次數(shù)據(jù)庫IO開銷巨大。優(yōu)化方案很簡單構(gòu)造好對象列表后一次性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è)高頻提問和對應(yīng)的答題思路是這樣。老師問“為什么資產(chǎn)狀態(tài)不直接用數(shù)字而用字符串”我就回答字符串可讀性強(qiáng)、日志直觀、不容易發(fā)生枚舉值映射混亂配合狀態(tài)機(jī)的合法流轉(zhuǎn)校驗(yàn)數(shù)據(jù)的正確性才有保證。老師問“系統(tǒng)能支撐多少資產(chǎn)量級”我如實(shí)回答基于SQLite在幾千條以下非常流暢切到MySQL后支撐幾萬條也沒有問題因?yàn)榱斜砗徒y(tǒng)計(jì)都走了分頁沒有一次性全量查詢。還有一個(gè)印象很深的問題“如果一家公司有多個(gè)分公司這個(gè)系統(tǒng)怎么辦”。我當(dāng)時(shí)坦誠地講現(xiàn)在的設(shè)計(jì)是針對單組織的但表結(jié)構(gòu)里預(yù)留了部門字段和權(quán)限角色擴(kuò)展成多組織只需要增加company_id來隔離數(shù)據(jù)即可。這個(gè)回答雖然沒有真正實(shí)現(xiàn)但老師對我的設(shè)計(jì)思路比較認(rèn)可。能把“現(xiàn)狀”和“擴(kuò)展”兩個(gè)維度講清楚項(xiàng)目就能立住。最后如果再分享一點(diǎn)個(gè)人體會畢業(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é)親手改一遍收獲會大得多。