stack_philosophy:
  framework: "Rails 8"
  database: "SQLite3 (production-ready)"
  background_jobs: "SolidQueue"
  websockets: "SolidCable"
  caching: "SolidCache"
  frontend: "Hotwire (Turbo + Stimulus)"
  styling: "Tailwind CSS"

code_conventions:
  naming:
    files: "snake_case"
    methods: "snake_case"
    classes: "CamelCase"
    constants: "SCREAMING_SNAKE_CASE"

  structure:
    - "Follow Rails conventions"
    - "RESTful routing"
    - "Thin controllers, fat models"
    - "Service objects for complex logic"

undefined

if user&.authenticate(params[:password])
  session[:user_id] = user.id
  redirect_to root_path, notice: "Logged in!"
else
  flash.now[:alert] = "Invalid email or password"
  render :new, status: :unprocessable_entity
end

undefined

undefined

undefined

undefined

undefined

undefined

undefined

undefined

  t.timestamps
end

add_index :orders, :status
add_index :orders, :completed_at
add_index :orders, [:user_id, :status]

undefined

<!-- app/views/products/index.html.erb -->
<%= turbo_frame_tag "products" do %>
  <div class="grid grid-cols-3 gap-4">
    <% @products.each do |product| %>
      <%= render product %>
    <% end %>
  </div>

  <%= paginate @products %>
<% end %>

<!-- app/views/products/_product.html.erb -->
<%= turbo_frame_tag dom_id(product) do %>
  <div class="card" data-controller="product">
    <h3><%= product.name %></h3>
    <p><%= number_to_currency product.price %></p>

    <%= link_to "Edit", edit_product_path(product),
                data: { turbo_frame: "modal" } %>
  </div>
<% end %>

undefined

if @comment.save
  respond_to do |format|
    format.turbo_stream
    format.html { redirect_to @post }
  end
else
  render :new, status: :unprocessable_entity
end

undefined

// app/javascript/controllers/form_controller.js
import { Controller } from "@hotwired/stimulus"

export default class extends Controller {
  static targets = ["input", "submit", "output"]
  static values = {
    url: String,
    debounce: { type: Number, default: 300 }
  }

  connect() {
    this.timeout = null
  }

  search() {
    clearTimeout(this.timeout)
    this.timeout = setTimeout(() => {
      this.performSearch()
    }, this.debounceValue)
  }

  async performSearch() {
    const query = this.inputTarget.value
    if (query.length < 2) return

    this.submitTarget.disabled = true

    try {
      const response = await fetch(`${this.urlValue}?q=${encodeURIComponent(query)}`)
      const html = await response.text()
      this.outputTarget.innerHTML = html
    } finally {
      this.submitTarget.disabled = false
    }
  }
}

undefined

it { should validate_presence_of(:name) }
it { should validate_presence_of(:price) }
it { should validate_uniqueness_of(:sku) }
it { should validate_numericality_of(:price).is_greater_than(0) }

  it "returns only published products with stock" do
    expect(Product.available).to contain_exactly(available)
  end
end

context "with valid params" do
  it "creates a new product" do
    expect {
      post products_path, params: valid_params
    }.to change(Product, :count).by(1)
  end
end

fill_in "Name", with: "Test Product"
fill_in "Price", with: "99.99"
click_button "Create Product"

expect(page).to have_content("Product was successfully created")
expect(page).to have_content("Test Product")

undefined

undefined

<% cache [product.category, "category"] do %>
  <span class="category"><%= product.category.name %></span>
<% end %>

undefined

undefined

undefined

undefined

# Partial index
add_index :products, :featured, where: "featured = true"

# GIN index for JSONB
add_index :products, :metadata, using: :gin

undefined

undefined

undefined

undefined

  before_action :authenticate_api_user!

  private

  def authenticate_api_user!
    authenticate_or_request_with_http_token do |token, options|
      @current_api_user = User.find_by(api_token: token)
    end
  end

  def current_api_user
    @current_api_user
  end
end

    render json: {
      products: products.as_json(only: [:id, :name, :price]),
      meta: {
        current_page: products.current_page,
        total_pages: products.total_pages,
        total_count: products.total_count
      }
    }
  end

  def show
    product = Product.find(params[:id])
    render json: ProductSerializer.new(product).as_json
  end
end

undefined