# 預計進度
    - 需要一個網站簡介，用來介紹這個網站可以做什麼，要怎麼使用。
        - 放在首頁 (index.hjs)。
        - 介紹網站功能與使用說明。
    - 新增疊圖，全臺839子集水區範圍圖。(目前資料已經準備好，尚未上傳到 PostGIS)。
    - 新增一個 favicon.ico。
    - 可以讓使用者上傳自己的資料，並顯示在地圖上。
        - 可能需要修改資料庫設定。
        - 支援的格式：Shapefile、GeoJSON、CSV。
        - 上傳後，資料會存到 PostGIS 資料庫中。
        - 使用者可以選擇要顯示的圖層。
    - 註冊時加入電子郵件驗證功能。
        - 使用 nodemailer 套件發送驗證郵件。
        - 使用者註冊後，會收到一封驗證郵件，點擊連結後才能啟用帳號。

# 不確定的進度
    - 將點位連起來，繪製成面。
        - 可能用 turf.js 的 concave 函數。
    - 搜尋欄位功能。
        - 依照縣市、鄉鎮市區、村里名稱搜尋。
        - 顯示搜尋結果列表。
    - 連接氣象局資料，顯示各縣市的即時氣象資訊。
        - json；氣象局氣象預報
        - json；氣象局雨量累計
    - 點擊搜尋列表，顯示該區域的資訊。
        - 即時氣象資訊。
        - 從 GeoServer 取得該區域的 shapefile -> GeoJSON 資料，並在地圖上顯示。

# 到伺服器上需要做的事情
    1. git pull 最新的程式碼。
        - git reset --hard
        - git clean -fd
        - git checkout main
        - git pull origin main
    2. compose.yaml。
        - 修改 nginx 服務的 ports，開放 443 埠以支援 HTTPS。
        - 修改 nginx 服務的 ports，關閉 80 埠以強制使用 HTTPS。
        - 修改 nginx 服務的 SSL 憑證設定，啟用 SSL 憑證與私鑰的檔案。
    3. nginx/default.conf。
        - 修改 listen 指令，啟用 443 埠並設定 SSL。
        - 修改 ssl_certificate 與 ssl_certificate_key 指令，指定 SSL 憑證與私鑰的路徑。
        - 修改 proxy_set_header 指令，加入 X-Forwarded-Port 標頭。
        - 修改 proxy_redirect 指令，根據實際情況啟用或禁用 HTTP 到 HTTPS 的重定向。
    4. geoserver/data_dir/global.xml。
        - 修改 useHeadersProxyURL 與 proxyBaseUrl 設定，啟用使用 Headers 中的 Proxy URL 並設定 Proxy Base URL。(第 14、15 行)
            <!-- <useHeadersProxyURL>true</useHeadersProxyURL> -->
            <!-- <proxyBaseUrl>https://yo.ct.ntust.edu.tw/geoserver/</proxyBaseUrl> -->

# 2026.05.09 王朝威
    1. express/map-server/public/js/layers.js。
        - 修正拼寫錯誤：disAasterPointMap → disasterPointMap。
        - 在解析器（parsers）、建構器（builders）、同步邏輯與註解中全面替換並統一命名。
        - 確保前端 JSON 處理的一致性。
    2. express/map-server/public/js/modules/config.js。
        - 移除舊有的錯字引用（legacy typo usages）。
        - 簡化 isWatershedDisasterLayerCategory 檢查邏輯。
        - 為每個圖層產生唯一的預設 sourceSelectId（使用 layerName 的 base64 值）。
        - 在解析 layer data 時，優先使用 disasterPointMap。

# 2026.05.08.2 王朝威
    1. express/map-server/public/js/layers.js。
        - 重構集水區（watershed）編輯器 UI。
        - 改用 <select> 下拉選單選擇圖層，並加入排序（order）輸入欄位。
        - 簡化災害點位（disaster point）為單一可選擇的圖層。
        - 更新 JSON 建構邏輯：
            - watershedRangeMaps 改為包含 label、ogc_fid、order 的陣列。
            - disasterPointMap 簡化為單一物件。
        - 調整同步邏輯與事件綁定。
    2. express/map-server/routes/layers.js。
        - 統一上傳欄位為單一的 shapefiles。
        - 移除原本 watershed 與 disaster 各自的分支處理邏輯。
        - 簡化處理流程，目前僅對「一般圖層」匯入生效。
        - 更新路由中介軟體（upload middleware），僅接受 shapefiles 欄位。
    3. express/map-server/views/layers/partials/watershed.hjs。
        - 更新模板結構，改用新的下拉選單與表格列格式。
        - 提供可選擇的圖層選項與排序控制。

# 2026.05.08 王朝威
    1. .gitignore。
        - 新增 express/map-server/tmp/layer-imports/*，用於忽略圖層匯入過程中的暫存檔案。
    2. express/map-server/public/js/layers.js。
        - 優化客戶端圖層 JSON 輸出，改為產生最小化資料物件。
        - WFS 圖層僅保留 typeName 與 table。
        - 非 WFS 圖層才包含 options 與 mapOptions（且僅在 mapOptions 存在時）。
    3. express/map-server/routes/layers.js。
        - 重構 processLayerShapefileUploads() 函式。
        - 移除多餘的 category 欄位。
        - 依圖層類型進行分支處理：
            - WFS 圖層：設定 url 為 /geoserver/wfs，並正確設定 typeName 與 webgis.<table>，同時移除不必要的 options 與 mapOptions。
            - 其他圖層（如 WMS）：保留/恢復正確的 WMS 選項（layers、format、transparent、maxZoom、url、type 等）。

# 2026.05.07 王朝威
    1. express/map-server/public/js/layers.js（全新檔案）。
        - 新增完整的客戶端 GUI 圖層編輯器。
        - 支援 JSON 模式與 GUI 模式切換。
        - 依類別渲染設定面板：一般圖層、流域、地震、合併、地貌。
        - 綁定表單輸入與 JSON 建構/解析邏輯。
    2. views/layers/partials/（新增模板目錄）。
        - 將圖層編輯器 UI 拆分成多個 partials 模板。
        - 更新 add.hjs 與 edit.hjs 頁面，使用新的 partials 組合渲染。
    3. express/map-server/routes/layers.js（後端路由重構）。
        - 改善 editorType 偵測邏輯（新增 watershed 類型支援）。
        - 暴露 isJsonCategory 與 defaultMode 供模板使用。
        - 重構 buildImportedLayerData，強化 watershedRangeMaps 與 disasterPointMap 的正規化處理（支援匯入與既有資料）。
        - 更新 processLayerShapefileUploads：
            - 支援一般 shapefile 上傳。
            - 同時處理 watershed 與一般圖層類別。
            - 修改預設匯入圖層名稱。
            - 依類別回傳對應的 layerDataJson。
    4. 後端渲染與端點調整。
        - 在 renderLayout 中註冊新的 partials。
        - 在新增/編輯端點新增通用的 shapefiles 上傳欄位。

# 2026.05.04 王朝威
    1. express/map-server/public/js/modules/config.js。
        - 強化 typeName 的安全後備機制（safe fallbacks）。
        - 在 loadDatabaseLayers() 中新增解析邏輯：
            - 透過 rowsByOgcFid 使用 ogc_fid 解析 watershedRangeMaps 項目。
            - 當 disasterPointMap 以 fid 參照時，自動填入 typeName 與 name。
        - 解析過程發生錯誤時僅記錄 log，不中斷圖層載入流程。
    2. express/map-server/public/js/modules/layers.js。
        - 新增 "showFeatureModalFromProps()" 輔助函式。
        - 為流域圖層（watershed）與災情點位圖層（disaster point）新增點擊事件處理（onEachFeature）。
        - 點擊圖徵時顯示功能詳細資訊彈出視窗（feature details modal），包含座標與屬性。
    3. express/map-server/public/js/modules/ui.js。
        - 優化 "buildPropertyTable()" 函式：
            - 對 HTML 進行跳脫處理，防止 XSS。
            - 物件類型屬性以 <pre> 格式化顯示 JSON。
            - 忽略 null 與 undefined 值，提升可讀性。

# 2026.04.30 王朝威
    1. express/map-server/public/js/modules/layers.js。
        - 新增 'watershed-disaster-composite' 複合圖層模式。
            - 支援同時合併面狀（polygons）與點狀（points）圖層資料。
        - 新增 fetchWFSGeoJSON() 函式。
            - 支援自訂 SRS（空間參考系統）。
            - 支援彈性 BBOX 範圍過濾。
    2. express/map-server/public/js/modules/config.js。
        - 擴展 config 邏輯，支援多來源流域範圍圖（multi-source watershed range maps）。
        - 完善複合圖層的資料來源處理機制。
    3. 依賴套件更新。
        - 新增 shapefile 套件，用於空間資料處理。
    4. 前端 UI 樣式調整。
        - 新增圖層管理卡片（layer management cards）的樣式。
        - 新增資料上傳區塊（data upload sections）的相關樣式。

# 2026.04.29.2 王朝威
    1. postgis/init.sql。
        - 修改 webgis schema 的擁有者（owner）改為 root。
        - 更新 ACL（存取權限）相關註解說明。
    2. 註記.md。
        - 調整文件內容，改為使用 root 資料庫使用者。
        - 更新資料庫備份（dump）的路徑與檔名說明。

# 2026.04.29 王朝威
    1. 資料庫變更。
        - 將使用者驗證相關欄位從 "webgis.users" 表中抽出。
        - 新增獨立資料表："webgis.user_verifications"。
    2. express/map-server/routes/users.js。
        - 新增以下輔助函式：
            - storeUserVerification()
            - deleteUserVerification()
            - getLatestUserVerification()
        - 新增驗證相關的 select 欄位常數。
        - 使用者驗證流程重構，重構以下重要函式：
            - issueVerificationCode()
            - activateUser()
            - createUser()
            - updateUser()
        - 更新 "/verify" 驗證流程。
        - 驗證成功後自動刪除對應的驗證記錄。
        - 非管理員帳號在建立時會正確產生並發送驗證記錄。
        - 在使用者成功驗證或登入後，新增呼叫 updateLastLogin() 更新最後登入時間。

# 2026.04.27.3 王朝威
    1. express/map-server/routes/layers.js。
        - 新增多個資料庫輔助函式：
            - getBasemapConflictLayer()
            - getOverlayConflictLayer()
            - swapConflictingOrders()
            - updateOrderWithSwap()
            - updateSingleLayerOrder()
        - 實作底圖與疊加圖層順序衝突偵測與自動交換邏輯。
        - 新增 /layers/reorder/:id 路由（調整圖層排序）。
        - 新增 /layers/restore/:id 路由（還原已軟刪除圖層）。
        - 包含伺服器端驗證、交易機制（transactional updates）與完整錯誤處理。
        - 圖層更新邏輯調整：
            - updateLayer() 現在支援傳入 transaction。
            - createLayer() 與 updateLayer() 在儲存前將 layerData 轉為 JSON 字串。
        - 還原功能整合：
            - 新增 restoreLayer() 函式，用於還原軟刪除的圖層。
    2. views/layers/index.hjs。
        - 在 views 中加入還原按鈕與表單。
        - 在圖層列表頁支援「雙擊」編輯底圖/疊加圖層的順序。
        - 新增客戶端驗證。
        - 發送 POST 請求至 reorder 端點。
        - 加入 CSRF token 處理。
    3. UI/UX 優化與樣式調整
        - 更新 checkbox 樣式（layers.css）。
        - 多處按鈕改用實心樣式（solid variant）。
        - 統一文字標籤，例如：
            - 「回列表」→ 「返回」
            - 「覆蓋」→ 「疊加」
        - 改善表單 checkbox 已勾選狀態的處理。
        - 小幅調整視圖標記與樣式修正。

# 2026.04.27.2 王朝威
    1. express/map-server/routes/users.js。
        - 新增資料庫輔助函式 "restoreDeletedUser()"。
        - 新增 POST "/users/restore/:id" 路由。
            - 僅限管理員（admin）可使用。
            - 加入 CSRF 保護。
            - 包含完整的錯誤處理與提示。
    2. views/users/index.hjs。
        - 將使用者列表拆分為兩個區塊：
            - 「使用中帳號」（Active Users）。
            - 「已刪除帳號」（Deleted Users）。
        - 新增 can_restore 與 canEditUser 權限旗標。
        - 已刪除帳號顯示「已刪除」徽章（deleted-user badge）。
        - 已刪除帳號顯示「還原」按鈕。
        - 已刪除帳號隱藏編輯相關功能。
    3. express/map-server/views/users/user.hjs。
        - 更新使用者詳細頁面與列表模板。
        - 顯示帳號狀態（active / deleted）。
        - 根據帳號狀態調整可用的操作按鈕（例如：已刪除帳號僅顯示「還原」按鈕）。

# 2026.04.27 王朝威
    1. express/map-server/routes/layers.js（全新檔案）。
        - 新增完整的 Layers 管理路由。
        - 實作以下功能：
            - 圖層列表（list）
            - 圖層詳細檢視（view）
            - 新增圖層（create）
            - 編輯圖層（edit）
            - 軟刪除圖層（soft-delete）
        - 使用 Sequelize raw queries 操作 "webgis.layers" 資料表。
        - 加入伺服器端驗證。
        - 套用 admin 與 login 權限守衛（guards）。
        - 加入 CSRF 保護。
        - 新增渲染輔助函式。
    2. views/layers/（全新目錄）。
        - 新增多個 Handlebars 模板：
            - index.hjs（圖層列表頁）
            - add.hjs（新增圖層頁）
            - edit.hjs（編輯圖層頁）
            - layer.hjs（詳細檢視頁）
    3. express/map-server/public/css/layers.css（全新樣式檔）。
        - 提供圖層管理介面的專用樣式。
        - 支援列表過濾、排序等客戶端互動。
    4. express/map-server/index.js。
        - 掛載新的 /layers 路由器。
        - 更新 /api/layers 端點，支援 ?includeDeleted=true 查詢參數（可顯示已軟刪除的圖層）。

# 2026.04.24 王朝威
    1. express/map-server/package.json
        - 新增 nodemailer 依賴，用於實作電子郵件驗證功能。
    2. .env（環境變數）
        - 新增 SMTP 相關設定：
            - SMTP_HOST
            - SMTP_PORT
            - SMTP_USER
            - SMTP_PASS
            - SMTP_FROM（寄件者郵箱）
    3. 資料庫結構更新（users 資料表）。
        - 新增以下驗證相關欄位：
            - is_active
            - verification_code_hash
            - verification_sent_at
            - verification_expires_at
    4. express/map-server/routes/users.js。
        - 新增發送驗證碼、產生驗證碼雜湊、檢查過期等輔助函式。
        - 更新 createUser：新註冊的非管理員帳號預設為待驗證狀態（pending verification）。
        - 更新 updateUser 處理驗證資料。
        - 新增驗證碼發送邏輯（支援 SMTP 失敗時 fallback 至 console 輸出）。
        - 修改 login 流程：未驗證帳號無法正常登入。
        - 更新 requireLogin 與 requireAdmin 中間件，遇到待驗證帳號時自動導向驗證頁面。
        - 新增 /verify 路由與 /verify/resend 端點。
    5. express/map-server/views/users/verify.hjs。
        - 新增驗證頁面，提示使用者輸入驗證碼。
    6. express/map-server/package.json。
        - 更新 prestart 腳本，確保安裝所有依賴套件。
        - 更新 package.json 中的專案描述與 metadata。

# 2026.04.23.2 王朝威
    1. express/map-server/public/js/modules/config.js。
        - 正規化並排序"合併圖層"選項（merged layer options）。
        - 新增輔助函式：
            - "getMergedLayerSourceId()"：用於正規化來源 ID。
            - "getMergedLayerOptionOrder()"：用於正規化排序順序。
        - 新增 "sortMergedLayerOptions()" 工具函式，用於對合併圖層選項進行可預測（deterministic）的排序。
        - 重構既有邏輯：
            - 在建立 WFS 選擇設定（select configs）及載入資料庫圖層時，以「排序 + 正規化」取代原本零散（ad-hoc）的對應處理方式。
        - 資料清理與標準化：
            - label 會先去除前後空白，若缺失則回退（fallback）使用 sourceId 過濾掉無效或空白的項目。
            - layerOptions 會正規化，確保包含 ogc_fid / value。
        - 預設來源調整：
            - defaultSource 改為使用正規化後的第一個來源。

# 2026.04.23 王朝威
    1. express/map-server/CONTOUR_README.md（全新檔案）。
        - 完整說明 "public/js/modules/contour.js"。
        - 文件內容包含：
            - Kriging 插值方法。
            - d3-contours 的使用方式。
            - 網格（grid）建構。
            - 座標轉換。
            - 渲染流程。
            - 快取機制。
            - 調校與最佳化建議。
    2. express/map-server/public/js/modules/contour.js。
        - 調整 contour.js 預設參數，將插值範圍擴展比例 "extendRatio" / "baseRatio" 從 0.5 提高至 2.0。
        - 涉及函式：
            - "getExtendedMapBounds()"
            - "getExtendRatioByZoom()"
            - "filterPointsForInterpolation()"
        - 目的：
            - 減少邊緣偽影（edge artifacts）。
            - 擴大插值候選範圍，提高結果穩定性。

# 2026.04.22.2 王朝威
    1. express/mcp-server/public/llm-tests/run-llm-model-tests.js。
        - 優先使用既有端點；修正 SSH 通道（tunnel）處理邏輯。
        - 先嘗試非 SSH 通道的端點。
            - 若已有可連線的端點，則不建立 SSH 通道
            - 新增 `buildNonTunnelEndpointCandidates()`
        - 更新 `buildEndpointCandidates()`：
            - 僅在需要時才加入 SSH 通道端點。
        - `resolveWorkingEndpoint` 行為調整：
            - 會重用任何可連線的既有端點。
            - 若所有端點皆不可用且 SSH 通道被停用，則拋出錯誤。
            - 否則會確保 SSH 通道已正確建立並可使用。
            - 當發生 `EADDRINUSE` 錯誤時，會關閉 SSH 通道以避免背景重連迴圈。
        - 函式回傳值變更：
            - 現在僅回傳單一端點字串（endpoint string）。
            - `run()` 也已相應更新。
    2. express/mcp-server/public/llm-tests/llm-models.txt。
        - 精簡 `llm-models.txt`。
            - 將模型清單縮減為較小的子集合。


# 2026.04.22 王朝威
    1. express/mcp-server/public/prompt.txt。
        - 重構並擴充地圖提示詞定義：
            - 將 "prompt.txt" 中的 basemap（底圖）與 dataset（資料集）區段，改為明確的「關鍵字 → 對應值」映射。
            - 新增大量資料集關鍵字（例如：地震、透明地圖、學校、各種行政邊界圖層等）。
            - 補充與釐清映射規則。
    2. express/mcp-server/public/prompt_zh_TW.txt。
        - 對應更新繁體中文提示詞定義，保持與英文版本一致。
        - 確保所有關鍵字映射都已翻譯並正確對應。
    3. express/mcp-server/public/prompt_en_US.txt。
        - 與 "prompt.txt" 保持一致。

# 2026.04.21 王朝威
    1. views/tools/（全新目錄）。
        - 將 Tools Registry 測試介面從獨立靜態 HTML 搬移至 server-rendered views。
        - 新增 views/tools/tools-registry-test.hjs（原 tools-registry-test.html）。
        - 新增 views/tools/README.md：說明 Tools Registry 測試頁面的使用方式與設定。
    2. express/map-server/index.js。
        - 新增路由處理器，提供 /tools/tools-registry-test.html 頁面。
        - 不再依賴 public 靜態資料夾直接提供測試 HTML。
    3. express/map-server/README.md（全新檔案）。
        - 新增 map-server 的詳細說明文件。
        - 包含架構、路由設定、開發注意事項等。
    4. express/map-server/public/js/modules/contour.js。
        - 將 Kriging variogram model 從 'exponential' 改為 'spherical'（球面模型）。

# 2026.04.18.3 王朝威
    1. README.md（專案根目錄）。
        - 新增詳細的 Web GIS 系統架構圖與說明。
        - 加入 MCP / LLM 完整流程圖與說明。
        - 文件化以下內容：
            - Nginx 路由規則
            - SSE（Server-Sent Events）行為
            - Session 生命週期
            - Intent 處理流程
        - 文件化 MCP 已拆分為獨立的 mcp-server 容器（監聽 port 3001）。
        - 新增端點說明：
            - /map/api/mcp/rpc
            - /map/api/mcp/rpc/sse
        - 更新 PowerShell 與 Bash 的使用範例，改用 Nginx 路徑。
        - 將測試指令移至 express/mcp-server 專屬說明。
        - 更新 pgAdmin 存取網址與範例登入憑證資訊。
    2. express/mcp-server/README.md。
        - 全面本地化為繁體中文並大幅擴充內容。
        - 更新檔案結構說明。
        - 說明 docker-compose 設定。
        - 說明健康檢查（healthcheck）機制。
        - 說明 stdio-proxy 使用方式。
        - 提供完整的環境變數範例。
        - 詳細說明 SSH Tunnel 配置方式。
        - 列出目前可用的測試腳本（test scripts）。

# 2026.04.18.2 王朝威
    1. compose.yaml。
        - 簡化 mcp-server 在開發環境的 volume 掛載。
        - 改為直接掛載整個 express/mcp-server 目錄至容器內 /app。
        - 新增匿名 volume /app/node_modules，避免因個別檔案掛載導致開發時容易出錯的問題。
    2. express/map-server/public/js/mcp.js。
        - 大規模重構並進行繁體中文本土化。
        - 大多數註解與使用者介面文字已翻譯為繁體中文。
        - 新增或優化多個輔助函式，包括：
            - removeTransportPanel()。
            - set/isMcpTransportPanelEnabled()。
            - classifyTransportReason()。
            - appendDecision()。
            - 伺服器計時解析功能。
            - 階段記錄器工具（stage recorder utilities）。
            - nowMs()、roundMs()。
            - showMcpMessage()。
            - createStageRecorder()。
            - getServerTimingsFromResponse()。
            - logMcpTimeline()。
        - ToolsRegistry 部分：加入繁體中文註解，並優化 init/fetch/save/load/auto-refresh 等後備機制。
        - MapActions 大幅擴充，新增穩健的 DOM 輔助函式：
            - getLayerControlContext()。
            - selectDatasetSource()。
        - 改善資料集與日期選擇邏輯（selectBestDate、setDatasetDate 支援 selectId override）。
        - 強化疊加圖層、日期、source 選擇流程。
        - 新增不透明度控制輔助函式（setLayerOpacity、adjustLayerOpacityByDelta、adjustActiveLayersOpacity）。
        - 新增 getCurrentLayerState() 用於收集目前圖層狀態。
        - 其他 UX 控制項優化。
    3. runMCP 函式優化。
        - 改善資料集與底圖的解析邏輯。
        - 支援 compare_dataset 推斷。
        - 協調底圖、動作、搜尋、行政區、資料集、不透明度、等高線等完整流程。
        - 為各操作階段記錄計時資訊。
    4. 其他檔案更新。
        - 更新 mcp-server 的 Dockerfile。
        - 更新 README.md 與 SSH_TUNNEL_README。
        - GeoServer 資料目錄中多個 metadata、log 與安全性相關檔案的例行性更新。

# 2026.04.18 王朝威
    1. 後端（express/map-server/index.js）。
        - 新增 tableMappingByOgcFid 與 geomorphSourceLayerFids 資料結構。
        - 新增輔助函式，用來根據 layer fid 或傳統 source 解析對應設定。
        - 在 /api/dates 與 /api/displacement 端點支援 ?source=... 查詢參數。
        - 驗證 fid 輸入格式。
        - 改用參數化 Sequelize 查詢（parameterized queries），防止 SQL Injection。
        - 支援「地貌合併圖層」（merged geomorph point layers），可聚合多個來源圖層並讓使用者選擇特定 source 來載入日期與點位資料。
    2. 前端（express/map-server/public/js/）。
        - 將使用者選擇的 source 傳遞給日期與 displacement 請求。
        - 當 source 變更時，自動重新整理 WFS 圖層。
        - 使用支援 source 的 typeName 解析邏輯。
    3. Config 與 Layers 模組（config.js、layers.js）。
        - 改善地貌來源（geomorph sources）的 select config 偵測機制。
        - 合併 mapOptions 處理邏輯，新增：
            - sourceTypeNameMap
            - sourceLayerNameMap
            - defaultSource
            - inputs 等設定
        - 小幅優化標籤（label）與 ID 的處理。
    4. 其他重構與優化。
        - 集中化地貌點位圖層與地震點位圖層的相關邏輯。
        - 提升整體穩健性與錯誤處理。

# 2026.04.17 王朝威
    1. express/mcp-server/public/llm-tests/expected-web-states.json。
        - 新增多筆 LLM 測試項目（以中文查詢為主）。
        - 包含需要澄清的查詢以及可接受的網頁狀態（acceptable states）。
        - 後續的 queryIndex 值已重新編號。
    2. express/mcp-server/prompt.txt。
        - 修改系統提示詞（system instruction），新增要求 LLM 不要輸出思考過程（suppress reasoning output）。
        - 新增 "## User Request" 標記，用來清楚區分使用者請求內容。

# 2026.04.16 王朝威
    1. express/map-server/public/js/modules/contour.js（全新模組）。
        - 新增可重用的等高線渲染模組 contour.js。
        - 基於 Kriging 內插 + D3 等高線產生器。
        - 主要功能包含：
            - 自適應網格大小（adaptive grid sizing）。
            - 根據邊界與縮放等級過濾點位（bounding/zoom-aware point filtering）。
            - 結果快取機制（caching）。
            - 自動產生門檻值（threshold generation）。
            - 顏色調色盤輔助函式（color palette helpers）。
            - Leaflet 渲染選項支援（fills、lines、tooltips、互動性等）。
    2. express/map-server/public/js/modules/layers.js。
        - 重構地震等高線相關邏輯，改呼叫新的 renderContoursWithKriging() 函式。
        - 移除重複的 contour 程式碼。
    3. express/map-server/public/js/modules/weather.js。
        - 重構雨量等高線相關邏輯，改呼叫 renderContoursWithKriging()。
        - 移除重複的 contour 程式碼。
    4. express/mcp-server/index.js。
        - 小幅調整日誌字串格式。

# 2026.04.15.2 王朝威
    1. express/mcp-server/public/llm-tests/test-queries.txt。
        - 在檔案末尾新增「破中文」專區。
        - 測試案例類型包含：
            - 日期格式混亂。
            - 衝突指令（contradictory instructions）。
            - 錯別字與口語用法。
            - 容易讓 UI 混淆的請求。
    2. express/mcp-server/routes/modules/ssh-tunnel.js。
        - 重構 ssh-tunnel 模組，新增以下功能：
            - manualHealthCheck()：手動執行健康檢查。
            - manualDisconnect()：手動斷開 SSH Tunnel。
            - 序列化的重連迴圈（serialized reconnect loop），支援指數退避（exponential backoff）與排程重試。
            - closeActiveConnections() 輔助函式，用於安全關閉連線。
            - 改善狀態回報，包含 uptime（執行時間）與 nextRetry（下次重試時間）。
            - 優化啟動與關閉流程：
                - 啟動時立即執行健康探測。
                - 在 finally 區塊中確保總是啟動健康檢查。
                - 停止或關閉時清除重連計時器。
    3. express/mcp-server/index.js。
        - 新增兩個公開端點：
            - POST /ssh/health-check：手動觸發 SSH Tunnel 健康檢查。
            - POST /ssh/disconnect：手動斷開 SSH Tunnel。
    4. express/mcp-server/SSH_TUNNEL_README.md。
        - 新增上述兩個端點的詳細說明與使用方式。

# 2026.04.15 王朝威
    1. express/mcp-server/routes/modules/ssh-tunnel.js。
        - 實作完整的 SSH Tunnel 生命週期管理。
        - 新增健康檢查（health checks）機制。
        - 實作指數退避重連（exponential backoff reconnect）。
        - 追蹤隧道狀態（status tracking）。
        - 支援優雅關閉（graceful shutdown）。
        - 新增詳細說明文件：SSH_TUNNEL_README（或 README_ssh-tunnel.md）。
    2. express/mcp-server/index.js。
        - 在 /health 端點中暴露 SSH Tunnel 的目前狀態。
    3. express/mcp-server/routes/mcp.js 與 intent-service.js。
        - 將 SSH Tunnel 實例附加到 MCP Router。
        - 讓伺服器在啟動時初始化隧道。
        - 定期執行健康檢查。
        - 在接收到 SIGTERM / SIGINT 訊號時正確關閉隧道。
    4. 測試相關檔案。
        - 新增單元測試：routes/modules/__tests__/ssh-tunnel.test.js。
        - 新增整合測試：public/llm-tests/ssh-tunnel-integration.test.js。
    5. express/mcp-server/package.json。
        - 新增執行 SSH Tunnel 測試的 npm scripts。
    6. compose.yaml。
        - 更新 volume 掛載設定，包含 routes/bin/index 相關檔案，以便開發時熱重載。

# 2026.04.14.2 王朝威
    1. express/map-server/public/js/mcp.js。
        - 將 Tools Registry 相關的傳輸面板標籤（transport panel labels）、日誌訊息、警告與錯誤提示全面本地化為繁體中文（zh-TW）。
    2. express/map-server/public/js/workers/tools-registry-worker.js。
        - 本地化 Worker 生命週期訊息。
        - 翻譯 RPC / SSE 錯誤文字。
        - 調整警告、錯誤與一般日誌訊息為繁體中文。
    3. express/map-server/public/js/workers/tools-registry.test.js。
        - 更新測試輸出文字與提示訊息為繁體中文。
    4. 文字格式統一調整（上述三個檔案）。
        - 將省略號（...）統一改為全形省略號（……）。
        - 將冒號（:）統一調整為全形冒號（：）。
        - 優化標點符號與排版格式，提升中文閱讀舒適度。

# 2026.04.14 王朝威
    1. express/mcp-server/（多個模組與測試檔案）。
        - 將使用者介面訊息、錯誤提示與日誌全面翻譯為繁體中文（臺灣用語）。
        - 涵蓋 intent-service、rpc-response、session-transport 等 MCP Server 主要模組。
        - 更新測試檔案中的提示文字與輸出訊息。
    2. LLM 連線設定調整（express/mcp-server/）。
        - 將預設 Ollama / LLM endpoint 改為：
            - http://host.docker.internal:11434/api/generate
        - 新增 SSH Tunnel 支援與端點探測機制（endpoint probing）。
        - 在 run-llm-model-tests.js 中加入逾時處理（timeout）與提示訊息。
        - 每次發送請求前，先確認可正常運作的 endpoint。
    3. express/mcp-server/package.json。
        - 重新排序並新增 LLM 測試相關 npm scripts。

# 2026.04.13 王朝威
    1. 後端 - Map Server（express/map-server/）。
        - 新增兩個 API 端點：
            - /api/earthquake-events：取得地震事件資料。
            - /api/earthquake-contours：取得地震等高線資料。
        - 調整圖層映射查詢語法。
        - 新增地震相關欄位的允許清單驗證（allowed earthquake fields validation）。
    2. 前端 - 地圖 UI（express/map-server/public/js/）。
        - 支援 WFS 點位圖層的多選與 selectConfigs 機制。
        - 強化比較地圖的同步功能（compare map syncing）。
        - 更新 createOverlayControl 與 select 元件，加入地震相關 UI。
        - 切換圖層時自動清除舊的等高線疊加圖層（clear contour overlays）。
    3. Layers 模組（express/map-server/public/js/modules/layers.js）。
        - 新增地震專屬處理邏輯：
            - 取得地震點位資料。
            - Kriging 訓練與內插計算。
            - 使用 D3 產生等高線。
            - 等高線圖層管理。
            - 彈出視窗（popups）建構。
        - 匯出 clearOverlayContours() 函式。
        - 支援地震圖層的渲染與驗證。
    4. Config 模組（express/map-server/public/js/modules/config.js）。
        - 建構 selectConfigs，包含地震事件與數值欄位的下拉選單。
        - 將其串接至 addWfsPointLayerByFlags() 與 loadDatabaseLayers()。
    5. Compare 模組（express/map-server/public/js/modules/compare.js）。
        - 調整比較地圖以支援 multi-select configs。
        - 讓比較地圖與主地圖的選擇狀態保持同步。
    6. MCP Server（express/mcp-server/）。
        - 新增 SSH Tunnel 配置流程（環境變數 → mcp router）。
        - 整合 ssh2 套件。
        - 在 intent-service 中新增 createSshTunnel 使用邏輯，可選擇性開啟本地 SSH tunnel，並優先使用 tunnel endpoint。
        - 新增 ssh-tunnel 模組，實作 SSH local port forwarding。
    7. 設定與文件。
        - .env：新增 LLM SSH Tunnel 相關環境變數。
        - README.md：補充 SSH Tunnel 使用說明，並更新 docker compose 服務名稱。
        - express/mcp-server/package.json：新增 ssh2 依賴。
        - 更新 llm model 清單。

# 2026.04.10 王朝威
    1. express/map-server/index.js。
        - 擴充圖層查詢 SQL，新增取得 category 與 layer_data 欄位。
        - 解析 layer_data JSON 欄位。
        - 優先使用 layer_data 中的 table / typeName 來建立 table mapping。
        - 目前僅納入類別為「地貌點位圖層」的圖層。
    2. express/map-server/public/js/modules/config.js。
        - 移除原本的 LAYER_TYPES 常數。
        - 新增輔助函式：
            - parseLayerCategory()：解析圖層類別，回傳標準化的類別名稱。
            - parseLayerData()：解析圖層資料欄位，回傳包含 type、url、options 的物件。
        - 正規化 category 字串（去除多餘空格、大小寫統一等）。
        - 將新的 layer_data 與舊有欄位進行合併（merge）。
        - 依據 category 路由圖層：
            - 一般圖層（wms/wmts）使用 addLayerByFlags()。
            - 地貌點位圖層（wfs）使用 addWfsPointLayerByFlags()。
        - 在載入與建立圖層時使用新的分類邏輯。
    3. express/mcp-server/llm-models.txt。
        - 新增 gemma4 模型條目。

# 2026.04.09.3 王朝威
    1. express/mcp-server/llm-tests/（全新目錄）。
        - 將原本位於 "express/map-server/public/llm-tests/" 的所有測試資產完整搬移至此。
        - 新增範例檔案："llm-response.txt"（用於運行時追加 LLM 回應記錄）。
    2. compose.yaml。
        - 更新 volume 掛載設定，將 mcp-server 的 llm-tests 資料夾正確掛載進容器。
    3. express/map-server/package.json。
        - 將 package name 改為 "webgis-app"。
        - 移除所有與 LLM 及測試相關的 npm scripts。
    4. express/mcp-server/package.json。
        - 新增多項 LLM 測試相關 npm scripts：
        - "test:mcp-protocol"
        - "test:regression:quick"
        - "test:llm-models"
        - "test:llm-web-states:init"
        - "test:llm-web-states:record"
        - "test:llm-web-states:validate"
    5. express/mcp-server/routes/modules/intent-service.js。
        - 強化 append logging 機制：
            - 明確 require path。
            - 在寫入 log 前先執行 mkdir -p 建立父目錄。
            - 確保即使目錄不存在也能穩健寫入 LLM 回應記錄。

# 2026.04.09.2 王朝威
    1. express/mcp-server/routes/modules（模組重構）。
        - 將原本單一的大型 routes/mcp.js 拆分成多個小型模組：
            - intent-service.js。
            - protocol-utils.js。
            - resource-service.js。
            - rpc-dispatcher.js。
            - rpc-response.js。
            - session-transport.js。
        - 更新 mcp.js，使用新的模組化 dispatcher 與 session transport 來處理請求。
    2. LLM 設定相關調整。
        - 預設 LLM 模型升級為 gemma4:31b。
        - 新增支援 LLM_ENDPOINTS 環境變數（可接受逗號分隔的多個端點）。
        - run-llm-model-tests.js 現在會優先使用 LLM_ENDPOINT 作為後備機制。
    3. 設定與文件更新。
        - 更新 .env 範例檔案，加入新的 LLM 相關環境變數。
        - 更新 README.md，補充 LLM endpoint 使用說明。
        - 擴充 prompt 中的關鍵字映射（keyword mappings），包含更多英文同義詞，並明確說明 reset 行為。
    4. express/mcp-server/Dockerfile。
        - 調整 COPY 指令，確保正確複製 mcp-server 的 package 相關檔案。
        - 設定正確的工作目錄（working directory）。
    5. express/mcp-server/package.json。
        - 新增運行時必要依賴套件：
            - dotenv。
            - express。
            - pg。
            - sequelize。

# 2026.04.09 王朝威
    1. express/map-server/（全新目錄，Express 應用搬移目標）。
        - 將原本的 Express 應用程式從 express/ 搬移到此目錄中。
        - 包含以下主要檔案與資料夾：
            - Dockerfile。
            - package.json。
            - routes/（Express 路由模組）。
            - views/（Express 視圖模板）。
            - public/（前端資產，如 JavaScript、CSS、圖片等）。
    2. compose.yaml。
        - 將原本的 Express 服務名稱改為 map-server。
        - 更新 build 路徑：改為 "./express/map-server"。
        - 更新 volume 掛載：./express/map-server:/app。
        - 修改 nginx 服務的 depends_on，改為依賴 map-server。
    3. nginx/default.conf。
        - 微調設定，更新後端 proxy 目標為 map-server 服務。

# 2026.04.08 王朝威
    1. express/mcp-server/（全新獨立服務目錄）。
        - 新增 Dockerfile。
        - 新增 package.json。
        - 新增 index.js（主要伺服器入口）。
        - 新增 stdio-proxy（標準輸入輸出代理）。
        - 新增 CLI shim（命令列相容層）。
        - 新增 .vscode/launch.json（VS Code 除錯設定範例）。
        - 新增 .mcp 描述檔。
        - 新增 env 範例檔案（供 mcp-server 使用）。
        - 新增 README.md（服務說明、啟動方式與架構文件）。
    2. express/mcp-server/（從原 express 搬移的資產）。
        - 將原本的 MCP route 與 lib 相關檔案移入此獨立目錄。
        - 重新組織 MCP 後端邏輯，使其成為可獨立運行的服務。
    3. docker-compose.yaml。
        - 新增 mcp-server 服務定義，使用 express/mcp-server 目錄下的 Dockerfile。
        - 設定 nginx 依賴於 mcp-server（depends_on）。
        - 調整服務啟動順序與網路連線。
    4. .env。
        - 新增 MCP 與 LLM 相關環境變數。
        - 同步更新 .env.example 或相關範例檔。
    5. express/index.js。
        - 移除原本的 in-process MCP 路由與相關 wiring 程式碼。
        - 不再直接處理 MCP 請求（改由獨立 mcp-server 負責）。
    6. express/package.json。
        - 更新 npm scripts（調整與 MCP 相關的測試、啟動指令）。
    7. express/public/llm-tests/。
        - 更新 LLM 測試 fixtures。
        - 更新 expected-web-states.json 等預期網頁狀態定義。
        - 加入新的 intent 欄位與驗證行為的對應調整。

# 2026.03.26.3 王朝威
    1. express/public/js/mcp.js。
        - MCP transport monitor 面板位置改為左下角，並加入關閉按鈕（X）。
        - 面板預設為關閉，並以 localStorage 保留顯示偏好。
        - 新增全域可呼叫的顯示控制方法與 `mcp-transport-visibility-changed` 事件，供其他 UI 元件同步狀態。
    2. express/views/partials/navbar.hjs。
        - 將 MCP transport monitor 控制放入管理員下拉選單，限制僅管理員可操作。
        - 控制元件由 checkbox 改為單一切換按鈕，並顯示目前狀態（開啟/關閉）。
        - 按鈕點擊後會切換 monitor 狀態，並透過事件即時同步按鈕文字與狀態標籤。

# 2026.03.26.2 王朝威
    1. express/lib/mcpRegistry.js。
        - 擴充 MCP tools 定義，新增 `webgis.get_map_state` 與 `webgis.adjust_layer_opacity`。
        - `webgis.parse_intent` input schema 新增 `map_state`，讓 LLM 可讀取當前圖層狀態。
        - `map.select_dataset` schema 新增 `weather_contours`、`rainfall_contours` 欄位。
    2. express/public/js/mcp.js。
        - 新增 `collectMapStateFromDom()` 與 `notifications/map_state` 同步流程。
        - 新增圖層透明度相對調整流程（`opacity_delta`）與指定圖層優先套用邏輯。
        - 修正「陰影圖/雷達影像」同名底圖誤切換問題，避免指令把疊圖切成底圖。
        - 新增氣象/雨量等高線執行流程（依 `weather_contours`、`rainfall_contours` 勾選項目）。
    3. express/public/llm-tests/llm-models.txt。
        - 更新本機可用 LLM 模型清單，供 `run-llm-model-tests.js` 使用。
    4. express/public/llm-tests/test-queries.txt。
        - 補充英文測試語句與 `## broken English` 測試段落（文法/拼字/時態錯誤）。
        - 新增與 MCP 圖層、透明度、觀測站等高線相關的驗證語句樣本。
    5. express/public/llm-tests/validate-mcp-protocol.js。
        - 新增 MCP 工具曝光檢查：`tools/list` 必須包含 `webgis.get_map_state`、`webgis.adjust_layer_opacity`。
        - 保留並延伸 session readiness、SSE replay、prompt params 等既有協定回歸驗證。
    6. express/public/prompt.txt。
        - 重寫開頭規則為更精簡、專業的 JSON-only 約束描述。
        - 補充「目前圖層」與「指定單一圖層」透明度語意規則。
        - 新增氣象/雨量觀測站與等高線欄位（`weather_contours`、`rainfall_contours`）定義與範例。
    7. express/routes/mcp.js。
        - 新增 `notifications/map_state`，將前端當前圖層狀態存入 MCP session。
        - 新增 `webgis.get_map_state` / `webgis.adjust_layer_opacity` 工具實作。
        - 將 MCP 專用邏輯（intent parsing、resource list/read、LLM log）由 `index.js` 內聚至 route 模組。
    8. express/views/partials/map.hjs。
        - `map.js`、`mcp.js` script URL 加入版本參數，避免舊快取導致 MCP 路徑或行為不一致。
    9. express/index.js。
        - 精簡為路由裝配層，移除 MCP 專用分析/資源/記錄函式。
        - MCP router 改以注入 `sequelize` 與設定掛載，保留 `/api/mcp/rpc`、`/api/mcp`、`/api/mcp/rpc/sse`。
    10. express/package.json。
        - 新增 `iconv-lite` 直接依賴，降低容器中 body-parser 編碼模組缺失風險。

# 2026.03.26 王朝威
    1. express/index.js、express/routes/mcp.js。
        - 新增 MCP router，並在 express/index.js 串接 `/api/mcp/rpc` 路由。
        - 實作 MCP intent parsing / normalization 流程，整合以 Ollama 為基礎的 `analyzeMcpIntent`。
        - 新增 origin allowlist 解析與 Origin 拒絕 runtime warning log（含 Origin 值）。
        - 新增 MCP resource listing / read 能力。
        - 強化 session readiness gate：未 `ready` 時拒絕非初始化請求並回 `-32002`。
        - 強化 SSE 續傳回放邏輯：`Last-Event-ID` 需搭配 `MCP-Stream-Id`，且 anchor event stream 必須一致。
        - `prompts/get` 缺參數情境改回 `-32602` 錯誤結構。
    2. express/lib/mcpRegistry.js。
        - `renderPrompt` 新增必要參數驗證；缺少 required argument 時拋錯，供路由層回傳 `-32602`。
    3. express/public/js/mcp.js、express/public/js/workers/tools-registry-worker.js。
        - 新增 ToolsRegistry 與 worker 的 session 404 自癒流程：自動 `initialize` + `notifications/initialized` 後重試一次 `tools/list`。
        - 主執行緒與 worker 支援 session 續用與 `session-renewed` 同步。
        - 新增/更新 tools-registry 測試整合流程。
    4. express/public/js/workers/tools-registry.test.js、express/public/tools-registry-test.html。
        - 新增 tools-registry 測試相關 worker test harness 與測試頁。
    5. express/package.json。
        - 新增 `test:mcp-protocol` 協定回歸指令。
        - 新增 `test:regression:quick`（協定 + Web 狀態）快速回歸指令。
    6. express/public/llm-tests/validate-mcp-protocol.js。
        - 新增/補強 prompts/cancel/templates/SSE progress 協定驗證流程。
        - 新增 pre-ready 拒絕測試：`notifications/initialized` 前呼叫 `tools/list` 應失敗。
        - 調整 initialize 測試流程，明確分離 `initialize` 與 `notifications/initialized`。
        - 新增 SSE `Last-Event-ID` + `MCP-Stream-Id` 重播驗證。
        - 新增 `initialize` capability 宣告檢查：`tools/resources/prompts.listChanged` 必須為 `false`。
        - 新增 SSE 續傳前置條件檢查：缺少或錯誤 `MCP-Stream-Id` 不得重播事件。
        - 新增缺必要參數案例：`prompts/get` 缺參數應回 `-32602`。
    7. README.md、express/public/llm-tests/WEB_STATE_VALIDATION_README.md。
        - 補充 MCP HTTP+SSE 規格、session lifecycle 與 SSE 續傳條件（需 `MCP-Stream-Id`）。
        - 補充 `validate-mcp-protocol.js` 使用說明、覆蓋項目與快速回歸指令。
    8. TOOLS_REGISTRY_TEST_GUIDE.md、TOOLS_REGISTRY_TEST_CHECKLIST.md、TESTING_READY.md、check-test-system.sh。
        - 新增本機測試流程文件與快速檢查腳本。

# 2026.03.24 王朝威
    1. express/public/llm-tests/。
        - 新增 validate-llm-web-states.js：自動化 LLM Web 狀態驗證腳本。
            - 支援三種模式：--init、--record、--validate。
            - --init：初始化狀態檔案結構。
            - --record：執行測試查詢並記錄 LLM 回應與相關狀態到 JSON 檔案。
            - --validate：將當前 LLM 回應與先前記錄的狀態進行比對，驗證是否一致。
        - 新增 expected-web-states.json：預期網頁狀態基準檔。
            - 包含每個測試查詢對應的預期狀態資訊（底圖、疊加圖層、日期選擇等）。
            - 用於 validate 模式下的比對依據。
        - 新增 results-csv 目錄：用於存放測試結果的 CSV 檔案。
        - 新增 README.md：說明測試流程、使用方式與注意事項。
        - 更新 llm-models.txt、test-queries.txt。
        - 更新 run-llm-model-tests.js。
    2. express/package.json。
        - 新增三個 npm scripts：
            - "test:llm-web-states:init"：初始化預期狀態。
            - "test:llm-web-states:record"：錄製當前網頁狀態。
            - "test:llm-web-states:validate"：執行驗證，比對實際與預期狀態。
    3. express/public/js/（前端資產）。
        - 新增 D3.js（d3.min.js）：用於客戶端資料視覺化。
        - 新增 kriging.js：用於克利金內插法（kriging interpolation）計算與渲染。
    4. express/public/js/map.js。
        - 更新引用，整合 D3 與 kriging 相關功能。
        - 調整地圖初始化與視覺化相關邏輯。
    5. express/public/js/modules/weather.js。
        - 整合 D3 與 kriging 進行雨量等高線或其他視覺化處理。
        - 優化氣象相關圖層的渲染效能與顯示效果。
    6. views/partials/map.hjs。
        - 更新模板，加入 D3 與 kriging 所需的 script 載入標籤。

# 2026.03.17.2 王朝威
    1. express/index.js。
        - 新增 /api/weather-stations/data 端點：取得氣象站資料。
        - 新增通用代理端點 /api/cwa/proxy/:dataset。
            - 用於轉發 Central Weather Administration (CWA) API 請求。
            - 自動帶入 .env 中的 CWA_API_KEY 作為 Authorization。
            - 解決瀏覽器 CORS 限制問題。
    2. .env。
        - 新增 環境變數 CWA_API_KEY，用於驗證與呼叫中央氣象署開放資料 API。
    3. express/public/js/modules/weather.js（全新模組）。
        - 實作雨量與氣象站疊加圖層相關控制器。
        - 主要功能包含：
            - 氣象站標記（station markers）。
            - IDW 反距離加權內插（Inverse Distance Weighting interpolation）。
            - 等高線（contour）產生與渲染。
            - 點位資訊彈出視窗（popup）建構器。
        - 匯出可用的疊加圖層名稱（overlay names），供 map.js 註冊使用。
    4. express/public/js/map.js。
        - 註冊新的 CWA 相關疊加圖層（rainfall、meteorological stations）。
        - 綁定 UI 事件（開關、參數調整等）。
        - 實作延遲載入（lazy loading）機制。
        - 當縮放地圖或參數變更時，重新繪製雨量等高線（redraw contours）。
    5. express/public/js/modules/ui.js。
        - 新增 weather-contour 控制項元件。
        - 將其註冊進疊加圖層控制項清單（overlay controls）。
        - 支援等高線樣式、顏色階、數值範圍等調整 UI。
    6. express/public/css/map.css。
        - 增加控制項選項區塊的最大高度（max-height）。
        - 啟用垂直捲軸（overflow-y: auto），讓選項過長時可捲動瀏覽。
    7. express/public/weather-stations 目錄（全新輔助資料夾）。
        - README：說明 CWA 資料使用方式、API 限制與 scraper 注意事項。
        - rainfall-map.html：獨立的雨量地圖檢視頁面（standalone viewer）。
        - scraper 腳本：
            - JavaScript 版本（瀏覽器或 Node.js 執行）。
            - Python 版本（資料抓取與處理範例）。

# 2026.03.17 王朝威
    1. express/index.js。
        - 新增 getNowMs() 高精度計時輔助函式，統一取得當前時間的方式。
        - 修改 /api/mcp 端點的處理邏輯，實作 LLM/MCP 流程各階段計時與紀錄：
            - client:read-response-text → 測量從回應中讀取文字的時間。
            - client:parse-response-json → 測量解析 JSON 的時間。
            - client:run-mcp → 測量執行 MCP 的時間。
            - 在完成 MCP 執行後，將整個流程的時間與各階段的時間紀錄到 logMcpTimeline() 中，方便後續分析與優化。
        - 新增 格式化與附加 LLM 回應日誌的函式（formatMcpLogEntry()、appendMcpResponseLog()）。
        - 將 LLM 回應記錄附加至 public/llm-response.txt。
        - 在回應中設定兩個自訂標頭：
            - Server-Timing → 包含 LLM 回應的相關時間資訊，格式化為 Server-Timing 標頭的形式。
            - X-MCP-Server-Timings → 包含 MCP 執行過程中各階段的詳細時間資訊，格式化為 JSON 字串。
        - 修改 Ollama 連線設定：改用 port 11435 與模型 gemma3:27b。
    2. public/llm-tests 目錄。
        - 新增 llm-models.txt 檔案，列出要測試的 LLM 模型名稱。
        - 新增 llm-response.txt 檔案，用於記錄 LLM 的回應內容與相關資訊。
        - 新增 run-llm-model-tests.js 腳本，實作對不同 LLM 模型的測試流程，並將結果記錄到 llm-response.txt 中。
        - 新增 test-queries.txt 檔案，列出要測試的查詢語句。
        - 新增 llm-response 目錄，用於存放每個模型的回應結果檔案。
    3. public/js/mcp.js。
        - 實作客戶端階段記錄器（stage recorder）與時間軸日誌功能。
        - 對 runMCP 流程進行儀表化（instrument），記錄各階段時間。
        - 讀取伺服器回傳的 X-MCP-Server-Timings 標頭。
        - 合併伺服器與客戶端時間軸並記錄完整 timeline。
    4. public/js/modules/ui.js
        - 新增 initializeBasemapControls()：動態產生底圖控制項。
        - 新增 createBasemapRadio()：產生單選按鈕形式的底圖選擇 UI。
        - 強化底圖選擇邏輯的穩健性（robust selection）。
        - 確保底圖切換時不會遺失疊加圖層狀態。
    5. public/js/modules/compare.js。
        - 改善比較地圖的預設值設定。
        - 強化比較模式下底圖與疊加圖層的處理一致性。
    6. public/js/modules/config.js。
        - 讓 basemap / overlay 設定支援動態載入（dynamic-ready）。
        - 新增排序支援：basemap/overlay order maps。
        - 實作通用 addLayerByFlags() 函式，支援 WMS / WMTS 等類型。
        - 資料庫圖層載入時加入穩定排序邏輯。
    7. express/package.json。
        - 新增 npm script："npm run test:llm-models"，用於執行 LLM 模型測試腳本。

# 2026.03.11 王朝威
    1. express/index.js。
        - 將 tableMapping 初始化為空物件。
        - 新增 getTableMapping 輔助函式（供其他模組安全取得映射）。
        - 修改 /api/layers 端點：改用 SELECT * 查詢所有欄位。
        - 修正 /api/dates 的映射邏輯，正確使用 ogc_fid 作為識別欄位。
    2. express/public/js/modules/config.js。
        - 移除原本硬編碼、重複的 WMS 圖層設定。
        - 新增輔助函式：
            - getOrderedOverlayNames() → 取得有穩定排序的疊加圖層名稱清單。
            - getSharedLayerNames() → 取得可在不同底圖間共用的圖層名稱。
        - 新增清除動態圖層條目的函式。
        - 新增解析資料庫 flags 的邏輯。
        - 實作模組化的圖層新增處理器，根據 DB 中的 type 旗標動態加入 WMS 或 WFS 圖層。
        - wfsPointConfigs 改為初始空陣列。
        - loadDatabaseLayers() 現在會讀取資料庫新欄位：
            - type, url, map_options, options, is_basemap, is_overlay
        - 依據上述欄位正確註冊圖層類型與屬性。
    3. express/public/js/modules/ui.js。
        - 大幅重構疊加圖層控制項產生邏輯，改為可組合（composable）的函式。
        - 新增核心函式：
            - createOverlayControl()
            - getOverlayControlComponents()
        - 新增專門產生 checkbox / select / transparency 控制項的 helper。
        - 新增 getOverlayOptionsElementByInput() 與 getOverlayOptionsElementByLayer()。
        - initializeOverlayControls() 現在接受有序的圖層名稱清單作為參數，提升控制項排序穩定性。
    4. express/public/js/map.js 與 modules/compare.js。
        - 引入 getOrderedOverlayNames() 與 getSharedLayerNames()。
        - 使用 UI.getOverlayOptionsElementByInput() 來取得選項元素。
        - 將有序的疊加圖層名稱串接到控制項初始化流程。
        - 改善共用圖層在底圖切換時的啟用/停用邏輯。
        - 簡化多處 DOM 查詢與元素存取方式。
    5. express/public/js/modules/layers.js。
        - 修正日期選項的值邏輯：改用真正的日期字串（date string），而非 ogc_fid。
        - 確保 WFS 點位圖層的日期選擇行為正確。
        
# 2026.03.04 王朝威
    1. 修改 express/index.js。
        - 新增 getTableMapping() 函式，從資料庫中取得圖層名稱與對應的資料表名稱的映射關係。
        - 新增 /api/layers 路由，回傳圖層名稱與資料表名稱的映射關係，供前端使用。
            - 確保後續請求可快速取得映射而無需重複查詢資料庫。
        - 新增 /map/api/session-result 路由，提供 session 層級的查詢結果（用於動態圖層相關操作）。
    2. 修改 express/public/js/modules/config.js。
        - 新增 loadDatabaseLayers() 函式，從 /api/layers 取得圖層與資料表的映射關係，並動態更新 config.js 中的圖層配置。
            - wfsPointConfigs 改為從資料庫動態取得並填充（不再硬編碼）。
        - 新增 parseOptionsJson() 函式，解析圖層選項的 JSON 字串或物件，確保前端能正確處理從後端獲取的配置。
    3. 修改 express/public/js/map.js。
        - 將地圖初始化流程改為非同步（async）。
        - 更新 basemap（底圖）與 overlay（疊加圖層）的 key 值與預設配置。
            - 確保新動態載入邏輯與既有預設值相容。
    4. 修改 express/public/js/modules/ui.js。
        - 新增 createSimpleOverlayControl() 函式，簡化疊加圖層控制面板的生成與事件綁定。
        - 新增 createSelectOverlayControl() 函式，專門用於生成帶有日期選單的疊加圖層控制項。
        - 新增 initializeOverlayControls() 函式，根據 config.js 中的圖層配置動態生成對應的控制面板與事件綁定。
            - 將原本靜態的 overlay 控制項 HTML 產生邏輯全部移至 helper 函式。
    5. 修改 express/public/js/modules/compare.js。
        - 同步比較圖層的設定（configs）與動態產生的 HTML 控制項。
        - 在動態控制項產生完成後再綁定相關事件（event listeners）。
    6. 修改 express/public/css/map.css。
        - 新增 .text-nowrap 類別，控制文字顏色與字體大小。

# 2026.02.27 王朝威
    1. 修改 express/public/css/users.css。
        - 新增大量響應式（responsive）規則，涵蓋：
            - 使用者列表頁面 (users/index.hjs)。
            - 新增使用者頁面 (users/add.hjs)。
            - 修改使用者頁面 (users/edit.hjs)。
            - 使用者詳細資料頁面 (users/user.hjs)。
    2. 修改 使用者相關模板 (express/views/users/*.hjs)。
        - 按鈕與圖示優化：
            - 為按鈕新增圖示（icon）與 .btn-label 文字 <span>。
            - 修正姓名欄位間距問題。
        - 將「刪除」文字改為「停用」，並同步更新確認提示文字。
        - 調整多處按鈕佈局，強化手機與桌面端的視覺與操作一致性。
    3. 修改 express/views/partials/map.hjs。
        - 將主題切換邏輯完整移至 navbar.hjs。

# 2026.02.24 王朝威
    1. 修改 express/views/partials/navbar.hjs。
        - 修改 導覽列的響應式樣式，將 sm 斷點更改為 md。
        - 新增 導覽列登入後顯示使用者的頭像，如果有的話，否則顯示預設頭像。
        - 新增 頭像點擊後展開下拉選單。
            - 新增 下拉選單中顯示使用者的名字、姓氏、ID 等基本資訊。
            - 新增 個人資料連結。
            - 新增 管理員專用連結（僅對管理員顯示）。
                - 圖層管理頁面。(目前尚未實作)
                - 使用者管理頁面。
            - 新增 主題切換(亮/暗模式)。
            - 新增 登出連結。
        - 新增 頭像、頭像圓形裁切、dropdown 樣式與定位相關 CSS。
    2. 修改 express/routes/users.js。
        - 修改 登入成功後的 session 資訊儲存，加入使用者的名字、姓氏、頭像 URL 等資訊，以便在前端顯示使用者相關資訊。
    3. 修改 express/index.js。
        - 修改 /api/auth-status 路由的回傳資料，加入使用者的名字、姓氏、頭像 URL 等資訊，以便在前端顯示使用者相關資訊。
    4. 修改 express/public/css/color-theme.css。
        - 新增 .root 類別的 CSS 變數定義，避免瀏覽器抽風，沒有正常套用 .root.light 與 .root.dark 的變數覆蓋。

# 2026.02.06 王朝威
    1. 修改 .env。
        - 更新 Postgres 資料庫連線憑證（使用者名稱與密碼）。
        - 更新 GeoServer 管理員帳號密碼。
        - 更新 pgAdmin 的電子郵件與密碼。
        - 所有憑證已同步調整為目前可用的開發環境值。
    2. 修改 express/index.js。
        - 調整 Express 預設資料庫連線參數，使其與新的 .env 憑證一致。
    3. 修改 compose.yaml。
        - 將 GeoServer 的資料目錄改為直接掛載本機目錄：./geoserver/data_dir。
        - 移除原本的 named volume「geoserver_data」。
        - 註解掉 nginx 的 443:443 埠對應（開發環境不開啟 HTTPS）。
    4. 修改 geoserver/data_dir/global.xml。
        - 註解掉 proxyBaseUrl 與 useHeadersProxyURL 設定（開發環境避免代理相關問題）。
    5. 修改 /。
        - 移除未使用的 map.js 檔案中。

# 2026/02/05 王朝威
    1. 新增 express/routes/users.js。
        - 實作 使用者管理相關的路由處理邏輯，包含登入、登出、新增使用者、刪除使用者、修改使用者資料等功能。
        - 使用 bcrypt 來處理密碼的雜湊與驗證。
        - 使用 express-session 來管理使用者的登入狀態。
        - 修改 對以下路由新增 csrfProtection 中介軟體：
            - GET /map/users/login
            - POST /map/users/login
            - GET /map/users/add
            - POST /map/users/add
            - GET /map/users/edit/:id
            - POST /map/users/edit/:id
            - POST /map/users/delete/:id
    2. 修改 express/index.js。
        - 修改 設定 session 中介軟體，包含 secret、resave、saveUninitialized、cookie 等選項。
        - 新增 引入 users.js 路由模組並註冊路由。
        - 實作 檢查登入狀態的中介軟體，保護需要登入才能訪問的路由。
        - 修改 csrf 保護中介軟體。
            - 移除 原本全域的 app.use(csrf())。
            - 新增 csrfProtection 實例，並在需要的路由中使用。
        - 修改 註解說明，更新使用者管理相關的說明文字。
    3. 修改 express/views/partials/navbar.hjs。
        - 修改 導覽列的登入/登出按鈕，根據使用者的登入狀態顯示不同的內容。
            - 已登入：顯示歡迎訊息、使用者名稱、使用者管理連結、登出按鈕。
            - 未登入：顯示註冊/登入按鈕。
    4. 新增 express/views/users/login.hjs。
        - 實作 使用者登入頁面的 HTML 結構與樣式。
        - 包含使用者名稱與密碼的輸入欄位，以及登入按鈕。
    5. 新增 express/views/users/index.hjs。
        - 實作 使用者列表頁面的 HTML 結構與樣式。
        - 顯示所有使用者的基本資訊，並提供新增、編輯、刪除使用者的功能。
    6. 新增 express/views/users/add.hjs。
        - 實作 新增使用者頁面的 HTML 結構與樣式。
        - 包含使用者名稱、密碼、名字、姓氏、電子郵件、電話、頭像等欄位的輸入表單。
        - 若是管理員新增使用者，則可設定該使用者是否為管理員。
        - 實作 頭像圖片的上傳與預覽功能，使用 JavaScript 來處理檔案選擇與預覽顯示。
    7. 新增 express/views/users/edit.hjs。
        - 實作 修改使用者頁面的 HTML 結構與樣式。
        - 包含密碼、名字、姓氏、電子郵件、電話、頭像等欄位的輸入表單。
        - 若是管理員修改使用者，則可設定該使用者是否為管理員。
        - 實作 頭像圖片的上傳與預覽功能，使用 JavaScript 來處理檔案選擇與預覽顯示。
    8. 新增 express/views/users/user.hjs。
        - 實作 使用者詳細資料頁面的 HTML 結構與樣式。
        - 顯示使用者的完整資訊，並提供編輯使用者的功能。
    10. 新增 express/views/partials/errors.hjs。
        - 實作 顯示錯誤訊息的部分樣板。
        - 用於在使用者管理相關頁面中顯示驗證錯誤或其他錯誤訊息。
    11. 新增 express/public/css/users.css。
        - 實作 使用者管理相關頁面的 CSS 樣式。
        - 包含登入頁面、使用者列表頁面、新增/修改使用者頁面的樣式設定。
    12. 修改 express/public/css/styles.css。
        - 新增 基礎佈局樣式，用於網站的整體佈局。
        - 新增 錯誤頁面樣式，用於顯示錯誤訊息的頁面。
    13. 修改 express/views/layout.hjs。
        - 刪除 {{> map}} 部分樣板區塊，改為在主要內容區域動態載入不同的頁面。
        - 新增 {{> main}} 部分樣板區塊，用於包裹主要內容區域。
    14. 新增 express/public/files/avatar/avatar_default.png。
        - 預設使用者頭像圖片。
    15. 新增 express/public/files/tables/。
        - 未來可用於使用者上傳的資料表檔案存放目錄。
    16. 修改 express/package.json。
        - 新增 bcrypt 套件，用於密碼的雜湊與驗證。
        - 新增 multer 套件，用於處理頭像圖片的上傳。
    17. 修改 nginx/default.conf。
        - 修改 Express 伺服器的代理設定，添加正確的 headers。
    18. 新增 express/public/js/users.js。
        - 實作 使用者頭像上傳與預覽功能的 JavaScript 程式碼。
        - 包含選擇圖片檔案、顯示預覽、移除選擇的圖片等功能。

# 2026/02/01 王朝威
    1. 修改 express/public/css/map.css。
        - 更新 地圖字體大小並統一規格，以提升整體介面一致性。
            - 地圖載入指示器 .loading、.error：1.5rem。
            - 地圖控制按鈕 #control-toggles button：1.2rem。
            - 控制面板標題 .control-header h3：1.5rem。
            - 控制面板關閉按鈕 .close-btn：2.0rem。
        - 地圖應用程式永遠佔滿視窗，不會出現頁面級別的滾動條，阻斷了視窗寬度改變的連鎖反應，解決了地圖不必要的重繪與資料請求。
            - body 與 #map-wrapper 的 overflow 屬性改為 hidden。
    2. 修改 introduction/開發日誌.txt。
        - 更新專案計畫內容。
        - 補充更詳細的使用者管理需求。
        - 加入版本號命名規則（versioning scheme）。
        - 增加其他待辦任務項目。
    3. views/navbar.hjs → views/partials/navbar.hjs。
        - 將 navbar.hjs 檔案移動到 partials 資料夾中。
    4. views/map.hjs → views/partials/map.hjs。
        - 將 map.hjs 檔案移動到 partials 資料夾中。
    5. 修改 express/index.js。
        - 更新 根路由，修改地圖 partials 的路徑。
    6. 修改 express/package.json。
        - 更新 版本號為 0.26.0201 (0: 開發中，1: 正式版)。
    7. 修改 express/public/js/mcp.js。
        - 實作比較地圖功能控制項。
            - 支援比較圖層的日期選擇。
            - 支援比較圖層的透明度調整。
            - 完成比較資料集的相關互動邏輯。
    8. 修改 express/public/prompt.txt。
        - 更新文件內容。
        - 新增比較資料集（comparison datasets）專用的 intent 欄位說明。
        - 補充相關提示詞與使用方式描述。

# 2026/01/30 王朝威
    1. 修改 express/views/map.hjs。
        - 新增 對比地圖控制面板與控制按鈕的 HTML 結構。
            - 新增 行政區選擇的下拉選單（縣市、鄉鎮市區、村里）。
            - 新增 行政區重置按鈕。
    2. 修改 express/public/js/modules/compare.js。
        - 實作 行政區（縣市、鄉鎮市區、村里）選擇與重置控制。
        - 實作 對應的 UI 元件（下拉選單、重置按鈕）與事件處理邏輯。
        - 整合呼叫 districts.js 提供的共用初始化函式。
        - 改善對比地圖的非同步處理邏輯。
        - 實作 請求取消機制：在移除對比圖層時，呼叫 cancelLoading 以中止未完成的 WFS 請求。
    3. 修改 express/public/js/modules/districts.js。
        - 重構 行政區模組，將原本分散在 map.js 與 compare.js 中的重複選單事件綁定邏輯移除。
        - 新增 共用函式 initDistrictControls，統一處理行政區選擇器與重置邏輯。
        - 支援多個地圖實例（包含對比地圖）與獨立圖層管理。
        - 集中管理縣市、鄉鎮市區、村里三層選擇器，提升程式碼可維護性與一致性。
    4. 修改 express/public/js/modules/layers.js。
        - 更新 WFS 查詢邏輯：當選擇非臺北市的縣市時，顯示警告並自動切回臺北市。
        - 新增 WFS 請求取消機制：導入 AbortController 實作進行中請求的取消功能。
        - 實作 cancelLoading 函式，當圖層被移除或更新時，主動中斷舊有的資料請求，避免不必要的網路資源消耗並提升介面回應速度。
    5. 修改 express/public/js/map.js。
        - 更新 行政區初始化流程，改用 districts.js 提供的共用 initDistrictControls 函式。
        - 移除 原本重複的行政區選擇與重置邏輯。
        - 實作 請求取消機制：在移除圖層時，呼叫 cancelLoading 以中止未完成的 WFS 請求。

# 2026/01/29 王朝威
    1. 修改 introduction/一、架構簡介.txt。
        - 修改 架構圖，更新 Nginx、ExpressJS、GeoServer、PgAdmin 之間的關係。
        - 新增 詳細的路由說明與資料庫連線說明。
    2. 修改 introduction/二、目錄結構.txt。
        - 更新 express/public/，加入匯出 PDF 所需資源、字型資源、MCP 工具的前端程式碼、載入動畫資源、給 LLM 使用 MCP 工具的提示詞、模組化程式碼等說明。
        - 更新 nginx/ssl/，加入自簽憑證相關檔案說明。
        - 更新 postgis/tables/，加入建立行政區域邊界資料表、建立 2025 年 ASC 點位資料表、建立 2025 年 DES 點位資料表、建立正規化函式、建立檢視表等說明。
    3. 新增 express/public/js/modules/compare.js。
        - 實作 地圖對比功能模組，包含對比地圖的初始化、銷毀、同步視角等功能。
        - 實作 createCompareBasemaps 與 createCompareOverlays 函式，根據 config.js 配置動態生成對比地圖圖層。
        - 實作 refreshCompareWFSForOverlay 函式，調用 Layers.refreshWFSForOverlay 共用刷新邏輯。
        - 實作 syncMainToCompare 與 syncCompareToMain 函式，實現主地圖與對比地圖的雙向同步。
        - 實作 initCompareMap 函式，初始化對比地圖並同步主地圖的底圖、疊加圖層、透明度、日期選擇等狀態。
        - 實作 destroyCompareMap 函式，銷毀對比地圖並重置所有相關狀態。
        - 實作 toggleCompareMode 函式，切換對比模式的開啟與關閉。
        - 實作 initCompareControls 函式，初始化對比地圖的事件監聽（底圖切換、疊加層切換、日期選單變更、透明度滑桿）。
        - 新增 compareLoadingController 物件，封裝對比地圖的 loading 控制方法。
        - 新增 compareFilters 常數，固定對比地圖的篩選條件為臺北市。
    4. 修改 express/public/js/map.js。
        - 修正 controlPanel 變數在 closeButton 之前被引用導致的 ReferenceError。
        - 新增 引入 Compare 模組並初始化對比地圖控制功能。
    5. 修改 express/public/js/modules/ui.js。
        - 新增 createLoadingController 工廠函數，使用閉包管理 loading 計數，避免重複顯示/隱藏問題。
        - 新增 mapLoadingController 與 compareMapLoadingController 兩個獨立的 loading 控制器。
        - 新增 showCompareMapLoading 與 hideCompareMapLoading 函式，用於對比地圖的載入動畫。
        - 修改 updateScalePosition 函式，在響應式設計（≤768px 垂直排列）時將比例尺移至對比地圖。
    6. 修改 express/public/js/modules/layers.js。
        - 修改 loadDateOptions 函式，新增 options 參數（configSource、loadingController），支援對比地圖重複使用。
        - 修改 fetchPointsWFS 函式，新增 options 參數（mapInstance、pkField），支援指定不同地圖實例。
        - 修改 refreshWFSForOverlay 函式，新增 options 參數（configSource、mapInstance、loadingController、getFilters），實現主地圖與對比地圖共用刷新邏輯。
        - 移除 loadWFSPoints 函式，將邏輯整合至 refreshWFSForOverlay 中。
    7. 修改 express/public/js/modules/config.js。
        - 新增 basemapConfigs 與 overlayConfigs 配置物件，用於動態生成底圖與疊加圖層。
        - 新增 createLayerFromConfig 函式，根據配置物件建立 Leaflet 圖層。
    8. 修改 express/views/map.hjs。
        - 新增 對比地圖容器結構（compare-map-container）。
        - 新增 對比地圖控制面板與控制按鈕（compare-map-controls、compare-control-toggles）。
        - 新增 對比地圖載入動畫元件（compare-map-loading）。
        - 新增 對比地圖底圖選擇與疊加圖層選項的 HTML 結構。
    9. 修改 express/public/css/map.css。
        - 新增 對比地圖容器與控制面板樣式。
        - 新增 對比模式下的地圖排列樣式（水平與垂直響應式）。
        - 新增 對比地圖載入動畫樣式。
        - 新增 對比按鈕的 active 狀態樣式。

# 2026/01/28 王朝威
    1. 修改 express/public/chart/ 資料夾名稱為 express/public/chartjs。
    2. 修改 express/views/map.hjs。
        - 修改 引入 Chart.js 的路徑。
        - 新增 引入 jspdf、jspdf-autotable、html2canvas 的路徑。
    3. 修改 express/Dockerfile。
        - 修改 基底映像為 node:24-trixie 以支援較新的套件。
    4. 修改 nginx/default.conf。
        - 修改 新增 client_max_body_size 指令，設定客戶端請求主體最大尺寸為 50MB。
            - 避免上傳圖片或大量資料時出現 413 Payload Too Large 錯誤。
    5. 修改 express/index.js。
        - 設定請求本體大小限制，增加限制以支援大型檔案上傳 (如 Base64 圖片)，避免出現 413 Payload Too Large 錯誤。
            - 使用 express.json({ limit: '50mb' }) 與 express.urlencoded({ extended: true, limit: '50mb' })。
    6. 新增 express/public/export2pdf/ 目錄。
        - 新增 jspdf.umd.min.js。
        - 新增 jspdf.plugin.autotable.min.js。
        - 新增 html2canvas.min.js。
    7. 新增 express/public/fonts/ 目錄。
        - 新增 思源黑體字型目錄 Noto-Sans-TC/。
        - 新增 Noto Sans TC 中文字體支援模組 noto-sans-tc-font.js。
    8. 修改 express/public/js/modules/charts.js。
        - 修改 exportPDF 函式。
            - 新增 autoTable 參數設定，以避免表格內容過多時超出頁面範圍。
            - 新增 font 參數設定，使用 Noto Sans TC 字體以支援中文顯示。
    9. 修改 express/public/css/map.css。
        - 新增 全螢幕載入遮罩樣式。
    10. 修改 express/public/js/ui.js。
        - 新增 showFullScreenLoader 與 hideFullScreenLoader 函式，用於顯示與隱藏全螢幕載入遮罩。
    11. 修改 compose.yaml。
        - 修改 當伺服器電腦啟動時，容器可以自動啟動。

# 2026/01/24 王朝威
    1. 修改 nginx/default.conf。
        - 移除 GeoServer 預設的 Content-Security-Policy (CSP)。
        - 避免因為 form-action 限制導致無法登入 (例如: form-action 'self')。
        - 在代理請求至 GeoServer 時，加入 X-Forwarded-Host 與 X-Forwarded-Port 標頭。
        - 加入 proxy_redirect 指令，將 GeoServer 回傳的 http:// 重新導向為 https://。
    2. 修改 geoserver/data_dir/security/csp_default.xml。
        - 修改 CSP 規則，加入 form-action 允許的來源 http://yo.ct.ntust.edu.tw。
    3. 修改 geoserver/data_dir/security/csp.xml。
        - 修改 CSP 規則，加入 form-action 允許的來源 http://yo.ct.ntust.edu.tw。
    4. 修改 geoserver/data_dir/global.xml。
        - 啟用使用 Headers 中的 Proxy URL。
        - 設定 Proxy Base URL 為 https://yo.ct.ntust.edu.tw/geoserver/。
    5. 修改 compose.yaml。
        - 新增 GEOSERVER_CSRF_DISABLED、wicket.configuration、wicket.csp.enabled 三個環境變數，禁用 CSRF 保護與 CSP。

# 2026/01/22 王朝威
    1. 修改 express/views/map.hjs。
        - 修改 引入 map.js 的 type 屬性為 module。
    2. 修改 express/public/js/map.js。
        - 重構 將 map.js 改為模組化。
            - 將原本的程式碼拆分成多個模組檔案，並使用 import/export 來管理依賴關係。
            - 調整 全域變數的使用方式，改為透過模組匯出與匯入來共享資料。
    3. 新增 express/public/js/modules/config.js。
        - 實作 地圖配置模組，包含底圖、疊加圖層、WFS 點位圖層的定義與初始化邏輯。
    4. 新增 express/public/js/modules/ui.js。
        - 實作 使用者介面模組，包含比例尺、主題切換、定位控制等 UI 元件的初始化與更新邏輯。
    5. 新增 express/public/js/modules/layers.js。
        - 實作 圖層模組，包含 WMS/WMTS 底圖圖層與 WFS 點位圖層的建立與管理邏輯。
    6. 新增 express/public/js/modules/districts.js。
        - 實作 行政區模組，包含縣市、鄉鎮市區、村里選單的初始化與更新邏輯。
    7. 新增 express/public/js/modules/charts.js。
        - 實作 圖表模組，包含時間序列圖的繪製與匯出功能。

# 2026/01/21 王朝威
    1. 修改 express/public/js/mcp.js。
        - 實作 setLayerOpacity 函式，根據使用者輸入的透明度值，設定對應圖層的透明度。
            - 支援 TileLayer (WMS/WMTS) 與 WFS GeoJSON 點位圖層的即時透明度調整。
        - 新增 使用顯示地圖載入提示與隱藏地圖載入提示的函式。
    2. 修改 express/public/prompt.txt。
        - 新增 opacity 欄位說明，包含定義、允許值範圍。
        - 新增 JSON Schema 中的 opacity 欄位。
        - 新增 透明度調整範例。
    3. 修改 express/views/map.hjs。
        - 修改 自動建立 icon 物件的程式碼：
            - 紅色的 icon 大小設定為 20x20。
            - 綠色的 icon 大小設定為 5x5。
            - 藍色的 icon 大小設定為 20x20。
            - 其餘的顏色 icon 大小則自動根據顏色等級線性插值計算。
    4. 修改 express/public/css/map.css。
        - 修改 地圖載入指示器色彩，改為使用 color-theme.css 中定義的 CSS 變數。
        - 修改 地圖載入指示器色彩，加入 color 屬性，讓文字顏色能夠隨著亮/暗主題改變。
    5. 修改 express/public/css/color-theme.css。
        - 新增 地圖載入指示器色彩的 CSS 變數，包含亮色模式與暗色模式的定義。
    6. 修改 express/public/js/map.js。
        - 修改 將顯示地圖載入提示與隱藏地圖載入提示作為變數暴露給全域變數，供 mcp.js 使用。

# 2026/01/20 王朝威
    1. 修改 express/views/map.hjs。
        - 新增 jspdf 與 html2canvas 套件引用。
        - 修改 Modal footer 結構，支援匯出功能按鈕群組。
    2. 修改 express/public/js/map.js。
        - 修改 loadPointFeatures 函式，在 Modal footer 加入「匯出」按鈕群組(PDF、PNG、JPG)，並加入 Bootstrap Icon。
        - 實作 exportImage 函式，支援將圖表匯出為 PNG/JPG 圖片。
        - 實作 exportPDF 函式，產生包含標題、屬性表格、位置示意圖、位移折線圖的 PDF 報表。
            - 設定 PDF 字體為「標楷體」(KaiTi)。
            - 調整版面配置，將屬性表格與位置示意圖並排顯示。
            - 實作 獨立的位置示意圖生成邏輯，建立暫存地圖容器，只顯示目標點位，並設定為正方形視圖。

# 2026/01/19 王朝威
    1. 修改 express/index.js。
        - 修改 加入讀取 prompt.txt 的處理邏輯。
            - 使用 path.join 來組合檔案路徑，確保跨平台相容性。
            - 使用 fs.promises.readFile 來非同步讀取檔案內容。
            - 加入錯誤處理，捕捉讀取檔案時可能發生的錯誤，並回傳 500 狀態碼與錯誤訊息給前端。
    2. 新增 express/public/prompt.txt。
        - 實作 MCP 使用的提示詞(prompt)，包含 JSON 格式規範、可用欄位與定義、JSON 架構範例等說明文件。
    3. 修改 express/views/map.hjs。
        - 修改 註解 點位資訊 -> 圖徵資訊。
        - 修改 預設 Modal footer 按鈕前方加入 Bootstrap 圖示。
    4. 修改 express/public/js/map.js
        - 移除 判斷是否有 Modal footer 的條件式。
        - 修改 Modal footer 按鈕文字 其他資料 -> 詳細資料。
        - 修改 Modal footer 按鈕前方加入 Bootstrap 圖示。
    5. 修改 express/public/js/mcp.js。
        - 修改 selectBasemap 與 selectOverlay 函式，加入判斷避免重複點擊。
        - 加入 詳細的註解說明。

# 2026/01/17 王朝威
    1. 修改 express/index.js。
        - 新增 MCP API 中呼叫 Ollama API 的錯誤處理邏輯。
            - 將 try-catch 包覆整個 fetch 請求，確保所有錯誤都能被捕捉並處理。
            - 在 catch 區塊中，記錄錯誤訊息並回傳 500 狀態碼與錯誤訊息給前端。

# 2026/01/16 王朝威
    1. 修改 express/public/js/map.js。
        - 修正 buildPropertyTable 函式，避免顯示不必要的欄位。
        - 修正 showFeatureModal 函式中 Modal footer 的按鈕樣式與功能。
            - 將關閉按鈕樣式從 primary 改為 danger。
            - 修改 Modal 內容由 JavaScript 動態生成。
                - 新增 展開點位其他資料 按鈕。
                - 隱藏 除位移外的其他資料。
        - 修改 updateOverlayVisibility 函式名稱，改為 updateOverlayAvailability。
        - 修正 updateOverlayAvailability 函式中底圖與疊加圖層互斥邏輯，改為禁用 overlay 選項而非隱藏。
    2. 修改 express/views/map.hjs。
        - 修改 Modal footer 的按鈕樣式與功能。
            - 將關閉按鈕樣式從 primary 改為 danger。
            - 修改 Modal 內容由 JavaScript 動態生成。
                - 新增 展開點位其他資料 按鈕。
                - 隱藏 除位移外的其他資料。
            - 新增 Modal 中 loading 動畫樣式，使用 loading.io 提供的 CSS 動畫。
        - 修改 資料控制面板 中的 重置 按鈕樣式與文字。
            - 將按鈕樣式改為 btn btn-outline-danger btn-sm w-100 mt-2。
            - 新增 按鈕文字「重置」。
        - 新增 地圖中 loading 動畫樣式，使用 loading.io 提供的 CSS 動畫。
    3. 修改 express/public/css/map.css。
        - 新增 Modal 中 loading 動畫的樣式。
        - 新增 地圖中 loading 動畫的樣式。
    4. 修改 express/views/layout.hjs。
        - 新增 Loading.io 動畫的樣式引用。
    5. 建立 Loading.io 元件(component) 。
        - 新增 express/public/loadingio/loadingio.html。
        - 新增 express/public/loadingio/loadingio.css。
        - 新增 express/public/loadingio/loadingio.js。
        - 實作 loading-io 元件，支援 type 屬性來選擇不同的動畫樣式。

# 2026/01/15 王朝威
    1. 修改 express/views/navbar.hjs。
        - 修正 導覽列三個按鈕的連結，將絕對路徑改為相對路徑。
    2. 修改 introduction/script.js。
        - 修正 導覽列六個按鈕的連結，將絕對路徑改為相對路徑。
    3. 修改 express/public/js/map.js。
        - 移除 註解掉的程式碼。
    4. 新增 express/public/js/暫時用不到/old_map.js。
        - 新增 將移除掉的程式碼搬移至此，以備未來參考。
    5. 修改 express/index.js。
        - 新增 API `/api/mcp`，處理使用者搜尋意圖，目前實作簡易關鍵字分析。
        - 修改 根路由，傳遞 CSRF Token。
    6. 修改 express/views/layout.hjs。
        - 新增 meta 標籤 `csrf-token`。
    7. 修改 express/public/js/mcp.js。
        - 新增 搜尋欄位事件監聽，串接後端 MCP API。
        - 修正 `performSearch` 避免遞迴觸發。

# 2026/01/14 王朝威
    1. 新增 express/public/js/mcp.js。
        - 修正 MapActions 參考錯誤與執行環境問題。
        - 實作 MCP 智慧日期選擇邏輯 (selectBestDate)，支援部份日期格式 ('YYYY', 'YYYY-MM') 並自動選擇最新日期。
        - 新增 行政區選擇的序列動畫效果 (縣市 -> 鄉鎮 -> 村里)，加入延遲以優化視覺體驗。
        - 擴充 MCP 支援功能，包含底圖切換、縮放、主題切換等通用控制。
        - 重構程式碼，優化重複邏輯 (DRY)。
    2. 修改 express/views/map.hjs。
        - 更新 圖層疊加 (Overlay) 區塊版面配置。
        - 新增 「雷達衛星影像」與「16向陰影圖」圖層選項。
        - 新增 所有疊加圖層的透明度控制滑桿。
    3. 修改 express/public/js/map.js。
        - 新增 「雷達衛星影像」與「16向陰影圖」至底圖與疊加圖層定義。
        - 實作 圖層互斥邏輯：當圖層被選為底圖時，自動隱藏對應的疊加圖層選項。
        - 實作 透明度控制邏輯，支援 TileLayer (WMS/WMTS) 與 WFS GeoJSON 點位圖層的即時透明度調整。
    4. 修改 express/index.js。
        - 修正 取得日期列表 API。
        - 修正 取得位移資料 API。

# 2025/12/14 王朝威
    1. 修改 express/public/js/map.js。
        - 修正 修正 載入日期下拉選單的邏輯。
            - 修正 開啟圖層與關閉圖層時，顯示與隱藏下拉選單時的動畫效果。
            - 修正 讓其他圖層選項跟著下拉選單的動畫一起移動(下移/上移)。
    2. 修改 express/public/css/map.css。
        - 修正 控制面板中 選項下拉選單 的樣式。
            - 修正 選項下拉選單的動畫效果，包含顯示與隱藏的過渡效果，使其他圖層選項跟著下拉選單的動畫一起移動(下移/上移)。
        - 刪除 地圖中部分按鈕使用不到的樣式。

# 2025/12/13 王朝威
    1. 修改 express/public/js/map.js。
        - 修正 載入日期下拉選單的邏輯。
            - 修正 載入日期選項時，移除預設選項，造成使用者誤選後無法正確載入資料的問題。
            - 新增 開啟圖層之後，才顯示日期下拉選單，關閉圖層時隱藏日期下拉選單。
        - 修正 下拉選單切換亮/暗主題的邏輯。
            - 修正 選擇元素從 getElementById 改成 querySelector，以符合新增的 class 屬性。
    2. 修改 express/views/map.hjs。
        - 修正 位移時間序列下拉選單的 HTML 結構。
        - 新增 下拉選單的 class 屬性 control-item-options，方便在 JS 中操作。
    3. 修改 express/public/css/map.css。
        - 修正 控制面板中 選項下拉選單 的樣式。
            - 調整選項下拉選單的寬度與對齊方式，確保在不同解析度下都能正常顯示。

# 2025/12/12 王朝威
    1. 修改 express/index.js。
        - 新增 取得日期列表的 API。
            - 根據圖層名稱，從資料庫取得該圖層的所有日期資料，並回傳給前端。
        - 新增 取得位移資料的 API。
            - 根據圖層名稱與點位 ogc_fid，從資料庫取得該點位的位移資料陣列，並回傳給前端。
    2. 修改 express/public/js/map.js。
        - 新增 載入日期下拉選單的邏輯。
            - 根據圖層名稱，從資料庫取得該圖層的所有日期資料，載入對應的日期選項。
        - 新增 獲取位移資料的邏輯。
            - 根據圖層名稱與點位 ogc_fid，從資料庫取得該點位的位移資料陣列。
        - 修正 顯示點位詳細資訊 Modal 的邏輯。
            - 刪除 extractTimeSeriesData 函式，改為直接在顯示 Modal 時呼叫獲取位移資料的函式。
            - 修正 buildPropertyTable 函式，將部分不需要顯示的欄位過濾掉。
            - 修正 drawTimeSeriesChart 函式，將繪製圖表的邏輯改為使用獲取到的位移資料陣列。
        - 修正 點擊/拖曳/滑鼠滾輪時會觸發地圖點擊事件的問題。
        - 修正 點位顏色等級的判斷邏輯。
            - 等級 0：紅色(red)             ，       displacement <= -48
            - 等級 1：橙色(orange)          ，-48 <  displacement <= -24
            - 等級 2：黃色(yellow)          ，-24 <  displacement <= -12
            - 等級 3：黃綠色(chartreuse)    ，-12 <  displacement <= -6
            - 等級 4：綠色(green)           ，- 6 <  displacement <   6
            - 等級 5：青綠色(tiffany)       ，  6 <= displacement <   12
            - 等級 6：青色(cyan)            ， 12 <= displacement <   24
            - 等級 7：蔚藍色(azure)         ， 24 <= displacement <   48
            - 等級 8：藍色(blue)            ， 48 <= displacement
    3. 修改 express/views/map.hjs。
        - 新增 位移時間序列下拉選單的 HTML 結構。
    4. 資料庫點位資料正規化完成。
        - 資料表名稱：
            - asc_2025                  主要點位資料
            - asc_2025_date             日期資料
            - asc_2025_displacement     位移資料
            - des_2025                  主要點位資料
            - des_2025_date             日期資料
            - des_2025_displacement     位移資料
            - county_1140318
            - town_1140318
            - village_1140620
        - 檢視表名稱：
            - view_asc
            - view_asc_displacement
            - view_des
            - view_des_displacement
            - view_town
            - view_village
    5. GeoServer 重新整理從 PostGIS 讀取的資料。
        - 重新命名並整理 asc、des 兩個圖層，確保 GeoServer 能正確讀取資料庫中的點位資料。

# 2025/12/02 王朝威
    1. 修改 express/public/js/map.js。
        - 修正 添加 WFS 圖層的邏輯。
            - 添加 wfsPointConfigs 陣列，包含要添加的 WFS 圖層的配置。
                - 使用迴圈遍歷 wfsPointConfigs 陣列，動態添加每個 WFS 圖層。
            - 將添加行政區邊界的邏輯與添加點位圖層的邏輯分開，避免混淆。
            - 將點位分成 5 個等級，根據 velocity 欄位的值來決定點位的顏色。
                - 等級 1：綠色
                - 等級 2：黃綠色
                - 等級 3：黃色
                - 等級 4：橙色
                - 等級 5：紅色
            - 根據地圖的縮放等級，動態調整點位的多寡。
                - 以 3 為底，19 減去縮放等級次方，作為降採樣的基準。
                - 當主鍵 ID % 降採樣基準等於 1 時，顯示該點位。
        - 修正 點擊點位後顯示詳細資訊的邏輯。
            - 將攏長的函式拆分成多個小函式，提升可讀性與維護性。
            - 將部分重複的 HTML 內容放置到模板檔案中。
        - 修正 更改亮/暗主題的邏輯
            - 使用 root.dark 與 root.light 來設定亮/暗主題的 CSS 變數。
            - 確保在切換主題時，表格與下拉選單的樣式也會跟著改變。
    2. 修改 express/views/map.hjs。
        - 將點位詳細資訊的 HTML 內容放置到模板檔案中。
        - 修改 點位詳細資訊的樣式，確保在亮/暗主題下都能正常顯示。
    3. 修改 express/public/css/map.css。
        - 新增 點位詳細資訊(表格)的樣式，確保在亮/暗主題下都能正常顯示。
        - 修改 紀錄亮暗主題的方法，從 @media (prefers-color-scheme) 改成使用 root.dark 與 root.light。
    4. 將點位與行政區邊界資料從 GeoPackage 轉成 PostGIS。

# 2025/11/17 王朝威
    1. 利用 QGIS 編輯圖資。
        - 修正 16向陰影圖 的座標系統，將座標系統名稱與參數修改為 EPSG:3826 (TWD97 / TM2 zone 121)。
            - 將 16向陰影圖 匯出為 GeoTIFF 格式，並命名為 TWD97_MULTI-HS_D16_H35-002-001.tif。
        - 將點位資料輸出為 PostGIS 可匯入的 SQL 檔案。
            - 將 asc2025vd_slpunit_neg.gpkg 輸出為 asc2025vd_slpunit_neg.sql。
            - 將 des2025vd_slpunit_neg.gpkg 輸出為 des2025vd_slpunit_neg.sql。
    2. 修改 express/public/js/map.js。
        - 修正 16向陰影圖 底圖。
            - 使用 TWD97_MULTI-HS_D16_H35-002-001.tif 作為 16向陰影圖 底圖。
    3. 加入資料至 PostGIS。
        - 使用 psql 指令將 asc2025vd_slpunit_neg.sql 匯入至 PostGIS 資料庫中。
        - 使用 psql 指令將 des2025vd_slpunit_neg.sql 匯入至 PostGIS 資料庫中。
        - 建立 「直轄市、縣(市)」、「鄉(鎮、市、區)」、「村(里)」 三個資料表(id, code, name)。

# 2025/11/11 王朝威
    1. 修改 express/public/js/map.js。
        - 新增 雷達衛星影像 底圖。
        - 新增 16向陰影圖 底圖。(未完成)
        - 移除 便利商店(超商) 圖層。
    2. 修改 express/views/map.hjs。
        - 新增 雷達衛星影像 底圖 選項。
        - 新增 16向陰影圖 底圖 選項。
        - 移除 便利商店(超商) 圖層 選項。

# 2025/10/29 王朝威
    1. 新增 資料夾 nginx/ssl/，用於存放 SSL 證書與私鑰。
        - parameter.txt (包含產生自簽名證書所需的參數)
        - server.crt
        - server.csr
        - server.key
    2. 修改 compose.yaml。
        - 將 Nginx 的 443 連接埠映射到主機的 443 連接埠，80 連接埠映射到主機的 80 連接埠。
        - 將 Nginx 的配置文件和 SSL 證書掛載到容器中。
        - 修正部分註解錯誤。

# 2025/10/22 王朝威
    1. 放棄使用 Git LFS 管理大型檔案。
        - 刪除 .gitattributes 中的設定。
        - 移除 Git LFS 的追蹤設定。

# 2025/10/21 王朝威
    1. 建立 leaflet 地圖標記圖示。
        - leaflet\images\point-marker-icon.png
        - leaflet\images\point-marker-icon-2x.png
    2. 修改 public/js/map.js。
        - 修改點位在地圖上的樣式。
            - 修改 顯示點位的方法，從 Leaflet CircleMarker 改成使用 Leaflet Marker 來顯示點位。
            - 使用 Leaflet Icon 來自定義點位的圖示。
        - 修改函式名稱。
            - 將 fetchWFSPoints 改成 fetchWFS。
    3. 修改 express/views/map.hjs。
        - 增加 全臺839子集水區範圍圖 的圖層控制選項。
        - 修改 重置按鈕，增加按鈕文字「重置」。
    4. 修改 public/css/map.css。
        - 修改重置按鈕的樣式，增加按鈕寬度，讓文字不會換行。

# 2025/10/15 王朝威
    1. 修改 nginx/default.conf。
        - 新增 IPv6 支援。
        - 新增 代理請求至 pgAdmin 的設定。
            - 將 pgAdmin 的路徑改成 /pgadmin，避免與其他應用程式衝突。
            - 保留 Host 和 X-Forwarded-* header，避免 Wicket 驗證失敗。
            - 加入 X-Script-Name header，讓 pgAdmin 知道它被代理到 /pgadmin 路徑下。
    2. 資料夾名稱(檔案路徑)去除空格、符號、中文，改用英文與底線。
        - 台北市.points                   -> Taipei_City_Points
        - 直轄市、縣（市）界線1140318      -> City_Boundaries_1140318
        - 鄉（鎮、市、區）界線1140318      -> Town_Boundaries_1140318
        - 村（里）界（TWD97經緯度）1140620 -> Village_Boundaries_1140620
        - 衛星影像                        -> Satellite_Imagery
        - 全臺839子集水區範圍圖            -> Taiwan_839_Subset_Watershed_Range_Map
    3. 修改 .gitignore。
        - 將中文路徑改成英文路徑。

# 2025/10/08 王朝威
    1. 修改 .gitignore。
        - 將 geoserver/data_dir/data/ 中的資料夾加入忽略清單，使用全路徑，避免其他相同名稱的資料夾也被忽略。
    2. 修改 compose.yaml。
        - 將 GeoServer 的連接埠改回預設的 8080。
        - 將 Nginx 的連接埠改成 443，與老師提供的伺服器設定一致。
    3. 修改 public/js/map.js。
        - 修正 has been blocked by CORS policy 的問題。
            - 將 fetch 的 URL 改成相對路徑，讓請求經過 Nginx 代理到 GeoServer。

# 2025/10/07 王朝威
    1. 修改 public/js/map.js。
        - 修正 displaySingleDistrict 函式中的問題：
            - 解決選擇行政區後，因為 mouseover 與 mouseout 會重製樣式，導致行政區邊界的圖層會在點位圖層之上，讓點位無法被點擊的問題。
        - 新增 resetDistrictSelections 函式。
            - 點擊重置按鈕，將已選擇的縣市、鄉鎮市區、村里歸零，並移除地圖上的邊界與點位圖層。

# 2025/10/06 王朝威
    1. 修改 public/js/map.js。
        - 修正 fetchDistrictGeometry 函式名稱錯誤的問題。
    2. 修改 docker-compose.yml 檔案名稱與副檔名為 compose.yaml。
        - 採用官方建議的檔案名稱與副檔名。
    3. 啟用 Git 進行版本控制。
        - 初始化 Git 儲存庫。
        - 建立初始提交。
        - 使用 Git LFS 來管理大型檔案。
        - 建立 .gitignore，忽略 .vscode/ 與 data_dir/data/ 中部分資料夾。
    4. 使用 SCP 指令將專案上傳到遠端伺服器。
        - 遠端伺服器：140.118.105.88
        - 連接埠：2224
        - 使用者名稱：m11305502
        - 目的路徑：/home/m11305502/WebGIS/
    5. 使用 SSH 連接到遠端伺服器。
        - 遠端伺服器：140.118.105.88
        - 連接埠：2224
        - 使用者名稱：m11305502

# 2025/10/02 王朝威
    1. 修改 docker-compose.yml。
        - 更新 將已經設定好的 data_dir 綁定進去，避免每次重建容器都要重新設定 GeoServer。

# 2025/10/01 王朝威
    1. 修改 public/js/map.js。
        - 新增 在資料控制中選擇縣市、鄉鎮市區、村里後的邏輯。
            - 將地圖縮放到該區域。
            - 顯示該區域的邊界。
            - 顯示該區域內的點位資料。
            - 修正以下 fetchWFSPoints 函式中的問題：
                - 解決選擇行政區後，BBOX 會無效，導致顯示的點位資料不正確的問題。
            - 修正以下 displaySingleDistrict 函式中的問題：
                - 解決因為選擇行政區後，因為地圖自動縮放而讓網頁再次發送請求到 GeoServer ，導致伺服器負載過高，甚至崩潰。
                - 解決地圖移動後或更改選擇的行政區後，舊的邊界不會被移除，導致地圖上有多個重疊的邊界的問題。
                - 問題：選擇行政區後，行政區邊界的圖層會在點位圖層之上，導致點位無法被點擊。

# 2025/09/26 王朝威
    1. 修改 public/js/map.js。
        - 新增 圖層控制面板中 資料控制的縣市、鄉鎮市區、村里 選單。
            - 地圖初始化時，載入縣市選單。
            - 選擇縣市後，載入該縣市的鄉鎮市區選單。
            - 選擇鄉鎮市區後，載入該鄉鎮市區的村里選單。

# 2025/09/24 王朝威
    1. 修改 public/js/map.js。
        - 修改 將 臺北市主要點位資料 的圖層加入圖層控制面板。

# 2025/09/23 王朝威
    1. 修改 public/js/map.js。
        - 新增 點擊點位標記，使用 Bootstrap Modal 顯示該點位的詳細資訊。
        - 新增 使用 Chart.js 繪製時間序列圖表。

# 2025/09/16 王朝威
    1. 修改 public/js/map.js。
        - 新增 讀取 GeoServer WFS 點位資料的功能。(臺北市主要點位資料)
        - 新增 點擊點位標記，顯示該點位的詳細資訊。
        - 新增 根據縮放級別對點位資料進行抽稀，提升地圖效能。

# 2025/09/03 王朝威
    1. 修改 public/js/map.js。
        - 新增 連接氣象局資料，顯示各縣市的即時氣象資訊。(未完成)
        - 新增 點擊搜尋列表，顯示該區域的資訊。

# 2025/08/28 王朝威
    1. 修改 public/js/map.js。
        - 修正 點擊事件處理邏輯。

# 2025/08/27 王朝威
    1. 修改 public/js/map.js。
        - 新增 點擊搜尋結果中的縣市名稱時，顯示該縣市的邊界。
        - 新增 點擊搜尋結果中的鄉鎮區名稱時，顯示該鄉鎮區的邊界。
        - 新增 點擊搜尋結果中的村里名稱時，顯示該村里的邊界。

# 2025/08/20 王朝威
    1. 修改 public/js/map.js。
        - 新增 GeoServer WFS 圖層的載入功能，從 GeoServer 取得各縣市的 shapefile -> GeoJSON 資料，並在地圖上顯示。

# 2025/08/17 王朝威
    1. 修改 public/js/map.js。
        - 新增 從 GeoServer 取得各縣市的 shapefile 資料，並在地圖上顯示。(目前失敗)
        - 新增 點擊地圖後，從 國土測繪中心 連接 API 取得該點的縣市、鄉鎮市區、村里等資訊，並顯示在地圖上。

# 2025/08/14 王朝威
    1. 新增 geoserver/Dockerfile。
        - 新增中文語系設定。

# 2025/08/13 王朝威
    1. 修改 nginx/default.conf。
        - 修正 Nginx `proxy_pass` 與 header，將 Nginx 配成保留 `Host` 和 `X-Forwarded-*`，避免 Wicket 驗證失敗。
    2. 更新 GeoServer 映像版本。

# 2025/08/12 王朝威
    1. 修改 public/css/map.css。
        - 新增 版權聲明的樣式。
        - 新增 地圖比例尺的樣式。
    2. 修改 public/js/map.js。
        - 新增 地圖點擊事件，顯示點擊位置的經緯度。
        - 新增 標記點擊事件，顯示標記的經緯度。
        - 修正 點擊按鈕與搜尋欄的事件處理，當用戶點擊這些元素時，不會觸發地圖的點擊事件。

# 2025/08/11 王朝威
    1. 修改 靜態資源 public 資料夾結構。
        - 將自定義 CSS 和 JS 檔案分離到獨立的資料夾中。
        - 將 Leaflet 的 CSS 和 JS 檔案與 images 資料夾放入 public/leaflet 資料夾中。
        - 將 Bootstrap 的 CSS 和 JS 檔案與 fonts 資料夾放入 public/bootstrap 資料夾中。
        - 修正 將 誤認為 Bootstrap 的 htmx 的 CSS 和 JS 檔案放入 public/htmx 資料夾中。
    2. 修改 express/views/map.hjs。
        - 新增 地圖控制面板的樣式與功能，包含底圖選擇與圖層疊加選項。
        - 新增 控制面板的切換按鈕與關閉按鈕。
        - 新增 控制面板的收合動畫效果。
        - 修改 將網頁樣式和腳本分離到獨立的 CSS 和 JS 檔案中。
        - 修改 地圖縮放按鈕的樣式與功能，使用 Bootstrap Icons 替代原有的圖示。
        - 修改 主題切換按鈕的樣式與功能，使用 Bootstrap Icons 替代原有的圖示。
    3. 新增 public/css/map.css。
    4. 新增 public/js/map.js。

# 2025/08/01 王朝威
    1. 修改 express/views/map.hjs。
        - 修改 地圖相關功能，將各縣市 GeoJSON 的顏色隨機分配，增加視覺多樣性。
        - 新增 Fisher-Yates 洗牌算法隨機分配顏色的功能。

# 2025/07/30 王朝威
    1. 修改 express/views/layout.hjs。
        - 修改 地圖相關功能，將樣式與功能分離到獨立的 .hjs 檔案中。
    2. 建立 express/views/map.hjs。
        - 新增 地圖相關功能的樣式與功能。
        - 新增 地圖容器的大小調整功能，根據導航欄高度動態調整地圖容器位置和大小。
        - 新增 地圖比例尺的顯示功能。
        - 新增 地圖圖層(各縣市 GeoJSON)的載入功能。
        - 新增 地圖圖層(各縣市 GeoJSON)的點擊事件，顯示縣市名稱。
    3. 修改 express/index.js。
        - 修改 根路由，新增地圖相關功能的 partials。

# 2025/07/25 王朝威
    1. 修改 express/views/layout.hjs。
        - 修改 導航欄(頁首)，將樣式與功能分離到獨立的 .hjs 檔案中。
    2. 建立 express/public/color-theme.css。
        - 新增 亮/暗主題的色彩變數。
    3. 建立 express/public/style.css。
        - 新增 亮/暗主題切換功能按鈕樣式。
    4. 建立 express/public/script.js。
        - 新增 亮/暗主題切換功能。
    5. 建立 express/views/navbar.hjs。
        - 新增 導航欄(頁首)的樣式與功能(按鈕連結)。
        - 修改 導航欄(頁首)的漢堡按鈕樣式(亮/暗主題)。

# 2025/07/24 王朝威
    1. 修改 express/views/layout.hjs，修改地圖相關功能。
        - 新增 國土測繪中心 WMTS 底圖，EPSG:3857 的載入。
        - 新增 國土測繪中心 WMTS 底圖，TWD97 的載入(無法使用)。
        - 新增 國土測繪中心 WMS 層的載入。
    2. 修改 introduction/index.html，修改靜態網頁功能。
        - 新增 `WMTS 與 WMS 圖層設定`的內容。
        - 新增 `WMTS 與 WMS 圖層設定`的連結。
    3. 建立 introduction/三、WMTS使用範例.txt。
    4. 建立 introduction/四、WMS使用範例.txt。

# 2025/07/20 王朝威
    1. 修改 leaflet 目錄名稱為 introduction。
    1. 建立 introduction/style.css。
    2. 建立 introduction/script.js。
    3. 修改 introduction/index.html，修改靜態網頁功能。
        - 將網頁樣式和腳本分離到獨立的 .css 和 .js 檔案中。
        - 修改 .css 與 .js 的內容，將顏色修改為 css 變數，實現亮/暗主題切換功能。
        - 修改 網頁內容，加入`開發日誌`的連結。
        - 修改 網頁內容與 .js，修正導航連結，將原本的靜態網頁功能改為動態載入。
    4. 修改 introduction/一、架構簡介.txt。
    5. 修改 introduction/二、目錄結構.txt。
    6. 修改 nginx/default.conf，修改 Nginx 配置。
        - 設定 Nginx 的字元集為 UTF-8，以確保文本檔案以 UTF-8 提供。
    7. 建立 註記.md。

# 2025/07/19 王朝威
    1. 建立 leaflet/一、架構簡介.txt。
    2. 建立 leaflet/二、目錄結構.txt。
    3. 修改 leaflet/index.html，修改靜態網頁功能。
        - 修改 網頁樣式。
        - 修改 網頁腳本。
        - 修改 網頁內容。
        - 將`架構簡介`和`目錄結構`的內容分離到獨立的 .txt 檔案中，並嵌入到網頁中。

# 2025/07/18 王朝威
    1. 修改 leaflet/index.html，建立靜態網頁功能。
        - 新增 網頁樣式。
        - 新增 網頁腳本。
        - 新增 網頁內容。

# 2025/07/17 王朝威
    1. 建立 express/views/layout.hjs。
        - 新增 一個基本的 HTML 模板，包含頁首、頁尾和內容區域。
        - 使用 hjs 模板引擎來渲染網頁。
        - 新增 地圖相關功能。
    2. 修改 nginx/default.conf，修正對 Express 應用程式的代理設定。
    3. 修改 express/package.json，加入 Express 套件依賴。
        - 新增 @dr.pogodin/csurf 套件。
        - 新增 dotenv 套件。
        - 新增 express-sanitizer 套件。
        - 新增 express-session 套件。
        - 新增 hjs 套件。
    4. 修改 express/index.js，加入 Express 套件的載入。
        - 新增 @dr.pogodin/csurf 的載入。
        - 新增 dotenv 的載入。
        - 新增 express-sanitizer 的載入。
        - 新增 express-session 的載入。
        - 新增 hjs 的載入。
    5. 修改 express/index.js，定義根路由。
        - 當訪問 `/` 時，會渲染 `layout` 模板。
    6. 修改 leaflet/index.html，更改靜態網頁功能。
        - 刪除 地圖相關功能。
        - 更改為本專案的簡介頁面。

# 2025/07/14 王朝威
    1. 修改 express/Dockerfile，加入安裝套件的指令。
    2. 修改 express/package.json，加入 Express 套件依賴。
        - 新增 leaflet 套件。
        - 新增 pg 套件。
        - 新增 sequelize 套件。
    3. 修改 express/index.js，加入 Express 套件的載入。
        - 新增 leaflet 的載入。
        - 新增 pg 的載入。
        - 新增 sequelize 的載入。

# 2025/07/10 王朝威
    1. 修改 nginx/default.conf，修正 Nginx 配置。
    2. 修改 express/index.js，定義一個簡單的測試用問候路由。

# 2025/07/09 王朝威
    1. 建立 docker-compose.yml。
    2. 建立 Nginx 配置文件 nginx/default.conf。
    3. 建立 Express 建立檔案 express/Dockerfile。
    4. 建立 Express 套件依賴 express/package.json。
    5. 建立 Express 應用程式 express/index.js。
    6. 建立 靜態網頁 leaflet/index.html。
    7. 建立 README.md。

# 參考資料
    - Leaflet 官方文件：https://leafletjs.com/reference.html
    - Leaflet 非官方教學（1）：https://www.letswrite.tw/leaflet-osm-basic/
    - Leaflet 非官方教學（2）：https://www.letswrite.tw/leaflet-osm-locate/
    - Leaflet 非官方教學（3）：https://www.letswrite.tw/leaflet-plugins/
    - OpenStreetMap 官方網站：https://www.openstreetmap.org/
    - OpenStreetMap Wiki：https://wiki.openstreetmap.org/wiki/Main_Page
    - Bootstrap 官方網站：https://getbootstrap.com/
    - Bootstrap Icons：https://icons.getbootstrap.com/
    - Bootstrap 中文文件：https://bootstrap5.hexschool.com/
    - htmx 官方網站：https://htmx.org/
    - htmx 官方文件：https://htmx.org/docs/
    - GeoServer 官方網站：https://geoserver.org/
    - GeoServer 文檔：https://docs.geoserver.org/stable/en/user/
    - PostGIS 官方網站：https://postgis.net/
    - PostGIS 文檔：https://postgis.net/documentation/
    - Sequelize 官方網站：https://sequelize.org/
    - Sequelize 文檔：https://sequelize.org/docs/v6/
    - Node.js 官方網站：https://nodejs.org/
    - Node.js 文檔：https://nodejs.org/en/docs/
    - Express 官方網站：https://expressjs.com/
    - Express 文檔：https://expressjs.com/en/4x/api.html
    - Docker 官方網站：https://www.docker.com/
    - Docker 文檔：https://docs.docker.com/
    - Docker Compose 官方網站：https://docs.docker.com/compose/
    
    - 國土測繪中心介接服務說明：https://maps.nlsc.gov.tw/S09SOA/homePage.action?Language=ZH#tab-3
    - 台灣行政區劃資料下載（直轄市、縣（市）界線1140318）：https://data.gov.tw/dataset/7442
    - 台灣行政區劃資料下載（鄉（鎮、市、區）界線1140318）：https://data.gov.tw/dataset/7441
    - 台灣行政區劃資料下載（村（里）界（TWD97經緯度）1140620）：https://data.gov.tw/dataset/7438