# 풀스택 + AI 프로젝트 포트폴리오 정보 추출 요청

이 저장소를 풀스택 + AI 프로젝트 포트폴리오 작성 관점에서 분석해줘.

단순 기능 목록이 아니라, 아래 항목을 중심으로 “백엔드/풀스택/AI 활용 프로젝트 포트폴리오에 쓸 수 있는 정보”를 뽑아줘.

## 1. 프로젝트 목적
- 이 프로젝트가 해결하려는 사용자 문제
- AI를 사용한 이유
- AI 없이 구현했을 때의 한계
- 주요 사용자
- 프로젝트를 한 줄로 설명할 수 있는 문장
- 핵심 가치가 자동화/추천/요약/분석/검색/생성 중 무엇인지

## 2. 전체 서비스 흐름
- 사용자가 처음 화면에서 결과를 받기까지의 흐름
- 프론트엔드에서 호출하는 주요 API
- 백엔드에서 요청을 검증하고 처리하는 방식
- DB에 저장되는 데이터
- AI 모델에 전달되는 데이터
- AI 응답 후처리 방식
- 최종 결과가 UI에 표시되는 방식

## 3. AI 기능 분석
- AI가 담당하는 기능 목록
- AI 입력값
- AI 출력값
- 출력 형식
- 모델 응답을 검증하는 방식
- AI 실패 시 처리 방식
- AI 결과가 서비스 핵심 기능에 어떻게 연결되는지

## 4. 프롬프트 설계
- 시스템 프롬프트/사용자 프롬프트 구조
- 출력 형식 강제 여부
- JSON/schema 기반 응답 여부
- Few-shot 예시 사용 여부
- 프롬프트 파일 또는 버전 관리 여부
- 프롬프트 인젝션 방어 고려 여부
- 프롬프트 설계 의도

## 5. 데이터 처리
- 사용자가 입력하는 원본 데이터
- AI 요청 전 데이터 정제 방식
- 파일/문서/이미지/음성 처리 여부
- chunking 여부
- 임베딩 여부
- 민감정보 제거 여부
- AI 결과 저장 방식

## 6. RAG/검색 구조
- RAG를 사용하는지
- 임베딩 모델
- 벡터 DB 또는 검색 엔진
- 문서 chunk 생성 방식
- 검색 기준
- 검색 결과를 프롬프트에 넣는 방식
- 출처 제공 여부
- hallucination을 줄이기 위한 처리

## 7. 백엔드 구조
- 주요 API 목록
- 인증/인가 구조
- 요청 검증 방식
- AI 호출 서비스 분리 여부
- DB 모델 구조
- 비동기 작업 처리 여부
- 작업 상태 관리 여부
- 에러 처리 방식
- 로그/모니터링 방식
- 토큰 사용량 또는 비용 기록 여부

## 8. 프론트엔드 구조
- 주요 화면 목록
- 사용자 입력 UI
- AI 처리 중 로딩/상태 표시
- 스트리밍 응답 여부
- 결과 표시 방식
- 결과 수정/저장/재생성 기능
- 에러 UI
- 사용자 피드백 기능

## 9. 안정성 처리
- AI 응답 파싱 실패 처리
- 빈 응답 처리
- 잘못된 형식 응답 처리
- 재시도 처리
- timeout 처리
- rate limit 처리
- 부적절한 결과 필터링
- 사용자가 결과를 검토/수정할 수 있는 구조

## 10. 성능/비용 최적화
- 토큰 사용량 제한
- 입력 길이 제한
- 캐싱 여부
- 이전 결과 재사용 여부
- 응답 시간 측정 여부
- 모델 선택 기준
- 동기/비동기 처리 기준
- 스트리밍 적용 여부

## 11. 테스트와 검증
- 프론트엔드 테스트
- 백엔드 테스트
- AI 응답 테스트
- 프롬프트 테스트
- Mock AI 사용 여부
- 통합 테스트
- 실패 케이스 테스트
- 실제 사용자 시나리오 검증 여부

## 12. 문제 해결 사례 후보
아래 구조로 3~5개 후보를 찾아줘.

### 문제 상황
무슨 문제가 있었는지

### 원인 분석
왜 문제가 발생했는지

### 해결 방법
어떤 구조나 기술로 해결했는지

### 선택 이유
왜 그 방법을 선택했는지

### 결과
사용성, 정확도, 안정성, 비용, 유지보수성 측면에서 어떤 개선이 있었는지

## 13. 포트폴리오 문장 초안
위 분석을 바탕으로 아래 항목별로 바로 사용할 수 있는 문장 초안을 작성해줘.

- 프로젝트 개요
- 담당 역할
- 주요 기여
- 사용 기술 및 선택 이유
- 구현 사항
- AI 기능 설계
- 문제 해결 사례
- 프로젝트 성과
- 회고

주의:
- 실제 코드에서 확인되는 내용만 작성해줘.
- 확인되지 않는 내용은 “확인 필요”로 표시해줘.
- 단순히 “AI API를 사용했다”라고 쓰지 말고, AI가 어떤 문제를 어떻게 해결했는지 중심으로 작성해줘.
- “사용자 입력 → 백엔드 처리 → AI 요청 → 결과 후처리 → UI 표시” 흐름을 반드시 포함해줘.
- 포트폴리오 문장은 “문제 → 설계 선택 → 구현 방식 → 결과” 구조로 작성해줘.