Geospatial/places and spaces (#818)

## Summary of Changes

This pull request introduces several major features and improvements to
the Community Engine, focused on calendar integration, geospatial
modeling, contact and file management, and UI enhancements. It also
includes extensive code cleanup and minor bug fixes.

### 🗓️ Calendar System
- Added `Calendar` model, database migrations, policies, controllers,
and views.
- Integrated `simple_calendar` gem with support for monthly, weekly, and
daily views.
- Linked calendars to host communities and ensured correct attribute
setting.

### 🗺️ Geospatial Mapping
- Introduced `Geography::Map`, `Geography::Space`, `Place`, and
supporting join models for geospatial relationships.
- Integrated Leaflet.js for map rendering with support for zoom/center
customization.
- Added `mappable` polymorphic association and geocoding support.
- Ensured PostGIS support in GitHub Actions test environment.

### 🏢 Venue Infrastructure
- Added `Building`, `Floor`, and `Room` models with address support.
- Enhanced slug and identifier handling across models using
parameterized values and friendly_id.

### 🧩 UI & UX Improvements
- Created responsive image gallery using Masonry.js.
- Improved calendar and map controls and default behaviors.
- Added a toggle switch partial and associated Stimulus controller.
- Enhanced nested tab activation, contact field entry, and hint text
styling.

### 📁 Uploads & Files
- Introduced `BetterTogether::File` model (renamed to `Upload`) to
manage downloadable content.

### 📇 Contact & Info Management
- Enabled multiple `Contact` records for a `Contactable`.
- Added support for email/phone flags and improved partial rendering for
boolean values via `humanize_boolean`.

### 🧼 Code Cleanup & Enhancements
- Removed unused Stimulus controllers and replaced legacy references
(e.g., Twix → Bluesky).
- Added helper methods (e.g., `to_s` on `ApplicationRecord`,
`human_attribute_name_for_model`).
- Refined default rendering of address formats.
- Performed numerous Rubocop and linting fixes.
- Updated dependencies and development environment credentials.

Author: rsmithlal

.github/workflows/rubyonrails.yml

@@ -35,7 +35,7 @@ jobs:
           "ES_JAVA_OPTS": "-Xms512m -Xmx512m"
     env:
       RAILS_ENV: test
-      DATABASE_URL: "postgres://rails:password@localhost:5432/rails_test"
+      DATABASE_URL: "postgis://rails:password@localhost:5432/rails_test"
       ES_HOST: "http://localhost"
     steps:
       - name: Checkout code

Gemfile.lock

@@ -19,7 +19,7 @@ GIT
 PATH
   remote: .
   specs:
-    better_together (0.7.1)
+    better_together (0.8.0)
       active_storage_svg_sanitizer
       active_storage_validations
       activerecord-import
@@ -34,11 +34,14 @@ PATH
       font-awesome-sass (~> 6.5)
       friendly_id (>= 5.2, < 5.6)
       friendly_id-mobility (~> 1.0.4)
+      geocoder
       groupdate
+      humanize_boolean
       i18n-timezones
       image_processing (~> 1.2)
       importmap-rails (~> 2.0)
       jsonapi-resources (>= 0.10.0)
+      kaminari
       memory_profiler
       mobility (>= 1.0.1, < 2.0)
       mobility-actiontext (~> 1.1)
@@ -52,6 +55,7 @@ PATH
       reform-rails (~> 0.2.0)
       rswag (>= 2.3.1, < 2.17.0)
       ruby-openai
+      simple_calendar
       sprockets-rails
       stackprof
       stimulus-rails (~> 1.3)
@@ -160,7 +164,7 @@ GEM
       mime-types (>= 2.99)
       unf
     ast (2.4.2)
-    autoprefixer-rails (10.4.19.0)
+    autoprefixer-rails (10.4.21.0)
       execjs (~> 2)
     aws-eventstream (1.3.1)
     aws-partitions (1.1052.0)
@@ -224,16 +228,17 @@ GEM
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
     concurrent-ruby (1.3.5)
-    connection_pool (2.5.0)
+    connection_pool (2.5.1)
     coveralls_reborn (0.28.0)
       simplecov (~> 0.22.0)
       term-ansicolor (~> 1.7)
       thor (~> 1.2)
       tins (~> 1.32)
     crass (1.0.6)
-    css_parser (1.21.0)
+    css_parser (1.21.1)
       addressable
-    dartsass-sprockets (3.2.0)
+    csv (3.3.4)
+    dartsass-sprockets (3.2.1)
       railties (>= 4.0.0)
       sassc-embedded (~> 1.80.1)
       sprockets (> 3.0)
@@ -306,15 +311,15 @@ GEM
       railties (>= 5.0.0)
     faker (3.5.1)
       i18n (>= 1.8.11, < 2)
-    faraday (2.12.2)
+    faraday (2.13.0)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
     faraday-multipart (1.1.0)
       multipart-post (~> 2.0)
     faraday-net_http (3.4.0)
       net-http (>= 0.5.0)
-    ffi (1.17.1-x86_64-linux-gnu)
+    ffi (1.17.2-x86_64-linux-gnu)
     fog-aws (3.30.0)
       base64 (~> 0.2.0)
       fog-core (~> 2.6)
@@ -342,9 +347,12 @@ GEM
     fuubar (2.5.1)
       rspec-core (~> 3.0)
       ruby-progressbar (~> 1.4)
+    geocoder (1.8.5)
+      base64 (>= 0.1.0)
+      csv (>= 3.0.0)
     globalid (1.2.1)
       activesupport (>= 6.1)
-    google-protobuf (4.30.0-x86_64-linux)
+    google-protobuf (4.30.2-x86_64-linux)
       bigdecimal
       rake (>= 13)
     groupdate (6.5.1)
@@ -353,6 +361,8 @@ GEM
     highline (3.1.2)
       reline
     htmlentities (4.3.4)
+    humanize_boolean (0.0.2)
+      i18n
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     i18n-tasks (1.0.15)
@@ -381,7 +391,7 @@ GEM
       activesupport (>= 6.0.0)
       railties (>= 6.0.0)
     io-console (0.8.0)
-    irb (1.15.1)
+    irb (1.15.2)
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
@@ -396,6 +406,18 @@ GEM
       railties (>= 4.1)
     jwt (2.10.1)
       base64
+    kaminari (1.2.2)
+      activesupport (>= 4.1.0)
+      kaminari-actionview (= 1.2.2)
+      kaminari-activerecord (= 1.2.2)
+      kaminari-core (= 1.2.2)
+    kaminari-actionview (1.2.2)
+      actionview
+      kaminari-core (= 1.2.2)
+    kaminari-activerecord (1.2.2)
+      activerecord
+      kaminari-core (= 1.2.2)
+    kaminari-core (1.2.2)
     language_server-protocol (3.17.0.4)
     launchy (3.1.1)
       addressable (~> 2.8)
@@ -405,7 +427,7 @@ GEM
     listen (3.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    logger (1.6.6)
+    logger (1.7.0)
     loofah (2.24.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
@@ -426,7 +448,7 @@ GEM
       benchmark
       logger
     mini_mime (1.1.5)
-    minitest (5.25.4)
+    minitest (5.25.5)
     mobility (1.3.2)
       i18n (>= 0.6.10, < 2)
       request_store (~> 1.0)
@@ -449,7 +471,7 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     nio4r (2.7.4)
-    nokogiri (1.18.4-x86_64-linux-gnu)
+    nokogiri (1.18.7-x86_64-linux-gnu)
       racc (~> 1.4)
     noticed (2.6.0)
       rails (>= 6.1.0)
@@ -484,7 +506,7 @@ GEM
     pundit (2.5.0)
       activesupport (>= 3.0.0)
     racc (1.8.1)
-    rack (3.1.12)
+    rack (3.1.13)
     rack-cors (2.0.2)
       rack (>= 2.0.0)
     rack-mini-profiler (3.3.1)
@@ -542,7 +564,7 @@ GEM
       ffi (>= 1.0.6)
       msgpack (>= 0.4.3)
       optimist (>= 3.0.0)
-    rdoc (6.12.0)
+    rdoc (6.13.1)
       psych (>= 4.0.0)
     redis (5.4.0)
       redis-client (>= 0.22.0)
@@ -556,7 +578,7 @@ GEM
       activemodel (>= 5.0)
       reform (>= 2.3.1, < 3.0.0)
     regexp_parser (2.10.0)
-    reline (0.6.0)
+    reline (0.6.1)
       io-console (~> 0.5)
     representable (3.2.0)
       declarative (< 0.1.0)
@@ -625,7 +647,7 @@ GEM
     rubocop-rspec (3.5.0)
       lint_roller (~> 1.1)
       rubocop (~> 1.72, >= 1.72.1)
-    ruby-openai (8.0.0)
+    ruby-openai (8.1.0)
       event_stream_parser (>= 0.3.0, < 2.0.0)
       faraday (>= 1)
       faraday-multipart (>= 1)
@@ -634,8 +656,8 @@ GEM
       ffi (~> 1.12)
       logger
     rubyzip (2.4.1)
-    sass-embedded (1.85.1-x86_64-linux-gnu)
-      google-protobuf (~> 4.29)
+    sass-embedded (1.86.3-x86_64-linux-gnu)
+      google-protobuf (~> 4.30)
     sassc (2.4.0)
       ffi (~> 1.9)
     sassc-embedded (1.80.4)
@@ -663,6 +685,8 @@ GEM
       logger (>= 1.6.2)
       rack (>= 3.1.0)
       redis-client (>= 0.23.2)
+    simple_calendar (3.1.0)
+      rails (>= 6.1)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
@@ -683,7 +707,7 @@ GEM
     stackprof (0.2.27)
     stimulus-rails (1.3.4)
       railties (>= 6.0.0)
-    stringio (3.1.5)
+    stringio (3.1.6)
     sync (0.5.0)
     term-ansicolor (1.11.2)
       tins (~> 1.0)

README.md

@@ -52,7 +52,7 @@ end
 Add this gem to your Gemfile:
 
 ```ruby
-gem 'better_together', '~> 0.5.0',
+gem 'better_together', '~> 0.8.0',
     github: 'better-together-org/community-engine-rails',
     branch: 'main'
 ```
@@ -85,26 +85,26 @@ rails db:migrate
 
 This gem is developed using Docker and Docker Compose. To get the app running, complete the following steps:
 
-Build the application image:
+Build the application image using the docker convenience scripts:
 
 ```bash
-docker compose build
+bin/dc build
 ```
 
 Bundle the gems:
 
 ```bash
-docker compose run --rm app bundle
+bin/dc-run app bundle
 ```
 
 Setup the database:
 
 ```bash
-docker compose run --rm app rails db:setup
+bin/dc-run app rails db:setup
 ```
 
 Run the RSpec tests:
 
 ```bash
-docker compose run --rm app rspec
+bin/dc-run app rspec
 ```

app/assets/config/better_together_manifest.js

@@ -2,6 +2,7 @@
 
 //= link_tree ../../javascript .js
 //= link_tree ../stylesheets .css
+//= link_tree ../../../vendor/stylesheets .css
 //= link_tree ../stylesheets .scss
 //= link_tree ../images
 
@@ -14,3 +15,10 @@
 //= link stimulus.js
 //= link stimulus-loading.js
 //= link turbo.js
+
+//= link masonry.min.js
+//= link imagesloaded.min.js
+
+//= link leaflet.js
+//= link leaflet-gesture-handling.js
+//= link leaflet-providers.js

app/assets/stylesheets/better_together/application.scss

@@ -10,6 +10,7 @@
  * files in this directory. Styles in this file should be added after the last require_* statement.
  * It is generally better to create a new file per style scope.
  *
+ *= require leaflet-gesture-handling.min
  *= require_self
  */
 
@@ -25,10 +26,13 @@
 @import 'content_blocks';
 @import 'conversations';
 @import 'forms';
+@import 'image-galleries';
+@import 'maps';
 @import 'metrics';
 @import 'navigation';
 @import 'notifications';
 @import 'profiles';
+@import 'simple_calendar';
 @import 'share';
 @import 'sidebar_nav';
 @import 'trix-extensions/richtext';

app/assets/stylesheets/better_together/image-galleries.scss

@@ -0,0 +1,4 @@
+
+.image-gallery {
+  // min-height: 50vh;
+}

app/assets/stylesheets/better_together/maps.scss

@@ -0,0 +1,12 @@
+
+.map {
+  min-height: 500px;
+  position: relative;
+
+  .map-controls {
+    position: absolute;
+    top: 10px;
+    right: 10px;
+    z-index: 401;
+  }
+}

app/assets/stylesheets/better_together/share.scss

@@ -57,8 +57,8 @@ a {
   &.share-facebook:hover i.bg,
   &.share-facebook:focus i.bg { color: #3b5998; }
 
-  &.share-twitter:hover i.bg,
-  &.share-twitter:focus i.bg { color: #1da1f2; }
+  &.share-bluesky:hover i.bg,
+  &.share-bluesky:focus i.bg { color: #1185fe; }
 
   &.share-linkedin:hover i.bg,
   &.share-linkedin:focus i.bg { color: #0077b5; }

app/controllers/better_together/calendars_controller.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module BetterTogether
+  # CRUD for calendars
+  class CalendarsController < FriendlyResourceController
+    # GET /better_together/calendars
+
+    # GET /better_together/calendars/new
+    def new
+      @calendar = resource_instance
+    end
+
+    # GET /better_together/calendars/1/edit
+    def edit; end
+
+    # POST /better_together/calendars
+    # def create
+    #   @calendar = BetterTogether::Calendar.new(better_together_calendar_params)
+
+    #   if @calendar.save
+    #     redirect_to @calendar, notice: "Calendar was successfully created."
+    #   else
+    #     render :new, status: :unprocessable_entity
+    #   end
+    # end
+
+    # PATCH/PUT /better_together/calendars/1
+    # def update
+    #   if @calendar.update(better_together_calendar_params)
+    #     redirect_to @calendar, notice: "Calendar was successfully updated.", status: :see_other
+    #   else
+    #     render :edit, status: :unprocessable_entity
+    #   end
+    # end
+
+    # DELETE /better_together/calendars/1
+    def destroy
+      @calendar.destroy!
+      redirect_to better_together_calendars_url, notice: 'Calendar was successfully destroyed.', status: :see_other
+    end
+
+    private
+
+    def permitted_attributes
+      resource_class.extra_permitted_attributes + %i[community_id]
+    end
+
+    def resource_class
+      BetterTogether::Calendar
+    end
+  end
+end