Portfolio Hackerton: AI 기반 소프트웨어 엔지니어링 및 커리어 가이드

이 리포지토리는 취업을 위한 포트폴리오 제작 해커톤의 운영 및 교육 자료를 담고 있습니다. 대학생과 주니어 개발자가 생성형 AI를 활용하여 효율적으로 학습하고, 모던 소프트웨어 엔지니어링 원칙을 이해하며, 올바른 개발 습관을 형성하는 것을 돕습니다.

📂 주요 목차

1. 학습 및 커리어 가이드 (docs/)

• 생성형 AI 활용 전략: 챗GPT를 활용한 프로그래밍, 영어, 전공 학습 및 학습 동기 유지 전략 (해라체 버전).
• 모던 소프트웨어 엔지니어링: Dave Farley의 'Modern Software Engineering' 핵심 요약
  • Part 1: 엔지니어링이란 무엇인가?
  • Part 2: 복잡성을 관리하는 원칙
  • Part 3: 실천 및 엔지니어의 자세
• 프로젝트 배경 및 서사: 이 프로젝트가 시작된 배경과 목적에 대한 이야기.

2. 교육용 슬라이드 (slides/)

Marp를 활용하여 제작된 발표 자료입니다.

• 00-Motivation.md: 동기 부여 및 학습의 의의
• 01-Intro.md: 해커톤 및 과정 소개
• 02-AIDrivenStudy.md: AI를 활용한 학습 방법론
• 03-Habits.md: 실력 있는 개발자가 되기 위한 핵심 습관 설정

---

🛠 사용 방법

슬라이드 빌드 및 관리

본 리포지토리는 Marp CLI와 Makefile을 사용하여 마크다운 슬라이드를 HTML 및 PPTX 형식으로 변환합니다.

사전 준비

npm install

주요 명령어

• 모든 슬라이드 빌드: make all (HTML, PPTX 생성)
• 특정 슬라이드 빌드: make slide NAME=03-Habits
• 실시간 미리보기: make preview NAME=03-Habits
• 변경 사항 감시 및 자동 빌드: make watch
• 생성된 파일 삭제: make clean

결과물은 slides/output/ 디렉토리에 저장됩니다.

포트폴리오 테이블 생성

CSV 파일에서 참가자 정보를 읽어 GitHub 리포지토리 및 GitHub Pages 정보를 자동으로 조회하여 마크다운 테이블을 생성합니다.

사전 준비

• Python 3.x
• GitHub CLI (gh) 설치 및 인증

주요 명령어

# 기본 실행 (attendee.csv, 2025-12-22 이후 생성된 리포지토리)
make portfolio

# 다른 CSV 파일 사용
make portfolio CSV_FILE=data/attendees.csv

# 다른 시작 날짜 지정
make portfolio START_DATE=2025-12-20

# 파일로 출력
make portfolio PORTFOLIO_OUTPUT=portfolio_table.md

직접 스크립트 실행

python3 scripts/generate_portfolio_table.py attendee.csv 2025-12-22
python3 scripts/generate_portfolio_table.py attendee.csv 2025-12-22 -o output.md

---

🚀 목표

1. AI Native 학습: 생성형 AI를 도구가 아닌 멘토로 활용하는 능력 배양
2. 엔지니어링 사고: 단순히 코드를 짜는 것을 넘어, 과학적 방법론에 기반한 엔지니어링 원칙 습득
3. 지속 가능한 습관: 장기적으로 성장할 수 있는 일일 루틴 및 집중 환경 구축

---

👥 해커톤 참가자 및 포트폴리오

2025년 12월 22일 해커톤에 참가한 학생들의 GitHub 계정 및 포트폴리오 리포지토리 목록입니다.

GitHub ID	이름	포트폴리오 리포지토리	GitHub Pages
Seogaeun03	서가은	ai_project, calculator-demo, Java-Solution, The_Corporate_Shield	The_Corporate_Shield
baobabkim	김도현	apply-demo-1, apply-demo-2, calculaton-demo	apply-demo-2, calculaton-demo
minjae-488	서민재	-, baseball, baseball2, carculator_demo, hanwhalinup, lab-homepage, MARK-1, OmniSeller-Desk, WinnerLens	-, baseball2, carculator_demo, hanwhalinup, lab-homepage, MARK-1, OmniSeller-Desk
nohyujin	노유진	calculator, calculator-app, edu, hrd-skill-gap-analysis, LnS, new, second	calculator, calculator-app, edu, LnS, second
chp2	박창훈	Calculator-demo, demo1, Five-in-a-row, NovelMate	Calculator-demo, demo1, Five-in-a-row
yeneua	김예나	calculator, toss-apply-demo	calculator, toss-apply-demo
DongKim2	김동환	black_scholes-model, cal1, calculator-demo, CAMP-2025_winter, CAMP_P_R_repository, TASKS.md	CAMP_P_R_repository
lsm427654-source	임선민	calculating, ERP, upstages, VAT	calculating, ERP, VAT
Jee-Seung	한지승	Demo-Calculator, project_1, test	Demo-Calculator
junhachoe61-dotcom	최준하	calculator-demo, data, Data-Enginnering, Data_pipeline, subway_flow	calculator-demo, data
2215836-netizen	김희윤	calculator-demo, hyundai_fta_simulator, LogicHR, scientific-calculator, upstage-apply-demo	calculator-demo, upstage-apply-demo
hennessynlove7552	이현주	calculator, commodity-tracker, engineering-calculator, newproject	commodity-tracker, newproject
kwang-min13	남광민	Airflow_practice	-
jinseungwook	진승욱	busanbank, calculate, DACON	busanbank, calculate, DACON
ldw188918-hue	이동욱	Calculator, calculator-demo, Dong-Uk, Project, upstage-demo	Calculator, Dong-Uk, Project
ts6nqswnr8-sudo	김채린	calculator-demo, DB-, RProject, UpstageDemo	-
CSY-333	진시우	calculator-demo, Crowling, Generative-Multi-Agent-Sitcom-Simulator, GPR, naver_pension_crawler, pension-research-dashboard	calculator-demo, Generative-Multi-Agent-Sitcom-Simulator, pension-research-dashboard
hamjang	함승훈	Industry-Specific-RFM-Weighting, Intermittent-Demand-Optimiation, OCR-Triplet-Extractor, OntoGraphRAG-CoT	-
chlsuun	서민재	calculiator-demo, calculiator-demo-, test	calculiator-demo-, test
tlstn3172	이세현	brick-break-demo, calculator-demo, earthworm-game-demo, national-pension-demo, steam-discount-demo, upstage-apply-demo, weather-forecaster-demo	brick-break-demo, calculator-demo, earthworm-game-demo, national-pension-demo, steam-discount-demo, weather-forecaster-demo
JoGiJun	조기준	---, calculator-demo, stat-stat, stat-stat_v2	calculator-demo, stat-stat
yonghwan-ko02	고용환	calculator-demo, Project, project01	calculator-demo, Project
ShinEunJi58	신은지	Busan-NSR-Navigator, calculator-demo, upstage-apply-demo	Busan-NSR-Navigator, calculator-demo, upstage-apply-demo
Bsagom	배성환	Calculator-Demo, demo, Demo2, football-demo	Calculator-Demo, Demo2, football-demo
megaTRX	최대영	arduino, calculator, Embedded-Portfolio, PCB-design, upstage-apply-demo	calculator, upstage-apply-demo
2216259-ctrl	조은수	calculator-demo, PomodoroTimer-demo, upstage-apply-demo	calculator-demo, PomodoroTimer-demo, upstage-apply-demo
hyeonz673	황현지	calculator-demo, legal-chatbot, Local-Legal-Insight, RAG	legal-chatbot
sansammm	김이진	calculcator-demo, calculcator-demo-2, upstage-apply-demo	calculcator-demo-2
HoSeongRyu23	류호성	1rm-calculator-demo, calculator-demo, demo, demo2, rhs-demo, ryu-demo	1rm-calculator-demo, calculator-demo, demo2

참고:

• 위 리포지토리들은 2025년 12월 22일 이후 생성된 해커톤 포트폴리오 프로젝트입니다.
• GitHub Pages 링크는 has_pages: true로 설정된 리포지토리를 기준으로 작성되었습니다.