OSS Calendarは企業で使うことを想定したオープンソースのカレンダーアプリです。
企業内のスケジューラーは使いづらい部分が多くあります。
しかし、個人のGoogleカレンダーなどと連携させてしまうと情報管理が心配で、開発をしたくてもカレンダーアプリは費用が掛かりすぎてしまいます。
OSS Calendarは企業で使うことを想定したカレンダーアプリですので、以下のような機能を実現しています。
詳しくは公式サイトをご確認ください。
OSS Calendar
Dockerを使って開発サーバーを建てる手順について説明します。 検証はMacOSのDocker for Macで行っていますので、Windowsの場合ところどころ違う可能性があります。
git clone https://github.com/thinkingreed-inc/oss-calendar.git oss-calendar
cd oss-calendar
docker-compose build
docker-compose up -d
cp .env.example .env
APP_URL=http://localhost #APIServerのURLを指定
CLIENT_URL=http://localhost #クライアントのURLを指定、HTMLを配信する場所
###
# CLIENT_URLは、npm run devで立ち上げた場合、http://localhost:3000になるため注意する
###
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=osscalendar
DB_USERNAME=username
DB_PASSWORD=userpass
MAIL_DRIVER=smtp
MAIL_HOST=mailcatcher
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
MAIL_FROM_NAME="シンキングリード"
# Dockerコンテナにログインして、Composerで関連ファイルをInstallする
docker ps
docker exec -it [container_id] bash
# ここからコンテナ内
cd /var/www/html/
composer remove fideloper/proxy
composer require laravel/helpers
composer require laravel/legacy-factories
composer require symfony/mailgun-mailer symfony/http-client
composer require fruitcake/laravel-cors
composer install
php artisan key:generate
php artisan optimize
php artisan migrate
php artisan db:seed
php artisan passport:install
- 既存のdockerimageとのポートの競合を回避する必要あります。
もし80番ポート等を使われている場合は、docker-compose.yml内のポートを修正してください。 クライアントサーバはnpm run dev
で稼働し、APIサーバはDockerコンテナのNginx、php-fpmで稼働します- .env.sampleをコピーして.envファイルを作成する
- .envファイルにあるAPP_KEYを更新する
- .env内部では半角スペースを使用できません。利用する場合はシングルクォーテーションでくくってください。
- もし、開発時にLaravelのコードが反映されない場合、php artisan optimizeでキャッシュをクリアする
ここではDockerではなく、クライアント側でnpmを実行手順を紹介する
先にも書きましたが、CLIENT_URLの部分は http://localhost:3000
を指定してください。
npm install
npm install -g nuxt
npm run dev
※クライアントサーバのポートは.envに記載してあるポート番号を自動で読み込む
表示されるURLにアクセスして、ログイン画面が表示され、「admin/admin」でログインできれば環境構築は完了です。
APIサーバには設定ファイルがキャッシュ化されているため、設定変更した場合は、php artisan optimize
コマンドを実行する。
クライアントサーバとAPIサーバを同一サーバにとして稼働させる
※同一サーバにすることでサーバのメンテナンスコストを削減できる
envの設定例:
CLIENT_URL=http://localhost
APP_URL=http://localhost
※CLIENT_URLとAPP_URLは同じにする
静的ファイルの書き出し:
$ npm run generate
$ npm run build
※public/_nuxtフォルダに書き出される
※.envのAPP_URLとCLIENT_URLによって、.htaccessのRewriteBaseは自動設定される
同一サーバで稼働させる
apacheのドキュメントルートをpublic/以下に設定し、稼働させる
APIサーバには設定ファイルがキャッシュ化されているため、設定変更した場合は、php artisan optimize
コマンドを実行する。
予定のメール通知を受け取るために、以下のスクリプトをcronに登録する
$ crontab -e
#以下の行を追加
#cd /var/www/html/ && php artisan command:reminder >> /dev/null 2>&1
api用のコントローラの作成
$ php artisan make:controller ApiController --api
自動補完対応
$ php artisan ide-helper:generate
$ php artisan ide-helper:model
For the avoidance of doubt, except that if any license choice other than GPL or LGPL is available it will apply instead, Thinkingreed elects to use only the General Public License version 3 (GPLv3) at this time for any software where a choice of GPL license versions is made available with the language indicating that GPLv3 or any later version may be used, or where a choice of which version of the GPL is applied is otherwise unspecified.
We want free and open source software applications under certain licenses to be able to use specified GPL-licensed OSS-Calenar despite the fact that not all such FOSS licenses are compatible with version 3 of the GNU General Public License. Therefore there are special exceptions to the terms and conditions of the GPLv2 as applied to these client libraries, which are identified and described in more detail in the FOSS License Exception at There are other conditions specified by Thinkingreed.