Leantime®

⭐ Leantime が役に立ったら、GitHub でスターをお願いします！ ⭐

Leantime は、プロジェクトマネージャーではない人のためのオープンソースプロジェクト管理システムです。戦略、計画、実行を一体化し、チームの誰もが簡単に使えるように設計されています。 ADHD、ディスレクシア、自閉症を考慮して開発されています。🧠

💪 Trello のようにシンプルでありながら、Jira のように機能豊富 🔄 ClickUp、Monday、Asana の完璧な代替ツール 🌐 https://leantime.io

Github Downloads GitHub Sponsors

alt text

🚀 機能*

タスク管理	プロジェクト計画	情報・ナレッジ管理	管理機能
カンバンボード、ガントチャート、テーブル、リスト、カレンダービューによるタスク管理	プロジェクトダッシュボード、レポート、ステータス更新	Wiki / ドキュメント	簡単なインストール
無制限のサブタスクと依存関係	ゴールと指標のトラッキング	アイデアボード	複数のユーザーロールとプロジェクトごとの権限
マイルストーン管理	リーンキャンバス & ビジネスモデルキャンバス	レトロスペクティブ	二要素認証
スプリント管理	SWOT分析キャンバス	S3またはローカルファイルシステムによるファイルストレージ	LDAP、OIDC連携
タイムトラッキング & タイムシート	リスク分析	画面 & ウェブカメラ録画	プラグインとAPIで拡張可能
	... その他多数	すべてにコメント/ディスカッション可能	Slack、Mattermost、Discordと連携
	... その他多数		20以上の言語に対応
*はい、これらの機能はすべてOSS版に含まれています

📸 スクリーンショット

❗システム要件

PHP 8.2以上
MySQL 8.0以上または MariaDB 10.6以上
Apache または Nginx（IISも一部修正で動作可能）
PHP拡張:
BC Math (bcmath)
Ctype
cURL
DOM
Exif
Fileinfo
Filter
GD
Hash
LDAP
Multibyte String (mbstring)
MySQL
OPcache
OpenSSL
PCNTL
PCRE
PDO
Phar
Session
Tokenizer
Zip
SimpleXML

️⚡️ インストール（本番環境）

LeanTime を本番環境にインストールするには、主に2つの方法があります。1つ目はシステムに必要なすべてのコンポーネントをローカルにインストールする方法です。2つ目は公式にサポートされているDockerイメージを使用する方法です。

ローカル本番インストール

リリースページから最新のリリースパッケージ（ファイル名: Leantime-vx.x.x.zip）をダウンロード
空のMySQLデータベースを作成
ディレクトリ全体をサーバーにアップロード
ドメインルートを public/ ディレクトリに向ける
config/sample.env を config/.env にリネーム
config/.env にデータベースの認証情報（ユーザー名、パスワード、ホスト、DB名）を入力
<yourdomain.com>/install にアクセス
指示に従ってデータベースのインストールと最初のユーザーアカウントのセットアップを実行

IIS インストール時の注意

上記の手順はInternet Information Services（IIS）にも適用できますが、完全に動作させるにはIISで追加の設定変更が必要になる場合があります。PATCHメソッドを許可する必要があります:

IISを開く
左側でサーバーとサイトを展開し、LeanTimeサイトを選択
Handler Mappings をダブルクリック
サイトで使用されているPHPハンドラマッピングをダブルクリック
Request Restrictions… をクリック
Verbs タブをクリック
One of the following verbs テキストボックスに PATCH を追加 — 例: GET,HEAD,POST,PATCH
OK をクリック
Executable (optional) テキストボックスで、php-cgi.exe ファイルへのパスの先頭と末尾にダブルクォート（"）を追加（パスにスペースが含まれていない場合は不要）
OK をクリック
FastCGIアプリケーションを作成するかどうかのポップアップが表示されたら Yes をクリック

注意: PHPをアップグレードした際にこの手順を繰り返す必要がある場合があります。

Docker経由での本番インストール

公式のDockerイメージをDockerHubで公開しています。イメージを実行するには、MySQLの認証情報を入力して以下を実行します。.envのすべての設定変数を渡すことができます。

docker run -d --restart unless-stopped -p 8080:8080 --network leantime-net \
-e LEAN_DB_HOST=mysql_leantime \
-e LEAN_DB_USER=admin \
-e LEAN_DB_PASSWORD=321.qwerty \
-e LEAN_DB_DATABASE=leantime \
-e LEAN_EMAIL_RETURN=changeme@local.local \
--name leantime leantime/leantime:latest

他の場所にデータベースを用意していない限り、docker-composeファイルの使用をお勧めします。

起動後、<yourdomain.com>/install にアクセスしてインストールスクリプトを実行できます。

重要: プラグインを使用する予定がある場合は、プラグインフォルダ plugins:/var/www/html/app/Plugins をマウントし、www-dataユーザーがアクセスできることを確認してください。そうしないと、インストールが失敗するか、再起動後にプラグインが削除される可能性があります。

Docker インストール時の注意

Leantime をリバースプロキシ（nginxなど）の背後に配置してカスタムドメイン名の解決やSSLオフローディングを行う場合は、Dockerで以下の環境変数を設定する必要があります。

-e LEAN_APP_URL=https://yourdomain.com \

yourdomain.com をカスタムドメイン名に更新してください。

🤓 インストール（開発環境）

LeanTime の開発環境をセットアップするには2つの方法があります。1つ目（最も技術的な方法）はシステムのすべてのコンポーネントをローカルにインストールする方法です。2つ目（推奨方法）はDockerコンテナ化された開発環境を使用する方法です。

ローカル開発インストール

リポジトリをローカルサーバーにクローン
MySQLデータベースを作成
make build-dev でwebpackビルダーを実行
ローカルドメインを public/ ディレクトリに向ける
config/sample.env を config/.env にリネーム
config/.env にデータベースの認証情報（ユーザー名、パスワード、ホスト、DB名）を入力
<localdomain>/install にアクセス
指示に従ってデータベースとユーザーアカウントをインストール

Docker経由での開発インストール

開発では、Dockerコンテナ化された開発環境を使用します。docker、docker compose、make、composer、git、npm がインストールされている必要があります。

Windows環境での注意:
- Unix固有のコマンドを使用するために、すべてのコマンドをgit bashターミナル内で実行してください
- zipファイルからPHPをインストールした場合、php.iniを設定する必要があります。初期状態ではphp.iniは存在しないため、C:\php\php.ini-developmentをC:\php\php.iniにコピーしてください。また、テキストエディタでphp.iniを編集し、ビルドプロセスに必要なすべての拡張を有効にする必要があります。makeコマンドを実行し、不足している拡張のエラーメッセージを確認することで必要な拡張を特定できます。;extension=gd のような行を検索し、セミコロンを削除することで有効化できます。

開発用Dockerイメージをビルドするには、リポジトリのルートで以下のコマンドを実行して初期セットアップを行います。

make clean build

その後、以下を実行します。

make run-dev

これにより、ポート5080で開発サーバーが起動します。

開発環境にはMySQLサーバー、メールサーバー、S3サーバーが含まれており、すぐに使える状態になっています。開発環境の基本設定はcomposeファイルで定義済みです。config/.env に.envファイルを作成して、sample.envの一部の設定で基本設定を拡張できます。重要: データベース情報を更新しないでください。Dockerデータベースとの接続が切断されます。 利用可能なアプリケーションは以下の通りです。

http://localhost:8090 : leantime
http://localhost:8081 : maildev - 送信されたメールを確認
http://localhost:8082 : phpMyAdmin（認証情報 leantime:leantime）でDBスキーマとデータを確認
http://localhost:8083 : s3ninja - S3アップロードを確認。.dev/.env ファイルでS3を有効にする必要があります

また、Xdebugは有効化されていますが、.dev/xdebug.ini ファイル（または代わりにIDE側）でIDEキーを変更する必要があります。Xdebugを効果的に使用するには、ファイアウォールでポート9003を一時的に開放する必要があります。これは、Dockerからホストへの接続が外部からの受信接続として扱われるためです。

テストの実行

静的解析 make phpstan コードスタイル make test-code-style（コードスタイルを自動修正するには make fix-code-style）ユニットテスト make unit-test 受け入れテスト make acceptance-test（Dockerが必要）

個別の受け入れテストグループを直接テストできます: API の場合: docker compose --file .dev/docker-compose.yaml --file .dev/docker-compose.tests.yaml exec leantime-dev php vendor/bin/codecept run -g api --steps タイムシートの場合: docker compose --file .dev/docker-compose.yaml --file .dev/docker-compose.tests.yaml exec leantime-dev php vendor/bin/codecept run -g timesheet --steps

🏗 アップデート

手動

データベースとファイルのバックアップを必ず取ってください
ディレクトリ内のすべてのファイルを更新版で置き換え
データベースに変更があった場合、システムが <yourdomain.com>/update にリダイレクトします

CLI

php bin/leantime system:update を実行

Docker

アップデート前に、MySQLコンテナがマウントされたボリュームを使用して起動されていることを確認してください。そうでないとコンテンツが削除されます
既存のコンテナを削除/停止
最新のDockerイメージをプルし、composeファイルを使用して再ビルド

よくある問題

Leantime のインストールやアップデート時によくある問題については、ドキュメントをご覧ください。

🔌 Leantime の拡張

Leantime は以下の方法で拡張できます:

独自のプラグインを作成: プラグインドキュメント
JSON-RPC APIを使用: APIドキュメント
マーケットプレイスからプラグインを購入

🛟 インストール代行サービス

お客様の環境への手間のかからないインストールサービスを提供しています。完全なインストール、アップデート、設定、プラグインのインストールに対応します。詳細はマーケットプレイスをご覧ください。

☁️ ホスティングをお任せください

マネージドホスティングプランとSaaS製品を提供しており、手間をかけずにLeantimeのすべてのメリットを享受できます。詳細は leantime.io をご覧ください。

🤙 テクニカルサポートが必要ですか？

お客様の環境でのLeantimeのセットアップとニーズに合わせたカスタマイズをサポートします。サポートプランはウェブサイトに記載しています。

注意: 現在、公式のLeantime docker composeおよび標準インストールのみサポートしています。最新バージョンのみサポートを提供しています。

Cloudron、Elestio、Turnkey、その他の非公式バージョンのLeantimeを提供する外部配布プラットフォームのサポートは行っていません。

🫴 コントリビューション

Leantimeへのコントリビューションに興味をお持ちいただきありがとうございます。皆様に素晴らしいコントリビューション体験をしていただき、新しい機能がコアに取り込まれるようにしたいと考えています。

🪲 バグ

GitHub でイシューを見つけ（または新しく作成し）、名前を追加するかコメントで作業する旨を伝えてください。修正後、プルリクエストを作成してください。

コアへの新機能

新機能のアイデアがある場合は、Discordでお気軽にご連絡ください。機能開発の調整や、新機能をコアに追加すべきかプラグインにすべきかを議論する場です。

🌏 翻訳

言語ファイルと翻訳は app/Language/* に格納されています。更新後、プルリクエストを作成してください。

👥 コミュニティサポート

ドキュメント https://docs.leantime.io
コミュニティチャット Discord
バグ報告 https://github.com/Leantime/leantime/issues/new
翻訳 https://crowdin.com/project/leantime

⚖️ ライセンスの例外事項

Leantime は AGPLv3 でライセンスされています。このファイルは Leantime ソフトウェアの一部を構成しており、以下の例外が追加されています: /app/Plugins ディレクトリ内のプラグインには、エンタープライズライセンスを含む他のライセンスでライセンスされたプラグインが含まれる場合があります。