SuperAPI AI 工具集

implementing-hotwire-admin

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:在 Ruby on Rails 应用中实现可自定义的管理后台,适合不使用 ActiveAdmin 或 Administrate、希望自行构建管理界面的场景,也可用于为现有应用新增管理后台并配套 E2E 测试。

主要能力:按步骤覆盖管理后台的搭建流程,包括管理命名空间、路由与基础控制器;专用布局与侧边栏导航;列表、详情、新建、编辑等 CRUD 页面及各数据类型对应的表单辅助方法;删除、发布、下架等 Turbo 化操作;确认对话框、Flash 消息、动态表单等 Stimulus 控制器;管理后台测试用例的系统化梳理与测试计划;基于 Playwright + Capybara 的 E2E 测试实现(采用 TDD 方式推进);以及常见问题的排查。

技术栈:Ruby on Rails 8.x、Hotwire(Turbo + Stimulus)、Tailwind CSS、Playwright + Capybara,认证可用 Devise 或自建方案。

使用方式:技能主文件为 SKILL.md,具体步骤见 steps/ 目录(01_setup_and_routing.md 至 08_troubleshooting.md),另有 references/turbo_patterns.md 作为 Turbo 模式参考。

限制与注意:Rails 8 的 Turbo 环境下 link_to 的 method: 选项不可用,需使用 button_to 配合 data: { turbo_confirm: ... }。E2E 测试中测试 Turbo 确认对话框应使用 click_button 而非 click_link;响应式测试可用 page.driver.with_playwright_page 调整视口大小;CI 环境使用 Playwright 无头模式。其余配置细节暂未提供。