数据层

Android 模板不会让 composable 直接访问 Supabase。页面调用 ViewModel， ViewModel 调用 repository，repository 再调用远程数据源或本地 controller flow。

基本形状

Composable screen
  -> @HiltViewModel
  -> Repository
  -> RemoteDataSource interface
  -> Supabase implementation
  -> PostgREST / Auth / Storage / Functions

大多数功能 repository 都返回 AppResult<T>，这样 ViewModel 可以渲染成功、 加载和失败状态，而不需要在 UI 层捕获 Supabase 异常。

关键文件

AppResult<T>

core/result/AppResult.kt 定义：

sealed interface AppResult<out T> {
    data class Success<T>(val data: T) : AppResult<T>
    data class Failure(val error: AppError) : AppResult<Nothing>
}

appSuspendRunCatching 会保留 coroutine cancellation，并把常见异常映射成友好的 AppError.message。Auth 错误会对无效凭据、邮箱未确认、OTP 过期、频率限制、 弱密码和 provider 禁用做特殊文案处理。

当前使用这个模式的 repository：

UploadsRepository 是例外：它直接暴露 Flow<UploadStatus>，因为 UI 需要来自 Supabase Storage 的每个上传任务进度事件。

模型

Supabase 行被建模为 @Serializable Kotlin data class：

Subscription 使用宽容 enum serializer。未来服务端新增 enum 值时，旧客户端会解码 成 Unknown，不会直接崩溃。

远程数据源

RepositoryModule 把接口绑定到 Supabase 实现：

测试会在这些 seam 注入 fake。模板的单元测试使用普通内存 fake 和 kotlinx-coroutines-test；repository 和 ViewModel 测试不需要 Mockk。

PostgREST 示例

SupabaseTodosRemoteDataSource.fetchAll() 会按 owner 筛选，并使用 UI 期望的排序：

table.select {
    filter { eq("user_id", userId) }
    order("sort_order", Order.ASCENDING)
    order("created_at", Order.DESCENDING)
}.decodeList<Todo>()

TodosRepository.add() 会把新项目排在当前第一项之前：

val nextOrder = currentItems.minOfOrNull { it.sortOrder }?.minus(1) ?: 0
remoteDataSource.add(userId, title.trim(), nextOrder)

Profile 更新会把空白输入归一化为 null，再发送单字段 patch：

val cleaned = value?.trim()?.takeIf { it.isNotEmpty() }
remoteDataSource.update(userId, mapOf(field to cleaned))

本地状态

AppPreferences 用 typed flow 包装 DataStore Preferences，覆盖：

• 主题和语言。
• Dynamic color 开关。
• Onboarding 完成状态。
• 生物识别锁开关。
• 已接受的 legal version。
• 已忽略的 soft update version。
• 应用内评价计数和提示历史。

NetworkObserver 包装 ConnectivityManager.NetworkCallback，并暴露 StateFlow<Boolean> 给离线横幅使用。它同时要求 internet capability 和 validated network capability。

RLS 预期

移动端客户端假设这些 owner-scoped RLS：

subscriptions 和 payments 故意没有客户端写策略。RevenueCat webhook 校验 webhook Authorization 密钥和 RevenueCat app_user_id 后，用 service-role key 写入这些表。

添加自己的功能

相关页面