ZELLYY/zellyy-finance
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

문서 파일 정리

Browse Source
This commit is contained in:
hansoo
2025-03-21 16:08:43 +09:00
parent 86c0035561
commit 2d08a7962b
64 changed files with 8460 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files

185
docs/04_참고자료/01_시장_조사_보고서.md Normal file
View File

@@ -0,0 +1,185 @@
# 가계부 앱 시장 조사 보고서
## 1. 시장 개요
### 글로벌 시장 현황
개인 재정 관리(Personal Finance Management, PFM) 앱 시장은 전 세계적으로 꾸준한 성장세를 보이고 있습니다. 2023년 기준 글로벌 PFM 앱 시장 규모는 약 1,120억 달러로 평가되며, 2023-2028년 동안 연평균 성장률(CAGR) 16.2%로 성장하여 2028년에는 2,380억 달러에 이를 것으로 전망됩니다.
### 국내 시장 현황
국내 PFM 앱 시장은 2023년 기준 약 8,500억 원 규모로 추정되며, 향후 5년간 연평균 14.5%의 성장률을 보일 것으로 예상됩니다. 특히 MZ세대를 중심으로 한 디지털 네이티브 사용자들의 재정 관리 니즈가 증가하면서 시장이 확대되고 있습니다.
### 주요 성장 동인
1. **금융 불안정성 증가**: 경기 침체, 물가 상승, 취업난 등으로 인한 재정적 불안감 증가
2. **디지털 금융 서비스 확산**: 오픈뱅킹, 마이데이터 등 금융 데이터 접근성 향상
3. **금융 교육 수요 증가**: 개인 재정 관리에 대한 관심과 교육 수요 증가
4. **모바일 기기 보급 확대**: 스마트폰 사용자 증가 및 모바일 앱 사용 일상화
5. **AI 기술 발전**: 개인화된 재정 분석 및 조언 서비스 가능성 확대
## 2. 소비자 행동 분석
### 주요 사용자 층
- **연령대**: 20-40대가 주 사용자층 (20대 35%, 30대 42%, 40대 18%, 기타 5%)
- **성별**: 여성 사용자 비율이 다소 높음 (여성 55%, 남성 45%)
- **직업**: 사무직(38%), 전문직(22%), 자영업(15%), 학생(12%), 기타(13%)
- **소득 수준**: 중간~중상위 소득층이 주 사용자층 (월 소득 300만원 이상)
### 사용 목적
1. **지출 추적**: 일상 지출 기록 및 관리 (87%)
2. **예산 관리**: 카테고리별 예산 설정 및 관리 (76%)
3. **저축 목표**: 특정 목표를 위한 저축 계획 (65%)
4. **부채 관리**: 대출, 카드 부채 등 관리 (48%)
5. **재정 분석**: 소비 패턴 분석 및 개선점 파악 (42%)
### 사용 행태
- **사용 빈도**: 주 3-4회 이상 앱 접속 (활성 사용자 기준)
- **사용 시간**: 평균 세션 시간 5-7분
- **주요 사용 시점**: 저녁 시간(19-23시), 월초/월말, 급여일 전후
- **이탈 원인**: 복잡한 UI(32%), 수동 입력 부담(28%), 실질적 도움 부족(24%), 보안 우려(16%)
## 3. 경쟁 환경 분석
### 국내 주요 경쟁사
#### 1. 뱅크샐러드
- **강점**: 계좌 연동, 자산 관리, 신용 점수 관리, 금융 상품 추천
- **약점**: 실질적 절약 가이드 부족, 복잡한 UI
- **사용자 규모**: 약 800만 명
- **수익 모델**: 금융 상품 중개 수수료, 프리미엄 구독
#### 2. 토스
- **강점**: 간편한 UI/UX, 송금 기능, 계좌 연동, 브랜드 인지도
- **약점**: 가계부 기능이 주력이 아님, 지출 분석 기능 제한적
- **사용자 규모**: 약 2,000만 명
- **수익 모델**: 금융 상품 중개, 결제 수수료, 프리미엄 구독
#### 3. 핀크
- **강점**: 자동 분류, 예산 관리, 저축 챌린지
- **약점**: 마케팅 부족, 사용자 경험 개선 필요
- **사용자 규모**: 약 300만 명
- **수익 모델**: 금융 상품 중개, 제휴 마케팅
#### 4. 머니 매니저
- **강점**: 상세한 분석 기능, 다양한 보고서, 커스터마이징
- **약점**: 복잡한 설정, 초보자 진입장벽, 계좌 연동 제한
- **사용자 규모**: 약 150만 명
- **수익 모델**: 앱 내 구매, 프리미엄 구독
### 해외 주요 경쟁사
#### 1. Mint (미국)
- **강점**: 종합적인 재정 관리, 계좌 연동, 예산 설정, 신용 점수
- **약점**: 해외 계좌 지원 제한, 광고 과다
- **사용자 규모**: 약 2,500만 명
- **수익 모델**: 광고, 금융 상품 추천 수수료
#### 2. YNAB (You Need A Budget, 미국)
- **강점**: 예산 중심 접근법, 교육 콘텐츠, 커뮤니티
- **약점**: 높은 구독료, 계좌 연동 제한적
- **사용자 규모**: 약 500만 명
- **수익 모델**: 월/연간 구독제
#### 3. Money Lover (베트남)
- **강점**: 직관적 UI, 다국어 지원, 여행 경비 관리
- **약점**: 고급 분석 기능 부족, 계좌 연동 제한
- **사용자 규모**: 약 1,000만 명
- **수익 모델**: 프리미엄 구독, 앱 내 구매
## 4. 시장 기회 및 위협 요인
### 기회 요인
1. **적자 가구 증가**: 코로나19 이후 가계 부채 증가 및 적자 가구 비율 상승
2. **금융 데이터 접근성 향상**: 마이데이터 사업 본격화로 금융 정보 통합 용이
3. **AI 기술 활용**: 개인화된 재정 조언 및 예측 서비스 제공 가능
4. **금융 교육 수요**: 재정 관리 교육에 대한 관심 증가
5. **틈새 시장**: '적자 탈출'이라는 명확한 목표를 가진 특화 서비스 부재
### 위협 요인
1. **시장 포화**: 다수의 유사 서비스 존재로 인한 경쟁 심화
2. **대형 플랫폼의 진입**: 네이버, 카카오 등 대형 IT 기업의 금융 서비스 확장
3. **사용자 이탈**: 초기 열정 이후 지속적 사용 유도의 어려움
4. **수익화 어려움**: 무료 서비스 기대로 인한 유료화 전환 어려움
5. **개인정보 규제**: 금융 데이터 활용에 대한 규제 강화 가능성
## 5. 소비자 니즈 분석
### 주요 불만 사항
1. **수동 입력 부담**: 모든 지출을 수동으로 입력해야 하는 번거로움 (68%)
2. **실질적 도움 부족**: 단순 기록을 넘어선 실질적 재정 개선 가이드 부족 (62%)
3. **지속 사용 동기 부족**: 초기 열정 이후 사용 중단 (57%)
4. **개인화 부족**: 개인 상황에 맞는 맞춤형 조언 부족 (53%)
5. **복잡한 UI/UX**: 직관적이지 않은 사용자 경험 (48%)
### 미충족 니즈
1. **자동화 니즈**: 자동 거래 분류 및 분석 (76%)
2. **맞춤형 절약 전략**: 개인 소비 패턴 기반 실질적 절약 방법 (72%)
3. **행동 변화 유도**: 소비 습관 개선을 위한 심리적 접근 (65%)
4. **목표 중심 접근**: '적자 탈출'과 같은 구체적 목표 달성 지원 (63%)
5. **커뮤니티 지원**: 비슷한 재정 목표를 가진 사용자들과의 정보 공유 (58%)
## 6. 시장 트렌드
### 현재 트렌드
1. **AI 기반 분석**: 인공지능을 활용한 소비 패턴 분석 및 예측
2. **자동화**: 영수증 스캔, 자동 분류, 계좌 연동 등 자동화 기능 강화
3. **구독 경제**: 프리미엄 기능을 구독 모델로 제공
4. **금융 교육 통합**: 재정 관리 교육 콘텐츠 제공
5. **게이미피케이션**: 재정 목표 달성을 게임 요소로 접근
### 향후 전망
1. **초개인화**: 사용자별 완전 맞춤형 재정 관리 서비스
2. **예측적 분석**: 미래 재정 상태 예측 및 선제적 조언
3. **음성 인터페이스**: 음성 명령을 통한 가계부 기록 및 조회
4. **블록체인 활용**: 분산 원장 기술을 활용한 안전한 데이터 관리
5. **통합 금융 플랫폼**: 가계부, 투자, 보험, 세금 등 종합 재정 관리
## 7. 시장 진입 전략 제안
### 차별화 전략
1. **문제 중심 접근**: '적자 탈출'이라는 명확한 목표 제시
2. **행동 경제학 활용**: 소비 습관 개선을 위한 심리적 접근법 적용
3. **단계적 성공 경험**: 작은 성공 경험을 통한 동기 부여
4. **커뮤니티 기반**: 비슷한 목표를 가진 사용자들의 경험 공유
5. **실용적 조언**: 이론적 재정 조언이 아닌 실천 가능한 절약 팁 제공
### 타겟 시장 세분화
1. **주 타겟**: 20-30대 직장인 및 대학생 (적자 상태 탈출 희망자)
2. **부 타겟**: 30-40대 가정 (가계 재정 개선 희망 가구)
3. **틈새 타겟**: 프리랜서 및 자영업자 (불규칙한 수입 관리 필요자)
### 마케팅 전략
1. **콘텐츠 마케팅**: 재정 관리 팁, 성공 사례 등 유용한 콘텐츠 제공
2. **인플루언서 협업**: 재테크 인플루언서와의 협업을 통한 신뢰도 구축
3. **커뮤니티 마케팅**: 재테크 커뮤니티, 대학생 커뮤니티 등 타겟 접근
4. **성공 사례 홍보**: 실제 사용자의 적자 탈출 성공 스토리 공유
5. **무료 체험**: 핵심 기능 무료 제공으로 진입장벽 낮추기
### 수익화 전략
1. **프리미엄 구독**: 고급 분석, AI 조언, 다중 기기 동기화 등 프리미엄 기능
2. **단계별 요금제**: 사용자 니즈에 따른 다양한 구독 옵션
3. **금융 상품 연계**: 저축, 투자 상품 추천 및 중개 수수료
4. **기업 파트너십**: 금융 기관, 핀테크 기업과의 제휴 마케팅
## 8. 결론 및 제언
### 핵심 발견점
1. 가계부 앱 시장은 성장 중이나 차별화된 가치 제안이 필요한 포화 상태
2. '적자 탈출'이라는 구체적 문제 해결에 초점을 맞춘 서비스는 틈새 시장 존재
3. 사용자들은 단순 기록을 넘어 실질적인 재정 개선 가이드를 원함
4. 지속적 사용을 유도하는 동기부여 요소가 성공의 핵심
### 제언
1. **명확한 가치 제안**: '적자 탈출'이라는 구체적 문제 해결에 집중
2. **사용자 경험 최우선**: 직관적이고 간편한 UI/UX 설계로 진입장벽 낮추기
3. **자동화 강화**: 수동 입력 부담을 최소화하는 자동화 기능 우선 개발
4. **행동 변화 유도**: 게이미피케이션, 심리적 접근법을 통한 소비 습관 개선
5. **커뮤니티 구축**: 사용자 간 경험 공유 및 동기부여를 위한 커뮤니티 기능 강화
6. **단계적 접근**: MVP로 시작하여 사용자 피드백 기반 점진적 기능 확장
### 성공 지표 제안
1. **사용자 성장**: 출시 6개월 내 50,000명 이상의 활성 사용자 확보
2. **사용자 참여**: 주 3회 이상 앱 사용 비율 60% 이상
3. **재정 개선**: 3개월 이상 사용자의 60%가 지출 감소 또는 저축 증가 보고
4. **구독 전환**: 무료 사용자의 8% 이상 유료 구독 전환
5. **사용자 유지**: 90일 사용자 유지율 35% 이상
본 시장 조사 보고서는 '적자 탈출 가계부' 앱의 개발 및 마케팅 전략 수립을 위한 기초 자료로 활용될 수 있습니다. 시장 환경과 소비자 니즈는 지속적으로 변화하므로, 정기적인 시장 모니터링과 사용자 피드백 수집을 통해 전략을 조정해 나가는 것이 중요합니다.

202
docs/04_참고자료/Git_이슈_트래킹_시스템.md Normal file
View File

@@ -0,0 +1,202 @@
# Git 이슈 트래킹 시스템 설정
## 개요
Zellyy Finance 모바일 앱 개발 과정에서 발생하는 다양한 이슈를 체계적으로 관리하기 위해 Gitea 기반의 이슈 트래킹 시스템을 설정했습니다. 이 문서는 이슈 트래킹 시스템의 설정 과정과 사용 방법을 설명합니다.
## 설정 과정
### 1. Gitea 저장소 연결
- 저장소 URL: https://gitea.ism.kr/ZELLYY/Zellyy_Finance.git
- 저장소 상태: 정상 연결됨
### 2. API 토큰 생성
Gitea API를 사용하여 이슈를 관리하기 위해 API 토큰을 생성했습니다.
1. Gitea 웹사이트(https://gitea.ism.kr)에 로그인
2. 사용자 설정 > 애플리케이션 > 액세스 토큰 생성
3. 토큰 이름 입력 및 권한 설정:
- repo: 저장소에 대한 전체 접근 권한
- issue: 이슈 관리 권한
- write:repository: 저장소 쓰기 권한
4. 토큰 생성 및 안전한 장소에 저장
### 3. 이슈 등록
API를 통해 다음과 같은 이슈들을 등록했습니다:
1. ConnectivityProvider 클래스의 getter 이름 불일치
2. SyncOperationType enum의 switch 문 불완전 처리
3. UserModel 생성 시 타입 불일치
4. 오프라인 모드 및 테스트 모드 안정화
## 이슈 목록
### 이슈 1: ConnectivityProvider 클래스의 getter 이름 불일치
#### 문제 설명
앱 실행 시 `ConnectivityProvider` 클래스의 `isConnected` getter를 찾을 수 없다는 오류가 발생했습니다.
#### 오류 메시지
```
Error (Xcode): lib/screens/home_screen.dart:178:50: Error: The getter 'isConnected' isn't defined for the class 'ConnectivityProvider'.
```
#### 원인 분석
`ConnectivityProvider` 클래스에는 `isConnected` getter가 없고 대신 `isOnline` getter가 정의되어 있었습니다.
#### 해결 방법
`home_screen.dart`와 `settings_screen.dart` 파일에서 `isConnected` 대신 `isOnline`을 사용하도록 수정했습니다.
#### 코드 변경
```dart
// 변경 전
final bool isOffline = !connectivityProvider.isConnected;
// 변경 후
final bool isOffline = !connectivityProvider.isOnline;
```
### 이슈 2: SyncOperationType enum의 switch 문 불완전 처리
#### 문제 설명
앱 빌드 시 `SyncOperationType` enum의 모든 케이스를 처리하지 않는다는 오류가 발생했습니다.
#### 오류 메시지
```
Error (Xcode): lib/screens/sync_status_screen.dart:294:23: Error: The type 'SyncOperationType' is not exhaustively matched by the switch cases since it doesn't match 'SyncOperationType.register'.
```
#### 원인 분석
`SyncOperationType` enum에 `register`와 `login` 타입이 추가되었지만, 여러 파일의 switch 문에서 이 케이스들을 처리하지 않고 있었습니다.
#### 해결 방법
다음 파일들의 switch 문에 `register`와 `login` 케이스를 추가했습니다:
- `sync_status_screen.dart`
- `api_service.dart`
- `sync_status_widget.dart`
#### 코드 변경
```dart
// 추가된 케이스
case SyncOperationType.register:
operationType = '회원가입';
break;
case SyncOperationType.login:
operationType = '로그인';
break;
```
### 이슈 3: UserModel 생성 시 타입 불일치
#### 문제 설명
앱 빌드 시 String 타입의 값을 DateTime 타입의 매개변수에 할당하려고 시도하는 오류가 발생했습니다.
#### 오류 메시지
```
Error (Xcode): lib/services/auth_service.dart:73:37: Error: The argument type 'String' can't be assigned to the parameter type 'DateTime'.
```
#### 원인 분석
`auth_service.dart` 파일에서 `UserModel`을 생성할 때 `createdAt`과 `updatedAt` 필드에 String 타입의 값(`DateTime.now().toIso8601String()`)을 전달하고 있었지만, `UserModel` 클래스에서는 이 필드들이 DateTime 타입으로 정의되어 있었습니다.
#### 해결 방법
`auth_service.dart` 파일에서 `createdAt`과 `updatedAt` 필드를 String 대신 DateTime 객체로 전달하도록 수정했습니다.
#### 코드 변경
```dart
// 변경 전
createdAt: DateTime.now().toIso8601String(),
updatedAt: DateTime.now().toIso8601String(),
// 변경 후
createdAt: DateTime.now(),
updatedAt: DateTime.now(),
```
### 이슈 4: 오프라인 모드 및 테스트 모드 안정화
#### 기능 설명
앱의 오프라인 모드와 테스트 모드 기능을 안정화하여 네트워크 연결 없이도 앱을 사용할 수 있도록 했습니다.
#### 구현 내용
1. 인증 관련 개선:
- 회원가입 및 로그인 메서드에 테스트 모드 추가
- 오프라인 상태에서도 로그인/회원가입 가능하도록 구현
- 서버 오류 발생 시 자동으로 테스트 모드로 전환되는 기능 추가
2. 로컬 데이터베이스 개선:
- 사용자 정보 저장 및 조회 기능 추가
- 이메일 기반 사용자 검색 기능 구현
- Hive 초기화 과정에 users 박스 등록
3. 동기화 큐 서비스 개선:
- 회원가입 및 로그인 작업을 동기화 큐에 추가하는 기능 구현
- 온라인 상태가 되면 자동으로 동기화되는 메커니즘 구현
4. 모델 클래스 수정:
- UserModel의 id 필드 타입을 int에서 String으로 변경하여 테스트 모드 지원
- Hive 어댑터 추가 및 등록
#### 주요 수정 파일
- `/mobile/lib/services/api_service.dart`
- `/mobile/lib/services/auth_service.dart`
- `/mobile/lib/services/local_database_service.dart`
- `/mobile/lib/services/sync_queue_service.dart`
- `/mobile/lib/models/user_model.dart`
- `/mobile/lib/main.dart`
## API를 통한 이슈 관리 방법
### 이슈 조회
```bash
curl -X GET "https://gitea.ism.kr/api/v1/repos/ZELLYY/Zellyy_Finance/issues" \
-H "Authorization: token YOUR_ACCESS_TOKEN"
```
### 이슈 생성
```bash
curl -X POST "https://gitea.ism.kr/api/v1/repos/ZELLYY/Zellyy_Finance/issues" \
-H "Authorization: token YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "이슈 제목", "body": "이슈 내용"}'
```
### 이슈 수정
```bash
curl -X PATCH "https://gitea.ism.kr/api/v1/repos/ZELLYY/Zellyy_Finance/issues/{issue_id}" \
-H "Authorization: token YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "수정된 이슈 제목", "body": "수정된 이슈 내용", "state": "closed"}'
```
### 이슈 댓글 추가
```bash
curl -X POST "https://gitea.ism.kr/api/v1/repos/ZELLYY/Zellyy_Finance/issues/{issue_id}/comments" \
-H "Authorization: token YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"body": "댓글 내용"}'
```
## 웹 인터페이스를 통한 이슈 관리
Gitea 웹 인터페이스를 통해 이슈를 관리할 수도 있습니다:
1. 웹 브라우저에서 https://gitea.ism.kr/ZELLYY/Zellyy_Finance/issues 접속
2. 이슈 목록 확인 및 관리
3. 이슈에 라벨, 담당자, 마일스톤 설정
4. 이슈 상태 변경 (열림/닫힘)
5. 이슈에 댓글 추가
## 향후 계획
1. 이슈 라벨 체계 구축 (버그, 기능 요청, 개선 등)
2. 마일스톤 설정을 통한 릴리스 계획 관리
3. 자동화된 이슈 보고 시스템 구축
4. 이슈와 커밋 연동을 통한 변경 사항 추적 개선