dawarich/PLACES_INTEGRATION_CHECKLIST.md

Places Integration Checklist

Files Modified:

• ✅ app/javascript/controllers/stat_page_controller.js - Added PlacesManager integration
• ✅ app/javascript/maps/places.js - Fixed API authentication headers
• ✅ app/views/stats/_month.html.erb - Added Places button and tag filters
• ✅ app/views/shared/_place_creation_modal.html.erb - Already exists

What Should Appear:

On Monthly Stats Page (/stats/YYYY/MM):

1. Map Controls (top right of map):

   • "Heatmap" button
   • "Points" button
   • "Places" button ← NEW!

2. Below the Map:

   • "Filter Places by Tags" section ← NEW!
   • Checkboxes for each tag you've created
   • Each checkbox shows: icon + name + color dot

Troubleshooting Steps:

Step 1: Restart Server

# Stop server (Ctrl+C)
bundle exec rails server

# Or with Docker:
docker-compose restart web

Step 2: Hard Refresh Browser

• Mac: Cmd + Shift + R
• Windows/Linux: Ctrl + Shift + R

Step 3: Check Browser Console

1. Open Developer Tools (F12)
2. Go to Console tab
3. Look for errors (red text)
4. You should see: "StatPage controller connected"

Step 4: Verify URL

Make sure you're on a monthly stats page:

• ✅ /stats/2024/11 ← Correct
• ❌ /stats ← Wrong (main stats index)
• ❌ /stats/2024 ← Wrong (yearly stats)

Step 5: Check JavaScript Loading

In browser console, type:

console.log(document.querySelector('[data-controller="stat-page"]'))

Should show the element, not null.

Step 6: Verify Controller Registration

In browser console:

console.log(application.controllers)

Should include "stat-page" in the list.

Expected Behavior:

When You Click "Places" Button:

1. Places layer toggles on/off
2. Button highlights when active
3. Map shows custom markers with tag icons

When You Check Tag Filters:

1. Map updates immediately
2. Shows only places with selected tags
3. Unchecking all shows all places

If Nothing Shows:

Check if you have any places created:

bundle exec rails console

# In console:
user = User.find_by(email: 'your@email.com')
user.places.count  # Should be > 0
user.tags.count    # Should be > 0

Create test data:

bundle exec rails console

user = User.first
tag = user.tags.create!(name: "Test", icon: "📍", color: "#FF5733")

# Create via API or console:
place = user.places.create!(
  name: "Test Place",
  latitude: 40.7128,
  longitude: -74.0060,
  source: :manual
)
place.tags << tag

Verification Script:

Run this in Rails console to verify everything:

user = User.first
puts "Tags: #{user.tags.count}"
puts "Places: #{user.places.count}"
puts "Places with tags: #{user.places.joins(:tags).distinct.count}"

if user.tags.any?
  puts "\nYour tags:"
  user.tags.each do |tag|
    puts "  #{tag.icon} #{tag.name} (#{tag.places.count} places)"
  end
end

if user.places.any?
  puts "\nYour places:"
  user.places.limit(5).each do |place|
    puts "  #{place.name} at (#{place.latitude}, #{place.longitude})"
    puts "    Tags: #{place.tags.map(&:name).join(', ')}"
  end
end

Still Having Issues?

Check these files exist and have the right content:

• app/javascript/maps/places.js - Should export PlacesManager class
• app/javascript/controllers/stat_page_controller.js - Should import PlacesManager
• app/views/stats/_month.html.erb - Should have Places button at line ~73

Look for JavaScript errors in browser console that might indicate:

• Import/export issues
• Syntax errors
• Missing dependencies