ruby-rails-application

Ruby Rails 应用程序

目录

• 概述
• 适用场景
• 快速开始
• 参考指南
• 最佳实践

概述

按照 Rails 约定构建全面的 Ruby on Rails 应用程序，包含适当的模型关联、RESTful 控制器、Active Record 查询、身份验证系统、中间件链和视图渲染。

适用场景

• 构建 Rails Web 应用程序
• 实现带有关联的 Active Record 模型
• 创建 RESTful 控制器和操作
• 集成身份验证和授权
• 构建复杂的数据库关系
• 实现 Rails 中间件和过滤器

快速开始

最简可运行示例：

rails new myapp --api --database=postgresql
cd myapp
rails db:create

参考指南

references/ 目录中的详细实现：

指南	内容
Rails 项目设置	Rails 项目设置
使用 Active Record 的模型	使用 Active Record 的模型
数据库迁移	数据库迁移
带有 RESTful 操作的控制器	带有 RESTful 操作的控制器
使用 JWT 进行身份验证	使用 JWT 进行身份验证
Active Record 查询	Active Record 查询
序列化器	序列化器

最佳实践

✅ 应该

• 优先遵循约定，而非进行配置
• 善用 Active Record 关联
• 为查询实现合适的作用域
• 使用强参数保障安全
• 在 ApplicationController 中实现身份验证
• 使用服务处理复杂的业务逻辑
• 实现适当的错误处理
• 使用数据库迁移更改架构
• 在模型层验证所有输入
• 合理使用 before_action 过滤器

❌ 不应该

• 不使用参数化就执行原始 SQL
• 在控制器中实现业务逻辑
• 不经验证就信任用户输入
• 在代码中存储机密信息
• 使用 select *，而不指定列
• 忽视 N+1 查询问题（使用 includes/joins）
• 在每个控制器中实现身份验证
• 使用全局变量
• 忽略数据库约束