01範例說明
這份範例, 用 hao-code 自己的 repo 做。
本頁是 hao-code 拿自己的作品集 repo 做的交付文件範本:內容取自這個 repo 的 README、.env.example、package.json 與實際指令輸出。它不是真實客戶的專案文件,也不含任何密鑰;密鑰一律透過安全管道另行交付。
範例交付
hao-code 作品集與概念作品網站
程式庫
github.com/HowHaoChih/web-studio
交付基準
main 分支的公開 commit 歷史
02六項交接內容
一項一項看, 對方拿到了什麼。
左側是約定的六項交接清單,選一項就看它的實際內容、來源檔案與還沒涵蓋的界線。
01可追蹤的 commit 與分支
Git 版本紀錄
交接清單承諾:以可追蹤的 commit 與分支整理本次交付內容。
對方拿到的是這個 repo 真實的 Git 歷史,而不是一個無法追查的壓縮檔。每一版交付都有對應的 commit 與分支,出了問題可以逐筆比對改了什麼、哪一版放進了哪個決定。
交接時,對方會拿到什麼?
- 可追蹤的 commit 歷史,訊息沿用 feat / fix / chore 前綴
- 交付以合併進 main 的 commit 清單為準;中繼分支只用於過程,合併後不保留
- origin 遠端:https://github.com/HowHaoChih/web-studio.git
- 驗收時可比對 main 上的 commit 清單與實際檔案
實際指令
git log --oneline --graph --decorate -15來源
- git log --oneline -12
- git remote -v
- git branch --show-current
界線這是 hao-code 自己的作品集 repo,不是客戶的私有程式庫。正式合作會改用對方擁有權限的遠端,並先約定是否保留完整歷史、分支命名與 commit 訊息格式。
先提供這些,討論會快很多
- 網站或系統要解決什麼問題,給誰用
- 預計要有哪些內容或功能,現有素材到哪個程度
- 一到兩個參考網站,以及你喜歡或不喜歡的地方
- 希望上線的時間,以及預算大概的區間