Appearance
功能一覽
下表列出目前所有功能。「版本」欄是功能首次出現的版本；之後的調整記在版本歷史。
使用者看得到的功能
| 功能 | 說明 | 誰能用 | 在哪裡 | 版本 |
|---|---|---|---|---|
| 首頁 | 顯示服務名稱與目前項目總數（快取 5 分鐘） | 所有人 | / | v0.1.0 |
| 項目列表 | 每頁 25 筆、顯示總數、上一頁／下一頁；無效頁碼自動修正 | 所有人（唯讀） | /items | v0.1.0 |
| 新增項目 | 視窗內填標題（最多 200 字）與內容（最多 5000 字） | 已登入；啟用通行碼時可免登入 | /items | v0.1.0 |
| 編輯／刪除項目 | 視窗內編輯；刪除前會確認，並一併刪除附件檔案 | 已登入 | /items | v0.1.0 |
| 附件上傳 | PNG／JPEG／WebP／PDF／TXT，最大 5 MB | 已登入 | 項目列的「附件」 | v0.1.0 |
| 附件下載 | 經網站轉送，未登入會先導向登入 | 已登入 | 附件標籤 | v0.1.0 |
| Google 登入 | 以 Google 帳號登入，驗證 Email 已確認 | 允許名單內的帳號 | /login | v0.1.0 |
| 管理頁 | 使用者清單、項目總數 | 管理員 | /admin | v0.1.0 |
| 元件展示 | 按鈕、表單、表格、視窗等元件範例 | 所有人 | /ui | v0.1.0 |
| 深色模式 | 跟隨系統設定 | 所有人 | 全站 | v0.1.0 |
| 列印版面 | 無導覽列的 A4 版面（供憑證、報表類頁面使用） | 所有人 | 列印時 | v0.1.0 |
| 每日摘要信 | 每天寄項目數量給管理員，失敗自動重試 | 管理員收信 | 正式環境排程 | v0.1.0 |
| 健康檢查 | 回報資料庫連線與部署版本 | 所有人 | /health | v0.1.0 |
安全與保護（使用者不必操作，但會感受到）
- 登入封閉預設：沒設定允許名單時，任何人都無法登入；不是任何 Google 帳號都能改資料。
- 操作頻率限制：同一個來源短時間內送出太多寫入會被暫時擋下。
- 安全標頭：禁止被嵌入其他網站、禁止猜測檔案類型。
- 輸入一律轉義：標題與內容裡的
<script>之類文字只會被當成文字顯示。 - 登入只能回到本站：登入後的導回網址只接受本站路徑。
開發者額外取得的能力
這些不會出現在網站上，但是範本的賣點：資料庫版本控管與危險遷移檢查、dev／stg／prd 三環境一鍵部署與回滾、完整的 AI 代理（agent）工具組、可升級的完整 SaaS 版本（profiles/full-saas）。細節見程式庫的 docs/。