Skip to content

Conversation

@yerim123456
Copy link
Contributor

@yerim123456 yerim123456 commented Aug 21, 2025

🔑 JIRA 이슈 키

KOBG-13 lesson 관련 api 제작


✒ 진행한 작업

  • 레슨 상세 조회 API
  • 레슨 전체 조회 API
  • 외부 발음 평가 api 연결
  • 발음 평가 api 제작
  • chat gpt api 연결
  • 답변 교정 api 제작
  • 초기 data.sql 제작

💡 생겼던 문제 및 해결법

1️⃣ 외부 발음 평가 API 서버의 에러 문제

  • 문제: 해당 사이트 발음 평가 기능이 막혀있음
  • 해결: 외부 사이트도 찾아봤지만, 금액적인 부분의 부담이 있어 추후 실제 ai 모델과 연결시켜 api 구현할 예정이다. 현재는 임시방편으로 프론트에서 stt 기반으로 글자 유사도를 기반으로 별점과 퍼센테이지를 주고 있다.

2️⃣ oneToone 관계인 LessonSentence - LessonChat
chat이 sentence의 답변을 유도하는 질문이라 1:1매핑이 되어야 했다. 그러나 oneToone 의 의미 만으로는 jpa 메소드가 lesson sentence id 로 lesson chat 을 1:1로 가져올 수 있는 것이 아닌, list 로 매핑이 되었다. 따라서 joinColumn 에 unique 설정을 추가하여 진행해 oneToone 이 가능하도록 설정했다.


📢 아쉬운 부분 및 개선점

😤 WebClient 비동기 장점 사용 부실
mvc 상태에서 WebClient 를 사용한다면, 그저 RestTemplate을 대체하기 위해 통신 방법으로 사용하는 정도로 WebClient 를 제대로 사용할 수 없는 방법이라고 한다. WebClient 는 WebFlux 와 함께 사용할 때 비로소 비동기의 장점을 완연히 보여줄 수 있다고 해서 해당 부분 참고해 디벨롭할 예정이다.

🔑확대/수정에 용이한 번역 erd 다시 구성
처음에는 번역본에 대한 것을 모두 google-translation-api 로 대체할 것이라고 계획을 했었다. 구현 후, 의문점이 들어 다시 개발자 분과 논의해보니 고정된 부분은 그래도 저장하는 게 좋지 않을까로 결론을 짓게 되었다. 또한 추가로 실제 회사라면, translate-api 사용보단 번역가에게 외주를 맡기고 제대로 검증된 번역본을 사용할 것 같다는 판단이 들어 추후에 보다 다양한 외국어 반영이 쉽고, 각 문장에 대해 보다 구조화된 erd를 구성해 추후 유지보수에 용이하게 할 예정이다.

📚 data.sql 방식이 아닌 데이터 파이프라인 기반 관리 진행
현재는 레벨 별 콘텐츠가 많진 않고, 추후에 확대될 예정이라 가볍게 진행하였으나 추후 데이터의 확장과 편리한 업데이트를 고려하여 데이터 파이프라인을 구현하여 관리하고자 한다.

💌 AI Agent 이용한 매끄러운 대화로 디벨롭
현재는 레슨의 기본 문장을 답변할 수 있도록 하는 소통방식이어서 보다 자유롭지는 못하다. 추후 AI Agent 를 통해서 자유로운 소통 안에서 다양한 주제 관련 어휘 및 문장을 활용하도록 도울 예정이다.


yerim1ee added 30 commits August 21, 2025 10:12
yerim1ee added 17 commits August 21, 2025 10:12
@yerim123456 yerim123456 self-assigned this Aug 21, 2025
@yerim123456 yerim123456 added documentation Improvements or additions to documentation enhancement New feature or request labels Aug 21, 2025
@github-actions
Copy link

📊 Jacoco Test Coverage

Overall Project NaN% NaN% 🍏

There is no coverage information present for the Files changed

@github-actions
Copy link

📊 Jacoco Test Coverage

Overall Project NaN% NaN% 🍏

There is no coverage information present for the Files changed

@github-actions
Copy link

📊 Jacoco Test Coverage

Overall Project NaN% NaN% 🍏

There is no coverage information present for the Files changed

@github-actions
Copy link

📊 Jacoco Test Coverage

Overall Project NaN% NaN% 🍏

There is no coverage information present for the Files changed

@yerim123456 yerim123456 merged commit c8378d2 into develop Aug 21, 2025
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants