add audience as prefill to template creation

* this is primarily for conversion from ATS to Docuseal, since these fields would normally just be updated through the Docuseal iframe itself

Author: ryanarakawa

app/controllers/api/templates_controller.rb

@@ -85,8 +85,11 @@ def destroy
       render json: @template.as_json(only: %i[id archived_at])
     end
 
+    VALID_AUDIENCE_VALUES = %w[single_sided employee_then_manager manager_then_employee simultaneous].freeze
+
     def pdf
       template = build_template
+      audience = params[:audience]
       fields_from_request = params[:fields] if params[:fields].present?
 
       template.save!
@@ -99,6 +102,8 @@ def pdf
 
         template.update!(schema: schema)
 
+        apply_audience(template, audience)
+
         finalize_template_creation(template, documents)
       rescue StandardError => e
         template.destroy!
@@ -201,6 +206,13 @@ def map_request_fields_to_documents(fields_from_request, documents)
       end
     end
 
+    def apply_audience(template, audience)
+      return if audience.blank?
+      return unless audience.in?(VALID_AUDIENCE_VALUES)
+
+      template.update!(preferences: template.preferences.merge('submitters_order' => audience))
+    end
+
     def finalize_template_creation(template, documents)
       enqueue_template_created_webhooks(template)
       SearchEntries.enqueue_reindex(template)
@@ -252,7 +264,7 @@ def template_params
           external_data_fields: {},
           submitters: [%i[name uuid is_requester invite_by_uuid optional_invite_by_uuid linked_to_uuid email]],
           fields: [[:uuid, :question_id, :submitter_uuid, :name, :type,
-                    :required, :readonly, :default_value,
+                    :required, :readonly, :default_value, :prefill,
                     :title, :description,
                     { preferences: {},
                       conditions: [%i[field_uuid value action operation]],

spec/requests/templates_spec.rb

@@ -150,6 +150,85 @@
     end
   end
 
+  describe 'POST /api/templates/pdf' do
+    let(:pdf_base64) { Base64.strict_encode64(Rails.root.join('spec/fixtures/sample-document.pdf').read) }
+    let(:base_params) do
+      {
+        name: 'Test Template',
+        documents: [{ name: 'sample-document.pdf', file: pdf_base64 }]
+      }
+    end
+
+    it 'creates a template with audience set as submitters_order' do
+      post '/api/templates/pdf',
+           headers: { 'x-auth-token': author.access_token.token },
+           params: base_params.merge(audience: 'manager_then_employee').to_json,
+           env: { 'CONTENT_TYPE' => 'application/json' }
+
+      expect(response).to have_http_status(:ok)
+
+      template = Template.last
+      expect(template.preferences['submitters_order']).to eq('manager_then_employee')
+    end
+
+    it 'creates a template with simultaneous audience' do
+      post '/api/templates/pdf',
+           headers: { 'x-auth-token': author.access_token.token },
+           params: base_params.merge(audience: 'simultaneous').to_json,
+           env: { 'CONTENT_TYPE' => 'application/json' }
+
+      expect(response).to have_http_status(:ok)
+      expect(Template.last.preferences['submitters_order']).to eq('simultaneous')
+    end
+
+    it 'ignores audience when not provided' do
+      post '/api/templates/pdf',
+           headers: { 'x-auth-token': author.access_token.token },
+           params: base_params.to_json,
+           env: { 'CONTENT_TYPE' => 'application/json' }
+
+      expect(response).to have_http_status(:ok)
+      expect(Template.last.preferences['submitters_order']).to eq('single_sided')
+    end
+
+    it 'ignores an invalid audience value' do
+      post '/api/templates/pdf',
+           headers: { 'x-auth-token': author.access_token.token },
+           params: base_params.merge(audience: 'invalid_value').to_json,
+           env: { 'CONTENT_TYPE' => 'application/json' }
+
+      expect(response).to have_http_status(:ok)
+      expect(Template.last.preferences['submitters_order']).to eq('single_sided')
+    end
+
+    it 'stores prefill attribute on fields' do
+      employee_uuid = SecureRandom.uuid
+      fields = [
+        {
+          uuid: SecureRandom.uuid,
+          submitter_uuid: employee_uuid,
+          name: 'First Name',
+          type: 'text',
+          prefill: 'employee_first_name',
+          areas: [{ x: 0.1, y: 0.1, w: 0.2, h: 0.03, page: 0 }]
+        }
+      ]
+
+      post '/api/templates/pdf',
+           headers: { 'x-auth-token': author.access_token.token },
+           params: base_params.merge(
+             submitters: [{ name: 'Employee', uuid: employee_uuid }],
+             fields:
+           ).to_json,
+           env: { 'CONTENT_TYPE' => 'application/json' }
+
+      expect(response).to have_http_status(:ok)
+
+      stored_field = Template.last.fields.find { |f| f['name'] == 'First Name' }
+      expect(stored_field['prefill']).to eq('employee_first_name')
+    end
+  end
+
   describe 'POST /api/templates/:id/clone' do
     it 'clones a template' do
       template = create(:template, account:,