# Rails 专家 ## 核心工作流程 1. **分析需求** — 确定模型、路线、实时需求、后台作业 2. **脚手架资源** - `rails 生成模型用户名:string email:string`, `rails 生成控制器用户` 3. **运行迁移** — `rails db:migrate` 并使用 `rails db:schema:dump` 验证模式 * 如果迁移失败：检查 `db/schema.rb` 是否有冲突，使用 `rails db:rollback` 回滚，修复并重试 4. **实施** — 编写控制器、模型，添加 Hotwire（请参阅下面的参考指南） 5. **验证** — `bundle exec rspec` 必须通过；样式的“bundle exec rubocop” * 如果规格失败：检查错误输出，修复失败示例，使用“--format Documentation”重新运行以获取详细信息 * 如果在审核期间出现 N+1 查询：添加 `includes`/`eager_load` （请参阅常见模式）并重新运行规范 6. **优化**——审核N+1查询，添加缺失索引，添加缓存 ## 参考指南根据上下文加载详细指南：主题 |参考|加载时间 ---|---|--- 热线/涡轮| `references/hotwire-turbo.md` | Turbo Frames、Streams、Stimulus 控制器活动记录| `references/active-record.md` |模型、关联、查询、性能后台工作 | `references/background-jobs.md` | Sidekiq、作业设计、队列、错误处理测试| `references/rspec-testing.md` |型号/要求/系统规格、工厂 API 开发 | `references/api-development.md` |仅 API 模式、序列化、身份验证 ## 常见模式 ### 使用includes/eager_load进行N+1预防 # BAD — 触发 N+1 帖子 = Post.all posts.each { |post|放置 post.author.name } # GOOD — 急切加载关联 posts = Post.includes(:author).all posts.each { |post|放置 post.author.name } # 好 — eager_load 强制加入（在过滤关联时很有用） posts = Post.eager_load(:author).where(authors: { verify: true }) ### Turbo Frame 设置（部分页面更新） <%# app/views/posts/index.html.erb %> <%=turbo_frame_tag“帖子”执行%> <%= 渲染@posts %> <%= link_to "加载更多", posts_path(page: @next_page) %> <％结束％> <%# app/views/posts/_post.html.erb %> <%= Turbo_frame_tag dom_id(post) do %>

<%= post.title %>

<%= link_to "编辑", edit_post_path(post) %> <％结束％> # 应用程序/控制器/posts_controller.rb 定义索引 @posts = Post.includes(:author).page(params[:page]) @next_page = @posts.next_page 结束 ### Sidekiq 工作模板 # 应用程序/jobs/send_welcome_email_job.rb 类 SendWelcomeEmailJob < ApplicationJob 队列作为：默认 sidekiq_options 重试：3，死亡：false def 执行(user_id) 用户 = User.find(user_id) UserMailer.welcome(用户).deliver_now 救援 ActiveRecord::RecordNotFound => e Rails.logger.warn("SendWelcomeEmailJob: 未找到用户 #{user_id} — #{e.message}") # 不要再次加注；记录消失了，重试没有意义结束结束 # 从控制器或模型回调入队 SendWelcomeEmailJob.perform_later(user.id) ### 强参数（控制器模板） # 应用程序/控制器/posts_controller.rb 类 PostsController < 应用程序控制器 before_action :set_post，仅：%i[显示编辑更新销毁] 定义创建 @post = Post.new(post_params) 如果@post.save redirect_to @post，注意：“帖子已创建。” 否则渲染：新，状态：：unprocessable_entity 结束结束私人的 def set_post @post = Post.find(params[:id]) 结束 def post_params params.require(:post).permit(:title, :body, :published_at) 结束结束 ## 约束条件 ### 必须做 * 在每个涉及关联的集合查询上使用“includes”/“eager_load”防止 N+1 查询 * 编写全面的规格，目标覆盖率 >95% * 使用服务对象来实现复杂的业务逻辑；保持控制器纤薄 * 为“WHERE”、“ORDER BY”或“JOIN”中使用的每个列添加数据库索引 * 将缓慢的操作卸载到 Sidekiq — 切勿在请求周期中同步运行它们 ### 绝对不能做 * 跳过架构更改的迁移 * 使用未经清理的原始 SQL（仅“sanitize_sql”或参数化查询） * 不加考虑地暴露 URL 中的内部 ID ## 输出模板实现 Rails 功能时，请提供： 1. 迁移文件（如果需要更改架构） 2. 具有关联和验证的模型文件 3. 具有 RESTful 操作和强大参数的控制器 4. 查看文件或 Hotwire 设置 5. 型号和要求的规格文件 6. 架构决策的简要说明

轨道专家

包含技能