D-Log는 사용자가 일상의 순간들을 짧은 영상으로 기록하고, 영상 클립에 대한 메모를 추가하여 자신만의 비디오 다이어리를 만들 수 있는 웹 애플리케이션입니다. 기록된 영상과 메모는 Firebase에 안전하게 저장되며, 언제든 다시 보고 관리할 수 있습니다.
- 영상 녹화: 웹캠 또는 모바일 카메라(후면 기본)를 사용하여 짧은 영상 클립을 녹화합니다.
- 카메라 전환: 모바일 환경에서 전/후면 카메라를 전환할 수 있습니다.
- 메모 작성 및 수정: 영상 녹화 후 하나의 메모를 작성할 수 있으며, 상세 화면에서 언제든지 수정할 수 있습니다.
- Firebase 연동:
- 녹화된 영상과 썸네일은 Firebase Storage에 업로드됩니다.
- 영상 URL, 썸네일 URL, 메모 등 메타데이터는 Firestore에 저장됩니다.
- 클립 타임라인: 저장된 클립 목록을 날짜별로 정렬하여 보여줍니다.
- 클립 상세 보기: 클립을 재생하고, 작성된 메모를 확인하고 수정할 수 있습니다.
- 클립 삭제: 저장된 클립(영상, 썸네일, 메타데이터)을 영구적으로 삭제합니다.
- 반응형 UI: 모바일 환경에서도 최적화된 사용자 경험을 제공합니다.
- Framework: React (with Vite)
- Language: TypeScript
- Styling: Tailwind CSS
- UI Components: shadcn/ui
- State Management: React Hooks (useState, useEffect, useRef)
- Notifications: Sonner (Toast)
- Authentication: Firebase Authentication (Anonymous Login)
- Database: Firestore (NoSQL Document Database)
- File Storage: Firebase Storage (for video clips and thumbnails)
- Frontend Hosting: Vercel
프로젝트는 frontend와 backend 두 개의 하위 폴더로 구성된 모노레포(Monorepo) 형태로 관리됩니다.
.
├── frontend/ # React 기반의 웹 애플리케이션 코드
│ ├── public/
│ ├── src/
│ ├── package.json
│ └── ...
├── backend/ # (예정) 영상 병합 등 서버리스 기능 구현 (Google Cloud Run)
├── .git/ # Git 저장소 정보
├── .gitignore # Git 추적 제외 파일 설정
├── .gemini_ignore # Gemini CLI 추적 제외 파일 설정
├── README.md # 프로젝트 설명 (현재 파일)
└── ...
git clone https://github.com/TheDeveperKwon/D-Log.git
cd D-Log- Firebase 프로젝트 생성: Firebase Console에서 새 프로젝트를 생성합니다.
- 웹 앱 등록: 프로젝트 설정(⚙️) > General > Your apps 섹션에서 웹 앱(
</>)을 등록하고firebaseConfig객체 정보를 복사합니다. - .env 파일 생성:
frontend폴더 내에.env파일을 생성하고, 복사한firebaseConfig정보를 아래 형식으로 붙여넣습니다.VITE_FIREBASE_API_KEY="YOUR_API_KEY" VITE_FIREBASE_AUTH_DOMAIN="YOUR_AUTH_DOMAIN" VITE_FIREBASE_PROJECT_ID="YOUR_PROJECT_ID" VITE_FIREBASE_STORAGE_BUCKET="YOUR_STORAGE_BUCKET" VITE_FIREBASE_MESSAGING_SENDER_ID="YOUR_MESSAGING_SENDER_ID" VITE_FIREBASE_APP_ID="YOUR_APP_ID" VITE_FIREBASE_MEASUREMENT_ID="YOUR_MEASUREMENT_ID" # 선택 사항
- Firebase 서비스 활성화:
- Authentication: Build > Authentication > Get started > Sign-in method 탭 > Anonymous 활성화
- Firestore Database: Build > Firestore Database > Create database > Production mode > 위치 선택 > Enable
- Storage: Build > Storage > Get started > Production mode > 위치 선택 > Done
Firebase 콘솔에서 각 서비스의 Rules 탭으로 이동하여 아래 규칙을 붙여넣고 Publish 합니다.
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /users/{userId}/clips/{clipId} {
allow read, write: if request.auth != null && request.auth.uid == userId;
}
}
}rules_version = '2';
service firebase.storage {
match /b/{bucket}/o {
match /videos/{userId}/{allPaths=**} {
allow read, write: if request.auth != null && request.auth.uid == userId;
}
match /thumbnails/{userId}/{allPaths=**} {
allow read, write: if request.auth != null && request.auth.uid == userId;
}
}
}브라우저에서 Storage로 파일을 업로드하기 위해 CORS 설정을 해야 합니다.
- 프로젝트 루트에
cors.json파일을 생성하고 아래 내용을 붙여넣습니다.[ { "origin": [ "http://localhost:5173", "https://<내-vercel-앱-주소>.vercel.app" ], "method": ["GET", "POST", "PUT", "HEAD"], "responseHeader": [ "Content-Type", "x-goog-resumable" ], "maxAgeSeconds": 3600 } ] - Google Cloud CLI를 설치하고
gcloud init으로 로그인합니다. - 터미널에서 아래 명령어를 실행합니다. (
<버킷_주소>는 Firebase 콘솔 Storage 탭에서 확인)gsutil cors set cors.json gs://<버킷_주소>
cd frontend
npm install
npm run dev- GitHub 저장소 연결: Vercel 대시보드에서 GitHub 저장소를 연결합니다.
- Root Directory 설정: 프로젝트 설정에서 Root Directory를
frontend로 변경합니다. - 환경 변수 설정: Vercel 프로젝트 설정의 Environment Variables에
.env파일의VITE_FIREBASE_API_KEY등 모든 Firebase 관련 환경 변수를 추가합니다. - 배포가 완료되면 Vercel이 제공하는 URL을
cors.json에 추가하고gsutil명령어를 다시 실행해야 합니다.
- 영상 병합 기능 구현 시 Google Cloud Run에 배포될 예정입니다.
- 하루 영상 자동 병합: 하루 동안 기록된 여러 개의 클립을 하나의 영상으로 자동 병합합니다.
- 메모 기반 자동 자막 생성: 작성된 메모를 영상 길이에 맞춰 자동으로 자막을 생성하고, 적절한 타이밍에 표시합니다.
- 영상 다듬기 (컷 편집): 사용자가 직접 영상의 불필요한 부분을 잘라낼 수 있는 기능을 제공합니다.
- 배경음악 추가: 사용자가 원하는 음악을 배경음악으로 추가하거나, 앱에서 제공하는 라이브러리에서 선택할 수 있습니다.
- 위치/시간 표시: 영상 상단에 촬영 당시의 위치와 시간 정보를 작게 표시합니다.
- 이동 경로 CG 애니메이션: 촬영 시 수집된 위치 정보를 바탕으로, 하루의 이동 경로를 지도 위에 애니메이션으로 시각화하여 영상 인트로에 추가합니다.
- 날씨 정보 자동 추가: 위치 정보 기반으로 날씨 API를 호출하여, 당시의 날씨(아이콘 등)를 기록하고 영상에 오버레이로 추가합니다.
- AI 자동 하이라이트 영상: AI가 영상들을 분석하여, 표정이 밝거나 움직임이 많은 부분 등 흥미로운 순간만 자동으로 모아 별도의 하이라이트 영상을 제작합니다.
- 메모 감성 분석 및 음악 추천: 메모의 텍스트를 자연어 처리 기술로 분석하여, 글의 감성(기쁨, 슬픔 등)에 어울리는 배경음악을 자동으로 추천합니다.
- '작년 오늘' 기능: 앱 접속 시, 1년 전 같은 날에 기록했던 영상을 보여주어 사용자의 재방문을 유도하고 추억을 상기시킵니다.
- 계정 연동: 익명 계정을 이메일, 소셜 로그인 등 영구적인 계정으로 전환하여 여러 기기에서 데이터를 동기화할 수 있도록 합니다.