https://hangil.site
- ์ฌ์ฉ์๊ฐ ์ง๊ธ๊น์ง ์ด์ํ ๊ณผ๋ชฉ๋ค๊ณผ ํ์ฌ ์ ๊ณต ์ด์ํ์ ์ ๋ณด์ฌ์ค๋๋ค.
2. ์๊ณ ๋ฆฌ์ฆ์ ํตํด ์ฌ์ฉ์์ ํธ๋์ ๋ง์ถฐ ์ ํํ ๊ณผ๋ชฉ์ด ์ ๊ณต์ ํ์ธ์ง ์ ๊ณตํ์์ธ์ง ๋ณด์ฌ์ค๋๋ค.
3-1. ์ ๊ณต ์ ํ์ผ ๊ฒฝ์ฐ 1, 2ํธ๋ ์ค ์ฌ์ฉ์๊ฐ ์ง์ ์ ํํ ์ ์์ต๋๋ค.
3-2. ์ ๊ณต ํ์์ผ ๊ฒฝ์ฐ ์๋์ผ๋ก ํด๋น ํธ๋์ ์ ํ๋ฉ๋๋ค.
4. ๊ณผ๋ชฉ์ ํธ๋์ ๋ฐ๊พธ๊ณ ์ถ์ ๊ฒฝ์ฐ ๋ณ๊ฒฝ ๋ฒํผ์ ํตํด ์์ ํ ์ ์์ต๋๋ค.
5. ์กธ์ ์๊ฑด์ ์ฑ์ธ ๊ฒฝ์ฐ ์งํ๋ฐ๋ ์ด๋ก์์ผ๋ก ๋ณ๊ฒฝ๋ฉ๋๋ค. ์ด๋ ๊ฒ ์ฌ์ฉ์๋ ์กธ์ ๊น์ง์ ๊ณํ์ ์ธ์ฐ๊ณ ์ ์ฅํ ์ ์์ต๋๋ค
๊ณผ๋ชฉ ๋ฐ์ดํฐ โ Qdrant ๋ฒกํฐํ โ ์ฌ์ฉ์ ์ฟผ๋ฆฌ โ ์ ์ฌ ๊ณผ๋ชฉ ๊ฒ์ โ LLM ๋ก๋๋งต ์์ฑ
1. ๋ฐ์ดํฐ ์ค๋น (Embedding & Indexing)
- ๋ชจ๋ ๊ณผ๋ชฉ ์ ๋ณด(๊ฐ์ ๊ณํ์, ๊ณผ๋ชฉ ์ค๋ช ๋ฑ)๋ฅผ LLM์ด ์ดํดํ ์ ์๋ ๋ฒกํฐ(Vector) ๋ก ๋ณํํฉ๋๋ค. ๋ณํ๋ ๋ฒกํฐ๋ค์ ์๋ฏธ ๊ธฐ๋ฐ ๊ฒ์์ด ์ฉ์ดํ๋๋ก VectorDB์ ์ ์ฅ(Indexing)๋ฉ๋๋ค.
2. ์ฐ๊ด ๋ฐ์ดํฐ ๊ฒ์
- ์ฌ์ฉ์์ ์ ๋ณด์ ์ค๋ฌธ์กฐ์ฌ(๊ด์ฌ ๋ถ์ผ ๋ฑ) ๋ํ ๋ฒกํฐ๋ก ๋ณํ๋ฉ๋๋ค. VectorDB ๋ด์์ ์ฌ์ฉ์์ ์ง์ ๋ฒกํฐ์ DB ๋ด ๊ณผ๋ชฉ ๋ฒกํฐ๋ค ๊ฐ์ ์ฝ์ฌ์ธ ์ ์ฌ๋(Cosine Similarity)๋ฅผ ์ธก์ ํ์ฌ ์๋ฏธ์ ์ผ๋ก ๊ฐ์ฅ ๊ด๋ จ์ฑ ๋์ ์์ K๊ฐ์ ๋ฌธ์๋ฅผ ์ ์ํ๊ฒ ๊ฒ์ํฉ๋๋ค.
3. ํ๋กฌํํธ ๊ตฌ์ฑ ๋ฐ ์๋ต ์์ฑ
- ๊ฒ์๋ ์ ๋ณด๋ ์ฌ์ฉ์์ ์๊ฐ ์ด๋ ฅ, ํธ๋ ์ ๋ณด ๋ฑ ๊ฐ์ธ ๋ฐ์ดํฐ์ ๋ฐ๋ผ ํ ๋ฒ ๋ ํํฐ๋ง๋ฉ๋๋ค. ์ต์ข ์ ์ผ๋ก ์ ์ ๋ ๋ฐ์ดํฐ๋ ๋ก๋๋งต ์์ฑ ๊ท์น๊ณผ ํจ๊ป LLM์ ์ ๋ฌ๋ฉ๋๋ค. LLM์ ์ด ์ปจํ ์คํธ๋ฅผ ๋ฐํ์ผ๋ก ํ๊ฐ(Hallucination) ํ์์ ์ต์ํํ์ฌ ๋ง์ถคํ ๋ก๋๋งต์ ์์ฑํฉ๋๋ค.
Frontend
๐ฆFrontend
โฃ ๐.git
โ โฃ ๐hooks
โ โ โฃ ๐applypatch-msg.sample
โ โ โฃ ๐commit-msg.sample
โ โ โฃ ๐fsmonitor-watchman.sample
โ โ โฃ ๐post-update.sample
โ โ โฃ ๐pre-applypatch.sample
โ โ โฃ ๐pre-commit.sample
โ โ โฃ ๐pre-merge-commit.sample
โ โ โฃ ๐pre-push.sample
โ โ โฃ ๐pre-rebase.sample
โ โ โฃ ๐pre-receive.sample
โ โ โฃ ๐prepare-commit-msg.sample
โ โ โฃ ๐push-to-checkout.sample
โ โ โ ๐update.sample
โ โฃ ๐info
โ โ โ ๐exclude
โ โฃ ๐logs
โ โ โฃ ๐refs
โ โ โ โฃ ๐heads
โ โ โ โ โ ๐develop
โ โ โ โ ๐remotes
โ โ โ โ โ ๐origin
โ โ โ โ โ โ ๐HEAD
โ โ โ ๐HEAD
โ โฃ ๐objects
โ โ โฃ ๐info
โ โ โ ๐pack
โ โ โ โฃ ๐pack-3e6ae162964f898e9555f4b541a48afd891d14f7.idx
โ โ โ โ ๐pack-3e6ae162964f898e9555f4b541a48afd891d14f7.pack
โ โฃ ๐refs
โ โ โฃ ๐heads
โ โ โ โ ๐develop
โ โ โฃ ๐remotes
โ โ โ โ ๐origin
โ โ โ โ โ ๐HEAD
โ โ โ ๐tags
โ โฃ ๐HEAD
โ โฃ ๐config
โ โฃ ๐description
โ โฃ ๐index
โ โ ๐packed-refs
โฃ ๐.github
โ โฃ ๐ISSUE_TEMPLATE
โ โ โฃ ๐๐-๋ฌธ์ํ.md
โ โ โฃ ๐๐จ-๋ฒ๊ทธ-ํด๊ฒฐ.md
โ โ โฃ ๐๐๏ธ-ํผ๋ธ๋ฆฌ์ฑ.md
โ โ โฃ ๐๐-๊ธฐ๋ฅ-๊ตฌํ.md
โ โ โฃ ๐๐งญ-ํ๊ฒฝ์ค์ .md
โ โ โ ๐๐งน-๋ฆฌํฉํ ๋ง.md
โ โ ๐pull_request_template.md
โฃ ๐.vscode
โ โฃ ๐settings.json
โ โ ๐tasks.json
โฃ ๐public
โ โฃ ๐file.svg
โ โฃ ๐globe.svg
โ โฃ ๐logo.svg
โ โฃ ๐next.svg
โ โฃ ๐vercel.svg
โ โ ๐window.svg
โฃ ๐src
โ โฃ ๐app
โ โ โฃ ๐(app)
โ โ โ โฃ ๐completion
โ โ โ โ โ ๐page.tsx
โ โ โ โฃ ๐dashboard
โ โ โ โ โ ๐page.tsx
โ โ โ โฃ ๐graduation
โ โ โ โ โ ๐page.tsx
โ โ โ โฃ ๐roadmap
โ โ โ โ โ ๐page.tsx
โ โ โ โฃ ๐simulation
โ โ โ โ โ ๐page.tsx
โ โ โ โฃ ๐timetable
โ โ โ โ โ ๐page.tsx
โ โ โ โ ๐layout.tsx
โ โ โฃ ๐(auth)
โ โ โ โฃ ๐login
โ โ โ โ โ ๐page.tsx
โ โ โ โฃ ๐onboarding
โ โ โ โ โ ๐page.tsx
โ โ โ โ ๐layout.tsx
โ โ โฃ ๐favicon.ico
โ โ โฃ ๐globals.css
โ โ โฃ ๐layout.tsx
โ โ โ ๐page.tsx
โ โฃ ๐components
โ โ โฃ ๐client
โ โ โ โฃ ๐wrapper
โ โ โ โ โฃ ๐HeaderClientWrapper.tsx
โ โ โ โ โ ๐LoginClientWrapper.tsx
โ โ โ โฃ ๐CompletionPageClient.tsx
โ โ โ โฃ ๐DashboardPageClient.tsx
โ โ โ โฃ ๐ErrorBoundary.tsx
โ โ โ โฃ ๐GraduationPageClient.tsx
โ โ โ โฃ ๐Navigation.tsx
โ โ โ โฃ ๐RoadmapPageClient.tsx
โ โ โ โฃ ๐SimulationPageClient.tsx
โ โ โ โ ๐TimetablePageClient.tsx
โ โ โฃ ๐server
โ โ โ โ ๐Layout.tsx
โ โ โฃ ๐views
โ โ โ โฃ ๐CompletionStatusView.tsx
โ โ โ โฃ ๐DashboardView.tsx
โ โ โ โฃ ๐GraduationView.tsx
โ โ โ โฃ ๐LoginScreen.tsx
โ โ โ โฃ ๐OnboardingScreen.tsx
โ โ โ โฃ ๐RoadmapView.tsx
โ โ โ โฃ ๐SimulationView.tsx
โ โ โ โฃ ๐TimetableView.tsx
โ โ โ โ ๐index.ts
โ โ โฃ ๐Button.tsx
โ โ โฃ ๐ConfirmationModal.tsx
โ โ โฃ ๐CourseCard.tsx
โ โ โฃ ๐OnboardingRestartModal.tsx
โ โ โฃ ๐PrivacyPolicyModal.tsx
โ โ โฃ ๐ProgressBar.tsx
โ โ โฃ ๐Toast.tsx
โ โ โฃ ๐Toggle.tsx
โ โ โฃ ๐animations.ts
โ โ โ ๐common.tsx
โ โฃ ๐data
โ โ โ ๐courseData.ts
โ โฃ ๐hooks
โ โ โฃ ๐useData.ts
โ โ โ ๐useStore.ts
โ โฃ ๐providers
โ โ โ ๐QueryProvider.tsx
โ โฃ ๐services
โ โ โฃ ๐api.ts
โ โ โฃ ๐authService.ts
โ โ โ ๐modifyService.ts
โ โฃ ๐store
โ โ โ ๐index.ts
โ โฃ ๐styles
โ โ โ ๐theme.ts
โ โฃ ๐views
โ โ โฃ ๐DashboardView.tsx
โ โ โฃ ๐LoginScreen.tsx
โ โ โ ๐OnboardingScreen.tsx
โ โ ๐types.ts
โฃ ๐.eslintignore
โฃ ๐.eslintrc.json
โฃ ๐.gitignore
โฃ ๐.prettierignore
โฃ ๐.prettierrc
โฃ ๐README.md
โฃ ๐eslint.config.mjs
โฃ ๐jest.config.js
โฃ ๐jest.setup.js
โฃ ๐main.sql
โฃ ๐main.vuerd.json
โฃ ๐next.config.ts
โฃ ๐package-lock.json
โฃ ๐package.json
โฃ ๐postcss.config.mjs
โฃ ๐temp.vuerd.json
โ ๐tsconfig.json
Backend
๐ฆsrc
โฃ ๐main
โ โฃ ๐java
โ โ โ ๐grit
โ โ โ โ ๐guidance
โ โ โ โ โฃ ๐domain
โ โ โ โ โ โฃ ๐course
โ โ โ โ โ โ โฃ ๐controller
โ โ โ โ โ โ โ โ ๐CourseAdminController.java
โ โ โ โ โ โ โฃ ๐dto
โ โ โ โ โ โ โ โ ๐CourseDataDto.java
โ โ โ โ โ โ โฃ ๐entity
โ โ โ โ โ โ โ โฃ ๐Course.java
โ โ โ โ โ โ โ โฃ ๐CoursePrerequisite.java
โ โ โ โ โ โ โ โฃ ๐CourseType.java
โ โ โ โ โ โ โ โฃ ๐Semester.java
โ โ โ โ โ โ โ โฃ ๐Track.java
โ โ โ โ โ โ โ โ ๐TrackRequirement.java
โ โ โ โ โ โ โฃ ๐repository
โ โ โ โ โ โ โ โฃ ๐CoursePrerequisiteRepository.java
โ โ โ โ โ โ โ โฃ ๐CourseRepository.java
โ โ โ โ โ โ โ โฃ ๐TrackRepository.java
โ โ โ โ โ โ โ โ ๐TrackRequirementRepository.java
โ โ โ โ โ โ โ ๐service
โ โ โ โ โ โ โ โฃ ๐CourseDescriptionCrawlingService.java
โ โ โ โ โ โ โ โฃ ๐CourseService.java
โ โ โ โ โ โ โ โฃ ๐TrackRequirementService.java
โ โ โ โ โ โ โ โ ๐TrackService.java
โ โ โ โ โ โฃ ๐graduation
โ โ โ โ โ โ โฃ ๐controller
โ โ โ โ โ โ โ โ ๐GraduationController.java
โ โ โ โ โ โ โฃ ๐dto
โ โ โ โ โ โ โ โฃ ๐CertificationStatusDto.java
โ โ โ โ โ โ โ โฃ ๐CrawlingGraduationDto.java
โ โ โ โ โ โ โ โฃ ๐DashboardResponseDto.java
โ โ โ โ โ โ โ โฃ ๐DetailedCreditDto.java
โ โ โ โ โ โ โ โฃ ๐GraduationPlanRequestDto.java
โ โ โ โ โ โ โ โฃ ๐GraduationResponseDto.java
โ โ โ โ โ โ โ โ ๐TrackProgressDto.java
โ โ โ โ โ โ โฃ ๐entity
โ โ โ โ โ โ โ โ ๐CrawlingGraduation.java
โ โ โ โ โ โ โฃ ๐repository
โ โ โ โ โ โ โ โ ๐CrawlingGraduationRepository.java
โ โ โ โ โ โ โ ๐service
โ โ โ โ โ โ โ โ ๐GraduationService.java
โ โ โ โ โ โฃ ๐roadmap
โ โ โ โ โ โ โฃ ๐controller
โ โ โ โ โ โ โ โ ๐RoadmapController.java
โ โ โ โ โ โ โฃ ๐dto
โ โ โ โ โ โ โ โฃ ๐CourseDto.java
โ โ โ โ โ โ โ โฃ ๐CourseRecommendationRequest.java
โ โ โ โ โ โ โ โฃ ๐RoadmapDataDto.java
โ โ โ โ โ โ โ โฃ ๐RoadmapResponseDto.java
โ โ โ โ โ โ โ โฃ ๐SearchRequest.java
โ โ โ โ โ โ โ โ ๐SemesterDto.java
โ โ โ โ โ โ โฃ ๐entity
โ โ โ โ โ โ โ โ ๐RecommendedCourse.java
โ โ โ โ โ โ โฃ ๐repository
โ โ โ โ โ โ โ โฃ ๐QdrantRepository.java
โ โ โ โ โ โ โ โ ๐RecommendedCourseRepository.java
โ โ โ โ โ โ โ ๐service
โ โ โ โ โ โ โ โฃ ๐CourseEmbeddingService.java
โ โ โ โ โ โ โ โฃ ๐LlmRoadmapService.java
โ โ โ โ โ โ โ โฃ ๐RecommendedCourseService.java
โ โ โ โ โ โ โ โ ๐RoadmapService.java
โ โ โ โ โ โฃ ๐simulation
โ โ โ โ โ โ โฃ ๐controller
โ โ โ โ โ โ โ โ ๐SimulationController.java
โ โ โ โ โ โ โฃ ๐dto
โ โ โ โ โ โ โ โฃ ๐GraduationPlanRequestDto.java
โ โ โ โ โ โ โ โ ๐SimulationDto.java
โ โ โ โ โ โ โฃ ๐entity
โ โ โ โ โ โ โ โฃ ๐GraduationPlan.java
โ โ โ โ โ โ โ โ ๐GraduationPlanCourse.java
โ โ โ โ โ โ โฃ ๐repository
โ โ โ โ โ โ โ โฃ ๐GraduationPlanCourseRepository.java
โ โ โ โ โ โ โ โ ๐GraduationPlanRepository.java
โ โ โ โ โ โ โ ๐service
โ โ โ โ โ โ โ โ ๐SimulationService.java
โ โ โ โ โ โ ๐user
โ โ โ โ โ โ โฃ ๐controller
โ โ โ โ โ โ โ โฃ ๐CrawlingController.java
โ โ โ โ โ โ โ โฃ ๐DashboardController.java
โ โ โ โ โ โ โ โฃ ๐FavoriteCourseController.java
โ โ โ โ โ โ โ โฃ ๐LoginController.java
โ โ โ โ โ โ โ โฃ ๐TimetableController.java
โ โ โ โ โ โ โ โฃ ๐UserController.java
โ โ โ โ โ โ โ โ ๐UserSyncController.java
โ โ โ โ โ โ โฃ ๐dto
โ โ โ โ โ โ โ โฃ ๐AcademicStatusDto.java
โ โ โ โ โ โ โ โฃ ๐CareerGoalDto.java
โ โ โ โ โ โ โ โฃ ๐CourseGradeResponse.java
โ โ โ โ โ โ โ โฃ ๐DashboardDataDto.java
โ โ โ โ โ โ โ โฃ ๐DashboardResponseDto.java
โ โ โ โ โ โ โ โฃ ๐ErrorResponse.java
โ โ โ โ โ โ โ โฃ ๐FavoriteCourseRequest.java
โ โ โ โ โ โ โ โฃ ๐FavoriteCourseResponse.java
โ โ โ โ โ โ โ โฃ ๐HansungDataResponse.java
โ โ โ โ โ โ โ โฃ ๐LoginRequest.java
โ โ โ โ โ โ โ โฃ ๐LoginResponse.java
โ โ โ โ โ โ โ โฃ ๐MajorCreditDetail.java
โ โ โ โ โ โ โ โฃ ๐MajorCreditTotal.java
โ โ โ โ โ โ โ โฃ ๐MajorRequiredCreditsResponse.java
โ โ โ โ โ โ โ โฃ ๐NextSemesterCourseDto.java
โ โ โ โ โ โ โ โฃ ๐SemesterGradeResponse.java
โ โ โ โ โ โ โ โฃ ๐TimetableDataDto.java
โ โ โ โ โ โ โ โฃ ๐TimetableDetailDto.java
โ โ โ โ โ โ โ โฃ ๐TimetableEventDto.java
โ โ โ โ โ โ โ โฃ ๐TimetableResponse.java
โ โ โ โ โ โ โ โฃ ๐TotalGradeResponse.java
โ โ โ โ โ โ โ โฃ ๐UserCourseDto.java
โ โ โ โ โ โ โ โฃ ๐UserInfoDto.java
โ โ โ โ โ โ โ โฃ ๐UserInfoResponse.java
โ โ โ โ โ โ โ โฃ ๐UserSyncRequestDto.java
โ โ โ โ โ โ โ โ ๐UserTrackDto.java
โ โ โ โ โ โ โฃ ๐entity
โ โ โ โ โ โ โ โฃ ๐CompletedCourse.java
โ โ โ โ โ โ โ โฃ ๐CompletedGrade.java
โ โ โ โ โ โ โ โฃ ๐EnrolledCourse.java
โ โ โ โ โ โ โ โฃ ๐FavoriteCourse.java
โ โ โ โ โ โ โ โฃ ๐GraduationRequirement.java
โ โ โ โ โ โ โ โฃ ๐Setting.java
โ โ โ โ โ โ โ โฃ ๐TrackType.java
โ โ โ โ โ โ โ โฃ ๐UserTrack.java
โ โ โ โ โ โ โ โ ๐Users.java
โ โ โ โ โ โ โฃ ๐repository
โ โ โ โ โ โ โ โฃ ๐CompletedCourseRepository.java
โ โ โ โ โ โ โ โฃ ๐EnrolledCourseRepository.java
โ โ โ โ โ โ โ โฃ ๐FavoriteCourseRepository.java
โ โ โ โ โ โ โ โฃ ๐GraduationRequirementRepository.java
โ โ โ โ โ โ โ โฃ ๐UserTrackRepository.java
โ โ โ โ โ โ โ โ ๐UsersRepository.java
โ โ โ โ โ โ โ ๐service
โ โ โ โ โ โ โ โฃ ๐CrawlingConditionService.java
โ โ โ โ โ โ โ โฃ ๐DashboardService.java
โ โ โ โ โ โ โ โฃ ๐FavoriteCourseService.java
โ โ โ โ โ โ โ โฃ ๐LoginService.java
โ โ โ โ โ โ โ โฃ ๐TimetableService.java
โ โ โ โ โ โ โ โฃ ๐UserAcademicInfoSyncService.java
โ โ โ โ โ โ โ โฃ ๐UserCourseService.java
โ โ โ โ โ โ โ โฃ ๐UserDetailsServiceImpl.java
โ โ โ โ โ โ โ โ ๐UsersCrawlingService.java
โ โ โ โ โฃ ๐global
โ โ โ โ โ โฃ ๐common
โ โ โ โ โ โ โฃ ๐response
โ โ โ โ โ โ โ โ ๐ApiResponse.java
โ โ โ โ โ โ โฃ ๐BaseEntity.java
โ โ โ โ โ โ โฃ ๐SystemData.java
โ โ โ โ โ โ โ ๐SystemDataRepository.java
โ โ โ โ โ โฃ ๐config
โ โ โ โ โ โ โฃ ๐QdrantConfig.java
โ โ โ โ โ โ โฃ ๐SecurityConfig.java
โ โ โ โ โ โ โ ๐SwaggerConfig.java
โ โ โ โ โ โ ๐jwt
โ โ โ โ โ โ โฃ ๐JwtAuthenticationFilter.java
โ โ โ โ โ โ โฃ ๐JwtService.java
โ โ โ โ โ โ โ ๐JwtToken.java
โ โ โ โ โ ๐GuidanceApplication.java
โ โ ๐resources
โ โ โฃ ๐data
โ โ โ โ ๐courses.json
โ โ โฃ ๐application-dev.yml
โ โ โฃ ๐application-local.yml
โ โ โ ๐application.yml
โ ๐test
โ โ ๐java
โ โ โ ๐grit
โ โ โ โ ๐guidance
โ โ โ โ โฃ ๐domain
โ โ โ โ โ โฃ ๐roadmap
โ โ โ โ โ โ โ ๐service
โ โ โ โ โ โ โ โ ๐CourseEmbeddingServiceTest.java
โ โ โ โ โ โ ๐user
โ โ โ โ โ โ โ ๐service
โ โ โ โ โ โ โ โ ๐UsersCrawlingServiceTest.java
โ โ โ โ โ ๐GuidanceApplicationTests.java
https://github.com/2025-Engineering-Contest-Team-GRIT/Frontend.git
https://github.com/2025-Engineering-Contest-Team-GRIT/Backend.git
- Backend/.env
POSTGRES_DB=
POSTGRES_USER=
POSTGRES_PASSWORD=
POSTGRES_URL=
SPRING_PROFILES_ACTIVE=
OPENAI_API_KEY=
docker-compose up --build
yarn install
yarn run dev
| Name | ์ต์ฌํ | ๊นํํฌ | ๋ณ์ ์ | ๊น์งํ |
|---|---|---|---|---|
| Role | Team Leader, Backend |
Backend, DevOps | Backend | Frontend, Design |
| GitHub |





