y.YOUNGJOONGBACKEND DEVELOPER
← 프로젝트 목록
03 / 팀 프로젝트 · 교육

새싹톡

작은 배움을 이어 주는 한글 퍼즐.

문제 해결 과정 ↓직접 체험 ↗
01 / MY CONTRIBUTION

학습 API·생성 JSON 검증·React 연동과 통합

02 / EXPLORE HERE

초성퀴즈·문장퍼즐·끝말잇기, 키보드와 드래그 조작

03 / EVIDENCE

기존 단어 판정·중복 블록 방지를 보존하고 실제 AI 요청·실패 시 기록 유지·취소를 검증합니다.

CONTEXT & CONTRIBUTION

배우는 즐거움 뒤에서, 입력과 응답을 어떻게 연결할까?

FastAPI·SQLAlchemy·PostgreSQL API와 AI 생성 JSON 처리, React 연동 및 코드 통합을 담당했습니다. 이번 포트폴리오는 원본 게임 UI와 자산을 재사용해 직접 조작할 수 있도록 연결했습니다.

FastAPI·SQLAlchemy·PostgreSQL API, AI 생성 JSON 처리, React 연동 지원, Git 병합·코드 통합 및 배포 협업.

DECISIONS & TRADE-OFFS

어떤 판단을 했는가

01 / 포트폴리오 게임 이식의 검증 보강

보이는 조각과 판정하는 ID를 분리

같은 단어가 여러 번 나와도 각 블록 ID로 구분합니다. 외부 드래그 데이터의 문구를 신뢰하지 않고 실제 문제의 조각인지 확인합니다.

02 / 웹 체험의 서버 연결 경계

AI 실패와 게임 진행을 구분하기

공용 체험권으로 실제 AI 문제를 요청합니다. 인증·연결·생성 검증 실패는 오류로 표시하고 현재 기록을 보존합니다. 로컬 문제로 자동 전환하지 않습니다.

핵심 흐름

  1. 원본 게임 화면·자산 통합: 초성퀴즈·문장퍼즐·끝말잇기
  2. AI 생성 JSON을 저장·관리하는 백엔드
  3. React API 연동과 프로젝트 코드 통합
기여 범위와 검증 한계

원본 React 게임의 표시 컴포넌트·자산과 정답·점수 규칙을 재사용합니다. 공용 체험권으로 FastAPI의 초성퀴즈 출제, 문장 생성, 끝말잇기 AI 응답을 요청합니다. 차례별 시간제한은 없습니다. 서버 없이 사용하는 로컬 문제은행은 별도로 선택하며 AI 생성과 구분합니다. AI 실패는 오류로 표시하고 자동 대체하지 않습니다. 원본 로그인·결제·운영 DB는 연결하지 않았습니다.

직접 체험 →
TROUBLESHOOTING / 문제 해결 과정

문제의 원인부터 확인한 결과까지.

개발 당시 기록을 기준으로 정리했습니다. 아래 결과는 이 웹사이트의 체험 기능에서 새로 측정한 값이 아닙니다.

01팀 협업 · 역할 확장역할 공백 속에서 핵심 화면과 API를 연결한 통합
BEFORE / 문제 상태

프론트엔드 참여가 어려워져 API 연동과 화면 작업이 남음

AFTER / 변경 후

백엔드 담당 범위를 넓혀 주요 서비스 흐름을 연결

  1. 01

    문제 상황

    프로젝트 중 프론트엔드 작업을 맡던 팀원의 참여가 어려워졌고, API 연동과 주요 화면 구성 작업이 남아 완성 일정에 영향이 생길 수 있었습니다.

  2. 02

    원인 분석

    백엔드 기능과 React 화면을 연결할 담당 범위가 비어 있었고, 여러 사람의 코드도 하나로 합쳐야 했습니다.

  3. 03

    해결 방법과 기술적 선택

    백엔드 API와 생성 JSON 저장·관리를 맡으면서 로그인, 학습 게임, 활동 대시보드, 관리자 화면의 React 연동을 지원했습니다. 팀의 역할을 다시 나누고 Git 병합·코드 통합을 수행했습니다.

  4. 04

    검증 과정

    초기 PDF p.16·개정2 p.23의 역할·완성 흐름을 원본 SST 코드와 대조했습니다. hgtk 자모 처리와 초성 규칙, 블록 중복 방지 등 이식 규칙은 별도 테스트로 확인하며 당시 서비스의 전체 테스트 통과 수치는 자료에 없습니다.

  5. 05

    결과와 검증 근거

    당시 PDF에는 회원가입부터 학습 활동·관리자 기능까지 핵심 흐름을 완성하고 Docker Compose 배포, HTTPS 인증, 도메인 연결을 경험했다고 기록돼 있습니다. 현재 그 운영 환경의 가동 상태를 뜻하지는 않습니다.

  6. 06

    배운 점과 남은 한계

    기능 구현만으로 서비스가 완성되지는 않습니다. API 계약, 화면 상태, 코드 통합과 배포 경계를 함께 확인하는 경험이 됐습니다.

근거 · 범위 초기·개정 포트폴리오 PDF의 팀 상황, 역할 확장, 결과 기록. 이번 확장의 Ollama·Kiwi AI 연결과 시간제한 제거는 원래 팀 프로젝트의 구현 범위와 구분합니다.