Migrate from Supabase to Appwrite with core functionality and UI components
This commit is contained in:
hansoo
@@ -1,204 +0,0 @@
|
||||
# 적자 탈출 가계부 개발 로드맵
|
||||
|
||||
## 개발 접근 방식
|
||||
|
||||
'적자 탈출 가계부' 프로젝트는 애자일 방법론을 기반으로 개발될 예정입니다. 2주 단위의 스프린트로 진행하며, 각 스프린트마다 사용 가능한 기능을 구현하고 테스트하는 방식으로 진행합니다. MVP(Minimum Viable Product) 접근법을 통해 핵심 기능을 우선적으로 개발하고, 사용자 피드백을 바탕으로 점진적으로 기능을 확장해 나갈 계획입니다.
|
||||
|
||||
## 개발 단계
|
||||
|
||||
### 1단계: 기획 및 설계 (2024년 Q1)
|
||||
|
||||
#### 1월: 요구사항 분석 및 기획
|
||||
- [x] 사용자 요구사항 수집 및 분석
|
||||
- [x] 경쟁 앱 분석 및 차별화 전략 수립
|
||||
- [x] 핵심 기능 정의 및 우선순위 설정
|
||||
- [x] 사용자 페르소나 및 사용자 여정 맵 작성
|
||||
|
||||
#### 2월: UI/UX 설계
|
||||
- [ ] 앱 정보 구조 설계
|
||||
- [ ] 주요 화면 와이어프레임 작성
|
||||
- [ ] 디자인 시스템 구축 (색상, 타이포그래피, 컴포넌트)
|
||||
- [ ] 프로토타입 제작 및 사용성 테스트
|
||||
|
||||
#### 3월: 기술 설계
|
||||
- [ ] 시스템 아키텍처 설계
|
||||
- [ ] 데이터베이스 스키마 설계
|
||||
- [ ] API 명세 작성
|
||||
- [ ] 보안 및 개인정보 보호 전략 수립
|
||||
|
||||
### 2단계: MVP 개발 (2024년 Q2)
|
||||
|
||||
#### 4월: 기본 인프라 구축
|
||||
- [ ] 개발 환경 설정
|
||||
- [ ] CI/CD 파이프라인 구축
|
||||
- [ ] 백엔드 서버 기본 구조 개발
|
||||
- [ ] 데이터베이스 구축 및 연결
|
||||
|
||||
#### 5월: 핵심 기능 개발 (1)
|
||||
- [ ] 사용자 인증 시스템 구현
|
||||
- [ ] 기본 수입/지출 기록 기능 개발
|
||||
- [ ] 카테고리 관리 기능 개발
|
||||
- [ ] 기본 대시보드 구현 (D3.js/Chart.js 활용)
|
||||
- [ ] 뉴모피즘 스타일 UI 컴포넌트 개발
|
||||
|
||||
#### 6월: 핵심 기능 개발 (2)
|
||||
- [ ] 예산 설정 및 관리 기능 개발
|
||||
- [ ] 기본 분석 보고서 구현
|
||||
- [ ] 알림 시스템 구현
|
||||
- [ ] 데이터 백업 및 복원 기능 개발
|
||||
|
||||
### 3단계: 베타 테스트 및 개선 (2024년 Q3)
|
||||
|
||||
#### 7월: 베타 버전 완성
|
||||
- [ ] 기능 통합 및 안정화
|
||||
- [ ] 성능 최적화
|
||||
- [ ] 사용자 피드백 수집 시스템 구현
|
||||
- [ ] 베타 테스트 환경 구축
|
||||
|
||||
#### 8월: 베타 테스트 진행
|
||||
- [ ] 클로즈드 베타 테스트 진행 (100명 규모)
|
||||
- [ ] 사용자 피드백 수집 및 분석
|
||||
- [ ] 버그 수정 및 UI/UX 개선
|
||||
- [ ] 성능 모니터링 및 최적화
|
||||
|
||||
#### 9월: 개선 및 추가 기능 개발
|
||||
- [ ] 베타 테스트 피드백 기반 개선사항 적용
|
||||
- [ ] 추가 기능 개발 (사용자 요구 기반)
|
||||
- [ ] 앱 안정성 및 성능 최적화
|
||||
- [ ] 출시 준비 (앱스토어 등록 준비)
|
||||
|
||||
### 4단계: 출시 및 확장 (2024년 Q4)
|
||||
|
||||
#### 10월: 공식 출시
|
||||
- [ ] 앱스토어 및 구글 플레이 스토어 등록 (Capacitor 앱 배포)
|
||||
- [ ] 웹 버전 공개 및 PWA 배포
|
||||
- [ ] 마케팅 캠페인 실행
|
||||
- [ ] 사용자 지원 시스템 구축
|
||||
- [ ] 실시간 모니터링 및 이슈 대응
|
||||
|
||||
#### 11월: 고급 기능 개발 (1)
|
||||
- [ ] AI 기반 지출 분석 엔진 개발
|
||||
- [ ] 맞춤형 절약 제안 시스템 구현
|
||||
- [ ] 영수증 스캔 및 자동 분류 기능 개발
|
||||
- [ ] 사용자 행동 분석 시스템 구현
|
||||
|
||||
#### 12월: 고급 기능 개발 (2)
|
||||
- [ ] 금융 계좌 연동 기능 개발
|
||||
- [ ] 절약 챌린지 시스템 구현
|
||||
- [ ] 커뮤니티 기능 개발
|
||||
- [ ] 프리미엄 구독 모델 구현
|
||||
|
||||
### 5단계: 확장 및 고도화 (2025년 Q1-Q2)
|
||||
|
||||
#### 3월 추가 작업: 기술 스택 전환 (Flutter → React, MongoDB → Supabase)
|
||||
- [x] 문서 업데이트 (README.md, 시스템 아키텍처, Lovable UI 컴포넌트 정리)
|
||||
- [x] Lovable UI 컴포넌트 React 구현 (LovableButton, LovableCard, LovableBudgetCard, LovableTransactionCard, LovableAddTransactionButton)
|
||||
- [x] 홈 화면 React 리팩토링
|
||||
- [x] Supabase 기본 연동 설정 (데이터 모델, 실시간 구독)
|
||||
- [ ] Supabase 인증 구현 및 완전한 통합
|
||||
- [ ] Capacitor 설정 및 네이티브 기능 연동
|
||||
|
||||
#### 3-4월: 서비스 확장 및 안정화
|
||||
- [ ] 상태 관리 시스템 구현 (React Context 또는 Redux)
|
||||
- [ ] 추가 화면 개발 (통계, 예산 설정, 프로필)
|
||||
- [ ] 다중 기기 동기화 기능 구현
|
||||
- [ ] 데스크톱 앱 버전 개발 (Electron 활용)
|
||||
- [ ] 국제화 및 현지화 (다국어 지원)
|
||||
|
||||
#### 5-6월: 서비스 고도화
|
||||
- [ ] 고급 데이터 시각화 도구 개발
|
||||
- [ ] 고급 AI 예측 모델 개발
|
||||
- [ ] 금융 교육 콘텐츠 통합
|
||||
- [ ] 파트너십 확대 (금융 기관, 핀테크 등)
|
||||
- [ ] 사용자 데이터 기반 서비스 개인화 강화
|
||||
|
||||
## 개발 팀 구성
|
||||
|
||||
### 핵심 팀 (초기 단계)
|
||||
- **프로젝트 매니저**: 1명 - 전체 프로젝트 조정 및 일정 관리
|
||||
- **UI/UX 디자이너**: 1명 - 사용자 경험 설계 및 시각적 디자인
|
||||
- **프론트엔드 개발자**: 2명 - 웹 앱 개발 (React, Capacitor)
|
||||
- **백엔드 개발자**: 2명 - 서버 및 API 개발 (Node.js)
|
||||
- **데이터 엔지니어**: 1명 - 데이터 모델링 및 분석 시스템 개발
|
||||
- **QA 엔지니어**: 1명 - 품질 보증 및 테스트 자동화
|
||||
|
||||
### 확장 팀 (후기 단계)
|
||||
- **AI/ML 엔지니어**: 1명 - 인공지능 및 기계학습 모델 개발
|
||||
- **DevOps 엔지니어**: 1명 - 인프라 관리 및 배포 자동화
|
||||
- **마케팅 전문가**: 1명 - 사용자 확보 및 브랜딩 전략
|
||||
- **콘텐츠 제작자**: 1명 - 재정 교육 콘텐츠 및 가이드 제작
|
||||
- **고객 지원 담당자**: 1-2명 - 사용자 문의 대응 및 지원
|
||||
|
||||
## 개발 환경 및 도구
|
||||
|
||||
### 개발 환경
|
||||
- **프론트엔드**: React, Vite, Tailwind CSS, Capacitor, TypeScript
|
||||
- **상태 관리**: React Context API (또는 Redux 검토 중)
|
||||
- **백엔드**: Supabase(PostgreSQL) On-Premise
|
||||
- **인증**: Supabase Auth
|
||||
- **AI/ML**: Python, TensorFlow, Pandas
|
||||
- **인프라**: Docker, Kubernetes
|
||||
|
||||
### 개발 도구
|
||||
- **프로젝트 관리**: Jira, Confluence
|
||||
- **소스 코드 관리**: GitHub
|
||||
- **CI/CD**: GitHub Actions, Jenkins
|
||||
- **커뮤니케이션**: Slack, Zoom
|
||||
- **디자인**: Figma, Adobe XD
|
||||
- **테스트**: Jest, Cypress, Postman
|
||||
|
||||
## 품질 보증 전략
|
||||
|
||||
### 테스트 전략
|
||||
- **단위 테스트**: 개별 함수 및 컴포넌트 테스트 (Jest)
|
||||
- **통합 테스트**: 컴포넌트 간 상호작용 테스트
|
||||
- **E2E 테스트**: 사용자 시나리오 기반 전체 흐름 테스트 (Cypress)
|
||||
- **성능 테스트**: 로드 테스트 및 스트레스 테스트
|
||||
- **보안 테스트**: 취약점 스캔 및 침투 테스트
|
||||
|
||||
### 코드 품질 관리
|
||||
- **코드 리뷰**: 모든 코드 변경에 대한 동료 검토
|
||||
- **정적 코드 분석**: ESLint, SonarQube
|
||||
- **코드 컨벤션**: 일관된 코딩 스타일 가이드
|
||||
- **문서화**: 코드 및 API 문서 자동화
|
||||
|
||||
## 위험 관리
|
||||
|
||||
### 잠재적 위험 및 대응 전략
|
||||
1. **일정 지연**
|
||||
- 대응: 우선순위 재조정, 스프린트 계획 유연성 확보
|
||||
- 완화: 버퍼 시간 확보, 주기적 진행 상황 검토
|
||||
|
||||
2. **기술적 복잡성**
|
||||
- 대응: 전문가 자문, 기술 스파이크 활용
|
||||
- 완화: 단계적 구현, 대안 기술 검토
|
||||
|
||||
3. **사용자 채택 저조**
|
||||
- 대응: 사용자 피드백 기반 개선, 마케팅 전략 조정
|
||||
- 완화: 초기 사용자 테스트, 경쟁 분석 강화
|
||||
|
||||
4. **보안 및 개인정보 이슈**
|
||||
- 대응: 즉각적인 취약점 패치, 투명한 커뮤니케이션
|
||||
- 완화: 정기적인 보안 감사, 개인정보 보호 설계
|
||||
|
||||
## 성공 기준
|
||||
|
||||
### 기술적 성공 기준
|
||||
- 99.9% 이상의 서비스 가용성
|
||||
- 앱 크래시 비율 0.1% 미만
|
||||
- 평균 앱 로딩 시간 2초 이내
|
||||
- 데이터 손실 사고 0건
|
||||
|
||||
### 비즈니스 성공 기준
|
||||
- 출시 6개월 내 50,000명 이상의 활성 사용자 확보
|
||||
- 무료 사용자의 8% 이상 유료 구독 전환
|
||||
- 앱스토어 평점 4.5/5.0 이상
|
||||
- 사용자 유지율 30일 기준 40% 이상
|
||||
|
||||
## 결론
|
||||
|
||||
'적자 탈출 가계부' 개발 로드맵은 사용자 중심의 접근 방식과 애자일 방법론을 기반으로 설계되었습니다. MVP 접근법을 통해 핵심 기능을 우선적으로 개발하고, 사용자 피드백을 지속적으로 반영하여 서비스를 개선해 나갈 계획입니다.
|
||||
|
||||
개발 과정에서 발생할 수 있는 위험을 사전에 식별하고 대응 전략을 마련하여, 프로젝트의 성공적인 완수를 위한 기반을 마련하였습니다. 또한, 명확한 성공 기준을 설정하여 프로젝트의 진행 상황을 객관적으로 평가할 수 있도록 하였습니다.
|
||||
|
||||
이 로드맵은 프로젝트의 진행 상황과 사용자 피드백에 따라 유연하게 조정될 수 있으며, 궁극적으로는 사용자들이 재정적 어려움에서 벗어나 건강한 재정 상태를 달성할 수 있도록 돕는 가치 있는 서비스를 제공하는 것을 목표로 합니다.
|
||||
@@ -1,122 +0,0 @@
|
||||
# 적자 탈출 가계부 - 1단계 산출물 요약
|
||||
|
||||
## 1. 요구사항 문서
|
||||
|
||||
### 1.1 사용자 페르소나
|
||||
- 3개의 대표 페르소나 정의 (직장인, 신혼부부, 대학생)
|
||||
- 각 페르소나의 재정적 특성, 소비 패턴, 목표 정의
|
||||
- 페르소나별 주요 문제점과 니즈 식별
|
||||
|
||||
### 1.2 핵심 문제 정의
|
||||
- 신용카드 사용 관련 문제점 분석
|
||||
- 기존 가계부/금융 앱의 한계 정리
|
||||
- MVP 접근 방식 및 문제 해결 전략 수립
|
||||
|
||||
### 1.3 주요 사용 시나리오
|
||||
- 3개의 사용자 시나리오 작성
|
||||
- 월간 카드 한도 관리
|
||||
- 충동 구매 방지
|
||||
- 부부 공동 카드 관리
|
||||
- 각 시나리오별 사용자 여정 및 앱 기능 요구사항 정의
|
||||
|
||||
### 1.4 프로젝트 개요
|
||||
- 프로젝트 목표, 범위, 기술 스택 정의
|
||||
- MVP 핵심 기능 신용카드 관리 중심으로 수정
|
||||
- 확장 기능에 AI 기반 재정 어시스턴트 추가
|
||||
|
||||
## 2. 사용자 스토리 및 기능 목록
|
||||
|
||||
### 2.1 사용자 스토리
|
||||
- 카드 한도 관리 관련 스토리 (한도 설정, 현황 확인, 알림)
|
||||
- 카드 사용 내역 관리 관련 스토리 (내역 기록, 조회/분석, 수정/관리)
|
||||
- 대시보드 및 분석 관련 스토리 (메인 대시보드, 지출 분석, 리포트/인사이트)
|
||||
- 사용자 관리 및 설정 관련 스토리 (프로필 관리, 데이터 관리, 다중 사용자 지원)
|
||||
|
||||
### 2.2 MVP 기능 목록 (MoSCoW 방법론)
|
||||
- Must have: 월간 카드 한도 설정, 실시간 사용량 표시, 기본 알림 등
|
||||
- Should have: 카테고리별 한도, 내역 템플릿, 기본 분석 기능 등
|
||||
- Could have: 영수증 사진 촬영, 위치 기반 자동 완성, 맞춤형 리포트 등
|
||||
- Won't have: 자동 내역 동기화, 다중 사용자 지원, AI 고급 분석 등
|
||||
|
||||
### 2.3 제외 기능 명확한 정의
|
||||
- 자동 내역 동기화, 다중 사용자 지원, AI 기반 고급 분석 등 MVP에서 제외되는 기능 명확히 정의
|
||||
|
||||
## 3. 데이터 모델 설계
|
||||
|
||||
### 3.1 핵심 데이터 엔티티
|
||||
- 사용자(Users) 테이블 구조
|
||||
- 카드(Cards) 테이블 구조
|
||||
- 카테고리(Categories) 테이블 구조
|
||||
- 지출(Expenses) 테이블 구조
|
||||
- 한도(Limits) 테이블 구조
|
||||
- 알림(Notifications) 테이블 구조
|
||||
- 템플릿(Templates) 테이블 구조
|
||||
|
||||
### 3.2 데이터 관계 및 제약 조건
|
||||
- 테이블 간 관계 정의 (ERD 작성)
|
||||
- 기본 카테고리 목록 정의
|
||||
- 데이터 유효성 검사 규칙 정의
|
||||
|
||||
### 3.3 데이터베이스 인덱스 설계
|
||||
- 성능 최적화를 위한 인덱스 설계
|
||||
- 데이터 마이그레이션 전략
|
||||
- 데이터 보안 고려사항
|
||||
|
||||
## 4. UI/UX 와이어프레임
|
||||
|
||||
### 4.1 핵심 화면 와이어프레임
|
||||
- 로그인/회원가입 화면
|
||||
- 메인 대시보드 화면
|
||||
- 지출 입력 화면
|
||||
- 지출 목록 화면
|
||||
- 필터 및 검색 화면
|
||||
|
||||
### 4.2 추가 화면 와이어프레임
|
||||
- 예산 설정 화면
|
||||
- 분석 화면
|
||||
- 설정 화면
|
||||
- 카드 관리 화면
|
||||
- 카드 추가 화면
|
||||
|
||||
### 4.3 화면 간 이동 흐름도
|
||||
- 주요 사용자 흐름 정의
|
||||
- 신규 사용자 온보딩 흐름
|
||||
- 지출 기록 흐름
|
||||
- 지출 분석 흐름
|
||||
- 한도 관리 흐름
|
||||
- 지출 내역 검색 흐름
|
||||
|
||||
### 4.4 디자인 노트
|
||||
- 색상 팔레트
|
||||
- 타이포그래피
|
||||
- 아이콘 및 시각적 요소
|
||||
- 사용자 경험 고려사항
|
||||
- 접근성 고려사항
|
||||
|
||||
## 5. 기술 스택 및 개발 환경
|
||||
|
||||
### 5.1 기술 스택
|
||||
- 모바일 앱: Flutter (크로스 플랫폼)
|
||||
- 백엔드: Supabase (PostgreSQL)
|
||||
- AI 모델:
|
||||
- 기기 내: TensorFlow Lite, 경량 모델 (DistilBERT)
|
||||
- 서버: Hugging Face 또는 OpenAI 모델
|
||||
|
||||
### 5.2 개발 환경 설정 계획
|
||||
- 개발 환경 요구사항
|
||||
- 필요한 개발 도구 목록
|
||||
- 로컬 개발 환경과 서버 환경 설정 단계
|
||||
|
||||
## 6. 다음 단계 계획
|
||||
|
||||
### 6.1 2단계 목표
|
||||
- 백엔드 구축 (Supabase 설정)
|
||||
- 데이터베이스 스키마 구현
|
||||
- 기본 API 엔드포인트 개발
|
||||
- 인증 시스템 구현
|
||||
|
||||
### 6.2 향후 고려사항
|
||||
- 개인정보 보호 방안
|
||||
- LLM 모델 선택 및 최적화
|
||||
- 사용자 피드백 반영 전략
|
||||
- 단계별 기능 확장 계획
|
||||
@@ -1,131 +0,0 @@
|
||||
# 적자 탈출 가계부 앱 - 1단계 첫 주차 할 일
|
||||
|
||||
## 역할 구분
|
||||
- [사용자] : 제품 기획 및 테스트 담당자가 수행할 작업
|
||||
- [AI] : AI 어시스턴트가 수행할 작업
|
||||
- [공동] : 함께 논의하고 결정할 작업
|
||||
|
||||
## 1일차: 프로젝트 초기화 및 요구사항 정의
|
||||
|
||||
### 오전
|
||||
- [공동] 프로젝트 관리 환경 설정 ✅
|
||||
- [사용자] 프로젝트 폴더 구조 생성 ✅
|
||||
- [AI] 문서 템플릿 준비 (요구사항, 디자인 등) ✅
|
||||
- [사용자] 일정 관리 도구 설정 (선택적)
|
||||
|
||||
### 오후
|
||||
- [사용자] MVP(Minimum Viable Product) 핵심 요구사항 정의
|
||||
- [사용자] 사용자 페르소나 작성 (주 사용자층 정의) ✅
|
||||
- [사용자] 핵심 문제 정의 (적자 발생 원인 분석) ✅
|
||||
- [사용자] 주요 사용 시나리오 작성 (2-3개) ✅
|
||||
- [AI] 요구사항 문서화 및 정리 ✅
|
||||
|
||||
## 2일차: 사용자 스토리 및 기능 목록 작성
|
||||
|
||||
### 오전
|
||||
- [공동] 사용자 스토리 작성
|
||||
- [사용자] 핵심 사용자 니즈 정의
|
||||
- [AI] 사용자 스토리 형식으로 문서화: ✅
|
||||
- "사용자로서 나는 지출을 빠르게 기록하고 싶다"
|
||||
- "사용자로서 나는 현재 사용 가능한 잔액을 실시간으로 확인하고 싶다"
|
||||
- "사용자로서 나는 월별 예산을 설정하고 진행 상황을 확인하고 싶다"
|
||||
- "사용자로서 나는 지출 패턴을 카테고리별로 분석하고 싶다"
|
||||
- "사용자로서 나는 예산 초과 시 알림을 받고 싶다"
|
||||
|
||||
### 오후
|
||||
- [공동] MVP 기능 목록 및 우선순위 설정 ✅
|
||||
- [사용자] 필수 기능 결정 ✅
|
||||
- [AI] 기능별 우선순위 부여 (MoSCoW 방법: Must have, Should have, Could have, Won't have) ✅
|
||||
- [공동] 제외할 기능 명확히 정의 ✅
|
||||
|
||||
## 3일차: 데이터 모델 설계
|
||||
|
||||
### 오전
|
||||
- [AI] 핵심 데이터 엔티티 정의 ✅
|
||||
- [AI] 사용자(users) 테이블 구조 설계 ✅
|
||||
- [AI] 지출(expenses) 테이블 구조 설계 ✅
|
||||
- [AI] 카테고리(categories) 테이블 구조 설계 ✅
|
||||
- [AI] 예산(budgets) 테이블 구조 설계 ✅
|
||||
|
||||
### 오후
|
||||
- [공동] 데이터 관계 및 제약 조건 설계 ✅
|
||||
- [AI] 테이블 간 관계 정의 (ERD 작성) ✅
|
||||
- [사용자] 기본 카테고리 목록 정의 ✅
|
||||
- [AI] 데이터 유효성 검사 규칙 정의 ✅
|
||||
- [사용자] 데이터 모델 검토 및 피드백 ✅
|
||||
|
||||
## 4-5일차: UI/UX 와이어프레임 작성
|
||||
|
||||
### 4일차
|
||||
- [공동] 핵심 화면 와이어프레임 스케치 ✅
|
||||
- [AI] 초기 와이어프레임 제안: ✅
|
||||
- 로그인/회원가입 화면 ✅
|
||||
- 메인 대시보드 화면 ✅
|
||||
- 지출 입력 화면 ✅
|
||||
- 지출 목록 화면 ✅
|
||||
- [사용자] 와이어프레임 검토 및 피드백 ✅
|
||||
|
||||
### 5일차
|
||||
- [공동] 추가 화면 및 사용자 흐름 설계 ✅
|
||||
- [AI] 추가 와이어프레임 제안: ✅
|
||||
- 예산 설정 화면 ✅
|
||||
- 분석 화면 ✅
|
||||
- 설정 화면 ✅
|
||||
- [AI] 화면 간 이동 흐름도 작성 ✅
|
||||
- [사용자] 최종 와이어프레임 검토 및 승인 ✅
|
||||
|
||||
## 6일차: 기술 스택 결정 및 개발 환경 설정 계획
|
||||
|
||||
### 오전
|
||||
- [AI] 최종 기술 스택 결정 ✅
|
||||
- [AI] Flutter 버전 선택 ✅
|
||||
- [AI] 필요한 Flutter 패키지 목록 작성 ✅
|
||||
- [AI] Supabase 설치 요구사항 확인 ✅
|
||||
- [사용자] 기술 스택 검토 및 승인 ✅
|
||||
|
||||
### 오후
|
||||
- [AI] 개발 환경 설정 계획 수립 ✅
|
||||
- [AI] 개발 환경 요구사항 문서화 ✅
|
||||
- [AI] 필요한 개발 도구 목록 작성 ✅
|
||||
- [AI] 로컬 개발 환경과 서버 환경 설정 단계 정의 ✅
|
||||
- [사용자] 서버 환경 정보 공유 ✅
|
||||
|
||||
## 7일차: 1단계 검토 및 2단계 준비
|
||||
|
||||
### 오전
|
||||
- [공동] 1단계 산출물 검토
|
||||
- [사용자] 요구사항 문서 검토 및 피드백
|
||||
- [사용자] 와이어프레임 최종 검토
|
||||
- [AI] 데이터 모델 최종 검토
|
||||
- [AI] 문서 보완 및 수정
|
||||
|
||||
### 오후
|
||||
- [공동] 2단계 계획 수립
|
||||
- [AI] 2단계 작업 목록 초안 작성
|
||||
- [사용자] 2단계 일정 및 우선순위 결정
|
||||
- [공동] 2단계 목표 및 성공 기준 정의
|
||||
- [AI] 1단계 결과물 최종 정리 및 문서화
|
||||
|
||||
## 주간 산출물 목록
|
||||
|
||||
1. **요구사항 문서** [공동]
|
||||
- MVP 핵심 요구사항 정의서
|
||||
- 사용자 스토리 목록
|
||||
- 기능 우선순위 목록
|
||||
|
||||
2. **데이터 모델 문서** [AI 주도]
|
||||
- 데이터베이스 스키마 설계서
|
||||
- ERD(Entity Relationship Diagram)
|
||||
- 기본 카테고리 목록 [사용자 정의]
|
||||
|
||||
3. **디자인 문서** [공동]
|
||||
- 핵심 화면 와이어프레임
|
||||
- 사용자 흐름도
|
||||
- UI 컴포넌트 목록
|
||||
|
||||
4. **기술 문서** [AI 주도]
|
||||
- 기술 스택 명세서
|
||||
- 개발 환경 설정 가이드
|
||||
- 2단계 백엔드 구축 계획
|
||||
|
||||
이 일정은 유연하게 조정 가능하며, 각 태스크의 완료 상황에 따라 일정을 앞당기거나 미룰 수 있습니다. 중요한 것은 1주차 말에 2단계 백엔드 구축을 시작할 수 있도록 필요한 모든 계획과 설계가 완료되는 것입니다.
|
||||
@@ -1,303 +0,0 @@
|
||||
# 적자 탈출 가계부 - 2단계 계획
|
||||
|
||||
## 1. 2단계 목표
|
||||
|
||||
2단계의 주요 목표는 적자 탈출 가계부 앱의 백엔드 인프라를 구축하고, 데이터베이스를 설계하며, 기본적인 API 엔드포인트를 개발하는 것입니다. 이를 통해 3단계에서 진행될 프론트엔드 개발을 위한 기반을 마련합니다.
|
||||
|
||||
### 핵심 목표
|
||||
1. [x] Supabase 기반 백엔드 인프라 구축
|
||||
2. [x] 데이터베이스 스키마 구현
|
||||
3. [x] 기본 API 엔드포인트 개발
|
||||
4. [x] 사용자 인증 시스템 구현
|
||||
5. [ ] 초기 테스트 환경 구성
|
||||
|
||||
## 2. 작업 목록 및 일정
|
||||
|
||||
### 1일차: Supabase 프로젝트 설정
|
||||
|
||||
#### 오전
|
||||
- [x] [사용자] Supabase 계정 생성 및 프로젝트 생성
|
||||
- [x] [AI] Supabase 프로젝트 설정 가이드 작성
|
||||
- [x] [공동] 프로젝트 환경 변수 및 보안 설정
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 데이터베이스 연결 테스트 코드 작성
|
||||
- [x] [사용자] 데이터베이스 연결 테스트
|
||||
- [x] [AI] 기본 백엔드 구조 설계 문서 작성
|
||||
|
||||
### 2일차: 데이터베이스 스키마 구현
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] SQL 스키마 스크립트 작성
|
||||
- [x] Users 테이블 생성
|
||||
- [x] Cards 테이블 생성
|
||||
- [x] Categories 테이블 생성
|
||||
- [x] Expenses 테이블 생성
|
||||
- [x] Limits 테이블 생성
|
||||
- [x] Notifications 테이블 생성
|
||||
- [x] Templates 테이블 생성
|
||||
|
||||
#### 오후
|
||||
- [x] [사용자] SQL 스키마 스크립트 실행 및 검증
|
||||
- [x] [AI] 기본 카테고리 데이터 삽입 스크립트 작성
|
||||
- [x] [사용자] 기본 데이터 삽입 및 확인
|
||||
- [x] [공동] 데이터베이스 인덱스 및 제약 조건 검토
|
||||
- [x] [공동] 코드 및 문서 관리 원칙 수립 (Gitea와 옵시디언 통합)
|
||||
|
||||
### 3-4일차: API 엔드포인트 개발
|
||||
|
||||
#### 3일차 오전
|
||||
- [x] [AI] 사용자 관리 API 개발
|
||||
- [x] 회원가입 API
|
||||
- [x] 로그인 API
|
||||
- [x] 프로필 조회/수정 API
|
||||
- [x] 비밀번호 변경/재설정 API
|
||||
|
||||
#### 3일차 오후
|
||||
- [x] [AI] 카드 관리 API 개발
|
||||
- [x] 카드 등록 API
|
||||
- [x] 카드 조회 API
|
||||
- [x] 카드 수정/삭제 API
|
||||
- [x] 카드 한도 설정 API
|
||||
|
||||
#### 4일차 오전
|
||||
- [x] [AI] 지출 관리 API 개발
|
||||
- [x] 지출 등록 API
|
||||
- [x] 지출 조회 API
|
||||
- [x] 지출 수정/삭제 API
|
||||
- [x] 지출 필터링/검색 API
|
||||
|
||||
#### 4일차 오후
|
||||
- [x] [AI] 분석 및 대시보드 API 개발
|
||||
- [x] 카테고리별 지출 분석 API
|
||||
- [x] 기간별 지출 추이 API
|
||||
- [x] 한도 사용 현황 API
|
||||
- [x] 대시보드 요약 정보 API
|
||||
|
||||
### 5일차: 인증 및 보안 구현
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 사용자 인증 시스템 구현
|
||||
- [x] JWT 토큰 기반 인증 설정
|
||||
- [x] 소셜 로그인 연동 (Google, Kakao, Naver, Apple)
|
||||
- [x] 권한 관리 시스템 구현
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 데이터 보안 구현
|
||||
- [x] 민감 정보 암호화 설정
|
||||
- [x] API 요청 검증 미들웨어 구현
|
||||
- [x] CORS 및 보안 헤더 설정
|
||||
|
||||
### 6일차: 테스트 및 문서화
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] API 테스트 스크립트 작성
|
||||
- [x] 단위 테스트 작성
|
||||
- [x] 통합 테스트 작성
|
||||
- [x] 성능 테스트 작성
|
||||
|
||||
#### 오후
|
||||
- [x] [공동] API 문서 작성
|
||||
- [x] Swagger/OpenAPI 문서 생성
|
||||
- [x] API 엔드포인트 사용 예제 작성
|
||||
- [x] 에러 코드 및 응답 형식 문서화
|
||||
|
||||
### 7일차: 2단계 검토 및 3단계 준비
|
||||
|
||||
#### 오전
|
||||
- [x] [공동] 2단계 산출물 검토
|
||||
- [x] 백엔드 기능 테스트
|
||||
- [x] API 응답 검증
|
||||
- [x] 성능 및 보안 검토
|
||||
|
||||
#### 오후
|
||||
- [ ] [공동] 3단계 계획 수립
|
||||
- [ ] 3단계 작업 목록 초안 작성
|
||||
- [ ] 3단계 일정 및 우선순위 결정
|
||||
- [ ] 3단계 목표 및 성공 기준 정의
|
||||
- [ ] [AI] 2단계 결과물 최종 정리 및 문서화
|
||||
|
||||
## 3. 기술적 고려사항
|
||||
|
||||
### 3.1 Supabase 설정
|
||||
- Supabase 프로젝트 리전: 서울 (ap-northeast-2)
|
||||
- 데이터베이스 성능 티어: 스타터 플랜
|
||||
- 스토리지 설정: 영수증 이미지 저장용 버킷 구성
|
||||
- 백업 설정: 일일 자동 백업 활성화
|
||||
|
||||
### 3.2 API 설계 원칙
|
||||
- RESTful API 설계 원칙 준수
|
||||
- JSON 응답 형식 표준화
|
||||
- HTTP 상태 코드 적절히 활용
|
||||
- 페이지네이션 및 필터링 지원
|
||||
- 일관된 에러 처리 및 응답 형식
|
||||
|
||||
### 3.3 보안 고려사항
|
||||
- 모든 API 요청에 인증 필요 (공개 API 제외)
|
||||
- 비밀번호 해싱에 bcrypt 사용
|
||||
- API 요청 속도 제한 설정
|
||||
- 민감한 정보는 서버 측에서만 처리
|
||||
- HTTPS 강제 적용
|
||||
|
||||
### 3.4 성능 최적화
|
||||
- 데이터베이스 쿼리 최적화
|
||||
- 적절한 인덱스 설정
|
||||
- 캐싱 전략 구현 (Redis 고려)
|
||||
- 대량 데이터 처리를 위한 페이지네이션
|
||||
- 비동기 처리가 필요한 작업 식별
|
||||
|
||||
## 4. 산출물 목록
|
||||
|
||||
2단계 완료 시 다음과 같은 산출물이 생성될 예정입니다:
|
||||
|
||||
1. **Supabase 프로젝트 설정 문서**
|
||||
- 프로젝트 구성 정보
|
||||
- 환경 변수 목록
|
||||
- 접근 권한 설정
|
||||
|
||||
2. **데이터베이스 스키마 문서**
|
||||
- SQL 스키마 스크립트
|
||||
- ER 다이어그램 (구현 버전)
|
||||
- 인덱스 및 제약 조건 목록
|
||||
|
||||
3. **API 문서**
|
||||
- API 엔드포인트 목록 및 설명
|
||||
- 요청/응답 형식 예제
|
||||
- 인증 및 권한 요구사항
|
||||
|
||||
4. **테스트 문서**
|
||||
- 테스트 케이스 목록
|
||||
- 테스트 결과 보고서
|
||||
- 성능 테스트 결과
|
||||
|
||||
5. **개발 가이드**
|
||||
- 로컬 개발 환경 설정 방법
|
||||
- API 사용 예제 코드
|
||||
- 문제 해결 가이드
|
||||
|
||||
## 5. 위험 요소 및 대응 계획
|
||||
|
||||
### 5.1 기술적 위험
|
||||
- **Supabase 제한 사항**: 무료/스타터 플랜의 제한 사항 파악 및 대응 계획 수립
|
||||
- **데이터베이스 성능**: 대량 데이터 처리 시 성능 이슈 대응 방안 마련
|
||||
- **API 응답 시간**: 복잡한 쿼리의 응답 시간 최적화 전략 수립
|
||||
|
||||
### 5.2 일정 관련 위험
|
||||
- **기술 학습 시간**: Supabase 학습에 필요한 추가 시간 고려
|
||||
- **예상치 못한 문제**: 버퍼 시간을 일정에 포함하여 계획
|
||||
|
||||
### 5.3 보안 관련 위험
|
||||
- **데이터 보안**: 민감 정보 보호를 위한 추가 보안 조치 계획
|
||||
- **인증 시스템**: 보안 취약점 방지를 위한 철저한 테스트 계획
|
||||
|
||||
## 6. 성공 기준
|
||||
|
||||
2단계는 다음 기준이 충족될 때 성공적으로 완료된 것으로 간주합니다:
|
||||
|
||||
1. 모든 데이터베이스 테이블이 성공적으로 생성되고 관계가 설정됨
|
||||
2. 모든 필수 API 엔드포인트가 구현되고 테스트됨
|
||||
3. 사용자 인증 시스템이 안전하게 작동함
|
||||
4. API 응답 시간이 목표 성능 기준을 충족함 (평균 응답 시간 < 300ms)
|
||||
5. 모든 API가 문서화되고 프론트엔드 개발에 사용할 준비가 됨
|
||||
|
||||
## 7. 다음 단계 미리보기
|
||||
|
||||
2단계 완료 후 진행될 3단계의 주요 내용은 다음과 같습니다:
|
||||
|
||||
1. Flutter 프로젝트 설정 및 기본 구조 구현
|
||||
2. UI 컴포넌트 개발 및 스타일 가이드 작성
|
||||
3. 백엔드 API와의 연동 구현
|
||||
4. 핵심 화면 및 기능 구현
|
||||
5. 사용자 테스트 및 피드백 수집
|
||||
|
||||
## 8. 진행 상황
|
||||
|
||||
### 8.1 완료된 작업
|
||||
1. [x] **Supabase 프로젝트 설정**
|
||||
- [x] 프로젝트 생성 및 기본 설정
|
||||
- [x] 데이터베이스 연결 설정
|
||||
- [x] 스토리지 버킷 구성
|
||||
- [x] 백업 설정 구성
|
||||
|
||||
2. [x] **데이터베이스 스키마 구현**
|
||||
- [x] 사용자 테이블 생성
|
||||
- [x] 카테고리 테이블 생성
|
||||
- [x] 지출/수입 테이블 생성
|
||||
- [x] 예산 테이블 생성
|
||||
- [x] 카드 테이블 생성
|
||||
- [x] 한도 테이블 생성
|
||||
- [x] 템플릿 테이블 생성
|
||||
- [x] 알림 테이블 생성
|
||||
- [x] 분석 설정 테이블 생성
|
||||
|
||||
3. [x] **기본 데이터 삽입**
|
||||
- [x] 기본 카테고리 데이터 삽입
|
||||
- [x] 테스트 사용자 데이터 삽입
|
||||
- [x] 샘플 지출/수입 데이터 삽입
|
||||
|
||||
4. [x] **API 엔드포인트 개발**
|
||||
- [x] 사용자 관리 API 함수 구현
|
||||
- [x] 카테고리 관리 API 함수 구현
|
||||
- [x] 지출/수입 관리 API 함수 구현
|
||||
- [x] 예산 관리 API 함수 구현
|
||||
- [x] 카드 관리 API 함수 구현
|
||||
- [x] 한도 관리 API 함수 구현
|
||||
- [x] 템플릿 관리 API 함수 구현
|
||||
- [x] 알림 관리 API 함수 구현
|
||||
- [x] 분석 관리 API 함수 구현
|
||||
|
||||
5. [x] **사용자 인증 시스템 구현**
|
||||
- [x] JWT 토큰 기반 인증
|
||||
- [x] 비밀번호 암호화 (bcrypt)
|
||||
- [x] 소셜 로그인 연동 (Google, Kakao, Naver, Apple)
|
||||
- [x] 이메일 인증 및 비밀번호 재설정
|
||||
- [x] Row Level Security (RLS) 정책 구현
|
||||
- [x] 토큰 블랙리스트 관리 (로그아웃)
|
||||
|
||||
6. [x] **데이터 보안 구현**
|
||||
- [x] 민감 정보 암호화 설정
|
||||
- [x] API 요청 검증 미들웨어 구현
|
||||
- [x] CORS 및 보안 헤더 설정
|
||||
- [x] 데이터 암호화 전략 수립
|
||||
- [x] 보안 감사 및 검증
|
||||
|
||||
7. [x] **성능 테스트 및 최적화**
|
||||
- [x] 데이터베이스 쿼리 성능 테스트
|
||||
- [x] 성능 병목 지점 식별
|
||||
- [x] 성능 최적화 전략 수립
|
||||
- [x] 성능 테스트 보고서 작성
|
||||
|
||||
### 8.2 진행 중인 작업
|
||||
- [x] 보안 감사 및 검증
|
||||
- [x] 보안 취약점 분석
|
||||
- [x] 보안 테스트 및 검증
|
||||
|
||||
### 8.3 다음 단계
|
||||
- [ ] 백엔드 테스트
|
||||
- [x] 단위 테스트 작성 및 실행
|
||||
- [x] 인증 시스템 단위 테스트 작성 및 실행
|
||||
- [x] 기타 API 함수 단위 테스트 작성 및 실행
|
||||
- [x] 통합 테스트 구현
|
||||
- [x] 보안 테스트 및 취약점 분석
|
||||
|
||||
- [ ] 3단계 준비
|
||||
- [ ] 프론트엔드 개발 환경 설정
|
||||
- [ ] API 연동 계획 수립
|
||||
- [ ] 3단계 세부 일정 및 작업 목록 작성
|
||||
|
||||
## 9. 이슈 및 고려사항
|
||||
|
||||
1. [ ] **Supabase Realtime 서비스 상태**
|
||||
- [ ] Realtime 서비스가 현재 Unhealthy 상태로 표시됨
|
||||
- [ ] 실시간 기능이 필요한 경우 추가 디버깅 필요
|
||||
- [ ] 우선순위: 중간 (기본 CRUD 작업에는 영향 없음)
|
||||
|
||||
2. [ ] **대용량 데이터 처리 전략**
|
||||
- [ ] 장기적인 데이터 보관 정책 수립 필요
|
||||
- [ ] 오래된 데이터 아카이빙 전략 고려
|
||||
- [ ] 우선순위: 낮음 (초기 단계에서는 문제 없음)
|
||||
|
||||
3. [ ] **API 성능 최적화**
|
||||
- [ ] 복잡한 분석 쿼리 최적화 필요
|
||||
- [ ] 캐싱 전략 구현 고려
|
||||
- [ ] 우선순위: 중간 (기본 기능에는 영향 없음)
|
||||
@@ -1,223 +0,0 @@
|
||||
/Users/hansoo./Documents/my vault/3. Resource/Users/hansoo./Documents/my vault/3. Resource# 적자 탈출 가계부 - 3단계 계획
|
||||
|
||||
## 1. 3단계 목표
|
||||
|
||||
3단계의 주요 목표는 적자 탈출 가계부 앱의 프론트엔드를 개발하고, 백엔드 API와 연동하여 완전한 사용자 경험을 제공하는 것입니다. 이 단계에서는 Flutter를 사용하여 크로스 플랫폼 모바일 앱을 개발합니다.
|
||||
|
||||
### 핵심 목표
|
||||
1. [x] Flutter 프로젝트 설정 및 기본 구조 구현
|
||||
2. [x] UI 컴포넌트 개발 및 디자인 시스템 구축
|
||||
3. [ ] 백엔드 API와의 연동 구현
|
||||
4. [x] 핵심 화면 및 기능 구현
|
||||
5. [ ] 사용자 테스트 및 피드백 수집
|
||||
|
||||
## 2. 작업 목록 및 일정
|
||||
|
||||
### 1일차: 개발 환경 설정 및 프로젝트 구조 설계
|
||||
|
||||
#### 오전
|
||||
- [x] [사용자] Flutter 개발 환경 설정
|
||||
- [x] [AI] Flutter 프로젝트 생성 및 기본 설정 가이드 작성
|
||||
- [x] [공동] 프로젝트 구조 및 아키텍처 설계
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 상태 관리 전략 수립 (Provider, Bloc, Riverpod 등)
|
||||
- [x] [AI] 라우팅 및 네비게이션 설계
|
||||
- [x] [사용자] 기본 프로젝트 구조 검증 및 테스트
|
||||
|
||||
### 2일차: 디자인 시스템 및 UI 컴포넌트 개발
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 디자인 시스템 설계
|
||||
- [x] 색상 팔레트 및 테마 설정
|
||||
- [x] 타이포그래피 스타일 정의
|
||||
- [x] 공통 UI 컴포넌트 디자인
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 기본 UI 컴포넌트 구현
|
||||
- [x] 버튼, 입력 필드, 카드 등 기본 컴포넌트
|
||||
- [x] 커스텀 위젯 및 애니메이션
|
||||
- [x] 반응형 레이아웃 구현
|
||||
|
||||
### 3-4일차: 화면 개발 및 API 연동
|
||||
|
||||
#### 3일차 오전
|
||||
- [x] [AI] 인증 관련 화면 개발
|
||||
- [x] 로그인 화면
|
||||
- [x] 회원가입 화면
|
||||
- [x] 비밀번호 재설정 화면
|
||||
|
||||
#### 3일차 오후
|
||||
- [x] [AI] 인증 API 연동
|
||||
|
||||
{{ ... }}
|
||||
|
||||
### 5일차: 지출 관리 기능 개발
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 지출 추가/편집 화면 개발
|
||||
- [x] [AI] 지출 목록 및 상세 화면 개발
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 지출 관리 API 연동
|
||||
- [x] [AI] 지출 필터링 및 검색 기능 구현
|
||||
|
||||
### 6일차: 예산 관리 및 프로필 기능 개발
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 예산 관리 화면 개발
|
||||
- [x] 예산 설정 화면
|
||||
- [x] 예산 사용 현황 표시
|
||||
- [x] 카테고리별 예산 관리
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 프로필 화면 개발
|
||||
- [x] 사용자 정보 표시 및 수정
|
||||
- [x] 테마 설정 (라이트/다크 모드)
|
||||
- [x] 언어 설정
|
||||
- [x] 로그아웃 기능
|
||||
|
||||
### 7일차: 통계 및 분석 기능 개발
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 통계 화면 개발
|
||||
- [x] 지출 추이 차트
|
||||
- [x] 카테고리별 지출 분석
|
||||
- [x] 기간별 지출 비교
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 분석 기능 구현
|
||||
- [x] 지출 패턴 분석
|
||||
- [x] 예산 대비 지출 분석
|
||||
- [x] 절약 제안 기능
|
||||
|
||||
### 8일차: 오프라인 동기화 기능 개발
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 오프라인 동기화 인프라 구축
|
||||
- [x] 동기화 큐 서비스 구현
|
||||
- [x] 로컬 데이터베이스 서비스 구현
|
||||
- [x] 네트워크 연결 상태 모니터링 서비스 구현
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 동기화 UI/UX 구현
|
||||
- [x] 동기화 상태 위젯 개발
|
||||
- [x] 동기화 대시보드 위젯 개발
|
||||
- [x] 동기화 상태 화면 개발
|
||||
- [x] 동기화 정책 설정 기능 구현
|
||||
|
||||
### 9일차: 오프라인 동기화 기능 테스트 및 개선
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 동기화 기능 테스트
|
||||
- [x] 다양한 네트워크 상황에서의 동기화 테스트
|
||||
- [x] 오류 처리 및 재시도 메커니즘 테스트
|
||||
- [x] 대용량 데이터 동기화 테스트
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 동기화 기능 개선
|
||||
- [x] 성능 최적화
|
||||
- [x] 사용자 경험 개선
|
||||
- [x] 오류 처리 메커니즘 강화
|
||||
|
||||
{{ ... }}
|
||||
|
||||
## 5. 진행 상황 요약 (2025-02-28 업데이트)
|
||||
|
||||
### 완료된 작업
|
||||
1. **프로젝트 기본 구조 구현**
|
||||
- Flutter 프로젝트 생성 및 설정
|
||||
- 디렉토리 구조 및 아키텍처 설계
|
||||
- Provider 패턴 기반 상태 관리 구현
|
||||
|
||||
2. **디자인 시스템 구축**
|
||||
- 앱 테마 설정 (라이트/다크 모드)
|
||||
- 색상 팔레트 및 타이포그래피 정의
|
||||
- 공통 UI 컴포넌트 구현
|
||||
|
||||
3. **핵심 화면 개발**
|
||||
- 스플래시 화면
|
||||
- 로그인/회원가입 화면
|
||||
- 홈 화면 (지출 요약 및 최근 지출 목록)
|
||||
- 지출 추가/편집/상세 화면
|
||||
- 예산 관리 화면
|
||||
- 프로필 화면
|
||||
- 동기화 상태 화면
|
||||
- 통계 및 분석 화면
|
||||
|
||||
4. **서비스 레이어 구현**
|
||||
- StorageService: Hive를 사용한 로컬 데이터 저장
|
||||
- AuthService: 사용자 인증 관리
|
||||
- ExpenseService: 지출 데이터 관리
|
||||
- BudgetService: 예산 데이터 관리
|
||||
- ApiService: 백엔드 API 통신
|
||||
- SyncQueueService: 오프라인 동기화 작업 관리
|
||||
- LocalDatabaseService: 로컬 데이터베이스 관리
|
||||
- ConnectivityService: 네트워크 연결 상태 모니터링
|
||||
|
||||
5. **모델 구현**
|
||||
- UserModel: 사용자 정보 모델
|
||||
- ExpenseModel: 지출 정보 모델
|
||||
- BudgetModel: 예산 정보 모델
|
||||
- CategoryConstants: 카테고리 상수 정의
|
||||
- SyncOperation: 동기화 작업 모델
|
||||
- SyncOperationType: 작업 유형 열거형
|
||||
- SyncStatus: 작업 상태 열거형
|
||||
|
||||
6. **프로바이더 구현**
|
||||
- UserProvider: 사용자 상태 관리
|
||||
- ExpenseProvider: 지출 상태 관리
|
||||
- BudgetProvider: 예산 상태 관리
|
||||
- ThemeProvider: 테마 상태 관리
|
||||
- ConnectivityProvider: 네트워크 연결 상태 관리
|
||||
|
||||
7. **오프라인 동기화 기능 구현**
|
||||
- 오프라인 작업 큐 관리 시스템
|
||||
- 동기화 상태 위젯 (SyncStatusWidget)
|
||||
- 동기화 대시보드 위젯 (SyncDashboardWidget)
|
||||
- 동기화 상태 화면 (SyncStatusScreen)
|
||||
- 네트워크 상태에 따른 자동/수동 동기화 정책
|
||||
- 작업 재시도 및 오류 처리 메커니즘
|
||||
- 동기화 작업 상태 추적 (대기, 진행 중, 완료, 실패)
|
||||
|
||||
8. **통계 및 분석 기능 구현**
|
||||
- 지출 추이 차트 구현
|
||||
- 카테고리별 지출 분석 시각화
|
||||
- 기간별 지출 비교 기능
|
||||
- 지출 패턴 분석 알고리즘
|
||||
- 예산 대비 지출 분석 대시보드
|
||||
- 절약 제안 기능
|
||||
|
||||
### 진행 중인 작업
|
||||
1. 오프라인 동기화 기능 테스트 및 안정화
|
||||
2. 테스트 환경 구성 (웹, 에뮬레이터)
|
||||
3. 대용량 데이터 동기화 성능 최적화
|
||||
|
||||
### 다음 작업 계획
|
||||
1. 동기화 작업 우선순위 설정 기능 구현
|
||||
2. 충돌 해결 메커니즘 구현
|
||||
3. 동기화 통계 및 로그 기능 강화
|
||||
4. 성능 최적화 및 버그 수정
|
||||
5. 사용자 테스트 및 피드백 수집
|
||||
6. 앱 출시 준비 (앱 스토어 등록 등)
|
||||
|
||||
### 기술적 이슈 및 해결 방안
|
||||
1. **폰트 호환성 문제**
|
||||
- 문제: Pretendard 폰트 사용 시 오류 발생
|
||||
- 해결: Google Fonts의 Noto Sans로 대체하여 해결
|
||||
|
||||
2. **라우팅 충돌 문제**
|
||||
- 문제: 라우트 이름과 변수명 충돌
|
||||
- 해결: 라우트 이름 변수를 더 명확한 이름으로 변경 (settings → settingsRoute)
|
||||
|
||||
3. **API 연동 문제**
|
||||
- 문제: 싱글톤 패턴 구현 시 의존성 주입 이슈
|
||||
- 해결: 생성자에서 선택적 매개변수를 통한 의존성 주입 방식 개선
|
||||
|
||||
4. **오프라인 동기화 이슈**
|
||||
- 문제: 네트워크 연결 복구 시 동기화 작업 중복 실행
|
||||
- 해결: 작업 ID 기반 중복 방지 메커니즘 구현
|
||||
|
||||
5. **로컬 데이터베이스 성능 이슈**
|
||||
- 문제: 대용량 데이터 처리 시 지연 발생
|
||||
- 해결: 인덱싱 및 페이지네이션 적용, 비동기 처리 최적화
|
||||
@@ -1,296 +0,0 @@
|
||||
# 적자 탈출 가계부 - 4단계 계획
|
||||
|
||||
## 1. 4단계 목표
|
||||
|
||||
4단계의 주요 목표는 적자 탈출 가계부 앱의 품질을 향상시키고, 사용자 경험을 개선하며, 앱 스토어 출시를 준비하는 것입니다. 이 단계에서는 테스트, 최적화, 안정화 작업을 중점적으로 진행합니다.
|
||||
|
||||
### 핵심 목표
|
||||
1. [x] 앱 성능 최적화 및 안정화 (2025년 2월 28일 완료)
|
||||
2. [ ] 사용자 테스트 및 피드백 수집/반영
|
||||
3. [x] 오프라인 동기화 기능 안정화 (2025년 2월 25일 완료)
|
||||
4. [ ] 앱 출시 준비 및 배포
|
||||
5. [ ] 사용자 가이드 및 문서 작성
|
||||
|
||||
## 2. 작업 목록 및 일정
|
||||
|
||||
### 1일차: 성능 최적화 및 코드 리팩토링 (2025년 2월 24일 완료)
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 성능 분석 및 병목 지점 식별
|
||||
- [x] 메모리 사용량 분석
|
||||
- [x] 렌더링 성능 분석
|
||||
- [x] 네트워크 요청 최적화 분석
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 코드 리팩토링 및 최적화
|
||||
- [x] 불필요한 빌드 최소화
|
||||
- [x] 메모리 누수 해결
|
||||
- [x] 이미지 및 리소스 최적화
|
||||
|
||||
### 2일차: 오프라인 동기화 기능 안정화 (2025년 2월 25일 완료)
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 동기화 성능 최적화
|
||||
- [x] 대용량 데이터 동기화 테스트
|
||||
- [x] 동기화 작업 우선순위 설정 기능 구현
|
||||
- [x] 충돌 해결 메커니즘 구현
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 동기화 오류 처리 강화
|
||||
- [x] 네트워크 불안정 상황 테스트
|
||||
- [x] 동기화 실패 복구 메커니즘 개선
|
||||
- [x] 동기화 로그 및 통계 기능 구현
|
||||
|
||||
### 3일차: 개발자 모드 및 성능 모니터링 도구 구현 (2025년 2월 26-27일 완료)
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 개발자 모드 기능 구현
|
||||
- [x] 개발자 모드 활성화/비활성화 기능
|
||||
- [x] 7번 클릭으로 개발자 모드 전환 기능
|
||||
- [x] SharedPreferences를 사용한 상태 지속
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 성능 모니터링 도구 구현
|
||||
- [x] 프레임 렌더링 타이밍 추적
|
||||
- [x] 빌드 시간 및 래스터 시간 기록
|
||||
- [x] 느린 프레임 및 프레임 드롭 감지
|
||||
- [x] 성능 측정 데이터 저장 및 분석
|
||||
|
||||
### 4일차: 메모리 관리 및 성능 프로필 화면 구현 (2025년 2월 28일 완료)
|
||||
|
||||
#### 오전
|
||||
- [x] [AI] 메모리 관리 기능 강화
|
||||
- [x] 메모리 사용량 기록
|
||||
- [x] 리소스(구독, 타이머, 애니메이션 컨트롤러) 추적
|
||||
- [x] 메모리 정리 및 가비지 컬렉션 기능
|
||||
|
||||
#### 오후
|
||||
- [x] [AI] 성능 프로필 화면 구현
|
||||
- [x] 앱 및 기기 정보 표시
|
||||
- [x] 빌드 시간 차트
|
||||
- [x] 메모리 사용량 차트
|
||||
- [x] 메모리 정리 및 보고서 생성 버튼
|
||||
- [x] [AI] 오프라인 모드 및 테스트 모드 구현
|
||||
- [x] 인증 서비스 테스트 모드 추가
|
||||
- [x] 오프라인 상태에서 로그인/회원가입 기능 구현
|
||||
- [x] 동기화 큐에 인증 작업 추가 기능 구현
|
||||
- [x] 로컬 데이터베이스에 사용자 정보 저장 기능 추가
|
||||
|
||||
### 5일차: 사용자 테스트 준비 및 진행 (2025년 3월 1일 예정)
|
||||
|
||||
#### 오전
|
||||
- [ ] [AI] 테스트 시나리오 및 설문지 작성
|
||||
- [ ] 핵심 기능 테스트 시나리오
|
||||
- [ ] 사용성 테스트 항목
|
||||
- [ ] 피드백 수집 설문지
|
||||
|
||||
#### 오후
|
||||
- [ ] [사용자] 내부 테스트 진행
|
||||
- [ ] 테스트 참가자 모집
|
||||
- [ ] 테스트 세션 진행
|
||||
- [ ] 피드백 수집
|
||||
|
||||
### 6일차: 피드백 분석 및 개선 (2025년 3월 2일 예정)
|
||||
|
||||
#### 오전
|
||||
- [ ] [AI] 수집된 피드백 분석
|
||||
- [ ] 주요 이슈 및 개선점 식별
|
||||
- [ ] 우선순위 설정
|
||||
- [ ] 개선 계획 수립
|
||||
|
||||
#### 오후
|
||||
- [ ] [AI] 핵심 개선사항 구현
|
||||
- [ ] UI/UX 개선
|
||||
- [ ] 기능 개선
|
||||
- [ ] 버그 수정
|
||||
|
||||
### 7일차: 보안 및 데이터 무결성 강화 (2025년 3월 3일 예정)
|
||||
|
||||
#### 오전
|
||||
- [ ] [AI] 보안 감사 및 개선
|
||||
- [ ] 데이터 암호화 검토
|
||||
- [ ] 인증 및 권한 관리 강화
|
||||
- [ ] 개인정보 보호 검토
|
||||
|
||||
#### 오후
|
||||
- [ ] [AI] 데이터 무결성 강화
|
||||
- [ ] 데이터 백업 및 복구 기능
|
||||
- [ ] 데이터 검증 로직 강화
|
||||
- [ ] 오류 발생 시 데이터 보호 메커니즘
|
||||
|
||||
### 8일차: 앱 출시 준비 (2025년 3월 4일 예정)
|
||||
|
||||
#### 오전
|
||||
- [ ] [AI] 앱 스토어 최적화
|
||||
- [ ] 앱 아이콘 및 스크린샷 준비
|
||||
- [ ] 앱 설명 및 키워드 최적화
|
||||
- [ ] 개인정보 처리방침 작성
|
||||
|
||||
#### 오후
|
||||
- [ ] [AI] 출시 버전 빌드 및 테스트
|
||||
- [ ] 릴리스 빌드 생성
|
||||
- [ ] 최종 테스트 진행
|
||||
- [ ] 배포 준비
|
||||
|
||||
### 9일차: 사용자 가이드 및 문서 작성 (2025년 3월 5일 예정)
|
||||
|
||||
#### 오전
|
||||
- [ ] [AI] 사용자 가이드 작성
|
||||
- [ ] 주요 기능 사용법
|
||||
- [ ] 자주 묻는 질문 (FAQ)
|
||||
- [ ] 문제 해결 가이드
|
||||
|
||||
#### 오후
|
||||
- [ ] [AI] 개발자 문서 작성
|
||||
- [ ] 아키텍처 문서
|
||||
- [ ] API 문서
|
||||
- [ ] 유지보수 가이드
|
||||
|
||||
## 3. 기술 스택 및 도구
|
||||
|
||||
### 테스트 도구
|
||||
- Flutter 테스트 프레임워크
|
||||
- Firebase Test Lab
|
||||
- Flutter Performance 모니터링 도구
|
||||
- 자체 개발한 성능 프로파일링 도구
|
||||
|
||||
### 성능 최적화 도구
|
||||
- Flutter DevTools
|
||||
- Lighthouse (웹 버전)
|
||||
- Firebase Performance Monitoring
|
||||
- 자체 개발한 메모리 관리 및 성능 모니터링 도구
|
||||
|
||||
### 배포 도구
|
||||
- Fastlane
|
||||
- Firebase App Distribution
|
||||
- Google Play Console
|
||||
- Apple App Store Connect
|
||||
|
||||
## 4. 품질 지표 및 목표
|
||||
|
||||
### 성능 목표
|
||||
- 앱 시작 시간: 2초 이내
|
||||
- 화면 전환 시간: 300ms 이내
|
||||
- 메모리 사용량: 최대 100MB
|
||||
- 배터리 소모: 1시간 사용 시 5% 이내
|
||||
- 프레임 드롭률: 1% 이하
|
||||
|
||||
### 안정성 목표
|
||||
- 크래시 비율: 0.1% 이하
|
||||
- ANR (Application Not Responding): 0.05% 이하
|
||||
- 오프라인 동기화 성공률: 99% 이상
|
||||
- 메모리 누수 발생률: 0%
|
||||
|
||||
### 사용자 경험 목표
|
||||
- 앱 스토어 평점: 4.5 이상
|
||||
- 사용자 이탈률: 20% 이하
|
||||
- 일일 활성 사용자 (DAU): 초기 목표 1,000명
|
||||
|
||||
## 5. 출시 전략
|
||||
|
||||
### 단계적 출시
|
||||
1. 내부 테스트 (알파)
|
||||
- 개발팀 및 내부 사용자 대상
|
||||
- 주요 버그 및 성능 이슈 식별
|
||||
- 개발자 모드를 통한 성능 데이터 수집
|
||||
|
||||
2. 제한된 공개 테스트 (베타)
|
||||
- 선별된 외부 사용자 대상
|
||||
- 사용자 피드백 수집 및 개선
|
||||
- 성능 모니터링 데이터 분석
|
||||
|
||||
3. 정식 출시
|
||||
- 구글 플레이 스토어 및 애플 앱 스토어 출시
|
||||
- 마케팅 활동 시작
|
||||
|
||||
### 마케팅 전략
|
||||
- 소셜 미디어 홍보
|
||||
- 금융/가계부 관련 커뮤니티 홍보
|
||||
- 보도자료 배포
|
||||
- 인플루언서 협업
|
||||
|
||||
## 6. 위험 요소 및 대응 계획
|
||||
|
||||
### 잠재적 위험
|
||||
1. **성능 이슈**
|
||||
- 위험: 대용량 데이터 처리 시 성능 저하
|
||||
- 대응: 페이지네이션 및 지연 로딩 구현, 데이터 캐싱 최적화, 개발자 모드를 통한 지속적인 성능 모니터링
|
||||
|
||||
2. **동기화 충돌**
|
||||
- 위험: 오프라인 모드에서 동일 데이터 수정 시 충돌
|
||||
- 대응: 충돌 해결 알고리즘 구현, 사용자 선택 옵션 제공, 동기화 로그 및 통계 기능을 통한 문제 추적
|
||||
|
||||
3. **Provider 관련 오류**
|
||||
- 위험: Provider 패턴 사용 시 의존성 주입 문제로 앱 실행 오류 발생
|
||||
- 대응: 모든 Provider를 MultiProvider에 등록하고, 의존성 주입을 통해 서비스 공유, 일관된 네이밍 컨벤션 적용
|
||||
|
||||
4. **API 요청 실패**
|
||||
- 위험: 서버 연결 불안정 또는 API 오류로 인한 데이터 로딩 실패
|
||||
- 대응: 모든 API 호출에 대한 로컬 데이터 대체 로직 구현, 오프라인 모드 강화, 사용자 친화적 오류 메시지 제공
|
||||
|
||||
5. **사용자 수용성**
|
||||
- 위험: 복잡한 기능으로 인한 사용자 혼란
|
||||
- 대응: 직관적인 UI/UX 개선, 튜토리얼 및 도움말 강화
|
||||
|
||||
6. **보안 취약점**
|
||||
- 위험: 개인 금융 데이터 유출 가능성
|
||||
- 대응: 데이터 암호화, 보안 감사, 취약점 테스트
|
||||
|
||||
## 7. 해결된 주요 이슈
|
||||
|
||||
### Provider 관련 오류
|
||||
- **문제**: ConnectivityProvider를 찾을 수 없는 `ProviderNotFoundException` 오류 발생
|
||||
- **원인**:
|
||||
1. `main.dart`에 `ConnectivityProvider`가 MultiProvider 목록에 포함되지 않음
|
||||
2. `ConnectivityProvider` 생성자가 새로운 `ConnectivityService` 인스턴스를 생성하여 의존성 공유 불가
|
||||
- **해결**:
|
||||
1. `main.dart`의 MultiProvider 목록에 `ConnectivityProvider` 추가
|
||||
2. `ConnectivityProvider` 생성자 수정하여 외부에서 `ConnectivityService` 주입 가능하도록 변경
|
||||
3. `isConnected` getter 추가하여 `isOnline`과 동일하게 동작하도록 함
|
||||
|
||||
### 예산 데이터 로딩 오류
|
||||
- **문제**: 예산 화면에서 "예산 사용 현황을 불러오는 중 오류가 발생했습니다: Exception: 예산 사용 현황 조회 실패: Exception: 서버 오류: 404" 메시지 표시
|
||||
- **원인**: 서버에서 예산 데이터를 가져오는 API 요청이 404 오류를 반환하고, 오류 발생 시 로컬 데이터를 사용하는 대체 로직이 없었음
|
||||
- **해결**: `BudgetService`의 `getBudgetUsage` 메서드를 수정하여 API 호출이 실패할 경우 로컬 데이터를 사용하도록 변경
|
||||
|
||||
## 8. 유지보수 계획
|
||||
|
||||
### 정기 업데이트
|
||||
- 월 1회 기능 업데이트
|
||||
- 2주 1회 버그 수정 및 안정성 개선
|
||||
- 사용자 피드백 기반 개선 사항 우선순위 지정
|
||||
|
||||
### 모니터링 시스템
|
||||
- Firebase Crashlytics를 통한 오류 모니터링
|
||||
- Firebase Analytics를 통한 사용자 행동 분석
|
||||
- 자체 개발한 성능 모니터링 도구를 통한 성능 데이터 수집 및 분석
|
||||
- 사용자 피드백 수집 및 분석 시스템
|
||||
|
||||
## 9. 개발자 모드 및 성능 모니터링 도구 활용 계획
|
||||
|
||||
### 개발자 모드 활용
|
||||
- 내부 테스트 중 성능 데이터 수집
|
||||
- 사용자 환경에서의 실제 성능 측정
|
||||
- 문제 발생 시 상세 진단 정보 수집
|
||||
|
||||
### 성능 모니터링 도구 활용
|
||||
- 프레임 렌더링 성능 지속적 모니터링
|
||||
- 메모리 사용량 추적 및 최적화
|
||||
- 성능 병목 현상 조기 발견 및 해결
|
||||
- 사용자 기기별 성능 차이 분석
|
||||
|
||||
### 메모리 관리 도구 활용
|
||||
- 메모리 누수 조기 발견 및 해결
|
||||
- 리소스 사용 최적화
|
||||
- 저사양 기기에서의 성능 개선
|
||||
|
||||
## 10. 결론 및 기대 효과
|
||||
|
||||
### 기대 효과
|
||||
- 앱의 안정성과 성능이 향상되어 사용자滿足도가 증가할 것으로 기대
|
||||
- 사용자 피드백을 반영한 지속적인 개선으로 앱의 품질이 유지될 것으로 기대
|
||||
- 마케팅 활동을 통해 사용자 수와 앱 스토어 평점이 개선될 것으로 기대
|
||||
|
||||
## 11. 참고자료
|
||||
|
||||
- [Git 이슈 트래킹 시스템 설정](1.%20Project/2.%20ZELLYY/젤리의%20적자%20탈출/04_참고자료/Git_이슈_트래킹_시스템.md)
|
||||
59
docs/03_개발_단계/개발_가이드라인.md
Normal file
59
docs/03_개발_단계/개발_가이드라인.md
Normal file
@@ -0,0 +1,59 @@
|
||||
# Zellyy Finance 개발 가이드라인
|
||||
|
||||
## 1. 코드 작성 원칙
|
||||
- 모든 컴포넌트는 함수형 컴포넌트로 작성할 것
|
||||
- Hook 명명 규칙은 'use'로 시작하는 camelCase 사용할 것
|
||||
- 비즈니스 로직은 훅으로 분리하여 재사용성 높일 것
|
||||
- 주석은 한국어로 작성하여 가독성 높일 것
|
||||
- prop 타입은 모두 TypeScript 인터페이스로 정의할 것
|
||||
|
||||
## 2. 트랜잭션 삭제 안전성
|
||||
- 트랜잭션 삭제 작업은 UI 스레드를 차단하지 않도록 비동기로 처리할 것
|
||||
- 상태 업데이트 전/후에 try-catch 블록으로 오류 처리할 것
|
||||
- 가능한 requestAnimationFrame 또는 queueMicrotask를 사용하여 UI 업데이트 최적화할 것
|
||||
- 컴포넌트 언마운트 상태를 추적하여 메모리 누수 방지할 것
|
||||
- 이벤트 핸들러는 성능 병목 지점이 될 수 있으므로 디바운스/스로틀링 적용할 것
|
||||
|
||||
## 3. Appwrite 통합 원칙
|
||||
- Appwrite 클라이언트는 앱 시작 시 한 번만 초기화
|
||||
- 인증 및 데이터 동기화는 전용 훅 사용
|
||||
- 오류 처리 및 사용자 피드백 제공
|
||||
- 트랜잭션 작업은 비동기로 처리
|
||||
- 네트워크 오류 시 적절한 재시도 메커니즘 구현
|
||||
|
||||
## 4. 상태 관리 최적화
|
||||
- 컴포넌트 간 상태 공유는 Context API나 상태 관리 라이브러리 사용할 것
|
||||
- 큰 상태 객체는 여러 작은 조각으로 분리하여 불필요한 리렌더링 방지할 것
|
||||
- 불변성을 유지하여 React의 상태 업데이트 최적화 활용할 것
|
||||
- useCallback, useMemo를 적극 활용하여 함수와 값 메모이제이션할 것
|
||||
- 기본 데이터 로딩은 상위 컴포넌트에서 처리하고 하위 컴포넌트로 전달할 것
|
||||
|
||||
## 5. 디버깅 및 로깅
|
||||
- 중요 작업(특히 트랜잭션 삭제와 같은 위험 작업)은 상세한 로그 남길 것
|
||||
- 개발 모드에서는 상태 변화를 추적할 수 있는 로그 포함할 것
|
||||
- 사용자에게 영향을 주는 오류는 UI 피드백(토스트 등)으로 표시할 것
|
||||
- 백그라운드 작업 실패는 적절히 로깅하고 필요시 재시도 메커니즘 구현할 것
|
||||
|
||||
## 6. iOS 지원
|
||||
- iOS 안전 영역(Safe Area) 고려한 UI 레이아웃 설계
|
||||
- iOS 특유의 제스처와 상호작용 패턴 지원 (스와이프, 핀치 등)
|
||||
- iOS 다크 모드 대응을 위한 동적 색상 시스템 활용
|
||||
- iOS 기기별 화면 크기 및 노치(Notch) 대응
|
||||
- iOS 앱 배포 시 필요한 인증서 및 프로비저닝 프로파일 관리
|
||||
|
||||
## 7. Android 지원
|
||||
- BuildInfo와 같은 네이티브 플러그인은 반드시 MainActivity에 등록할 것
|
||||
- 안드로이드 빌드 정보는 Capacitor 플러그인을 통해 JS로 전달할 것
|
||||
- 플러그인 호출 시 항상 오류 처리 로직 포함할 것
|
||||
- 네이티브 기능 실패 시 대체 방법(fallback) 제공할 것
|
||||
- 안드로이드 버전별 호환성 고려 (API 레벨 차이)
|
||||
- 다양한 화면 크기 및 해상도 대응 (태블릿 포함)
|
||||
- 안드로이드 백 버튼 처리 및 생명주기 관리
|
||||
- 권한 요청 및 처리 로직 구현
|
||||
- 안드로이드 알림 채널 설정 및 관리
|
||||
|
||||
## 8. 버전 관리
|
||||
- 모든 빌드는 자동으로 빌드 번호가 증가되도록 설정할 것
|
||||
- 릴리즈 빌드는 versionCode와 buildNumber 모두 증가할 것
|
||||
- 디버그 빌드는 buildNumber만 증가할 것
|
||||
- 버전 정보는 항상 설정 페이지에 표시하여 사용자와 개발자가 확인 가능하게 할 것
|
||||
Reference in New Issue
Block a user