本グループウェアの利用は無料です。ただし、サーバー、ドメイン、外部APIなどの利用料、導入や保守にかかる費用は別途必要になる場合があります。
主な特徴
- 共用レンタルサーバーに導入可能：エックスサーバーのスタンダードプランで動作確認しています。
- 必要な機能をまとめて管理：組織階層、権限階層、ユーザーに基づいて情報を管理できます。
- システム保守機能：バックアップ、復元、データベースメンテナンスなどを用意しています。
- 配布ZIPを提供：公式配布ZIPには、動作に必要なComposer依存関係を含めています。
- 外部サービス連携：カレンダー、メール、プッシュ通知、OCRなどを必要に応じて有効化できます。
主な機能
- スケジュール管理
- シフト管理
- メッセージ
- チャット
- ワークフロー
- タスク管理
- 日報
- 掲示板
- ファイル管理
- ファイル共有
- WEBデータベース
- アドレス帳
- 施設予約
- カレンダー連携
- 通知・メール送信
- 全文検索
- ユーザー管理
- 組織管理
- バックアップと復元
- DBメンテナンス
- 機能の有効化・無効化
インストール手順
以下は、公式配布ZIPを使用して導入する場合の基本手順です。サーバー会社や契約プランによって、画面名・パス・設定方法が異なる場合があります。
配布ZIP：adlink-groupware-1.1.8.zip
動作要件を確認する
| 項目 | 要件 |
|---|---|
| PHP | 8.2 以上（8.3を推奨）。Web実行用とCron用を同じ系統にします |
| PHP 必須拡張 | pdo, pdo_mysql, mbstring, json, fileinfo, gd または imagick外部連携を使う場合は curl, openssl も有効にします。PHPのmemory_limitは128MB以上を推奨します。 |
| データベース | MySQL 5.7 以上 / MariaDB 10.3 以上 |
| Web サーバー | .htaccess とURL書き換えが利用できる環境 |
| その他 | 独自ドメインまたはサブドメイン、無料SSL、Cron設定、2GB程度以上の空き容量を推奨 |
データベースを用意する
空のデータベースを作成し、接続先、データベース名、ユーザー名、パスワードを確認します。文字コードはutf8mb4を使用してください。
配布ZIPを配置する
ZIPを展開し、Web公開ディレクトリへアップロードします。ドキュメントルートへ配置する場合は、例として https://example.com/install.php からインストーラーを開きます。サブディレクトリへ配置する場合は、例として https://example.com/groupware/install.php から開きます。
公式配布ZIPにはComposer依存関係を含めています。通常、導入先サーバーでComposerを実行する必要はありません。
書き込み権限を確認する
インストール時および運用時に、config、uploads、public/uploads、exports、storageへ書き込める必要があります。まずはサーバーの標準的な権限（ディレクトリ755、ファイル644を目安）で設定し、777の常用は避けてください。
Webインストーラーを実行する
インストーラーの画面に従い、環境チェック、データベース接続、管理者アカウント、会社名・タイムゾーンなどを設定します。内容を確認してインストールを実行してください。
インストール完了後は、インストールロックが作成されます。初期設定を終えたら、管理者アカウントでログインできることを確認してください。
初期設定を行う
組織・ユーザー・施設、メール送信（SMTP）、ワークフロー、日報テンプレートなどを設定します。カレンダー連携、PWAプッシュ通知、SSOなどは必要な場合だけ設定してください。
Cronを設定する
メールキュー処理や定期処理を利用する場合は、サーバーのCronへ登録します。以下は構成例です。実際のPHP実行ファイルと配置パスは、契約サーバーの案内に合わせて変更してください。
*/5 * * * * /usr/bin/php8.3 /home/USER/DOMAIN/public_html/groupware/scripts/process_email_queue.php >> /home/USER/email_queue_cron.log 2>&1
動作確認を行う
ログイン、ユーザー権限、ファイルのアップロード、メール送信、Cron処理、スマートフォン表示を確認します。外部連携を有効にした場合は、連携先との通信も確認してください。
更新時の注意
更新前にバックアップを取得してください。config/config.php、config/database.php、.env、install.lock、アップロードデータ、エクスポートデータ、ストレージデータは上書き・削除しないでください。
トラブルシューティング
- 画面が真っ白、または500エラーになる場合：PHPバージョン、必要な拡張、ファイル権限、Webサーバーのエラーログを確認してください。
- データベースへ接続できない場合：接続先、ポート、データベース名、ユーザー権限、パスワードを確認してください。
- CSSやJavaScriptが読み込まれない場合：URL書き換え、HTTPS、サブディレクトリ設定、ブラウザキャッシュを確認してください。
- Cronが動作しない場合：PHPの実行パス、スクリプトの絶対パス、実行ユーザー、Cronログを確認してください。
- 再インストールする場合：データベースと設定ファイルを含むバックアップを取得し、既存データを削除する前に復元方法を確認してください。
OCR機能について
名刺画像などのOCR読み取りには、任意でTesseract OCRを利用できます。TesseractはサーバーOSへインストールする外部実行ファイルのため、共用レンタルサーバーでは利用できない場合があります。
Tesseractを利用できない環境では、OpenAI APIを指定して名刺画像のOCR読み取りに対応できます。OpenAI APIの利用にはAPIキーが必要で、提供元の利用条件や料金が適用されます。Tesseractと外部APIのどちらも利用できない環境でも、OCR機能以外の通常のグループウェアは利用できます。
ライセンス・開発の経緯
このプロジェクトは GNU General Public License v3.0 のもとで公開されています。
本ソフトウェアは、Yuusuke9228が公開したGitHubリポジトリ groupwareをフォークし、アドリンク株式会社が自社で利用するために改変・機能追加・保守している派生版です。コーディングはCodexで行っています。
- フォーク元公開者
- Yuusuke9228（GitHubアカウント名）
- フォーク元リポジトリ
- https://github.com/Yuusuke9228/groupware
- 本プロジェクト名
- adlink-groupware
Composer依存ライブラリには、MIT、Apache-2.0、LGPL、BSDなど、個別のライセンスが適用されます。詳細は配布ZIP内の LICENSE.md、LICENSE、および各依存ライブラリのライセンスファイルを確認してください。
注意事項
- 本ソフトウェアには保証がありません。自己責任でご利用ください。
- サーバー環境によっては、必要なPHP拡張、Cron、URL書き換え、外部実行ファイルが利用できない場合があります。
- デモ環境や固定のデモアカウントは提供していません。