Alphea App

Phase 5 구현 완료 — 레거시 wallet_address 소유권 컬럼 제거¶

commit:server|dc8ad6e

적용된 변경¶

DB 스키마 v15 (clean rewrite)

• ALTER TABLE nodes DROP COLUMN owner_wallet_address
• virtual_node_assignments 재설계: wallet_address 제거 → user_id UUID NOT NULL + 인덱스 (user_id, status)
• virtual_node_credits 재설계: user_id UUID NOT NULL + 인덱스
• virtual_node_packages: claimed_wallet_address 제거 → claimed_user_id UUID + 인덱스
• virtual_node_claim_events: wallet_address → user_id
• clean rewrite: 세 테이블 DROP/RECREATE

Proto

• NodeInfo.owner_wallet_address (필드 #5) → owner_user_id
• VipNodeInfo.owner_wallet_address → owner_user_id
• 요청 메시지에 wallet_address 없음은 Phase 2 에서 이미 완료. DiscardUnknown 으로 older clients 호환

Store

• store/nodes.go: Node.OwnerWalletAddress 필드 제거, nodeColumns / scanNode 조정. GetNodesByWallet / GetClientNodesByWallet 제거 (user_id 그룹 유지). CountDeviceNodesByWallet 는 wallet→user_id 석게 후 user_id로 조회. EnsureNodeForAccount, RegisterNodeForUser INSERT 에서 owner_wallet_address 제거
• store/virtual_node.go: VirtualNodeAssignment.WalletAddress → UserID, VirtualNodeCredit.WalletAddress → UserID. 모든 helper 이름 그룹적으로 변경 (ListActiveAssignmentsByUser, SumVirtualAgxByUser, SumVirtualAgxTodayByUser, GetCreditsByUser). InsertCredit 이 해당 user_id 로 wallet_adjustments 도 동일 트랜잭션으로 소포 (reason=virtual_node_credit, ref_code=assignment:<id>)
• store/virtual_node_claims.go: ClaimVirtualNodePackage[ByID](userID, ...), ClaimedUserID *string, claimed_user_id 컬럼 사용. claim events 에서도 wallet 이 아닌 user_id 로 기록
• store/virtual_credit_overlap.go: SumVirtualAgxByUserDuring, ListVirtualCreditDayBucketsByUser{,AllTime} 등으로 이름/조회 컬럼 일괄 교체
• store/wallet_vip.go 재작성: GetUserNodeDetails, GetUserEarningsByRange, GetUserEarningsSummary 가 receipts.user_id + virtual_node_*.user_id 로 집계
• store/wallet_queries.go: 레거시 wallet 기반 함수 GetJobsByWallet / GetEarningsByWallet / GetEarningsToday(wallet) / GetReceiptsByWallet / backfillEarningBreakdown 제거. GetEarningsByUser 가 ListVirtualCreditDayBucketsByUserAllTime 로 직접 fold-in
• store/admin_cleanup.go::DeleteWalletData: wallet→user_id 와 wallets registry 둘 다 조회해 user_id 해결, friends/referral/rewards/virtual_node 계 삭제는 user_id 키로, receipts/aggregated_earnings/vfs/access_logs 는 wallet_address 그대로

Handler

• handler/node.go::nodeToProto: OwnerUserId 채움. ConnectNode 는 owner_user_id 를 바로 사용 (wallet 폴백 제거)
• handler/wallet.go::ClaimVirtualNodes: resolvePrimaryWallet 경로 제거, db.ClaimVirtualNodePackage(userID, code) 에 그대로 호출
• handler/wallet.go::GetNodes / GetEarningsToday: wallets 이터레이션 제거, ListActiveAssignmentsByUser / SumVirtualAgxByUser / SumVirtualAgxTodayByUser 로 직접 동작
• handler/wallet_vip.go: 세 RPC 모두 user_id 기반 helper 호출. iteration 로직 제거
• handler/wallet_virtual_nodes.go: virtual VipNodeInfo 가 assignment.UserID 를 OwnerUserId 로 노출
• handler/monitor.go::RealNodeInfo: OwnerWalletAddress 필드는 하위 호환을 위해 유지하되 내부적으로 user_id 를 담아 노출 (관리자 대시보드 완전 호환)
• handler/wallet_auth.go: 사용하지 않는 resolvePrimaryWallet 제거
• admin/api.go::listWalletRows: 각 wallet 행에서 user_id 해결 후 user_id 기반 가상 노드 집계
• admin/pages.go: 테플릿 레이블 ClaimedWalletAddress → ClaimedUserID

Engine

• engine/virtual_node_creditor.go: assignment.UserID 기반으로 적립. InsertCredit 경로를 통해 wallet_adjustments 자동 소포

Tests

• 7개의 test 파일 업데이트 (handler 4, store 2, engine 2): ctxWithUser + seedUserWithWallet 패턴으로 재작성. virtual_credit_overlap_test.go 는 완전 재작성 (GetEarningsByUser / GetUserEarningsSummary / SumVirtualAgxTodayByUser 계제)

검증¶

• go build ./... PASS
• go vet ./... PASS
• go test ./... PASS (integration 테스트는 TEST_DATABASE_URL 미설정으로 skip)

DoD 체크¶

• make build, make test 통과
• DB 에서 wallet_address 컬럼이 소유권/identity 키로 사용되는 테이블은 0개 — wallets(레거시 registry), job_receipts/aggregated_earnings (metadata only), vfs_nodes / access_logs / wallet_comments 에만 남음
• virtual_node_* 가 완전히 user_id 키로 동작
• ClaimVirtualNodes 가 caller user_id 로 직접 동작 — wallet 등록 없이도 클레임 가능
• NodeInfo.owner_wallet_address 일괄 제거, owner_user_id 필드로 응답

Phase 종결¶

Go 원본으로의 Supabase GoTrue 인증 백포트가 5개 phase (Phase 1–5) 로 완전 종결:

• Phase 1 (#434, commit:server|03c6c64) — GoTrue 인프라 + 표준 JWT + AuthService 축소 + accounts/nodes user_id 컴럼
• Phase 2 (#435, commit:server|61f09e9) — AGX 회계 user_id + 1:N wallets + wallet_adjustments ledger
• Phase 3 (#436, commit:server|cf27194) — Admin Dev Console GoTrue Sign Up/Log In UI
• Phase 4 (#437, commit:server|de617cf) — FriendsService user_id (friends/referral_claims/rewards_log)
• Phase 5 (#438, commit:server|dc8ad6e) — 레거시 wallet 컬럼 제거 — 본 이슈