문서 파일 정리

docs/03_개발_단계/01_개발_로드맵.md

@@ -0,0 +1,204 @@
+# 적자 탈출 가계부 개발 로드맵
+
+## 개발 접근 방식
+
+'적자 탈출 가계부' 프로젝트는 애자일 방법론을 기반으로 개발될 예정입니다. 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 접근법을 통해 핵심 기능을 우선적으로 개발하고, 사용자 피드백을 지속적으로 반영하여 서비스를 개선해 나갈 계획입니다. 
+
+개발 과정에서 발생할 수 있는 위험을 사전에 식별하고 대응 전략을 마련하여, 프로젝트의 성공적인 완수를 위한 기반을 마련하였습니다. 또한, 명확한 성공 기준을 설정하여 프로젝트의 진행 상황을 객관적으로 평가할 수 있도록 하였습니다.
+
+이 로드맵은 프로젝트의 진행 상황과 사용자 피드백에 따라 유연하게 조정될 수 있으며, 궁극적으로는 사용자들이 재정적 어려움에서 벗어나 건강한 재정 상태를 달성할 수 있도록 돕는 가치 있는 서비스를 제공하는 것을 목표로 합니다.

docs/03_개발_단계/1단계/1단계_산출물_요약.md

@@ -0,0 +1,122 @@
+# 적자 탈출 가계부 - 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 모델 선택 및 최적화
+- 사용자 피드백 반영 전략
+- 단계별 기능 확장 계획

docs/03_개발_단계/1단계/1단계_첫주차_할일.md

@@ -0,0 +1,131 @@
+# 적자 탈출 가계부 앱 - 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단계 백엔드 구축을 시작할 수 있도록 필요한 모든 계획과 설계가 완료되는 것입니다.

docs/03_개발_단계/2단계/2단계_계획.md

@@ -0,0 +1,303 @@
+# 적자 탈출 가계부 - 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 성능 최적화**
+   - [ ] 복잡한 분석 쿼리 최적화 필요
+   - [ ] 캐싱 전략 구현 고려
+   - [ ] 우선순위: 중간 (기본 기능에는 영향 없음)

docs/03_개발_단계/3단계/3단계_계획.md

@@ -0,0 +1,223 @@
+/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. **로컬 데이터베이스 성능 이슈**
+   - 문제: 대용량 데이터 처리 시 지연 발생
+   - 해결: 인덱싱 및 페이지네이션 적용, 비동기 처리 최적화

docs/03_개발_단계/4단계/4단계_계획.md

@@ -0,0 +1,296 @@
+# 적자 탈출 가계부 - 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)