index.md

💻 캡스톤 30조 결과물 소개

[중간발표 자료 및 보고서]
[최종발표 자료&포스터 및 보고서]
[Github]
`파트별 자세한 내용은 각 프로젝트 디렉토리의 마크다운 문서를 확인해주시기 바랍니다`

프론트	백	AI
FRONT.md	BACK.md	AI.md

Play 스토어 다운로드

1. 프로젝트 소개

이 프로젝트는 국민대학교 유학생들이 겪는 언어적, 문화적 불편함을 해결하기 위한 프로젝트입니다. 이 프로젝트에서 제공하는 앱에서 유학생들이 캠퍼스 생활에 빠르게 적응할 수 있도록 다양한 정보와 서비스를 제공합니다.

2. Abstract

This project aims to develop a comprehensive app service for international students studying at Kookmin University. The app provides a variety of information and services to help students quickly adapt to campus life.

3. 시연 영상

4. 프로젝트 기능

1️⃣ 번역된 공지사항 / 학식 / 학교정보 제공

국민대학교에서는 공지사항, 학식, 학교정보의 번역을 잘 지원하지 않습니다. 이에따라 외국인 유학생들은 매번 번역기를 사용하여 학교에 대한 정보를 얻기 때문에 정보의 접근성이 낮습니다.

따라서, 외국민 서비스는 설정한 언어에 맞춰서 공지사항/학식/학교정보 번역본을 제공합니다.

번역된 공지사항	공지사항 디테일	번역된 학식정보

2️⃣ 챗봇 기능

국민대학교에서는 ON국민 챗봇 "쿠민이"를 서비스하고있으나, 성능이 매우 형편없습니다. 간단한 질문에도 동문서답을 하거나, 영어로 질문했는데 한글로 답변하는 등 전혀 챗봇으로서의 기능을 수행하지 못하고 있습니다.

따라서, 외국민은 RAG와 LLM을 사용하여 국민대학교에 특화된 답변을 제공하고 다국어를 지원하는 "KuKu" 챗봇을 제공합니다.

국민대 관련 질문	다국어 지원	일상 대화

3️⃣ 발음 교정 기능

많은 외국인들은 한국에 와서 언어 문제로 힘들어합니다. 특히 학교 생활을 하다보면 발표를 하거나 일상생활에서 의사소통을 해야할 때, 본인의 발음이 정확한지 확인할 방법이 없어서 힘들어합니다.

따라서, 외국민은 자신의 발표 스크립트를 입력으로 넣어서 발음 평가를 받을 수 있을 뿐만 아니라, 한국의 일상생활에서 많이 쓰이는 여러 표현들을 연습할 수 있도록하여 한국 유학생활을 돕고자 합니다.

일상생활에 자주쓰는 예문 지원	문장 커스텀 지원	발음 평가 제공

4️⃣ 헬퍼 매칭 기능

많은 외국인들이 낯선 땅에 왔을 때 도움을 받을 사람이 없어서 매우 힘들어합니다.

따라서, 외국민은 외국인들을 도울 수 있도록 헬퍼 매칭 기능을 제공합니다. 한국인 or 오랜 유학생활을 하여 한국 생활에 익숙해진 외국인 헬퍼를 구할 수 있도록 커뮤니티를 제공합니다.

헬퍼 및 헬피 게시판	디테일	채팅

5️⃣ Q&A와 FAQ 기능

유학생들이 한국생활에서 궁금한 것을 물어볼만한 곳이 마땅치 않고, ON국민에 있는 FAQ의 존재를 알기 쉽지 않습니다. 하지만, 이 FAQ 또한 번역을 제공하지 않고 있습니다.

따라서, 외국민은 Q&A 게시판과 다국어로 번역된 FAQ를 제공합니다.

Q&A 게시판	디테일	FAQ 조회

5. 팀원 소개

최지훈	김민제	조현진
****1683	****1557	****1675
👑 Frontend	Frontend	Backend

채원찬	김혜성	최영락
****1676	****1582	****1678
Backend	AI	AI

6. 기술스택

🛠 Frontend

역할	종류
Framework
Database
Programming Language
Device

💾 Backend

역할	종류
Framework
Database
Programming Language
Test
Deploy
CI/CD
ETC

📻 AI

역할	종류
Programming Language
Development
Technology
Test
Server

🔨 Tools

역할	종류
Version Control
Cooperation
Test

7. 시스템 구조

💻 서비스 아키택처

🤖 챗봇 아키텍처

📂 디렉토리 구조

├── 📂.github

├── 📂front 🗂 프론트 앱 소스 (Flutter)

├── 📂back-gateway 🗂 백엔드 Api Gateway (Spring Cloud Gateway)

├── 📂back 🗂 백엔드 메인 비즈니스 서버 소스(Spring Boot)

├── 📂back-chat 🗂 백엔드 채팅 서버 소스 (Ruby on Rails)

├── 📂ai 🗂 KuKu 채팅 봇 소스

└── 📕Readme.md

8. 사용법

Frontend

1. 플러터 설치

1. Flutter 공식 웹사이트(https://flutter.dev)에 접속
2. Get Started를 클릭하여 설치 가이드를 따라 설치
3. 설치가 완료되면, 터미널 또는 커맨드 프롬프트를 열고 flutter doctor 명령어를 실행하여 설치가 올바르게 되었는지 확인

2. 프로젝트 디렉토리 이동

cd front/capstone_front

3. 플러터 패키지 설치

flutter pub get

4. 프로젝트 실행

flutter run

Backend

.env.example을 바탕으로 .env를 작성합니다. 그 다음

docker-compose up -d

를 통해 docker compose를 통하여 실행하시면 됩니다. 이미지는 모두 Dockerhub에 업로드 되어 있습니다.

AI

1. git clone https://github.com/kookmin-sw/capstone-2024-30.git
2. cd YOUR PATH/ai/
3. pip install -r requirements.txt
4. 벡터 저장소 FAISS 폴더를 /ai 에 위치 다운로드 링크
5. python run_chatbot.py

9. 기타

챗봇 주요 수집 데이터 출처

• 국민대 2023 요람 PDF
• 국민대 전체 공지사항
• 국민대 홈페이지 대학소개
• 국민대 홈페이지 대학생활
• 국민대 홈페이지 학사안내
• 국민대 소프트웨어융합대학
• 국민대 소프트웨어융합대학 공지사항
• 그 외 네이버 및 구글 기타 수집 데이터

Metrics

RAGAS