유형: 현황

PunkPoll V3 리팩토링 진행 현황 (팀 공유용)

작성일: 2026-07-20 (세션 종합 갱신)
검증 기준: A(dev.punkpoll.com) 실측 대조 · dev 서버 엔드포인트 + cloud 브라우저 E2E


1. 종합 완료율

범위완료율근거
사용자 + 채널관리자 앱 파이프라인 (DB→백엔드→프론트)~95%브라우저 E2E 5/5 clean + A 실측 대조
온체인 파이프라인 (배포→참여→SBT)~90%Fuji 무개입 자동 E2E 관통 (settle 수동만 잔여)
챗봇 V3 연결~80%참여 발신부 관통 검증 (dev 플래그, answerCid 포맷 잔여)
A 완전 대체(컷오버) 기준 전체~65~70%admin 패널 미착수 + mainnet 컷오버(Phase6 게이트)

2. 아키텍처 / 인프라


3. 완료 항목 (모두 A 실측 대조 + 브라우저 검증)

사용자 페이지

피드/변형(explore·live·vote·daily·opinion-poll·feedback·citizen) · 마이페이지(/user/{uid}) · 지갑(mWallet) · 채널 · 설문 상세(질문/결과/댓글) · 검색 · 패널 · 토큰 페이지

채널관리자 전 사이드메뉴

대시보드 · 참여자(stats캐시 14s→0.14s) · 토큰보유자 · 팔로워 · 매니저 · 리포트차트/히트맵 · 댓글 · 블록체인(tx 2.75s→0.27s) · 설문목록 · 지갑(PUNK)

생성 플로우

채널 생성/편집(카테고리 19개 A정합) · 설문 빌더 신규 생성/저장(basicInfo→질문→보기→validFlag 관통)

온체인 (Fuji 테스트넷 무개입 자동 E2E)

POST /distribution → SurveyNFTV2 배포+예치 → DeployCompleteListener 자동 02→03 → POST /join → registerParticipation → SBT 자동 발행 → reward_ledger + sbt_token_id. 실 tx 검증 완료.

챗봇 V3 연결

dev 챗봇(@버클리) 참여 발신부: 답변→IPFS핀→answerCid→POST /api/voter/surveys/:uid/join→온체인. 플래그 게이팅(프로덕션 무영향), 답변 저장 sm_user_answer_info 유지.

데이터 정합 (A 대조)

결과 실득표수(sm_user_answer_info) · 결제이력(52건) · 투표수 611설문 · 카테고리 · 채널이미지 · socialGraph(24≈A 23)


4. 핵심 발견 (팀 공유 필수)

1. channels.uid = 소유자 nullifier (userUid 아님) — 참여자·매니저·지갑·마이페이지·설문생성 목록이 비던 반복 버그의 근원. 전 도메인 점검 필요.
2. 엔드포인트 200 ≠ 렌더 정상 — 마이페이지·블록체인·토큰 크래시(null.startsWith, [...res.data])는 브라우저 E2E로만 잡힘. self-PASS 금물.
3. "데이터 없음"이 아니라 마이그레이션 미완 — A 데이터는 전부 같은 서버에 존재, 전량 이관 완료.
4. enable_sbt는 A도 게이팅 안 함 — txSender가 참여 시 무조건 SBT 발행(글로벌 env만). V3 현행이 A-정합.


5. 남은 작업 (우선순위)

1. admin 패널 (144 엔드포인트) — 미착수 (마지막 지정)
2. mainnet 온체인 컷오버 — jegwon Phase 6 GO 필요 (실 컨트랙트 재배포)
3. 마이너/데이터 완전성:


6. 접속 / 인프라

⚙️ 운영 주의: dev 서버 ~/punkpoll-v3는 git 저장소 아님(rsync 배포). 코드 변경 후 반드시 dev→cloud→GitHub sync 필요.