
AI 時代的名言:「這個需求很簡單,大概兩天就能好」?
在資工系的軟體工程課堂上,四個充滿自信的大三學生接下了看似最基礎的專題——做一個簽到系統。最初的需求只有三行:老師建立課程、學生登入、學生按下簽到,預估工期兩個星期。然而十三週過去了,系統從三張資料表暴增到二十七張資料表、六十三支 API、三十八個前端頁面,程式碼突破兩萬行。
這是一個真實血淚的縮影。從需求蔓延到身分驗證的無底洞,每一個階段都在告訴我們軟體工程的殘酷現實。
▋ 領域模型與資料庫模型的根本差別
在專案初期,團隊常在身分與權限上摔跤。這裡必須釐清一個關鍵觀念:領域模型不等於資料庫模型。
領域模型專注於業務邏輯,用來理清現實世界裡的人、事、物彼此有什麼關係,完全不管資料庫要怎麼存。資料庫模型則是實體關聯模型,專注於技術實作,規定資料要在磁碟裡建幾張表、欄位型態是什麼。簡單來說,領域模型是想怎麼解決業務問題,而資料庫模型是想怎麼把資料塞進電腦。如果沒搞懂這點,資料庫架構就會隨著需求不斷打掉重練。
▋ 用 User Story 與 SDD 劃定邊界
故事中的學生初期只拿著簡單功能清單就開工。真正的開發應該從 User Story 開始,包含身分、目標與價值,並搭配明確的驗收標準。透過驗收標準,團隊能在第一週就釐清範圍,避免 GPS、動態 QR Code 等非必要功能無限蔓延。
進一步的解法是 SDD 規格驅動開發。在動手寫 code 前先建立好 API 規格與資料庫架構的契約,讓前後端有共識,並阻止口頭隨意加功能的盲目擴張。
▋ TDD 測試驅動開發解決整合崩潰
當專案走到後期,常常發生各個零件單獨正常、合在一起卻全面崩潰的慘劇。這正是先寫程式、後補測試的副作用。
導入 TDD 的紅綠燈循環,先寫出會失敗的測試來定義預期行為,再寫程式讓測試通過。如果團隊在第一週就寫好高併發寫入的壓力測試,那麼資料庫重複紀錄的漏洞在第一天就會被逼出來,而不是拖到上線前夕才爆炸。
▋ AI 時代的軟體工程優化之道
現在有了 AI 工具,寫程式的門檻降低了,但軟體工程的重點變成了如何精準定義需求。
如果沒有在一開始釐清規格,AI 幫你產 code 的速度越快,架構崩壞的速度也越快。正確的做法是結合 User Story 與 SDD,先讓 AI 參與需求訪談模擬與規格審查,接著採用 AI 驅動的 TDD,先要求 AI 寫出測試案例,以通過測試為唯一驗收標準。這樣既能享受 AI 的效率,又能防止 AI 產生幻覺代碼。
▋ 結語:最成熟的技術判斷是不寫不必要的程式
故事的結尾非常有意思。老師因為開錯舊網址而以為系統壞掉,主角沒有去寫網址導向或快取清除,而是說了一句:「老師,下次請用書籤。」
這不是逃避,而是軟體工程師最寶貴的素養:判斷問題的邊界與解決成本。世界上沒有簡單的系統,只有還沒開始問問題的需求。在 AI 時代,懂得在關鍵時刻說不,懂得利用既有工具,才是工程師無可取代的核心價值。
做軟體就像蓋房子,只要寫程式,就一定會經歷這 5 個「與客戶鬥智」的過程。用最白話的方式解釋給你聽:
- 1. 需求發掘(讀心術)
客戶其實常不知道自己要什麼。他們說想做一個「按鈕」,其實背後只是想「下載報表」。這個階段就是要把他們心裡真正的渴望挖出來。 - 2. 需求確認(對答案)
如果只給客戶看密密麻麻的字,他們都說看懂了,結果工程師做出來,客戶才驚呼「這不是我要的!」。所以動工前,一定要畫個草圖跟客戶確認:我們想的一模一樣對吧? - 3. 需求凍結(不可以色色…啊不是,是不可以改了)
為了讓工程師專心寫程式,雙方要約定一個時間點。在這個期限之後,目前的規格就先卡死,不准再隨便亂加新功能,否則房子永遠蓋不完。 - 4. 需求變動(計劃趕不上變化)
專案做著做著,老闆可能突然看到對手出了新功能,或是政府改了法規,這時候就得改設計。改可以,但要講清楚:這需要延期或加錢。 - 5. 需求管理(記帳本)
當功能越來越多、時間越來越長,就要做筆記。確保未來的每行程式碼、每個測試,都能對應到當初是誰要求的。不然人一離職,就沒人知道這功能當初是衝著誰做的。
軟體專案會爆炸,通常不是技術爛,而是這 5 個溝通環節出問題。你有遇過這種需求的溝通災難嗎?
心得
軟體開發背後是門很大的學問,所以開發沒做好,其實也是正常的。就連談好的需求,等功能實作出來變來變去,也是正常的。在實作某一個功能時候,該不該規畫的有彈性,使用者通常喜歡功能很有彈性,但要讓系統變得有彈性,背後付出的代價其實通常也不小。
相關文章
YouTube: https://youtu.be/ZcYn_0hXGSU
資工系大三有一門「軟體工程(Software Engineering)」,期末規定四人一組做專題。
老師在第一堂課特別強調:「題目不用偉大,我不希望看到什麼人工智慧城市、區塊鏈醫療平台、量子運算社群網站。你們只要做一個小而完整、真的可以用的系統。」
坐在第三排的冠宇聽完,轉頭跟組員說:「那我們做簽到系統好了。」
另外三個人一致同意。
因為大家都知道,簽到系統很簡單。
至少那天下午,他們是這麼認為的。
最初的需求只有三行:
老師建立課程。
學生登入。
學生按下簽到。
冠宇看著白板說:「這大概兩個禮拜。」
負責前端的育誠說:「介面一天。」
負責後端的俊豪說:「API兩天。」
負責資料庫的宗翰說:「資料表三張就夠。」
四個人互相看了一眼。
那是一種資工系學生特有的自信。
通常出現在專案開始之前,以及事情還沒真正發生之前。
第一週,他們建立了三張資料表:User、Course、Attendance。
老師看完問:「學生跟老師都是User嗎?」
冠宇回答:「對,用role區分。」
老師點頭:「那助教呢?」
四個人沉默五秒。
宗翰打開資料庫。
第四張表出現了。
TA。
老師又問:「一門課可以有兩個助教嗎?」
宗翰沉默十秒。
TA表消失了。
CourseMember表出現了。
老師再問:「那有些助教同時也是其他課的學生呢?」
宗翰盯著螢幕說:「沒問題,這就是多對多關係(Many-to-Many Relationship)。」
老師說:「很好。」
宗翰鬆了一口氣。
老師接著問:「那老師如果下學期變成另一門課的學生呢?」
宗翰把筆電闔上。
「老師,我覺得我們應該先討論人的本質。」
第二週,他們開始做登入。
原本的設計非常單純:帳號、密碼。
俊豪說:「密碼不能明碼儲存,要做雜湊(Hashing)。」
冠宇說:「當然。」
育誠問:「忘記密碼呢?」
三個人安靜下來。
俊豪說:「寄Email。」
宗翰問:「Email怎麼驗證?」
俊豪說:「驗證信。」
冠宇問:「驗證連結多久失效?」
俊豪說:「三十分鐘。」
育誠問:「使用者同時按五次忘記密碼,前四個連結還能不能用?」
俊豪沒有回答。
他只是把原本寫著「登入功能」的工作項目,改成了「身分驗證模組(Authentication Module)」。
過了兩天,那個模組下面已經有登入、登出、重設密碼、Email驗證、Token更新、Session管理、錯誤登入次數限制、裝置登入紀錄。
冠宇看了一眼說:「我們是不是偏離簽到系統了?」
俊豪說:「沒有,使用者要先登入才能簽到。」
這句話邏輯上完全正確。
也因此沒有人能阻止事情繼續惡化。
第三週,簽到按鈕終於完成。
育誠很開心地把畫面秀給大家看。
正中央一個藍色按鈕,上面寫著「簽到」。
冠宇按了一下。
成功。
大家鼓掌。
那是整個專案最後一次純粹的快樂。
隔天老師來看進度。
老師問:「學生如果人在家裡,可以簽到嗎?」
冠宇說:「目前可以。」
老師問:「那這樣簽到有什麼意義?」
四個人又沉默了。
育誠提議:「用GPS。」
俊豪說:「瀏覽器可以取得定位。」
宗翰說:「那就判斷距離教室一百公尺內才能簽。」
冠宇覺得有道理。
於是他們加入地理定位(Geolocation)。
兩天後第一次測試。
四個人全部坐在同一間教室。
冠宇的手機顯示距離教室17公尺。
育誠顯示42公尺。
俊豪顯示126公尺。
宗翰顯示他人在隔壁行政大樓。
宗翰抬頭看大家。
「我肉體在這裡,但資料不同意。」
他們查了一整晚,終於理解GPS在室內不是神諭。
老師隔天問:「那怎麼辦?」
冠宇說:「改用Wi-Fi。」
「怎麼判斷?」
「檢查IP。」
老師說:「學生開VPN呢?」
冠宇第一次產生了一個念頭。
也許點名簿其實是人類文明很成熟的技術。
但他沒有說出口。
資工系有一種奇怪的職業尊嚴:當紙本方法明顯比較簡單時,絕對不能太早承認。
於是他們開始研究校園無線網路。
研究兩天後,題目從「簽到系統」變成了「基於網路環境與地理資訊之多因子課堂出席驗證平台」。
老師看著題目問:「你們是不是一開始只想做一個按鈕?」
冠宇說:「需求演化(Requirement Evolution)。」
老師點點頭。
「很好,你們已經學會軟體工程最重要的一件事。」
四個人期待地看著老師。
老師說:「替失控取一個專業名稱。」
第四週,真正的問題出現了。
有人提出:「如果學生把帳號密碼給同學,請同學代簽呢?」
冠宇說:「那做QR Code。」
每堂課老師產生一組QR Code,學生掃描後簽到。
大家覺得很合理。
直到育誠說:「拍照傳到班群就好了。」
QR Code開始每三十秒更新一次。
俊豪說:「那用動態Token。」
宗翰說:「要不要綁裝置?」
冠宇說:「怎麼綁?」
「Device Fingerprinting。」
大家安靜了一下。
育誠問:「我們現在是在做簽到,還是在做網路銀行?」
沒有人回答。
因為俊豪已經開始查Device Fingerprinting的文件。
第五週,他們遇到併發(Concurrency)問題。
老師測試時讓全班五十人同時按簽到。
資料庫瞬間出現十二筆重複紀錄。
宗翰看著結果,臉色非常平靜。
那不是因為他不緊張。
而是一個人在真正理解事情有多糟之後,反而會進入某種哲學狀態。
他說:「理論上有Unique Constraint。」
俊豪問:「那為什麼還有重複?」
宗翰說:「因為昨天測試的時候我先拿掉了。」
「為什麼?」
「它一直報錯。」
俊豪說:「它報錯就是因為有重複資料啊。」
宗翰點頭。
「對。」
「所以你怎麼處理?」
「我把會報錯的東西拿掉。」
冠宇坐在旁邊,突然理解了很多現實世界的資訊系統為什麼會變成今天這個樣子。
第六週,老師要求加上請假功能。
冠宇說:「沒問題,小功能。」
其他三個人同時看著他。
經過前五週,他們已經知道「小功能」是一種極度不吉利的詞。
果然,請假功能一開始只有:日期、原因。
然後有人問:「公假跟事假要不要分?」
要。
「病假要不要附件?」
要。
「附件格式?」
PDF、JPG、PNG。
「大小限制?」
10MB。
「請假誰審核?」
老師。
「老師不在呢?」
助教。
「助教可以審自己的假嗎?」
不行。
「學生撤回後可以重新送嗎?」
可以。
「老師已經核准後還能撤回嗎?」
不知道。
「跨兩堂課呢?」
……
冠宇看著需求文件,突然說:「我發現我們不是在做簽到系統。」
育誠問:「那我們在做什麼?」
冠宇說:「學校。」
第七週,他們加入通知系統(Notification System)。
學生簽到成功要通知。
簽到失敗要通知。請假送出要通知。請假核准要通知。請假駁回要通知。
老師忘記開放簽到也最好通知。助教最好也收到。
然後問題來了:「通知用什麼?」
站內通知。
Email。
之後有人提議加推播通知(Push Notification)。
冠宇立即說:「不要。」
這是他第一次在專案裡成功阻止一項需求。
全組對他的領導能力重新產生敬意。
三天後老師問:「手機沒有開網頁,也能收到提醒嗎?」
冠宇低頭說:「我們會研究Push Notification。」
第八週,前端開始出問題。
育誠做了一個漂亮的簽到頁面。
桌面版很好看。
手機一開,按鈕跑到畫面外。
他修了響應式網頁設計(Responsive Web Design)。
平板又壞掉。
修完平板,Safari壞掉。
Safari修完,深色模式文字消失。
深色模式修完,有人把瀏覽器字體放大到200%。
整個介面像地震。
育誠盯著CSS三個小時,最後說:「人類為什麼需要這麼多尺寸?」
俊豪說:「因為世界不是固定寬度。」
育誠回答:「那世界設計得不好。」
第九週,資安問題來了。
老師找了一個學長幫忙做簡單的滲透測試(Penetration Testing)。
學長坐下不到十分鐘就問:「你們API有做權限驗證嗎?」
俊豪說:「有啊,前端沒有顯示老師功能。」
學長抬起頭。
「我問的是後端。」
全組沉默。
學長直接送出一個HTTP Request。
學生帳號成功刪掉整門課。
那一天,四個人第一次真正理解一件事:把按鈕藏起來,不叫權限控制。
宗翰問:「所以要做Role-Based Access Control?」
學長說:「對。」
俊豪說:「每個Endpoint都要檢查?」
學長說:「對。」
俊豪看著目前的四十七個Endpoint。
「我突然覺得被駭也是一種使用者體驗。」
第十週,他們開始寫測試。
老師要求單元測試(Unit Test)、整合測試(Integration Test)。
俊豪寫了第一個測試。
通過。
第二個。
通過。
第三個。
失敗。
他修改程式。
第三個通過。
第一個失敗。
他再修改。
三個都通過。
整合測試全部失敗。
育誠問:「為什麼?」
俊豪說:「因為每個零件單獨都正常。」
「那合在一起呢?」
「就不正常。」
冠宇說:「這句話很像我們這一組。」
沒有人笑。
因為大家知道這已經不是笑話。
第十一週,專案終於部署到伺服器。
本機測試完全正常。
部署後首頁白畫面。
俊豪說:「不可能,我電腦可以。」
老師剛好走過來,聽見這句話。
老師停下腳步。
「你們知道軟體工程裡最沒有資訊量的一句話是什麼嗎?」
大家搖頭。
老師說:「『在我電腦上可以跑(Works on My Machine)。』」
俊豪想反駁。
但他的確只有自己的電腦可以跑。
於是他們開始研究容器化(Containerization)。
冠宇問:「Docker會不會太複雜?」
俊豪說:「不會,它就是把環境包起來。」
六小時後,四個人圍著一個起不來的Container。
育誠問:「現在呢?」
俊豪說:「現在我們把問題也一起包起來了。」
第十二週,系統上線測試。
老師登入。
學生登入。
QR Code正常。
定位正常。
簽到正常。
請假正常。
通知正常。
所有人感動得差點站起來鼓掌。
老師看著畫面,點了幾下。
然後問:「如果老師開錯課程的簽到,可以取消嗎?」
四個人臉上的笑容同時消失。
冠宇說:「目前不行。」
老師說:「那加一下,應該很簡單吧?」
這句話像一枚手榴彈掉進會議室。
沒有人動。
老師疑惑地問:「怎麼了?」
冠宇很慎重地說:「老師,經過十二週,我們組內已經禁止使用『簡單』這個詞。」
老師笑了。
「那我換個說法,只要增加取消簽到。」
宗翰問:「取消之後原本簽到紀錄要刪除嗎?」
老師想了一下。
「最好保留。」
俊豪問:「那狀態改成Cancelled?」
「可以。」
育誠問:「學生畫面要顯示什麼?」
「顯示這次簽到已取消。」
冠宇問:「如果老師取消之後重新開放?」
老師停頓一下。
「那應該算新的吧。」
宗翰問:「新的Session?」
「對。」
俊豪問:「那舊Session的學生如果已經請假呢?」
老師沉默。
育誠問:「通知要重新發嗎?」
老師沉默更久。
冠宇慢慢把筆電轉向老師。
「老師。」
「嗯?」
「歡迎加入我們。」
第十三週,期末驗收。
四個人穿得比平常正式。
簡報第一頁寫著:「智慧課堂出席暨身分驗證管理平台」。
老師看到標題笑了一下。
「你們一開始不是說要做簽到系統?」
冠宇說:「是。」
「現在有多少資料表?」
宗翰回答:「二十七張。」
「API?」
俊豪說:「六十三支。」
「前端頁面?」
育誠說:「三十八個。」
老師問:「程式碼多少?」
俊豪說:「不算套件,大概兩萬多行。」
老師靠在椅背上。
「所以你們花十三週、四個人、兩萬多行程式,最後完成了什麼?」
冠宇操作系統。
建立課程。
開啟簽到。
QR Code產生。
學生掃描。
GPS檢查。
Token驗證。
權限驗證。
資料寫入。
通知送出。
畫面跳出綠色提示。
「簽到成功。」
教室裡非常安靜。
老師看著那四個字。
又看看四個學生。
「所以最後,還是讓學生按一下簽到?」
冠宇回答:「對。」
老師問:「那跟你們第一週做的有什麼不同?」
四個人想了很久。
最後宗翰說:「第一週的時候,我們不知道自己不知道什麼。」
老師笑了。
「現在呢?」
宗翰說:「現在我們知道不知道的東西還很多。」
老師點頭。
「很好,這才是這門課真正的成果。」
驗收結束後,四個人走出教室。
育誠問:「下學期專題要不要繼續做這個?」
冠宇立刻說:「不要。」
俊豪說:「我想做簡單一點的。」
宗翰問:「例如?」
俊豪想了一下。
「待辦事項系統(To-Do List)。」
三個人停下腳步。
冠宇很謹慎地問:「使用者可以共用待辦事項嗎?」
「應該可以。」
「可以指定負責人嗎?」
「可以。」
「截止日呢?」
「有。」
「重複任務?」
「可以加。」
「附件?」
「好像需要。」
「通知?」
「也要。」
「權限?」
俊豪開始不說話。
育誠補了一句:「如果兩個人同時修改同一個待辦事項呢?」
宗翰接著問:「刪掉的任務要不要可以復原?」
冠宇問:「子任務呢?」
俊豪站在走廊中央,沉默了足足十秒。
最後他說:「不然我們做計算機。」
其他三人同時看向他。
沒有人立刻答應。
因為經過一學期的軟體工程訓練,他們已經具備了真正的專業素養。
遇到任何看起來很簡單的需求,都會先懷疑。
過了一會兒,宗翰才小心翼翼地問:「哪一種計算機?」
俊豪說:「就加減乘除。」
冠宇問:「小數呢?」
「要。」
「負數?」
「要。」
「除以零?」
「要處理。」
「括號?」
「……」
「運算優先順序?」
「……」
「歷史紀錄?」
「……」
「浮點數精度(Floating-Point Precision)?」
俊豪抬起頭,看著走廊盡頭。
「算了。」
「怎樣?」
「我們還是做簽到系統好了。」
三個人點點頭。
因為在資工系待久了,你最後會理解一件事:世界上其實沒有簡單的系統。只有還沒開始問問題的需求。
而所謂的軟體工程,就是一群人先花三個月,把所有問題問出來,再花三個月發現原來前面還漏問了一半。
至於那套簽到系統,後來真的被系上拿去試用了。
第一天上午九點,冠宇收到老師的訊息:「系統是不是壞了?我按開始簽到沒有反應。」
四個人立刻上線查Log。
資料庫正常。
API正常。
伺服器正常。
網路正常。
權限正常。
前端正常。
他們查了二十分鐘,什麼問題都找不到。
最後冠宇跑去教室。
老師坐在講桌前,把筆電轉給他看。
冠宇只看了一眼就知道原因。
老師開的是上學期留下來的測試網站。
冠宇沉默了一會兒,幫老師換成正式網址。
系統立刻正常。
老師有點不好意思地問:「這種情況有辦法避免嗎?」
冠宇站在講桌旁。
那一瞬間,他腦中閃過網址重新導向、舊版停用頁面、環境標示、版本檢查、自動更新、DNS設定、部署流程、快取清除,以及至少八種新的例外處理。
他想起十三週前,那個相信「簽到系統兩個禮拜就能做好」的自己。
然後他做出了這學期最成熟的一次技術判斷。
他說:「老師,下次請用書籤。」
老師點點頭。
「好。」
問題解決。
沒有新增資料表。
沒有新增API。
沒有新增套件。
甚至沒有寫一行程式。
冠宇走出教室時,第一次真正感受到自己學會了軟體工程。
不是因為他終於知道怎麼解決所有問題。
而是他終於知道:不是所有問題,都值得寫程式解決。
