sam-docs/system/erp-analysis/08-reports.md

# 보고서 및 분석 (슬라이드 105-113)

## 1. 개요

보고서 및 분석 모듈은 일일 일보, 지출 예상 내역서, 가지급금 인정이자 계산, AI 리포트 생성 등을 제공합니다.

## 2. 일일 일보 (슬라이드 106-107)

### 2.1 일일 일보 조회
- 매일 전일의 입출금 및 매출 매입 현황 자동 집계

### 2.2 현황 카드
| 항목 | 설명 |
|------|------|
| 전일 잔액 | 조회 기준일 전일 잔액 |
| 당일 입금액 | 전일 입금 합계 |
| 당일 출금액 | 전일 출금 합계 |
| 당일 잔액 | 조회 기준일 잔액 |

### 2.3 일일 일보 목록
| 필드명 | 설명 |
|--------|------|
| 구분 | 입금/출금 |
| 거래처명 | |
| 계정과목 | |
| 입금액 | |
| 출금액 | |
| 적요 | |

### 2.4 엑셀 다운로드 버튼

## 3. 지출 예상 내역서 (슬라이드 108-109)

### 3.1 지출 예상 내역서 조회
- 예상 지출 금액 및 일정 조회

### 3.2 현황 카드
| 항목 | 설명 |
|------|------|
| 예상 지출 합계 | 월별 예상 지출 합계 |
| 계좌 잔액 | 현재 계좌 잔액 |
| 예상 잔액 | 계좌 잔액 - 예상 지출 합계 |

### 3.3 지출 예상 내역서 목록
| 필드명 | 설명 |
|--------|------|
| 예상 지급일 | |
| 품목 | |
| 지출금액 | |
| 거래처 | |
| 계좌 | |

### 3.4 엑셀 다운로드 버튼

### 3.5 월별 합계
| 항목 | 설명 |
|------|------|
| 2025/11 계 | 11월 지출 합계 |
| 2025/12 계 | 12월 지출 합계 |
| 지출 합계 | 전체 지출 합계 |
| 계좌 잔액 | |
| 최종 차액 | |

## 4. 가지급금 인정이자 계산 (슬라이드 110-112)

### 4.1 가지급금 인정이자 계산 예시 (2024년 기준)
- 인정이자율 4.6% (당좌대출이자율 기준, 매년 고시)

### 4.2 계산 예시
| 항목 | 금액 |
|------|------|
| 가지급금 잔액 | 15,200,000원 |
| 인정이자 | 699,200원 |
| 법인세 추가 (19%) | 132,848원 |
| 대표자 소득세 추가 (35%) | 244,720원 |
| 대표자 지방소득세 (10%) | 24,472원 |
| **총 세금 부담** | **402,040원** |

### 4.3 계산식
```
잔액 × 0.046 = 인정이자
인정이자 × 0.19 = 법인세 추가
인정이자 × 0.35 = 대표자 소득세 추가
```

### 4.4 기본 정산 공식
```
정산차액 = 가지급금 총액 - 실사용 총액
```

### 4.5 인정이자 계산 공식 (법인세법 기준)
```
경과일수 = 정산일 - 지급일
일이자율 = 연이자율 ÷ 365
인정이자 = 가지급금 × 일이자율 × 경과일수
```

## 5. AI 리포트 생성 (슬라이드 113)

### 5.1 AI 리포트 생성 프롬프트

#### 작성 규칙
1. 문장은 간결하고 명확하게 작성
2. 숫자는 읽기 쉽게 "3,123,000원", "15%" 형식 사용
3. 계정과목명, 거래처명은 구체적으로 명시
4. 조치가 필요한 경우 구체적인 행동 권한 포함
5. 긍정적 변화도 반드시 실상 포함
6. 법인세, 소득세 영향이 있는 경우 세무 리스크 명시

#### 키워드 강조 규칙
출력 메시지 내 다음 키워드는 프론트엔드에서 색상 강조됩니다:
- **빨간색(경고)**: 초과, 증가, 발생, 필요, 불가
- **주황색(주의)**: 점검, 확인, 주의, 검토
- **녹색(긍정)**: 감소, 완료, 정상
- **파란색(양호)**: 여유, 적정, 양호

#### 예시 출력
입력 데이터 예시에 대한 출력:

```json
{"리포트": [
  {"영역": "지출분석", "상태": "경고", "메시지": "이번 달 예상 지출이 전월 대비 15% 증가했습니다.", "상세": "매입 비용 증가가 주요 원인입니다."},
  {"영역": "가지급금", "상태": "주의", "메시지": "50일 이상 잔기 미수금 3건(2,500만원) 발생.", "상세": "회수 조치가 필요합니다."},
  {"영역": "카드/계좌", "상태": "경고", "메시지": "법인카드 사용 한도 85% 도달, 잔여 한도 600만원입니다.", "상세": "사용 계획을 점검해 주세요."},
  {"영역": "미수금", "상태": "주의", "메시지": "미수금에 대한 관리가 필요한 상태입니다.", "상세": ""}
],
"요약": "지출 증가와 정기 미수금에 대한 관리가 필요한 상태입니다."}
```

---

## 데이터 모델

### DailyReport (일일 일보)
```
- id: bigint
- tenant_id: bigint (FK)
- report_date: date
- previous_balance: decimal
- daily_deposit: decimal
- daily_withdrawal: decimal
- current_balance: decimal
- details: json # 입출금 상세 내역
- created_at: timestamp
```

### ExpenseEstimate (지출 예상 내역서)
```
- id: bigint
- tenant_id: bigint (FK)
- expected_date: date
- item_name: string
- amount: decimal
- vendor_id: bigint (FK, nullable)
- account_id: bigint (FK, nullable)
- created_at: timestamp
```

### LoanInterestCalculation (가지급금 인정이자 계산)
```
- id: bigint
- tenant_id: bigint (FK)
- calculation_date: date
- loan_balance: decimal
- interest_rate: decimal
- recognized_interest: decimal
- corporate_tax_addition: decimal
- income_tax_addition: decimal
- local_tax_addition: decimal
- total_tax_burden: decimal
- created_at: timestamp
```

### AIReport (AI 리포트)
```
- id: bigint
- tenant_id: bigint (FK)
- report_date: date
- report_type: string
- content: json # 리포트 내용
- summary: text
- created_at: timestamp
```

---

## API 도출

### 일일 일보 API
```
GET    /api/reports/daily                # 일일 일보 조회
GET    /api/reports/daily/export         # 일일 일보 엑셀 다운로드
```

### 지출 예상 내역서 API
```
GET    /api/reports/expense-estimate     # 지출 예상 내역서 조회
POST   /api/reports/expense-estimate     # 지출 예상 내역 등록
PUT    /api/reports/expense-estimate/{id}# 지출 예상 내역 수정
DELETE /api/reports/expense-estimate/{id}# 지출 예상 내역 삭제
GET    /api/reports/expense-estimate/export # 지출 예상 내역서 엑셀 다운로드
```

### 가지급금 인정이자 API
```
GET    /api/reports/loan-interest        # 가지급금 인정이자 계산 조회
POST   /api/reports/loan-interest/calculate # 가지급금 인정이자 계산 실행
```

### AI 리포트 API
```
GET    /api/reports/ai                   # AI 리포트 목록
POST   /api/reports/ai/generate          # AI 리포트 생성
GET    /api/reports/ai/{id}              # AI 리포트 상세
DELETE /api/reports/ai/{id}              # AI 리포트 삭제
```

### 대시보드/분석 API
```
GET    /api/dashboard/summary            # 대시보드 요약
GET    /api/dashboard/charts             # 대시보드 차트 데이터
GET    /api/analytics/sales              # 매출 분석
GET    /api/analytics/expense            # 지출 분석
GET    /api/analytics/receivables        # 미수금 분석
```