Ever Gauzy プラットフォーム

💡 新着情報

ワーク＆プロジェクト管理のための Ever Teams プラットフォームをリリースしました。 https://github.com/ever-co/ever-teams をチェックして、GitHub でスターをお願いします！ React（NextJs）/ ReactNative（Expo）スタックで構築されており、ヘッドレスの Ever Gauzy プラットフォーム API に接続します。

🌟 概要

Ever® Gauzy™ - コラボレーション、オンデマンド、シェアリングエコノミー向けのオープンビジネス管理プラットフォーム。

• 企業資源計画（ERP）
• 顧客関係管理（CRM）
• 人材管理（HRM）
• 応募者追跡システム（ATS）
• ワーク＆プロジェクト管理（PM）
• 従業員の勤怠管理、アクティビティ＆生産性トラッキング

Ever® Gauzy™ プラットフォームは、コラボレーション、オンデマンド、シェアリングエコノミー向けのより大きなオープンプラットフォーム - Ever® Platform™ の一部です。

✨ 機能

主要機能：

• 時間管理/トラッキングと従業員パフォーマンスモニタリングを含む人材管理（HRM）
• 顧客関係管理（CRM）
• 企業資源計画（ERP）
• プロジェクト/タスク管理
• 営業管理
• 財務・コスト管理（会計、請求書作成 など）
• 在庫、サプライチェーン管理、生産管理

プラットフォームで利用可能な機能のより詳細なリスト：

• ヘッドレス API
• ダッシュボード（会社の収入/支出、従業員ボーナスなど、様々な指標の概要を提供）
• 時間管理/タイムトラッキング/アクティビティトラッキング/タイムシート
• 従業員管理（会社の従業員/契約者の登録、従業員の料金など）
• 従業員オンボーディング
• 応募者追跡システム（ATS）/候補者面接
• 連絡先管理（クライアント/顧客/リードなど）
• スケジュール/予約/イベント
• プロジェクト管理/タスク
• 目標/KPI/目的/主要成果指標
• 営業パイプライン
• 提案書
• 会計/請求書/見積書
• 課金
• 支払い
• 収入/支出管理
• 休暇管理/祝日/承認
• 在庫管理
• 機器/共有
• 複数組織管理
• 組織の部門とチーム
• 組織のクライアントとベンダー
• ヘルプセンター/ナレッジベース
• タグ/ラベル
• レポート/インサイト/アナリティクス
• 組織と従業員の公開ページ
• 統合（Upwork、HubStaff など）
• メール履歴/メールテンプレート
• データインポート/エクスポート
• ロール/権限
• マルチ通貨
• 多言語対応
• ダーク/ライト/コーポレート/マテリアルなどのテーマ

Gauzy についてや、会社、オンデマンドビジネス、フリーランスビジネス、代理店、スタジオ、社内チームでの使い方について詳しくお読みください。

🌼 スクリーンショット

Web UI

デスクトップタイマー UI（標準）

デスクトップタイマー UI（展開）

🔗 リンク

• https://gauzy.co - 公式ウェブサイトでプラットフォームの詳細情報をご確認ください。
• https://app.gauzy.co - SaaS（重要：現在アルファ版/テストモードのため、慎重にご利用ください）。
• https://demo.gauzy.co - オンラインデモ（下記の詳細情報もご覧ください）。
• https://gauzy.co/downloads - プラットフォーム＆アプリのダウンロード（利用可能なダウンロードについては下記もご覧ください）。
• https://docs.gauzy.co - プラットフォームドキュメント（作成中）。Wiki もご覧ください。
• https://ever.co - 当社の製品についてより詳しい情報をご覧ください。

📊 アクティビティ

💻 デモ、ダウンロード、テスト、本番環境

デモ

Ever Gauzy プラットフォームのデモは https://demo.gauzy.co でご利用いただけます。

注意事項：

• デフォルトのスーパー管理者ユーザーのログインは admin@ever.co、パスワードは admin です
• デモ DB の内容はデモ環境へのデプロイごとにリセットされます（通常は毎日）
• デモ環境は develop ブランチから CI/CD を使用してデプロイされています

ダウンロード

Gauzy プラットフォーム、Gauzy サーバー、またはデスクトップアプリ（Windows/Mac/Linux）は公式ダウンロードページからダウンロードできます。

さらに、すべてのリリースとプレリリースのダウンロードは以下のページからも利用可能です：

• プラットフォームリリース
• アプリ

本番環境（SaaS）

Ever® Gauzy™ プラットフォーム SaaS は https://app.gauzy.co でご利用いただけます。

注意：現在アルファ版/テストモードのため、慎重にご利用ください！

ステージング

• Gauzy プラットフォームのステージングビルド（stage ブランチからの CI/CD 使用）は https://stage.gauzy.co でご利用いただけます
• 本番環境にデプロイする前にリリースをテストするためにステージング環境を使用しています
• デスクトップ/サーバーアプリのプレリリースはこの環境からビルドされ、手動（設定内）でステージ API に接続するよう設定できます：https://apistage.gauzy.co

サーバー＆デスクトップアプリ

Gauzy サーバーと2つのデスクトップアプリ（Windows/Mac/Linux対応）があります：

• Ever® Gauzy™ サーバー - Gauzy API、SQLite DB（または外部 PostgreSQL に接続）を含み、Gauzy フロントエンドを提供します。複数のクライアント（ブラウザベースまたはデスクトップベース）向けに Gauzy サーバーを素早く実行できます。小〜中規模の組織で Ever Gauzy プラットフォームをセットアップしたい場合に推奨されるオプションです。

• Ever® Gauzy™ デスクトップアプリ - Gauzy フロントエンド（UI）、Gauzy API、SQLite DB などをオールインワンで含みます！Gauzy ソリューション全体をローカルで素早く実行でき、UI とタイマー（勤怠管理用、もちろんオプション）の両方を利用できます。さらに、外部データベース（例：PostgreSQL）や外部 API（別のコンピューターに Gauzy サーバーと API/DB がインストールされている場合や、ライブ API に接続したい場合）への接続も可能です。Gauzy を素早く試したい場合や個人利用、または「クライアント-サーバー」構成で Gauzy サーバーに接続してデスクトップアプリを使用したい場合（ウェブブラウザの代わりに）に推奨されるオプションです。

• Ever® Gauzy™ デスクトップタイマーアプリ - スクリーンショットとアクティビティモニタリング機能を備えた従業員/契約者向けの勤怠管理とアクティビティトラッキングを実行できます。他の Gauzy プラットフォーム機能（会計など）に興味がなく、勤務時間のトラッキングのみが必要な組織の従業員がセットアップすることを推奨します。

サーバー＆デスクトップアプリの詳細情報：

• 公式ダウンロードページからお使いの OS 用にダウンロードするか、リリースページへの他のリンクについては上記の「ダウンロード」セクションをご覧ください。
• セットアップウィザードでデフォルトの選択肢で Gauzy サーバーをセットアップして実行します。
• Gauzy デスクトップアプリ（独立して実行するか Gauzy サーバーに接続可能）または Gauzy デスクトップタイマーアプリ（Gauzy サーバーに接続する必要あり）もセットアップできます。
• Gauzy サーバーまたは Gauzy デスクトップアプリをインストールした場合、admin@ever.co とパスワード admin で管理者機能を確認できます。注意：この管理者ユーザーは従業員ではないため、勤怠管理はできません。
• employee@ever.co とパスワード 123456 で従業員関連機能を Gauzy UI で確認するか、「従業員」の観点からデスクトップタイマーを実行できます（このユーザーは従業員であり、勤怠管理が可能です）。
• Gauzy サーバーをインストールした場合、ブラウザ（デフォルトで http://localhost:4200）または Gauzy デスクトップアプリから接続できます（デスクトップアプリを Gauzy API http://127.0.0.1:3000/api に接続するよう設定してください。Gauzy サーバー API はデフォルトでそこで実行されます）。
• デスクトップアプリの詳細は デスクトップアプリ Wiki ページ、サーバーについては サーバー Wiki ページをお読みください。

🧱 技術スタックと要件

• TypeScript
• NodeJs / NestJs
• Nx / Lerna
• Angular / RxJS / Ngx-admin
• TypeORM / MikroORM / Knex

本番環境では以下を推奨：

• PostgreSQL または MySQL
• Kubernetes、Docker

注意：TypeORM / MikroORM のおかげで、Gauzy は多数の DB をサポートします：SQLite（デフォルト、デモ用）、PostgreSQL（開発/本番）、MySql（開発/本番）、MariaDb、CockroachDb、MS SQL、Oracle、MongoDb、その他（最小限の変更で）。

プラットフォームに含まれるライブラリとソフトウェアのリスト、ライセンスに関する情報、その他の詳細については、関連フォルダ内の README.md および CREDITS.md ファイルもご覧ください

📄 ドキュメント

公式プラットフォームドキュメントと Wiki（作成中）をご参照ください。

🚀 クイックスタート

Docker Compose を使用

• リポジトリをクローンします。
• 最新の Docker Compose がローカルにインストールされていることを確認してください。重要：最低 v2.20 が必要です。

デモ

• プリビルドされた Docker イメージを使用して基本的な設定（デモ/機能の探索/クイック実行用など）でプラットフォームを実行するには docker-compose -f docker-compose.demo.yml up を実行します。異なる設定（オプション）については .env.demo.compose ファイルを確認してください（例：DB タイプ）。（注意：Docker Compose は GitHub CI/CD を使用して master ブランチのヘッドから自動的にプリビルドされた最新のイメージを使用します。）
• ブラウザで http://localhost:4200 を開きます。
• スーパー管理者ユーザーとしてメール admin@ever.co、パスワード admin でログインします。
• 従業員ユーザーとしてメール employee@ever.co、パスワード 123456 でログインします。
• お楽しみください！

本番環境

• カスタム設定（例：DB タイプ）を使用する場合は .env.compose を編集します（必要に応じて）。
• プリビルドされた Docker イメージを使用して最小限の本番構成でプラットフォームを実行するには docker-compose up -d を実行します。（注意：Docker Compose は GitHub CI/CD を使用して master ブランチのヘッドから自動的にプリビルドされた最新のイメージを使用します。）

注意：本番ワークロードには Docker Compose の代わりに Kubernetes の使用を推奨します！

ビルド

• カスタム設定（例：DB タイプ）を使用する場合は .env.compose を編集します（必要に応じて）。
• すべて（コードと Docker イメージ）をローカルでビルドするには docker-compose -f docker-compose.build.yml up -d を実行します。（注意：プラットフォーム全体をローカルでビルドするため非常に時間がかかります。上記の他のオプションの方がはるかに高速です！）
• コーヒータイム... プリビルドされた Docker イメージを使用した場合でも、最初の Docker Compose 実行時に API が DB にフェイクデータをシードするのに時間がかかる場合があります。

注意事項：

• デモの docker-compose.demo.yml は最小限のコンテナ（API、Web UI、DB）を実行しますが、他の Docker Compose ファイルは複数のインフラストラクチャ依存関係を実行します（下記の完全なリストを参照）。
• docker-compose -f docker-compose.infra.yml up -d コマンドでインフラ依存関係のみ（API/Web コンテナなし）を実行することもできます。メインの docker compose ファイルでは include を使用して既にこれを行っています。
• docker-compose の up コマンドに --env-file .env.something のようなものを追加して、カスタム設定を含む特定の .env.something ファイルを使用するよう Docker Compose に指示できます。

上記の本番環境（docker-compose.yml）およびビルド（docker-compose.build.yml）の Docker Compose コマンドは、Gauzy とともに以下のインフラストラクチャコンポーネントを実行します：

• PostgreSQL - プライマリデータベース。
• Pgweb - PostgreSQL DB 用のクロスプラットフォームクライアント、http://localhost:8081 でアクセス可能。
• OpenSearch - 検索エンジン。
• OpenSearch Dashboards - 検索エンジンダッシュボード、http://localhost:5601 でアクセス可能。デフォルトのユーザー名：admin、パスワード：Gauzy_password_123
• Dejavu - OpenSearch 用 Web UI、http://localhost:1358 でアクセス可能。
• MinIO - マルチクラウド ☁️ オブジェクトストレージ（AWS S3 互換）。
• Jitsu - Jitsu はオープンソースの Segment 代替（データ取り込みエンジン）。
• Redis - インメモリデータストア/キャッシュ（Jitsu でも使用）。
• Cube - レポート、ダッシュボード、アナリティクスなどの BI 関連機能に使用される「セマンティックレイヤー」、http://localhost:4000 で UI アクセス可能。
• Zipkin - 分散トレーシングシステム。

手動

必須

• NodeJs LTS バージョン以降（例：バージョン 22.x または 24.x）をインストール。
• Yarn v1.22.x をインストール（未インストールの場合）npm i -g yarn で。
• コマンド yarn bootstrap で NPM パッケージをインストールしてソリューションをブートストラップ。
• コード変更を行い Git リポジトリにプッシュする必要がある場合は yarn prepare:husky を実行してください。
• ローカル実行で使用される .env.local の設定を調整。
• または、.env.sample を .env にコピーしてデフォルト設定を変更（例：データベースタイプ、名前、ユーザー、パスワードなど）。
• 単一コマンドで API と UI の両方を実行：yarn start。
• ブラウザで http://localhost:4200 から Gauzy UI を開きます（API は http://localhost:3000/api で実行）。
• スーパー管理者ユーザーとしてメール admin@ever.co、パスワード admin でログイン。
• 従業員ユーザーとしてメール employee@ever.co、パスワード 123456 でログイン。
• お楽しみください！

注意事項：

• 最初の API 起動時、ユーザーが見つからない場合は自動的に最小限の初期データで DB がシードされます。
• 手動でいつでもシードを実行できます（例：エンティティスキーマを変更した場合）yarn seed コマンドで DB を再初期化できます（警告：本番環境では安全ではありません！）。
• デモ目的/テスト用に大量のフェイクデータの生成を実行することも可能 yarn seed:all（警告：完了まで約10分かかります）。

オプション/本番環境に推奨

• オプション（本番環境に推奨）PostgreSQL バージョン 14 以降（本番には 16.x 推奨）をインストールして実行。注意：他の DB は TypeORM / MikroORM / Knex で手動設定可能。デフォルトの DB は SQLite（テスト/デモ目的のみに推奨）に設定されています。
• オプション（本番環境に推奨）Redis をインストールして実行。注意：プラットフォームは分散キャッシュ戦略の代わりにインメモリキャッシュ戦略を使用して Redis なしでも動作します（テスト/デモ目的のみに推奨）。ただし、Jitsu には Redis が必要です。
• オプション（本番環境に推奨）OpenSearch をインストールして実行。注意：プラットフォームは DB 組み込みの検索機能を使用して OpenSearch なしでも動作します（テスト/デモ目的のみに推奨）。
• オプション MinIO または LocalStack をインストールして実行。注意：プラットフォームはローカルファイルシステムベースのストレージを使用して MinIO / LocalStack などの S3 互換ストレージなしでも動作します（テスト/デモ目的のみに推奨）。本番環境には Wasabi または AWS S3 ストレージなどの S3 互換クラウドストレージの使用を推奨します。
• オプション（本番環境に推奨）Jitsu をインストールして実行。注意：プラットフォームは Jitsu なしでも動作しますが、追加分析/リアルタイムパイプラインのデータ取り込みが無効になります。
• オプション（本番環境に推奨）Cube をインストールして実行。注意：プラットフォームは Cube なしでも動作しますが、一部の高度な（動的）レポートとデータ処理機能が無効になります。

本番環境

一般情報

• サーバーでの本番環境セットアップの詳細については クライアントサーバー用の Gauzy セットアップをご覧ください。

Kubernetes

• 手動（下記参照）または Terraform モジュールや Ever Helm チャートを使用して Kubernetes（k8s）へのデプロイを推奨します。
• k8s でのよりシンプルなデプロイシナリオについては、DigitalOcean k8s クラスターに Gauzy をデプロイするために使用している Kubernetes 設定をご覧ください。

DigitalOcean App Platform

• 最もシンプルなデプロイシナリオ（個人または小規模組織向けなど）については、DigitalOcean App Platform 設定および対応する GitHub Action をご確認ください。

仮想インスタンス / Droplets（SSH 経由）

• Gauzy をデプロイする別の方法は、DigitalOcean Droplets またはその他の仮想インスタンス（Ubuntu OS）を使用し、SCP/SSH でデプロイすることです。例えば GitHub Action をご参照ください。

Pulumi

• さらに、Gauzy Pulumi プロジェクト（開発中）もご確認ください。単一コマンド（pulumi up）で複雑なクラウドデプロイメントが可能です。注意：現在、Application Load Balancer と AWS RDS Serverless PostgreSQL DB デプロイメントを備えた AWS EKS（Kubernetes）での開発・本番環境をサポートしています。同じ Pulumi プロジェクトで ECS EC2 および Fargate クラスターへのデプロイメントも実装しています。

💌 お問い合わせ

• Ever.co ウェブサイトのお問い合わせページ
• Slack コミュニティ
• Discord チャット
• 
• 
• ビジネスに関するお問い合わせ：mailto:gauzy@ever.co
• セキュリティ脆弱性の報告は mailto:security@ever.co までお願いします
• Gauzy Platform @ Twitter
• Gauzy Platform @ Facebook

🔐 セキュリティ

Ever® Gauzy™ は優れたセキュリティプラクティスに従っていますが、いかなるソフトウェアでも100%のセキュリティを保証することはできません！ Ever® Gauzy™ は一切の保証なしに現状のまま提供されます。自己責任でご利用ください！ 詳細は LICENSE をご覧ください。

本番環境のセットアップでは、クライアント側からサーバー側（バックエンド、API）へのすべての通信を HTTPS/WSS/SSL を使用して暗号化する必要があります（REST API、GraphQL エンドポイント、Socket.io WebSocket など）。

セキュリティに関する問題を発見した場合は、GitHub イシューを作成するのではなく、mailto:security@ever.co にメールを送信するか、 で責任を持って情報を開示してください。

🛡️ ライセンス

私たちはオープンソースコミュニティをサポートしています。素晴らしい非営利/オープンソースプロジェクトを構築中の方には、喜んでお手伝いし、（受け入れ基準に従い）Ever Gauzy Enterprise エディションのライセンスと無料ホスティングオプションを提供します！リクエストについてはお気軽に mailto:ever@ever.co までご連絡ください。詳細は Wiki をご覧ください。

このソフトウェアは以下のライセンスで利用可能です：

• Ever® Gauzy™ プラットフォーム Community エディション
• Ever® Gauzy™ プラットフォーム Small Business
• Ever® Gauzy™ プラットフォーム Enterprise

有効な Ever® Gauzy™ プラットフォーム Enterprise または Ever® Gauzy™ プラットフォーム Small Business ライセンス契約がない場合のデフォルトの Ever® Gauzy™ プラットフォームライセンスは Ever® Gauzy™ プラットフォーム Community エディションライセンスです

ライセンスの詳細は LICENSE をご覧ください。オファリングの比較も可能です

™️ 商標

Ever® は Ever Co. LTD の登録商標です。 Ever® Demand™、Ever® Gauzy™、Ever® Teams™、Ever® Rec™、Ever® Recu™、Ever® Cloc™、Ever® Works™、Ever® OpenSaaS™ はすべて Ever Co. LTD の商標です。

商標は Ever Co. LTD の書面による許可がある場合にのみ使用でき、競合製品やサービスの宣伝やマーケティングに使用することはできません。

その他すべてのブランド名および製品名は、それぞれの所有者の商標、登録商標、またはサービスマークです。

🍺 コントリビュート

• GitHub でスターをお願いします、助けになります！
• 機能リクエストは別のリポジトリに提出してください
• プルリクエストはいつでも歓迎です！プルリクエストは develop ブランチに対して作成し、コントリビューティングガイドに従ってください。

💪 コントリビューターへの感謝

コントリビューターリストは CONTRIBUTORS.md をご覧ください。 GitHub で追跡されるコントリビューターの完全なリストも表示できます。

⭐ スター履歴

❤️ Powered By

©️ 著作権

Copyright © 2019-present, Ever Co. LTD. All rights reserved

🔥 追伸

• オンデマンド（デリバリー）やデジタルマーケットプレイスビジネスに興味がある場合は、オープンソースの Ever Demand Platform をチェックしてください
• 採用中：リモート TypeScript / NestJS / Angular 開発者