hyowons
fed3526b20
설정·스크립트·스킬·문서·큐레이션 메모리 추적. 시크릿(credentials/identity)·런타임 상태(state/logs/sessions/sqlite)· 백업(clobbered/bak)·dream 캐시는 .gitignore로 제외. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# monthly-settlement
|
|
|
|
매월 1일에 후잉 잔액을 스냅샷으로 저장하고, 전월 스냅샷과 비교해 자산 변동을 리포트한다.
|
|
|
|
## When to use
|
|
|
|
- 매월 1일 05:00 KST cron 자동 호출 (`agent: budget`)
|
|
- 관리자님이 "이번달 결산", "월간 결산", "자산 변동 요약" 요청할 때
|
|
|
|
## How
|
|
|
|
```bash
|
|
python3 /Users/snowoyh/.openclaw/agents/budget/workspace/skills/monthly-settlement/scripts/monthly_settlement.py
|
|
```
|
|
|
|
기본 동작:
|
|
1. `whooing_balance.py --json` 호출해 현재 순자산/자산/부채 스냅샷 생성
|
|
2. `state/monthly_snapshots.json` 에서 전월 스냅샷 로드
|
|
3. 계정별 증감 계산 (신규/청산 포함)
|
|
4. 메일 발송: `gog gmail send --to mini.snowoyh@gmail.com`
|
|
- 제목 `[월간결산] YYYY년 M월 자산 변동`
|
|
- 모든 계정 증감을 절대값 내림차순으로 정렬
|
|
5. 골디 텔레그램 발송: 순자산 변동 한 줄 + ±100만원 이상 변동 top 5
|
|
6. 이번달 스냅샷을 `monthly_snapshots.json` 에 저장
|
|
|
|
첫 실행(비교 대상 없음)은 스냅샷만 저장하고 "첫 결산" 안내만 발송.
|
|
|
|
## Flags
|
|
|
|
- `--dry-run` — 전송·저장 없이 메일/텔레그램 본문만 stdout 출력
|
|
- `--no-send` — 전송 생략, 스냅샷 저장과 stdout 출력만 수행 (복구/재실행용)
|
|
- `--as-of YYYY-MM-DD` — 기준일 강제 지정 (기본: 오늘)
|
|
|
|
## Output
|
|
|
|
마지막 한 줄 요약:
|
|
|
|
```
|
|
✅ 월간결산 2026-04: 순자산 +1,234,567원, 메일+텔레그램 전송 완료
|
|
```
|
|
|
|
## 데이터
|
|
|
|
- 스냅샷 저장: `state/monthly_snapshots.json` (키: `YYYY-MM` = 스냅샷 시점의 월)
|
|
- 리포트 대상 월: 전월 (스냅샷 시점 기준 직전 달)
|