Skip to content
This repository has been archived by the owner on Dec 2, 2022. It is now read-only.

Home

Jump to bottom
uplus edited this page Sep 15, 2019 · 24 revisions

起動方法

git clone https://github.com/ictsc/ictsc-score-server.git
cd ictsc-score-server
cp .env.sample .env
docker-compose pull
docker-compose up
docker-compose exec api rails db:setup

ポート

種類 ポート
API 8900
UI 8901
DB 8902
REDIS 8903

アクセス方法のサンプル

用途 URL
フロントエンド http://localhost:8901
API http://localhost:8900
API ログイン/ログアウト http://localhost:8900/api/sessions
API GraphQLエンドポイント http://localhost:8900/api/graphql

開発環境で用意されるユーザー

パスワードはユーザー名と同じ

権限 ユーザー名
staff staff
audience audience
player team a
player team b (a ~ brぐらいまである)

リポジトリ運用

試験的にgit-flowで運用する。
※PRを作る際、よく分からなければ適当にブランチを作ってPRを送って良い

git-flowを選んだ大まかな理由としては以下

  • スコアサーバは年一次予選・二次予選・本戦・予備校数回で利用する
  • リハーサル後は機能追加を止めたいけど開発は続けたいので、プロダクションブランチと開発ブランチを分けたい
  • リハーサル後もバグフィックはマージしたい

git-flowはサポートツールがあるので使うと少し運用が楽。

ツールインストール後にリポジトリのディレクトリに移動して以下を実行

git flow init -d
git config gitflow.prefix.versiontag v

UIを作る上で気をつけること

  1. 後でやろうはやらないフラグ
    • 後回しにするなら TODO: コメントかIssue化
  2. nilなのか0なのか
    • e.g. 未回答なら'---'と表示し、0点解答なら'0'と表示するべき
  3. JSでa.b.cの用にネストした値を扱う時、途中のオブジェクトがnilな可能性は無いか
    • Elvisオペレーターが欲しい...
  4. デフォルト値は最適か?
    • e.g. 質問一覧は状態によってフィルタできるようになっている。この場合デフォルトでは未解決と対応中のもののみ表示するべき
  5. 表示順序は最適か?
    • 並び順に意味があるなら、APIから取得した順ではなく必ず明示的にソートする
    • IDでソートしない
    • e.g. 解答一覧では解答を提出時間が古い順で並べるべき
  6. その値は決め打ちでいいのか?
    • e.g. 問題一覧ページの上部には採点遅延が20分と決め打ちでハードコートされていたが、これはAPIから取得できるようにするべき
  7. 文章入力中にリロードしても大丈夫か?
    • 解答入力中に誤ってリロードしたらショックで寝込むかもしれない
  8. 操作確認UIが無くて大丈夫か?
    • e.g. 削除時に「本当に削除しますか」
    • e.g. 解答送信前にプレビュー表示
Clone this wiki locally