traPtitech / traPtitech/Checkin

DEPLOY-NEOSHOWCASE.md の手順が、個人アカウントのフォークの 1 ブランチに依存している

Open
#67 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation
Dominant language
TypeScript
Stars
0
Forks
0
Avg merge
3d 5h
Merged PRs (30d)
7

Description

現状

DEPLOY-NEOSHOWCASE.md は、Jomon を個人アカウントのフォーク kaitoyama/Jomonlocal/checkin-dev-env ブランチからデプロイする手順になっている。2026-09-18 に grep -n 'kaitoyama/Jomon\|local/checkin-dev-env' DEPLOY-NEOSHOWCASE.md で確かめたところ、フォークとブランチへの参照が合わせて 9 行あった。うち 2 行は、そのブランチの個別のコミットのハッシュ値を挙げて「修正済み」と述べている。

このブランチに載っているものとして文書が挙げているのは、forward-auth の受け入れ、サービス間呼び出しの Bearer の受け口、Swift を使わない場合のファイル保存のフォールバックの 3 つである。

誰が何を誤るか

このフォークかブランチが消えると、Jomon 側に何が載っている必要があるのかを手順から辿れなくなる。文書に残るのは「このブランチを使う」という指示と、参照できなくなったコミットのハッシュ値だけで、必要な差分の中身は書かれていない。そうなると、上流の Jomon を使って同じ配備を再現しようとする人が、何を足せばよいか分からない。

フォークを使う判断そのものは妥当である。上流の Jomon をそのままデプロイすると、この 3 つが無いので Checkin との連携が成り立たない。この issue が扱うのは、依存先が消えたときに情報が失われることのほうである。

取りうる手

  • 必要な変更を上流へ出し、上流のブランチを指す手順に切り替える
  • フォークを traP の org の下に置き、個人アカウントの消滅に依存しないようにする
  • 必要な差分の中身(どのファイルに何を足すか)を DEPLOY-NEOSHOWCASE.md に文章で書き、リンクだけに依存しないようにする

直さずに残した理由

どれを採るかは Jomon 側の合意が要る。HANDOVER.md の「5. 残作業」の A も、本番に向けて残る Jomon 側の調整として Bearer の受け口を挙げており、この調整を上流へ出すかどうかがまだ決まっていない。

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with DEPLOY-NEOSHOWCASE.md and inspect the nine references to kaitoyama/Jomon and local/checkin-dev-env, then read section 5 of HANDOVER.md. Confirm the Jomon-side decision before changing the deployment instructions; done means the procedure no longer loses the required changes when the personal fork or branch disappears.

Written by the indexing model from the issue text.

Assessment

Tech stack
swift
Domain
devops, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.