# 爱柚科技接入准备清单

产品入口：https://iyoucloud.com/

## 1. 确认应用与权限

- 应用名称、用途与负责人。
- 所属租户、用户范围、角色与资源权限。
- 客户端形态：Web BFF、Web SPA 或原生应用。
- 由管理员登记应用并分配访问权限；门户不提供匿名自助开户。

## 2. 配置统一认证

- 应用域名、允许来源、精确回调地址与退出后的返回地址。
- 独立的本地开发客户端与部署客户端；不要使用通配回调地址。
- 由管理员分配客户端标识，确认登录模板、会话策略与增强认证要求。
- OIDC Issuer：https://sso.iyoucloud.com/realms/iyoucloud
- 发现文档：https://sso.iyoucloud.com/realms/iyoucloud/.well-known/openid-configuration
- Web SPA / 原生应用使用 Authorization Code + PKCE（S256）。
- BFF 的 OAuth 令牌由服务端持有；浏览器中不配置客户端密钥。
- 登录协议对接与业务会话接入需要一起联调，不能只验证登录跳转。

## 3. 前端平台

- 使用 Node.js >=22.13.0 <27 与 pnpm。
- 取得 @iyoucloud 包仓库权限后，锁定平台 runtime/tooling 版本。
- 按需复用应用生命周期、路由、主题、存储与请求能力。
- 业务模型、权限码、服务端点与品牌设计保留在独立应用。
- 管理系统可使用默认布局；官网与其他产品可自定义展示层。

## 4. 服务集成

- 梳理应用域名、服务上游、接口路径与所需网关策略。
- 明确身份、会话、租户上下文与服务端权限校验。
- 文件等基础服务接口由管理员按应用授权提供。
- 不在公开前端配置中放入内部管理端点或服务凭据。

## 5. 联调验收

- 登录、回调、刷新恢复、过期恢复与不同范围的退出。
- 角色与租户隔离、未授权访问、接口错误与重试。
- 桌面与手机、明暗主题、键盘操作与减少动态效果。
- 类型、测试、构建、部署后的资源缓存与版本回退。

## 系统入口

- 权限管理：https://upms.iyoucloud.com/
- 认证中心：https://auth.iyoucloud.com/
- 网关中心：https://gateway.iyoucloud.com/

所有控制台按实际账号权限访问。其他基础服务当前通过业务应用或平台管理流程接入。