fix(api/search): update group db schema to have a vector search

Author: TylerAdamMartinez

alembic/versions/y3z4a5b6c7d8_add_group_search_vector.py

@@ -0,0 +1,66 @@
+"""add group search vector
+
+Revision ID: y3z4a5b6c7d8
+Revises: e2f3a4b5c6d7
+Create Date: 2026-07-06 16:20:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+import sqlalchemy_utils
+from alembic import op
+
+
+revision: str = "y3z4a5b6c7d8"
+down_revision: Union[str, None] = "e2f3a4b5c6d7"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "group",
+        sa.Column(
+            "search_vector",
+            sqlalchemy_utils.types.ts_vector.TSVectorType(),
+            nullable=True,
+        ),
+    )
+    op.create_index(
+        "ix_group_search_vector",
+        "group",
+        ["search_vector"],
+        unique=False,
+        postgresql_using="gin",
+    )
+    op.execute(
+        """
+        UPDATE "group"
+        SET search_vector = to_tsvector(
+            'pg_catalog.simple',
+            concat_ws(' ', name, description, group_type)
+        )
+        """
+    )
+    op.execute(
+        """
+        CREATE TRIGGER "group_search_vector_update"
+        BEFORE INSERT OR UPDATE ON "group"
+        FOR EACH ROW EXECUTE PROCEDURE
+        tsvector_update_trigger(
+            'search_vector',
+            'pg_catalog.simple',
+            'name',
+            'description',
+            'group_type'
+        )
+        """
+    )
+
+
+def downgrade() -> None:
+    op.execute('DROP TRIGGER IF EXISTS "group_search_vector_update" ON "group"')
+    op.drop_index("ix_group_search_vector", table_name="group", postgresql_using="gin")
+    op.drop_column("group", "search_vector")

api/search.py

@@ -16,7 +16,7 @@
 from fastapi import APIRouter
 from fastapi_pagination import paginate
 from fastapi_pagination.utils import disable_installed_extensions_check
-from sqlalchemy import select, func, text, or_
+from sqlalchemy import select, func, text
 from sqlalchemy.orm import Session, selectinload
 
 from api.pagination import CustomPage
@@ -203,23 +203,15 @@ def _get_asset_results(session: Session, q: str, limit: int) -> list[dict]:
 
 
 def _get_project_results(session: Session, q: str, limit: int) -> list[dict]:
-    search_term = f"%{q.strip()}%"
-    query = (
-        select(Group)
-        .where(
-            or_(
-                Group.name.ilike(search_term),
-                Group.description.ilike(search_term),
-                Group.group_type.ilike(search_term),
-            )
-        )
-        .order_by(Group.name)
-        .limit(limit)
-        .options(
+    query = search(
+        select(Group).options(
             selectinload(Group.thing_associations).selectinload(
                 GroupThingAssociation.thing
             )
-        )
+        ),
+        q,
+        vector=Group.search_vector,
+        limit=limit,
     )
 
     projects = session.scalars(query).all()

db/group.py

@@ -19,6 +19,7 @@
 from sqlalchemy import String, Integer, ForeignKey, UniqueConstraint
 from sqlalchemy.ext.associationproxy import association_proxy, AssociationProxy
 from sqlalchemy.orm import relationship, Mapped, mapped_column
+from sqlalchemy_utils import TSVectorType
 
 from core.constants import SRID_WGS84
 from db.base import Base, AutoBaseMixin, ReleaseMixin, lexicon_term
@@ -36,6 +37,9 @@ class Group(Base, AutoBaseMixin, ReleaseMixin):
         Geometry(geometry_type="MULTIPOLYGON", srid=SRID_WGS84, spatial_index=True)
     )
     group_type: Mapped[Optional[str]] = lexicon_term(nullable=True)
+    search_vector: Mapped[TSVectorType] = mapped_column(
+        TSVectorType("name", "description", "group_type")
+    )
 
     # Foreign Keys
     parent_group_id: Mapped[Optional[int]] = mapped_column(