2025-12-02 06:27:21 +00:00

589 lines
18 KiB
Markdown

# Changelog
라온누리 프로젝트의 모든 주요 변경사항을 기록합니다.
---
## [Unreleased]
### 계획 중
- 서버 사이드 Redis 캐싱
- Rate Limiting 구현
---
## [2025-12-02] - 피드 시스템 및 영감 생성
### Added
- **피드 시스템 API**: 4개 엔드포인트 추가
- GET /api/feed/daily-prompt - 오늘의 글감 조회
- GET /api/feed/inspirations - 추천 영감 목록
- GET /api/feed/weekly-stats - 주간 통계
- GET /api/feed/team-activity - 팀 활동
- POST /api/user/[uid]/weekly-goal - 주간 목표 설정
- **FeedManager**: 피드 데이터 관리 (2분 캐싱)
- **피드 컴포넌트**: TodayTopicCard, WeeklyGoalCard, RecentActivityCard, InspirationCard
- **GlassCard 컴포넌트**: 반투명 배경 + 블러 효과 통일
- **AI 영감 자동 생성**: Cloud Function `generateDailyInspirations` (매일 새벽)
- Vertex AI (Gemini 2.5 Flash)
- Unsplash API 이미지 검색/다운로드
- Firebase Storage 저장
- 크레딧 정보 저장
- **AI 영감 수동 생성**: HTTP Function `generateInspirationsManual`
- **Vertex AI 라이브러리 변경**: @google-cloud/vertexai → @google/genai v1.29.0
- **Unsplash API 키**: Secret Manager로 관리
- **Container 레이아웃 확장**: maxW 1200px → 1400px
- **Tlab신영복체 폰트**: 글쓰기 페이지 제목에 적용
- **ModeSelectionCard UI 개선**: 이미지 드롭 쉐도우, 전환 효과
### Changed
- Vertex AI 클라이언트: 싱글톤 패턴으로 인스턴스 재사용
- Vertex AI 모델 업그레이드: gemini-1.5-flash → gemini-2.5-flash
- InspirationCard: Unsplash 크레딧 표시 제거 (저장은 유지)
### Fixed
- Unsplash Rate Limit 방지: API 호출 간격 1초 추가
- 영감 재생성 시 기존 데이터 덮어쓰기 옵션
---
## [2025-12-01] - 글쓰기 모드 선택
### Added
- **글쓰기 모드 선택 화면**: 글부터 쓰기 / 그림부터 올리기
- **URL 파라미터**: ?mode=wrt|img로 모드 관리
- **ImageDropzone 컴포넌트**: 드래그앤드롭 이미지 업로드, 미리보기
- **ImageFirstLayout**: 이미지+에디터 2컬럼 레이아웃
- **pendingImageStore**: IndexedDB 기반 이미지 임시 저장 (새로고침 유지)
- **캐릭터 이미지**: startWriting.png, uploadImage.png
### Changed
- 모드 선택 카드 디자인: 그라데이션 배경, 상단 장식 바, 제목 배지
- 모드 선택 카드 이미지: 크기 증가 180px → 240px
- 호버 애니메이션 개선
### Translations
- modeSelection namespace 추가 (ko/en/ja)
---
## [2025-11-28] - 이미지 업로드 플로우 개편
### Added
- **/imageUpload 페이지**: AI 생성/직접 업로드 선택
- **WritingManager.uploadUserImage()**: 클라이언트 사이드 이미지 리사이즈
- Canvas API 사용 (1920x1080 최대, 85% 품질)
- Firebase Storage 업로드
- **WritingManager.analyzeWritingBackground()**: fire-and-forget 패턴
- **가격정책 페이지** (/pricing)
- 4개 플랜: Free, Classroom, Academy, School
- 월간/연간 결제 토글 (20% 할인)
- FAQ 섹션
- **댓글 시스템**
- Comment 데이터 모델 (계층 구조, 반응형)
- CommentList/CommentItem/CommentInput 컴포넌트
- API Routes 구현 (GET/POST/PUT/DELETE)
- 낙관적 업데이트
### Changed
- Write 페이지 저장 플로우: 저장 → 백그라운드 분석 → /imageUpload 리다이렉트
- Interaction 페이지: 이미지 없으면 /imageUpload로 자동 이동
- authStore.isLoading 초기값: false → true (리다이렉트 방지)
### Removed
- GenerateImageDialog 제거 (플로우 변경)
### Translations
- imageUpload namespace 추가 (ko/en/ja, 15개 키)
- pricing namespace 추가 (ko/en/ja, 40개 키)
---
## [2025-11-27] - 팀 공개 설정 및 커버 이미지
### Added
- **팀 공개 설정 시스템**
- Team 타입 확장: isPublic, allowPublicWritings, description
- 팀 관리 페이지: 공개 설정 UI
- 공개 팀 조회 API (커서 기반 페이지네이션)
- 공개 글 조회 API (팀별)
- **팀 커버 이미지 시스템**
- Team.coverImage 필드
- POST/DELETE /api/team/[teamId]/cover-image
- TeamCoverImageUploader 컴포넌트 (드래그앤드롭, 16:9)
- Firebase Storage 업로드 (5MB 제한)
- TeamCard 이미지 표시
- **공개 팀 목록 페이지** (/team/all)
- TeamCard 컴포넌트 (글래스모피즘)
- 무한 스크롤 페이지네이션
- **채점 시스템 전면 개편**
- 0~1 품질 기반 점수 (5단계)
- 계층적 설정 (기본→팀→주제)
- TeamScoringSettings/TeamRubricSettings 컴포넌트
### Changed
- 팀 상세 페이지: 3가지 뷰 모드 (멤버/공개/접근 불가)
- 팀원 아바타 표시: photoURL 지원, 정식/익명 아이콘 구분
### Translations
- teams namespace 추가 (공개 팀 목록)
- team.manage.publicSettings namespace
- team.coverImage namespace (16개 키)
---
## [2025-11-26] - 익명 계정 연결 기능
### Added
- **POST /api/auth/merge-account**: 익명 계정 데이터 병합 API
- Firestore 데이터 마이그레이션 (writings, topics, comments 등)
- Realtime DB 데이터 마이그레이션 (drafts, monitoring)
- 원자성 보장 (Batch, Transaction)
- **서비스 레이어**: mergeAndLoginWithEmail, mergeAndLoginWithGoogle
- **authStore**: mergeWithEmail, mergeWithGoogle 액션
- **LoginForm/SignupForm**: mode prop ('auth'|'link')
- **LoginDialog**: link 모드 지원
### Changed
- 용어 변경: "병합" → "연결", "익명" → "임시"
### Removed
- LinkAccountFlow 컴포넌트 (기존 폼 재사용)
### Translations
- linkAccountDescription, mergeButton, linkButton 등 15개 키 (ko/en/ja)
---
## [2025-11-25] - 글 분석 및 이미지 왜곡 영역
### Added
- **POST /api/writing/[id]/analyze**: 서버 데이터 기반 글 분석
- **상호작용 컴포넌트**: AnalysisNeededBanner, AreaUnlockBadge, ImprovementHint, ScoreBadge
- **점수 기반 영역 해금**: areaLimit.ts 로직
- **DistortionAreaData**: 이미지 왜곡 영역 데이터 모델
- **InteractiveImageViewer**: 왜곡 효과 + 애니메이션
- **팀 멤버 닉네임**: POST /api/team/add-member에 nickname 파라미터
### Changed
- WritingAnalysis 타입 확장
- 글 수정 시 왜곡 영역 저장/불러오기
---
## [2025-11-23] - 이미지 비율 유지 및 CORS
### Added
- **Firebase Storage CORS 설정**
- firebase-storage-cors.json 생성
- gsutil cors set 명령어로 적용
- Canvas 이미지 조작 허용
### Changed
- **InteractiveImage 비율 유지**
- useEffect로 이미지 원본 크기 측정
- Box에 aspectRatio 속성 적용
- Canvas 찌그러짐 방지
### Fixed
- 캐시 무효화: cacheBustedSrc (?t=Date.now())
- CDN 캐시 문제 해결 (쿼리 파라미터)
---
## [2025-11-22] - Server Component 전환 및 BackButton
### Added
- **BackButton 공통 컴포넌트**
- router.back() 기본 동작
- href prop으로 특정 경로 이동
- label prop으로 텍스트 커스터마이징
### Changed
- **글 상세보기 Server Component 전환**
- /writing/[writingId]/page.tsx
- Firebase Admin SDK 사용
- SEO 최적화 (서버 HTML 생성)
- SNS 공유 미리보기 지원
- 초기 로딩 성능 개선
---
## [2025-11-21] - 주제 생성 Dialog 통합 및 UI 개선
### Added
- **수정 모드 UX 대폭 개선**
- Sticky 헤더바 (오렌지 그라데이션, z-index:100)
- 강조된 테두리 (2px solid 오렌지)
- 섀도우 효과 (글로우)
- 색상 시스템 정립
### Changed
- **주제 생성 Dialog 통합**
- CreateTeamTopicDialog 삭제 (674줄)
- CreateTopicDialog로 통합 (개인/팀 공용)
- onSubmit 콜백 패턴
- **홈 페이지 모듈화**
- 6개 컴포넌트 분리 (src/components/home/)
- 580줄 → 223줄 (62% 감소)
- **수정 모드 주제 변경 차단**
- TopicSelector readonly prop
- 데이터 무결성 보장
### Removed
- "새 글쓰기" 버튼 (write 페이지)
- 미사용 i18n 키 (newWriting, discardConfirm)
---
## [2025-11-20] - AI 이미지 생성 스타일 개선
### Changed
- **Imagen 4.0 Fast 업그레이드**
- **일관된 스타일 가이드**: 애니메이션/만화 스타일
- **한국 문화권 고려**: "Korean elementary student" 명시
- **Negative Prompt 강화**: 과도한 사실주의, 어두운 분위기 차단
- **키워드 개수 증가**: 6-12개
---
## [2025-11-19] - Draft 클라우드 동기화 및 팀 코드 개선
### Added
- **Draft 클라우드 동기화**
- localStorage + Realtime DB 하이브리드
- syncStatus 필드 ('local'|'synced'|'syncing')
- DraftManager: syncToCloud, loadDraftsFromCloud, mergeDrafts
- SavedDraftsDialog 배지 표시
- **팀 코드 예약 반환 로직**
- generate-code API: previousCode 파라미터
- 새 코드 받기 시 이전 예약 해제
- 중복 호출 방지 (isGeneratingCode)
### Changed
- **AI Delta 전송 로직 개선**
- diff-match-patch 도입
- 정확한 diff 계산
- 5자 미만 변경 누적
- 완화된 기준 (80%, 200자)
### Security
- **XSS 방지**: HTML Sanitization 구현 (sanitize-html)
- 백엔드 자동 세탁 (src/lib/server/writing.ts)
- 26개 유닛 테스트
---
## [2025-11-18] - 다국어 및 팀 코드 개선
### Added
- **팀 코드 다국어 생성**
- 언어별 단어 목록 (한국어/영어/일본어)
- generateTeamCode(locale)
- **Realtime DB 팀 코드 예약 시스템**
- teamCodeReservation.ts 서버 레이어
- Transaction 기반 atomic 예약
- 5분 TTL, onDisconnect 자동 정리
- Race condition 완전 방지
- **팀 나가기 기능**
- 팀 상세 페이지 "팀 나가기" 버튼
- POST /api/team/remove-member 권한 체크
- **Level 1 중복 체크 로직 (UID 기반)**
- Custom Token API (익명 계정만 발급)
- 정식 계정 탈취 방지
- **내가 쓴 글 목록 + 글 수정 기능**
- WritingCard 컴포넌트
- /writings 전체 글 목록 페이지
- /write 페이지 수정 모드 (?id=xxx)
- **주제별 학생 분석 API**
- GET /api/topic/[topicId]/writers
- TopicMemberAnalysisSection UI
### Changed
- **팀 관리 컴포넌트 다국어 완성**
- TeamTopicManager, LiveWritingMonitor
- StudentLoginFlow 일본어 번역
### Translations
- team.create, team.detail, team.manage 일본어 (126개 키)
- writings 섹션 (ko/en/ja, 22개 키)
- errors.team namespace (6개 키)
---
## [2025-11-17] - AI 이미지 생성 및 AI 설정 UI
### Added
- **AI 이미지 생성 시스템**
- Vertex AI Imagen 3.0 통합
- AI 장면 분리 기능 (Gemini Flash)
- AI 프롬프트 최적화 (키워드 추출)
- 4단계 플로우 (장면 추출 → 선택 → 최적화 → 생성)
- sceneExtractionService.ts, imagenService.ts, imageStorage.ts
- SceneSelector 컴포넌트
- GenerateImageDialog 개선
- **AI 설정 고급 UI**
- AIConfigDialog 컴포넌트
- Slider 3개 (멈춤 감지/최대 힌트/쿨다운)
- 커스텀 힌트 레벨 카드 (우상단 삼각형 인디케이터)
### Translations
- write.generateImage, write.extractScenes namespace (22개 키)
- team.manage.aiConfig namespace (28개 키, ko/en/ja)
---
## [2025-11-14] - 개별 글 분석 및 AI 도우미
### Added
- **개별 글 분석 결과 저장**
- Writing.analysis 필드
- SpellingError 타입
- generateWritingContentHash 유틸
- contentHash 기반 재분석 방지 (90% 비용 절감)
- **AI 글쓰기 도우미 시스템**
- 4단계 점진적 힌트 (질문 → 방향 → 선택지 → 예시)
- useWritingInactivityDetection 훅 (5분 멈춤 감지)
- InactivityPrompt, HintDisplay 컴포넌트
- writingAssistanceService.ts
- POST /api/writing-assistance
- GET/PUT /api/team/[teamId]/ai-config
- Team.aiAssistanceConfig 필드
### Changed
- 글쓰기 페이지: 저장 시 AI 분석 병렬 수행
- 실시간 분석 제거 (저장 시에만)
### Translations
- aiAssist namespace (19개 키, ko/en/ja)
---
## [2025-11-13] - 다국어 지원 시스템 (i18n)
### Added
- **next-intl 라이브러리** 설치 및 설정
- **[locale] 라우팅 구조**: /ko/*, /en/*, /ja/*
- **middleware.ts**: 브라우저 언어 자동 감지
- **3개 언어 번역 파일**: messages/ko.json, en.json, ja.json (각 407줄, 220+ 키)
- **LocaleSwitcher 드롭다운**: 국기 이모지, 체크 표시
### Changed
- **전체 페이지 번역**
- Navbar (4개 링크)
- Landing 페이지 (20+ 항목)
- Home, Write, Team 페이지
- 인증 컴포넌트 (70+ 항목)
- site.ts 텍스트 → 번역 파일로 이동
### Config
- next.config.ts: next-intl 플러그인
- i18n/routing.ts, i18n/request.ts 설정
- NEXT_LOCALE 쿠키 저장
---
## [2025-11-12] - 패턴 분석 캐싱 및 실시간 모니터링
### Added
- **Content Hash 기반 3단계 캐싱**
- L1: localStorage (영구, LRU 10개) ~1ms
- L2: Firestore patternAnalyses (영구) ~100ms
- L3: Server in-memory (5분, 50개) ~50ms
- AI 비용 절감 (전체 사용자 기준 1회 분석)
- **실시간 글쓰기 모니터링**
- Firebase Realtime Database 기반
- WritingSessionManager (5초 주기)
- LiveWritingMonitor 컴포넌트
- 3가지 상태 관리 (작성 중/나감/대기)
- 작성 속도 계산 (글자/분)
- Sparkline 그래프 (Area Chart)
- 30초 타임아웃 체크
- **Writing API 구현 완료**
- POST/GET/PUT/DELETE /api/writing
- src/lib/server/writing.ts (Firestore CRUD)
- **패턴 분석 - 팀 소유자 기능**
- 3가지 분석 타입 (self/by-team/by-topic)
- TopicMemberAnalysisSection UI
### Performance
- 캐시 히트: ~1ms (localStorage)
- 완전 무료 (Realtime DB 100명)
---
## [2025-11-11] - 실시간 피드백 시스템
### Added
- **Vertex AI 기반 텍스트 분석**
- POST /api/analyze-text
- Delta 전송 지원 (40% 비용 절감)
- Multi-region failover (3개 region)
- 서버 캐싱 (LRU, 1분)
- **Google AI SDK 마이그레이션**: @google-cloud/vertexai → @google/genai v1.29.0
- **텍스트 분석 평가 기준 개편**: 오감(4점) + 감정(2점) + 대화(2점) + 의성어(2점)
- **분석 히스토리 시스템**: Draft.analysisHistory (최대 5개)
- **맞춤법 검사 서비스**: spellingService.ts (독립 debounce 5초)
- **글 작성 패턴 분석**: WritingPatternDialog/Display
- **실시간 하이라이트**
- SpellingHighlight/SensoryWordHighlight Extensions
- EditorTooltip (Portal + ESC/외부 클릭)
- **Toast 알림**: 분석 시작/완료/실패
### Changed
- `descriptive``emotion`
- 프롬프트 최적화 (칭찬 강화, 제안 0~1개)
---
## [2025-11-10] - 5단계 보안 레벨 시스템
### Added
- **TeamSecurityLevel enum** (1-5)
- OPEN, NAME_LIST, AUTH_REQUIRED, EMAIL_LIST, CLOSED
- **명단 관리 API**
- POST/DELETE /api/team/:teamId/allowed-names
- POST/DELETE /api/team/:teamId/allowed-emails
- POST /api/team/:teamId/security-level
- **SecurityLevelSelector**: RadioCard 기반 UI
- **다중 글조각 관리**: DraftManager (최대 10개)
- **SavedDraftsDialog**: syncStatus 배지
### Changed
- **User 타입 최소화**
- FirestoreUser/User 분리
- Firebase Auth = Single Source of Truth
- **닉네임 저장 위치**: users.nicknames → team.members[uid].nickname
- **memberUids 제거**: Object.keys(members) 사용
### Removed
- useColorModeValue() 전체 제거 (Semantic token 사용)
### Translations
- securitySelector namespace (13개 키, ko/en/ja)
---
## [2025-11-07] - 매니저 패턴 API 전환
### Added
- **API 타입 시스템**: ApiResponse, HttpMethod Enum
- **클라이언트 캐싱**: BaseManager (TTL, 자동 무효화)
- **팀 주제 시스템**: 팀 소유자가 팀 주제 생성
- **API 명세서**: API_SPEC.md (23개 엔드포인트)
### Changed
- TeamManager, StudentManager → API 호출 방식
- Firestore 직접 호출 제거
- **아키텍처 단순화**: students → users 컬렉션, PIN 제거
- TopicSelector: 팀/개인 배지 표시
### Removed
- 그룹(Group) 기능 완전 제거
---
## [2025-11-06] - 팀 코드 시스템
### Added
- **한글 팀 코드 생성**: "춤추는 파란 사자"
- **Anonymous Auth**: Firebase 익명 로그인
- **teamService, studentService**: 백엔드 로직
- **PIN SHA-256**: 암호화 저장
- **정식 계정 연결**: linkWithCredential
- **팀 관리 UI**: 팀 목록, 생성, 멤버, 관리 페이지
- **학생 관리 기능**: 이름 수정, 강퇴 (Menu + Dialog)
### Changed
- 용어 변경: "클래스" → "팀", "교사" → "소유자"
- currentStudent 중심 authStore 재설계
- Semantic token 적극 활용
---
## [2025-10-31] - 개인 주제 생성 UI
### Added
- **CreateTopicDialog**: 태그 입력 필드
- 키보드 네비게이션
- 방향키 선택
- Backspace/Delete 삭제
---
## [2025-10-30] - 글쓰기 페이지 및 주제 선택
### Added
- **글쓰기 페이지**: Tiptap 순수 텍스트 에디터
- Editable 제목
- LocalStorage 자동 저장
- 하단 고정 버튼
- **Firestore 연동**: 글 저장/불러오기/삭제
- **Manager 패턴 도입**: WritingManager (싱글톤)
- **주제 선택 기능**
- TopicManager, TopicSelector
- 개인 주제 시스템
- 템플릿 미리채우기
---
## [2025-10-29] - 인증 기반 라우팅
### Added
- **인증 기반 라우팅**: `/``/home` 분리
- 자동 리다이렉트 구현
---
## [2025-10-28] - 회원가입 및 테마
### Added
- **회원가입 기능**
- LoginDialog 페이드 전환
- 비밀번호 강도 게이지
- HIBP API 연동
- **커스텀 테마**: Chakra UI v3 테마 시스템
- **SEO 최적화**: 메타데이터, OpenGraph, StructuredData
- **랜딩 페이지**: Hero, Features, How It Works, CTA
- **네비게이션**: Navbar, 다크모드 지원
---
## [2025-10-27] - 인증 시스템
### Added
- **로그인 기능**: 이메일/비밀번호
- **Google OAuth**: 소셜 로그인
- **상태 관리**: Zustand 인증 스토어
---
## [2025-10-26] - Firebase 연동
### Added
- **Firebase Auth**: 설정 및 초기화
---
## [2025-10-25] - 프로젝트 초기화
### Added
- **프로젝트 설정**: Next.js 16, React 19, TypeScript
---
## 범례
- **Added**: 새로운 기능
- **Changed**: 기존 기능 변경
- **Deprecated**: 곧 제거될 기능
- **Removed**: 제거된 기능
- **Fixed**: 버그 수정
- **Security**: 보안 관련 변경
- **Performance**: 성능 개선
- **Translations**: 다국어 번역 추가/수정
- **Config**: 설정 파일 변경
---
© 2024 BlueNovaLab. All rights reserved.