zen_admin 0.9.2

data/config/locales/zh-CN.yml

@@ -0,0 +1,110 @@
+zh-CN:
+  zen_admin:
+    ui:
+      search: "搜索"
+      show_limit: "显示"
+      items_per_page: "条"
+      no_data: "暂无数据。"
+      list_suffix: "列表"
+      actions: "操作"
+      confirm_delete: "确认删除吗？"
+      confirm_bulk_delete: "确认删除选中的 {count} 条数据吗？"
+      select_all: "全选"
+      close: "关闭"
+      save: "保存"
+      cancel: "取消"
+      errors: "错误！"
+      related_records: "相关记录"
+      no_related_records: "暂无相关记录。"
+      click_to_upload: "点击上传 %{field}"
+      change_image: "点击更换预览图"
+      multi_select_help: "按住 Ctrl (或 Command) 可选择多个"
+    actions:
+      new: "新增 %{resource}"
+      view: "查看"
+      edit: "编辑"
+      delete: "删除"
+      bulk_delete: "批量删除"
+      copy: "复制"
+      restore: "还原"
+      move_to_trash: "移至回收站"
+    messages:
+      created: "成功创建了 %{resource}。"
+      updated: "成功更新了 %{resource}。"
+      destroyed: "成功删除了 %{resource}。"
+      bulk_destroyed: "成功批量删除了 %{count} 条记录。"
+      restored: "成功还原了 %{resource}。"
+      moved_to_trash: "已将 %{resource} 移至回收站。"
+    
+    # 内置核心资源定义
+    builtin:
+      assets: "文件资源库"
+      attachments: "系统自动附件"
+      attachment_info: "这里列出了系统中所有通过 ActiveStorage 自动关联的附件（如富文本插图等）。"
+
+    models:
+      # 映射 ActiveStorage 关联
+      "active_storage/attachment":
+        one: "系统自动附件"
+        other: "系统自动附件"
+        fields:
+          id: "预览"
+          record_type: "所属模型"
+          name: "字段名"
+          blob_filename: "原始文件名"
+          blob_id: "复制链接"
+          record: "来源对象"
+          blob: "原始文件"
+      # 映射内置资产模型
+      asset:
+        one: "文件资源库"
+        other: "文件资源库"
+        fields:
+          file: "预览"
+          name: "文件名称/备注"
+          id: "复制链接"
+          created_at: "上传时间"
+      user:
+        one: "系统用户"
+        other: "系统用户"
+        fields:
+          username: "用户名"
+          password: "密码"
+          roles: "角色"
+          created_at: "创建时间"
+      role:
+        one: "角色管理"
+        other: "角色管理"
+        fields:
+          name: "角色名称"
+          code: "标识符"
+          permissions: "拥有权限"
+          permission_ids: "权限分配"
+      permission:
+        one: "权限点"
+        other: "权限点"
+        fields:
+          name: "权限名称"
+          code: "标识符"
+      audit_log:
+        one: "操作审计"
+        other: "操作审计"
+        fields:
+          admin_username: "操作员"
+          resource_type: "资源类型"
+          resource_id: "ID"
+          action: "操作"
+          created_at: "时间"
+          changes_data: "数据变更"
+          ip_address: "IP地址"
+      trash_item:
+        one: "回收站记录"
+        other: "回收站记录"
+
+  views:
+    pagination:
+      first: "首页"
+      last: "末页"
+      previous: "上一页"
+      next: "下一页"
+      truncate: "..."

data/config/routes.rb

@@ -0,0 +1,24 @@
+ZenAdmin::Engine.routes.draw do
+  next unless ZenAdmin.configuration.enable_ui
+
+  # 1. 静态路由优先级最高 (防止被作为资源名匹配)
+  get    "login",  to: "sessions#new",     as: :login
+  post   "login",  to: "sessions#create"
+  delete "logout", to: "sessions#destroy", as: :logout
+  root to: "dashboard#index"
+
+  # 2. 动态资源路由 (直接挂载在 / 下)
+  # /admin/posts, /admin/posts/5, etc.
+  scope ":resource_name", module: "ui" do
+    post "bulk_action", to: "resources#bulk_action", as: :ui_resource_bulk_action
+    post ":id/member_action", to: "resources#member_action", as: :ui_resource_member_action
+    post ":id/restore", to: "resources#restore", as: :ui_resource_restore
+    delete "empty_trash", to: "resources#empty_trash", as: :ui_resource_empty_trash
+    
+    resources :resources, 
+              as: :ui_resource, 
+              path: "", 
+              only: [:index, :new, :create, :edit, :update, :show, :destroy],
+              param: :id
+  end
+end

data/lib/generators/zen_admin/admin_user/admin_user_generator.rb

@@ -0,0 +1,55 @@
+module ZenAdmin
+  module Generators
+    class AdminUserGenerator < Rails::Generators::Base
+      desc "创建 ZenAdmin 管理员账号"
+
+      def create_admin_user
+        username = ask("请输入用户名 [admin]:")
+        username = "admin" if username.blank?
+
+        # 检查用户是否已存在
+        if ZenAdmin::User.exists?(username: username)
+          say "错误: 用户 '#{username}' 已存在。", :red
+          return
+        end
+
+        password = ask_password("请输入密码:")
+        
+        # 简单强度校验：长度小于 8 位
+        if password.length < 8
+          say "提示: 密码长度小于 8 位，安全性较低。", :yellow
+          unless yes?("确定要使用这个弱密码吗？(y/n)")
+            password = ask_password("请重新输入更强的密码:")
+          end
+        end
+
+        begin
+          user = ZenAdmin::User.new(username: username, password: password)
+          
+          # 自动确保“超级管理员”角色存在
+          admin_role = ZenAdmin::Role.find_or_create_by!(code: "superadmin") do |r|
+            r.name = "超级管理员"
+          end
+          
+          user.roles << admin_role
+          say "已分配超级管理员权限。", :green
+
+          if user.save
+            say "成功: 管理员 '#{username}' 已创建！", :green
+          else
+            say "保存失败: #{user.errors.full_messages.join(', ')}", :red
+          end
+        rescue => e
+          say "发生异常: #{e.message}", :red
+        end
+      end
+
+      private
+
+      def ask_password(prompt)
+        # echo: false 隐藏输入，安全性更好
+        ask(prompt, echo: false)
+      end
+    end
+  end
+end

data/lib/generators/zen_admin/install/install_generator.rb

@@ -0,0 +1,50 @@
+require "rails/generators/active_record"
+
+module ZenAdmin
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      source_root File.expand_path("templates", __dir__)
+
+      desc "安装 ZenAdmin 基础配置（硬编码登录模式）"
+
+      def copy_initializer
+        template "zen_admin.rb", "config/initializers/zen_admin.rb"
+      end
+
+      def copy_migrations
+        migration_template "create_zen_admin_assets.rb.erb", "db/migrate/create_zen_admin_assets.rb"
+        migration_template "create_zen_admin_audit_logs.rb.erb", "db/migrate/create_zen_admin_audit_logs.rb"
+        migration_template "create_zen_admin_trash_items.rb.erb", "db/migrate/create_zen_admin_trash_items.rb"
+      end
+
+      def copy_models
+        template "asset.rb", "app/models/zen_admin/asset.rb"
+      end
+
+      def copy_locales
+        template "zh-CN.yml", "config/locales/zen_admin.zh-CN.yml"
+      end
+
+      def install_dependencies
+        say "正在安装 Action Text 和 Active Storage 依赖...", :yellow
+        rails_command "action_text:install"
+        # 注意: action_text:install 也会顺带安装 active_storage:install
+      end
+
+      def add_routes
+        route 'mount ZenAdmin::Engine => "/admin"'
+      end
+
+      def show_readme
+        say "\nZenAdmin 基础配置安装成功！", :green
+        say "你可以通过 config/initializers/zen_admin.rb 修改默认账号密码。", :yellow
+        say "接下来请运行: ", :yellow
+        say "  bin/rails db:migrate", :white
+        say "直接访问 /admin 使用硬编码方式登录。", :white
+        say "\n如果你需要基于数据库的角色权限管理，请运行：", :yellow
+        say "  bin/rails g zen_admin:rbac_install", :white
+      end
+    end
+  end
+end

data/lib/generators/zen_admin/install/templates/asset.rb

@@ -0,0 +1,46 @@
+module ZenAdmin
+  class Asset < ApplicationRecord
+    self.table_name = "zen_admin_assets"
+    has_one_attached :file
+
+    zen_admin do |resource|
+      resource.label :'zen_admin.builtin.assets', :'zen_admin.builtin.assets'
+      resource.menu label: :'zen_admin.builtin.assets', icon: "fas fa-images", position: 99
+      resource.enable_batch_actions
+      resource.batch_action :delete, label: I18n.t('zen_admin.actions.bulk_delete'), type: :danger, confirm: I18n.t('zen_admin.ui.confirm_delete') do |records|
+        records.destroy_all
+      end
+      
+      resource.search do
+        field :name
+      end
+
+      resource.list do
+        field :file, label: "Preview"
+        field :name, label: "Name"
+        field :id, label: I18n.t('zen_admin.actions.copy') do |asset|
+          if asset.file.attached?
+            url = Rails.application.routes.url_helpers.rails_blob_url(asset.file, host: "localhost:3000") rescue "#"
+            render "zen_admin/builtin/copy_button", url: url
+          end
+        end
+        field :created_at, label: "Created At"
+      end
+
+      resource.form do
+        field :name, label: "Name/Note", required: true
+        field :file, label: "File", type: :file
+      end
+
+      resource.show do
+        field :name, label: "Name"
+        field :file, label: "Attachment Details" do |asset|
+          if asset.file.attached?
+            url = Rails.application.routes.url_helpers.rails_blob_url(asset.file, host: "localhost:3000") rescue ""
+            render "zen_admin/builtin/file_link", url: url
+          end
+        end
+      end
+    end
+  end
+end

data/lib/generators/zen_admin/install/templates/create_zen_admin_assets.rb.erb

@@ -0,0 +1,9 @@
+class CreateZenAdminAssets < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :zen_admin_assets do |t|
+      t.string :name
+
+      t.timestamps
+    end
+  end
+end

data/lib/generators/zen_admin/install/templates/create_zen_admin_audit_logs.rb.erb

@@ -0,0 +1,18 @@
+class CreateZenAdminAuditLogs < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :zen_admin_audit_logs do |t|
+      t.string :admin_user_id
+      t.string :admin_username
+      t.string :resource_type
+      t.string :resource_id
+      t.string :action
+      t.text   :note
+      t.json   :changes_data
+      t.string :ip_address
+      t.string :user_agent
+      t.datetime :created_at
+    end
+    add_index :zen_admin_audit_logs, [:resource_type, :resource_id]
+    add_index :zen_admin_audit_logs, :admin_user_id
+  end
+end

data/lib/generators/zen_admin/install/templates/create_zen_admin_rbac.rb.erb

@@ -0,0 +1,57 @@
+class CreateZenAdminRbac < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    # 1. 用户表
+    create_table :zen_admin_users do |t|
+      t.string :username, null: false
+      t.string :password_digest, null: false
+      t.timestamps
+    end
+    add_index :zen_admin_users, :username, unique: true
+
+    # 2. 角色表
+    create_table :zen_admin_roles do |t|
+      t.string :name, null: false
+      t.string :code, null: false
+      t.timestamps
+    end
+    add_index :zen_admin_roles, :name, unique: true
+    add_index :zen_admin_roles, :code, unique: true
+
+    # 3. 权限表
+    create_table :zen_admin_permissions do |t|
+      t.string :name, null: false
+      t.string :code, null: false
+      t.timestamps
+    end
+    add_index :zen_admin_permissions, :code, unique: true
+
+    # 4. 用户与角色的多对多中间表
+    create_table :zen_admin_users_roles, id: false do |t|
+      t.belongs_to :user, null: false, foreign_key: { to_table: :zen_admin_users }
+      t.belongs_to :role, null: false, foreign_key: { to_table: :zen_admin_roles }
+    end
+    add_index :zen_admin_users_roles, [:user_id, :role_id], unique: true
+
+    # 5. 角色与权限的多对多中间表
+    create_table :zen_admin_roles_permissions, id: false do |t|
+      t.belongs_to :role, null: false, foreign_key: { to_table: :zen_admin_roles }
+      t.belongs_to :permission, null: false, foreign_key: { to_table: :zen_admin_permissions }
+    end
+    add_index :zen_admin_roles_permissions, [:role_id, :permission_id], unique: true
+
+    # 6. 审计日志表
+    create_table :zen_admin_audit_logs do |t|
+      t.string :admin_user_id # 支持硬编码或数据库用户
+      t.string :admin_username
+      t.string :resource_type
+      t.string :resource_id
+      t.string :action
+      t.json   :changes_data
+      t.string :ip_address
+      t.string :user_agent
+      t.datetime :created_at
+    end
+    add_index :zen_admin_audit_logs, [:resource_type, :resource_id]
+    add_index :zen_admin_audit_logs, :admin_user_id
+  end
+end

data/lib/generators/zen_admin/install/templates/create_zen_admin_trash_items.rb.erb

@@ -0,0 +1,13 @@
+class CreateZenAdminTrashItems < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :zen_admin_trash_items do |t|
+      t.string :resource_type, null: false
+      t.string :resource_id,   null: false
+      t.string :resource_label
+      t.json   :data
+      t.string :admin_username
+      t.datetime :created_at
+    end
+    add_index :zen_admin_trash_items, [:resource_type, :resource_id]
+  end
+end

data/lib/generators/zen_admin/install/templates/zen_admin.rb

@@ -0,0 +1,17 @@
+ZenAdmin.configure do |config|
+  # 是否开启管理后台 UI
+  config.enable_ui = true
+
+  # 后台访问路径
+  config.admin_path = "/admin"
+
+  # 设置显示时区
+  config.time_zone = "Beijing"
+
+  # 设置默认语言 (zh-CN, en)
+  config.default_locale = :"zh-CN"
+
+  # 默认初始账号（建议在通过指令创建真实用户后修改或删除）
+  config.username = "admin"
+  config.password = "password"
+end

data/lib/generators/zen_admin/install/templates/zh-CN.yml

@@ -0,0 +1,15 @@
+zh-CN:
+  zen_admin:
+    # 核心内置资源翻译
+    builtin:
+      assets: "文件资源库"
+      attachments: "系统自动附件"
+    
+    # 宿主应用业务模型翻译 (示例)
+    models:
+      # post:
+      #   one: "博客文章"
+      #   other: "文章管理"
+      #   fields:
+      #     title: "文章标题"
+      #     status: "发布状态"

data/lib/generators/zen_admin/model/model_generator.rb

@@ -0,0 +1,65 @@
+require "rails/generators/active_record"
+
+module ZenAdmin
+  module Generators
+    class ModelGenerator < Rails::Generators::NamedBase
+      argument :attributes, type: :array, default: [], banner: "field:type field:type"
+      source_root File.expand_path("templates", __dir__)
+
+      def create_model_if_missing
+        path = File.join("app/models", class_path, "#{file_name}.rb")
+        unless File.exist?(path)
+          say "Model #{class_name} not found. Generating it...", :yellow
+          generate "model", "#{class_name} #{attributes.map { |a| "#{a.name}:#{a.type}" }.join(' ')}"
+        end
+      end
+
+      def inject_zen_admin_config
+        path = File.join("app/models", class_path, "#{file_name}.rb")
+        
+        if File.exist?(path)
+          @attrs = derived_attributes
+          
+          # 渲染模板
+          template_path = File.expand_path("templates/zen_admin_config.rb.erb", __dir__)
+          config_content = ERB.new(File.read(template_path), trim_mode: '-').result(binding)
+
+          inject_into_class path, class_name do
+            config_content
+          end
+          
+          say "Successfully integrated ZenAdmin DSL into #{class_name}", :green
+        else
+          say "Error: Model file #{path} not found.", :red
+        end
+      end
+
+      private
+
+      # 获取模型属性，用于自动填充 list/form
+      def derived_attributes
+        if attributes.any?
+          attributes
+        else
+          begin
+            # 尝试从数据库加载（如果模型已存在）
+            klass = class_name.safe_constantize
+            if klass && klass < ActiveRecord::Base
+              columns = klass.columns.reject { |c| %w[id created_at updated_at deleted_at].include?(c.name) }
+              columns.map { |c| Rails::Generators::GeneratedAttribute.new(c.name, c.type.to_s) }
+            else
+              []
+            end
+          rescue
+            []
+          end
+        end
+      end
+
+      # 内部绑定使用的变量
+      def attrs
+        @attrs || []
+      end
+    end
+  end
+end

data/lib/generators/zen_admin/model/templates/zen_admin_config.rb.erb

@@ -0,0 +1,80 @@
+
+  # ZenAdmin 资源配置
+  zen_admin do |resource|
+    # 1. 基础信息配置
+    resource.label "<%= class_name %>", "<%= class_name.pluralize %>"
+    # group: 菜单分组名称，支持自动折叠
+    resource.menu label: "<%= class_name.pluralize.titleize %>", icon: "fas fa-circle", position: 10, visible: true, group: "应用管理"
+    
+    # 2. 功能特性开关
+    resource.enable_batch_actions  # 开启批量操作 (默认包含批量删除)
+    resource.exportable!           # 开启 CSV 导出功能
+    # resource.soft_delete = true  # 开启回收站 (默认开启，设为 false 则为物理删除)
+
+    # 3. 快捷页签 (Scopes)
+    # 静态页签示例 (支持 Ransack 查询语法: _eq, _cont, _gteq 等)
+    resource.scope :all, label: "全部", default: true
+    # resource.scope :recent, label: "最近一周", query: { created_at_gteq: 1.week.ago }
+    
+    # 动态页签示例 (从数据库加载)
+    # resource.scope do
+    #   Category.all.map { |cat| { name: "cat_#{cat.id}", label: cat.name, query: { category_id_eq: cat.id } } }
+    # end
+
+    # 4. 自定义批量操作 (Batch Actions)
+    # resource.batch_action :verify, label: "批量审核", type: :success, method: :bulk_verify_method
+    # resource.batch_action :archive, label: "批量归档", handler: ->(records) {
+    #   records.update_all(archived: true)
+    #   # 记录审计日志: zen_admin_audit(资源类, 动作名, note: 说明, changes: 数据)
+    #   zen_admin_audit(<%= class_name %>, "archive", note: "批量归档操作", changes: { ids: records.ids })
+    # }
+
+    # 5. 单条记录操作 (Member Actions)
+    # resource.member_action :copy, label: "复制", icon: "fas fa-copy", type: :info, method: :copy_instance_method
+    # resource.member_action :highlight, label: "精选", handler: ->(record) { record.touch }
+
+    # 6. 列表页字段定义 (List View)
+    resource.list do
+      field :id, sortable: true
+<% attrs.each do |a| -%>
+      field :<%= a.name %>, label: "<%= a.name.humanize %>"
+<% end -%>
+      field :created_at, label: "创建时间", sortable: true
+      # 自定义渲染示例
+      # field :status, collection: [["草稿", "draft"], ["发布", "published"]] do |record, label|
+      #   css = record.status == 'published' ? 'success' : 'secondary'
+      #   content_tag :span, label, class: "badge bg-#{css}"
+      # end
+    end
+
+    # 7. 高级筛选面板 (Filters)
+    resource.filters do
+<% attrs.select { |a| [:string, :text, :integer, :date, :datetime].include?(a.type.to_sym) }.each do |a| -%>
+      field :<%= a.name %>, label: "<%= a.name.humanize %>", type: :<%= a.type %>
+<% end -%>
+      field :created_at, type: :date_range, label: "时间范围"
+      # 支持类型: :string, :select, :date_range
+    end
+
+    # 8. 表单页字段定义 (Form View)
+    resource.form do
+<% attrs.each do |a| -%>
+      field :<%= a.name %>, label: "<%= a.name.humanize %>", type: :<%= a.type == "datetime" ? "date" : a.type %>
+<% end -%>
+      # 常用类型参考:
+      # :string, :text, :password, :number, :email, :date, :datetime
+      # :file (ActiveStorage), :rich_text (ActionText)
+      # :select (单选), :multi_select (多选), :radio (单选组)
+      # 示例:
+      # field :author_id, type: :select, collection: -> { Author.all.map{|a| [a.name, a.id]} }
+    end
+
+    # 9. 详情页字段定义 (Show View - 默认自动发现所有字段)
+    # resource.show do
+    #   field :id
+    #   field :created_at
+    #   field :cover_image do |record|
+    #     image_tag url_for(record.cover_image) if record.cover_image.attached?
+    #   end
+    # end
+  end

data/lib/generators/zen_admin/rbac_install/rbac_install_generator.rb

@@ -0,0 +1,52 @@
+require "rails/generators/active_record"
+
+module ZenAdmin
+  module Generators
+    class RbacInstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      source_root File.expand_path("templates", __dir__)
+
+      desc "安装 ZenAdmin RBAC 数据库支持"
+
+      def invoke_base_install
+        invoke "zen_admin:install"
+      end
+
+      def copy_migrations
+        migration_template "create_zen_admin_rbac.rb.erb", "db/migrate/create_zen_admin_rbac.rb"
+      end
+
+      def enable_rbac_config
+        path = "config/initializers/zen_admin.rb"
+        if File.exist?(path)
+          # 如果已经存在，则更新为 true
+          if File.read(path).include?("config.rbac_enable")
+            gsub_file path, /config\.rbac_enable\s*=\s*.*/, "config.rbac_enable = true"
+          else
+            # 插入在 configure 块的下一行
+            inject_into_file path, after: "ZenAdmin.configure do |config|\n" do
+              <<-RUBY
+  # 开启 RBAC 数据库验证模式
+  config.rbac_enable = true
+              RUBY
+            end
+          end
+        end
+      end
+
+      def add_seeds
+        append_to_file "db/seeds.rb" do
+          ERB.new(File.read(File.expand_path("templates/seeds.rb.erb", __dir__))).result
+        end
+      end
+
+      def show_readme
+        say "\nZenAdmin RBAC 迁移文件已生成！", :green
+        say "接下来请运行: ", :yellow
+        say "  bin/rails db:migrate", :white
+        say "然后创建管理员账号: ", :yellow
+        say "  bin/rails g zen_admin:admin_user", :white
+      end
+    end
+  end
+end

data/lib/generators/zen_admin/rbac_install/templates/create_zen_admin_rbac.rb.erb

@@ -0,0 +1,42 @@
+class CreateZenAdminRbac < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    # 1. 用户表
+    create_table :zen_admin_users do |t|
+      t.string :username, null: false
+      t.string :password_digest, null: false
+      t.timestamps
+    end
+    add_index :zen_admin_users, :username, unique: true
+
+    # 2. 角色表
+    create_table :zen_admin_roles do |t|
+      t.string :name, null: false
+      t.string :code, null: false
+      t.timestamps
+    end
+    add_index :zen_admin_roles, :name, unique: true
+    add_index :zen_admin_roles, :code, unique: true
+
+    # 3. 权限表
+    create_table :zen_admin_permissions do |t|
+      t.string :name, null: false
+      t.string :code, null: false
+      t.timestamps
+    end
+    add_index :zen_admin_permissions, :code, unique: true
+
+    # 4. 用户与角色的多对多中间表
+    create_table :zen_admin_users_roles, id: false do |t|
+      t.belongs_to :user, null: false, foreign_key: { to_table: :zen_admin_users }
+      t.belongs_to :role, null: false, foreign_key: { to_table: :zen_admin_roles }
+    end
+    add_index :zen_admin_users_roles, [:user_id, :role_id], unique: true
+
+    # 5. 角色与权限的多对多中间表
+    create_table :zen_admin_roles_permissions, id: false do |t|
+      t.belongs_to :role, null: false, foreign_key: { to_table: :zen_admin_roles }
+      t.belongs_to :permission, null: false, foreign_key: { to_table: :zen_admin_permissions }
+    end
+    add_index :zen_admin_roles_permissions, [:role_id, :permission_id], unique: true
+  end
+end

data/lib/generators/zen_admin/rbac_install/templates/seeds.rb.erb

@@ -0,0 +1,13 @@
+# ZenAdmin RBAC 初始数据
+puts "正在初始化 ZenAdmin RBAC 数据..."
+
+# 1. 创建基础权限 (可选，这里可以先空着让用户通过后台加)
+
+# 2. 创建超级管理员角色
+admin_role = ZenAdmin::Role.find_or_create_by!(code: "superadmin") do |r|
+  r.name = "超级管理员"
+end
+
+# 3. 如果有需要，可以给角色分配所有权限 (这里逻辑可以在后台手动操作，或写一个通配符逻辑)
+
+puts "ZenAdmin RBAC 数据初始化完成！"