272 lines
6.3 KiB
Markdown
272 lines
6.3 KiB
Markdown
# 적자 탈출 가계부 - 데이터 모델 설계
|
|
|
|
## 1. 핵심 데이터 엔티티
|
|
|
|
### 1.1 사용자(Users) 테이블
|
|
|
|
```
|
|
users
|
|
- id: UUID (PK)
|
|
- email: STRING (UNIQUE)
|
|
- password_hash: STRING
|
|
- name: STRING
|
|
- profile_image: STRING (nullable)
|
|
- created_at: TIMESTAMP
|
|
- updated_at: TIMESTAMP
|
|
- last_login_at: TIMESTAMP (nullable)
|
|
- notification_settings: JSON
|
|
- theme_preference: STRING (default: 'light')
|
|
- is_active: BOOLEAN (default: true)
|
|
```
|
|
|
|
### 1.2 카드(Cards) 테이블
|
|
|
|
```
|
|
cards
|
|
- id: UUID (PK)
|
|
- user_id: UUID (FK -> users.id)
|
|
- name: STRING
|
|
- card_type: ENUM ('credit', 'debit', 'prepaid')
|
|
- card_number_last4: STRING
|
|
- issuer: STRING
|
|
- color: STRING (for UI)
|
|
- payment_day: INTEGER (1-31)
|
|
- monthly_limit: DECIMAL
|
|
- is_active: BOOLEAN (default: true)
|
|
- created_at: TIMESTAMP
|
|
- updated_at: TIMESTAMP
|
|
```
|
|
|
|
### 1.3 카테고리(Categories) 테이블
|
|
|
|
```
|
|
categories
|
|
- id: UUID (PK)
|
|
- name: STRING
|
|
- icon: STRING
|
|
- color: STRING
|
|
- parent_id: UUID (FK -> categories.id, nullable)
|
|
- is_system: BOOLEAN (default: false)
|
|
- is_active: BOOLEAN (default: true)
|
|
- created_at: TIMESTAMP
|
|
- updated_at: TIMESTAMP
|
|
```
|
|
|
|
### 1.4 지출(Expenses) 테이블
|
|
|
|
```
|
|
expenses
|
|
- id: UUID (PK)
|
|
- user_id: UUID (FK -> users.id)
|
|
- card_id: UUID (FK -> cards.id)
|
|
- category_id: UUID (FK -> categories.id)
|
|
- amount: DECIMAL
|
|
- merchant: STRING
|
|
- transaction_date: TIMESTAMP
|
|
- description: TEXT (nullable)
|
|
- location: GEOGRAPHY (nullable)
|
|
- is_recurring: BOOLEAN (default: false)
|
|
- receipt_image: STRING (nullable)
|
|
- tags: STRING[] (nullable)
|
|
- created_at: TIMESTAMP
|
|
- updated_at: TIMESTAMP
|
|
```
|
|
|
|
### 1.5 한도(Limits) 테이블
|
|
|
|
```
|
|
limits
|
|
- id: UUID (PK)
|
|
- user_id: UUID (FK -> users.id)
|
|
- card_id: UUID (FK -> cards.id, nullable)
|
|
- category_id: UUID (FK -> categories.id, nullable)
|
|
- amount: DECIMAL
|
|
- period: ENUM ('daily', 'weekly', 'monthly')
|
|
- start_date: DATE
|
|
- end_date: DATE (nullable)
|
|
- is_active: BOOLEAN (default: true)
|
|
- created_at: TIMESTAMP
|
|
- updated_at: TIMESTAMP
|
|
```
|
|
|
|
### 1.6 알림(Notifications) 테이블
|
|
|
|
```
|
|
notifications
|
|
- id: UUID (PK)
|
|
- user_id: UUID (FK -> users.id)
|
|
- title: STRING
|
|
- message: TEXT
|
|
- type: ENUM ('limit_warning', 'payment_reminder', 'tip', 'system')
|
|
- related_entity_type: STRING (nullable)
|
|
- related_entity_id: UUID (nullable)
|
|
- is_read: BOOLEAN (default: false)
|
|
- created_at: TIMESTAMP
|
|
- read_at: TIMESTAMP (nullable)
|
|
```
|
|
|
|
### 1.7 템플릿(Templates) 테이블
|
|
|
|
```
|
|
templates
|
|
- id: UUID (PK)
|
|
- user_id: UUID (FK -> users.id)
|
|
- name: STRING
|
|
- category_id: UUID (FK -> categories.id)
|
|
- amount: DECIMAL (nullable)
|
|
- merchant: STRING (nullable)
|
|
- description: TEXT (nullable)
|
|
- is_favorite: BOOLEAN (default: false)
|
|
- created_at: TIMESTAMP
|
|
- updated_at: TIMESTAMP
|
|
```
|
|
|
|
## 2. 데이터 관계 및 제약 조건
|
|
|
|
### 2.1 테이블 간 관계 (ERD)
|
|
|
|
```
|
|
Users (1) --- (*) Cards
|
|
Users (1) --- (*) Expenses
|
|
Users (1) --- (*) Limits
|
|
Users (1) --- (*) Notifications
|
|
Users (1) --- (*) Templates
|
|
|
|
Cards (1) --- (*) Expenses
|
|
Cards (1) --- (*) Limits
|
|
|
|
Categories (1) --- (*) Expenses
|
|
Categories (1) --- (*) Limits
|
|
Categories (1) --- (*) Templates
|
|
Categories (1) --- (*) Categories (자기 참조: 부모-자식 관계)
|
|
```
|
|
|
|
### 2.2 기본 카테고리 목록
|
|
|
|
시스템에서 기본적으로 제공하는 카테고리 목록입니다:
|
|
|
|
1. **식비**
|
|
- 식료품
|
|
- 외식
|
|
- 카페/음료
|
|
|
|
2. **주거/통신**
|
|
- 월세/관리비
|
|
- 전기/수도/가스
|
|
- 인터넷/통신비
|
|
- 가구/가전
|
|
|
|
3. **교통**
|
|
- 대중교통
|
|
- 자동차/유류비
|
|
- 택시
|
|
|
|
4. **쇼핑**
|
|
- 의류/패션
|
|
- 화장품/미용
|
|
- 전자기기
|
|
- 생활용품
|
|
|
|
5. **여가/문화**
|
|
- 영화/공연
|
|
- 취미/레저
|
|
- 여행/숙박
|
|
- 도서/음악
|
|
|
|
6. **의료/건강**
|
|
- 병원/약국
|
|
- 운동/피트니스
|
|
|
|
7. **교육**
|
|
- 학비/등록금
|
|
- 학원/강의
|
|
- 교재/학습도구
|
|
|
|
8. **금융**
|
|
- 보험
|
|
- 세금
|
|
- 대출이자
|
|
- 투자
|
|
|
|
9. **기타**
|
|
- 기부/후원
|
|
- 용돈/선물
|
|
- 기타 지출
|
|
|
|
### 2.3 데이터 유효성 검사 규칙
|
|
|
|
#### 사용자(Users)
|
|
- 이메일은 유효한 형식이어야 하며 중복될 수 없음
|
|
- 비밀번호는 최소 8자 이상, 영문/숫자/특수문자 조합
|
|
- 이름은 필수 입력 항목
|
|
|
|
#### 카드(Cards)
|
|
- 카드 이름은 필수 입력 항목
|
|
- 월 한도는 0보다 커야 함
|
|
- 결제일은 1-31 사이의 값이어야 함
|
|
|
|
#### 지출(Expenses)
|
|
- 금액은 0보다 커야 함
|
|
- 거래 날짜는 현재 날짜보다 미래일 수 없음
|
|
- 카테고리는 필수 선택 항목
|
|
|
|
#### 한도(Limits)
|
|
- 한도 금액은 0보다 커야 함
|
|
- 카드 ID와 카테고리 ID는 둘 다 null이거나, 둘 중 하나만 지정되어야 함
|
|
- 시작 날짜는 필수 입력 항목
|
|
|
|
#### 템플릿(Templates)
|
|
- 템플릿 이름은 필수 입력 항목
|
|
- 카테고리는 필수 선택 항목
|
|
|
|
## 3. 데이터베이스 인덱스 설계
|
|
|
|
성능 최적화를 위한 인덱스 설계:
|
|
|
|
```
|
|
users: (email)
|
|
cards: (user_id, is_active)
|
|
expenses: (user_id, card_id), (user_id, category_id), (user_id, transaction_date), (is_recurring)
|
|
limits: (user_id, card_id), (user_id, category_id), (user_id, is_active)
|
|
notifications: (user_id, is_read), (user_id, created_at)
|
|
templates: (user_id, is_favorite)
|
|
categories: (parent_id), (is_system)
|
|
```
|
|
|
|
## 4. 데이터 마이그레이션 전략
|
|
|
|
1. **초기 설정**
|
|
- 기본 카테고리 데이터 생성
|
|
- 시스템 설정 데이터 생성
|
|
|
|
2. **버전 관리**
|
|
- 데이터베이스 스키마 버전 관리 시스템 도입
|
|
- 각 마이그레이션에 고유 ID 부여
|
|
|
|
3. **업그레이드 경로**
|
|
- 이전 버전에서 새 버전으로의 마이그레이션 스크립트 준비
|
|
- 데이터 무결성 검증 단계 포함
|
|
|
|
4. **롤백 전략**
|
|
- 각 마이그레이션에 대한 롤백 스크립트 준비
|
|
- 중요 데이터 변경 전 백업 수행
|
|
|
|
## 5. 데이터 보안 고려사항
|
|
|
|
1. **개인정보 보호**
|
|
- 사용자 비밀번호는 단방향 해시로 저장 (bcrypt 또는 Argon2)
|
|
- 카드 번호는 마지막 4자리만 저장
|
|
- 개인식별정보(PII)는 암호화하여 저장
|
|
|
|
2. **접근 제어**
|
|
- 사용자는 자신의 데이터만 접근 가능
|
|
- 관리자 권한은 최소 필요 인원에게만 부여
|
|
|
|
3. **데이터 백업**
|
|
- 정기적인 데이터베이스 백업 수행
|
|
- 백업 데이터 암호화 저장
|
|
|
|
4. **감사 로깅**
|
|
- 중요 데이터 변경에 대한 감사 로그 유지
|
|
- 비정상적인 접근 패턴 모니터링
|