<%= render "form_submissions/submission", submission: @form_submission %>
- <% if event && @form_submission.role == "bulk_payment" %>
+ <% if event && @form_submission.role == "bulk_payment" && @form_submission.slug.present? %>
- <%= link_to event_invoice_path(event, submission_id: @form_submission.id, return_to: "form_submission"),
+ <%= link_to bulk_payment_invoice_path(@form_submission.slug, return_to: "form_submission"),
class: "inline-flex items-center gap-2 rounded-lg border border-gray-300 bg-white px-4 py-2 text-sm font-medium text-gray-700 shadow-sm hover:bg-gray-50 transition-colors" do %>
View invoice
<% end %>
diff --git a/config/routes.rb b/config/routes.rb
index 189c537e1f..d228a4631a 100644
--- a/config/routes.rb
+++ b/config/routes.rb
@@ -74,6 +74,8 @@
end
resources :community_news
get "bulk_payment/:slug", to: "events/bulk_payment_form_submissions#ticket", as: :bulk_payment_ticket
+ get "bulk_payment/:slug/invoice", to: "events/bulk_payment_form_submissions#invoice", as: :bulk_payment_invoice
+ get "bulk_payment/:slug/receipt", to: "events/bulk_payment_form_submissions#receipt", as: :bulk_payment_receipt
post "bulk_payment/:slug/resend_confirmation", to: "events/bulk_payment_form_submissions#resend_confirmation", as: :bulk_payment_resend_confirmation
get "registration/:slug", to: "events/registrations#show", as: :registration_ticket
get "registration/:slug/invoice", to: "events/registrations#invoice", as: :registration_invoice
diff --git a/spec/models/form_submission_spec.rb b/spec/models/form_submission_spec.rb
index 5bf4101b67..06637a9969 100644
--- a/spec/models/form_submission_spec.rb
+++ b/spec/models/form_submission_spec.rb
@@ -81,6 +81,27 @@
end
end
+ describe "#bulk_payment_receipt_available?" do
+ let(:submission) { create(:form_submission, role: "bulk_payment") }
+
+ it "is true once a payment is recorded" do
+ create(:payment, form_submission: submission)
+
+ expect(submission.reload.bulk_payment_receipt_available?).to be(true)
+ end
+
+ it "is false while no payment is on file" do
+ expect(submission.bulk_payment_receipt_available?).to be(false)
+ end
+
+ it "is false for a non-bulk-payment submission even with a payment" do
+ other = create(:form_submission, role: "registration")
+ create(:payment, form_submission: other)
+
+ expect(other.reload.bulk_payment_receipt_available?).to be(false)
+ end
+ end
+
describe "linked registrations" do
let(:event) { create(:event) }
let(:form) { create(:form) }
diff --git a/spec/policies/form_submission_policy_spec.rb b/spec/policies/form_submission_policy_spec.rb
index 161b02f7f8..6a64f854e8 100644
--- a/spec/policies/form_submission_policy_spec.rb
+++ b/spec/policies/form_submission_policy_spec.rb
@@ -96,4 +96,74 @@ def policy_for(user:, record: submission)
it { is_expected.not_to be_allowed_to(:ticket?) }
end
end
+
+ describe "#invoice?" do
+ context "with admin user" do
+ subject { policy_for(user: admin_user) }
+
+ it { is_expected.to be_allowed_to(:invoice?) }
+ end
+
+ context "with regular user and matching slug" do
+ let(:submission) { build_stubbed(:form_submission).tap { |s| s.slug = "abc123" } }
+ subject { described_class.new(submission, user: regular_user, slug: "abc123") }
+
+ it { is_expected.to be_allowed_to(:invoice?) }
+ end
+
+ context "with regular user and non-matching slug" do
+ let(:submission) { build_stubbed(:form_submission).tap { |s| s.slug = "abc123" } }
+ subject { described_class.new(submission, user: regular_user, slug: "wrong") }
+
+ it { is_expected.not_to be_allowed_to(:invoice?) }
+ end
+
+ context "with no user and matching slug" do
+ let(:submission) { build_stubbed(:form_submission).tap { |s| s.slug = "abc123" } }
+ subject { described_class.new(submission, user: nil, slug: "abc123") }
+
+ it { is_expected.to be_allowed_to(:invoice?) }
+ end
+
+ context "with no user" do
+ subject { policy_for(user: nil) }
+
+ it { is_expected.not_to be_allowed_to(:invoice?) }
+ end
+ end
+
+ describe "#receipt?" do
+ context "with admin user" do
+ subject { policy_for(user: admin_user) }
+
+ it { is_expected.to be_allowed_to(:receipt?) }
+ end
+
+ context "with regular user and matching slug" do
+ let(:submission) { build_stubbed(:form_submission).tap { |s| s.slug = "abc123" } }
+ subject { described_class.new(submission, user: regular_user, slug: "abc123") }
+
+ it { is_expected.to be_allowed_to(:receipt?) }
+ end
+
+ context "with regular user and non-matching slug" do
+ let(:submission) { build_stubbed(:form_submission).tap { |s| s.slug = "abc123" } }
+ subject { described_class.new(submission, user: regular_user, slug: "wrong") }
+
+ it { is_expected.not_to be_allowed_to(:receipt?) }
+ end
+
+ context "with no user and matching slug" do
+ let(:submission) { build_stubbed(:form_submission).tap { |s| s.slug = "abc123" } }
+ subject { described_class.new(submission, user: nil, slug: "abc123") }
+
+ it { is_expected.to be_allowed_to(:receipt?) }
+ end
+
+ context "with no user" do
+ subject { policy_for(user: nil) }
+
+ it { is_expected.not_to be_allowed_to(:receipt?) }
+ end
+ end
end
diff --git a/spec/presenters/event_receipt_spec.rb b/spec/presenters/event_receipt_spec.rb
index 0d9f0dede9..659537469b 100644
--- a/spec/presenters/event_receipt_spec.rb
+++ b/spec/presenters/event_receipt_spec.rb
@@ -91,4 +91,88 @@
end
end
end
+
+ describe ".from_bulk_payment" do
+ let(:event) { create(:event, title: "AWBW 2-Day Art Facilitator Training", cost_cents: 150_000) }
+ let(:submitter) { create(:person, first_name: "Sam", last_name: "Submitter") }
+ let(:form) { create(:form) }
+ let(:submission) { create(:form_submission, person: submitter, form: form, event: event, role: "bulk_payment") }
+
+ def answer(identifier, value)
+ field = create(:form_field, form: form, answer_type: :free_form_input_one_line, field_identifier: identifier, name: identifier)
+ submission.form_answers.create!(form_field: field, submitted_answer: value, question_name_when_answered: identifier)
+ end
+
+ before do
+ answer("number_of_attendees", "3")
+ # Form-captured payer fields that must NOT drive the receipt: the connected
+ # payment's payer is authoritative (an admin may record it against someone
+ # other than the form submitter).
+ answer("payer_first_name", "Sam")
+ answer("payer_last_name", "Submitter")
+ answer("payer_organization", "Someone Else Inc")
+ end
+
+ context "when an organization paid" do
+ let(:organization) { create(:organization, name: "Northside Shelter", email: "billing@northside.org") }
+ let(:contact) { create(:person, first_name: "Dana", last_name: "Okafor") }
+
+ before do
+ create(:address, addressable: organization, street_address: "12 Main St", city: "Denver", state: "CO", zip_code: "80202")
+ create(:payment, form_submission: submission, organization: organization, person: contact,
+ payer_type: "Organization", type: "CashPayment", amount_cents: 450_000)
+ end
+
+ it "bills the payment's organization payer, not the form submitter" do
+ receipt = described_class.from_bulk_payment(submission.reload)
+
+ expect(receipt.number).to eq("RCPT-B-#{submission.id}")
+ expect(receipt.bill_to_name).to eq("Northside Shelter")
+ expect(receipt.bill_to_email).to eq("billing@northside.org")
+ expect(receipt.attention).to eq("Dana Okafor")
+ expect(receipt.client_id).to eq(organization.id)
+ expect(receipt.bill_to_address_lines).to eq([ "12 Main St", "Denver, CO 80202" ])
+ end
+
+ it "itemizes the event charge per attendee and records the amount paid" do
+ receipt = described_class.from_bulk_payment(submission.reload)
+
+ item = receipt.line_items.first
+ expect(item.description).to eq("AWBW 2-Day Art Facilitator Training")
+ expect(item.quantity).to eq(3)
+ expect(item.unit_price_cents).to eq(150_000)
+ expect(receipt.amount_paid_cents).to eq(450_000)
+ # A bulk payment records what was paid; it has no owed-balance concept.
+ expect(receipt.settles_balance?).to be(false)
+ end
+ end
+
+ context "when a person paid" do
+ let(:payer) { create(:person, first_name: "Alex", last_name: "Payer") }
+
+ before do
+ create(:payment, form_submission: submission, person: payer, organization: nil,
+ payer_type: "Person", type: "CheckPayment", amount_cents: 450_000, check_number: "7788")
+ end
+
+ it "bills the paying person directly" do
+ receipt = described_class.from_bulk_payment(submission.reload)
+
+ expect(receipt.bill_to_name).to eq("Alex Payer")
+ expect(receipt.attention).to eq("Alex Payer")
+ expect(receipt.bill_to_email).to eq(payer.preferred_email)
+ expect(receipt.client_id).to eq(payer.id)
+ end
+
+ it "records the payment as the one ledger entry, labelled by method" do
+ receipt = described_class.from_bulk_payment(submission.reload)
+
+ expect(receipt.entries.size).to eq(1)
+ entry = receipt.entries.first
+ expect(entry.method).to eq("Check")
+ expect(entry.reference).to eq("Check #7788")
+ expect(entry.amount_cents).to eq(450_000)
+ end
+ end
+ end
end
diff --git a/spec/requests/events/bulk_payment_form_submissions_spec.rb b/spec/requests/events/bulk_payment_form_submissions_spec.rb
index abc0d38691..7a66902f84 100644
--- a/spec/requests/events/bulk_payment_form_submissions_spec.rb
+++ b/spec/requests/events/bulk_payment_form_submissions_spec.rb
@@ -308,6 +308,22 @@ def get_ticket
expect(response.body).to include(event_bulk_payment_path(event, slug: submission.slug))
end
+ it "shows a locked receipt card until a payment is recorded" do
+ get_ticket
+
+ expect(response.body).to include("Available once your payment is received")
+ expect(response.body).not_to include(bulk_payment_receipt_path(submission.slug))
+ end
+
+ it "links the receipt once a payment is on file" do
+ create(:payment, form_submission: submission, type: "CashPayment", amount_cents: 1000)
+
+ get_ticket
+
+ expect(response.body).to include("View receipt")
+ expect(response.body).to include(bulk_payment_receipt_path(submission.slug))
+ end
+
it "returns 404 for an unknown slug" do
get bulk_payment_ticket_path("nope")
@@ -332,6 +348,88 @@ def get_ticket
end
end
+ describe "GET invoice" do
+ let(:event) { create(:event, :publicly_visible, cost_cents: 150_000, title: "Spring Workshop") }
+ let(:payer) { create(:person) }
+ let!(:submission) { create(:form_submission, person: payer, form: form, event: event, role: "bulk_payment") }
+
+ before do
+ # org_field (payer_organization) is defined at the top; only the attendee
+ # count field is new here.
+ count_field = create(:form_field, form: form, field_identifier: "number_of_attendees", name: "Number of attendees")
+ submission.form_answers.create!(form_field: org_field, submitted_answer: "A Greater Hope",
+ question_name_when_answered: "Organization")
+ submission.form_answers.create!(form_field: count_field, submitted_answer: "8",
+ question_name_when_answered: "Number of attendees")
+ sign_out admin
+ end
+
+ it "renders the bulk-payment invoice publicly by slug" do
+ get bulk_payment_invoice_path(submission.slug)
+
+ expect(response).to have_http_status(:success)
+ expect(response.body).to include("INVOICE")
+ expect(response.body).to include("A Greater Hope")
+ # 8 attendees × $1,500 = $12,000
+ expect(response.body).to include("$12,000")
+ end
+
+ it "links back to the ticket when opened from there" do
+ get bulk_payment_invoice_path(submission.slug, return_to: "bulk_payment_ticket")
+
+ expect(response.body).to include(bulk_payment_ticket_path(submission.slug))
+ expect(response.body).to include("Back to ticket")
+ end
+
+ it "returns 404 for an unknown slug (no enumerable id path)" do
+ get bulk_payment_invoice_path("nope")
+
+ expect(response).to have_http_status(:not_found)
+ end
+ end
+
+ describe "GET receipt" do
+ let(:event) { create(:event, :publicly_visible, cost_cents: 1000, title: "Spring Workshop") }
+ let(:payer) { create(:person) }
+ let!(:submission) { create(:form_submission, person: payer, form: form, event: event, role: "bulk_payment") }
+
+ before { sign_out admin }
+
+ it "renders the receipt for the amount paid once a payment is recorded" do
+ create(:payment, form_submission: submission, type: "CashPayment", amount_cents: 1000)
+
+ get bulk_payment_receipt_path(submission.slug)
+
+ expect(response).to have_http_status(:ok)
+ expect(response.body).to include("RECEIPT")
+ expect(response.body).to include("Amount paid")
+ expect(response.body).to include("RCPT-B-#{submission.id}")
+ end
+
+ it "omits the balance/paid-in-full framing (a bulk payment has no owed balance)" do
+ create(:payment, form_submission: submission, type: "CashPayment", amount_cents: 1000)
+
+ get bulk_payment_receipt_path(submission.slug)
+
+ expect(response.body).to include("Payment received")
+ expect(response.body).not_to include("Paid in full")
+ expect(response.body).not_to include("Balance due")
+ end
+
+ it "redirects back to the ticket while payment is still pending" do
+ get bulk_payment_receipt_path(submission.slug)
+
+ expect(response).to redirect_to(bulk_payment_ticket_path(submission.slug))
+ expect(flash[:alert]).to eq("A receipt is available once your payment is received.")
+ end
+
+ it "returns 404 for an unknown slug" do
+ get bulk_payment_receipt_path("nope")
+
+ expect(response).to have_http_status(:not_found)
+ end
+ end
+
describe "POST resend_confirmation" do
let(:event) { create(:event, :publicly_visible, cost_cents: 1000) }
let(:payer) { create(:person, email: "payer@example.com") }
diff --git a/spec/requests/events/invoices_spec.rb b/spec/requests/events/invoices_spec.rb
index 01755557ea..b6690806eb 100644
--- a/spec/requests/events/invoices_spec.rb
+++ b/spec/requests/events/invoices_spec.rb
@@ -4,6 +4,8 @@
let(:admin) { create(:user, :admin) }
let(:event) { create(:event, title: "AWBW 2-Day Art Facilitator Training", cost_cents: 150_000) }
+ # Only the admin blank template lives here now; a bulk-payment submission's
+ # invoice is served by Events::BulkPaymentFormSubmissions#invoice (slug-based).
describe "GET /events/:event_id/invoice" do
context "as an admin" do
before { sign_in admin }
@@ -16,34 +18,6 @@
expect(response.body).to include("AWBW 2-Day Art Facilitator Training")
expect(response.body).to include("$1,500")
end
-
- context "with a submission_id" do
- let(:form) { create(:form) }
- let(:payer) { create(:person) }
- let!(:submission) { create(:form_submission, person: payer, form: form, event: event, role: "bulk_payment") }
-
- def add_answer(identifier, value)
- field = create(:form_field, form: form, field_identifier: identifier, name: identifier.humanize)
- create(:form_answer, form_submission: submission, form_field: field, submitted_answer: value)
- end
-
- before do
- add_answer("payer_first_name", "Helena")
- add_answer("payer_last_name", "Lopez")
- add_answer("payer_organization", "A Greater Hope")
- add_answer("number_of_attendees", "8")
- end
-
- it "autofills the invoice from the bulk-payment submission" do
- get event_invoice_path(event, submission_id: submission.id)
-
- expect(response).to have_http_status(:success)
- expect(response.body).to include("A Greater Hope")
- expect(response.body).to include("Helena Lopez")
- # 8 attendees × $1,500 = $12,000
- expect(response.body).to include("$12,000")
- end
- end
end
context "as a non-admin" do
@@ -56,22 +30,7 @@ def add_answer(identifier, value)
end
context "as a guest (no account)" do
- let(:form) { create(:form) }
- let!(:submission) { create(:form_submission, form: form, event: event, role: "bulk_payment") }
-
- it "can view a bulk-payment submission's invoice (matches the public show page)" do
- get event_invoice_path(event, submission_id: submission.id)
- expect(response).to have_http_status(:success)
- expect(response.body).to include("INVOICE")
- end
-
- it "is denied an invoice for a non-bulk submission" do
- other = create(:form_submission, form: form, event: event, role: "registration")
- get event_invoice_path(event, submission_id: other.id)
- expect(response).to redirect_to(root_path)
- end
-
- it "is still denied the blank template" do
+ it "is denied the blank template and redirected" do
get event_invoice_path(event)
expect(response).to redirect_to(root_path)
end
diff --git a/spec/views/page_bg_class_alignment_spec.rb b/spec/views/page_bg_class_alignment_spec.rb
index 023520c78f..e1984a67af 100644
--- a/spec/views/page_bg_class_alignment_spec.rb
+++ b/spec/views/page_bg_class_alignment_spec.rb
@@ -216,6 +216,7 @@
"app/views/events/bulk_payment_form_submissions/new.html.erb" => "public",
"app/views/events/bulk_payment_form_submissions/show.html.erb" => "public",
"app/views/events/bulk_payment_form_submissions/ticket.html.erb" => "public",
+ "app/views/events/bulk_payment_form_submissions/receipt.html.erb" => "public",
# ─── event invoice (slug/submission-reachable; blank template gated in controller) ───
"app/views/events/invoices/show.html.erb" => "public",