Read Original
#Backend

기술이 없던 곳에 기술 더하기: 사내 해커톤 플랫폼 만들기

기술이 없던 곳에 기술 더하기: 사내 해커톤 플랫폼 만들기
01

Summary

코딩 한 줄 모르던 DR 담당자가 AI와 함께 사내 해커톤 플랫폼을 직접 배포하기까지

우아한형제들의 '우아톤' 운영 프로세스를 자동화한 AI 기반 풀스택 개발기

매년 진행되는 사내 해커톤의 운영 리소스 부족 문제를 해결하기 위해, 비개발자인 DR 담당자가 생성형 AI를 활용하여 직접 플랫폼 개발에 도전했습니다. 단순한 파일 취합 화면에서 시작해 Spring Boot 백엔드, 공유 DB, AWS Bedrock 연동 및 배포 환경까지 구축한 전 과정을 생생하게 공유합니다. 특히 AI로 디자인 시안을 코드에 오차 없이 완벽하게 옮기기 위해 터득한 프롬프트 작성 노하우와 협업 팁을 전수합니다.

  • 01비개발자가 Claude와 Claude Code를 적극 활용해 392개의 실제 커밋을 남기며 웹 서비스를 직접 빌드함
  • 02Python 기반 프로토타입에서 사내 표준인 Kotlin 및 Spring Boot 백엔드로 빠르게 마이그레이션
  • 03서버 간 로그인 유지(세션 동기화)를 위해 SQLite에서 MySQL 공유 데이터베이스로 시스템 구조 전환
  • 04AWS Bedrock SDK의 기본 서명 방식을 우회하고 Bearer 토큰 인증 방식을 사내 가이드에 맞춰 커스텀 구현
  • 05디자인 값의 근사치 오류를 극복하기 위해 Hex 코드와 px 단위를 강제하는 '비슷하게 금지' 지침서 활용법 정립

RECOMMENDATION

AI 도구를 활용해 아이디어를 빠르게 프로토타이핑하고 실제 서비스로 배포하고 싶은 비개발자 직군이나, AI 어시스턴트(Claude Code)와의 효율적인 협업 워크플로우를 구축하고자 하는 개발자들에게 적극 추천합니다.

The Problem

참가 규모가 역대 최대(36개 팀, 153명)로 늘어난 사내 해커톤에서, 한정된 운영 인력과 단축된 행사 시간 내에 결과물을 취합하고 심사를 집계하는 과정을 수작업으로 진행해야 하는 실수가 일어날 위험과 운영 부담이 존재했습니다.

The Solution

비개발자 운영자가 Claude 등의 AI 도구를 활용하여 Kotlin, Spring Boot 기반의 백엔드와 MySQL 공유 DB를 구축하고, AWS Bedrock을 연동한 사내 배포 시스템을 통해 자동화된 해커톤 운영 및 심사 플랫폼을 직접 제작했습니다.

The Result

데이터 취합과 전송이 자동화되어 예선 15분, 결선 10분이라는 극단적인 제한 시간 내에 완벽하게 심사를 마칠 수 있었으며, 행사가 끝난 뒤 프로젝트 라운지를 통한 온라인 전시까지 성공적으로 운영되었습니다.

Trade-off

AI 도움으로 전체 코드의 95% 이상을 빠르게 작성했으나, 반응형 화면 대응, 미세한 UI 오차, 브라우저 축소 비율 오류 등 디테일한 마지막 5%의 완성도를 잡기 위해 수십 번의 수동 커밋과 리소스가 추가로 소요되었습니다.

03

Key Concepts

Concept · 01

Claude Code

터미널 환경에서 직접 실행되어 파일 생성, 수정, 커밋, 푸시 등 개발 전반의 워크플로우를 대화형으로 수행할 수 있는 AI 기반 명령줄 도구입니다.

  • IntelliJ 통합 터미널에서 Claude Code를 직접 호출하여 코드 구현 및 원격 저장소 푸시까지 원스톱으로 처리하는 환경을 구축했습니다.
Concept · 02

Bearer 토큰 인증

API 요청 시 HTTP Authorization 헤더에 토큰을 포함하여 클라이언트의 권한을 증명하는 인증 체계입니다.

  • 기본 서명 인증을 시도하는 AWS Bedrock SDK의 동작을 정지시키고, 사내 표준 게이트웨이 사양에 맞춘 Bearer 토큰 인증 헤더를 수동으로 삽입하여 API 요청을 성공시켰습니다.
Concept · 03

Handoff 디자인

디자이너가 작성한 UI 시안을 개발자가 코드로 손쉽게 변환할 수 있도록 스타일 가이드, 치수(px), 색상값(Hex) 등의 상세 자산을 자동으로 추출해 전달하는 워크플로우입니다.

  • Claude Design의 handoff 링크와 정확한 수치 준수를 명령하는 HTML 지침서를 AI에게 함께 전달함으로써 디자인과 코드의 시각적 불일치를 완전히 해결했습니다.