台股個股全景（des） — 某一個 as_of 時點的橫切面,不是一個綜合結論
全景頁最常見的誤讀是把一整螢幕的欄位讀成「這家公司現在的樣子」。實際上它是某一個 as_of 時點的橫切面,而且橫切面裡的每一格有自己的資料截止日——報價可能是昨天收盤,財報可能是上一季,股利可能是去年度決議。先講清楚命名:des 是本頁的網址別名,它與 overview 指向同一份個股全景資料,站上並不存在另一個名為 des 的獨立資料集。理解這兩件事之後,全景才是有用的:它是一張對齊時點的索引,不是一個綜合結論。
des 與 overview 的對應關係
des 是網址別名:/feature/des 與 /feature/overview 是同一頁的兩個入口,回傳的是同一份個股全景資料,查詢端點為 /v1/overview/{stock_id},另有 /v1/overview 與 /v1/overview/catalog 供列舉與欄位目錄。
我們把這件事寫在頁面上,是因為不同名字容易被誤認成不同資料。再說一次:站上並不存在另一個名為 des 的獨立資料集,兩個網址背後是同一組欄位、同一組資料截止日。
橫切面的時間問題:逐欄位的資料截止日
全景把來源不同、更新頻率不同的欄位放在一起。報價是日頻、財報是季頻、股利是年度事件、籌碼是週頻或日頻,如果只在頁首放一個時間戳,讀者會以為整頁同步。因此我們逐欄位標示自己的資料截止日與期別。
這件事在回頭看歷史時特別重要。用今天知道的事回頭看過去,會讓過去的畫面比當時的人所能看到的更完整;想重建「當時看得到什麼」,就必須逐欄位對齊各自的公告時點,而不是取今天的最新值。
這頁不做綜合評分,也不給體質結論
我們不把全景欄位加總成一個分數、不給 A/B/C 等第、不做排名。加總的問題在於各欄位的資料截止日不同,把跨期的數字壓成一個數字,等於把時間差藏起來。
像「全景分數代表體質」這類講法在本站不會出現,因為橫切面本身無法支持它。橫切面能說的只有「在這個 as_of 時點,這些欄位各是多少、各自截止到哪一天」。
這頁不能拿來做什麼
本頁不排名、不選股、不給目標價、不給進出場時點、不預測。欄位齊全不代表股價會漲,欄位缺漏也不代表基本面差——缺漏常常只是該項還沒到公告時點。
正確的用法是當作對齊時點的起點:先看每一格截止到哪一天,再決定哪些欄位可以放在同一句話裡比較。跨期的兩個數字放在一起講,本來就不是同一件事。