Projects 보드 연결, 필드 매핑과 실제 업무 등록
내용 검토 · 2026-10-12
이 안내에서 찾기 · 3
1. 보드 만들고 주소 복사
GitHub 조직 페이지 → Projects → New project → Table 또는 Board → 이름 입력 → Create project. 기존 보드는 Projects 목록에서 이름을 클릭합니다.
보드를 실제로 연 주소 https://github.com/orgs/조직/projects/번호 를 복사합니다. 저장소의 /projects 주소는 보드 목록이므로 사용하지 않습니다.
플랫폼 연구업무 → 연결 보드 → GitHub Projects 연결 추가를 누르면 GitHub / Projects 보드가 미리 선택됩니다. 연결 이름과 보드 주소를 입력하고 보드에서 수집할 저장소에는 owner/repository를 입력합니다. 과제·프로젝트별 보드는 하나이며, 다른 보드로 바꾸려면 기존 연결을 편집하거나 중지하세요.
2. 보드 권한과 저장소 권한
GitHub 프로필 → Settings → Developer settings → Personal access tokens에서 조직 소유의 Fine-grained token을 만듭니다. Repository access에 대상 저장소를 선택하고 Contents 읽기, Issues 읽기/쓰기(업무 생성·수정 시)를 설정합니다. Organization permissions → Projects를 읽기 또는 업무 변경 시 읽기/쓰기로 설정합니다. 조직 승인 정책이 있으면 승인을 받습니다.
사용 계정/보드에서 Fine-grained token이 지원되지 않는 경우 공식 Projects API 안내에 따라 classic token의 read:project(읽기) 또는 project(쓰기), 비공개 저장소에는 repo 범위를 사용합니다. 조직 SSO가 있으면 해당 토큰의 Configure SSO도 승인해야 합니다.
토큰을 플랫폼 연결의 읽기 토큰 칸에 입력합니다. 이 칸의 토큰으로 명시적 업무 생성/수정도 수행하므로 쓰기 기능을 사용할 때는 위 쓰기 권한이 필요합니다.
3. 열 연결과 업무 생성
연결 저장 → 지금 수집 → 연구업무 → 연결 보드를 엽니다. 필드 연결 설정에서 Status를 진행 상태에, Due date를 기한에, Priority를 우선순위에 연결하고 저장합니다. 이 설정은 플랫폼의 표시·집계 기준만 바꿉니다.
GitHub 보드에 날짜 열이 없다면 Table → 오른쪽 + → New field → 이름 Due date → Field type Date → Save. 플랫폼에서 다시 수집하면 선택 목록에 나타납니다.
업무 생성 → 제목·내용 입력 → Status에서 Todo/In progress 등 선택 → 기한·우선순위·담당 연구원 지정 → GitHub 원본 반영 확인 → 저장. 저장소 Issue 생성 후 보드 추가와 필드 값 반영을 실행합니다. 담당자는 프로필 GitHub 아이디가 필요하고 GitHub에서 해당 이슈에 배정 가능한 사용자여야 합니다.
결과 확인 필요가 나오면 생성된 GitHub 업무 링크를 먼저 열어 중복을 확인하세요. 앱은 결과가 불확실한 생성 요청을 자동 재실행하지 않습니다.