# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: Kimai
spec:
    description: |
        Kimai is a free, open-source time-tracking application. Log working hours for projects and activities, generate reports and invoices, manage teams and customers. Supports multiple users, tagging, export to PDF/CSV, and a REST API.
    coverImage: https://www.kimai.org/images/screenshots/screenshot-dashboard.webp
    icon: https://avatars.githubusercontent.com/u/49702932
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Domain
          description: The domain to access Kimai
    tags:
        - Tool
        - Productivity
    readme: |
        # Kimai

        A self-hosted time-tracking application for freelancers, agencies, and companies. Track working hours per project and activity, manage customers, generate invoices and reports, and control access with role-based permissions.

        ## What You Can Do After Deployment

        1. **Visit your domain** — log in with the admin account you create via the console
        2. **Create customers and projects** — organize your time entries by customer, project, and activity
        3. **Track time** — start/stop timers or manually log hours from the web UI
        4. **Generate reports** — view weekly, monthly, or custom reports; export to PDF, CSV, or Excel
        5. **Manage teams** — invite users, assign roles, and restrict project visibility per team

        ## Key Features

        - Time tracking with start/stop timers and manual entry
        - Customer, project, and activity management
        - Invoicing and export (PDF, CSV, Excel, HTML)
        - Role-based access control (admin, team lead, user)
        - Tagging and color-coded activities
        - REST API for integrations
        - Multi-language support (30+ languages)
        - Plugin system for extensions

        ## First-Time Setup

        After deployment, open a terminal (Zeabur console) and run:

        ```
        /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
        ```

        Replace the email and set your password when prompted.

        ## License

        AGPL-3.0 — [GitHub](https://github.com/kimai/kimai) | [Website](https://www.kimai.org)
    services:
        - name: kimai
          icon: https://avatars.githubusercontent.com/u/49702932
          template: PREBUILT_V2
          spec:
            source:
                image: kimai/kimai2:apache-2.52.0
            ports:
                - id: web
                  port: 8001
                  type: HTTP
            volumes:
                - id: data
                  dir: /opt/kimai/var
            env:
                APP_SECRET:
                    default: ${PASSWORD}
                DATABASE_URL:
                    default: sqlite:///opt/kimai/var/data/kimai.sqlite
                TRUSTED_PROXIES:
                    default: '**'
            healthCheck:
                type: HTTP
                port: web
                http:
                    path: /
          domainKey: PUBLIC_DOMAIN
localization:
    es-ES:
        description: |
            Kimai es una aplicación gratuita de seguimiento de tiempo de código abierto. Registra horas de trabajo por proyecto y actividad, genera informes y facturas, gestiona equipos y clientes. Soporta múltiples usuarios, etiquetas, exportación a PDF/CSV y API REST.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Dominio
              description: El dominio para acceder a Kimai
        readme: |
            # Kimai

            Aplicación autoalojada de seguimiento de tiempo. Registra horas de trabajo por proyecto y actividad, gestiona clientes y genera facturas e informes.

            ## Qué puedes hacer después del despliegue

            1. **Visita tu dominio** — crea una cuenta de administrador desde la consola e inicia sesión
            2. **Crea clientes y proyectos** — organiza registros de tiempo por cliente, proyecto y actividad
            3. **Registra tiempo** — usa temporizadores o registra horas manualmente
            4. **Genera informes** — visualiza informes semanales, mensuales o personalizados; exporta a PDF, CSV o Excel
            5. **Gestiona equipos** — invita usuarios, asigna roles y controla la visibilidad de proyectos por equipo

            ## Configuración inicial

            Después del despliegue, abre una terminal (consola Zeabur) y ejecuta:

            ```
            /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
            ```

            ## Licencia

            AGPL-3.0 — [GitHub](https://github.com/kimai/kimai)
    id-ID:
        description: |
            Kimai adalah aplikasi pelacakan waktu open-source gratis. Catat jam kerja per proyek dan aktivitas, buat laporan dan faktur, kelola tim dan klien. Mendukung multi-pengguna, tag, ekspor PDF/CSV, dan REST API.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Domain
              description: Domain untuk mengakses Kimai
        readme: |
            # Kimai

            Aplikasi pelacakan waktu self-hosted. Lacak jam kerja per proyek dan aktivitas, kelola klien, dan buat faktur serta laporan.

            ## Apa yang bisa dilakukan setelah deploy

            1. **Buka domain** — buat akun admin dari konsol lalu login
            2. **Buat klien dan proyek** — atur catatan waktu berdasarkan klien, proyek, dan aktivitas
            3. **Lacak waktu** — gunakan timer atau catat jam kerja secara manual
            4. **Buat laporan** — lihat laporan mingguan, bulanan, atau kustom; ekspor ke PDF, CSV, atau Excel
            5. **Kelola tim** — undang pengguna, tetapkan peran, kontrol visibilitas proyek per tim

            ## Pengaturan awal

            Setelah deploy, buka terminal (konsol Zeabur) dan jalankan:

            ```
            /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
            ```

            ## Lisensi

            AGPL-3.0 — [GitHub](https://github.com/kimai/kimai)
    ja-JP:
        description: |
            Kimaiは無料のオープンソース時間追跡アプリです。プロジェクトやアクティビティの作業時間を記録し、レポートや請求書を生成し、チームと顧客を管理します。複数ユーザー、タグ、PDF/CSVエクスポート、REST APIに対応。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: ドメイン
              description: Kimaiにアクセスするためのドメイン
        readme: |
            # Kimai

            セルフホストの時間追跡アプリ。プロジェクトとアクティビティごとに作業時間を追跡し、顧客を管理し、請求書とレポートを生成します。

            ## デプロイ後にできること

            1. **ドメインにアクセス** — コンソールで管理者アカウントを作成してログイン
            2. **顧客とプロジェクトを作成** — 顧客、プロジェクト、アクティビティ別に時間を記録
            3. **時間を追跡** — タイマーまたは手動で作業時間を記録
            4. **レポートを生成** — 週次・月次・カスタムレポートを表示、PDF・CSV・Excelにエクスポート
            5. **チームを管理** — ユーザーを招待、ロールを割り当て、チーム別にプロジェクトの可視性を制御

            ## 初回セットアップ

            デプロイ後、ターミナル（Zeaburコンソール）で実行：

            ```
            /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
            ```

            ## ライセンス

            AGPL-3.0 — [GitHub](https://github.com/kimai/kimai)
    ko-KR:
        description: |
            Kimai는 무료 오픈소스 시간 추적 애플리케이션입니다. 프로젝트와 활동별 근무 시간을 기록하고, 보고서와 청구서를 생성하며, 팀과 고객을 관리합니다. 다중 사용자, 태그, PDF/CSV 내보내기, REST API를 지원합니다.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 도메인
              description: Kimai에 접속할 도메인
        readme: |
            # Kimai

            셀프호스팅 시간 추적 앱. 프로젝트와 활동별로 근무 시간을 추적하고, 고객을 관리하며, 청구서와 보고서를 생성합니다.

            ## 배포 후 할 수 있는 것

            1. **도메인 접속** — 콘솔에서 관리자 계정을 생성한 후 로그인
            2. **고객과 프로젝트 생성** — 고객, 프로젝트, 활동별로 시간 기록 정리
            3. **시간 추적** — 타이머 또는 수동으로 근무 시간 기록
            4. **보고서 생성** — 주간, 월간 또는 사용자 정의 보고서 보기, PDF/CSV/Excel로 내보내기
            5. **팀 관리** — 사용자 초대, 역할 할당, 팀별 프로젝트 가시성 제어

            ## 첫 설정

            배포 후 터미널(Zeabur 콘솔)에서 실행:

            ```
            /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
            ```

            ## 라이선스

            AGPL-3.0 — [GitHub](https://github.com/kimai/kimai)
    th-TH:
        description: |
            Kimai คือแอปติดตามเวลาโอเพนซอร์สฟรี บันทึกชั่วโมงทำงานตามโปรเจกต์และกิจกรรม สร้างรายงานและใบแจ้งหนี้ จัดการทีมและลูกค้า รองรับผู้ใช้หลายคน แท็ก ส่งออก PDF/CSV และ REST API
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: โดเมน
              description: โดเมนสำหรับเข้าถึง Kimai
        readme: |
            # Kimai

            แอปติดตามเวลาแบบ self-hosted ติดตามชั่วโมงทำงานตามโปรเจกต์และกิจกรรม จัดการลูกค้า สร้างใบแจ้งหนี้และรายงาน

            ## สิ่งที่ทำได้หลังจากติดตั้ง

            1. **เข้าสู่โดเมน** — สร้างบัญชีผู้ดูแลจากคอนโซลแล้วเข้าสู่ระบบ
            2. **สร้างลูกค้าและโปรเจกต์** — จัดระเบียบบันทึกเวลาตามลูกค้า โปรเจกต์ และกิจกรรม
            3. **ติดตามเวลา** — ใช้ตัวจับเวลาหรือบันทึกชั่วโมงด้วยตนเอง
            4. **สร้างรายงาน** — ดูรายงานรายสัปดาห์ รายเดือน หรือกำหนดเอง ส่งออกเป็น PDF, CSV หรือ Excel
            5. **จัดการทีม** — เชิญผู้ใช้ กำหนดบทบาท ควบคุมการมองเห็นโปรเจกต์ตามทีม

            ## ตั้งค่าครั้งแรก

            หลังจากติดตั้ง เปิดเทอร์มินัล (คอนโซล Zeabur) แล้วรัน:

            ```
            /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
            ```

            ## สัญญาอนุญาต

            AGPL-3.0 — [GitHub](https://github.com/kimai/kimai)
    zh-CN:
        description: |
            Kimai 是免费的开源时间追踪应用。记录项目和活动的工时，生成报表和发票，管理团队和客户。支持多用户、标签、导出 PDF/CSV 和 REST API。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 域名
              description: 访问 Kimai 的域名
        readme: |
            # Kimai

            自托管的时间追踪应用，适合自由职业者、代理商和企业。按项目和活动追踪工时，管理客户，生成发票和报表。

            ## 部署后可以做什么

            1. **打开域名** — 通过控制台创建管理员账号后登录
            2. **创建客户和项目** — 按客户、项目和活动组织时间记录
            3. **追踪时间** — 使用计时器或手动记录工时
            4. **生成报表** — 查看周报、月报或自定义报表，导出为 PDF、CSV 或 Excel
            5. **管理团队** — 邀请用户、分配角色、按团队限制项目可见性

            ## 首次设置

            部署后，打开终端（Zeabur 控制台）执行：

            ```
            /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
            ```

            ## 授权

            AGPL-3.0 — [GitHub](https://github.com/kimai/kimai)
    zh-TW:
        description: |
            Kimai 是免費的開源時間追蹤應用程式。記錄專案和活動的工時，產生報表和發票，管理團隊和客戶。支援多使用者、標籤、匯出 PDF/CSV 和 REST API。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 網域
              description: 存取 Kimai 的網域
        readme: |
            # Kimai

            自架的時間追蹤應用程式，適合自由工作者、代理商和企業。按專案和活動追蹤工時，管理客戶，產生發票和報表。

            ## 部署後可以做什麼

            1. **開啟網域** — 透過主控台建立管理員帳號後登入
            2. **建立客戶和專案** — 按客戶、專案和活動組織時間記錄
            3. **追蹤時間** — 使用計時器或手動記錄工時
            4. **產生報表** — 檢視週報、月報或自訂報表，匯出為 PDF、CSV 或 Excel
            5. **管理團隊** — 邀請使用者、指派角色、按團隊限制專案可見性

            ## 首次設定

            部署後，開啟終端機（Zeabur 主控台）執行：

            ```
            /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN
            ```

            ## 授權

            AGPL-3.0 — [GitHub](https://github.com/kimai/kimai)