Skip to content
zest-swPublic

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

24 Commits

Folders and files

Repository files navigation

D-Log: 간편 비디오 다이어리 앱

🚀 프로젝트 소개

D-Log는 사용자가 일상의 순간들을 짧은 영상으로 기록하고, 영상 클립에 대한 메모를 추가하여 자신만의 비디오 다이어리를 만들 수 있는 웹 애플리케이션입니다. 기록된 영상과 메모는 Firebase에 안전하게 저장되며, 언제든 다시 보고 관리할 수 있습니다.

✨ 주요 기능 (MVP)

  • 영상 녹화: 웹캠 또는 모바일 카메라(후면 기본)를 사용하여 짧은 영상 클립을 녹화합니다.
  • 카메라 전환: 모바일 환경에서 전/후면 카메라를 전환할 수 있습니다.
  • 메모 작성 및 수정: 영상 녹화 후 하나의 메모를 작성할 수 있으며, 상세 화면에서 언제든지 수정할 수 있습니다.
  • Firebase 연동:
    • 녹화된 영상과 썸네일은 Firebase Storage에 업로드됩니다.
    • 영상 URL, 썸네일 URL, 메모 등 메타데이터는 Firestore에 저장됩니다.
  • 클립 타임라인: 저장된 클립 목록을 날짜별로 정렬하여 보여줍니다.
  • 클립 상세 보기: 클립을 재생하고, 작성된 메모를 확인하고 수정할 수 있습니다.
  • 클립 삭제: 저장된 클립(영상, 썸네일, 메타데이터)을 영구적으로 삭제합니다.
  • 반응형 UI: 모바일 환경에서도 최적화된 사용자 경험을 제공합니다.

🛠️ 기술 스택

Frontend

  • Framework: React (with Vite)
  • Language: TypeScript
  • Styling: Tailwind CSS
  • UI Components: shadcn/ui
  • State Management: React Hooks (useState, useEffect, useRef)
  • Notifications: Sonner (Toast)

Backend (Firebase)

  • Authentication: Firebase Authentication (Anonymous Login)
  • Database: Firestore (NoSQL Document Database)
  • File Storage: Firebase Storage (for video clips and thumbnails)

Deployment

  • 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           # 프로젝트 설명 (현재 파일)
└── ...

🚀 시작하기 (로컬 개발 환경)

1. 저장소 클론

git clone https://github.com/TheDeveperKwon/D-Log.git
cd D-Log

2. Firebase 프로젝트 설정

  1. Firebase 프로젝트 생성: Firebase Console에서 새 프로젝트를 생성합니다.
  2. 웹 앱 등록: 프로젝트 설정(⚙️) > General > Your apps 섹션에서 웹 앱(</>)을 등록하고 firebaseConfig 객체 정보를 복사합니다.
  3. .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" # 선택 사항
  4. 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

3. Firebase 보안 규칙 설정 (Firestore & Storage)

Firebase 콘솔에서 각 서비스의 Rules 탭으로 이동하여 아래 규칙을 붙여넣고 Publish 합니다.

Firestore Rules

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;
    }
  }
}

Storage Rules

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;
    }
  }
}

4. Firebase Storage CORS 설정

브라우저에서 Storage로 파일을 업로드하기 위해 CORS 설정을 해야 합니다.

  1. 프로젝트 루트에 cors.json 파일을 생성하고 아래 내용을 붙여넣습니다.
    [
      {
        "origin": [
          "http://localhost:5173",
          "https://<내-vercel-앱-주소>.vercel.app"
        ],
        "method": ["GET", "POST", "PUT", "HEAD"],
        "responseHeader": [
          "Content-Type",
          "x-goog-resumable"
        ],
        "maxAgeSeconds": 3600
      }
    ]
  2. Google Cloud CLI를 설치하고 gcloud init으로 로그인합니다.
  3. 터미널에서 아래 명령어를 실행합니다. (<버킷_주소>는 Firebase 콘솔 Storage 탭에서 확인)
    gsutil cors set cors.json gs://<버킷_주소>

5. 프론트엔드 의존성 설치 및 실행

cd frontend
npm install
npm run dev

🚀 배포

Frontend (Vercel)

  1. GitHub 저장소 연결: Vercel 대시보드에서 GitHub 저장소를 연결합니다.
  2. Root Directory 설정: 프로젝트 설정에서 Root Directory를 frontend 로 변경합니다.
  3. 환경 변수 설정: Vercel 프로젝트 설정의 Environment Variables에 .env 파일의 VITE_FIREBASE_API_KEY 등 모든 Firebase 관련 환경 변수를 추가합니다.
  4. 배포가 완료되면 Vercel이 제공하는 URL을 cors.json에 추가하고 gsutil 명령어를 다시 실행해야 합니다.

Backend (Google Cloud Run - 예정)

  • 영상 병합 기능 구현 시 Google Cloud Run에 배포될 예정입니다.

💡 향후 발전 계획 (로드맵)

Backend Core (MVP)

  • 하루 영상 자동 병합: 하루 동안 기록된 여러 개의 클립을 하나의 영상으로 자동 병합합니다.
  • 메모 기반 자동 자막 생성: 작성된 메모를 영상 길이에 맞춰 자동으로 자막을 생성하고, 적절한 타이밍에 표시합니다.

영상 편집 기능

  • 영상 다듬기 (컷 편집): 사용자가 직접 영상의 불필요한 부분을 잘라낼 수 있는 기능을 제공합니다.
  • 배경음악 추가: 사용자가 원하는 음악을 배경음악으로 추가하거나, 앱에서 제공하는 라이브러리에서 선택할 수 있습니다.

정보 오버레이 및 시각화

  • 위치/시간 표시: 영상 상단에 촬영 당시의 위치와 시간 정보를 작게 표시합니다.
  • 이동 경로 CG 애니메이션: 촬영 시 수집된 위치 정보를 바탕으로, 하루의 이동 경로를 지도 위에 애니메이션으로 시각화하여 영상 인트로에 추가합니다.
  • 날씨 정보 자동 추가: 위치 정보 기반으로 날씨 API를 호출하여, 당시의 날씨(아이콘 등)를 기록하고 영상에 오버레이로 추가합니다.

AI 기반 스마트 기능

  • AI 자동 하이라이트 영상: AI가 영상들을 분석하여, 표정이 밝거나 움직임이 많은 부분 등 흥미로운 순간만 자동으로 모아 별도의 하이라이트 영상을 제작합니다.
  • 메모 감성 분석 및 음악 추천: 메모의 텍스트를 자연어 처리 기술로 분석하여, 글의 감성(기쁨, 슬픔 등)에 어울리는 배경음악을 자동으로 추천합니다.

사용자 경험

  • '작년 오늘' 기능: 앱 접속 시, 1년 전 같은 날에 기록했던 영상을 보여주어 사용자의 재방문을 유도하고 추억을 상기시킵니다.
  • 계정 연동: 익명 계정을 이메일, 소셜 로그인 등 영구적인 계정으로 전환하여 여러 기기에서 데이터를 동기화할 수 있도록 합니다.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages