Hakke Studio 的 Supabase 集成

专为 Hakke Studio 项目定制的 Supabase 集成方案。

当前项目

CLI 安装

bash

Supabase CLI（已安装）

若未安装

身份认证

登录 Supabase

bash
supabase login

此命令将打开浏览器，通过 contacto@hakke.cl 进行 OAuth 登录。

关联项目

bash
cd /home/bastianberrios/proyectos/HAKKE/hakke-app
supabase link --project-ref <项目ID>

数据库操作

生成类型定义

bash
supabase gen types typescript --local > lib/supabase/database.types.ts

创建迁移文件

bash
supabase migration new <迁移名称>

应用迁移

bash
supabase db push

重置数据库（仅限开发环境）

bash
supabase db reset

认证操作

获取 API 密钥

bash
supabase status

返回结果：

• - anon key - 公钥（客户端使用）
• service_role key - 密钥（仅限服务端使用）

创建用户（管理员）

sql
-- 在 Supabase 控制台 SQL 编辑器中执行
INSERT INTO auth.users (email, encryptedpassword, emailconfirmed_at)
VALUES (
user@example.com,
crypt(password123, gen_salt(bf)),
NOW()
);

RLS（行级安全）

启用 RLS

sql
ALTER TABLE users ENABLE ROW LEVEL SECURITY;

创建策略

sql
-- 用户只能查看自己的数据
CREATE POLICY 用户只能查看自己的数据
ON users
FOR SELECT
USING (auth.uid() = id);

-- 用户只能更新自己的数据
CREATE POLICY 用户只能更新自己的数据
ON users
FOR UPDATE
USING (auth.uid() = id);

存储操作

创建存储桶

sql
-- 在 Supabase 控制台 SQL 编辑器中执行
INSERT INTO storage.buckets (id, name, public)
VALUES (avatars, avatars, false);

存储策略

sql
-- 用户可上传文件到自己的文件夹
CREATE POLICY 用户可上传头像
ON storage.objects
FOR INSERT
WITH CHECK (
bucket_id = avatars
AND auth.uid()::text = (storage.foldername(name))[1]
);

边缘函数

创建函数

bash
supabase functions new <函数名称>

部署函数

bash
supabase functions deploy <函数名称>

调用函数

bash
curl -i -L --request POST https://.supabase.co/functions/v1/<函数名称> \
--header Authorization: Bearer <匿名密钥> \
--header Content-Type: application/json \
--data {name:Functions}

多租户 SaaS（hakke-app）

架构设计

┌─────────────────────────────────────────┐
│ hakke-app (SaaS) │
├─────────────────────────────────────────┤
│ tenants 表（多租户） │
│ - id, slug, name, plan │
│ - owner_id (外键 → auth.users) │
│ - subscription_status │
├─────────────────────────────────────────┤
│ 行级安全 (RLS) │
│ - tenantid = currenttenant() │
└─────────────────────────────────────────┘

租户隔离

sql
-- 获取当前租户的函数
CREATE OR REPLACE FUNCTION currenttenantid()
RETURNS uuid AS $$
BEGIN
RETURN (auth.jwt()->>tenant_id)::uuid;
END;
$$ LANGUAGE plpgsql SECURITY DEFINER;

-- RLS 策略示例
CREATE POLICY 用户只能查看自己租户的数据
ON appointments
FOR ALL
USING (tenantid = currenttenant_id());

订阅管理

sql
-- 检查订阅状态
CREATE OR REPLACE FUNCTION hasactivesubscription()
RETURNS boolean AS $$
DECLARE
tenant_record tenants%ROWTYPE;
BEGIN
SELECT * INTO tenant_record
FROM tenants
WHERE id = currenttenantid();

RETURN tenantrecord.subscriptionstatus = active;
END;
$$ LANGUAGE plpgsql SECURITY DEFINER;

常用查询

列出所有表

sql
SELECT table_name
FROM information_schema.tables
WHERE table_schema = public;

查看表结构

sql
SELECT
column_name,
data_type,
is_nullable,
column_default
FROM information_schema.columns
WHERE table_name = users;

检查 RLS 状态

sql
SELECT
schemaname,
tablename,
rowsecurity
FROM pg_tables
WHERE schemaname = public;

环境变量

.env.local

bash
NEXTPUBLICSUPABASE_URL=https://.supabase.co
NEXTPUBLICSUPABASEANONKEY=<匿名密钥>
SUPABASESERVICEROLE_KEY=<服务角色密钥>

.env.example（提交到 Git）

bash
NEXTPUBLICSUPABASE_URL=
NEXTPUBLICSUPABASEANONKEY=
SUPABASESERVICEROLE_KEY=

客户端配置

服务端客户端（Next.js）

typescript
// lib/supabase/server.ts
import { createClient } from @supabase/supabase-js;
import { cookies } from next/headers;

export function createServerClient() {
const cookieStore = cookies();

return createClient(
process.env.NEXTPUBLICSUPABASE_URL!,
process.env.NEXTPUBLICSUPABASEANONKEY!,
{
auth: {
persistSession: false,
},
}
);
}

浏览器客户端（Next.js）

typescript
// lib/supabase/client.ts
import { createClient } from @supabase/supabase-js;

export const supabase = createClient(
process.env.NEXTPUBLICSUPABASE_URL!,
process.env.NEXTPUBLICSUPABASEANONKEY!
);

故障排查

连接问题

bash

检查 Supabase 是否可访问