세미프로젝트 : youwin - 음악중심소통 웹사이트

핵심 요약

본 문서는 국비지원 교육과정의 중간 점검 팀 프로젝트(YouWin Repository)를 총괄 리딩하며 적용한 애자일 칸반(Kanban) 작업 관리, Git Flow 브랜치 보호 전략, AI 기반 UI/UX 표준화 및 페어 프로그래밍, 그리고 신뢰 중심의 팀 그라운드 룰(Working Rules) 구축 사례를 정리한다.

단순한 코드 구현을 넘어, 팀원들이 순수 Java MVC 패턴의 CRUD 아키텍처와 JS 비동기 데이터 통신을 안정적으로 구현할 수 있도록 인프라/프론트엔드 장벽을 낮추고, 체계적인 협업 프로세스를 통해 성공적인 결과물을 도출한 실전 프로젝트 관리 방법론입니다.

1. 프로젝트 개요 및 리더십 아키텍처

┌─────────────────────────────────────────────────────────────────────────────┐
│                            Project Lead (PL)                                │
│  - 프로젝트 전반적 리딩, 아키텍처 설계 및 핵심 개념 멘토링                 │
│  - AI 페어 프로그래밍 기반 Vanilla HTML/CSS UI/UX 표준 템플릿 공급          │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │ (표준 UI 및 개발 가이드라인 공급)
        ┌──────────────────────────────┴──────────────────────────────┐
        ▼                                                             ▼
┌──────────────────────────────┐              ┌──────────────────────────────┐
│       Team Member A          │              │       Team Member B          │
│ - Java MVC 백엔드 비즈니스   │              │ - Vanilla JS 비동기 데이터   │
│   로직 및 CRUD 컨트롤러 구현 │              │   바인딩 및 API 연동 구현    │
└──────────────────────────────┘              └──────────────────────────────┘

1) 프로젝트 목적 및 배경

• 국비지원교육 중간 점검: 순수 Java 기반 MVC 패턴의 기본 구조를 이해하고, CRUD 비즈니스 로직 및 화면 구현 역량을 검증.
• 협업 및 딜리버리 역량 배양: 협업 툴(Git, GitHub, IntelliJ, Notion, Discord 등)을 실전처럼 활용하고, 발표 자료 작성 및 프리젠테이션 역량을 훈련.
• 오픈 소스 저장소: GitHub - rlaguswls13/youwin

2) 기술적 리딩 전략 (AI 기반 UI/UX 표준화)

• 프론트엔드 복잡도 제거: 초보 개발자가 백엔드와 프론트엔드 스타일링을 동시에 구현할 때 발생하는 병목을 해소하기 위해, PL이 AI 도구를 활용하여 바닐라 HTML/CSS 기반의 일관된 UI/UX 컴포넌트 및 레이아웃을 선제적으로 일반화·템플릿화하여 제공.
• 핵심 역량에 집중: 팀원들이 복잡한 CSS 퍼블리싱 스트레스에서 벗어나 Java MVC 백엔드 CRUD 로직 및 JavaScript 데이터 연동(Implementation)의 핵심 개념을 체득하는 데 온전히 집중할 수 있는 환경 조성.

2. 애자일 칸반(Kanban) 기반 작업 관리 체계

칸반보드는 복잡한 이슈 추적 도구(Jira, Slack 등)의 핵심 원리를 가볍고 직관적으로 적용하여 프로젝트의 흐름(Flow)과 병목(Bottleneck)을 실시간으로 가시화하는 최적의 도구이다.

[Backlog / Ready] ──> [In Progress] ──> [In Review / Test] ──> [Done]
  (일간/주간 등록)       (1인 1티켓 담당)      (로컬 충돌 해결 & 검증)     (main 병합 완료)

1) 티켓팅 및 작업 방식 (Task Management)

1. 일간/주간 단위 Task 일괄 등록: 스프린트 단위로 팀원 각자가 수행할 작업을 사전에 등록하고, 애자일 원칙에 따라 유연하게 수정·취소·생성.
2. 1인 1티켓(Single Ownership) 원칙:

• 티켓 추적의 혼선을 방지하기 위해 하나의 티켓은 1명의 담당자가 작성 ➔ 진행 ➔ 완료 로그 기록을 전담.
• 다수의 인원이 하나의 티켓에 얽혀 히스토리가 꼬이는 현상을 원천 방지.
• 부득이하게 복수 인원이 티켓을 공동 처리해야 할 경우, 작업 내역과 변경 사유에 대한 상세 로그(Log) 작성을 의무화.

1. 업무 범위 격리(Scope Guarding):

• 칸반 보드 내 논의는 프로젝트 범위(Scope) 내 작업에 한정.
• 외부 잡무나 프로젝트 무관 리소스가 칸반에 유입되어 우선순위와 일정을 왜곡하는 현상을 방지.

[작업방식]

{ image }이미지 불러오는 중

{ image }이미지 불러오는 중

3. 회의록 문서화 및 캘린더 일정 동기화

1) 회의록 기록 및 주기적 상태 점검

• 문서화 원칙: 모든 회의와 논의 사항은 정형화된 문서로 기록·저장하고 팀 전체에 투명하게 공유.
• 주간 작업 리포트(Weekly Report): 주간 단위로 실제 작업 진척도를 리포팅하여, 특정 팀원에게 작업이 쏠리는 병목(Workload Skew)을 조기에 감지하고 유연하게 일정을 재조정. [회의록 기록]

{ image }이미지 불러오는 중

{ image }이미지 불러오는 중

2) 캘린더 일정 공유와 프라이버시 보호

• 공적 일정 동기화: 미팅, 마일스톤 점검, 통합 테스트, 발표 리허설 등 공통 일정은 캘린더에 사전 등록하여 혼선 방지.
• 개인 일정의 스마트한 공유: 사생활 노출을 원치 않는 개인 일정은 세부 내용을 적지 않고 '개인 일정' 또는 '사적 일정'이라는 범주로만 캘린더에 표시 ➔ 팀 전체가 서로의 가용 시간(Capacity)을 한눈에 파악하여 합리적인 공통 일정을 수립할 수 있는 판단 지표로 활용. [캘린더 일정공유]

{ image }이미지 불러오는 중

4. 개발 협업 그라운드 룰 (Working Rules) & Git Flow

소스코드의 무결성을 유지하고 병합 충돌(Merge Conflict)로 인한 생산성 저하를 방지하기 위해 명확한 Git Flow 규칙을 수립·적용하였다.

   feature/name-a ─────┐
                       ▼ (로컬에서 충돌 해결 후 검증)
  main ────────────────●─────────────────────────────> (안정된 배포 브랜치)
                       ▲ (Direct Push 금지)
   feature/name-b ─────┘

1) Git Flow 브랜치 운영 수칙

5. 코어 타임 및 심리적 안전감(Psychological Safety) 기반 팀 문화

1) 집중 작업 기간 및 코어 타임(Core Time)

• 집중 몰입 기간: 7월 20일 ~ 7월 31일 (약 2주간의 스프린트)

• 평일 코어 타임 (월~목):

• 18:00 ~ 18:30: 석식 및 리프레시

• 18:30 ~ 21:00: 오프라인/온라인 집중 합동 작업

• 자율 퇴근제 도입: 당일 할당된 Task를 완료하고 추가 질의사항이 없는 팀원은 19:00~20:00에 자유롭게 퇴근할 수 있도록 보장하여 불필요한 눈치보기성 잔업 배제.

• 주말 온라인 헬프데스크 (토~일):

• 10:00 ~ 17:00: Discord 음성 채널 상시 오픈.

• 개발 중 막히는 블로커(Blocker) 발생 시 언제든 접속하여 실시간 화면 공유 및 질의응답 진행 (PL 상시 대기 및 페어 프로그래밍 지원).

2) 상호 존중과 신뢰 기반 커뮤니케이션

• 호칭 규정: 상호 간 친밀도에 따라 편한 사이는 '형', 공적인 자리나 어색한 관계에서는 반드시 '님'으로 호칭을 통일하여 심리적 안전감과 예의를 동시에 확보.
• 참여 및 일정 공유: 회의나 공동 작업 불참 시 당일이라도 사전 공유 원칙 준수. 벌칙이나 강제 규정 대신 '신뢰와 상호 예의'를 중심 가치로 두어 팀 결속력 유지.

6. 기술적 성과 및 교훈 (Retrospective)

1) 성공 요인 (Key Success Factors)

1. AI 페어 프로그래밍을 통한 프론트엔드 표준화: 초보 팀원들이 UI 퍼블리싱에 시간을 낭비하지 않고 Java MVC 백엔드 아키텍처 이해와 데이터 흐름 제어에 집중할 수 있었음.
2. 명확한 Single Ownership과 Git 규칙: 1인 1티켓 관리와 로컬 충돌 선해결 원칙 덕분에 코드 덮어쓰기나 브랜치 꼬임 사고 없이 안전하게 프로젝트 완주.
3. 유연한 코어 타임과 주말 디스코드 대기: 자율적인 조기 퇴근으로 동기를 부여하고, 주말 상시 대기실을 통해 초보 개발자들이 겪는 기술적 블로커를 신속히 해소.