docs: IR Deck 프론트엔드 React 구조 원칙 리팩토링 기록 추가

This commit is contained in:
happybell80 2025-11-29 17:22:43 +09:00
parent cd096b1af3
commit b088915b54

View File

@ -68,11 +68,36 @@ curl -X POST http://localhost/rb8001/api/ir-deck/evaluate \
- 백엔드 피드백 API 연동 (`/rb8001/api/ir-deck/feedback`). - 백엔드 피드백 API 연동 (`/rb8001/api/ir-deck/feedback`).
- Sequoia 10가지 기준 실제 평가 로직 구현. - Sequoia 10가지 기준 실제 평가 로직 구현.
## ChatGPT 스타일 디자인 개선 항목 (2025-11-29)
### Critical 수정 필요
1. **헤더 제거** - `ir-valuation.tsx:380-405`: ChatGPT는 헤더 없음
2. **본문 텍스트 크기** - `index.css:52`: 14px → 16px
3. **입력 박스** - `ir-valuation.tsx:571-584`: 높이 52px → 56-60px, border-radius 증가
4. **메시지 버블** - `ir-valuation.tsx:459-465`: `rounded-lg``rounded-xl/2xl`, 패딩 증가
5. **사용자 메시지 색상** - `ir-valuation.tsx:463`: `bg-blue-500``bg-gray-700/800`
### High 개선
6. **행간 설정** - `index.css`: `line-height: 1.6-1.8`
7. **컨텐츠 최대 너비** - `ir-valuation.tsx:410`: `max-w-2xl` (672px) → `max-w-3xl` (768px)
8. **색상 팔레트** - 배경색: `bg-gray-50``#F7F7F8` 유사 색상
--- ---
## 체크리스트 ## React 구조 원칙 리팩토링 (2025-11-29)
- [ ] 핵심만 간결하게 정리
- [ ] 100줄 이하 확인 (현재 78줄) ### 변경 사항
- [ ] 교훈 섹션 포함 - **API 통신 분리**: `services/irDeckService.ts` - 모든 API 호출 중앙화
- [ ] 관련 파일 링크 포함 - **비즈니스 로직 분리**: `hooks/useFileUpload.ts`, `hooks/useEvaluation.ts` - 커스텀 훅으로 로직 추출
- [ ] Nginx 설정 및 SPA 라우팅 검증 - **UI 컴포넌트 분리**: `components/features/FileMessage.tsx` - 파일 메시지 전용 컴포넌트
- **타입 정의**: `types/message.ts` - Message 인터페이스 확장 (파일 정보 포함)
### UX 개선
- 파일 업로드를 채팅 메시지 버블로 표시 (진행률 포함)
- 파일 업로드 후 자동 평가 시작 제거, 사용자 입력 대기
- 사용자 메시지 전송 시 파일과 함께 평가 시작
### 교훈
- React 구조 원칙 준수: 계층 분리 (UI → Hooks → Services)
- 컴포넌트 단일 책임: 897줄 파일을 기능별로 분리
- 사용자 제어권: 파일 업로드 후 즉시 평가가 아닌 사용자 확인 후 진행