OSS Calendar

OSS Calendarは企業で使うことを想定したオープンソースのカレンダーアプリです。

Motivation

企業内のスケジューラーは使いづらい部分が多くあります。
しかし、個人のGoogleカレンダーなどと連携させてしまうと情報管理が心配で、開発をしたくてもカレンダーアプリは費用が掛かりすぎてしまいます。

OSS Calendarは企業で使うことを想定したカレンダーアプリですので、以下のような機能を実現しています。

• チーム全員のスケジュールの可視化
• 素早いメンバーアサインの実現
• 通常のスケジューラーとしての利用

詳しくは公式サイトをご確認ください。
OSS Calendar

Features

• Laravel 5.8
• passport
• Vue + VueRouter + Vuex
• vuetify

開発環境

バックエンドの準備

docker-compose build
docker-compose up -d

クライアントサーバはnpm run devで稼働し、APIサーバはphp artisan serverで稼働させて開発します

• .env.sampleをコピーして.envファイルを作成する
• .envファイルにあるAPP_KEYを更新する。

docker ps
docker exec -it osscal-web bash

php artisan key:generate

• クライアントサーバとAPIサーバの.envファイルの設定例：

APP_URL=http://localhost
CLIENT_URL=http://localhost

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="シンキングリード"

※ 環境構築用のスクリプトを流す

composer install
php artisan optimize
php artisan migrate
php artisan db:seed
php artisan passport:install

• APIサーバのコマンド実行例：

$ php artisan optimize
※前回の設定ファイルのキャッシュの最適化のため

フロントエンドの準備

Dockerではなく、クライアント側で実行する

• クライアントのコマンド実行例：

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
※public/_nuxtフォルダに書き出される
※.envのAPP_URLとCLIENT_URLによって、.htaccessのRewriteBaseは自動設定される

• 同一サーバで稼働させる
  apacheのドキュメントルートをpublic/以下に設定し、稼働させる
  APIサーバには設定ファイルがキャッシュ化されているため、設定変更した場合は、php artisan optimizeコマンドを実行する。

Cronの設定

予定のメール通知を受け取るために、以下のスクリプトを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

License

GPLv3 Disclaimer

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.

OSS-Calendar FOSS License Exception

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.