学園祭実行委員会と参加企画との間のコミュニケーションを支援するオープンソースウェブシステム。
PortalDots(ポータルドット)は、 学園祭実行委員会と参加企画担当者との間のコミュニケーションを支援するウェブシステム です。お知らせメールの一斉送信や各種申請の受付をオンラインで簡単に行うことができます。
開発は 東京理科大の学園祭実行委員経験者が主導するボランティア の開発チームによって行っています。また、オープンソース(MIT License)としており、無料・再配布自由としています。PortalDots は どなたでも開発に参加いただけます 。
※ 「ロリポップ!レンタルサーバー」や「コアサーバー」で PortalDots を利用する方法は PortalDots マニュアル に掲載しています。
※ もしご不明な点がありましたら、 PortalDots 公式 LINE アカウント または portal-dots at hrgrweb dot com (at と dot はそれぞれ @
と .
に置き換える)にてサポートいたします。お気軽にご連絡ください。
PortalDots には、登録ユーザーの管理や、お知らせ・配布資料ダウンロードファイルの登録を行うための「スタッフモード」があります。
また、スタッフモード内の各機能を利用できるユーザーを制限する「スタッフの権限設定」機能があります。管理者権限を有する「管理者ユーザー」は、PortalDots の全機能が利用できるほか、PortalDots のシステムに関する設定を変更することができます。
PortalDots 初回インストール時に作成するユーザーは管理者ユーザーとなります。
スタッフを追加することができるのは、 スタッフ・管理者ユーザー です。
管理者ユーザーを追加することができるのは、 管理者ユーザーのみ です。
※ セキュリティのため、管理者権限を割り当てるユーザーの人数は最小限にしてください。
「ユーザー種別」が「スタッフ」のユーザーは、「管理者」ユーザーに「スタッフの権限設定」を行ってもらうまで、スタッフモードの各種機能は利用できません。管理者ユーザーは、以下に記載の方法で、スタッフユーザーが各種機能を利用できるように設定してください。
※ セキュリティのため、各ユーザーが利用できる機能は最小限にしてください。例えば、企画情報の確認ができれば十分なユーザーには、企画の編集ができない「スタッフモード › 企画情報管理 › 閲覧」という権限を付与してください。
PortalDots 開発チーム(有志による個人開発チーム)
@
と .
に置き換える)PortalDots では、新規機能・既存機能改良の提案、バグの報告や Pull Request を歓迎します。
詳しくは コントリビューションガイドライン をご覧ください。
Git、PHP(8.0 以上)、Node.js、Yarn、Docker がセットアップ済みである必要があります。
セットアップが完了した後、以下のコマンドを順番に実行してください。
$ git clone git@github.com:portaldots/PortalDots.git
$ cd PortalDots/
# 必要な Node.js パッケージをインストール
# ※ エラーが表示される場合は、後述の *1 を参照してください
$ yarn install
# 開発環境を起動する
$ yarn docker
# Docker コンテナ内で必要な PHP パッケージをインストールし、設定ファイルを作成
$ yarn docker-shell
$ composer install
$ cp .env.example .env
$ php artisan key:generate
$ exit
# マイグレーション(データベースのセットアップ)
$ yarn migrate
# フロントエンド開発サーバーの起動
$ yarn dev
# → ブラウザで http://localhost にアクセスすると、PortalDots の開発環境が起動する
# → フロントエンド開発サーバーを終了するには Ctrl + C を押す
# 開発環境を停止する
$ yarn docker-stop
yarn install
実行時にエラーが表示される場合インストールされている Node.js のバージョンが古い場合、エラーが表示されることがあります。
Node.js を最新バージョンにアップグレードした上で、再度 yarn install
を実行してください。
yarn docker-stop
コマンドを実行してから yarn docker
コマンドを実行し、開発環境を再起動してください。db_portal_dev
※ スタッフ・管理者についての詳細は、前述の「スタッフモード・管理者権限について」を参照してください。
db_portal_dev
をクリックします。users
をクリックします。is_staff
列の 0
をダブルクリックし、 1
に書き換えて Enter キーを押します。is_staff
列と is_admin
列の両方について 0
をダブルクリックし、 1
に書き換えて Enter キーを押します。