十分钟实战：使用 Supabase 构建商业级 AI 图像生成平台后端

🚀前言

前端界面构建完毕后，接下来需要为其提供后端支持。利用 Supabase，可声明式地快速搭建应用所需的数据、认证、存储和实时通信系统。以下是实现思路与关键细节。

🔎1.数据库设计

结合系统设计文档，规划出如表所示的核心数据表。

表名	主要字段	描述与关系
user_profiles	id, user_id, name, avatar_url, preferences, created_at, updated_at	存储用户的详细资料和偏好设置，与 Supabase 内置的 auth.users 表关联
generation_tasks	id, user_id, task_type, prompt, negative_prompt, status, replicate_id, cost_credits, created_at	记录用户每一次发起的生成请求及当前状态（pending, processing, completed, failed）
user_images	id, user_id, task_id, image_url, thumbnail_url, metadata, created_at	存储成功生成的最终图像文件及其元数据，并与对应的生成请求关联
credit_transactions	id, user_id, amount, type, description, related_id, created_at	记录所有积分变动（消费、充值、赠送等），便于审计和用户查询
orders	id, user_id, stripe_session_id, amount, status, credits_amount, created_at, updated_at	存储用户购买积分的订单信息，与 Stripe 支付系统集成
stripe_subscriptions	id, user_id, stripe_subscription_id, status, current_period_start, current_period_end, created_at	管理用户订阅状态，支持定期自动充值

这种将'生成请求'（generation_tasks 表）与'最终成果'（user_images 表）分离的设计，是一种健壮的数据建模方式。它能追踪每一次尝试（无论成败），这对后续调试和用户行为分析至关重要。

🔎2.用户认证系统

在 Supabase 仪表盘中点击 Authentication → Sign In/Providers，在右侧界面的 Auth Provider 区域启用 Email，也可以根据需求一键开启 Google、GitHub 等社交账户登录方式。

随后为所有表启用并配置行级安全（RLS）策略——这是 Supabase 的核心安全特性，能将数据访问控制下沉到数据库层面。我们添加的策略为'用户只能查看和操作 user_id 与自身认证 uid 匹配的记录'。这样一来，即使用户绕过前端直接调用 API，数据库也能阻止其窥探或篡改他人数据。

🔎3.数据库视图和函数

为了简化前端的数据获取，我们创建了几个有用的数据库视图：

• user_stats_view：显示用户的生成统计、积分余额等汇总信息。
• monthly_stats_view：按月份统计用户的生成数量和积分消费。
• credit_consumption_view：分析用户的积分消费模式。
• generation_type_distribution_view：统计不同生成类型的分布。

同时，创建了数据库函数来处理复杂的业务逻辑，核心函数如下：

-- 更新用户积分的函数
CREATE OR REPLACE FUNCTION update_user_credits(
    p_user_id UUID,
    p_amount ,
    p_type TEXT,
    p_description TEXT,
    p_related_id UUID  
)  void  $$

    
     credit_transactions(
        user_id, amount, type, description, related_id
    ) (
        p_user_id, p_amount, p_type, p_description, p_related_id
    );
    
    RAISE NOTICE , p_user_id,
          p_amount         p_amount, p_type, p_description;
; 
$$  plpgsql SECURITY DEFINER;