Stage8 cash_point Audit Log Sprint

• 일시: 2026-05-10 12:15 ~ 12:45 KST (30분, Phase 2 wiring 확장 포함)
• AI 관리자: Claude (사용자 임시 위임)
• 서버: stage8 (66.42.34.229)
• Workflow: /sprint Plan→Design→Build→Review→Test→Ship→Retro

트리거

stage8-cash-point-gap-rootcause-20260506 메모리의 권장 사항: "future remediation: introduce 1127_cash_point_audit_log table that records every cash_point UPDATE with before/after value, source code path, and admin actor. Apply at all UPDATE sites." + 5/6 PRIMARY fix(payoutAllSummary status not 2) 미배포 잔존.

산출물

1. DB migration

신규 테이블 1127_cash_point_audit_log:

• id / user_id / source / amount(±) / balance_before / balance_after
• ref_table / ref_id / actor_user_id / actor_role / meta(JSON) / created_at
• 4 인덱스 (user / source / created / ref_table+ref_id)

2. Prisma model

prisma db pull 으로 자동 model 추가 + prisma generate 통과.

3. Helper 신규 (1 파일)

/home/stage8-user/src/lib/audit/cashPointAudit.ts (76 LOC)

• recordCashPointAudit(client, input) — tx 또는 prisma 인자 모두 호환
• swallow + console.error — audit 실패가 본 흐름 막지 않음
• type union: 16종 source

4. Wiring 최종 매트릭스 (7 파일, 9곳)

Phase 1 (5 파일 5 endpoint, 7곳):

파일	위치	source
admin/payout/route.ts:245	reject 환불 직후	payout_refund
admin/wallet/adjust/route.ts:102	manual credit/debit 직후	admin_credit / admin_debit
ewallet/transfer/route.ts:112	sender 차감 직후	transfer_out
ewallet/transfer/route.ts:124	recipient 가산 직후	transfer_in
admin/users/bulk-register/route.ts:49	initialCash 가산 직후	bulk_register

Phase 2 (2 파일 4 endpoint, 4곳) — 사용자 명령 후속 wiring:

파일	위치	source
investmentService.ts:260	신규 투자 차감 직후	investment_create
investmentService.ts:441	일일 수익 가산 직후	investment_yield
investmentService.ts:503	만기 반환 가산 직후	investment_principal
BscWatcher.ts:174	USDT 자동 입금 직후	deposit_bsc

SKIP (정책 반영):

• TronWatcher.ts:174 — TRON 미지원 정책 (사용자 명시 + 메모리 47 sprint 일치)
• authService.ts:151 — cash_point=0 신규 INSERT, 0 amount audit 의미 없음

5. 5/6 PRIMARY fix 동시 배포 (잔존 미배포 작업)

/home/stage8-user/src/app/api/user/ewallet/route.ts:213

- prisma.payout_release_requests.aggregate({
-   where: { user_id: userIdBigInt },
+ prisma.payout_release_requests.aggregate({
+   where: { user_id: userIdBigInt, status: { not: 2 } },
    _sum: { amount: true, payout_fee: true }
  })

→ rejected payout double-count 5건 ($114) 해소.

DC 검증 (7/7 PASS)

#	항목	결과
1	1127_cash_point_audit_log 테이블 + 4 인덱스 생성	✅
2	Prisma model cash_point_audit_log 생성 + generate	✅
3	helper recordCashPointAudit 76 LOC	✅
4	5 파일 7곳 wiring (audit insert 호출)	✅
5	5/6 PRIMARY fix 적용 (status: { not: 2 })	✅
6	DB 비교 검증 — kstone0675 $54 / star365 $5 / LHU86968923 $25 / anyhome1 $30 = $114 해소	✅
7	PM2 양쪽 reload zero-downtime, unstable=0	✅

메모리 정합 검증

stage8-cash-point-gap-rootcause-20260506 의 PRIMARY ROOT CAUSE 검증:

• 메모리: "kstone0675=54 (covers 100% of gap), star365=5 (covers 29% of 17 gap)"
• DB 비교 일치: kstone0675 old $54 → new $0 (정확히 100% 차감), star365 old $421 → new $416 (5 차이)

향후 추가 wiring 후보 — Phase 2 완료 (사용자 명령 후속)

항목	상태
investmentService.ts 3곳 (create / yield / principal return)	✅ Phase 2 완료
BscWatcher.ts:174 (deposit_bsc)	✅ Phase 2 완료 (PM2 stage8-bsc-watcher reload)
TronWatcher.ts	⏭️ TRON 미지원 정책 SKIP
authService.ts:151	⏭️ cash_point=0 INSERT (audit 의미 없음) SKIP

최종: 9 wiring + 1 helper + 1 migration. 핵심 cash_point 변동 흐름 100% 커버 (admin actor 5 + 자동 트리거 4 — BSC deposit / investment yield / investment principal / investment create).

5/6 메모리의 PENDING 4명 (a01071540697, garnet, ljm5177, lst6485)

이번 sprint 후 동작: 신규 cash_point 변경 시 audit 자동 기록됨. 기존 gap은 표 없는 OFF-LEDGER 변경(race condition + retroactive INSERT)이라 backfill 어려움. 향후 모든 변동이 audit_log에 남으므로 재발 시 즉시 root cause 식별 가능.

안전

• 트레이딩 stop: 0
• UFW/iptables: 0
• DB DROP/TRUNCATE: 0 (CREATE TABLE + ALTER 만)
• 서버 재부팅: 0
• SSH 변경: 0
• PM2 reload zero-downtime — stage8-user, stage8-admin, stage8-bsc-watcher (Phase 2 BscWatcher 변경 포함) 모두 reload, unstable=0
• 백업 8건 (.bak-audit-20260510): admin/payout, admin/wallet/adjust, ewallet/transfer, ewallet, admin/users/bulk-register, prisma/schema.prisma, investmentService, BscWatcher

사용자 검증 SQL

-- 사용자별 audit 이력
SELECT * FROM 1127_cash_point_audit_log WHERE user_id = ? ORDER BY created_at DESC LIMIT 50;

-- 24h source별 통계
SELECT source, COUNT(*) cnt, SUM(amount) total_amount
FROM 1127_cash_point_audit_log
WHERE created_at >= NOW() - INTERVAL 24 HOUR
GROUP BY source ORDER BY cnt DESC;

-- balance_before/after 정합 검증 (race 추적)
SELECT user_id, source, amount, balance_before, balance_after,
  (balance_after - balance_before) AS calc_delta
FROM 1127_cash_point_audit_log
WHERE balance_before IS NOT NULL AND balance_after IS NOT NULL
  AND ABS((balance_after - balance_before) - amount) > 0.001
ORDER BY created_at DESC LIMIT 20;