iT邦幫忙

2026 iThome 鐵人賽

DAY 19
0
佛心分享-SideProject30

打造 APR Engineer 的生產力平台,從 Flow Tracer 到 SignOff DashBoard 的落地實戰系列 第 19

Day 19 | Block Page:階段頁籤、APR/ECO 葉子與 SignOff 檢查表

  • 分享至 

  • xImage
  •  

Q_Q 改寫到一半被叫去加班惹

從階層表點進一顆名字,使用者站在這座平台真正的工作台前面。Day 14 只要求門牌在、頁籤在;今天把房間內部講完——至少講到工程師能核對「這顆 block 現在最新的實作與檢查」。Layout 曲線與 Timing 細節若還沒進箱子,表可以素,但骨架必須穩:標題列、階段頁籤、依頁籤切換的本體。

Block 頁是一個房間、多扇門。門是階段,不是另一顆 block。選錯層級,後面會做出「在頁籤裡切換 block」這種讓人迷路的東西。記住:走廊選 block,房間選階段。

  ss_ep_top                                           [ 回到階層 ]
  N4_SM8466 · v3 · 負責人 · 日期

  APR | ECO | SignOff | PV | STA | IR            Summary
  -------------------------------------------------------
  現在停在 APR 這扇門

  只列出末端(線頭),不是整棵樹
  版本     沿途怎麼走來        DRC    時間     父親
  v3       v1 → v2 → v3       12     08/18    v2     ← 可點進 Version

一、進房之後先認三塊

版面固定分成標題列、頁籤、本體。標題是等寬的 block 名,底下是專案 id,以及從最新一次上傳拿到的版本、負責人、日期。旁邊一顆按鈕回到階層。這三塊不要為了某一階段而改形。

頁籤目前是:APR、ECO、SignOff 可點;PV、STA、IR 灰色,標成稍後才來;Summary 靠右,提醒它跟左側工程頁籤不是同一類觀眾。可點的頁籤改的是網址裡的階段,不是元件內部的私有狀態。這樣重新整理、傳連結,對方會停在同一扇門。

不合法的階段會被讀檔整理踢回 APR。灰色頁籤根本不是連結,點不了。兩種處理不一樣:一個是防深連結寫錯,一個是地圖上先占位子。占位子很重要。團隊若從沒在頁籤上看過 PV,之後開燈時會以為是新網站,而不是同一座大廳補了一扇門。

副標寫「block · 階段」。頂部路徑停在 block,再往下的 version 才加階段與 version 字樣。使用者應隨時知道:我在哪顆、哪一扇門。不知道,就是外框沒把資料包的位置畫出來,不是本體表格的錯。


二、APR 與 ECO:只列出末端,不把整棵樹攤在桌上

這兩扇門的本體來自同一種東西:這顆 block、這個階段的父親樹。樹上每個節點是一次上傳。沒有小孩的是葉子,沒有父親的是根。Block 頁 只畫葉子

為什麼不畫整棵?因為工程師進這扇門時,問的通常是「現在最新的那幾條線頭」,不是每一次中間實作。中間版本屬於譜系,留給 Version 頁沿路展開。若在 Block 頁把所有節點列成一張長表,最新與歷史會擠在一起,掃的人又要靠日期自己濾。葉子就是濾好的結果:每條家族線的末端。

表欄保持少:版本、沿途譜系文字、DRC、利用率、上傳時間、父親。版本是連結,整列也可點,進到該葉子的 Version 頁。譜系文字用人看得懂的「階段(版本)→ …」串起來,讓你還沒進細節就能判斷這條線是從哪次根走來。DRC 與利用率只取最一眼的那個數——例如 DRC 的 all、利用率的 DESIGN——當目錄,不當報告。完整指標在下一層並排。

沒有任何上傳時,不要畫一張全是橫線的表。畫一段說明:這個階段還沒有上傳;父親欄空白即為根。空狀態要教契約,不要只說「沒有資料」。有上傳但組不出樹,才是讀檔整理問題;有檔而這裡說沒有,才是 Day 16 的鑰匙問題。

根的數量與葉子數量可以不同。一個根分出兩條線,就會有兩片葉子。表上兩列,不是錯。葉子依日期新到舊排,新的在上,符合「進來先看現在」。父親那一欄對根顯示 ROOT,對其他人顯示父親的版本名。對帳時若 ROOT 該出現卻出現了某個版本,代表父親字串被解析到了不該對上的別名——那是 Day 20 要小心的事,今天先能指出「這一列的父親欄寫了什麼」。

ECO 與 APR 是兩棵樹、兩扇門,不要在同一張表用顏色區分。走錯門會以為 ECO 沒跑;走對門,契約才被執行。檔名或 stage 把一次 run 判錯階段,症狀就是跑到另一扇門的葉子裡。修的是正規化,不是頁籤。


三、SignOff:最新一份檢查表,加上死板的燈號

SignOff 門不看父親樹,看「這顆 block 所有含 stage_qa 的上傳裡,日期最新的那一份」。它可能來自一次 APR 上傳,也可能來自後來某次 ECO 上傳,只要箱子裡帶了檢查。這與「最新 APR 葉子」不是同一個時間點。頁面上必須讓人感覺到:這是檢查,不是實作版本列表。

有資料時,本體是一張檢查表:名稱、狀態、數值、準則,上頭有整份的通過/失敗/警告計數與總燈號。總燈號同樣死板——有失敗就失敗。單項狀態用同一套顏色,不要檢查表一顆綠勾、標題列一個藍字 OK。語意一散,PM 與工程師又會各看各的。

沒有 stage_qa 時,說明這個 block 還沒有檢查資料。不要用最新 APR 的 DRC 假裝成 SignOff。假裝會讓「通過」這個詞破產。檢查項為空陣列但外層計數在,是另一種殘缺:顯示計數,表身寫沒有列出項目,讓丟檔的人去補 item_info

數值與準則在原始資料裡可能是物件。畫面可以把它們收成文字,但不要在這一層做四捨五入以外的美化。美化是對帳的敵人。路徑類欄位不該出現在這張表——正規化時就該清掉。

從 Summary 點進某一顆的檢查,應落到這扇門,而不是落到 APR。連結的階段要對。這是頁籤存在的意義:同一房間、不同門,深連結必須指名那扇門。


四、房間裡的 Summary:只談這一顆

頁籤靠右的 Summary,帶的是這顆 block 的最新 APR 列與最新 SignOff 列,不是全專案。欄位與專案級總覽同一套(版本、負責人、DRC、利用率、檢查計數……),只是不必再顯示 block 名。點 APR 列進 Version,點 SignOff 列進檢查門。

為什麼房間裡也要一扇 Summary?因為有人深連結直接進 block,不想先回階層再按總覽。它不是第三種資料,只是同一組「最新欄位」的窄版。PV 仍標稍後,不要在這裡先做假列。假列會讓主管以為 PV 已經在跑。

尚未開放的階段若有人硬改網址,讀檔整理會帶回 APR;若未來開放而資料仍空,占位卡片一句「尚未啟用」即可。占位與空上傳不同:占位是產品還沒做,空上傳是產品做了但這顆還沒跑。兩種文案不要共用。


五、手感:整列可點,但不要跟連結搶

葉子表與摘要表的列可以點。點到列裡的 <a>,就讓瀏覽器走連結,不要再改一次網址。否則會出現連點兩次、或中鍵開新分頁失效。這是小細節,卻是「這張表像不像工具」的分界。

回到階層的按鈕永遠在標題列右側。不要只靠頂部路徑。投影分享時,游標在右上角比在頂部路徑列好找。標題列的版本與日期,用的是「這顆 block 所有上傳裡最新的那一份」,不一定等於你當前頁籤那棵樹的最新葉子。若兩者不一致,不是 bug,是你同時有較新的另一個階段。看日期時連頁籤一起看。


六、這間房怎樣算裝好

用 Day 16 的最小集走一遍。點進那顆葉子,預設停在 APR,表上有一列版本,父親是 ROOT,DRC 若你有抽就對得上箱子。切 ECO,應是空說明(除非你真的丟了 ECO)。切 SignOff,有檢查就見表與燈號,沒有就見說明。切 Summary,見一列最新 APR,檢查有則再見一列。刷新停在同一扇門。把網址貼到無痕視窗,仍是同一顆、同一扇。

再丟第二次 APR、並讓它的父親指到第一次。表上葉子應仍是一(或仍是末端那一列),譜系文字應出現兩段。若變成兩列葉子,父親沒對上。這已經踩到 Day 20 的邊界,但 Block 頁是你最先看見症狀的地方。


上一篇
Day 18 | Home 與 Project:從製程卡片走進階層表
下一篇
Day 20 | Father 樹與 Version 頁:譜系上的指標如何並排
系列文
打造 APR Engineer 的生產力平台,從 Flow Tracer 到 SignOff DashBoard 的落地實戰20
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言