<基本原则> ## Vanilla Rails 哲学 **“没有一个范式”** \-实用主义胜过纯粹性。 Rails 提供了所需的一切，无需复杂的架构模式。 ### 1\.服务对象上的丰富域模型业务逻辑存在于模型中。对复杂的工作流程使用嵌套操作类： # 模型方法委托给嵌套类类引用 < ApplicationRecord def 创建采购订单 PurchaseOrderCreation.new(self).call 结束结束 # 应用程序/模型/报价/purchase_order_creation.rb 类 Quote::PurchaseOrderCreation def 初始化(quote) = @quote = quote 定义呼叫 ApplicationRecord.transaction 做 po = 创建采购订单更新报价状态婆结束结束结束 ### 2\.对凝聚力特征的担忧关注点代表领域概念，而不是垃圾抽屉：模块可关闭扩展 ActiveSupport::关注包括做范围 :open, -> { where(close_at: nil) } 范围 :close, -> { where.not(close_at: nil) } 结束绝对接近！ =更新！（关闭时间：Time.current）确定关闭？ = 目前已关闭？定义打开？ = ！关闭？结束 ### 3\.瘦控制器，胖模型控制器协调；模型包含逻辑。使用过滤器链接：定义索引资源 = 资源.all .then(&方法(:apply_scoping)) .then(&method(:filter_by_status)) .then(&方法(:apply_ordering)) 渲染 json：ResourceBlueprint.render(resources) 结束 ### 4\.请求上下文的当前模式使用“Current”来处理横切关注点：当前类 < ActiveSupport::CurrentAttributes 属性：用户，：组织结束 # 在控制器中设置一次，在任何地方使用当前组织 1. 构建新功能/端点 2. 调试现有问题 3. 编写/运行测试 4.优化性能 5.重构代码 6.其他的东西 **然后从`workflows/`中读取匹配的工作流程并遵循它。** <验证循环> ## 每次更改后 # 1. 语法检查 ruby -c 应用程序/模型/changed_file.rb # 2. 运行测试 bin/rails 测试测试/models/changed_file_test.rb # 3. 棉绒捆绑执行 rubocop app/models/changed_file.rb -a 报告：“语法：OK | 测试：X pass | Lint：干净” <参考索引> ## 领域知识全部在`references/`中： **架构：**architecture.md **模型：** models.md **控制器：**controllers.md **序列化：**blueprints.md **验证：**validations-callbacks.md **后台作业：**background-jobs.md **性能：**performance.md **测试：**testing.md **多租户：**multi-tenant.md **反模式：**反模式.md <工作流程索引> ## 工作流程全部在“工作流程/”中：文件 |目的 ---|--- 构建功能.md |从头开始创建新功能/端点调试.md |查找并修复错误写测试.md |编写并运行测试优化性能.md |配置文件和加速重构.md |按照模式重构代码 |

红宝石 on Rails

包含技能