Skip to content

[Work 64] 약속 조회·정보 수정과 약속 목록 화면을 Firestore로 연동했습니다. - #38

Open
sangYuLv wants to merge 10 commits into
developfrom
WORK-64
Open

sangYuLv wants to merge 10 commits into
developfrom
WORK-64

Conversation

@sangYuLv

@sangYuLv sangYuLv commented Nov 6, 2026 •

Copy link
Copy Markdown
Collaborator

JIRA

📝 작업 내용

📌 요약

  • 약속 조회와 정보 수정의 Firestore 연동
  • 홈·약속 목록·지난 약속 화면의 더미 데이터를 실제 약속으로 교체
  • 마이페이지 약속별 알림 목록의 더미 데이터를 실제 약속으로 교체
  • 화면 진입마다 약속 목록 갱신
  • 에뮬레이터 시드에 내 계정용 테스트 약속 추가

🔍 상세

[1] 약속 조회·수정

  • FirebaseAppointmentRepository: 조회·정보 수정의 Mock 호출을 Firestore 직접 읽기·쓰기로 교체
  • AppointmentDocumentDTO: Firestore 약속 문서를 Appointment로 변환
  • UserRepository.fetchUsers(userIDs:): 참여자 프로필을 30개씩 나눠 in 질의로 일괄 조회

[2] 내 약속 목록

  • fetchMyAppointments(from:to:): 내가 참여한 약속을 기간으로 조회, 약속 시각 오름차순 반환
  • FetchMyAppointmentsUseCase: 목록 4곳에서 공용으로 사용
  • firestore.indexes.json: participantIDs + dateTime 복합 인덱스 추가

[3] 화면별 조회 범위 (모두 viewWillAppear마다 1회 조회)

  1. 홈: 지금 이후
  2. 약속 목록: 오늘 0시 이후, 오늘 약속과 예정된 약속으로 구분
  3. 지난 약속: 최근 30일 이내의 지난 약속, 최신순
  4. 마이페이지 약속별 알림: 지금 이후

[4] 조회 결과가 없거나 실패한 경우

  • 홈: 약속이 없으면 섹션 제목과 카드 영역 숨김
  • 홈·약속 목록·지난 약속: 조회 실패 시 알럿 표시, 기존 목록 유지
  • 마이페이지: 조회 실패 시 알럿 없이 이전 값 유지

[5] Mock·시드 정리

  • MockAppointmentRepository: 경로 Mock과 DEBUG 메뉴가 쓰는 static 값 3개만 남긴 enum으로 축소
  • seedEmulator.js: npm run seed -- <UID> 실행 시 오늘·예정·지난 약속과 30일이 넘은 약속 생성

[6] 아직 동작하지 않거나 임시인 부분

  • 약속 알림 토글은 유저 정보이므로 서버에 저장되지 않는 상태 (화면별 메모리에만 유지, 새 약속은 켜짐으로 시작)

💬 리뷰 노트

실서버 사용 전 인덱스 배포가 필요합니다

participantIDs와 dateTime을 함께 쓰는 목록 쿼리는 복합 인덱스가 필요합니다. 에뮬레이터에서는 인덱스 없이도 동작하지만, 실서버에서는 배포 전까지 목록 조회가 실패합니다.
이번 PR에서는 인덱스 파일만 추가했고, 배포는 하지 않았습니다.

firebase deploy --only firestore:indexes

테스트용 시드 데이터를 추가했습니다

약속 목록을 실제 데이터로 바꾸면서 화면을 확인할 약속이 필요해, 에뮬레이터 시드에 내 계정용 약속을 추가했습니다.
모든 약속은 나와 더미 사용자 2명이 참여하며, 장소는 같습니다.

약속 시각 표시되는 화면
[테스트] 오늘 1시간 뒤 (자정을 넘기지 않음) 홈, 약속 목록, 마이페이지
[테스트] 예정 3일 뒤 홈, 약속 목록, 마이페이지
[테스트] 지난 약속 3일 전 지난 약속
[테스트] 30일 넘게 지남 31일 전 표시되지 않음

에뮬레이터를 켜고 앱에서 로그인한 뒤, 아래 명령을 실행하면 됩니다. UID는 에뮬레이터 UI의 users 컬렉션에서 확인할 수 있습니다.

npm --prefix firebase/functions run seed -- <내 UID>

UID를 생략하면 코드 참여 확인용 더미 약속(DUMMY2)만 만듭니다. 다시 실행하면 시드 약속이 처음 상태로 돌아갑니다.

약속 응답과 문서의 DTO를 나눴습니다

callable 응답은 시간이 epoch 밀리초이고 참여자 프로필을 포함하지만, Firestore 문서는 시간이 Timestamp이고 참여자 ID만 있습니다.
입력 형식이 달라 AppointmentDocumentDTO를 따로 만들었고, 장소 변환은 기존 AppointmentDTO의 코드를 재사용했습니다.

추후 작업

  • 채팅방 약속 정보 실시간 반영(observeAppointment) : 채팅 API가 구현되지 않은 상태여서 작업 순서를 다시 검토하고 진행해보겠습니다.

📸 영상 / 이미지

확인한 내용

에뮬레이터 환경에서 시드 데이터로 다음 항목을 확인했습니다.

  • 화면별 약속 표시, 시각 순서, 참여 인원
  • 약속 정보 수정 후 다시 들어왔을 때 유지
  • 약속 생성·코드 참여·나가기 후 목록 갱신
  • 빈 화면 표시와 빈 상태에서 약속을 추가한 뒤의 홈 카드 배치 (아래 영상에는 없음)
WORK64.appointment.MP4

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 AI 코드 리뷰 - 종합(핵심) 관점

Mock 구현체를 제거하고 Firestore 직접 조회로 전환한 PR이다. fetchMyAppointments를 신규 추가하고 홈·약속 목록·지난 약속·마이페이지 4개 화면에 연동했다. 핵심 위험 요소는 두 가지다: viewWillAppear마다 Firestore 요청이 발생하는 구조로 화면 전환 빈도에 따라 불필요한 네트워크 비용이 발생하고, updateAppointment 구현이 필드 업데이트 후 fetchAppointment를 추가 호출하는 방식이라 쓰기-읽기 사이에 경쟁 조건이 존재한다. 또한 FetchMyAppointmentsUseCase 인스턴스가 DI에서 싱글톤으로 등록되지 않고 ScreenFactory에서 화면마다 새로 생성되어 동일 저장소가 N개의 인스턴스를 갖는다.

throw FirebaseErrorMapper.map(error)
}
}
return try await fetchAppointment(appointmentID: appointmentID)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[HIGH] [버그] updateAppointment는 Firestore에 필드를 쓴 뒤 fetchAppointment를 별도 요청으로 호출한다. Firestore는 쓰기가 완료된 직후에도 오프라인 캐시나 복제 지연으로 인해 직전 값을 돌려줄 수 있다. 쓴 값을 그대로 돌려줘야 한다면, updateData 성공 후 클라이언트가 이미 가진 필드 값을 조합해 반환하거나 트랜잭션으로 묶는 방식이 안전하다.

@sangYuLv sangYuLv Nov 7, 2026 •

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Firestore의 updateData는 쓰기가 완료(승인)된 후 종료됩니다.
리뷰에서 제시한 상황은 발생하지 않을 것으로 판단됩니다.

bindViewModel()
}

override func viewWillAppear(_ animated: Bool) {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[MEDIUM] [성능] viewWillAppear에서 loadAppointments()를 호출하므로 이 화면 위에 다른 화면이 올라갔다가 내려올 때마다 Firestore 쿼리가 실행된다. AppointmentList, PastAppointmentList, MyPage 세 화면도 동일 패턴이다. 화면 복귀 시마다 반드시 갱신이 필요한지 의도를 명확히 하고, 불필요한 경우 최초 1회나 명시적 새로고침 트리거로 제한하는 것이 바람직하다.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

의도한 동작입니다.
사용자의 약속 참여 여부, 약속 세부 정보 등이 여러 화면이 올라오고 내려오면서 수정될 가능성이 있습니다.
이에 따라 viewWillAppear에서 약속 목록을 새로 조회하도록 했습니다.


func makeHomeViewController() -> HomeViewController {
let viewModel = HomeViewModel(
fetchMyAppointmentsUseCase: FetchMyAppointmentsUseCase(

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[MEDIUM] [아키텍처] FetchMyAppointmentsUseCase가 makeHomeViewController, makeAppointmentListViewController, makePastAppointmentListViewController, makeMyPageViewController 각각에서 새 인스턴스로 생성된다. 같은 저장소를 감싸는 동일 유스케이스가 화면 수만큼 복제되므로, DI 컨테이너에 단일 인스턴스로 등록하고 주입받는 방식이 일관성 있다.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

현재 코드는 기존 프로젝트의 스크린 팩토리 패턴을 따르고 있습니다.
유즈케이스의 단일 인스턴스를 유지해야 한다면, 스크린 팩토리가 관리하도록 할 수 있습니다.
그렇지만 유즈케이스의 생성 비용이 크지 않아 스크린 팩토리가 굳이 여러 유즈케이스를 소유할 필요가 없다고 판단했습니다.

AppointmentDocumentDTO(id: $0.documentID, data: $0.data())
}
// 약속마다 조회하지 않도록 참여자를 모아 한 번에 읽는다
let usersByID = try await userRepository.fetchUsers(userIDs: Set(dtos.flatMap(\.participantIDs)))

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[MEDIUM] [성능] fetchMyAppointments에서 모든 약속의 participantIDs를 합쳐 한 번에 fetchUsers를 호출하는 방식은 좋다. 단, Firestore in 질의는 한 번에 최대 30개까지만 허용되고 FirestoreUserRepository.fetchUsers가 이를 청크로 나눠 순차 실행한다. 약속 수가 많을 때 참여자 ID가 30을 넘으면 청크 수만큼 직렬 요청이 발생한다. 현재 구조에서 병렬 처리(async let 또는 withTaskGroup)를 적용할 여지가 있다.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

참여자가 30명을 넘어 조회 묶음이 여러 개가 되면, 그중 일부 묶음만 실패해도 fetchUsers 전체가 실패합니다. 이미 성공한 묶음의 결과도 쓰지 않으므로, 약속 목록이나 약속 정보를 불러오는 조회 자체가 실패합니다. 이때 시작된 다른 요청이 끝난 뒤에야 실패 알럿이 표시될 수 있습니다.

다만 저희 서비스에서 참여자가 30명을 넘는 약속이 생기는 일은 흔하지 않다고 생각했습니다. 묶음이 하나면 이 문제가 생기지 않고, 실패하더라도 화면에 다시 들어올 때 재조회됩니다. 일부 결과만 보여 주면 참여자나 인원수가 조용히 틀어질 수 있어, 지금처럼 전체를 실패로 처리하는 동작을 유지하겠습니다.

수정 커밋

@sangYuLv
sangYuLv added this pull request to stack #40 November 16, 2026 07:05

@snughnu snughnu left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

확인했습니다. 수고하셨어요! 🙊

Comment on lines +82 to +83
// 약속마다 조회하지 않도록 참여자를 모아 한 번에 읽는다
let usersByID = try await userRepository.fetchUsers(userIDs: Set(dtos.flatMap(\.participantIDs)))

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

목록 화면 4곳(홈·약속 목록·지난 약속·마이페이지)의 Appointment에서 participants.count만 쓰고 프로필 정보는 쓰지 않는다고 보이는데, 참여자 프로필을 읽는 비용이 좀 아깝다는 생각이 들었습니다..!

  • viewWillAppear마다 조회하니까, 화면에 들어갈 때마다 약속 수에 참여자 수만큼 Firestore 읽기가 더해지는 것 같아요.
  • 약속 쿼리가 끝나야 사용자 쿼리를 시작할 수 있어서, 목록이 뜨기까지 왕복이 두 번 필요해 보입니다.

그래서 목록용으로는 AppointmentSummary(id, name, dateTime, place, participantCount) 같은 가벼운 모델을 두는 방향은 어떨까요? participantIDs.count로 인원 수를 채우고, fetchUsers는 참여자 프로필이 필요한 fetchAppointment에서만 호출하는 식으로요

꼭 지금 반영될 필요는 없지만, 생각나서 한번 말씀드려봅니다!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants