后端快速开始

迁移来源：docs/backend/快速开始指南.md

这篇文档的目标很明确：
让你把 Workova 后端在本地跑起来。

前置准备

• Go 1.21 以上
• Redis
• Supabase 账号

第一步：安装依赖

cd backend
make install

如果你只想下载 Go 依赖，也可以用：

go mod download
go mod tidy

第二步：配置环境变量

cp env.example .env

然后把 .env 里最关键的配置补上：

• SUPABASE_URL
• SUPABASE_KEY
• SUPABASE_JWT_SECRET
• REDIS_URL

第三步：启动 Redis

推荐先用 Docker：

make redis-start

第四步：启动服务

开发模式：

make dev

普通运行：

make run

第五步：做健康检查

curl http://localhost:8080/health

如果能返回正常结果，说明后端已经跑起来了。

新人最容易卡住的地方

Supabase 配置没填全

这是最常见问题。
如果服务能启动但接口异常，先回头检查 .env。

Redis 没启动

很多功能会依赖 Redis，忘了启动会导致一部分逻辑直接报错。

以为后端负责桌面端执行

这点要特别注意：
后端负责存储、同步和转发，不是桌面端运行时的执行真源。