用途:为 Rails 应用编写 RSpec 测试提供系统化模式参考,适用于编写单元测试、集成测试、系统测试,以及搭建测试工厂、共享示例、Mock 外部服务、测试 ViewComponent 和后台任务。
主要能力:给出 spec 目录结构(rails_helper.rb、spec_helper.rb、support、factories、models、services、controllers、requests、system、components、jobs);展示模型 spec 的关联、校验、scope 与方法测试写法;FactoryBot 工厂定义、序列、trait、关联、transient 属性与回调;服务对象 spec 的 .call 测试、参数校验与 ServiceResult 模式;请求 spec 的认证头、状态码、JSON 响应与多租户隔离断言;ViewComponent 的 render_inline 与格式化方法测试;Capybara 系统测试与 Turbo Stream 更新验证;后台任务 spec 的 perform、队列与 enqueue 断言;共享示例(tenant scoped、requires authentication)与共享上下文(authenticated user);用 WebMock 桩化外部 HTTP 服务;认证与请求辅助方法。
使用方式:在 Rails 项目 spec 目录中按示例组织测试文件,通过 require 'rails_helper' 引入配置,使用 create/build、let、subject、before 等 RSpec 与 FactoryBot API 编写用例;外部服务用 stub_request 桩化;共享示例用 it_behaves_like 复用。
适用场景:Rails 企业级应用的模型、服务、控制器、请求、系统、组件与任务测试。
限制:资料未提供安装命令、版本要求、收费信息或具体运行命令;示例中的类名、路径与业务字段需按实际项目调整。