Build Everything Project 1

관련 자료

GitHub Repository: https://github.com/studydev/buildflow

Dev Site: https://nexus.studydev.com/

1. 이 프로젝트를 왜 만들었나

Microsoft Azure 기반의 기술 워크샵과 학습 콘텐츠는 해마다 꾸준히 만들어지고 있지만, 실제 현장에서는 다음과 같은 문제가 반복되어 왔다.

• 좋은 워크샵 자료와 GitHub 레포지토리가 개인 또는 팀 단위로 흩어져 있음

• 누가 어떤 콘텐츠를 만들었고, 실제로 고객에게 전달해 본 경험이 있는지 알기 어려움

• 과거에 사용했던 워크샵 자료가 재사용되지 않고 다시 만들어지는 경우가 많음

• 고객 입장에서는 “어디서부터 무엇을 보면 되는지”를 스스로 판단하기 어려움

NexusSkill 프로젝트는 이런 문제를 해결하기 위해 시작되었다.
핵심 목표는 단순한 자료 저장소가 아니라,

Azure 기반 워크샵과 학습 콘텐츠를 하나의 흐름으로 연결하고,
누구나 쉽게 찾고, 이해하고, 실제로 실행할 수 있도록 만드는 플랫폼

을 만드는 것이다.

2. NexusSkill이 해결하고자 하는 문제

2.1 내부 관점 (Microsoft 엔지니어 / 파트너)

• GitHub 레포지토리, PPT/PDF, 영상, 워크샵 가이드를 한 곳에서 관리

• “이 콘텐츠를 누가 만들었는지 / 누가 실제로 실행해봤는지”가 명확히 보임

• 신규 엔지니어도 기존 자산을 빠르게 이해하고 활용 가능

• 워크샵 경험이 개인의 경험이 아니라 조직의 자산으로 축적됨

2.2 외부 관점 (고객 / 학습자)

• Azure 워크샵 콘텐츠를 검색 기반으로 탐색

• GitHub → 설명 → 데모 → 실습까지 이어지는 학습 흐름 제공

• 단순 문서가 아닌, 실제로 검증된 실습 중심 콘텐츠를 소비 가능

3. NexusSkill의 핵심 컨셉

NexusSkill은 다음과 같은 원칙을 중심으로 설계되었다.

3.1 GitHub 중심 (GitHub-first)

• 모든 콘텐츠의 출발점은 GitHub Repository

• README, 코드 구조, 릴리즈, 커밋 활동 등에서 메타데이터를 수집

• 단순 링크 수집이 아니라, 레포지토리를 “학습 콘텐츠”로 재해석

3.2 파이프라인 기반 (Pipeline-first)

• 모든 분석과 가공 작업은 비동기 파이프라인으로 처리

• 사용자 요청 → 파이프라인 실행 → 결과 축적 → 검색 인덱싱

• API는 제어(Control Plane)만 담당하고, 무거운 작업은 분리

3.3 AI 보조 (AI-enriched)

• GitHub 콘텐츠를 기반으로:

  • 요약

  • 카테고리 분류

  • 사용 기술 식별

  • 난이도 추정

• 장기적으로는 한글화, 썸네일 생성, 추천까지 확장

4. 전체 아키텍처 구성

4.1 Azure 기반 구성 개요

NexusSkill은 Azure-native 아키텍처를 기반으로 한다.

• Frontend

  • Azure Static Web Apps

  • 로그인 없이도 콘텐츠 탐색 가능

• Backend API

  • Azure Container Apps

  • 인증, 파이프라인 제어, 검색 API 제공

• Pipeline Execution

  • Azure Container Apps Jobs

  • GitHub 분석, AI 처리, 인덱싱을 비동기로 실행

• Message Queue

  • Azure Service Bus

  • 파이프라인 트리거 및 상태 이벤트 관리

• Data Store

  • Cosmos DB (NoSQL)

  • 원본 데이터와 가공된 메타데이터 분리 저장

• Search

  • Azure AI Search

  • 키워드 + 벡터 기반 하이브리드 검색

• Email

  • Azure Communication Services (Email)

  • OTP 기반 로그인 인증

5. 인증과 접근 방식

5.1 회원가입 없는 이메일 OTP 인증

NexusSkill은 전통적인 회원가입을 요구하지 않는다.

• 이메일 입력 → OTP 인증 → 로그인

• 비밀번호 저장 없음

• 개인정보 최소화 원칙 준수

5.2 역할 기반 접근

• 일반 사용자

  • 로그인 없이 콘텐츠 탐색 가능

• 로그인 사용자

  • 내부 전용 콘텐츠 열람

• 기여자(Contributor)

  • 콘텐츠 등록

  • GitHub 분석 파이프라인 실행

  • 워크샵 경험 라벨링

6. 콘텐츠 흐름 예시

1. GitHub 레포지토리 URL 등록

2. 분석 파이프라인 실행

   • README / 메타데이터 수집

   • 기술 스택 식별

3. AI 기반 요약 및 분류

4. 검색 인덱스 반영

5. 사용자에게 카드 형태로 노출

   • GitHub 링크

   • 데모 / 문서 / 영상 (있는 경우)

   • 난이도 / 예상 소요 시간

7. 이 프로젝트의 의미

NexusSkill은 단순한 웹 애플리케이션이 아니다.

• 워크샵 경험을 구조화하는 시도

• 개인의 지식을 조직의 학습 자산으로 전환

• Azure 기술을 실제로 “학습과 전달”에 적용한 사례

장기적으로는,

• 추천 기반 학습

• AI Assistant를 통한 워크샵 가이드

• 지속적인 콘텐츠 갱신과 확장

으로 발전할 수 있는 기반을 목표로 한다.

8. 마무리

NexusSkill은
“좋은 Azure 워크샵 콘텐츠는 이미 많다”는 전제에서 출발한다.

이 프로젝트의 가치는 새로운 콘텐츠를 만드는 것이 아니라,
이미 존재하는 자산을 연결하고, 이해하고, 다시 쓰게 만드는 것에 있다.

원하면 다음도 바로 만들어줄 수 있어:

• 🔹 Confluence용 한 장 요약(Executive Summary)

• 🔹 아키텍처 다이어그램(Confluence 매크로용)

• 🔹 워크샵 운영 시나리오 예시

• 🔹 FAQ 섹션 (임원/관리자 설명용)