Map: Sign in with Apple, native on iOS

未关闭
#465 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
ios, supabase, terraform, typescript

调研方向

Start with the listed authentication and account deletion docs, production configuration, mobile app README, and the linked entry points: libs/api-server/src/http/account-auth.ts, terraform/production/supabase.tf, ADR 0019, and apps/mobile-app/AGENTS.md. Revalidate the linked Apple research and specify the unresolved login UI, secret rotation, Private Email Relay, notifications, fresh authentication, release signing, testing, and documentation work. Done means the acceptance criteria in the issue are met, including native iOS sign-in, web sign-in, the Android decision, token revocation, relay email delivery, and updated docs.

由索引模型根据 Issue 内容生成。

描述

wayfinder:map

Destination

A spec ready for /to-tickets that adds Sign in with Apple to Cup: the native Apple sheet on iOS, Supabase's OAuth flow on the web, a decided and specified answer for Android, the Worker admitting Apple identities, the login UI, custody of Apple's refresh token and its revocation on account deletion, the Private Email Relay, release signing of the iOS app and its Share Extension, and the docs. Its acceptance check is CUP-45's acceptance criteria: release-signed builds of the iOS app and its Share Extension can be produced; on a physical iPhone, Sign in with Apple uses the native sheet and ends in a Supabase session in secure storage; on the web, Sign in with Apple creates and signs into a Cup account; the Android decision is implemented; deleting an account that signed in with Apple revokes its Apple tokens; email to a Hide My Email address arrives; the authentication and production configuration docs describe Apple sign-in.

Notes

  • Origin: CUP-45 Enroll in the Apple Developer Program and add Sign in with Apple, native on iOS (Linear). It blocks CUP-44 and CUP-79.
  • The map plans only and carries no build. Apple Developer console work with lead time (team, enrollment, identifiers, key) is charted as wayfinder:task tickets so later decisions can rely on real identifiers; provisioning profiles and release signing in Xcode belong to the spec.
  • Settled while charting (2026-11-18).
    • iOS MUST use the native ASAuthorizationAppleIDProvider sheet through a Capacitor plugin, bound to a nonce, exchanging the identity token with Supabase via signInWithIdToken, as Android does for Google. A web flow in the WebView or a browser sheet is not acceptable for Apple on iOS.
    • Same person through Google and Apple is decided in this map; already-created accounts are never merged.
    • Today's Apple access is a team-member seat on Verena Handler-Kunze's individual membership. Apple's user identifier is team-scoped, so the developer team is decided before any real user signs in with Apple.
  • Starting point: the Worker admits only Google identities and the local test account (account-auth.ts); deletion revokes only Google tokens (account deletion); Supabase Terraform enables only Google (supabase.tf); iOS signs in with Google through a browser sheet (ADR 0019); the Xcode project keeps the team ID out of tracked files (apps/mobile-app/AGENTS.md).
  • Prior research, whose Apple findings need revalidating: deferred Apple/iOS handoff, native provider research, account deletion research.
  • Skills: grilling and domain-modeling for grilling tickets, research for research tickets. Read the glossary, authentication, account deletion, production configuration and apps/mobile-app/README.md first.

Decisions so far

Not yet specified

  • Login UI. Button order, styling and copy per platform under Apple's button guidelines, and where Apple appears next to Google.
  • Client secret rotation. Who rotates Supabase's Apple client secret (a JWT valid at most six months), how, and how an expiry is noticed.
  • Private Email Relay. Registering Cup's Resend sender domain and checking that mail, including account deletion notices, reaches a Hide My Email address.
  • Server-to-server notifications. Whether and how Cup handles Apple's account-deleted, consent-revoked and email-change events.
  • Fresh authentication with Apple. How deletion and recovery confirmation count a fresh Apple sign-in, on each platform.
  • Release signing. Provisioning profiles and certificates for the app and its Share Extension, kept out of tracked files, and the build command that produces a release-signed build.
  • Testing. An Apple identity in the fake auth provider, mobile E2E coverage of the native sheet's handoff, and the physical-device check.
  • Documentation. Which ADRs, architecture pages, glossary terms and READMEs change.

Out of scope

  • Distribution: TestFlight, App Store Connect records and uploads stay in CUP-79.
  • Native Google sign-in on iOS: CUP-63; Google on iOS stays on ADR 0019.
  • Merging already-created accounts.
主要语言
TypeScript
星标
1
派生
0
PR 合并指标
30 天内没有已合并 PR

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

patricktree/cup 的其他 Issue

查看 patricktree/cup 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。