refactor: unify storage config keys and refresh local dev setup

docs/protocols/models/auth.md

@@ -25,6 +25,21 @@ Base URL: `/api/v1/auth`
 
 ---
 
+## 本地开发约定（Supabase Self-Hosting）
+
+- 环境：本地网关地址为 `http://localhost:8001`，后端通过 `SOCIAL_SUPABASE__PUBLIC_URL` 访问。
+- 认证：开发机启用 SMS 测试 OTP，不走真实短信供应商。
+- 默认测试账号：`SOCIAL_TEST__PHONE`（提交时需使用 E.164，即在前面补 `+`）。
+- 默认测试验证码：`123456`（由本地 `auth` 服务的 `GOTRUE_SMS_TEST_OTP` 提供）。
+
+兼容性策略：
+
+- 对外 API 合约不变（`/otp/send`、`/phone-session`、`/sessions/*` 保持一致）。
+- 仅切换验证码来源（生产/云环境真实短信，本地环境测试 OTP）。
+- 前后端不需要因本地/云差异修改接口调用方式。
+
+---
+
 ## 1) POST `/otp/send`
 
 发送验证码，不区分登录和注册场景。