版本歷史

Kamika Group 網站更新記錄

v1.9.0

2026-01-31 最新版本

Data Checker 介面優化 + 搜尋記錄功能

介面改進

  • Data Checker 電郵驗證區塊優化
    • 將訂閱通知文字移到「發送驗證碼」按鈕下方
    • 訂閱通知文字改為灰色 (#888)，降低視覺干擾
    • 改善整體表單排版同視覺層次

後端功能

  • ICCID 搜尋記錄系統
    • querySim Cloud Function 新增搜尋記錄功能
    • 記錄內容：ICCID、電郵、時間戳記、SIM 狀態、方案數量、來源、IP 地址
    • 儲存到 Firestore search_logs collection
  • 跨專案資料同步
    • 新增 syncSearchLogs Firestore trigger function
    • 自動將搜尋記錄同步到 Dashboard 專案
    • 透過 Eventarc 實現即時同步

技術細節

  • 更新全部 7 個語言版本嘅 datachecker.astro
  • querySim 同 syncSearchLogs 部署到 asia-east1
  • 配置跨專案 IAM 權限以存取 Firestore

v1.8.0

2026-01-30

Embed Data Checker 狀態顯示優化 + Alt SIM Card 支援

新功能

  • Embed Data Checker 新狀態邏輯
    • SIM 卡資訊（Master Status）
      • Activated + 無數據使用（所有計劃 usedUnit = 0）→ Active Ready（橙色）
      • Activated + 有數據使用（任何計劃 usedUnit > 0）→ 已啟用（綠色）
      • 未啟用 → 原本狀態（原本顏色）
    • 服務計劃狀態
      • Active (planCondition=1) + activateStart 為空 → Active Ready（橙色）
      • Active (planCondition=1) + activateStart 有值 → 啟用（綠色）
      • activateEnd 已過期 → 已結束（紅色）
      • Not active (planCondition≠1) → 停用（紅色）
  • Alt SIM Card Embed 版本（/embed/alt/）
    • 獨立 Alt SIM Card 數據查詢器
    • 只顯示 simcardbrand = "altsim" 嘅計劃
    • 同 B4travel embed 相同嘅 UI 設計

改進

  • 服務計劃區塊重新設計
    • 由舊版 plan-card 格式改為 sim-info-card 格式
    • 同 SIM 卡資訊區塊統一外觀設計
    • 深藍色漸變背景 + 白色文字
  • 修復 Astro Scoped CSS 問題
    • 動態生成嘅 HTML 無法套用 scoped CSS
    • 改用 <style is:global> 解決

安全性

  • CSP frame-ancestors 更新
    • 新增 https://altsimcard.shop
    • 新增 https://www.altesim.com
    • 允許喺以上網站 embed iframe

技術細節

  • b4travel.astro 同 alt.astro 同步更新
  • 使用 <style is:global> 取代 <style> 確保動態 CSS 生效
  • 服務計劃模板使用 sim-info-card、sim-info-header、sim-info-grid 類別

v1.7.1

2026-01-30

POS 機小屏幕優化 + 掃描器精簡化

改進

  • POS 機小屏幕優化（360x592dp）
    • Modal 視窗縮小至 290px 寬度（原 320px）
    • 預覽區域高度縮小至 180px（原 200px）
    • 標題列精簡化：字體 14px，padding 8px
    • 適合低解像度 POS 機螢幕顯示
  • 掃描器配置精簡化
    • 條碼格式限定為 CODE_128（提升掃描速度）
    • 掃描框調整為 250x100（平衡識別率與速度）
    • FPS 降至 10（減少處理負擔）
    • 移除 experimentalFeatures 和 aspectRatio（提升兼容性）
  • 移除放大滑桿（Zoom Bar）
    • 簡化 UI，減少用戶操作
    • 保留自動 1.5x 放大功能
    • 移除相關 JavaScript 代碼（減少 JS 體積）

修復

  • 修復移除 Zoom Bar 後相機無法啟動問題
    • 移除 JavaScript 中對已刪除 HTML 元素的引用
    • 修復 zoom-slider 和 zoom-value 元素 null 錯誤
  • 修復 CSS transform 導致的黑屏問題
    • 改用直接尺寸縮小代替 CSS transform: scale()

技術細節

  • 7 個語言版本同步更新
  • 移除未使用的 CSS 樣式（#zoom-slider 相關）
  • Video 元素設置 height: auto !important 確保正確顯示

v1.7.0

2026-01-30

條碼掃描器大更新

新功能

  • 條碼掃描器改為彈出式 Modal 視窗
    • 更現代化的 UI 設計
    • 支援點擊背景或 ✕ 按鈕關閉
    • 淡入淡出動畫效果
    • 置中顯示，不會遮擋其他內容

修復

  • 修復條碼掃描器黑屏問題
    • 新增 350ms 延遲等待 Modal 動畫完成
    • 調整掃描框為 280x120（更適合手機屏幕）
    • 新增 aspectRatio: 1.5 配置確保視頻比例正確
    • 改善錯誤訊息顯示（區分權限問題 / 設備未找到）

改進

  • 擴展條碼格式支援
    • 新增 CODE_93, CODABAR, ITF, UPC_A, UPC_E
    • 原有支援: CODE_128, CODE_39, QR_CODE, EAN_13, EAN_8
  • 相機啟動時顯示「正在啟動相機...」提示

技術細節

  • 使用 Html5QrcodeSupportedFormats 常量（取代數字代碼）
  • 新增 config 物件統一管理掃描器配置
  • 改善錯誤處理，提供更具體的錯誤訊息

v1.6.0

2026-01-30

Google Cloud Vision OCR + 安全性強化

新功能

  • Google Cloud Vision OCR 圖片識別
    • 取代 Tesseract.js 前端 OCR
    • 更準確、更快速的 ICCID 識別
    • 伺服器端處理，減少瀏覽器負擔
  • GCP 安全性強化
    • Firestore 刪除保護 (Delete Protection)
    • Firestore PITR 7 天 Point-in-Time Recovery
    • Storage 公開存取防護 (PAP Enforced)

改進

  • Barcode 掃描器優化
    • 掃描區域加寬至 400x150（原 300x150）
    • FPS 提升至 25（原 10），掃描更快速
  • Email 驗證緩存延長至 24 小時
    • 驗證成功後 24 小時內無需再次驗證
    • 原本為 20 分鐘
  • Email 驗證碼模板美化
    • 使用網站主色調（金色 #f4b647）
    • 加入 Kamika Group Logo
  • 網站 Footer 優化
    • 加入 Logo 顯示
    • Footer 背景改為主色調
    • 加入版本號顯示
  • 修復 "正在查詢中..." 錯誤顯示問題

Cloud Functions

  • 新增 ocrImage - Google Vision OCR API

v1.5.0

2025-01-29

PWA 支援 + Brevo CRM 整合

新功能

  • PWA 支援 - 可安裝到手機主螢幕
    • manifest.json 配置
    • Service Worker 離線緩存
    • 自定義 PWA 圖標
  • Brevo CRM 整合
    • Email 驗證成功後自動訂閱
    • 加入 "Kamikagroup" 通知列表
  • 訂閱通知提示
    • 所有語言版本加入訂閱提示文字
  • Email 模板美化
    • 漸變色標題設計
    • 專業 HTML 排版

改進

  • 前端顯示訂閱 Kamika Group 通知提示

v1.4.0

2025-01-29

Email 驗證系統

新功能

  • Datachecker 3 步驟 UI 流程
    • Step 1: 輸入 Email → 發送驗證碼
    • Step 2: 輸入 6 位數驗證碼
    • Step 3: 輸入 ICCID → 查詢
  • Email 驗證系統
    • Brevo Transactional Email 發送驗證碼
    • 15 分鐘驗證碼有效期
    • 60 秒重發冷卻時間
  • 20 分鐘驗證緩存
    • 避免用戶重複驗證
    • 每次驗證最多 15 次查詢
  • reCAPTCHA v3 保護
    • 防止機器人濫用

Cloud Functions

  • sendCode - 發送驗證碼
  • verifyCode - 驗證驗證碼

v1.3.0

2025-01-28

多語言支援

新功能

  • 7 種語言支援
    • 繁體中文 (zh-hk)
    • 英文 (en)
    • 日文 (ja)
    • 韓文 (ko)
    • 法文 (fr)
    • 荷蘭文 (nl)
    • 西班牙文 (es)
  • 語言切換下拉選單
  • URL 路徑語言識別 (例如 /zh-hk/datachecker)

v1.2.0

2025-01-27

多服務計劃支援

新功能

  • 多服務計劃卡片顯示
  • 支援一個 ICCID 綁定多個數據計劃
  • 顯示每個計劃的用量、有效期

v1.1.0

2025-01-26

ICCID 掃描功能

新功能

  • ICCID 掃描功能
    • 相機即時掃描
    • 圖片上傳識別
  • 數據用量圖表顯示
  • 計劃詳情展示

v1.0.0

2025-01-25

初始版本

功能

  • 網站基礎架構
  • 首頁、關於我們、服務、聯絡頁面
  • Data Checker 基本查詢功能
  • Firebase Hosting 部署
  • GitHub Actions 自動部署