[Android] 🔥 Firebase 프로젝트 및 데이터베이스 구축 가이드

Last Updated: 2026년 10월 31일

Firebase 데이터베이스 무료 제공량은 아래와 같다. 모임 앱 특성상 일상적인 지출, 일정, 게시판, 투표 등록은 하루에 수십~수백건이라서 무료 한도의 1~5%도 채우기 어렵다. 고로 충분히 사용가능하다고 생각한다.
저장 용량 : 1GB, 문서 쓰기 : 20K/day, 문서 읽기 : 50K/day, 문서 삭제 : 20K/day, 네트워크 : 10GB/month

1단계: Firebase 콘솔 프로젝트 생성 및 설정

1. Firebase 콘솔에 접속하여 로그인합니다.
2. [프로젝트 추가]를 클릭하고 프로젝트 이름(예: TguBio90)을 입력합니다.
3. 구글 애널리틱스 설정은 필요에 따라 켜거나 끈 뒤 [프로젝트 만들기]를 완료합니다.
4. 프로젝트 대시보드에서 [Android 아이콘]을 눌러 안드로이드 앱을 등록합니다.
   • 패키지 이름: 안드로이드 스튜디오 프로젝트의 build.gradle.kts에 있는 applicationId와 정확히 일치시켜야 합니다 (예: com.example.tgubio90).
   • google-services.json 파일을 다운로드하여 프로젝트의 app/ 폴더 하단에 배치합니다.

2단계: 인증(Authentication) 설정

모임 회원들이 로그인하고 앱을 사용할 수 있도록 인증 방식을 활성화합니다.

1. 왼쪽 메뉴에서 Build > Authentication으로 이동합니다.
2. [시작하기]를 누릅니다.
3. Sign-in method(로그인 방법) 탭에서 사용할 인증 방식(예: Google 또는 이메일/비밀번호)을 선택하고 사용 설정(Enable)을 완료합니다.

3단계: Cloud Firestore 데이터베이스 생성

1. 왼쪽 메뉴에서 Build > Cloud Firestore로 이동합니다.
2. [데이터베이스 만들기]를 클릭합니다.
3. 데이터베이스 위치(asia-northeast3 서울 추천)를 선택합니다.
4. 보안 규칙은 초기 테스트를 위해 테스트 모드(Test mode)로 시작한 뒤, 나중에 인증된 사용자만 접근하도록 규칙을 강화합니다.

4단계: Firestore 컬렉션 및 문서 구조 설계 (핵심)

현재 앱에서 사용 중인 구조는 모임별로 데이터를 격리하기 위해 최상위에 groups 컬렉션을 두고, 그 아래에 모임 ID(tgubio90) 문서를 두어 하위 컬렉션들을 관리하는 구조입니다.

Firestore Root
 └── groups (Collection)
      └── tgubio90 (Document - 모임 ID)
           ├── members (Collection) : 회원 목록
           ├── expenses (Collection) : 회비 지출 내역
           └── schedules (Collection) : 모임 일정 및 연동 정보

📝 1. members 컬렉션 (회원 관리)

회원들의 정보와 역할을 저장합니다.

• 경로: groups/tgubio90/members/{memberId}
• 주요 필드:
  • name (String): 회원 이름 (예: “바이오90”)
  • role (String): 직책 또는 권한 (예: “총무”, “회원”)
  • joinedDate (Number 또는 Timestamp): 가입일

💸 2. expenses 컬렉션 (회비 지출 내역)

모임 회비 사용 내역과 참석자 정보를 기록합니다. (업로드해주신 이미지의 구조 기반)

• 경로: groups/tgubio90/expenses/{expenseId}
• 주요 필드:
  • amount (Number): 지출 금액 (예: 58258)
  • attendees (String 또는 Array): 참석자 명단 (예: "신규신청자,바이오90")
  • date (Number 또는 Timestamp): 지출 날짜 (1793113200000 등)
  • description 또는 title (String): 지출 내역 설명

📅 3. schedules 컬렉션 (일정 관리 및 지출 연동)

모임 일정 정보를 저장하며, 지출 내역과 ID로 연동(Fee ➔ Schedule)되도록 설계되었습니다.

• 경로: groups/tgubio90/schedules/{scheduleId}
• 주요 필드:
  • title (String): 일정 제목 (예: “정기 모임”)
  • date (Number 또는 Timestamp): 일정 날짜
  • location (String): 모임 장소

5단계: 안드로이드 프로젝트 연동 체크리스트

1. build.gradle.kts (project): Google Services 플러그인 버전 설정
2. build.gradle.kts (app):
   • Firebase BoM(firebase-bom) 및 Firestore, Auth 라이브러리 추가
   • google-services 플러그인 적용 (id("com.google.gms.google-services"))
3. 동기화(Sync) 후 앱을 실행하여 Firestore에 데이터가 정상적으로 읽히고 쓰이는지 확인합니다.