rails-image-post-solution 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61ff05d1659ea0e22251e785b60a0a3e9c08f200f63b54a16ddb77edfd046987
-  data.tar.gz: b211876b47d97ef9da39dd0197c688bde4951d9c2e100cf20da227e4b7129425
+  metadata.gz: 2120b2a444d646648b7e9fe57165b4a89f2bffd99b9e6ca2e4aeb19f924dd626
+  data.tar.gz: fadbb2a26397c2f4172630cbb24ef71f63dc05fd56463097856d0c0516c797bb
 SHA512:
-  metadata.gz: f448802dbaa0cbbeb74555219f1100ec50373a0cea862d8322efb63e653fea5420c3bab1413f9086feee2973f907f225188cbeffc4e6abdb271b494bcd189976
-  data.tar.gz: 0bdadbfc8e131fface96b9d3d9269e548687d11c1d65bbd2975b9aecbe3f3b4a08e536207e0136eb6607fe4b042be2b0f69a45cd8a55160c2ff35e10d49fc876
+  metadata.gz: 5472105bd1e6764ff1f977b4f46900f1f7560531a0c30ee05b94b59a645ee8ca103a9d3fcc966328203295796f9cf8fae4a4c41d49034ad9ad65cfe1086bde76
+  data.tar.gz: 57655c478d8a9a30e4c4f7e3e1158cc62c58eda115725c53810b043ced3599da95c28373c8804e650f1235d99b73deace7a2e16db25ed5cbc942821722117b07

data/README.md

@@ -4,6 +4,7 @@ A comprehensive Rails engine for image reporting, AI-powered moderation using Op
 
 ## Features
 
+### Core Features
 - **Image Reporting System**: Allow users to report inappropriate images
 - **AI-Powered Moderation**: Automatic content moderation using OpenAI Vision API
   - Detects R18 (adult content)
@@ -14,10 +15,15 @@ A comprehensive Rails engine for image reporting, AI-powered moderation using Op
 - **i18n Support**: Japanese and English locales included
 - **Highly Configurable**: Customize behavior to fit your application
 
+### Extended Admin Features (Optional)
+- **User Management**: Suspend, ban, and manage users
+- **Frozen Posts Management**: Review, unfreeze, or permanently freeze flagged content
+- **Enhanced Reporting**: Extended admin views with detailed statistics
+
 ## Requirements
 
-- Ruby >= 3.2.0
-- Rails >= 7.0
+- Ruby >= 3.4.7
+- Rails >= 8.1
 - Active Storage
 - OpenAI API key (for AI moderation features)
 
@@ -56,7 +62,39 @@ Mount the engine in your `config/routes.rb`:
 
 ```ruby
 Rails.application.routes.draw do
+  # Mount the engine (admin routes will be at /moderation/admin/image_reports)
   mount RailsImagePostSolution::Engine => "/moderation"
+
+  # Optional: Add direct admin routes (accessible at /admin/*)
+  namespace :admin do
+    resources :image_reports, only: %i[index show], controller: 'admin/image_reports' do
+      member do
+        patch :confirm
+        patch :dismiss
+      end
+    end
+
+    resources :users, only: %i[index show], controller: 'admin/users' do
+      member do
+        post :suspend
+        post :unsuspend
+        post :ban
+        post :unban
+      end
+    end
+
+    resources :frozen_posts, only: [:index], controller: 'admin/frozen_posts' do
+      collection do
+        post "unfreeze_stage/:id", to: "admin/frozen_posts#unfreeze_stage", as: :unfreeze_stage
+        post "unfreeze_comment/:id", to: "admin/frozen_posts#unfreeze_comment", as: :unfreeze_comment
+        post "permanent_freeze_stage/:id", to: "admin/frozen_posts#permanent_freeze_stage", as: :permanent_freeze_stage
+        post "permanent_freeze_comment/:id", to: "admin/frozen_posts#permanent_freeze_comment", as: :permanent_freeze_comment
+        delete "destroy_stage/:id", to: "admin/frozen_posts#destroy_stage", as: :destroy_stage
+        delete "destroy_comment/:id", to: "admin/frozen_posts#destroy_comment", as: :destroy_comment
+      end
+    end
+  end
+
   # ... your other routes
 end
 ```
@@ -90,7 +128,15 @@ export OPENAI_API_KEY=sk-...
 
 ### User Reporting
 
-Users can report images via POST request:
+The gem provides shared view partials for easy integration:
+
+```erb
+<%# In your view %>
+<%= render 'shared/image_report_button', image: @attachment %>
+<%= render 'shared/image_report_modal' %>
+```
+
+Or manually via POST request:
 
 ```ruby
 # In your view
@@ -113,6 +159,12 @@ fetch('/moderation/image_reports', {
 });
 ```
 
+The provided partials include:
+- `_image_report_button.html.erb` - Report button with status display
+- `_image_report_modal.html.erb` - Modal dialog for submitting reports with category selection
+
+**Note**: The partials reference Stimulus controllers (`image-report`). You'll need to implement the corresponding Stimulus controller in your application or use the manual POST method above.
+
 ### Admin Dashboard
 
 Admins can access the dashboard at:
@@ -144,17 +196,43 @@ To enable automatic post freezing, add a `freeze_post!` method to your models th
 class Post < ApplicationRecord
   has_many_attached :images
 
+  # Scopes for frozen posts management
+  scope :frozen, -> { where.not(frozen_at: nil) }
+  scope :temporarily_frozen, -> { frozen.where(frozen_type: "temporary") }
+  scope :permanently_frozen, -> { frozen.where(frozen_type: "permanent") }
+  scope :recent, -> { order(created_at: :desc) }
+
   def freeze_post!(type:, reason:)
     update!(
-      frozen: true,
       frozen_type: type,
       frozen_reason: reason,
       frozen_at: Time.current
     )
   end
 
+  def unfreeze!
+    update!(
+      frozen_type: nil,
+      frozen_reason: nil,
+      frozen_at: nil
+    )
+  end
+
   def frozen?
-    frozen == true
+    frozen_at.present?
+  end
+end
+```
+
+Add the required columns to your model:
+
+```ruby
+class AddFrozenFieldsToPosts < ActiveRecord::Migration[8.1]
+  def change
+    add_column :posts, :frozen_type, :string
+    add_column :posts, :frozen_reason, :text
+    add_column :posts, :frozen_at, :datetime
+    add_index :posts, :frozen_at
   end
 end
 ```
@@ -183,9 +261,74 @@ class User < ApplicationRecord
 end
 ```
 
+### Additional User Model Methods (for Extended Features)
+
+If you plan to use the extended admin features (user management, frozen posts), add these methods to your User model:
+
+```ruby
+class User < ApplicationRecord
+  # Status check methods
+  def active?
+    !suspended? && !banned?
+  end
+
+  def suspended?
+    suspended_until.present? && suspended_until > Time.current
+  end
+
+  def banned?
+    banned_at.present?
+  end
+
+  # User management methods
+  def suspend!(reason:, duration: 7.days)
+    update!(
+      suspended_until: Time.current + duration,
+      suspension_reason: reason
+    )
+  end
+
+  def unsuspend!
+    update!(
+      suspended_until: nil,
+      suspension_reason: nil
+    )
+  end
+
+  def ban!(reason:)
+    update!(
+      banned_at: Time.current,
+      ban_reason: reason
+    )
+  end
+
+  def unban!
+    update!(
+      banned_at: nil,
+      ban_reason: nil
+    )
+  end
+end
+```
+
+And add the corresponding database columns:
+
+```ruby
+class AddModerationFieldsToUsers < ActiveRecord::Migration[8.1]
+  def change
+    add_column :users, :suspended_until, :datetime
+    add_column :users, :suspension_reason, :text
+    add_column :users, :banned_at, :datetime
+    add_column :users, :ban_reason, :text
+  end
+end
+```
+
 ## Routes
 
-The engine provides the following routes:
+### Engine Routes (via /moderation mount point)
+
+When you mount the engine at `/moderation`, these routes are available:
 
 ```
 POST   /moderation/image_reports                        # Create report
@@ -193,6 +336,25 @@ GET    /moderation/admin/image_reports                  # List all reports
 GET    /moderation/admin/image_reports/:id              # View report details
 PATCH  /moderation/admin/image_reports/:id/confirm      # Mark as inappropriate
 PATCH  /moderation/admin/image_reports/:id/dismiss      # Mark as safe
+GET    /moderation/admin/users                          # List all users
+GET    /moderation/admin/users/:id                      # View user details
+POST   /moderation/admin/users/:id/suspend              # Suspend user
+POST   /moderation/admin/users/:id/unsuspend            # Unsuspend user
+POST   /moderation/admin/users/:id/ban                  # Ban user
+POST   /moderation/admin/users/:id/unban                # Unban user
+GET    /moderation/admin/frozen_posts                   # List frozen posts
+```
+
+### Optional: Direct Admin Routes (via host application routes)
+
+If you want admin routes accessible at `/admin/*` instead of `/moderation/admin/*`, add the routes shown in the Installation section to your host application's `config/routes.rb`. This allows you to access:
+
+```
+GET    /admin/image_reports                             # List all reports
+GET    /admin/image_reports/:id                         # View report details
+GET    /admin/users                                     # List all users
+GET    /admin/users/:id                                 # View user details
+GET    /admin/frozen_posts                              # List frozen posts
 ```
 
 ## Customization

data/config/routes.rb

@@ -12,5 +12,27 @@ RailsImagePostSolution::Engine.routes.draw do
         patch :dismiss
       end
     end
+
+    # User management
+    resources :users, only: %i[index show] do
+      member do
+        post :suspend
+        post :unsuspend
+        post :ban
+        post :unban
+      end
+    end
+
+    # Frozen posts management
+    resources :frozen_posts, only: [:index] do
+      collection do
+        post "unfreeze_stage/:id", to: "frozen_posts#unfreeze_stage", as: :unfreeze_stage
+        post "unfreeze_comment/:id", to: "frozen_posts#unfreeze_comment", as: :unfreeze_comment
+        post "permanent_freeze_stage/:id", to: "frozen_posts#permanent_freeze_stage", as: :permanent_freeze_stage
+        post "permanent_freeze_comment/:id", to: "frozen_posts#permanent_freeze_comment", as: :permanent_freeze_comment
+        delete "destroy_stage/:id", to: "frozen_posts#destroy_stage", as: :destroy_stage
+        delete "destroy_comment/:id", to: "frozen_posts#destroy_comment", as: :destroy_comment
+      end
+    end
   end
 end

data/lib/generators/rails_image_post_solution/install/README

@@ -22,6 +22,6 @@ Next steps:
      # Your implementation
    end
 
-For more information, see: https://github.com/your-username/rails-image-post-solution
+For more information, see: https://github.com/dhq-boiler/rails-image-post-solution
 
 ===============================================================================

data/lib/rails_image_post_solution/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsImagePostSolution
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-image-post-solution
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - dhq_boiler