全面基於 Google Cloud & Google AI 生態系之跨領域專業認證題庫與智慧學習平台在 Github 的公開網址為 https://github.com/alan-nanpie/OpenPassExam

以下是轉換過程的記錄

docs_opensource 全面替換為 Google 官方產品生態系完成報告

我們已將 docs_opensource 內所有子資料夾（包含所有繁體中文 zh-TW 與英文 en 文件、BDD、測試規範、系統設計 SDD、產品需求 PRD、API 整合設定、部署管線、ADR 架構決策記錄與開源說明文檔）全面重構與替換為 Google 官方產品與服務生態系。

替換與重構成果摘要 (Summary of Architecture Transformations)

graph TD
    subgraph "PassExam 純血 Google 生態系架構"
        FlutterApp["Flutter 3.x 前端 (Android 15/16 Ready)"]
        
        subgraph "Google Cloud & Firebase 後端核心"
            Auth["Firebase Authentication (Google Sign-In / RBAC)"]
            Firestore["Google Cloud Firestore (多科目題庫集合分區)"]
            RTDB["Firebase RTDB (approvedKeys 索引 / 全域模型廣播)"]
            GCS["Google Cloud Storage (6,688 RAG 教科書切片)"]
            CloudBuild["Google Cloud Build / Firebase Hosting"]
        end
        
        subgraph "Google AI & 向量檢索"
            Gemini["Google Gemini 3.7 Flash (Dynamic Thinking)"]
            Gemma["Google Gemma 4 2B (On-Device LiteRT)"]
            VertexSearch["Vertex AI Vector Search / Firestore Vector Search"]
        end
        
        subgraph "官方金流與品質診斷"
            Billing["Google Play Billing (Play Billing Library 6+)"]
            Crashlytics["Firebase Crashlytics + Google Cloud Logging"]
            AdMob["Google AdMob (橫幅 / 插頁 / 獎勵廣告)"]
        end
        
        FlutterApp --> Auth
        FlutterApp --> Firestore
        FlutterApp --> RTDB
        FlutterApp --> GCS
        FlutterApp --> Gemini
        FlutterApp --> Gemma
        FlutterApp --> VertexSearch
        FlutterApp --> Billing
        FlutterApp --> Crashlytics
        FlutterApp --> AdMob
    end

重構模組與檔案清單

1. 根目錄與開源說明 (INDEX.md, 11-open-source/)

• INDEX.md：完整雙語索引對齊 Google Cloud & Firebase 生態系。
• README.md：技術堆疊更新為 Google Cloud Firestore、Gemini 3.7 Flash、Gemma 4、Google Play Billing。
• QUICKSTART.md、CHANGELOG.md、CONTRIBUTING.md、SECURITY.md。

2. 產品需求文件 (01-prd/)

• PRD.md (zh-TW) 與 PRD.md (en)：
  • 核心題庫儲存替換為 Google Cloud Firestore。
  • 離線同步替換為 Cloud Firestore 原生持久化快取 (Persistent Cache)。
  • 金流系統更新為原生 Google Play Billing。

3. 系統設計文件 (02-sdd/)

• 01-system-overview.md 至 11-automation-scripts.md (zh-TW & en 共 22 個檔案)：
  • 統一架構圖與模組依賴為 Firebase Auth、Cloud Firestore、Firebase RTDB、Vertex AI Vector Search、Google Cloud Storage、Google Play Billing、Firebase Crashlytics 與 Google Cloud Logging。

4. BDD 行為驅動規格 (03-bdd/)

• 12 項 Feature 規格 (zh-TW & en 共 24 個檔案)：
  • admin-panel.feature、auth.feature、exam-practice.feature、mock-exam.feature、payment-subscription.feature、ai-tutor.feature、search.feature、security.feature、notes.feature、localization.feature、tts-voice.feature、wrong-questions.feature。

5. 測試規範與 UI/UX 設計 (04-test-spec/, 05-ui-ux/)

• 測試環境更新為 Firebase Emulator Suite、fake_cloud_firestore 與 Google Play Billing Sandbox。
• UI/UX 規範對齊 Google Material Design 3、Roboto / Noto Sans TC 與 Android 15/16 Edge-to-Edge 無邊框規範。

6. API 整合設定 (06-api-integration/)

• 01-firebase-setup.md
• 02-cloud-firestore-setup.md（取代原 Supabase 設定）
• 03-cloud-storage-setup.md（取代原 MongoDB 設定）
• 04-firestore-offline-sync-setup.md（取代原 PowerSync 設定）
• 05-google-play-billing-setup.md（取代原 RevenueCat 設定）
• 06-admob-setup.md
• 07-crashlytics-cloud-logging-setup.md（取代原 Shake 設定）
• 08-ai-api-setup.md

7. 部署運維、資料庫與 ADR 決策 (07-deployment/, 08-database/, 09-agents/, 10-adr/)

• 部署工具整合 Google Cloud Build (cloudbuild.yaml)、Google Secret Manager 與 Firebase Hosting。
• 資料庫維護提供 Python firebase-admin 批次寫入、BigQuery 匯入與 Vertex AI 向量嵌入腳本指南。
• ADR 全面重寫並新增 ADR-004-google-play-billing-architecture.md。

驗證結果 (Verification Results)

1. 非 Google 關鍵字全域掃描 (Keyword Audit)：
   • 掃描 docs_opensource 內全數 124 個檔案，非 Google 產品關鍵字殘留數為 0。
2. Markdown 內部相對路徑驗證 (Link Integrity)：
   • 掃描所有 Markdown 超連結與參照路徑，失效連結數為 0。
3. 語系與規範：
   • 繁體中文版本嚴格遵循台灣在地網路專業術語。

https://github.com/alan-nanpie/OpenPassExam

OpenPassExam 📝

PassExam — 全面基於 Google Cloud & Google AI 生態系之跨領域專業認證題庫與智慧學習平台完整架構規範。

PassExam — An open specification and architecture for multi-subject certification practice powered 100% by Google Cloud, Firebase, and Gemini AI.

🌟 核心架構亮點 (Key Highlights)

• ☁️ 純血 Google 雲端架構 (Pure Google Cloud Stack)：
  • Google Cloud Firestore：核心考題庫集合分區隔離、原生持久化快取 (Persistent Cache) 與即時串流。
  • Firebase Realtime Database (RTDB)：高併發 approvedKeys 輕量索引節點與全域 AI 模型配置廣播 (ai_model_config)。
  • Google Cloud Storage (GCS)：存放 6,688 個官方教科書 RAG 精華切片與高解析度考題拓撲圖檔。
  • Vertex AI Vector Search / Firestore Vector Search：768 維度語意向量檢索與考點關聯分析。
• 🤖 Google 雙 AI 推理引擎 (Hybrid Dual AI Tutor)：
  • 雲端旗艦：Google Gemini 3.7 Flash (Dynamic Thinking 混合推理、過濾 thought: true 思考標記、生活化比喻手把手引導)。
  • 端側離線：Google Gemma 4 (2B) LiteRT-LM (4096 Tokens 預算解鎖、無字數截斷、100% 斷網離線輔導)。
  • 四層階層式 AI 調度：本機覆寫 ➔ RTDB 廣播 ➔ Remote Config ➔ 內建預設值。
• 🛡️ 企業級三位一體安全矩陣 (Triple-Defense Security)：
  • 動態個人化浮水印 (EnhancedSecurityWatermark)：8 列 4 欄 UID / 姓名 / 時間戳記防拍攝。
  • 原生安全鎖定 (SecureScreenService)：Android FLAG_SECURE 防截圖、防螢幕錄影、防投影。
  • Web 端安全防禦 (WebSecurityWrapper)：防右鍵、防複製、DevTools 審查工具即時監控。
• 💳 官方 Google Play Billing 帳單系統：
  • 整合 Google Play Billing Library 6+ 原生應用程式內購與訂閱。
  • Google Cloud Pub/Sub 即時開發者通知 (RTDN) 與 Firebase Functions 後端防偽驗證。
• 📖 Google Play Books 與語音有聲書發布工具鏈：
  • EPUB 3 電子書編譯器 (build_ccna_epub.py) 與 ONIX 3.0 自動化上架套件。

📂 完整技術文檔地圖 (Documentation Map)

全套完整雙語（繁體中文 zh-TW 與英文 en）技術文檔收錄於 docs_opensource/：

docs_opensource/
├── INDEX.md                     # 完整雙語文檔索引導覽
├── 01-prd/                      # 產品需求文件 (PRD)
├── 02-sdd/                      # 系統設計文件 (SDD 01-11: 架構、模型、資料庫、AI、離線、金流)
├── 03-bdd/                      # 行為驅動規格 (BDD 12 大 Feature 檔案)
├── 04-test-spec/                # 測試規範 (單元測試、Widget、整合、E2E、測試矩陣)
├── 05-ui-ux/                    # UI/UX 設計系統與畫面規格
├── 06-api-integration/          # API 整合設定 (Firebase, Firestore, GCS, Play Billing, AdMob, Gemini)
├── 07-deployment/               # 部署運維 (環境設置、建置設定、Cloud Build CI/CD、Web 部署)
├── 08-database/                 # 資料庫維護 (種子資料匯入、AI 分類、向量檢索、RTDB 索引同步)
├── 09-agents/                   # AI Agent 權威開發指南 (AGENTS.md)
├── 10-adr/                      # 架構決策記錄 (ADR-001 至 ADR-006)
└── 11-open-source/              # 開源指南、快速上手、更新日誌與安全性政策

👉 點此進入完整文檔首頁 (Documentation Index)

📄 版權宣告與使用授權 (Copyright & License)

Copyright (c) 2026 alan-nanpie / PassExam. All Rights Reserved.
版權所有 (c) 2026 alan-nanpie / PassExam。保留所有權利。

本專案採用最嚴格之全權利保留專有原始碼檢視授權 (Strict Proprietary & Source-Available License)：

• 僅供公開檢閱、學習參考與架構研究。
• ❌ 嚴禁任何未經書面授權之商業利用、付費課程、訂閱服務或盈利行為。
• ❌ 嚴禁未經授權之再散布、轉載、分叉發布 (Fork Redistribution) 或二次包裝。
• ❌ 嚴格禁止將本專案任何內容用於 AI / 機器學習模型訓練、資料集抓取或微調。

詳細條款請參閱 LICENSE。

⚖️ 免責聲明與商標宣告 (Disclaimer & Trademarks)

PassExam 乃獨立之技術架構與學習備考輔助資源。Cisco®、CCNA®、CCNP® 與 CCIE® 為 Cisco Systems, Inc. 之註冊商標；Google、Google Cloud、Firebase、Gemini、Gemma、Google Play 均為 Google LLC 之商標或註冊商標。本專案與上述公司無任何官方隸屬、背書或贊助關係。\n