數位發展部公開數位憑證皮夾相關原始碼，期望透過公私協力推動以 OID4VC / OID4VP 為核心的可信賴身份服務。本文件提供專案概況、元件架構與合規事項，並說明各子專案閱讀路徑，協助開發者依循統一標準進行開發與貢獻。
此儲存庫預計包含以下元件，並陸續釋出程式碼：
| 項次 | 元件名稱 | 內容摘要 | 子目錄 / 文件 |
|---|---|---|---|
| 1 | 數位憑證皮夾 Android 持有端應用程式 | 原生 Android 持有端 App，整合持有端 SDK，支援 VC 與 VP。 | APP/moda-digitalwallet-holder-androidapp/README.md |
| 2 | 數位憑證皮夾 iOS 持有端應用程式 | 原生 iOS 持有端 App，整合持有端 SDK，支援 VC 與 VP。 | APP/moda-digitalwallet-holder-iosapp/README.md |
| 3 | Android 持有端 SDK | 金鑰管理、簽章與 NFC 通訊。 | APP/APPSDK/moda-digitalwallet-holder-androidapp-token-sdk/README.md |
| 4 | iOS 持有端 SDK | Secure Enclave 之 DID 金鑰管理。 | APP/APPSDK/moda-digitalwallet-holder-iosapp-token-sdk/README.md |
| 5 | 行動端 App SDK (Flutter) | 已釋出的 APPSDK，可產出 Android AAR / iOS Framework。 | APP/APPSDK/README.md |
| 6 | 數位憑證皮夾核心系統 Parent POM | 提供所有核心模組共用的 Maven Parent 設定、版本治理與品質規則。 | core-system/moda-digitalwallet-parent-pom/README.md |
| 7 | 數位憑證皮夾共用函式庫 | 提供 Actuator 建置資訊輸出與日誌記錄的共用 Spring Boot 套件。 | core-system/moda-digitalwallet-common/README.md |
| 8 | 發行端管理服務 | 部署於發行機關，提供 DID、憑證模板、狀態與對外 API。 | core-system/twdiw-issuer-api/README.md |
| 9 | 發行端前端管理介面 | 部署於發行機關，憑證發行之視覺化管理介面。 | core-system/twdiw-issuer-web/README.md |
| 10 | 驗證端管理服務 | 部署於驗證機關，提供 VP 模板、授權 QR 與驗證結果等 API。 | core-system/twdiw-verifier-api/README.md |
| 11 | 驗證端前端管理介面 | 部署於驗證機關，驗證模組管理之前端介面。 | core-system/twdiw-verifier-web/README.md |
| 12 | 發行端 OID4VCI 服務 | 部署於發行機關，處理 OID4VCI 發卡與驗證流程。 | core-system/twdiw-oid4vci-handler/README.md |
| 13 | 驗證端 OID4VP 服務 | 部署於驗證機關，支援 OID4VP 流程與 Presentation 驗證。 | core-system/twdiw-oid4vp-handler/README.md |
| 14 | 發證機關 VC 服務 | 提供 VC 簽發、狀態清冊、DID 管理等功能。 | core-system/twdiw-vc-handler/README.md |
| 15 | 驗證端 VP 服務 | 驗證 VP/VC 與 SD-JWT，支援選擇性揭露。 | core-system/twdiw-vp-handler/README.md |
| 16 | 共用服務與工具 | 共用函式庫、範例資料與文件。 | 依子目錄說明，例如 Docs/、doctemplate/、SampleCode/ |
各子專案的詳細使用方式請直接閱讀對應目錄下的
README.md。本檔案僅保留高層級資訊與合規指引。
- 建置符合國際標準的行動憑證載具，支援 OID4VC、OID4VP 與 DID 等規範。
- 協助開發者擴充介面與驗證流程，滿足不同應用情境需求。
- 以 MIT License 授權，讓政府及民間單位可在合規前提下延伸或再利用。
- 安全機制：強化憑證保護、金鑰管理與雙向驗證，對應政府信任架構。
- 國際相容：遵循主要開放標準，提升跨國互通能力。
- 治理文件完備：搭配
CONTRIBUTING.md、CODE_OF_CONDUCT.md等文件，確保協作流程透明。
.
├── APP/ # 行動端資源（持有端 App、APPSDK 內含各 SDK）
│ ├── moda-digitalwallet-holder-androidapp/ # Android 持有端 App
│ ├── moda-digitalwallet-holder-iosapp/ # iOS 持有端 App
│ └── APPSDK/ # 行動端 SDK（Flutter APPSDK、Android／iOS 持有端 SDK 等）
│ ├── … # Flutter APPSDK 主體與編譯指引（詳見 `APPSDK/README.md`）
│ ├── moda-digitalwallet-holder-androidapp-token-sdk/ # Android 持有端 SDK
│ └── moda-digitalwallet-holder-iosapp-token-sdk/ # iOS 持有端 SDK
├── Docs/ # 技術文件與架構說明
├── SampleCode/ # 對應文件所引用的程式範例
├── core-system/ # 核心系統模組（Parent POM、共用函式庫與各服務）
│ ├── moda-digitalwallet-parent-pom/ # Maven Parent POM 設定
│ ├── moda-digitalwallet-common/ # Spring Boot 共用函式庫
│ ├── twdiw-issuer-api/ # 發行端管理服務（API）
│ ├── twdiw-issuer-web/ # 發行端前端管理介面
│ ├── twdiw-verifier-api/ # 驗證端管理服務（API）
│ ├── twdiw-verifier-web/ # 驗證端前端管理介面
│ ├── twdiw-oid4vci-handler/ # 發行端 OID4VCI 服務
│ ├── twdiw-oid4vp-handler/ # 驗證端 OID4VP 服務
│ ├── twdiw-vc-handler/ # 發證機關 VC 服務
│ └── twdiw-vp-handler/ # 驗證端 VP 服務
├── .github/ # GitHub Issue / PR 模板（自動套用）
├── images/ # 參考示意圖與素材
├── CONTRIBUTING.md # 貢獻流程
├── CODE_OF_CONDUCT.md # 行為準則
├── CLA.md # 貢獻者授權協議
└── LICENSE.txt # MIT 授權條款
.github/目錄已包含 Issue 模板與 PR 模板，將由 GitHub 自動套用。
- 使用
git clone取得儲存庫程式碼。 - 依需求進入對應子目錄（例如
APP/、APP/APPSDK/、core-system/*），閱讀該資料夾下的README.md，以取得詳細安裝、編譯與部署步驟。 - 執行測試或驗證時，請遵循各子專案提供的測試指令；若有額外測試策略，可於 PR 中一併提出。
- 授權：本專案採用 MIT License，重用或修改時請保留原授權聲明。（
LICENSE.txt） - 行為準則：所有貢獻者應遵守
CODE_OF_CONDUCT.md，共同維護專業與友善環境。 - 貢獻者授權：提交 PR 前請確認已閱讀並同意
CLA.md。 - 提交流程：
- 建立 Issue 討論需求或回報問題。
- Fork 或建立分支，並依子專案指引完成修正與測試。
- 提交 PR，說明修改內容、測試結果與受影響子模組。
- 安全回報：如發現資安問題，請透過私密 Issue 或電子郵件聯繫官方窗口（
service@wallet.gov.tw）。
- 如何掌握 Roadmap？
建議追蹤 GitHub Issue 與 Discussions。若有建議事項，也可提出 Issue 供討論。
- Issue Tracker：請透過 GitHub Issue 回報問題，以利紀錄與追蹤。
- 討論串：如啟用 Discussions，歡迎交流建議或技術議題。
- Email：若含機敏資訊，請以電子郵件聯繫官方窗口（
service@wallet.gov.tw）。