nexu-io__open-design/docs/testing/e2e-coverage/entry.md

入口模块

覆盖范围

• 新建项目入口面板
• 入口侧栏项目类型切换与草稿保持
• Home 左侧导航、最近项目与 starter 入口
• 提示词模板创建路径
• Integrations 连接器入口与连接器 gate
• 资源驱动的项目创建 happy path

对应测试文件

• e2e/ui/entry-configuration-flows.test.ts
• e2e/ui/entry-chrome-flows.test.ts
• e2e/ui/app.test.ts
• e2e/ui/project-management-flows.test.ts

已自动化

入口配置流

ID	场景	来源
ENTRY-001	提示词模板加载失败后重试，编辑后的模板正文会写入项目 metadata	entry-configuration-flows.test.ts
ENTRY-002	live artifact 的空状态连接器 CTA 会跳转到受保护的 connector setup 路径	entry-configuration-flows.test.ts
ENTRY-003	connectors 入口支持搜索、空结果态，以及详情抽屉的键盘关闭	entry-configuration-flows.test.ts
ENTRY-004	在 Integrations 里保存 Composio key 后，connectors gate 会立即解锁，搜索和卡片可直接使用	entry-configuration-flows.test.ts
ENTRY-005	创建原型时切换到 Wireframe 后，即使先切到其他项目类型再切回，fidelity 选择也会保留，并正确写入创建 payload	NewProjectPanel.test.tsx
ENTRY-006	创建原型时在 design system 多选模式下切回 不指定 — 自由发挥，会清空主设计体系和 inspiration metadata	NewProjectPanel.test.tsx
ENTRY-007	创建原型时若项目名为空白，会回退到自动生成的默认标题而不是提交空名	NewProjectPanel.test.tsx
ENTRY-008	创建实时制品时会把 kind=prototype、intent=live-artifact 和当前 fidelity 一并写入创建 payload	NewProjectPanel.test.tsx
ENTRY-009	创建幻灯片时，开启 Use speaker notes 会把 speakerNotes=true 写入创建 metadata	NewProjectPanel.test.tsx
ENTRY-010	从模板创建在没有用户模板时不会误触发创建；有模板时会带上 templateId/templateLabel 正常提交	NewProjectPanel.test.tsx
ENTRY-011	创建图片项目时，所选 aspect 与修剪后的 style notes 会正确写入创建 payload	NewProjectPanel.test.tsx
ENTRY-012	创建视频项目时，所选 aspect 与 duration 会正确写入创建 payload	NewProjectPanel.test.tsx
ENTRY-013	创建音频项目时，所选 duration 与修剪后的 voice 会正确写入创建 payload	NewProjectPanel.test.tsx
ENTRY-014	入口页不再渲染旧 pet rail，Settings 也不再暴露 pet picker 的显示/隐藏开关	entry-chrome-flows.test.ts
ENTRY-015	紧凑桌面宽度下，入口页 header 与整页不会出现明显横向溢出	entry-chrome-flows.test.ts
ENTRY-016	展开的入口导航保持当前 Home / Community / Design systems / Plugins / Settings 结构，不再暴露已移除的 Projects / Automations / Integrations rail 入口	entry-chrome-flows.test.ts

资源驱动创建场景

ID	场景	来源
ENTRY-101	Prototype 项目可以创建并预览生成的 artifact	app.test.ts via prototype-basic
ENTRY-102	Deck 项目可以创建并预览生成的 deck artifact	app.test.ts via deck-basic
ENTRY-103	New project 的 design system 多选会把主系统与 inspirations 正确写入创建 payload	project-management-flows.test.ts
ENTRY-104	Image 项目通过当前 Media → Image 路径创建，并保存图片项目 metadata	app.test.ts via image-basic
ENTRY-105	Video 项目通过当前 Media → Video 路径创建，并保存默认模型、画幅与时长 metadata	app.test.ts via video-basic
ENTRY-106	Audio SFX 项目通过当前 Media → Audio 路径创建，并保存音频类型 metadata	app.test.ts via audio-sfx-basic
ENTRY-107	Live artifact 项目通过当前独立入口创建，并保存 intent 与高保真 metadata	app.test.ts via live-artifact-basic
ENTRY-108	HyperFrames 项目通过当前 Media → Video 路径创建，并预览生成的 HTML motion artifact	app.test.ts via hyperframes-basic

手工保留

ID	场景	原因
ENTRY-M01	入口页视觉风格是否符合品牌预期	依赖主观视觉判断，不适合做稳定自动化断言
ENTRY-M02	入口页动效、过渡、微交互是否自然	更适合人工体验验收，自动化收益较低

说明

• app.test.ts 的部分场景来自 e2e/resources/playwright.ts。新增资源驱动用例时，需要同时更新资源文件和这份文档。
• 旧 ExamplesTab 组件及其组件测试仍在仓库中，但当前 EntryShell 不挂载该页面；这些孤立组件测试不计作当前入口用户流覆盖，旧 example-use-prompt 资源也不能证明一条可达入口路径。
• 依赖 mocked SSE 的入口流程应尽量保持稳定、可重复、执行快。