學籍資料檢索系統

學校有三種學籍系統....=.=

1. Canofile 學籍系統年代已久遠，只能在 Windows 7 下使用
2. 到大中後的全誼系統即將停止學校這邊的服務
3. 思騰的系統，正常使用中（希望撐久一點）

前兩項因為學校無法編列相關的經費，一直以來就是呈現苟延殘喘的狀態。
都已經是 2026 年！ＡＩ這麼盛行的情況下，完成一份完整有序的檔案來使用應該不難。

於是誕生了和 AI 合作重新撰寫簡易的查詢系統版本，有興趣的同仁也可以和我討論／洽詢。

兩種版本，有各自的適用範圍，共同點就是使用後要點右上角的關閉系統

校內適用範圍：

(一) Canofile 民國73年-92年間的檔案
(二) 全誼111學年度以前的檔案

...........至於112學年度之後就靠服役中的思騰了，本月額度已用光XD

★★學籍查詢系統(73-92)使用說明

一、系統需求

作業系統：Windows 10 / 11
EXE 版：不需安裝任何軟體
網頁版：需安裝 Python 3.8+ 及相關套件

【EXE】版（StudentRecordSystem.exe）

首次設定

1. 將 StudentRecordSystem.exe 放在「雲端-學籍資料37-92」資料夾中
2. 確保資料夾內有 DATA/高中/國中/ 這三個子資料夾
3. 雙擊執行 StudentRecordSystem.exe

執行流程

- 若 students.db 不存在 → 自動從 DATA/ 的 DBF 檔建立資料庫（約 1~3 分鐘）
- 若 students.db 已存在 → 直接啟動
- 自動開啟瀏覽器連到 http://localhost:8001
- 關閉命令提示字元視窗即可停止系統

注意事項

- EXE 首次執行可能被防毒軟體誤判，請加入例外清單

【網頁版】（Python 原始碼）

首次設定

1. 安裝 Python 3.8 以上（https://python.org）
2. 開啟命令提示字元，切換到系統資料夾：

cd "雲端-學籍資料37-92"

3. 執行啟動腳本：

RunService.bat

腳本會自動安裝所需套件（fastapi、uvicorn、dbfread、Pillow 等）

4. 瀏覽器會自動開啟 http://localhost:8001

重建資料庫

刪除 students.db 後重新啟動系統即可。

---

【登入與操作】

資料搜尋：輸入姓名、身分證字號或出生日期查詢
資料檢查：檢視各學年度的資料完整性（缺身分證字號、缺掃描影像）
詳細資訊：點擊任一筆記錄可查看完整資料與掃描影像
列印：在詳細視窗點擊「列印學籍資料」

---

【檔案結構】

雲端-學籍資料37-92/
├── StudentRecordSystem.exe   ← EXE 版（自行複製）
├── app.py                     ← 網頁應用主程式
├── extract_db.py              ← 資料庫建立程式
├── run.py                     ← EXE 版進入點
├── RunService.bat             ← 網頁版啟動腳本
├── students.db                ← SQLite 資料庫（自動產生）
├── DATA/                      ← DBF 原始資料檔
│   └── 00/                    ← 各 Cabinet 學生資料
├── 高中/                      ← 高中掃描影像（47~56 年度）
├── 國中/                      ← 國中掃描影像（37~92 年度）
├── static/                    ← 靜態檔案（校徽圖片）
├── templates/                 ← 網頁樣板
│   ├── login.html             ← 登入頁面
│   ├── index.html             ← 主頁面（搜尋+檢查）
│   └── print.html             ← 列印頁面
└── 使用說明.md                ← 本文件

---

【常見問題】

Q：執行 EXE 後出現「Windows Defender 已防止執行」？
A：這是誤判。請至 Windows 安全性 → 病毒與威脅防護 → 排除項目，將 EXE 加入排除清單。

Q：如何更新資料？
A：刪除 students.db 後重新啟動系統，會自動從 DATA/ 重建。

下載連結

★★學籍查詢系統(98-111)使用說明

1️⃣ 放入檔案

把學生的 PDF 或 MHTML 檔，放到系統資料夾裡即可。
👉 例如：和執行檔案放在同一個資料夾。

2️⃣ 啟動系統

直接雙擊執行檔案。
第一次需要建立學生資料的json檔案，會比較久，並非沒反應。
✅ 畫面顯示 Server started on http://localhost:8080，就代表成功了。

3️⃣ 開啟網頁使用

打開瀏覽器（建議 Chrome 或 Edge），在網址列輸入：

http://localhost:8080

進入後就可以：

• 🔍 搜尋學生姓名、學號、身分證字號
• 📄 查看資料
• 📤 匯出資料

4️⃣ 換電腦也能直接用：

1. 直接把整個系統資料夾複製過去
2. 在新電腦再雙擊執行檔案
3. 不用重新建立快取，系統會自動處理

下載連結