# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: ezBookkeeping
spec:
    description: Lightweight, self-hosted personal finance app with powerful bookkeeping features.
    coverImage: https://raw.githubusercontent.com/wiki/mayswind/ezbookkeeping/img/desktop/en.png
    icon: https://github.com/mayswind/ezbookkeeping/blob/main/public/favicon.png?raw=true
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Domain
          description: Domain to access your ezBookkeeping dashboard
        - key: EBK_SECURITY_SECRET_KEY
          type: STRING
          name: Secret Key
          description: Please enter a random alphanumeric string (at least 32 characters). Required for security.
    tags:
        - Finance
        - Tool
        - Bookkeeping
    readme: "# ezBookkeeping\n\n## Introduction\n**ezBookkeeping** is a lightweight, self-hosted personal finance app with a user-friendly interface and powerful bookkeeping features.  \nDesigned to be resource-efficient and highly scalable, it can run smoothly on devices as small as a Raspberry Pi, or scale up to NAS, MicroServers, and even large cluster environments.  \n\nezBookkeeping offers tailored interfaces for both mobile and desktop devices.  \nWith support for **PWA (Progressive Web Apps)**, you can even add it to your mobile home screen and use it like a native app.  \n\n\U0001F517 **Live Demo:** [ezbookkeeping-demo.mayswind.net](https://ezbookkeeping-demo.mayswind.net)\n\n## Features\n\n### User-Friendly Interface\n- UI optimized for both mobile and desktop  \n- PWA support for native-like mobile experience  \n- Dark mode  \n\n### AI-Powered Features\n- Supports **MCP (Model Context Protocol)** for AI integration  \n\n### Powerful Bookkeeping\n- Two-level accounts and categories  \n- Attach images to transactions  \n- Location tracking with maps  \n- Recurring transactions  \n- Advanced filtering, search, visualization, and analysis  \n\n### Localization & Globalization\n- Multi-language and multi-currency support  \n- Automatic exchange rates  \n- Multi-timezone awareness  \n- Custom formats for dates, numbers, and currencies  \n\n### Security\n- Two-factor authentication (2FA)  \n- Login rate limiting  \n- Application lock (PIN code / WebAuthn)  \n\n### Data Import/Export\n- Supports CSV, OFX, QFX, QIF, IIF, Camt.053, MT940, GnuCash, Firefly III, Beancount, and more  \n\n## Documentation\nFor more details, please refer to the [official documentation](https://ezbookkeeping.mayswind.net/)\n\nIf you need to adjust the [configuration](https://ezbookkeeping.mayswind.net/configuration), you can check the documentation and add or modify environment variables to enable or disable specific features.  "
    services:
        - name: ezBookkeeping
          icon: https://github.com/mayswind/ezbookkeeping/blob/main/public/favicon.png?raw=true
          template: PREBUILT
          spec:
            source:
                image: mayswind/ezbookkeeping:latest
            ports:
                - id: web
                  port: 8080
                  type: HTTP
            volumes:
                - id: data
                  dir: /ezbookkeeping/data
                - id: storage
                  dir: /ezbookkeeping/storage
            env:
                EBK_SECURITY_SECRET_KEY:
                    default: ${EBK_SECURITY_SECRET_KEY}
                EBK_SERVER_DOMAIN:
                    default: ${PUBLIC_DOMAIN}
          domainKey: PUBLIC_DOMAIN
localization:
    zh-TW:
        description: 輕量化、自架的個人記帳應用，擁有直覺介面與強大功能。
        variables:
            - key: PUBLIC_DOMAIN
              type: DOMAIN
              name: 網域
              description: 你想將 ezBookkeeping 綁在哪個網域上？
            - key: EBK_SECURITY_SECRET_KEY
              type: STRING
              name: 安全金鑰
              description: 請輸入隨機英數字字串（至少 32 個字元）。正式環境必填以確保安全性。
        readme: "# ezBookkeeping\n\n## 介紹\n**ezBookkeeping** 是一個輕量化、自架的個人記帳應用程式，介面友善且功能強大。  \n它設計為高效能、可擴展，能流暢運行於 Raspberry Pi 等低資源裝置，也能部署在 NAS、微型伺服器甚至大型叢集環境。  \n\n提供針對手機與桌面最佳化的介面，並支援 **PWA**，可直接安裝在手機主畫面，像原生 App 一樣使用。  \n\n\U0001F517 **線上 Demo：** [ezbookkeeping-demo.mayswind.net](https://ezbookkeeping-demo.mayswind.net)\n\n## 功能特色\n\n### 使用者介面\n- 行動裝置與桌面皆最佳化 UI  \n- 支援 PWA 原生體驗  \n- 深色模式  \n\n### AI 功能\n- 支援 **MCP (Model Context Protocol)** 整合  \n\n### 記帳功能\n- 雙層帳戶與分類  \n- 交易可附加圖片  \n- 地點追蹤與地圖整合  \n- 週期性交易  \n- 進階搜尋、篩選、視覺化與分析  \n\n### 在地化與國際化\n- 多語言、多貨幣支援  \n- 自動匯率更新  \n- 多時區感知  \n- 自訂日期、數字、貨幣格式  \n\n### 安全性\n- 雙重驗證（2FA）  \n- 登入次數限制  \n- 應用程式鎖（PIN 碼 / WebAuthn）  \n\n### 資料匯入/匯出\n- 支援 CSV、OFX、QFX、QIF、IIF、Camt.053、MT940、GnuCash、Firefly III、Beancount 等格式  \n\n## 文件\n更多資訊請參考[官方文件](https://ezbookkeeping.mayswind.net/zh_Hans)\n\n如果在[配置](https://ezbookkeeping.mayswind.net/zh_Hans/configuration)上有需要調整，可以查看文件內容，透過新增或修改環境變數來開啟或關閉相關功能。"