SimplyCouch

class User
  include SimplyCouch::Model

  property :name
  property :email

  has_many :posts
  belongs_to :company
end

gem 'simply_couch'

gem 'couchrest'  # or couchbase, or any CouchDB driver

class Post
  include SimplyCouch::Model

  property :title
  property :body
  property :published, type: Boolean, default: false
  property :tags, type: Array

  belongs_to :author, class_name: 'User'
  has_many :comments, dependent: :destroy

  view :by_title, key: :title
  view :published_by_date, key: :created_at, conditions: 'doc.published == true'
end

# CRUD
post = Post.create(title: 'Hello World', body: '...')
post.update(title: 'Hello SimplyCouch')
post.destroy

# Queries
Post.find_by_title('Hello World')
Post.published_by_date(descending: true)
Post.all(page: 1, per_page: 40)

# Associations
post.author              # => User
post.comments            # => [Comment, ...]
post.comment_count       # => 42
Post.all(include: :author)  # eager-load to avoid N+1

property :name
property :age,        type: Integer
property :price,      type: Float
property :active,     type: Boolean
property :last_login, type: Time
property :tags,       type: Array
property :metadata,   type: Hash

class Post
  include SimplyCouch::Model
  has_many :comments, dependent: :destroy
  has_many :authors, through: :comments, source: :user
  belongs_to :category
end

class Page
  include SimplyCouch::Model
  property :categories, type: Array
  validates_containment_of :categories, in: %w[news blog docs]
end

view :by_status, key: :status
view :published, key: :created_at, conditions: 'doc.status == "published"'

Post.all(page: 2, per_page: 25)
User.by_name(page: 1, per_page: 50, descending: true)

class Document
  include SimplyCouch::Model
  enable_soft_delete  # defaults to :deleted_at
end

doc.destroy
Document.all                          # => [] (soft-deleted filtered out)
Document.all(with_deleted: true)      # => [doc] (recoverable)

class Page
  include SimplyCouch::Model
  property :title
  has_ancestry
end

parent = Page.create(title: 'Products')
child  = Page.create(title: 'Widgets', parent: parent)

Page.roots              # pages with no parent
Page.full_tree          # entire tree in one query
parent.children         # direct children
parent.descendants      # all descendants (flattened)
child.ancestors         # path to root

User.find_by_name('Alice')
User.find_all_by_active(true)
User.count_by_active(true)

User.auto_conflict_resolution_on_save = false

class ArchivedPost
  include SimplyCouch::Model
  use_database 'http://couchdb:5984/archive'
end

class Post
  include SimplyCouch::Model
  split_design_documents_per_view

  view :by_user_id, key: :user_id   # → _design/Post_view_by_user_id
  view :by_status,  key: :status    # → _design/Post_view_by_status
end

class Invoice
  include SimplyCouch::Model
  has_couch_attached :receipt
end

invoice.receipt = File.read('receipt.pdf')
invoice.save                           # attachment uploaded to CouchDB
invoice.receipt_url                    # fetch URL
invoice.delete_couch_attachment(:receipt)

class Product
  include SimplyCouch::Model
  has_local_attached :photo, styles: { thumb: '100x100', medium: '300x300' }
end

product.photo = uploaded_file
product.photo.url(:thumb)              # => "/system/product/photos/.../thumb.jpg"

class Report
  include SimplyCouch::Model
  has_s3_attached :pdf, bucket: 'reports'
end

report.pdf = File.read('monthly.pdf')
report.save                            # uploads to S3
report.pdf_url                         # presigned URL

# config/initializers/simply_couch.rb
SimplyCouch.s3_defaults = {
  bucket: 'myapp',
  access_key: ENV['S3_ACCESS_KEY'],
  secret_access_key: ENV['S3_SECRET_KEY']
}

# Or from Rails credentials:
SimplyCouch.s3_defaults = Rails.application.credentials.s3