Skip to content

FEATURE_SPECIFICATION.md

Latest commit

 

History

History
836 lines (563 loc) · 22.3 KB

FEATURE_SPECIFICATION.md

File metadata and controls

836 lines (563 loc) · 22.3 KB

기도함께 (Pray Together) - 기능 정의서

작성일: 2025-12-06 버전: 2.1 목적: 프로젝트의 기능을 사용자 관점에서 정의하고, 향후 기획 및 개발의 기준점으로 활용

목차

  1. 서비스 개요
  2. 사용자 여정
  3. 기능 목록
  4. 화면 구성
  5. 기능 명세
  6. 비즈니스 규칙
  7. 향후 개선 방향

1. 서비스 개요

1.1 서비스 소개

기도함께는 기도방을 만들고, 함께 기도 제목을 공유하며 서로의 기도를 응원하는 모바일 애플리케이션입니다.

1.2 핵심 가치

  • 함께: 혼자가 아닌 함께 기도하는 경험
  • 나눔: 기도 제목을 나누고 응원하는 공동체
  • 알림: 기도 완료 시 서로에게 알림으로 응원 전달

1.3 타겟 사용자

  • 기독교 신앙을 가진 사용자
  • 기도 제목을 함께 나누고 싶은 소그룹 (가족, 지인, 교회 소모임 등)
  • 서로의 기도를 응원하고자 하는 사용자

1.4 플랫폼

  • iOS (아이폰, 아이패드)
  • Android (안드로이드 스마트폰, 태블릿)

2. 사용자 여정

2.1 신규 사용자 온보딩

1. 회원가입
   ├─ 이메일로 인증번호 받기
   ├─ 인증번호 입력하여 본인 확인
   ├─ 이름, 비밀번호 입력
   └─ 전화번호 등록

2. 로그인
   └─ 이메일과 비밀번호로 로그인

3. 첫 화면
   └─ 기도방 목록 (처음에는 비어있음)

2.2 기본 사용 흐름

[기도방 만들기 또는 참여하기]
1. 기도방 만들기 또는 초대받아 참여하기
2. 기도방 입장

[기도 제목 작성]
3. 기도방 내에서 "기도제목 작성하기" 버튼 클릭
4. 기도 제목 입력
5. 함께 기도할 멤버 선택
6. 각 멤버를 위한 구체적인 기도 내용 작성
7. 저장

[기도하기]
8. 작성된 기도 제목 선택
9. 기도 내용 확인하며 기도
10. 기도 완료 시 "기도 알림" 버튼 클릭
11. 기도방 멤버들에게 "OOO님이 기도했어요" 알림 전송

2.3 초대 흐름

1. 기도방 초대
   ├─ 기도방 상세 화면에서 멤버 관리
   ├─ 회원 검색 (이름으로)
   └─ 초대 보내기

2. 초대 응답
   ├─ 마이페이지 > 초대 목록에서 확인
   └─ 수락 또는 거절

3. 기능 목록

3.1 회원 가입 및 인증

3.1.1 회원가입

  • 기능: 이메일 인증을 통한 회원가입
  • 필수 정보: 이름, 이메일, 비밀번호, 전화번호
  • 절차:
    1. 이메일 입력 → 인증번호 발송
    2. 인증번호 입력하여 본인 확인
    3. 이름, 비밀번호, 전화번호 입력
    4. 회원가입 완료

3.1.2 로그인

  • 기능: 이메일과 비밀번호로 로그인
  • 자동 로그인: 한 번 로그인하면 다음에는 자동으로 로그인됨
  • 로그인 유지: 앱을 껐다 켜도 로그인 상태 유지

3.1.3 로그아웃

  • 기능: 로그아웃하여 계정 보안 유지
  • 동작: 로그아웃 후 로그인 화면으로 이동

3.1.4 비밀번호 관리

  • 비밀번호 찾기: 이메일로 임시 비밀번호 받기
  • 비밀번호 변경: 로그인 후 비밀번호 변경 가능

3.1.5 회원 탈퇴

  • 기능: 계정 완전 삭제
  • 주의: 탈퇴 시 모든 데이터 삭제되며 복구 불가

3.2 기도방

3.2.1 기도방 만들기

  • 입력: 기도방 이름, 설명
  • 권한: 누구나 만들 수 있음
  • 생성 후: 만든 사람이 자동으로 방장 및 멤버가 됨

3.2.2 기도방 목록 보기

  • 정렬: 최근에 만든 순서 또는 오래된 순서
  • 표시 정보:
    • 기도방 이름
    • 설명
    • 함께하는 사람 수
    • 알림 설정 여부

3.2.3 기도방 상세

  • 기능: 기도 제목 목록 보기 (스크롤하면 자동으로 더 보기)
  • 정보:
    • 기도방 정보
    • 함께하는 사람 목록
    • 기도 제목 리스트

3.2.4 기도방 멤버 관리

  • 멤버 보기: 현재 기도방에 있는 사람들 확인
  • 멤버 초대하기: 이름으로 검색하여 초대
  • 기도방 나가기: 내가 기도방에서 나가기

3.2.5 알림 설정

  • 기능: 기도방별로 알림 받을지 선택
  • 적용: 해당 기도방의 기도 완료 알림만 끄기/켜기

3.3 기도

3.3.1 기도 제목 작성

  • 입력: 기도 제목, 멤버별 기도 내용
  • 절차:
    1. 기도 제목 입력 (예: "건강을 위한 기도")
    2. 기도할 대상 선택 (기도방 멤버 중)
    3. 선택한 사람을 위한 구체적인 기도 내용 작성
    4. 여러 사람에 대해 반복 가능
    5. 전체 저장

3.3.2 기도 제목 목록 보기

  • 위치: 기도방 상세 화면
  • 형식: 스크롤하면 자동으로 더 보기
  • 표시: 기도 제목, 작성한 사람, 작성 날짜

3.3.3 기도 상세 보기

  • 기도 제목 정보: 제목, 작성자, 작성일
  • 기도 내용 목록: 멤버별로 작성된 기도 내용 리스트
  • 수정 모드: 수정/삭제 버튼 보이기/숨기기

3.3.4 기도 제목 수정

  • 권한: 작성한 사람만 수정 가능
  • 수정 가능: 기도 제목

3.3.5 기도 내용 관리

  • 추가: 새로운 기도 내용 추가
  • 수정: 기존 기도 내용 수정
  • 삭제: 기도 내용 삭제

3.3.6 기도 완료 알림

  • 기능: 기도 완료 시 멤버들에게 알림 보내기
  • 절차:
    1. 기도 상세 화면에서 "기도 알림" 버튼 클릭
    2. 확인 창 표시
    3. 확인하면 기도방 멤버들에게 알림 전송
  • 알림 대상: 해당 기도방의 모든 멤버 (알림을 켠 경우)
  • 알림 내용: "OOO님이 기도를 완료했습니다"

3.3.7 기도 제목 삭제

  • 권한: 작성한 사람만 삭제 가능
  • 동작: 기도 제목과 하위 기도 내용 모두 삭제

3.4 초대

3.4.1 기도방 멤버 초대 (이메일)

  • 입력: 이메일 주소
  • 대상: 앱 가입 여부 무관
  • 제약: 1명씩 초대 가능

3.4.2 기도방 멤버 초대 (회원 검색)

  • 입력: 이름으로 검색
  • 대상: 앱에 가입된 회원만
  • 장점: 여러 명 동시 초대 가능
  • 절차:
    1. 이름으로 회원 검색
    2. 여러 명 선택
    3. 한 번에 초대 보내기

3.4.3 초대 목록

  • 위치: 마이페이지 > 초대
  • 표시:
    • 기도방 이름
    • 초대한 사람
    • 초대 날짜
    • 상태

3.4.4 초대 응답

  • 선택: 수락 / 거절
  • 수락 시: 기도방 멤버로 추가
  • 거절 시: 초대 삭제

3.5 마이페이지

3.5.1 프로필 보기

  • 표시: 이름, 이메일, 전화번호

3.5.2 프로필 수정

  • 수정 가능: 이름, 전화번호
  • 수정 불가: 이메일 (로그인 아이디)

3.5.3 비밀번호 변경

  • 입력: 새 비밀번호
  • 절차: 새 비밀번호 입력 → 변경 완료

3.5.4 초대 목록

  • 표시: 받은 기도방 초대 목록
  • 기능: 수락/거절

3.6 회원 검색

3.6.1 회원 검색

  • 검색 기준: 이름
  • 대상: 앱에 가입된 전체 회원
  • 사용처:
    • 기도방 멤버 초대

3.7 알림

3.7.1 알림 관리

  • 등록: 앱 설치 및 로그인 시 자동으로 알림 기능 활성화
  • 해제: 로그아웃 또는 앱 삭제 시 알림 중지

3.7.2 알림 종류

  • 기도 완료 알림: 누군가 기도를 완료했을 때
  • 기도방 초대 알림: 기도방에 초대되었을 때

3.7.3 알림 설정

  • 기도방별 알림: 각 기도방마다 알림 켜기/끄기 가능
  • 전체 알림: 휴대폰 설정에서 앱 알림 전체 켜기/끄기

3.7.4 알림 클릭 시 이동

  • 기도 완료 알림 클릭:
    • 해당 기도방 → 기도 제목 상세로 자동 이동
  • 초대 알림 클릭:
    • 초대 목록으로 자동 이동

3.8 앱 업데이트

3.8.1 필수 업데이트

  • 조건: 앱 버전이 너무 낮을 경우
  • 동작: 업데이트 필수 안내 표시 (업데이트 전까지 앱 사용 불가)

3.8.2 권장 업데이트

  • 조건: 새로운 버전이 있을 경우
  • 동작: 업데이트 권장 안내 표시 (건너뛰기 가능)

3.8.3 자동 업데이트

  • 기능: 작은 업데이트는 자동으로 적용
  • 적용: 앱 재시작 시 자동 반영

3.8.4 유지보수 모드

  • 조건: 서버 점검 등
  • 동작: 유지보수 안내 표시 (앱 사용 불가)

4. 화면 구성

4.1 로그인 전 화면

4.1.1 시작 화면

  • 권한: 누구나 접근 가능
  • 기능: 앱 시작, 자동 로그인 확인

4.1.2 로그인 화면

  • 권한: 누구나 접근 가능
  • 입력: 이메일, 비밀번호
  • 기능: 로그인, 회원가입 이동

4.1.3 회원가입 화면

  • 권한: 누구나 접근 가능
  • 단계:
    1. 이메일 입력 → 인증번호 발송
    2. 인증번호 입력
    3. 이름, 비밀번호 입력
    4. 전화번호 입력

4.1.4 전화번호 등록 화면

  • 권한: 로그인 필요
  • 기능: 회원가입 후 전화번호 등록 (필수)

4.2 메인 화면

4.2.1 기도방 목록 탭

  • 권한: 로그인 필요
  • 표시:
    • 내가 속한 기도방 목록
    • 기도방 이름, 설명, 멤버 수
  • 기능:
    • 기도방 만들기
    • 기도방 선택하여 상세 화면으로 이동

4.2.2 마이페이지 탭

  • 권한: 로그인 필요
  • 메뉴:
    • 프로필 수정
    • 비밀번호 변경
    • 초대 목록
    • 로그아웃
    • 회원 탈퇴

4.3 기도방 화면

4.3.1 기도방 상세

  • 권한: 기도방 멤버만
  • 표시:
    • 기도방 정보
    • 멤버 목록
    • 기도 제목 리스트 (스크롤하면 더 보기)
  • 기능:
    • 기도 제목 작성
    • 기도 제목 선택하여 상세로 이동
    • 멤버 관리 (초대)
    • 알림 설정
    • 기도방 나가기

4.3.2 멤버 초대 화면

  • 권한: 기도방 멤버만
  • 기능:
    • 이름으로 회원 검색
    • 여러 명 선택
    • 한 번에 초대

4.4 기도 화면

4.4.1 기도 제목 작성 화면

  • 권한: 로그인 필요
  • 입력:
    • 기도 제목
    • 멤버별 기도 내용 (여러 개 가능)
  • 기능:
    • 멤버 선택 창
    • 기도 내용 추가/삭제
    • 전체 저장

4.4.2 기도 상세 화면

  • 권한: 로그인 필요
  • 표시:
    • 기도 제목
    • 기도 내용 리스트
  • 기능:
    • 수정 모드 켜기/끄기
    • 기도 제목 수정
    • 기도 내용 추가/수정/삭제
    • 기도 완료 알림 보내기

4.5 마이페이지 서브 화면

4.5.1 프로필 수정

  • 권한: 로그인 필요
  • 수정 가능: 이름, 전화번호

4.5.2 비밀번호 변경

  • 권한: 로그인 필요
  • 입력: 새 비밀번호

4.5.3 초대 목록

  • 권한: 로그인 필요
  • 표시: 받은 기도방 초대
  • 기능: 수락/거절

5. 기능 명세

5.1 회원 인증 기능

기능 설명 로그인 필요
이메일 인증번호 요청 회원가입 시 이메일로 인증번호 발송 ❌
이메일 인증번호 확인 입력한 인증번호가 맞는지 확인 ❌
회원가입 새 계정 만들기 ❌
로그인 이메일/비밀번호로 로그인 ❌
로그아웃 로그아웃하기 ✅
자동 로그인 유지 앱을 껐다 켜도 로그인 상태 유지 ❌
비밀번호 찾기 이메일로 임시 비밀번호 받기 ❌
비밀번호 변경 비밀번호 변경하기 ✅
회원 탈퇴 계정 완전 삭제 ✅

5.2 기도 기능

기능 설명 로그인 필요
기도 제목 작성 새로운 기도 제목 만들기 ✅
기도 제목 목록 보기 기도방의 기도 제목 리스트 보기 ✅
기도 제목 수정 기도 제목 내용 수정하기 ✅
기도 제목 삭제 기도 제목 삭제하기 ✅
기도 내용 보기 멤버별 기도 내용 확인 ✅
기도 내용 추가 새로운 기도 내용 추가 ✅
기도 내용 수정 기도 내용 수정하기 ✅
기도 내용 삭제 기도 내용 삭제하기 ✅
기도 완료 알림 기도 완료 시 멤버들에게 알림 보내기 ✅

5.3 기도방 기능

기능 설명 로그인 필요
기도방 목록 보기 내가 속한 기도방 리스트 보기 ✅
기도방 만들기 새로운 기도방 만들기 ✅
기도방 나가기 기도방에서 나가기 ✅
기도방 멤버 보기 기도방에 속한 사람들 확인 ✅
알림 설정 변경 기도방별 알림 켜기/끄기 ✅

5.4 초대 기능

기능 설명 로그인 필요
이메일로 초대 이메일 주소로 기도방 초대 ✅
회원 검색하여 초대 이름으로 검색하여 여러 명 초대 ✅
초대 목록 보기 받은 기도방 초대 확인 ✅
초대 응답 기도방 초대 수락/거절 ✅

5.5 회원 정보 기능

기능 설명 로그인 필요
내 프로필 보기 내 정보 확인 ✅
내 프로필 수정 이름, 전화번호 수정 ✅
회원 검색 이름으로 회원 찾기 ✅

5.6 알림 기능

기능 설명 로그인 필요
알림 받기 설정 앱 알림 기능 활성화 ✅
알림 받기 해제 앱 알림 기능 중지 ✅

5.7 앱 버전 기능

기능 설명 로그인 필요
앱 버전 확인 현재 앱 버전 확인 및 업데이트 필요 여부 체크 ❌

6. 비즈니스 규칙

6.1 회원 가입 및 인증

6.1.1 회원가입

  • 이메일은 중복 불가 (한 이메일로 하나의 계정만)
  • 전화번호는 필수 입력
  • 비밀번호는 일정 수준 이상의 보안 필요

6.1.2 로그인

  • 이메일과 비밀번호가 일치해야 로그인 가능
  • 로그인 성공 시 자동 로그인 유지
  • 앱을 껐다 켜도 로그인 상태 유지

6.1.3 로그인 유지

  • 한 번 로그인하면 일정 기간 동안 자동 로그인
  • 보안을 위해 일정 기간 후 자동 로그아웃 (추정: 7일)

6.2 기도방

6.2.1 기도방 만들기

  • 누구나 만들 수 있음
  • 만든 사람이 자동으로 방장 및 멤버가 됨
  • 기도방 이름은 필수, 설명은 선택

6.2.2 기도방 멤버

  • 멤버는 초대를 통해서만 추가됨
  • 멤버는 언제든지 나갈 수 있음
  • 모든 멤버가 나가면 기도방 자동 삭제 (추정)

6.2.3 알림 설정

  • 기도방별로 알림 켜기/끄기 가능
  • 기본값: 알림 켜짐
  • 알림 끄면 해당 기도방의 기도 완료 알림만 받지 않음

6.3 기도

6.3.1 기도 제목 작성

  • 기도방 멤버만 작성 가능
  • 기도 제목은 필수
  • 기도 내용은 선택 (0개 이상)
  • 한 멤버에 대해 여러 기도 내용 작성 가능

6.3.2 기도 제목 목록

  • 기도방별로 조회
  • 스크롤하면 자동으로 더 보기
  • 최신순 정렬

6.3.3 기도 수정/삭제

  • 작성한 사람만 수정/삭제 가능

6.3.4 기도 완료 알림

  • 누구나 보낼 수 있음
  • 알림 대상: 해당 기도방의 모든 멤버 (알림 켠 경우)
  • 알림 내용: "OOO님이 기도를 완료했습니다"

6.4 초대

6.4.1 기도방 초대

  • 이메일 초대: 이메일로 1명씩 초대
  • 회원 검색 초대: 이름으로 검색하여 여러 명 동시 초대 (권장)
  • 이미 멤버인 경우 초대 불가

6.4.2 초대 응답

  • 수락: 기도방 멤버로 추가
  • 거절: 초대 삭제

6.5 알림

6.5.1 알림 종류

  • 기도 완료 알림: 누군가 기도를 완료했을 때
  • 기도방 초대 알림: 기도방에 초대되었을 때

6.5.2 알림 설정

  • 기도방별 알림: 각 기도방마다 켜기/끄기
  • 전체 알림: 휴대폰 설정에서 앱 알림 전체 켜기/끄기

6.5.3 알림 클릭 시

  • 자동으로 해당 화면으로 이동
  • 로그인 상태 확인 후 이동

7. 향후 개선 방향

7.1 단기 개선 사항 (3개월 이내)

7.1.1 사용 편의성

  • 기도방 검색 기능 (이름으로 검색)
  • 기도 제목 검색 기능
  • 기도 통계 (완료한 기도 수, 기도방별 통계)
  • 프로필 사진 업로드

7.1.2 기능 추가

  • 기도 분류 (감사, 간구, 회개 등)
  • 기도 태그 (가족, 건강, 재정 등)
  • 정기 기도 알림 (매일 특정 시간에 기도 알림)
  • 기도 응답 기록 (응답받은 기도 표시)

7.1.3 소셜 기능

  • 기도 응원하기 (좋아요)
  • 기도 댓글 기능
  • 기도 공유하기 (외부 공유)

7.2 중기 개선 사항 (6개월 이내)

7.2.1 커뮤니티

  • 공개 기도방 (누구나 참여 가능)
  • 기도방 분류 (교회, 가족, 지인 등)
  • 추천 기도방 (인기 기도방)

7.2.2 개인화

  • 나만의 기도 노트
  • 기도 일기
  • 기도 기록 (날짜별 기도 히스토리)

7.2.3 알림 고도화

  • 알림 시간 설정 (매일 특정 시간에 기도 알림)
  • 알림 종류 세분화 (기도 완료, 초대, 댓글 등)
  • 여러 알림 한 번에 보기

7.3 장기 개선 사항 (1년 이내)

7.3.1 인공지능 기능

  • 기도 제목 자동 추천
  • 기도 분류 자동 지정
  • 기도 응답 패턴 분석

7.3.2 오프라인 기능

  • 인터넷 없이도 기도 보기
  • 인터넷 없이 작성 후 나중에 저장

7.3.3 통계 및 분석

  • 개인 기도 통계 (주간/월간 리포트)
  • 기도방 활동 분석
  • 기도 트렌드 (많이 기도되는 주제)

7.3.4 다른 앱과 연동

  • 교회 일정 연동
  • 성경 앱 연동
  • 캘린더 연동

7.4 품질 개선

7.4.1 성능 향상

  • 화면 전환 속도 개선
  • 사진 로딩 속도 개선 (추후 사진 기능 추가 시)
  • 앱 용량 최적화

7.4.2 안정성 향상

  • 버그 감소
  • 오류 발생 시 복구 기능
  • 자동 테스트 도입

7.4.3 코드 품질

  • 코드 스타일 통일
  • 코드 리뷰 강화
  • 문서화 개선

8. 부록

8.1 용어 정의

용어 설명
기도방 사용자들이 함께 기도 제목을 공유하는 그룹
기도 제목 기도할 내용의 제목
기도 내용 특정 멤버를 위한 구체적인 기도 내용
기도 완료 기도를 마쳤음을 알리는 행위
멤버 기도방에 속한 사용자
초대 다른 사용자를 기도방에 초대하는 행위
인증번호 이메일로 발송되는 일회용 번호
알림 휴대폰으로 받는 푸시 알림
자동 업데이트 앱 재설치 없이 업데이트

8.2 제약 사항

8.2.1 플랫폼

  • iOS (아이폰, 아이패드)
  • Android (안드로이드 스마트폰, 태블릿)

8.2.2 언어 및 대상

  • 현재 한국어만 지원
  • 기독교 기반 서비스

8.2.3 기능 제약

  • 파일(사진, 동영상 등) 업로드 현재 미지원

8.3 Deprecated (중단된) 기능

8.3.1 친구 기능 (Deprecated)

중단 시점: 2025년 (추정) 상태: 코드는 남아있으나 현재 사용하지 않음 사유: 기능 단순화 및 사용성 개선

중단된 기능 목록:

  • 친구 요청 보내기 (이메일 기반)
  • 친구 요청 수락/거절
  • 친구 목록 관리
  • 친구 삭제
  • 친구 요청 알림

대체 방안:

  • 기도방 멤버 초대 기능으로 통합
  • 회원 검색을 통한 직접 초대로 변경
  • 별도의 친구 관계 없이 기도방 중심으로 사용자 관계 관리

개발자 참고사항:

  • 친구 관련 서비스 파일: src/domain/friends/services/friendService.ts
  • 친구 관련 화면: app/(protected)/friends/ 디렉토리
  • 친구 관련 API 엔드포인트: /v1/friends/*
  • 코드 정리 예정 (향후 버전에서 완전 제거 가능)

9. 변경 이력

버전 날짜 작성자 변경 내용
1.0 2025-12-06 AI 초안 작성 (개발자 관점)
2.0 2025-12-06 AI 기획자 관점으로 전면 개편 (기술 용어 제거)
2.1 2025-12-06 AI 친구 기능 제거 및 Deprecated 섹션 추가

문서 끝