15 天期限計算 + 倉頡碼查詢 —— 專為行政辦公打造的模組化、全離線單檔 PWA WebApp。
- 合規計算:發出當日不計入,由翌日起算;第 15 天若遇星期六、日或澳門公眾假期/補假日/豁免上班日,自動順延至首個正常工作天。
- 日曆視覺化:按月清晰標記「發出」、「第 1–14 天」、「15 天期限」、「順延明細」與「本期涉及假期」。
- 雙軌假期資料:優先線上讀取澳門政府公眾假期 iCal;離線或載入失敗時無縫降級至內建資料(已覆蓋 2026–2027 年)。
- 跨年防護:超出已知假期年份範圍時即時提示,避免誤判。
- 字庫齊全:內建超過 75,000 字繁簡倉頡碼與 4,000+ 組繁簡字對照,閒時延遲建索引不阻塞開啟。
- 字根拆解:一字一卡,同時呈現繁體主碼、字根與對應簡體字碼。
- 零摩擦操作:點擊卡片一鍵複製倉頡碼;支援一鍵繁簡轉換。
- 完全離線:單檔自包含 HTML 搭配 Service Worker 預快取,斷網照常開啟。
- 零隱私追蹤:100% 本地運算,無 Cookie、無第三方腳本、無分析追蹤。
- 設計規格鎖定:嚴守
docs/設計規格.md(暖紙底#faf6ee、紙白卡片#fffdf8、墨字#2e2a24、水藍點綴#1e9ab8、淺色鎖定、嚴格字階)。
- GitHub Pages:https://windowmmk.github.io/admin-tools/
├── 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 部署
直接以瀏覽器開啟 dist/work-tools/index.html,或啟動本機靜態伺服器:
python3 -m http.server 8080 -d dist/work-tools修改 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 與桌面版截圖作視覺自檢重構後的架構支援零摩擦新增任意數量的工具頁籤:
- 在
src/tools/<tool-id>/新增 4 個檔案:tool.json、view.html、style.css、logic.js。 - 如需靜態資料檔,放入
src/data/並在tool.json的data欄位宣告即可由構建器自動注入。 - 在
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 校驗線上檔案與本地構建包逐字節一致。
- 本地運算:所有日期計算與倉頡查碼完全於使用者裝置本機執行,絕不傳送輸入文字至遠端伺服器。
- 零追蹤:無 Cookie、無分析埋點、無外部腳本或樣式表引用。
- 縱深防禦:全站無
eval()/new Function(),所有使用者輸入與外部 iCal 資料均經顯式 HTML 轉義。
本專案採用 MIT License 開源授權。