{"id":26541398,"url":"https://github.com/traptitech/rucq-ui","last_synced_at":"2026-04-11T13:34:35.935Z","repository":{"id":283589613,"uuid":"952254395","full_name":"traPtitech/rucQ-UI","owner":"traPtitech","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-21T02:19:30.000Z","size":174,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-21T03:24:57.014Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/traPtitech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-21T01:31:04.000Z","updated_at":"2025-03-21T02:19:33.000Z","dependencies_parsed_at":"2025-03-21T03:35:18.280Z","dependency_job_id":null,"html_url":"https://github.com/traPtitech/rucQ-UI","commit_stats":null,"previous_names":["traptitech/rucq-ui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traPtitech%2FrucQ-UI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traPtitech%2FrucQ-UI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traPtitech%2FrucQ-UI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traPtitech%2FrucQ-UI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/traPtitech","download_url":"https://codeload.github.com/traPtitech/rucQ-UI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244893481,"owners_count":20527603,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-22T01:31:57.796Z","updated_at":"2026-04-11T13:34:35.924Z","avatar_url":"https://github.com/traPtitech.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rucQ-UI\n\n- サーバー：[traPtitech/rucQ](https://github.com/traPtitech/rucQ)\n- ユーザー向けクライアント：here\n- Admin 向けクライアント：[traPtitech/rucQ-Admin](https://github.com/traPtitech/rucQ-Admin)\n\n## 準備\n\n[Web エンジニアになろう講習会](https://traptitech.github.io/naro-text/chapter1/) に従って環境構築をした場合、fnm（Node.js のバージョン管理ツール）が手元にあるはず\n1. リポジトリルートをターミナルで開いて `fnm use --install-if-missing` を実行\n2. `node -v` を実行して `v22.22.0` と表示されることを確認\n3. `corepack enable \u0026\u0026 pnpm -v` を実行して `10.28.2` と表示されることを確認\n\n## 起動\n\n`pnpm i` でフロントエンドの起動に必要な Node モジュールをインストールしてください。\n\n### MSW の Mock API を使う方法\n\nクライアントからの HTTP リクエストを遮断して仮のレスポンスを返す MockServiceWorker を起動します。\n\n1. フロントエンドを起動 `pnpm dev:msw`\n2. \u003chttp://localhost:5173\u003e にアクセス\n\n起動は不安定であり、とくに初回は 2, 3 回のリロードを必要とする場合があります。\n\n### Staging / Production API を使う方法\n\n開発環境から Staging API（\u003chttps://rucq-dev.trapti.tech/api\u003e）または Production API（\u003chttps://rucq.trap.jp/api\u003e）にアクセスします。traQ 認証を突破するために Cookie をコピーしてくる必要があります。\n\n**注意: 本番環境は実際のデータを使用しているため、閲覧以外の操作はなるべく行わないでください。データが実際に書き換わります。**\n\n1. [Staging](https://rucq-dev.trapti.tech/api/me) または [Production](https://rucq.trap.jp/api/me) にアクセスする\n2. DevTool のアプリケーションタブを開き、Cookie 一覧から `_forward_auth` の値を取得する\n3. 空のテキストファイル `.env.local` をルートに作成して以下の内容を書き込む\n   ```sh\n   STAGING_COOKIE=\"_forward_auth=xxxx\" # Staging 用\n   PRODUCTION_COOKIE=\"_forward_auth=xxxx\" # Production 用\n   ```\n   ※ `_forward_auth=` から始まる値をそのまま貼り付けてください。\n\n4. フロントエンドを起動\n   - Staging: `pnpm dev:staging`\n   - Production: `pnpm dev:prod`\n5. \u003chttp://localhost:5173\u003e にアクセス\n\n### ビルドとプレビュー（オフライン動作の確認）\n\nビルドしてプレビューすることで、Service Worker（PWA）を含む本番相当の挙動を確認できます。特に**オフライン時の挙動**を確認したい場合はこの手順を行ってください。\n\n1. ビルドする\n   `pnpm build`\n2. プレビューを起動\n   - Staging: `pnpm preview:staging`\n   - Production: `pnpm preview:prod`\n3. \u003chttp://localhost:4173\u003e にアクセス（ポート番号が 5173 ではない点に注意）\n\n### ローカルでバックエンドを起動する方法\n\nとくに必要がなければ基本的に Mock API または Staging API を使用してください。\n\n1. バックエンドをローカルで起動 `docker compose up --build`\n2. rucQ-Admin（\u003chttp://localhost:3003\u003e）から @traq を合宿係に追加\n3. rucQ-Admin 上で合宿を作成して下書き設定を解除し、参加登録を受け付ける\n4. フロントエンドを起動 `pnpm dev`\n5. \u003chttp://localhost:5173\u003e にアクセス\n\nバックエンドをローカルに立てると自動で traQ も立ち上がります。@traq はデフォルトで traQ に存在するユーザーアカウントです。\n\n## API スキーマの更新\n\nAPI の型定義 [schema.d.ts](./src/api/schema.d.ts) はバックエンド [rucQ](https://github.com/traPtitech/rucQ) の openapi.yaml から自動生成されます。もし openapi.yaml に更新があれば、`pnpm generate:api` を実行して schema.d.ts を再生成してください。\n\n## リリース\n\n現状は以下の手順でやっています。\n\n1. main から `release/v1.X.X` という名前でブランチを生やす\n2. その中で package.json のバージョンを書き換えて `release v1.X.X` という名前でコミット\n3. main に対して PR を出してマージ\n4. GitHub の UI 上でリリースを打つ。Generate release notes ボタンを押してリリース概要を自動生成\n5. [manifest](https://github.com/traPtitech/manifest/pulls) からリリース用の PR（自動で立てられる）を探す\n6. 自分にレビューをリクエストし、Approve、マージ\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraptitech%2Frucq-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftraptitech%2Frucq-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraptitech%2Frucq-ui/lists"}