card_requests.rb

[geekelo]

FILE

ActiveAdmin.register Card::Request do
  actions :all, except: :destroy
  menu parent: 'Cards', label: 'Requests'
  includes :user, :processing_fee

  permit_params :status, :external_id

  index do
    selectable_column
    id_column
    column :user
    column :card_type
    column :card_network
    column :external_id, label: 'External ID'
    column :status
    column :phone_number do |cr|
      cr.phone_number
    end
    column :provider_fee do |cr|
      cr.total_provider_fee
    end
    column :bananacrystal_fee do |cr|
      cr.total_bananacrystal_fee
    end
    column :total_fee do |cr|
      cr.total_fee
    end
    column :created_at
    column :confirmed_at
    actions
  end

  show do
    attributes_table do
      row :id
      row :user
      row :processing_fee
      row :provider_fee do |cr|
        cr.total_provider_fee
      end
      row :bananacrystal_fee do |cr|
        cr.total_bananacrystal_fee
      end
      row :total_fee do |cr|
        cr.total_fee
      end
      row :salutation
      row :card_type
      row :card_network
      row :external_id, label: 'External ID'
      row :status
      row :gender
      row :marital_status do |cr|
        cr.marital_status
      end
      row :phone_number do |cr|
        cr.phone_number
      end
      row :emergency_contact_name do |cr|
        cr.emergency_contact_name
      end
      row :emergency_contact_phone_number do |cr|
        cr.emergency_contact_phone_number
      end
      row :id_type
      row :passport_number do |cr|
        cr.passport_number
      end
      row :passport_issued_date do |cr|
        cr.passport_issued_date
      end
      row :passport_expiry_date do |cr|
        cr.passport_expiry_date
      end
      row :passport_issued_by do |cr|
        cr.passport_issued_by
      end
      row :address do |cr|
        cr.address
      end
      row :city do |cr|
        cr.city
      end
      row :state do |cr|
        cr.state
      end
      row :country do |cr|
        cr.country
      end
      row :postal_code do |cr|
        cr.postal_code
      end
      row :error_data
      row :created_at
      row :updated_at
      row :confirmed_at
      row :passport_bio_page do |cr|
        link_to 'Passport bio page', url_for(cr.passport_bio_page_file), target: '_blank' if cr.passport_bio_page_file&.attached?
      end
      row :passport_bio_selfie do |cr|
        link_to 'Passport bio with selfie', url_for(cr.passport_with_selfie_file), target: '_blank' if cr.passport_with_selfie_file&.attached?
      end
      row :digital_signature do |cr|
        link_to 'Digital Signature', url_for(cr.digital_signature_file), target: '_blank' if cr.digital_signature_file&.attached?
      end
    end
  end

  form do |f|
    f.inputs do
      unless Rails.env.production?
        f.input :external_id, label: 'External ID'
      end
      f.input :status, as: :select, collection: SetStatus::STATUS.values
    end
    f.actions
  end
end

[geekelo]

This file defines the ActiveAdmin interface for managing Card::Request records. It provides a comprehensive setup to handle the display, editing, and creation of card requests, while excluding the delete (destroy) action.

File: card_request.rb

1. Menu Configuration

• menu parent: 'Cards', label: 'Requests'
  • Places the Card::Request records under the "Cards" menu with the label "Requests" in the ActiveAdmin interface.

2. Actions

• actions :all, except: :destroy
  • Enables all standard actions (index, show, edit, new) except for the destroy action, meaning users cannot delete Card::Request records from the admin interface.

3. Includes

• includes :user, :processing_fee
  • Preloads the associated user and processing_fee records to optimize database queries when displaying the index and show pages.

4. Permitted Parameters

• permit_params :status, :external_id
  • Limits the parameters that can be set via forms to status and external_id (if the external_id field is editable in the environment).

5. Index Page

• index do
  • Configures the columns displayed on the index page for Card::Request records.
• column :user
  • Displays the associated user.
• column :card_type
  • Displays the type of card requested.
• column :card_network
  • Displays the network of the card (e.g., Visa, MasterCard).
• column :external_id, label: 'External ID'
  • Displays the external ID of the card request.
• column :status
  • Displays the status of the card request.
• column :phone_number do |cr| cr.phone_number end
  • Displays the phone number associated with the card request.
• column :provider_fee do |cr| cr.total_provider_fee end
  • Displays the total provider fee for the card request.
• column :bananacrystal_fee do |cr| cr.total_bananacrystal_fee end
  • Displays the total Bananacrystal fee.
• column :total_fee do |cr| cr.total_fee end
  • Displays the total fee (provider fee + Bananacrystal fee).
• column :created_at
  • Displays the creation date of the card request.
• column :confirmed_at
  • Displays the date when the card request was confirmed.

6. Show Page

• show do
  • Configures the attributes displayed on the show page for a Card::Request record.
• attributes_table do
  • Uses an attributes table to organize the details of the card request.
• The table includes:
  • Personal details: id, user, salutation, gender, marital_status, phone_number, etc.
  • Card details: card_type, card_network, external_id, status.
  • Fee details: processing_fee, provider_fee, bananacrystal_fee, total_fee.
  • Document links: Links to downloadable files such as passport_bio_page, passport_bio_selfie, and digital_signature if they are attached.
• row :passport_bio_page do |cr| ... end
  • Generates a link to the passport bio page if the file is attached.

7. Form

• form do |f|
  • Configures the form for editing and creating Card::Request records.
• unless Rails.env.production? ... end
  • Displays the external_id field only if the environment is not production.
• f.input :status, as: :select, collection: SetStatus::STATUS.values
  • Provides a dropdown selection for the status field using predefined status values.

Summary:

• This ActiveAdmin setup provides a detailed interface for managing Card::Request records.
• The index view offers a summary of key information, while the show view presents a detailed breakdown, including personal details, fees, and attached documents.
• The form allows editing of the status and, conditionally, the external_id, ensuring that users have the necessary control without risking accidental deletion of records.

This setup is tailored for administrators to effectively manage card requests with a focus on security, data integrity, and user convenience.