CL3 v1.6.2 今日工作紀錄


 

CL3 v1.6.2 今日工作紀錄

版本結果

今天已完成 CL3 v1.6.2 的開發收斂、DEV 驗收、STG 驗收與 Git tag 發布。

  • main 已推送

  • v1.6.2 tag 已建立並 push

  • DEV 驗收通過

  • STG 驗收通過

本次主題

Logging v1 / Admin Log Center MVP 正式落地

這次不是單點修 bug，而是把 CL3 的 log 能力往前推了一個完整層級，從原本偏向容器 stdout 與人工追查，升級為：

  • 有結構化欄位

  • 可查詢

  • 可過濾

  • 可追 run_id / symbol / driver

  • 可在 Admin 中直接查看

今日完成項目

1. 完成 unified system logs v1

建立 system_logs 的統一欄位結構，正式導入以下核心欄位：

  • timestamp_utc

  • level

  • service

  • module

  • module_version

  • event_code

  • message

  • run_id

  • symbol

  • driver

  • source

  • extra_json

同時保留相容舊欄位，避免一次性硬切造成舊流程失效。

2. 完成 DB migration

完成並套用：

  • 008_logging_audit_foundation_v1.sql

  • 009_system_logs_schema_v1.sql

成果包括：

  • system_logs 新欄位建立

  • 舊資料回填

  • 查詢索引建立

  • DEV / STG 兩環境 migration 驗證成功

3. 完成共用 structured logger

完成 core / api / admin 共用 logging helper 串接，支援：

  • stdout JSON line 輸出

  • DB best-effort 寫入

  • 自動帶入 service/module/module_version

  • 可附帶 run_id / symbol / driver / source / extra_json

並補強：

  • DB write skipped 可見化

  • DB write failed 可見化

避免 logging 寫失敗時完全 silent swallow。

4. 完成 core lifecycle logging

已成功導入並實測進 DB 的核心事件：

  • CORE_RUNNER_STARTED

  • CORE_TICK_START

  • CORE_TICK_DONE

這代表 core tick 的生命週期已經可以被正式追蹤，而不是只能看 console 字串。

5. 完成 asset-level logging

已成功導入並實測進 DB 的資產層事件：

  • ASSET_FETCH_START

  • ASSET_FETCH_OK

  • ASSET_FETCH_EMPTY

  • ASSET_WRITE_OK

這對未來追 driver 問題、空資料問題、基金或 yfinance 異常問題非常重要。

6. 完成 Admin Log Center MVP

新增：

  • /admin/logs

支援：

  • system logs 檢視

  • event_code / service / level / symbol / driver / keyword 查詢

  • 基本欄位呈現

  • 中英文文案整合

這讓 log 不再只能靠 terminal 或直接查 DB，正式進入後台可視化階段。

7. 修正 DEV 環境兩個重要掛載問題

(1) shared 掛載問題

發現 DEV 容器實際載入的是舊版 shared logging，根因是：

  • docker-compose.dev.yml 未掛載 ./shared:/app/shared

修正後，core/admin/api 才真正吃到新版 logger。

(2) locales 掛載問題

發現 Admin UI 顯示 raw i18n keys，根因是：

  • ./admin:/app 覆蓋掉 image 內 /app/locales

  • 但 DEV compose 未把 repo 的 ./locales 掛回容器

修正後補上：

  • ./locales:/app/locales:ro

Admin Log Center i18n 恢復正常。

今日驗收結果

DEV 驗收

已確認：

  • migration 成功

  • 新 event_code 已寫入 DB

  • CORE_TICK_DONE 已取代舊 CORE_TICK_END

  • ASSET_FETCH_* / ASSET_WRITE_OK 成功落地

  • Admin Log Center 可正常使用

  • i18n 顯示正常

STG 驗收

已確認：

  • STG migration 成功

  • core/admin/api 成功重建並啟動

  • structured logs 出現在 container logs

  • 新事件成功寫入 STG system_logs

STG 最近 30 分鐘 event 分布已確認包含：

  • ASSET_FETCH_START

  • ASSET_WRITE_OK

  • ASSET_FETCH_OK

  • ASSET_FETCH_EMPTY

  • APP_START

  • CORE_TICK_DONE

  • CORE_TICK_START

  • CORE_RUNNER_STARTED

代表本次功能不只在 DEV 成立，也已在 STG 成立。

Git / Release 結果

今日最終 Git 狀態：

  • main 已同步到 origin/main

  • working tree clean

  • 已建立並 push：

    • v1.6.2

因此本次工作已正式收斂為：

CL3 v1.6.2 released

本次工作的價值

這次最大的價值不是多一個後台頁，而是 CL3 開始擁有比較完整的「工程除錯基礎設施」。

換句話說，後面遇到這些問題時，會比以前好處理很多：

  • driver 為什麼抓不到

  • 哪個 symbol 空資料

  • 哪次 tick 失敗

  • 哪個模組版本開始異常

  • 哪次 STG 與 DEV 行為不同

  • 哪個事件在 DB 有落地、哪個只有 stdout

這一步很關鍵，因為它會直接影響未來開發速度與穩定度。

下一步建議

下一輪最值得接的三件事：

1. Log Center detail view

可點開單筆 log 檢視 extra_json 與更多上下文。

2. ERROR / WARN 高亮與快捷篩選

讓異常事件在 UI 中更容易被看見。

3. Access / Audit / System 三類 log 體驗整合

把三種 log 的欄位、查詢與導航體驗再整理成更一致的後台介面。

一句收尾

今天這版不是表面功能，而是把 CL3 從「能跑」往「能追、能查、能維運」再往前推進了一步。

留言

張貼留言

這個網誌中的熱門文章

戰未來十年！我的新家 3 層樓 10G 影音內網 + 全屋 Wi-Fi 7 實戰紀實《序章》

圖片
序章：為什麼我需要「 10G 」？ 當我拿到新家鑰匙的那一刻，我看著這棟三層樓的「中古屋」，心中浮現的不是沙發要擺哪裡，也不是牆要漆什麼顏色，而是一張巨大的網路拓樸圖。 搬新家，在 IT 術語中稱為「 Greenfield ( 綠地 ) 佈署 」。這是一張完美的白紙，是身為一個 Prosumer ( 專業消費者 ) 夢寐以求的「黃金施工期」。 這是我 唯一 的機會，可以在水泥封上之前，把未來 10 年的基礎建設一次到位。我知道，如果我現在妥協，未來 10 年的每一天，我都會活在「早知道 ... 」的悔恨中。 但真正的問題來了： 我真的需要「 10G 」嗎？ 迷思： 10G 網路 ＝ 10G 網際網路？ 在開始之前，我們必須釐清一個最大的迷思：我談的「 10G 」，指的 不是 向中華電信申請的「對外 (WAN) 網際網路」，而是指我家中設備互連的「 內部區域網路 (LAN) 」。 就算我申請了 2G/1G 的光世代，如果我的內網只有 1G (1Gbps) ，那就像是擁有一條 8 線道的高速公路，但終點卻是一個單線道的收費站。 而這個 1G 的收費站，就是我決心剷除的瓶頸。 1Gbps (110MB/s) 的天花板，我受夠了 1Gbps (Gigabit) 網路，換算成我們熟悉的下載速度，理論極限大約是 110-120 MB/s 。 這在 10 年前很夠用，但在 2025 年的今天，它代表什麼？ 代表我從主力電腦備份 500GB 的資料到 NAS ，需要 75 分鐘 。 代表我想在 QNAP TVS-h674 上剪輯 4K (ProRes) 影片，素材讀取會卡頓到讓我放棄。 代表我的 Plex 或 Jellyfin 媒體庫在同時應付 2-3 個 4K 藍光原盤 (Remux) 串流時，會開始緩衝。 代表我未來安裝的 Wi-Fi 7 AP (U7 Pro) ，它那 2.5G 的網路埠，會被 1G 的交換器活活掐死在 1G 。 1G 內網，已經從「基礎建設」淪為「效能枷鎖」。 驅動我的「 10G 之魂」：三大核心需求 我的需求不是「上上網、看看 Netflix 」而已，我追求的是一個高效、穩定、且安...
閱讀完整內容

Building CL3 — From Manual Trading to a Decision Engine

圖片
  Building CL3 為什麼我決定建立自己的 Investment Decision Engine 每一個投資人，最終都會面對同一個問題。 市場充滿不確定性、資訊噪音，以及難以預測的變化。 但隨著時間，我逐漸意識到一件更重要的事情： 真正困難的不是市場，而是決策。 多年以來，我和大多數投資人一樣參與市場。 看圖表（Charts） 閱讀新聞（News） 觀察價格變動（Price Movements） 然後依靠經驗做出投資判斷。 有時候這些判斷很成功。 但有時候並不如此。 慢慢地，我發現一個現象： 人的判斷其實並不穩定。 有些時候，我們可以非常理性與紀律。 但在其他時候，情緒（Emotion）、恐懼（Fear）、或市場壓力會干擾決策。 同一個投資人，在不同時間點，可能會做出完全不同的投資行為。 這讓我開始思考一個問題： 如果投資決策可以被系統化（Systematized），會是什麼樣子？ 不是一個黑箱的 Trading Bot 。 而是一個更有意義的東西： Investment Decision Engine 這個想法，就是 CL3 的起點 。 Why CL3? 有趣的是， CL3 這個名字並不是一開始就精心設計的品牌。 它其實來自一次意外。 當時我正在和 AI 討論投資相關的想法，在回覆訊息時，我忘記把鍵盤從 Zhuyin Input Method（中文注音輸入法） 切換回中文。 我敲下了三個鍵： C(ㄏ) L(ㄠ) 3(ˇ) 在注音輸入法中，這三個鍵其實會輸入一個中文字： 「好」 但在當時的對話情境中，AI 看到的只是： CL3 有趣的是，AI 並沒有把它當作錯字。 反而開始回應一段關於 CL3 系統架構與投資方法 的說明。 那一刻我突然覺得： 也許這不只是一次打錯字。 也許這可以成為一個專案名稱。 於是 CL3 就成為了我開始撰寫這個投資系統時使用的專案代號。 What CL3 Means 隨著系統逐漸發展，我發現這三個字母其實也可以代表整個系統的核心理念： CL3 = Cycle · Logic · Layer Cycle 市場總是在循環（Market Cycle）。 牛市（Bull Market）、修正（Correction）、風險收縮（Risk...
閱讀完整內容

戰未來十年！《第二章》魔鬼在細節 - 核心設備選型 (血淚史)

圖片
  這一章是 90% 的人（包含我）花費最多時間、也最容易後悔的地方。每一個決策都像是在十字路口，選錯了，未來的 10 年都會充滿遺憾。 這就是我的「選型血淚史」。 第二章：魔鬼在細節 - 核心設備選型 ( 血淚史 ) 如果「架構藍圖」是理想，那麼「設備選型」就是殘酷的現實。這是在「預算」、「效能」和「功能」之間進行的痛苦拔河。我的每一分錢都要花在刀口上，而這刀口，必須能劃開 10G 的頻寬。 ( 路由 ) 靈魂： UDM-SE (Dream Machine Special Edition) 網路的靈魂，就是路由器。它決定了你的網路有多穩、有多安全、有多「聰明」。 我的選擇是 UniFi Dream Machine Special Edition (UDM-SE) 。 為什麼是它？ UDM-SE 是一台「 All-in-One 」的怪物。在 1U 的機身裡，它整合了： 高效能路由器 (Router) ： 支援 10G 路由效能， VLAN 防火牆規則再多也不怕。 2.5G WAN 埠： 這是關鍵！它能 跑滿 中華電信 2G/1G 光世代。 10G SFP+ LAN 埠： 這是我的「 10G 骨幹」與核心交換器 (QSW-M2116P) 連接的命脈。 PoE+ 交換器： 內建 8 個 PoE 埠，其中 2 個還是 2.5G PoE+ ！ UniFi 控制器： 無需額外主機 (Cloud Key 或 N100 VM) ，它本身就是 UniFi 生態系的大腦。 【血淚史】 UDM-SE vs. UDM-Pro ：差點選錯的致命妥協 新手最常問：「 UDM-SE 和 UDM-Pro 到底差在哪？」 UDM-Pro (2019 年產品 ) 看似便宜了 $4,000 多元，但這 $4,000 是我認為「 最划算的升級 」，因為 Pro 版有兩個致命缺陷： WAN 瓶頸： UDM-Pro 的 WAN 埠只有 1G ！ 在 2025 年的今天，當中華電信 2G 方案已是常態，你買一台 1G WAN 的旗艦路由器？這等於是「 落地即過時 」。 UDM-SE...
閱讀完整內容