Skip to content

VocPass/ios

Repository files navigation

VocPass

高職通用校務查詢系統

Platform Swift iOS License

此為 HansHans135/shin-her 的原生 App 版本,與 Claude Code 協作開發


✨ 功能特色

功能 說明
📅 課表查詢 查看每週課表,支援離線快取,無需每次重新載入
📊 成績查詢 第一、二學期及學年成績,各科目一覽無遺
🕐 缺曠統計 自動統計曠課、事假、病假、公假,即時掌握距 1/3 門檻狀況
獎懲記錄 功過明細、核定日期、銷過狀態完整呈現
🏝️ Dynamic Island 課表即時活動顯示,當前與下一節課盡在靈動島
🔐 驗證碼自動辨識 使用 Vision OCR 自動辨識登入驗證碼,免除手動輸入

📱 支援平台

  • iOS / iPadOS >= 17.0
  • macOS >= 11.0(Apple Silicon Only)

🏫 支援學校

學校擴充支援請至 Server 查看。


🛠️ 技術棧

  • SwiftUI — 全 UI 框架
  • ActivityKit + WidgetKit — Dynamic Island / 鎖定螢幕小工具
  • Vision — 驗證碼 OCR 辨識
  • WKWebView — 學校系統登入與資料擷取
  • UserDefaults — 本地快取與帳號記憶

🚀 安裝

從 Xcode 建置

  1. Clone 此 repo
git clone https://github.com/HansHans135/VocPass.git
  1. 以 Xcode 開啟 VocPass.xcodeproj
  2. 選擇目標裝置並執行(⌘ + R)

需 Xcode 15+ 及 Apple Developer 帳號(免費帳號限安裝於個人裝置)


🤝 貢獻

歡迎提交 Issue 或 PR!

  • 新增學校支援:前往 Server 貢獻
  • 功能建議:開 Issue 討論
  • Bug 回報:請附上裝置型號、iOS 版本與重現步驟

📄 授權

本專案採用 GPL 3.0 License 授權。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages