Rename Scan model to Visit with QR/link source distinction

- Rename scans table to visits with source column (qr_code/link)
- Add source detection via ?qr=1 parameter for QR codes
- Differentiated ticket rewards: QR scans = 3 tickets, links = 1 ticket
- Update all controllers, views, routes, and jobs
- Add visual indicators (📱 for QR, 🔗 for links) throughout UI
- Configure production database environment variables
- Add offline poster upload functionality with service worker caching

Author: zachlatta

PRODUCTION_ENV.md

@@ -0,0 +1,53 @@
+# Production Environment Variables
+
+## Required Database Configuration
+
+```bash
+# Database Connection
+DATABASE_HOST=your-postgres-host.com
+DATABASE_PORT=5432
+DATABASE_NAME=pyramid_scheme_production  # Base name, suffixes added automatically
+DATABASE_USERNAME=your_db_user
+DATABASE_PASSWORD=your_secure_password
+```
+
+## Rails Configuration
+
+```bash
+# Rails Environment
+RAILS_ENV=production
+RAILS_MASTER_KEY=your_master_key_from_credentials
+SECRET_KEY_BASE=your_long_random_secret
+
+# Connection Pool
+RAILS_MAX_THREADS=5
+```
+
+## Application Specific
+
+```bash
+# Geocoding Service
+GEOCODER_API_KEY=your_geocoder_api_key
+
+# Base URL for referral links
+BASE_REFERRAL_URL=https://your-domain.com
+
+# OAuth (if using GitHub auth)
+GITHUB_CLIENT_ID=your_github_client_id
+GITHUB_CLIENT_SECRET=your_github_client_secret
+```
+
+## Database Setup
+
+Rails will automatically create these databases during deployment:
+- `pyramid_scheme_production` (main app data)
+- `pyramid_scheme_production_cache` (Rails cache)
+- `pyramid_scheme_production_queue` (background jobs)
+- `pyramid_scheme_production_cable` (websockets)
+
+## Docker Deployment
+
+With Docker, Rails handles database setup automatically when you run:
+```bash
+bin/rails db:create db:migrate RAILS_ENV=production
+```

app/controllers/admin_controller.rb

@@ -10,15 +10,17 @@ def index
                          .where("birthday IS NOT NULL AND EXTRACT(year FROM age(birthday)) <= 18").count
     }
 
-    @scan_stats = {
-      total_scans: Scan.count,
-      unique_visitors: Scan.select(:ip_address, :user_agent).distinct.count,
-      scans_today: Scan.where('created_at > ?', 1.day.ago).count,
-      scans_this_week: Scan.where('created_at > ?', 1.week.ago).count
+    @visit_stats = {
+      total_visits: Visit.count,
+      unique_visitors: Visit.select(:ip_address, :user_agent).distinct.count,
+      visits_today: Visit.where('created_at > ?', 1.day.ago).count,
+      visits_this_week: Visit.where('created_at > ?', 1.week.ago).count,
+      qr_visits: Visit.qr_code.count,
+      link_visits: Visit.link.count
     }
 
     @recent_users = User.order(created_at: :desc).limit(10)
-    @recent_scans = Scan.includes(:user).order(created_at: :desc).limit(10)
+    @recent_visits = Visit.includes(:user).order(created_at: :desc).limit(10)
   end
 
   private

app/controllers/dashboard_controller.rb

@@ -4,24 +4,25 @@ class DashboardController < ApplicationController
 
   def show
     @user = current_user
-    @scans = current_user.scans.includes(:user).recent.limit(20)
-    @scan_stats = calculate_scan_stats
-    @next_prize = calculate_next_prize(@scan_stats[:total_tickets])
+    @visits = current_user.visits.includes(:user).recent.limit(20)
+    @visit_stats = calculate_visit_stats
+    @next_prize = calculate_next_prize(@visit_stats[:total_tickets])
   end
 
-  def scan_data
-    scans = current_user.scans.geocoded.recent.limit(100)
+  def visit_data
+    visits = current_user.visits.geocoded.recent.limit(100)
 
-    data = scans.map do |scan|
+    data = visits.map do |visit|
       {
-        id: scan.id,
+        id: visit.id,
         username: current_user.username,
-        latitude: scan.latitude,
-        longitude: scan.longitude,
-        location: scan.location_display,
-        device: scan.device_info,
-        created_at: scan.created_at.iso8601,
-        time_ago: time_ago_in_words(scan.created_at)
+        latitude: visit.latitude,
+        longitude: visit.longitude,
+        location: visit.location_display,
+        device: visit.device_info,
+        source: visit.source,
+        created_at: visit.created_at.iso8601,
+        time_ago: time_ago_in_words(visit.created_at)
       }
     end
 
@@ -32,8 +33,9 @@ def poster
     require 'hexapdf'
     require 'rqrcode'
 
-    # Generate QR code
-    qr_code = RQRCode::QRCode.new(current_user.referral_url)
+    # Generate QR code with qr=1 parameter for source detection
+    qr_url = "#{current_user.referral_url}?qr=1"
+    qr_code = RQRCode::QRCode.new(qr_url)
     qr_png = qr_code.as_png(size: 400, border_modules: 2)
 
     # Create PDF document
@@ -144,30 +146,34 @@ def poster
 
   private
 
-  def calculate_scan_stats
-    scans = current_user.scans
-    scans_this_week = scans.where('created_at > ?', 1.week.ago)
+  def calculate_visit_stats
+    visits = current_user.visits
+    visits_this_week = visits.where('created_at > ?', 1.week.ago)
 
-    # Calculate tickets based on current activity
-    # For now, we'll simulate ticket earning:
-    # - 3 tickets per unique visitor (simulating signup + 1 hour coding)
-    # - 1 ticket per poster download (we'll estimate based on total scans / 10)
+    # Calculate tickets based on source and activity
+    # QR code scans: 3 tickets each (higher engagement)
+    # Link clicks: 1 ticket each (easier sharing)
 
-    total_tickets = (scans.select(:ip_address, :user_agent).distinct.count * 3) + 
-                   (scans.count / 10) # Estimate poster downloads
+    qr_visits = visits.qr_code.select(:ip_address, :user_agent).distinct
+    link_visits = visits.link.select(:ip_address, :user_agent).distinct
 
-    tickets_this_week = (scans_this_week.select(:ip_address, :user_agent).distinct.count * 3) + 
-                       (scans_this_week.count / 10)
+    qr_visits_week = visits_this_week.qr_code.select(:ip_address, :user_agent).distinct
+    link_visits_week = visits_this_week.link.select(:ip_address, :user_agent).distinct
+    
+    total_tickets = (qr_visits.count * 3) + (link_visits.count * 1)
+    tickets_this_week = (qr_visits_week.count * 3) + (link_visits_week.count * 1)
 
     {
-      total_scans: scans.count,
+      total_visits: visits.count,
       total_tickets: total_tickets,
-      unique_visitors: scans.select(:ip_address, :user_agent).distinct.count,
-      scans_today: scans.where('created_at > ?', 1.day.ago).count,
-      scans_this_week: scans_this_week.count,
+      unique_visitors: visits.select(:ip_address, :user_agent).distinct.count,
+      qr_visits: qr_visits.count,
+      link_visits: link_visits.count,
+      visits_today: visits.where('created_at > ?', 1.day.ago).count,
+      visits_this_week: visits_this_week.count,
       tickets_this_week: tickets_this_week,
-      unique_visitors_this_week: scans_this_week.select(:ip_address, :user_agent).distinct.count,
-      top_countries: scans.geocoded
+      unique_visitors_this_week: visits_this_week.select(:ip_address, :user_agent).distinct.count,
+      top_countries: visits.geocoded
                           .where.not(country_name: [nil, ''])
                           .group(:country_name)
                           .count

app/controllers/home_controller.rb

@@ -1,27 +1,28 @@
 class HomeController < ApplicationController
   include ActionView::Helpers::DateHelper
   def index
-    @recent_scans = Scan.includes(:user)
-                       .recent
-                       .limit(10)
-    @unique_scan_count = Rails.cache.fetch("unique_scan_count", expires_in: 15.seconds) do
-      Scan.select(:ip_address, :user_agent).distinct.count
+    @recent_visits = Visit.includes(:user)
+                          .recent
+                          .limit(10)
+    @unique_visit_count = Rails.cache.fetch("unique_visit_count", expires_in: 15.seconds) do
+      Visit.select(:ip_address, :user_agent).distinct.count
     end
   end
 
-  def scan_data
-    scans = Scan.includes(:user).geocoded.recent.limit(100)
+  def visit_data
+    visits = Visit.includes(:user).geocoded.recent.limit(100)
 
-    data = scans.map do |scan|
+    data = visits.map do |visit|
       {
-        id: scan.id,
-        username: scan.user&.username || "Unknown",
-        latitude: scan.latitude,
-        longitude: scan.longitude,
-        location: scan.location_display,
-        device: scan.device_info,
-        created_at: scan.created_at.iso8601,
-        time_ago: time_ago_in_words(scan.created_at)
+        id: visit.id,
+        username: visit.user&.username || "Unknown",
+        latitude: visit.latitude,
+        longitude: visit.longitude,
+        location: visit.location_display,
+        device: visit.device_info,
+        source: visit.source,
+        created_at: visit.created_at.iso8601,
+        time_ago: time_ago_in_words(visit.created_at)
       }
     end
 

app/controllers/posters_controller.rb

@@ -0,0 +1,39 @@
+class PostersController < ApplicationController
+  before_action :require_login
+  before_action :set_poster, only: [:show]
+  
+  def index
+    @posters = current_user.posters.order(created_at: :desc)
+  end
+  
+  def new
+    @poster = current_user.posters.build
+  end
+  
+  def create
+    @poster = current_user.posters.build(poster_params)
+    
+    if @poster.save
+      # Queue background job for processing
+      ProcessPosterJob.perform_later(@poster)
+      
+      redirect_to @poster, notice: 'Poster uploaded successfully! It will be reviewed shortly.'
+    else
+      render :new, status: :unprocessable_entity
+    end
+  end
+  
+  def show
+    # Show poster details and status
+  end
+  
+  private
+  
+  def set_poster
+    @poster = current_user.posters.find(params[:id])
+  end
+  
+  def poster_params
+    params.require(:poster).permit(:image, :latitude, :longitude)
+  end
+end

app/controllers/referrals_controller.rb

@@ -20,14 +20,18 @@ def show
   private
 
   def log_scan(referral_code)
-    # Enqueue job to create scan with geocoding - don't block the redirect
-    CreateScanJob.perform_later(
+    # Detect source: QR code vs link click
+    source = params[:qr] == '1' ? 'qr_code' : 'link'
+    
+    # Enqueue job to create visit with geocoding - don't block the redirect
+    CreateVisitJob.perform_later(
       referral_code,
       request.remote_ip,
-      request.user_agent
+      request.user_agent,
+      source
     )
   rescue => e
     # Log error but don't fail the redirect
-    Rails.logger.error "Failed to enqueue scan creation: #{e.message}"
+    Rails.logger.error "Failed to enqueue visit creation: #{e.message}"
   end
 end

app/helpers/posters_helper.rb

@@ -0,0 +1,2 @@
+module PostersHelper
+end

app/javascript/application.js

@@ -1,3 +1,21 @@
 // Configure your import map in config/importmap.rb. Read more: https://github.com/rails/importmap-rails
 import "@hotwired/turbo-rails"
 import "controllers"
+
+// Register service worker for offline functionality
+if ('serviceWorker' in navigator) {
+  window.addEventListener('load', () => {
+    navigator.serviceWorker.register('/sw.js')
+      .then(registration => {
+        console.log('SW registered: ', registration);
+        
+        // Request persistent storage for offline uploads
+        if ('storage' in navigator && 'persist' in navigator.storage) {
+          navigator.storage.persist();
+        }
+      })
+      .catch(registrationError => {
+        console.log('SW registration failed: ', registrationError);
+      });
+  });
+}