feat(project): init

README.md

@@ -0,0 +1,29 @@
+# cms-front
+
+CMS 前端（业务系统），用于演示按 `iam-service/docs/SSO_INTEGRATION.md` 接入统一登录（iam-front）。
+
+## 本地启动
+
+```bash
+cp .env.example .env
+pnpm install
+pnpm dev
+```
+
+## 本地联调流程
+
+- 未登录访问页面时，middleware 会跳转到 iam-front 的 `/login`（携带 `clientId/tenantId/callback`）
+- 登录成功后会回跳到业务 callback（通常是 `cms-service /auth/callback`），由后端换 token 并写入 cookie，然后再重定向回 cms-front
+- 换取失败会跳转到 `/auth-error` 显示错误信息
+
+开发环境设置 tenantId（写入 tenantId cookie）：
+
+```
+/api/dev/set-tenant?tenantId=你的租户UUID
+```
+
+也可以在 .env 里设置默认租户（仅开发环境生效）：
+
+```
+CMS_DEFAULT_TENANT_ID=你的租户UUID
+```