docs: Sync documentation from private repository

This commit is contained in:
Documentation Bot 2026-05-15 06:54:29 +00:00
parent 34cc84462e
commit df55a605e2
4 changed files with 13 additions and 13 deletions

View File

@ -38,7 +38,7 @@
### Changed
- Vertex AI 클라이언트: 싱글톤 패턴으로 인스턴스 재사용
- Vertex AI 모델 업그레이드: gemini-1.5-flash → gemini-2.5-flash
- Vertex AI 모델 업그레이드: gemini-1.5-flash → gemini-3.1-flash-lite
- InspirationCard: Unsplash 크레딧 표시 제거 (저장은 유지)
### Fixed

View File

@ -129,7 +129,7 @@
| **글쓰기 모드 선택 기능** | **모드 선택 화면 추가 (글부터 쓰기 / 그림부터 올리기), URL 파라미터로 모드 관리 (?mode=wrt\|img), ImageDropzone 컴포넌트 (드래그앤드롭 이미지 업로드, 미리보기), ImageFirstLayout 컴포넌트 (이미지+에디터 2컬럼 레이아웃), pendingImageStore 유틸리티 (IndexedDB 기반 이미지 임시 저장, 새로고침해도 유지), 캐릭터 이미지 추가 (startWriting.png, uploadImage.png), 카드 디자인 개선 (그라데이션 배경, 상단 장식 바, 제목 배지, 호버 애니메이션, 이미지 크기 증가 180→240px), 다크 모드 지원, 다국어 지원 (modeSelection namespace, ko/en/ja)** | **2025-12-01** |
| **Container 레이아웃 확장** | **Container maxW를 1200px → 1400px로 확장 (가용 공간 증가)** | **2025-12-02** |
| **피드 시스템 구축** | **피드 관련 타입 정의 (Inspiration, DailyPrompt, WeeklyStats, TeamActivity), API 엔드포인트 4개 추가 (daily-prompt, inspirations, weekly-stats, team-activity), 오늘의 글감 컴포넌트 (TodayTopicCard, 매일 새 주제 제안), 주간 목표 컴포넌트 (WeeklyGoalCard, 목표 글 수 설정/진행률 표시), 최근 활동 컴포넌트 (RecentActivityCard, 팀 활동 요약), 추천 영감 컴포넌트 (InspirationCard, grid/horizontal 레이아웃), FeedManager 추가 (데이터 관리, 캐싱 로직), 일일 영감 자동 생성 (Cloud Function - generateDailyInspirations, 매일 새벽 실행), Vertex AI 연동 (Gemini 2.5 Flash, 한국어 영감 생성), Unsplash API 연동 (이미지 검색, 다운로드, Storage 저장, 크레딧 정보 저장), CompactCardsRow 컴포넌트 (주간 목표+최근 활동 가로 배치), 글쓰기 페이지 통합 (모드 선택 후 피드 표시), 다국어 지원 (feed namespace 23개 키, ko/en/ja), FeedCompactCard 공통 컴포넌트** | **2025-12-02** |
| **영감 수동 생성 기능** | **HTTP 함수 추가 (POST /generateInspirationsManual, 관리자 수동 생성), Vertex AI 클라이언트 라이브러리 변경 (@google-cloud/vertexai → @google/genai v1.29.0), Vertex AI 모델 업그레이드 (gemini-1.5-flash → gemini-2.5-flash), Unsplash API 키를 Secret Manager로 관리, Vertex AI 클라이언트 초기화 로직 개선 (싱글톤 패턴, 인스턴스 재사용), Unsplash 이미지 검색 및 다운로드 로직 추가 (Storage 업로드), 영감 생성 시 Unsplash 크레딧 정보 저장 (InspirationCard에서 표시 제거), API 호출 간격 추가 (Rate limit 방지 1초), 기존 영감 덮어쓰기 옵션 (재요청 시 삭제), 에러 로깅 강화, functions/tsconfig.json skipLibCheck 옵션 추가** | **2025-12-02** |
| **영감 수동 생성 기능** | **HTTP 함수 추가 (POST /generateInspirationsManual, 관리자 수동 생성), Vertex AI 클라이언트 라이브러리 변경 (@google-cloud/vertexai → @google/genai v1.29.0), Vertex AI 모델 업그레이드 (gemini-1.5-flash → gemini-3.1-flash-lite), Unsplash API 키를 Secret Manager로 관리, Vertex AI 클라이언트 초기화 로직 개선 (싱글톤 패턴, 인스턴스 재사용), Unsplash 이미지 검색 및 다운로드 로직 추가 (Storage 업로드), 영감 생성 시 Unsplash 크레딧 정보 저장 (InspirationCard에서 표시 제거), API 호출 간격 추가 (Rate limit 방지 1초), 기존 영감 덮어쓰기 옵션 (재요청 시 삭제), 에러 로깅 강화, functions/tsconfig.json skipLibCheck 옵션 추가** | **2025-12-02** |
| **GlassCard 컴포넌트 도입** | **GlassCard 컴포넌트 추가 (반투명 배경, 블러 효과, 시각적 통일성), FeedCompactCard → GlassCard로 전체 리팩토링, TodayTopicCard/WeeklyGoalCard/RecentActivityCard에 GlassCard 적용, 로딩 스켈레톤 UI 추가 (모든 카드), InspirationCard variant prop 추가 (vertical/horizontal), InspirationSection layout prop 추가 (grid/horizontal), ModeSelectionCards 컴포넌트 신규 추가 (글쓰기 모드 선택 카드), write 페이지 모드 선택 UI 개선, CompactCardsRow에서 compact prop 제거** | **2025-12-02** |
| **UI/UX 세부 개선** | **ModeSelectionCard 이미지 드롭 쉐도우 효과 추가, 전환 효과를 transform → all로 변경 (부드러운 애니메이션), 이미지 상하 패딩 조정** | **2025-12-02** |
| **Tlab신영복체 폰트 적용** | **Tlab신영복체.ttf 폰트 파일 추가 (public/fonts/), globals.css에 @font-face 추가, write 페이지 제목 텍스트에 폰트 적용, WeeklyGoalCard 스켈레톤 UI 개선 (헤더 및 진행 상태 레이아웃 간격 조정), GlassCard 내부 패딩 조정** | **2025-12-02** |

View File

@ -765,9 +765,9 @@ Region 3개 = 45 RPM (3배)
```
**Region 선택 전략**:
1. **asia-northeast1** (도쿄) - 한국 최근접 (~50ms) 🥇
2. **asia-southeast1** (싱가포르) - 백업 (~100ms) 🥈
3. **us-central1** (미국) - 최종 대체 (~200ms) 🥉
1. **global** - Vertex AI 글로벌 엔드포인트 (자동 라우팅) 🥇
2. **us** - 미국 멀티 리전 🥈
3. **eu** - 유럽 멀티 리전 🥉
#### 💰 비용 영향

View File

@ -751,20 +751,20 @@ const [selectedPartIndex, setSelectedPartIndex] = useState<number | null>(null);
**사용 가능한 Regions** (우선순위 순):
```
1. asia-northeast1 (도쿄) - 한국 최근접, ~50ms 🥇
2. asia-southeast1 (싱가포르) - 백업, ~100ms 🥈
3. us-central1 (미국) - 최종 대체, ~200ms 🥉
1. global - Vertex AI 글로벌 엔드포인트 (자동 라우팅) 🥇
2. us - 미국 멀티 리전 🥈
3. eu - 유럽 멀티 리전 🥉
```
**장애 시나리오**:
```
요청 → 도쿄 region
요청 → global endpoint
↓ 429 Rate Limit
도쿄를 1분간 "과부하" 마킹
global을 1분간 "과부하" 마킹
다음 요청 → 싱가포르 (자동 전환)
다음 요청 → us (자동 전환)
↓ 성공 ✅
계속 싱가포르 사용
계속 us 사용
↓ 1분 후
도쿄 자동 복구
@ -1456,7 +1456,7 @@ const improvementRate = calculateImprovementRate(spellingErrorsHistory);
**기술 스택**:
- **Vertex AI Imagen 4.0 Fast**: Google 최신 이미지 생성 모델
- **Gemini 2.5 Flash**: 장면 추출 및 프롬프트 최적화
- **Multi-region Failover**: us-east5 → us-south1 → us-central1
- **Multi-region Failover**: global → us → eu
#### 일관된 스타일 가이드 (2025-11-20 개선)