강원대학교(KNU) AI 부트캠프 최종 프로젝트 제출 리포지토리입니다.
이 리포지토리는 강원대학교 부트캠프 참가자들의 최종 프로젝트를 관리하고 제출하기 위한 공식 공간입니다. 모든 팀은 독립적인 프로젝트 디렉토리에서 작업하며, 아래 가이드라인을 따라 프로젝트를 제출합니다.
knu-bootcamp-projects/
├── README.md # 본 문서
├── projects/ # 모든 팀 프로젝트가 위치하는 디렉토리
│ ├── knu-bootcamp-template/ # 프로젝트 템플릿 (참고용)
│ └── [팀명]/ # 각 팀의 프로젝트 디렉토리
└── example_directory.md # 프로젝트 구조 참고 문서
projects/ 디렉토리 하위에 팀명으로 신규 디렉토리를 생성합니다.
규칙:
- 디렉토리명은 영문 소문자 사용
- 공백 대신 하이픈(
-) 사용 - 예시:
projects/team-1-financial-agent/
모든 프로젝트 관련 파일은 팀 디렉토리 내부에 위치해야 합니다.
주의사항:
- 소스 코드, 문서, 설정 파일 등 모든 산출물 포함
- 다른 팀 디렉토리 수정 금지 (Merge Conflict 방지)
- 기술 스택 및 배포 방식은 자유롭게 선택 가능
각 팀 디렉토리에는 반드시 README.md 파일이 포함되어야 합니다.
필수 포함 항목:
- 프로젝트 이름
- 팀원 소개
- 프로젝트 개요 및 목적
- 주요 기능
- 기술 스택 및 아키텍처
- 설치 및 실행 방법
- 데모 또는 스크린샷 (선택사항)
projects/knu-bootcamp-template/ 디렉토리에서 프로젝트 구조 템플릿을 제공합니다.
knu-bootcamp-template/
├── app/
│ ├── agents/ # AI 에이전트 로직
│ │ └── subgraphs/ # 에이전트 서브그래프
│ ├── api/ # API 라우터
│ │ └── route/ # API 엔드포인트
│ ├── core/ # 핵심 설정 (DB, LLM, Logger 등)
│ ├── models/ # 데이터 모델
│ │ ├── entities/ # 도메인 엔티티
│ │ └── schemas/ # API 스키마 (Pydantic)
│ ├── repository/ # 데이터 액세스 계층
│ │ ├── client/ # 외부 클라이언트
│ │ └── vector/ # 벡터 DB 레포지토리
│ └── service/ # 비즈니스 로직
│ └── agents/ # 에이전트별 서비스
├── docs/ # 문서
└── frontend/ # 프론트엔드 (Streamlit 등)
활용 방법:
- 템플릿을 복사하여 프로젝트 시작
- 필요에 따라 구조 수정 가능
- 프로젝트 요구사항에 맞게 커스터마이징
각 팀은 아래 템플릿을 참고하여 README.md를 작성하세요.
# [프로젝트 이름]
> 프로젝트 한 줄 설명
## 팀원 소개
| 이름 | 역할 | GitHub |
|------|------|--------|
| 홍길동 | Backend | [@gildong](https://github.com/gildong) |
| 김영희 | Frontend | [@younghee](https://github.com/younghee) |
## 프로젝트 개요
프로젝트의 목적과 배경을 설명합니다.
### 주요 기능
- 기능 1: 설명
- 기능 2: 설명
- 기능 3: 설명
## 기술 스택
### Backend
- Python 3.11+
- FastAPI
- LangGraph
### Frontend
- Streamlit / React
### AI/ML
- Upstage Solar LLM
- LangChain
- ChromaDB
### Infrastructure
- Docker
- ...
## 아키텍처
\```
[아키텍처 다이어그램 또는 설명]
\```
## 설치 및 실행
### 요구사항
- Python 3.11 이상
- ...
### 설치
\```bash
# 레포지토리 클론
git clone [repository-url]
cd [project-directory]
# 의존성 설치
pip install -r requirements.txt
# 환경 변수 설정
cp .env.example .env
# .env 파일 수정
\```
### 실행
\```bash
# 서버 실행
python main.py
# 또는
uvicorn main:app --reload
\```
## 데모
[스크린샷 또는 데모 영상 링크]
## 라이센스
MIT License- Fork: 본 리포지토리를 본인 계정으로 Fork
- Clone: Fork한 리포지토리를 로컬로 Clone
- Branch: 새로운 브랜치 생성 (
feature/team-name) - Commit: 프로젝트 작업 후 커밋
- Push: 본인 Fork 리포지토리에 Push
- Pull Request: 원본 리포지토리로 PR 생성
PR 제목:
[팀명] 프로젝트 제출 - [프로젝트명]
PR 설명:
## 팀 정보
- 팀명: [팀명]
- 팀원: [이름1, 이름2, ...]
## 프로젝트 개요
[간단한 프로젝트 설명]
## 주요 구현 내용
- [구현 내용 1]
- [구현 내용 2]
- ...
## 체크리스트
- [ ] README.md 작성 완료
- [ ] 코드 정리 및 주석 추가
- [ ] 실행 가능한 상태로 제출- 프로젝트 구조 상세 분석: example_directory.md
- 템플릿: projects/knu-bootcamp-template
프로젝트 제출 관련 문의사항은 운영진에게 연락해주세요.
T.B.D