프로젝트

일반

사용자정보

Actions
Copy link

이슈 #440

진행중
HP HP

ALPHEA Edge / dFS / Delta App 실행 로드맵 + Wallet-as-Identity (Phase 0.7) 디자인 정리

이슈 #440: ALPHEA Edge / dFS / Delta App 실행 로드맵 + Wallet-as-Identity (Phase 0.7) 디자인 정리

Henry Park이(가) 약 7시간 전에 추가함.

상태:
해결
우선순위:
보통
담당자:
Henry Park
목표버전:
6월 중간 버전
시작일:
2026/05/13
완료일:
진척도:

0%

추정시간:

설명

배경

GoTrue 도입(#411) 이후의 전체 아키텍처 방향(dFS, Delta App, Principal 모델, AI Agent Layer)을 문서로 정리하고, 모바일 SDK 재작성(#439) 등 후속 작업들의 reference 가 되는 디자인 결정을 일관되게 정렬한다.

작업 내용

신규 문서

  • alphea_edge_delta_d_fs_roadmap.md — Phase 011 + 마일스톤 M1M6 통합 실행 로드맵 (dFS / Delta App / alpn:// / ALPHEA Custom Browser / Edge AI Agent Layer)
  • PROJECT_STATUS.md — 현황 + 전략을 한눈에 보는 repo root 문서
  • docs/10-deployment.md — GitLab CI 자동 배포 절차

기존 문서 정렬

  • docs/00-overview.md — RPC 60개 (이전 66), AuthService 1개 RPC, GoTrue/OTel/Admin SAML 환경변수 추가
  • docs/01-auth.md — GoTrue + NodeService 흐름 전면 재작성. 제거된 AuthService RPC 명시
  • docs/06-mobile-sdk.md — GoTrue 마이그레이션 경고 + 새 흐름 도식
  • docs/07-api-reference.md — AuthService 섹션을 GenerateKeypair 만 남기고 축소
  • CLAUDE.md — 서비스 카운트 동기화 (auth 1, wallet 9, vfs 9, total 60)

핵심 디자인 결정

  1. VfsService 폐기 → dFS 로 대체 — 호환 어댑터 없이 깨끗하게 폐기 (vfs_nodes drop, /modules·/sys seed 는 dFS reserved path 로 이관)
  2. Principal 모델 도입 — 모든 ownership/identity 필드를 (principal_type, principal_id) 로 표현. user (GoTrue UUID) / wallet (0x...) / node (node_id)
  3. Phase 0.7 Wallet-as-Identity 신설 — secp256k1 지갑을 first-class identity 로 승격. AI Agent / 자동화 / CI 가 GoTrue 없이 동작. AuthService.WalletChallenge / WalletVerify 부활 (headless 목적)
  4. AI 생성 앱의 세 겹 권한 모델 (Phase 4) — Manifest + Runtime Session + Capability Token. AI 가 배포한 앱 JS 안에 private key 절대 금지. 세 가지 key 역할 분리 (AI Agent key / App JS capability / User wallet key)
  5. secp256k1 검증 강화 (Phase 0.7 선행 필수) — nonce / TTL / one-time / domain / public-key recover

후속 작업

  • Phase 0.7 의 첫 작업: VerifySignature 보안 강화
  • Phase 0 모바일 SDK 재작성 (#439 후속)

관련 이슈

  • #411 — GoTrue 인증 전환 (선행)
  • #421 — AGX 잔액 user_id 전환 (선행)
  • #438 — Phase 5 final cleanup (선행)
  • #439 — Mobile SDK GoTrue 인증 전환 (후속)

HP Henry Park이(가) 6달 전에 변경 Actions
Copy link
 #1

  • 상태을(를) 신규에서 해결(으)로 변경되었습니다.

디자인 정리 완료

commit:server|a7b3c4f

신규 문서

  • alphea_edge_delta_d_fs_roadmap.md — Phase 011 + 마일스톤 M1M6 통합 실행 로드맵
  • PROJECT_STATUS.md — 현황 + 전략을 한눈에 보는 repo root 문서

기존 문서 정렬

  • docs/00-overview.md — RPC 60개, AuthService 1개, GoTrue/OTel/Admin SAML 환경변수
  • docs/01-auth.md — GoTrue + NodeService 흐름 전면 재작성
  • docs/06-mobile-sdk.md — GoTrue 마이그레이션 경고
  • docs/07-api-reference.md — AuthService 축소
  • CLAUDE.md — 서비스 카운트 동기화

핵심 디자인 결정

  1. VfsService 폐기 → dFS 로 대체 (호환 어댑터 없음)
  2. Principal 모델 (user / wallet / node) 도입
  3. Phase 0.7 Wallet-as-Identity 신설 (AI Agent / 자동화)
  4. AI 생성 앱의 세 겹 권한 모델 (Manifest + Session + Capability)
  5. secp256k1 검증 강화 (Phase 0.7 선행)

비고

이 디자인 정리는 Phase 1-6 코드 backport (#411 / #421 / cf27194 / de617cf / #438 / dceda06) 직후의 상태를 기록한 시점에 작성. Phase 6 (dceda06) 으로 mobile SDK 가 GoTrue backport 됐으므로 일부 "stale" 라벨링은 추가 검증/갱신이 필요한 수 있다.

후속 작업

  • Phase 0.7 의 첫 작업: VerifySignature 보안 강화 (별도 이슈)
  • 로드맵 Phase 1 dFS PoC 시작

HP Henry Park이(가) 6달 전에 변경 Actions
Copy link
 #2

Spec 원본 연결

commit:server|92d3a61 에서 로드맵의 핵심 컴셉(alpn://, dFS, ALPHEA Custom Browser, AI Agent Layer, Phase 10 lock/QUIC) 의 원본 spec 두 개를 repo 에 추가했다 (#442). 이제 로드맵이 이 spec 들을 구체적 reference 로 가리킬 수 있다.

HP Henry Park이(가) 6달 전에 변경 Actions
Copy link
 #3

잔여 stale 문서 정리

commit:server|ea34feb 에서 이 이슈의 권고사항을 완결:

  • docs/06-mobile-sdk.md Authentication Flow + SDK API 섹션이 잊은 쌜 셍셔널 Authenticate* / Signer 를 나열하던 것을 제거. 현재 AuthenticateWithGoTrueToken 기준으로 재작성
  • docs/01-auth.md §7 SDK 헬퍼 섹션도 새 API 기준으로 재작성. 옷 Authenticate() / AuthenticateWithWallet() 가 제거됐음을 명시
  • PROJECT_STATUS 부채 표 의 "SDK stale" 이 본 repo (✅ 완료) vs 모바일 앱 측 (🟡 sibling repo) 로 분리

이제 로드맵/문서와 실제 코드 상태가 일치한다. Phase 0.7 MVP 구현은 #443 으로 이어진다.

HP Henry Park이(가) 6달 전에 변경 Actions
Copy link
 #4

잔여 stale 마무리 (Phase 0 SDK cleanup 완료 상태)

commit:server|a1c7d49 에서 docs/06-mobile-sdk.md 의 마지막 stale 세 곳 제거:

  1. Android Implementation 의 Mobile.authenticate(...) 예제 → authenticateWithGoTrueToken
  2. iOS Implementation 의 MobileAuthenticate(...) 예제 → MobileAuthenticateWithGoTrueToken
  3. WalletConnect Integration 섹션 전체 (Android / iOS / RN 예제) → "External Wallet — TBD" placeholder

이제 PROJECT_STATUS / 메모리의 "옷 Authenticate* 모두 제거" 주장과 문서 전체 설명이 완전 일치. 본 repo 측 Phase 0 문서·코드 cleanup 이 깨끗하게 닫힘. 다음 작업은 #443 (Phase 0.7 MVP 구현).

CP Chris Park이(가) 6달 전에 변경 Actions
Copy link
 #5

  • 담당자을(를) James Lee에서 Henry Park(으)로 변경되었습니다.
Actions
Copy link

내보내기 PDF Atom