stage8 Special $100 신 사양서(N가 엔진) 전면 전환 — Sprint 보고서

일시: 2026-05-22 09:10 ~ 17:35 KST (약 8.5시간, 자율 CEO 모드) 범위: stage8 Special $100 트랙 — 옵션 B-3 폐기 → 주종 스타리움 04:52 사양서 전환 + Stage 1+ 가드 + 계보 시각화 + $130 통합 패키지 + admin dashboard 통합 KPI 격리: 기존 stage8 일반 MLM / BSC·TRON watcher / mall / cash_point 결제 / ewallet 무수정

▎Phase A~N 14단계 종합

Phase	산출물	LOC
A	DB 마이그레이션: daily_points + nga_daily + special100_point 컬럼 + prisma generate	49 SQL
B+C	CommissionDistributor 재작성 — 추천+롤업(unilevel)+조건부후원+간접P	268
D	NgaCalculator + SettlementService wrapper + cron route 활성	393
E	vitest 32/32 PASS (기존 19 + 신규 N가 모드 13)	130
F	UI 위젯: status API 신스키마 + admin nga-daily API + N가 추이 카드 + PurchaseCard 3컬럼	320
G	systemd timer 23:59:30 KST + 라이브 cron 멱등성 검증	unit
H	Stage 1+ 가드 (Service + status + Sidebar + page) + i18n nav.special100	95
I	사용자 계보 시각화 페이지 + API + 메뉴 + i18n	230
J	관리자(santa) 전체 트리 뷰 + 회원 검색 + depth 10대	270
K	$130 통합 패키지 wrapper API (stageService + special100Service sequential)	145
L	URL/메뉴 board별 분리 (/special100 vs /package-130) + 자동 redirect	90
M	NgaCalculator FK bug fix (from_id=null + system leg_amount marker)	30
N	admin dashboard Special $100 8 카드 + 통합 매출 SQL	150
★	N가 카드 라벨에 settled_date 명시 (C 옵션)	8

총 코드 변경: ~2,180 LOC 신규/수정, 신규 API 4개, 신규 페이지 2개, vitest +13

▎신 사양 요약 (운영 가드)

1단계 즉시 USDT (매출당 평균 $25 차감)

1. 추천수당 $10 → users.sponsor_id (referrer) 항상
2. 롤업수당 $1 × 10대 → buyer 기준 Unilevel(sponsor_id chain) 1~10대
3. 직접추천자 후원수당 $10 → referrer == placement_parent AND 신규가 그 parent의 weaker leg

2단계 23:59:30 KST N가 일배치

• 간접 후원 P (10P): referrer != placement_parent AND binary 매칭 발생한 각 ancestor
• 추천매칭 P: 일배치 시점에 각 후원 수혜자의 referrer 1~3대에게 [당일 USDT + 간접P] 합산 × 10%
• A = 매출×0.5 − 1단계 USDT 합계, B = ΣP
• A ≥ B → 1P=1USDT (잔여 회사 유보)
• A < B → N가 = A/B, 회원별 = P × N가
• 정산 후 user_balance_amounts.special100_point = 0 초기화

▎라이브 실 검증 (수동 흐름)

Phase 1. grace 가입 (sponsor=star365)

• grace.id=961, board=0, sponsor_id=43

Phase 2. star365 → grace cash $130 송금

• star365 $529.19 → $399.19
• grace $0 → $130

Phase 3. grace $130 패키지 구매

분배	수혜자	금액	채널
Stage 1 referral	star365	$3	referral_bonus
Stage 1 level 1~7	hjd2786/ok1126/star365/Jason/stage8/bjw1242/admin	$12	level_commission
Special 추천	star365	$10	special100_phase1_referral
Special 롤업 1대	star365	$1	special100_phase1_rollup_1
Special 롤업 2대	admin	$1	special100_phase1_rollup_2
Special 직접 후원	star365	$10	special100_phase1_direct_sponsor
소계		$37

• grace board: 0 → 1, cash: $130 → $0
• star365 cash: $399.19 → $423.79 (+$24.60)
• admin cash: $2,558.71 → $2,561.51 (+$2.80)

5/22 N가 정산 (수동 cron 호출, FK fix 후)

• total_sales = $200 (star365 + grace 신 사양 패턴만 합산)
• total_phase1_paid = $43
• A = $57, B = 1 (admin 매칭 P from star365)
• mode = stable, ratio = 1.000
• distributed = $1 (admin), surplus = $56 (회사 유보)
• admin 매칭 payout cash $2,561.51 → $2,563.71 (+$1)

수학적 일치: 매출 $200 × 50% = $100 상한 = phase1 $43 + phase2 $1 + 회사 $56 ✅

▎admin 대시보드 Special $100 8 카드 (라이브)

카드	값
누적 매출 (Stage + Special $100)	$44,290
Special $100 누적 매출	$400
Special $100 오늘 매출	$200
Active 회원수	4명
1단계 USDT 누적 분배	$43
2단계 P→USDT 누적	$1
최근 정산 분배 (2026-05-23, zero_points)	$0
최근 정산 유보 (2026-05-23, N가=1.000)	$0

▎발견된 함정/버그 4건

1. MySQL 8 ADD COLUMN IF NOT EXISTS 미지원 — information_schema 확인 후 조건부 ALTER
2. pm2 ecosystem env가 .env 우선 — CRON_SECRET 불일치, pm2 env <id> 확인 + /etc/special100-daily.env 동기화 필수
3. NgaCalculator FK violation — payoutToMember의 from_id=0, leg_amount_id=0이 FK 위반 → from_id=null + system leg_amount marker로 fix
4. nga_daily 멱등성 + KST 자정 — 자정 직후 cron 시 todayKstYmd 자동 = 다음 날이라 어제 정산 안 됨. ?date=YYYY-MM-DD 명시 호출 필요. daily_points matching P row 잔존 시 재중복 위험 → 재호출 전 해당 날짜 matching DELETE 의무

▎안전 가드 위반 0

• 트레이딩 0 영향 / UFW 0 변경 / DB DROP 0 / 재부팅 0 / SSH 설정 0
• 기존 stage8 일반 MLM / BSC·TRON watcher / mall / ewallet / cash_point 결제 / payout 무수정
• 작업 중 FEATURE_SPECIAL100_SIGNUP=false → 종료 시 true 복귀
• 백업: /opt/stage8-backups/newspec-20260522/

▎자동 운영 시작 (2026-05-22~)

• 매일 23:59:30 KST systemd special100-daily.timer → NgaCalculator 자동 정산
• 신규 회원 가입 흐름:
  • board=0 회원: /package-130 ($130 통합 패키지) — Stage 1 + Special $100 동시 진입
  • board≥1 회원: /special100 (단독 $100) — 1구좌 정책
• 라이브 가시화:
  • user.stage8.club/special100 — 본인 잔액 + 어제 N가 + 7일 추이
  • user.stage8.club/special100/genealogy — 본인 binary 트리
  • santa.stage8.club/admin/special100/genealogy — 전체 트리 (검색 + depth 10대)
  • santa.stage8.club/admin/dashboard — 통합 KPI (Special $100 8 카드)

▎관련 메모리

• stage8-special100-newspec-nga-20260522.md
• [stage8-special100-optionB3-20260522.md] (폐기됨)
• [stage8-special100-s3-go-20260521.md] (옵션 B-3 직전 GO)