vault backup: 2026-05-05 21:27:37

프롬프트/풀스택 + AI 프로젝트 포트폴리오 정보 추출 요청.md

@@ -0,0 +1,149 @@
+# 풀스택 + 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 표시” 흐름을 반드시 포함해줘.
+- 포트폴리오 문장은 “문제 → 설계 선택 → 구현 방식 → 결과” 구조로 작성해줘.