fix: restore PostGIS via boost-serialization from EPEL 10

.github/workflows/build-base.yml

@@ -0,0 +1,52 @@
+name: Build and Push Base Image
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - Containerfile.base
+  workflow_dispatch:
+
+env:
+  REGISTRY: quay.io
+  IMAGE_NAME: crunchtools/rotv-base
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Quay.io
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ secrets.QUAY_USERNAME }}
+          password: ${{ secrets.QUAY_PASSWORD }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: Containerfile.base
+          push: true
+          tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
+          secrets: |
+            activation_key=${{ secrets.RHSM_ACTIVATION_KEY }}
+            org_id=${{ secrets.RHSM_ORG_ID }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Trigger rotv rebuild
+        env:
+          GH_TOKEN: ${{ secrets.CRUNCHTOOLS_DISPATCH_TOKEN }}
+        run: |
+          gh api repos/crunchtools/rotv/dispatches \
+            -f event_type=parent-image-updated

.github/workflows/build.yml

@@ -55,5 +55,8 @@ jobs:
           labels: ${{ steps.meta.outputs.labels }}
           build-args: |
             BASE_IMAGE=quay.io/crunchtools/rotv-base:latest
+          secrets: |
+            activation_key=${{ secrets.RHSM_ACTIVATION_KEY }}
+            org_id=${{ secrets.RHSM_ORG_ID }}
           cache-from: type=gha
           cache-to: type=gha,mode=max

.specify/memory/constitution.md

@@ -61,7 +61,10 @@ The init service creates the database if not present, imports seed data from `/t
 - Single-stage build on `ubi10-core`
 - Frontend built in-image: `npm run build` creates `/app/public/`
 - `rootfs/` directory provides systemd units and init script
-- PostgreSQL 17 installed from pgdg RPM repo (no RHSM needed)
+- PostgreSQL 17 + PostGIS installed from pgdg RPM repo
+- RHSM registration required at build time for boost-serialization (SFCGAL dep for PostGIS)
+  — uses `--mount=type=secret` pattern per crunchtools container-image profile Section II
+  — CI passes `activation_key` and `org_id` secrets; local builds skip registration gracefully
 - Playwright + Chromium installed globally for testing
 - Required LABELs: `maintainer`, `description`
 

Containerfile

@@ -21,13 +21,20 @@ RUN dnf install -y nodejs npm \
 # Install Playwright globally with Chromium (pinned to match backend/package.json)
 RUN npm install -g playwright@1.58.1 && npx playwright install chromium
 
-# Add PostgreSQL 17 + PostGIS from official pgdg repository (no RHSM needed)
-# EPEL provides PostGIS dependencies (hdf5, xerces-c)
-# WORKAROUND: PostGIS fails on RHEL 10 due to missing libboost_serialization.so.1.83.0 (as of 2026-04-09)
-# Allow build to continue without PostGIS until RHEL 10 repos are fixed
-RUN dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm && \
+# Add PostgreSQL 17 + PostGIS from official pgdg repository
+# RHSM registration provides RHEL BaseOS/AppStream (required for boost-serialization → SFCGAL → postgis35_17)
+# EPEL provides additional PostGIS dependencies (hdf5, xerces-c)
+RUN --mount=type=secret,id=activation_key \
+    --mount=type=secret,id=org_id \
+    if [ -s /run/secrets/activation_key ] && [ -s /run/secrets/org_id ]; then \
+        subscription-manager register \
+            --activationkey="$(cat /run/secrets/activation_key)" \
+            --org="$(cat /run/secrets/org_id)"; \
+    fi && \
+    dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm && \
     dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-10-x86_64/pgdg-redhat-repo-latest.noarch.rpm && \
-    (dnf install -y postgresql17-server postgresql17 postgis35_17 || dnf install -y postgresql17-server postgresql17) && \
+    dnf install -y postgresql17-server postgresql17 postgis35_17 && \
+    subscription-manager unregister 2>/dev/null || true && \
     dnf clean all
 
 # Create symlinks for PostgreSQL commands

Containerfile.base

@@ -33,9 +33,20 @@ RUN (cd /lib/systemd/system/sysinit.target.wants/; for i in *; do [ $i == system
 RUN npm install -g playwright && npx playwright install chromium
 RUN npm list -g playwright --depth=0 | grep playwright | awk -F@ '{print $2}' > /etc/playwright-version
 
-# Add PostgreSQL official repository and install PostgreSQL 17
-RUN dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-10-x86_64/pgdg-redhat-repo-latest.noarch.rpm && \
-    dnf install -y postgresql17-server postgresql17 postgresql17-contrib && \
+# Add PostgreSQL 17 + PostGIS from official pgdg repository
+# RHSM registration provides RHEL BaseOS/AppStream (required for boost-serialization → SFCGAL → postgis35_17)
+# EPEL provides additional PostGIS dependencies (hdf5, xerces-c)
+RUN --mount=type=secret,id=activation_key \
+    --mount=type=secret,id=org_id \
+    if [ -s /run/secrets/activation_key ] && [ -s /run/secrets/org_id ]; then \
+        subscription-manager register \
+            --activationkey="$(cat /run/secrets/activation_key)" \
+            --org="$(cat /run/secrets/org_id)"; \
+    fi && \
+    dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm && \
+    dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-10-x86_64/pgdg-redhat-repo-latest.noarch.rpm && \
+    dnf install -y postgresql17-server postgresql17 postgresql17-contrib postgis35_17 && \
+    subscription-manager unregister 2>/dev/null || true && \
     dnf clean all
 
 # Create symlinks for PostgreSQL commands

backend/tests/database.integration.test.js

@@ -153,6 +153,78 @@ describe('Database Schema Tests', () => {
   });
 });
 
+describe('PostGIS / Geographic Grounding Tests', () => {
+  it('PostGIS extension is installed', async () => {
+    const result = await pool.query(
+      "SELECT extname, extversion FROM pg_extension WHERE extname = 'postgis'"
+    );
+    expect(result.rows.length).toBe(1);
+    expect(result.rows[0].extname).toBe('postgis');
+  });
+
+  it('pois table has boundary_geom column', async () => {
+    const result = await pool.query(`
+      SELECT column_name
+      FROM information_schema.columns
+      WHERE table_name = 'pois' AND column_name = 'boundary_geom'
+    `);
+    expect(result.rows.length).toBe(1);
+  });
+
+  it('Serper grounding query executes without error', async () => {
+    // Insert a test boundary POI and a point POI inside it, then verify
+    // the grounding SQL (copied verbatim from serperService.js) returns the
+    // boundary name. This test catches PostGIS being absent or the geometry
+    // columns being missing — both of which silently degrade to ungrounded
+    // searches at runtime.
+    await pool.query(`
+      INSERT INTO pois (name, poi_type, latitude, longitude, boundary_geom)
+      VALUES (
+        '_test_boundary', 'boundary', 41.3, -81.6,
+        ST_MakeEnvelope(-82.0, 41.0, -81.0, 41.6, 4326)
+      )
+    `);
+    const testPoi = await pool.query(`
+      INSERT INTO pois (name, poi_type, latitude, longitude)
+      VALUES ('_test_point', 'point', 41.2, -81.5)
+      RETURNING id
+    `);
+    const poiId = testPoi.rows[0].id;
+
+    try {
+      const result = await pool.query(`
+        WITH poi_point AS (
+          SELECT
+            id,
+            CASE
+              WHEN poi_type = 'point' AND geom IS NOT NULL THEN geom
+              WHEN poi_type IN ('trail', 'boundary', 'river') AND geometry IS NOT NULL THEN
+                ST_StartPoint(ST_GeometryN(ST_GeomFromGeoJSON(geometry::text), 1))
+              ELSE NULL
+            END as point_geom
+          FROM pois
+          WHERE id = $1
+        )
+        SELECT boundary.name
+        FROM poi_point
+        LEFT JOIN pois AS boundary
+          ON boundary.poi_type = 'boundary'
+          AND boundary.boundary_geom IS NOT NULL
+          AND ST_Contains(boundary.boundary_geom, poi_point.point_geom)
+        WHERE poi_point.point_geom IS NOT NULL
+        ORDER BY ST_Area(boundary.boundary_geom) ASC
+        LIMIT 1
+      `, [poiId]);
+
+      // A point POI uses lat/lon, not geom, so grounding via geom column won't
+      // match — but the query must execute without throwing.
+      expect(Array.isArray(result.rows)).toBe(true);
+    } finally {
+      await pool.query("DELETE FROM pois WHERE name IN ('_test_boundary', '_test_point')");
+    }
+  });
+});
+
 describe('Database Query Tests', () => {
   it('should query POIs successfully', async () => {
     const result = await pool.query(`