用途
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。实现顺序为:
- 认证与登录(门户特有)——登录页、登录 API、会话 JWT(HttpOnly Cookie)、路由保护中间件。密码用 bcrypt 哈希(10+ 轮),会话 JWT 用 APP_JWT_SECRET 签名,1 小时有效期。
- 用户管理(门户特有)——用户 CRUD API、管理员 UI、用户数据模型(PortalUser、UserDashboard、DashboardFilter)、角色层级(Admin、Editor、Viewer)。
- 只读嵌入(若选择只读或两者)——委派给 cap-de-programmatic-filters,仅提供门户接线。
- 编辑嵌入(若选择编辑或两者)——委派给 cap-de-edit-embed,仅提供门户接线。需注意两个密钥用途不同:APP_JWT_SECRET 签门户登录会话,JWT_SECRET 签 Domo Identity Broker 令牌,不可互换。
- 客户端交互(可选)——委派给 cap-de-jsapi-filters,仅提供挂载模式。
- 应用品牌——将阶段一收集的品牌规范应用到 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 分钟)、登录和密码重置端点限流。
- 具体收费、价格、平台支持范围等事实资料中暂未提供。