Skip to content

About

專為行政辦公打造的輕量 PWA 工具箱:支援法定 15 天公文期限與節假日順延計算、70,000+ 字全離線繁簡倉頡碼字典。零隱私追蹤、支援離線與添加到主畫面。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

Repository files navigation

行政小工具 (Admin Tools)

License: MIT PWA Ready Platform

15 天期限計算 + 倉頡碼查詢 —— 專為行政辦公打造的模組化、全離線單檔 PWA WebApp。


🌟 功能亮點

1. 📅 15 天期限計算(法定工作日順延)

  • 合規計算:發出當日不計入,由翌日起算;第 15 天若遇星期六、日或澳門公眾假期/補假日/豁免上班日,自動順延至首個正常工作天。
  • 日曆視覺化:按月清晰標記「發出」、「第 1–14 天」、「15 天期限」、「順延明細」與「本期涉及假期」。
  • 雙軌假期資料:優先線上讀取澳門政府公眾假期 iCal;離線或載入失敗時無縫降級至內建資料(已覆蓋 2026–2027 年)。
  • 跨年防護:超出已知假期年份範圍時即時提示,避免誤判。

2. 🔤 倉頡碼字典查詢

  • 字庫齊全:內建超過 75,000 字繁簡倉頡碼與 4,000+ 組繁簡字對照,閒時延遲建索引不阻塞開啟。
  • 字根拆解:一字一卡,同時呈現繁體主碼、字根與對應簡體字碼。
  • 零摩擦操作:點擊卡片一鍵複製倉頡碼;支援一鍵繁簡轉換。

3. 📱 輕量離線 PWA 與質感設計

  • 完全離線:單檔自包含 HTML 搭配 Service Worker 預快取,斷網照常開啟。
  • 零隱私追蹤:100% 本地運算,無 Cookie、無第三方腳本、無分析追蹤。
  • 設計規格鎖定:嚴守 docs/設計規格.md(暖紙底 #faf6ee、紙白卡片 #fffdf8、墨字 #2e2a24、水藍點綴 #1e9ab8、淺色鎖定、嚴格字階)。

🚀 線上預覽


📁 專案目錄結構

├── src/
│   ├── app.json                 # 應用設定、版本號與已啟用工具清單
│   ├── data/                    # 獨立純資料檔(易於更新與版本比對)
│   │   ├── holidays-mo.json     # 澳門公眾假期內建備份表(2026–2027)
│   │   ├── cangjie.txt          # 75,150 字倉頡碼表(逐行儲存)
│   │   └── zh-conv.json         # 繁簡對照表
│   ├── shell/                   # 共用應用外殼(多頁籤路由、橫滑、Toast、離線與版本檢查)
│   │   ├── tokens.css           # 設計規格鎖定色板變數
│   │   ├── shell.css            # 外殼佈局、懸浮導航列與共用元件樣式
│   │   ├── shell.js             # 共用執行期(AdminShell)
│   │   └── template.html        # 單檔 PWA 輸出模板
│   └── tools/                   # 可插拔工具模組(每工具獨立目錄)
│       ├── deadline/            # 15 天期限計算(tool.json / view.html / style.css / logic.js)
│       └── cangjie/             # 倉頡碼查詢(tool.json / view.html / style.css / logic.js)
├── pwa/                         # PWA 清單、Service Worker 模板與正式圖示
├── scripts/
│   ├── build.py                 # 模組化單檔 PWA 構建器(輸出至 dist/work-tools/)
│   ├── make_icon.py             # PWA 圖示生成器
│   ├── publish.sh               # 本地全流程檢查與線上生產環境驗收腳本
│   └── screenshot.py            # 無外部依賴 Chromium CDP 交付截圖自檢腳本
├── tests/
│   ├── helpers.js               # 隔離 DOM Stub 與模組載入器
│   ├── verify.js                # 核心邏輯、設計規格、安全與私隱自動化驗收
│   ├── sweep_deadline.js        # 12 組跨月/跨年/閏年日曆不變量全覆蓋測試
│   └── verify_prod.js           # 線上發佈包與本地構建逐字節一致性驗收
├── dist/work-tools/             # 編譯完成的離線 PWA 套件(可直接以瀏覽器開啟或部署)
├── docs/設計規格.md              # 視覺色彩、圓角、字階與互動定稿規格
└── .github/workflows/deploy.yml # GitHub Actions 自動測試與 Pages 部署

🛠️ 本地開發與測試

1. 本地預覽

直接以瀏覽器開啟 dist/work-tools/index.html,或啟動本機靜態伺服器:

python3 -m http.server 8080 -d dist/work-tools

2. 構建與一鍵驗收

修改 src/ 下任何模組或資料檔後執行:

./scripts/publish.sh --check

或分步執行:

python3 scripts/build.py        # 編譯單檔離線 PWA 至 dist/work-tools/
node tests/verify.js            # 執行邏輯、安全、私隱與設計規格驗收
node tests/sweep_deadline.js    # 執行 12 組日曆邊界全覆蓋測試
python3 scripts/screenshot.py   # 產生手機 2×2 與桌面版截圖作視覺自檢

🧩 擴充新工具模組

重構後的架構支援零摩擦新增任意數量的工具頁籤:

  1. 在 src/tools/<tool-id>/ 新增 4 個檔案:tool.json、view.html、style.css、logic.js。
  2. 如需靜態資料檔,放入 src/data/ 並在 tool.json 的 data 欄位宣告即可由構建器自動注入。
  3. 在 src/app.json 的 tools 陣列加入 "<tool-id>",執行 ./scripts/publish.sh --check 即可自動生成分頁、橫滑手勢與離線單檔。

🚢 部署方式

推送至 main 分支後,GitHub Actions(.github/workflows/deploy.yml)會自動完成構建、執行全部自動化測試,並發佈 dist/work-tools/ 至 GitHub Pages。發佈後可執行 ./scripts/publish.sh 校驗線上檔案與本地構建包逐字節一致。


🔒 隱私與安全

  1. 本地運算:所有日期計算與倉頡查碼完全於使用者裝置本機執行,絕不傳送輸入文字至遠端伺服器。
  2. 零追蹤:無 Cookie、無分析埋點、無外部腳本或樣式表引用。
  3. 縱深防禦:全站無 eval()/new Function(),所有使用者輸入與外部 iCal 資料均經顯式 HTML 轉義。

📄 授權條款

本專案採用 MIT License 開源授權。

About

專為行政辦公打造的輕量 PWA 工具箱:支援法定 15 天公文期限與節假日順延計算、70,000+ 字全離線繁簡倉頡碼字典。零隱私追蹤、支援離線與添加到主畫面。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages