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. 법인세, 소득세 영향이 있는 경우 세무 리스크 명시

키워드 강조 규칙

출력 메시지 내 다음 키워드는 프론트엔드에서 색상 강조됩니다:

• 빨간색(경고): 초과, 증가, 발생, 필요, 불가
• 주황색(주의): 점검, 확인, 주의, 검토
• 녹색(긍정): 감소, 완료, 정상
• 파란색(양호): 여유, 적정, 양호

예시 출력

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

{"리포트": [
  {"영역": "지출분석", "상태": "경고", "메시지": "이번 달 예상 지출이 전월 대비 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        # 미수금 분석