# rattlesnake-ramble-charity/rattlesnake_ramble architecture

> Architecture diagram of the GitHub repository rattlesnake-ramble-charity/rattlesnake_ramble, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rattlesnake-ramble-charity/rattlesnake_ramble
- Repository: https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble

## Overview

Rattlesnake Ramble is a Rails website for managing races and editions, registering racers, taking PayPal payments, and administering entries and products. The principal workflow is a participant submitting racer details for an edition, proceeding to PayPal, and having a paid entry recorded through the return flow or PayPal IPN; successful entry triggers acknowledgment and scheduled reminders. The README also documents race reports and placement categories. Edges are limited to relationships shown in excerpts or README; unsampled implementation details are represented without inferred links.

Main entry points: [`app/controllers/race_editions_controller.rb`](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/race_editions_controller.rb) (Race editions), [`app/controllers/webhooks/paypal_ipns_controller.rb`](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/webhooks/paypal_ipns_controller.rb) (PayPal IPN webhook), [`app/controllers/race_entries_controller.rb`](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/race_entries_controller.rb) (Race entries), [`app/models/race_edition.rb`](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/race_edition.rb) (Race domain models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_race_admin["Race administration"]
  node_races["Races"]
  node_editions["Race editions"]
  node_race_models["Race domain models<br/>[race_edition.rb]"]
  node_products["Products"]
  node_product_model["Product catalog models<br/>[product.rb]"]
  node_race_presenter["Edition presenter"]
end

subgraph group_signup_payment["Signup and payment"]
  node_racers["Racers"]
  node_entries["Race entries"]
  node_racer_model["Racer model<br/>[racer.rb]"]
  node_entry_model["Entry model<br/>[race_entry.rb]"]
  node_ipn_webhook["PayPal IPN webhook"]
  node_ipn_processor["IPN processing<br/>[process_ipn.rb]"]
  node_ipn_records["IPN messages<br/>[ipn_message.rb]"]
  node_payment_admin["IPN administration"]
end

subgraph group_race_results["Reports and results"]
  node_category_results["Placement categories<br/>[categories.rb]"]
  node_race_reports["Race reports"]
end

subgraph group_site_services["Site services"]
  node_pages["Site pages"]
  node_mailer["Race email<br/>[race_mailer.rb]"]
  node_reminders["Reminder job<br/>[reminder_job.rb]"]
  node_users["User accounts<br/>[user.rb]"]
end

node_visitor(("Participant or admin"))
node_paypal(("PayPal"))
node_database[("PostgreSQL")]

node_visitor -->|"visits"| node_pages
node_visitor -->|"requests entry"| node_editions
node_visitor -->|"administers"| node_racers
node_editions -->|"loads edition"| node_race_models
node_editions -->|"saves racer"| node_racer_model
node_editions -->|"creates entry"| node_entry_model
node_editions -->|"builds presenter"| node_race_presenter
node_editions -->|"redirects checkout"| node_paypal
node_paypal -->|"posts IPN"| node_ipn_webhook
node_ipn_webhook -->|"processes post"| node_ipn_processor
node_ipn_webhook -->|"queues alert"| node_mailer
node_ipn_webhook -->|"schedules reminders"| node_reminders
node_editions -->|"acknowledges payment"| node_mailer
node_editions -->|"schedules reminders"| node_reminders
node_entries -->|"updates entry"| node_entry_model
node_entries -->|"sends acknowledgment"| node_mailer
node_entries -->|"schedules reminders"| node_reminders
node_racers -->|"saves racer"| node_racer_model
node_payment_admin -.->|"administers messages"| node_ipn_records
node_races -.->|"manages races"| node_race_models
node_products -.->|"manages products"| node_product_model
node_category_results -.->|"supports placements"| node_race_reports
node_pages -.->|"persists content"| node_database
node_race_models -.->|"stores race data"| node_database
node_racer_model -.->|"stores racer data"| node_database
node_entry_model -.->|"stores entry data"| node_database
node_product_model -.->|"stores products"| node_database
node_ipn_records -.->|"stores IPN messages"| node_database
node_visitor -.->|"signs in"| node_users

click node_pages "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/pages_controller.rb"
click node_races "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/races_controller.rb"
click node_editions "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/race_editions_controller.rb"
click node_racers "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/racers_controller.rb"
click node_entries "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/race_entries_controller.rb"
click node_race_models "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/race_edition.rb"
click node_racer_model "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/racer.rb"
click node_entry_model "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/race_entry.rb"
click node_products "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/products_controller.rb"
click node_product_model "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/product.rb"
click node_ipn_webhook "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/webhooks/paypal_ipns_controller.rb"
click node_ipn_processor "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/services/paypal/process_ipn.rb"
click node_ipn_records "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/paypal/ipn_message.rb"
click node_payment_admin "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/paypal_ipn_messages_controller.rb"
click node_race_presenter "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/presenters/race_edition_presenter.rb"
click node_category_results "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/services/results/categories.rb"
click node_race_reports "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/helpers/race_reports_helper.rb"
click node_mailer "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/mailers/race_mailer.rb"
click node_reminders "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/jobs/reminder_job.rb"
click node_users "https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/user.rb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_races,node_editions,node_race_models,node_products,node_product_model,node_race_presenter toneBlue
class node_racers,node_entries,node_racer_model,node_entry_model,node_ipn_webhook,node_ipn_processor,node_ipn_records,node_payment_admin,node_database toneAmber
class node_category_results,node_race_reports toneMint
class node_pages,node_mailer,node_reminders,node_users toneRose
class node_visitor,node_paypal toneIndigo
```

## Components

### Race administration

- [Races](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/races_controller.rb): `app/controllers/races_controller.rb`
- [Race editions](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/race_editions_controller.rb): `app/controllers/race_editions_controller.rb`
- [Race domain models](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/race_edition.rb): `app/models/race_edition.rb`
- [Products](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/products_controller.rb): `app/controllers/products_controller.rb`
- [Product catalog models](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/product.rb): `app/models/product.rb`
- [Edition presenter](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/presenters/race_edition_presenter.rb): `app/presenters/race_edition_presenter.rb`

### Signup and payment

- [Racers](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/racers_controller.rb): `app/controllers/racers_controller.rb`
- [Race entries](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/race_entries_controller.rb): `app/controllers/race_entries_controller.rb`
- [Racer model](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/racer.rb): `app/models/racer.rb`
- [Entry model](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/race_entry.rb): `app/models/race_entry.rb`
- [PayPal IPN webhook](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/webhooks/paypal_ipns_controller.rb): `app/controllers/webhooks/paypal_ipns_controller.rb`
- [IPN processing](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/services/paypal/process_ipn.rb): `app/services/paypal/process_ipn.rb`
- [IPN messages](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/paypal/ipn_message.rb): `app/models/paypal/ipn_message.rb`
- [IPN administration](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/paypal_ipn_messages_controller.rb): `app/controllers/paypal_ipn_messages_controller.rb`

### Reports and results

- [Placement categories](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/services/results/categories.rb): `app/services/results/categories.rb`
- [Race reports](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/helpers/race_reports_helper.rb): `app/helpers/race_reports_helper.rb`

### Site services

- [Site pages](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/controllers/pages_controller.rb): `app/controllers/pages_controller.rb`
- [Race email](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/mailers/race_mailer.rb): `app/mailers/race_mailer.rb`
- [Reminder job](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/jobs/reminder_job.rb): `app/jobs/reminder_job.rb`
- [User accounts](https://github.com/rattlesnake-ramble-charity/rattlesnake_ramble/blob/master/app/models/user.rb): `app/models/user.rb`

### Other components

- **Participant or admin**
- **PayPal**
- **PostgreSQL**

## Connections

- Participant or admin → Site pages: visits
- Participant or admin → Race editions: requests entry (evidence: `app/controllers/race_editions_controller.rb`)
- Participant or admin → Racers: administers (evidence: `app/controllers/racers_controller.rb`)
- Race editions → Race domain models: loads edition (evidence: `app/controllers/race_editions_controller.rb`)
- Race editions → Racer model: saves racer (evidence: `app/controllers/race_editions_controller.rb`)
- Race editions → Entry model: creates entry (evidence: `app/controllers/race_editions_controller.rb`)
- Race editions → Edition presenter: builds presenter (evidence: `app/controllers/race_editions_controller.rb`)
- Race editions → PayPal: redirects checkout (evidence: `app/controllers/race_editions_controller.rb`)
- PayPal → PayPal IPN webhook: posts IPN
- PayPal IPN webhook → IPN processing: processes post (evidence: `app/controllers/webhooks/paypal_ipns_controller.rb`)
- PayPal IPN webhook → Race email: queues alert (evidence: `app/controllers/webhooks/paypal_ipns_controller.rb`)
- PayPal IPN webhook → Reminder job: schedules reminders (evidence: `app/controllers/webhooks/paypal_ipns_controller.rb`)
- Race editions → Race email: acknowledges payment
- Race editions → Reminder job: schedules reminders
- Race entries → Entry model: updates entry (evidence: `app/controllers/race_entries_controller.rb`)
- Race entries → Race email: sends acknowledgment (evidence: `app/controllers/race_entries_controller.rb`)
- Race entries → Reminder job: schedules reminders (evidence: `app/controllers/race_entries_controller.rb`)
- Racers → Racer model: saves racer (evidence: `app/controllers/racers_controller.rb`)
- IPN administration → IPN messages: administers messages
- Races → Race domain models: manages races
- Products → Product catalog models: manages products
- Placement categories → Race reports: supports placements
- Site pages → PostgreSQL: persists content
- Race domain models → PostgreSQL: stores race data
- Racer model → PostgreSQL: stores racer data
- Entry model → PostgreSQL: stores entry data
- Product catalog models → PostgreSQL: stores products
- IPN messages → PostgreSQL: stores IPN messages
- Participant or admin → User accounts: signs in
