DaleStudy / DaleStudy/dalestudy.com

달레 스터디 전체 서비스의 배포 지도 작성

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

Nobody has claimed this yet.

documentation help wanted
Dominant language
TypeScript
Stars
3
Forks
3
Avg merge
22h 40m
Merged PRs (30d)
4

Description

배경

달레 스터디 org에는 저장소가 21개 있고 그중 여러 개가 실제 서비스로 배포되어 있습니다. 그런데 어떤 서비스가 어디에 배포되는지 정리된 문서가 없습니다. 지금은 저장소 About 링크와 각자의 기억에 의존하고 있는데, 둘 다 낡아 있습니다.

실제로 최근 다음 문제들이 확인됐습니다.

  • graphql 저장소의 About 링크가 옛 Fly 주소를 가리키고 있었고, 그 옛 배포가 아직 살아서 응답하는 바람에 이전이 안 된 것으로 오판하기 쉬운 상태였습니다
  • graphqlgithub 두 저장소의 About 링크가 서로 뒤바뀐 것으로 보입니다
  • leaderboard가 의존하는 GraphQL 엔드포인트가 응답하지 않는데, 이를 감지할 방법이 없었습니다
  • dalestudy.comgraphql서로 다른 Cloudflare 계정에 배포되어 있습니다

낡은 정보와 살아 있는 옛 인프라가 겹치면 잘못된 결론에 확신까지 붙습니다. 새로 합류하는 사람은 물론이고 기존 멤버도 같은 함정에 빠집니다.

목표

각 서비스가 어디에 배포되고, 누가 접근 권한을 갖고, 무엇에 의존하는지를 한 페이지로 정리합니다.

작업 범위

1. 인벤토리 수집

각 저장소에 대해 다음을 확인합니다.

  • 배포 도메인 (커스텀 도메인 / *.workers.dev / 기타)
  • 호스팅 (Cloudflare Workers / Containers / Pages / 그 외)
  • Cloudflare 계정 (org 계정인지 개인 계정인지)
  • 배포 방식 (Workers Builds / GitHub Actions / 수동 wrangler deploy)
  • 의존하는 다른 내부 서비스
  • 현재 살아 있는지

2. 실제 상태 검증

문서나 About 링크를 믿지 말고 각 도메인에 직접 요청을 보내 확인합니다. 응답 헤더의 server 값으로 호스팅 제공자를 구분할 수 있습니다.

3. 불일치 목록화

낡은 About 링크, 실제와 다른 문서, 아무도 참조하지 않는 배포 등을 목록으로 만듭니다. 고치는 것은 이 이슈의 범위가 아닙니다 — 발견하고 기록하는 것까지입니다.

4. 문서 작성 및 위치 결정

문서를 어디에 둘지도 함께 정해 주세요. 후보는 다음과 같습니다.

  • DaleStudy/.github의 org 프로필 README — 가장 눈에 띄는 위치
  • DaleStudy/DaleStudy (운영 저장소) — 성격상 가장 맞는 위치
  • 각 저장소 README에 배포 정보를 적고 지도는 링크만 모으는 방식

5. 갱신 방법 제안

수동 문서는 반드시 낡습니다. 일부라도 자동화할 수 있는지 검토해 주세요. 예를 들어 각 도메인의 응답을 주기적으로 확인해 문서와 다르면 알리는 워크플로우 같은 것입니다.

착수 자료 (이미 확인된 내용)

아래는 사전 조사에서 확인한 것입니다. 검증 없이 그대로 믿지 말고 다시 확인해 주세요. 조사 시점 이후 바뀌었을 수 있습니다.

도메인 응답 확인 결과
도메인 응답 비고
beta.dalestudy.com Cloudflare 이 저장소
leaderboard.dalestudy.com Cloudflare 정적 셸은 정상 응답
chat.dalestudy.com Cloudflare
schedule.dalestudy.com Cloudflare
leetcode.dalestudy.com Cloudflare
www.daleui.com Cloudflare
github.dalestudy.com Cloudflare (405) /, /graphql, /api/graphql 모두 {"error":"Not found"}
dalestudy.fly.dev Fly 살아 있으나 org 코드에서 참조하는 곳이 없음
graphql.daleseo.workers.dev 무응답 60초 타임아웃. leaderboard가 의존
graphql.dalestudy.com DNS 없음 커스텀 도메인 미설정
저장소 About 링크 중 낡아 보이는 것
저장소 현재 About 문제
github graphql.daleseo.workers.dev graphql 저장소의 주소로 보임
mcp dalemcp.fly.dev/mcp Fly 주소. 저장소는 2025-08 이후 갱신 없음
homepage www.dalestudy.com 신규 사이트가 beta에서 준비 중
leetcode-study www.dalestudy.com 위와 동일
daleui.com / daleui daleui.com / www.daleui.com www 유무 불일치
확인된 의존 관계
  • leaderboardgraphql : src/api/infra/gitHub/gitHubClient.ts에 엔드포인트가 하드코딩되어 있습니다 (환경변수 아님)

주의

살아 있는 배포를 임의로 종료하지 마세요. 참조가 없어 보여도 실제로 쓰이고 있을 수 있습니다. 정리 대상으로 판단되면 이 이슈에 기록만 하고 별도 이슈로 논의합니다.

완료 기준

  • 배포되는 모든 서비스가 표에 들어 있다
  • 각 항목이 실제 요청으로 검증됐다
  • 발견된 불일치가 목록으로 정리됐다
  • 문서 위치가 정해지고 실제로 커밋됐다
  • 갱신 방법에 대한 제안이 포함됐다

참고

이 이슈는 dalestudy.com 저장소에 있지만 범위는 org 전체입니다. 문서 위치가 정해지면 그쪽으로 옮기거나 링크를 연결해 주세요.

Contributor guide

Open the contributing guide

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 by inventorying the 21 organization repositories and rechecking each listed domain with direct requests. Inspect src/api/infra/gitHub/gitHubClient.ts in leaderboard for the GraphQL dependency, then choose and update a documentation location. Done means every deployed service is verified in a map, discrepancies are recorded, and a maintenance or alerting proposal is included.

Written by the indexing model from the issue text.

Assessment

Tech stack
github-actions, typescript
Domain
cloud, devops, documentation, infrastructure
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.