Alphea App

배경¶

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 인증 전환 (후속)