Finance Automation

# Finance Automation

Automate payments, invoices, expenses, and financial reports.

## Features
- **Payments**: Real-time payment recording via Stripe/Lemon Squeezy webhooks
- **Invoices**: CRUD with auto-numbering, tax calculation, send/paid status management
- **Expenses**: Submit, approve, reject expenses with category analytics
- **Reports**: Daily/monthly revenue, MRR, profit reports
- **Notifications**: Real-time Telegram alerts

## Quick Start
```bash
cd finance-automation
cp .env.example .env
# Edit .env with your API keys
npm install
npm run db:init
npm run dev
```

## API Endpoints
```
POST   /api/invoices              Create invoice
GET    /api/invoices              List invoices
POST   /api/invoices/:id/send     Send invoice
POST   /api/invoices/:id/mark-paid Mark as paid

POST   /api/expenses              Add expense
POST   /api/expenses/:id/approve  Approve expense
POST   /api/expenses/:id/reject   Reject expense

GET    /api/reports/daily          Daily revenue + expenses
GET    /api/reports/monthly        Monthly report
GET    /api/reports/summary        Period summary
GET    /api/reports/mrr            Monthly Recurring Revenue
GET    /api/reports/profit         Profit report
```

## Requirements
- Node.js >= 18
- SQLite3 (default) or PostgreSQL
- Stripe account (for payment webhooks)

## Tags
finance, payment, invoice, expense, report, stripe, automation

# Finance Automation Skill

OpenClaw용 금융/결제 자동화 스킬

## 개요

Stripe/Lemon Squeezy 연동, 인보이스 자동화, 경비 처리, 재무 리포트 생성을 자동화하는 OpenClaw 스킬입니다.

## 핵심 가치 제안

- **경리 직원 1명 월급 절감** (월 300-420만원 → 49,000원)
- **ROI: 600-800%**
- **시간 70% 절감** (인보이스 작성)
- **실수 90% 감소** (경비 분류)

## 주요 기능

### Phase 1: MVP (Week 1-2)
- ✅ Stripe/Lemon Squeezy 결제 모니터링
- ✅ 실시간 알림 (Telegram)
- ✅ 일일/주간/월간 매출 요약
- ✅ 기본 인보이스 생성

### Phase 2: 인보이스 자동화 (Week 3)
- ✅ 인보이스 템플릿 (한국 세금계산서 포함)
- ✅ PDF 생성
- ✅ 자동 발송 (이메일)
- ✅ 결제 리마인더

### Phase 3: 경비 처리 (Week 4)
- ✅ 경비 입력 및 분류
- ✅ 영수증 OCR (선택)
- ✅ 카테고리 자동 분류
- ✅ 월별 경비 리포트

### Phase 4: 고급 분석 (Week 5-6)
- ✅ MRR (Monthly Recurring Revenue)
- ✅ Churn Rate
- ✅ LTV (Customer Lifetime Value)
- ✅ 트렌드 분석 및 예측

## 기술 스택

- **Backend**: Node.js 18+
- **Framework**: Express.js
- **Database**: SQLite (로컬) / PostgreSQL (프로덕션)
- **PDF**: PDFKit
- **OCR**: Tesseract.js (선택)
- **APIs**:
  - Stripe API
  - Lemon Squeezy API
  - OpenClaw Message API

## 프로젝트 구조

```
finance-automation/
├── README.md                 # 이 파일
├── ARCHITECTURE.md          # 아키텍처 문서
├── SKILL.md                 # OpenClaw 스킬 정의
├── package.json
├── .env.example
├── .gitignore
├── src/
│   ├── index.js            # 메인 진입점
│   ├── config/
│   │   └── config.js       # 환경 변수 관리
│   ├── api/
│   │   ├── stripe.js       # Stripe API 클라이언트
│   │   └── lemonSqueezy.js # Lemon Squeezy API 클라이언트
│   ├── webhooks/
│   │   ├── stripe.js       # Stripe Webhook 핸들러
│   │   └── lemonSqueezy.js # Lemon Squeezy Webhook 핸들러
│   ├── services/
│   │   ├── payment.js      # 결제 처리 로직
│   │   ├── invoice.js      # 인보이스 생성
│   │   ├── expense.js      # 경비 처리
│   │   ├── report.js       # 리포트 생성
│   │   └── notification.js # 알림 발송
│   ├── mod...