KUCODE
Summary
수업과 개발을 연결하여 저장소만으로는 알기 어려운 교과목별 GitHub 활동을 파악할 수 있도록, 고려대학교 정보대학 학생들의 GitHub 계정을 학사 정보와 연결한 플랫폼을 구축했습니다. 교수와 조교가 교과목별 활동 현황을 분석하고 학생이 누적된 활동을 e-Profile과 포트폴리오 자료로 활용할 수 있게 한 프로젝트입니다.
- Role
- Project LeadPMFull-stack Developer
- Outcome
- 분석 대상 학생 1,018명저장소 9,095개연동된 개설 교과 30개
GitHub 활동이 수업 밖에서도 활용될 수 있도록
학생들이 작성한 코드와 협업 이력은 GitHub에 남습니다. 하지만 여러 저장소에 흩어진 활동을 수업별로 모아 보거나, 학생 한 명이 참여한 프로젝트와 기여 내용을 정리하기는 어려웠습니다. 교수와 조교는 교과목별로 학생들의 개발 활동을 확인하고, 학생은 그 이력을 자신의 포트폴리오에 활용할 수 있어야 했습니다.
이 요구를 바탕으로 고려대학교 정보대학 학생들의 GitHub 계정을 학사 정보와 연결하는 KUCODE를 구축했습니다. 교수와 조교는 교과목별 개발 활동을 분석하고, 학생은 자신의 활동을 e-Profile과 포트폴리오 자료로 활용할 수 있습니다. 저는 프로젝트를 총괄하며 Django와 Vue.js를 활용한 풀스택 개발과 운영 환경 구축을 맡았습니다.
| 항목 | 규모 | 집계 기준 |
|---|---|---|
| 분석 대상 학생 | 1,018명 | 학생 ID 기준 중복 제거 |
| 연결된 저장소 | 9,095개 | 학생 계정과 연결된 저장소 · 포크 포함 |
| 연동된 개설 교과 | 30개 | 5개 학기 · 분반 포함 |
학생 1,000여 명과 개설 교과 30개, 저장소 9,000여 개를 연결한 데이터 구조
수업별 GitHub 활동을 비교하려면 저장소와 학생 계정뿐 아니라 수강 정보도 함께 연결해야 했습니다. 같은 과목이라도 개설 연도와 학기, 분반에 따라 수강생과 프로젝트가 달라지기 때문입니다. 교과목, 수강 이력, 프로젝트 저장소를 각각 관리하고 서로 연결하여, 어떤 학생이 어느 수업에서 어떤 프로젝트에 참여했는지 확인할 수 있도록 데이터 구조를 설계했습니다.
학생의 개발 활동은 GitHub ID로 연결하고, 교과목은 개설 연도와 학기, 학수번호를 기준으로 구분했습니다. 학생과 교과목은 수강 이력으로, 교과목과 저장소는 프로젝트 정보로 연결하여, 여러 수업에 참여한 학생도 수업별 활동과 개인의 누적 활동을 구분해 조회할 수 있도록 했습니다.
팀 저장소의 전체 커밋 수를 그대로 보여주면 학생 개인의 기여를 구분하기 어렵습니다. 그래서 커밋과 PR, 이슈의 작성자와 저장소의 기여자 정보를 구분해 저장하고, e-Profile에서는 해당 학생의 활동을 보여줍니다. 학생이 소유한 저장소와 다른 사람의 저장소에 기여한 경험도 구분해 조회할 수 있습니다.
전체 재수집 대신, 변경된 저장소만 동기화
학생 계정에 연결된 저장소는 9,095개입니다. 매번 모든 활동을 다시 수집하면 변경되지 않은 데이터에도 API 호출과 갱신 작업을 반복하게 됩니다. 이를 줄이기 위해 저장소의 갱신 시점과 푸시 시점을 비교하여 수집 대상을 정합니다. 같은 소유자의 저장소 목록은 한 번의 동기화 안에서 재사용하여, 목록을 반복 조회하는 작업도 줄입니다.
다만 코드가 푸시되지 않아도 PR이나 이슈는 새로 등록되거나 상태가 바뀔 수 있습니다. 푸시 시점만 보고 수집 여부를 정하면 이런 활동을 놓칠 수 있어, 저장소 정보에 변화가 없더라도 PR과 이슈의 변경 여부를 별도로 확인합니다. 갱신할 내용이 있으면 해당 저장소를 수집 대상에 포함합니다.
변경 여부를 확인하는 API가 실패했다고 해서 실제 활동에 변화가 없다고 판단할 수는 없습니다. 그래서 확인에 실패한 저장소는 수집 대상에 남겨, 조회 오류만으로 활동을 놓치지 않도록 합니다. 전체 활동을 다시 수집하는 방식도 유지하며, 저장소와 SHA 조합의 유일성 제약으로 같은 커밋이 중복 저장되는 것을 막습니다.
저장소를 하나씩 열지 않아도 보이는 교과목별 GitHub 활동
교수와 조교가 저장소를 하나씩 열지 않아도 수업별 개발 활동을 파악할 수 있도록, 교과목별 수강생과 커밋, PR, 이슈, Star, 저장소 수를 한 화면에 모아 보여줍니다. 학사 정보와 개발 활동을 함께 조회하고, 통계 화면에서는 과목별, 학과별로 분석 범위를 바꿀 수 있습니다.
학생 명부 가져오기와 검색, 통계 내보내기도 제공하여 교과 운영 업무에 활용할 수 있도록 했습니다. 교과 관리에서는 학기별 개설 현황을 확인하고, 학생 분석에서는 수강 과목과 GitHub 활동을 함께 조회하여 학생이 어느 수업에서 어떤 활동에 참여했는지 살펴볼 수 있습니다.
화면을 열 때마다 GitHub에서 활동을 가져오면 외부 API 응답을 기다려야 하므로, 데이터 수집과 화면 조회를 분리했습니다. 분석 API는 DB에 저장된 활동을 조회합니다. 학생별 교과 분석에서는 수강 정보와 교과 정보를 미리 불러오고, 저장소는 GitHub ID별로, 프로젝트는 저장소 ID별로 묶어 재사용하여 학생과 과목마다 같은 정보를 반복 조회하는 작업을 줄였습니다.
수집한 GitHub 활동을 학생의 e-Profile과 포트폴리오로
교육 운영을 위해 수집한 GitHub 활동을 학생도 자신의 경험을 정리하는 데 활용할 수 있도록, 개인 e-Profile에서 제공합니다. 학생은 주요 사용 언어, 커밋, PR, 이슈, 활동 추이와 프로젝트 목록을 확인하고 자기소개와 기술 스택을 함께 정리할 수 있습니다.
학생은 교과 프로젝트와 자율 활동을 구분해 살펴보고, 포트폴리오 PDF에 담을 프로젝트를 직접 선택할 수 있습니다. 지원 분야나 설명하려는 경험에 맞게 프로젝트를 골라 포트폴리오 자료로 활용할 수 있도록 했습니다.
기획부터 개발, 운영까지 직접 맡은 KUCODE
프로젝트 총괄 겸 PM으로 개발계획과 화면설계의 요구사항을 정리하고, 풀스택 개발과 운영 환경 구축까지 맡았습니다. 학생의 개인 활동 정리와 교수, 조교의 교과 분석은 같은 GitHub 데이터를 활용하지만 조회 목적이 다르므로, 사용자별로 확인할 정보와 조회 기준을 구분하여 화면을 설계했습니다.
Django와 Vue.js로 서비스를 구현하고 PostgreSQL을 데이터베이스로 사용했으며, Nginx와 Gunicorn은 Docker Compose로 구성했습니다. 개발 중인 설정이나 데이터가 운영 환경에 섞이지 않도록 개발, 스테이징, 운영은 각각 별도의 Compose 프로젝트와 데이터 볼륨을 사용합니다.
KUCODE에는 5개 학기에 걸쳐 연동된 개설 교과 30개의 데이터가 쌓여 있습니다. 교수와 조교는 학사 정보와 GitHub 활동을 함께 보며 교과목별 개발 활동을 분석하고, 학생은 자신의 프로젝트 경험을 정리해 포트폴리오 자료로 활용할 수 있습니다.