SuperAPI AI 工具集

wf-de-embed-portal

编程与开发

查看项目

更新于 10-16 06:39

技能介绍

用途

wf-de-embed-portal 是一个编排型技能,用于构建 Domo 嵌入式门户(Embed Portal)。当外部用户需要登录后才能查看或交互 Domo 仪表盘时使用,无论用户如何称呼该需求。该技能负责收集需求,然后委派给已有的能力技能处理 Domo 特有的实现细节,自身不重复子技能内容。

主要能力

该技能将门户构建拆分为多个阶段:

  • 阶段一:收集需求——以对话方式收集三类信息:品牌规范(主色、辅色、强调色、字体、Logo)、嵌入模式(只读、编辑或两者兼有)、用户管理方式(Domo AppDB、外部数据库或第三方认证提供商)。
  • 阶段二:搭建应用骨架——建议使用 Next.js(App Router、TypeScript、Tailwind CSS),并给出项目结构、环境变量示例。
  • 阶段三:按顺序实现——认证与登录、用户管理、只读嵌入、编辑嵌入、客户端交互、应用品牌。

该技能委派给以下子技能:

  • cap-de-programmatic-filters——只读嵌入令牌流程、服务端过滤器、数据集切换
  • cap-de-edit-embed——通过 Identity Broker 的编辑嵌入、JWT 认证、Domo 角色
  • cap-de-jsapi-filters——客户端过滤、钻取事件、iframe 通信

使用方式

该技能按阶段推进。首先收集品牌、嵌入模式和用户管理三方面需求,若上下文中已明确则跳过。随后搭建应用骨架,建议 Next.js,并生成项目结构与 .env.example。实现顺序为:

  1. 认证与登录(门户特有)——登录页、登录 API、会话 JWT(HttpOnly Cookie)、路由保护中间件。密码用 bcrypt 哈希(10+ 轮),会话 JWT 用 APP_JWT_SECRET 签名,1 小时有效期。
  2. 用户管理(门户特有)——用户 CRUD API、管理员 UI、用户数据模型(PortalUser、UserDashboard、DashboardFilter)、角色层级(Admin、Editor、Viewer)。
  3. 只读嵌入(若选择只读或两者)——委派给 cap-de-programmatic-filters,仅提供门户接线。
  4. 编辑嵌入(若选择编辑或两者)——委派给 cap-de-edit-embed,仅提供门户接线。需注意两个密钥用途不同:APP_JWT_SECRET 签门户登录会话,JWT_SECRET 签 Domo Identity Broker 令牌,不可互换。
  5. 客户端交互(可选)——委派给 cap-de-jsapi-filters,仅提供挂载模式。
  6. 应用品牌——将阶段一收集的品牌规范应用到 Tailwind 配置、页头、侧边栏、按钮、表单和登录页。

若同时选择只读和编辑模式,构建单个 EmbedDashboard 组件并分两个分支,根据仪表盘分配检测模式。若使用 AppDB 或外部数据库,需实现密码重置。

适用场景

  • 需要让外部用户登录后查看 Domo 仪表盘的项目
  • 需要让外部用户编辑 Domo 仪表盘的项目
  • 同时需要只读和编辑两种模式的门户
  • 基于 Next.js 构建、需要安全嵌入令牌流程的门户

限制

  • 该技能是编排型技能,不重复子技能内容,Domo 特有实现细节需阅读对应子技能。
  • 只读嵌入令牌流程、编辑嵌入 JWT 流程、JS API 实现均归子技能所有,本技能仅提供门户接线。
  • 部署选项包括 Vercel/Netlify、Docker、Domo Code Engine,其中 Domo Code Engine 需检查当前限制。
  • 生产前需完成安全检查清单:密钥置于环境变量、密码 bcrypt 哈希、会话令牌置于 HttpOnly Cookie、嵌入令牌仅服务端生成、管理员路由受中间件保护、程序化过滤器服务端强制执行、编辑 JWT 短有效期(5 分钟)、登录和密码重置端点限流。
  • 具体收费、价格、平台支持范围等事实资料中暂未提供。