Adding filters and controls for scopes

2026-07-27 14:59:03 -03:00
1 parent 3febc15a8f
commit 2587ccbceb
@@ -31,20 +31,6 @@ async def list_all(
    return list(result.scalars().all())


-async def list_by_part_type(
-    db: AsyncSession, part_type_id: int, skip: int = 0, limit: int = 1000
-) -> list[AugmentedPart]:
-    """All augmented parts of a given part type, ordered by description."""
-    result = await db.execute(
-        select(AugmentedPart)
-        .where(AugmentedPart.part_type_id == part_type_id)
-        .order_by(AugmentedPart.description)
-        .offset(skip)
-        .limit(limit)
-    )
-    return list(result.scalars().all())
-
-
 async def get_many(db: AsyncSession, ids: list[int]) -> list[AugmentedPart]:
    """Fetch augmented parts by id in one query (selectin relationships loaded)."""
    if not ids:
@@ -19,9 +19,22 @@ SCOPE_TYPE_NAME = "Scope"
 _LABEL_RANK = {FitLabel.EXACT.value: 2, FitLabel.POSSIBLE.value: 1}


-async def build(db: AsyncSession) -> dict:
+async def build(
+    db: AsyncSession,
+    *,
+    description: str = "",
+    manufacturer_id: int | None = None,
+    scope_model_id: int | None = None,
+    sub_part_type_id: int | None = None,
+    fits_part_type_id: int | None = None,
+) -> dict:
    """Return the context for ``scopes.html``.

+    The scope rows are narrowed by the scope-attribute filters (``description``
+    matches the scope's description; the ``*_id`` filters match exactly).
+    ``fits_part_type_id`` keeps only scopes that have at least one (non-``none``)
+    fit for that part type.
+
    Shape::

        {
@@ -47,7 +60,15 @@ async def build(db: AsyncSession) -> dict:
    if scope_type is None:
        return {"column_types": column_types, "rows": []}

-    scopes = await augmented_part_crud.list_by_part_type(db, scope_type.id)
+    scopes = await augmented_part_crud.list_filtered(
+        db,
+        description=description,
+        manufacturer_id=manufacturer_id,
+        scope_model_id=scope_model_id,
+        sub_part_type_id=sub_part_type_id,
+        part_type_id=scope_type.id,
+        limit=1000,
+    )
    scope_ids = {s.id for s in scopes}
    if not scope_ids:
        return {"column_types": column_types, "rows": []}
@@ -97,6 +118,8 @@ async def build(db: AsyncSession) -> dict:
            )
            for type_id, entries in cell_map[scope.id].items()
        }
+        if fits_part_type_id is not None and fits_part_type_id not in cells:
+            continue  # scope has no fit for the required accessory type
        rows.append(
            {"scope": scope, "info": infos.get(scope.id), "cells": cells}
        )
@@ -0,0 +1,71 @@
+{%- macro mag(v) -%}{{ v | int if v == v | int else v | round(1) }}{%- endmacro -%}
+{%- macro magnification(info) -%}
+  {%- if info and info.magnification_min is not none and info.magnification_max is not none -%}
+    {{ mag(info.magnification_min) }}–{{ mag(info.magnification_max) }}×
+  {%- elif info and info.magnification_min is not none -%}
+    {{ mag(info.magnification_min) }}×
+  {%- elif info and info.magnification_max is not none -%}
+    {{ mag(info.magnification_max) }}×
+  {%- else -%}
+    <span class="muted">—</span>
+  {%- endif -%}
+{%- endmacro -%}
+<div id="scopes-table-card" class="card" style="overflow-x:auto">
+  <table class="table">
+    <thead>
+      <tr>
+        <th>Scope</th>
+        <th>Manufacturer</th>
+        <th>Model</th>
+        <th>Type</th>
+        <th>Magnification</th>
+        <th>Objective thread</th>
+        {% for ct in column_types %}
+          <th>{{ ct.name }}</th>
+        {% endfor %}
+      </tr>
+    </thead>
+    <tbody>
+      {% for row in rows %}
+        {% set scope = row.scope %}
+        {% set info = row.info %}
+        <tr>
+          <td>
+            <strong>{{ scope.description }}</strong>
+            {% if scope.sku %}<br><span class="muted">{{ scope.sku }}</span>{% endif %}
+          </td>
+          <td>{{ scope.manufacturer.name if scope.manufacturer else "—" }}</td>
+          <td>{{ scope.scope_model.name if scope.scope_model else "—" }}</td>
+          <td>{{ scope.sub_part_type.name if scope.sub_part_type else "—" }}</td>
+          <td>{{ magnification(info) }}</td>
+          <td>
+            {% if info and info.objective_thread_pitch %}
+              {{ info.objective_thread_pitch }}
+            {% else %}<span class="muted">—</span>{% endif %}
+          </td>
+          {% for ct in column_types %}
+            {% set entries = row.cells.get(ct.id) %}
+            <td>
+              {% if entries %}
+                {% for e in entries %}
+                  <div class="fit-cell-item">
+                    <span class="fit-badge fit-badge-{{ e.label }}">{{ e.label | capitalize }}</span>
+                    {{ e.part.description | truncate(48) }}
+                  </div>
+                {% endfor %}
+              {% else %}
+                <span class="muted">—</span>
+              {% endif %}
+            </td>
+          {% endfor %}
+        </tr>
+      {% else %}
+        <tr>
+          <td colspan="{{ 6 + column_types | length }}" class="muted">
+            No scopes match your search.
+          </td>
+        </tr>
+      {% endfor %}
+    </tbody>
+  </table>
+</div>
@@ -10,77 +10,40 @@
    is a confirmed fit, <span class="fit-badge fit-badge-possible">Possible</span> a candidate.
  </p>

-  {%- macro mag(v) -%}{{ v | int if v == v | int else v | round(1) }}{%- endmacro -%}
-  {% macro magnification(info) -%}
-    {%- if info and info.magnification_min is not none and info.magnification_max is not none -%}
-      {{ mag(info.magnification_min) }}–{{ mag(info.magnification_max) }}×
-    {%- elif info and info.magnification_min is not none -%}
-      {{ mag(info.magnification_min) }}×
-    {%- elif info and info.magnification_max is not none -%}
-      {{ mag(info.magnification_max) }}×
-    {%- else -%}
-      <span class="muted">—</span>
-    {%- endif -%}
-  {%- endmacro %}
-
-  <div class="card" style="overflow-x:auto">
-    <table class="table">
-      <thead>
-        <tr>
-          <th>Scope</th>
-          <th>Manufacturer</th>
-          <th>Model</th>
-          <th>Type</th>
-          <th>Magnification</th>
-          <th>Objective thread</th>
-          {% for ct in column_types %}
-            <th>{{ ct.name }}</th>
-          {% endfor %}
-        </tr>
-      </thead>
-      <tbody>
-        {% for row in rows %}
-          {% set scope = row.scope %}
-          {% set info = row.info %}
-          <tr>
-            <td>
-              <strong>{{ scope.description }}</strong>
-              {% if scope.sku %}<br><span class="muted">{{ scope.sku }}</span>{% endif %}
-            </td>
-            <td>{{ scope.manufacturer.name if scope.manufacturer else "—" }}</td>
-            <td>{{ scope.scope_model.name if scope.scope_model else "—" }}</td>
-            <td>{{ scope.sub_part_type.name if scope.sub_part_type else "—" }}</td>
-            <td>{{ magnification(info) }}</td>
-            <td>
-              {% if info and info.objective_thread_pitch %}
-                {{ info.objective_thread_pitch }}
-              {% else %}<span class="muted">—</span>{% endif %}
-            </td>
-            {% for ct in column_types %}
-              {% set entries = row.cells.get(ct.id) %}
-              <td>
-                {% if entries %}
-                  {% for e in entries %}
-                    <div class="fit-cell-item">
-                      <span class="fit-badge fit-badge-{{ e.label }}">{{ e.label | capitalize }}</span>
-                      {{ e.part.description | truncate(48) }}
-                    </div>
-                  {% endfor %}
-                {% else %}
-                  <span class="muted">—</span>
-                {% endif %}
-              </td>
-            {% endfor %}
-          </tr>
-        {% else %}
-          <tr>
-            <td colspan="{{ 6 + column_types | length }}" class="muted">
-              No scopes recorded yet.
-            </td>
-          </tr>
+  <div class="filter-bar">
+    <form hx-get="/scopes/filter"
+          hx-target="#scopes-table-card"
+          hx-trigger="input delay:300ms, change"
+          hx-swap="outerHTML">
+      <input type="text" name="description" placeholder="Search scopes…"
+             value="{{ filters.description or '' }}">
+      <select name="manufacturer_id">
+        <option value="">All manufacturers</option>
+        {% for m in manufacturers %}
+          <option value="{{ m.id }}" {{ "selected" if filters.manufacturer_id and filters.manufacturer_id|int == m.id }}>{{ m.name }}</option>
        {% endfor %}
-      </tbody>
-    </table>
+      </select>
+      <select name="scope_model_id">
+        <option value="">All models</option>
+        {% for sm in scope_models %}
+          <option value="{{ sm.id }}" {{ "selected" if filters.scope_model_id and filters.scope_model_id|int == sm.id }}>{{ sm.name }}</option>
+        {% endfor %}
+      </select>
+      <select name="sub_part_type_id">
+        <option value="">All types</option>
+        {% for spt in sub_part_types %}
+          <option value="{{ spt.id }}" {{ "selected" if filters.sub_part_type_id and filters.sub_part_type_id|int == spt.id }}>{{ spt.name }}</option>
+        {% endfor %}
+      </select>
+      <select name="fits_part_type_id">
+        <option value="">Fits any accessory</option>
+        {% for ct in column_types %}
+          <option value="{{ ct.id }}" {{ "selected" if filters.fits_part_type_id and filters.fits_part_type_id|int == ct.id }}>Fits {{ ct.name }}</option>
+        {% endfor %}
+      </select>
+    </form>
  </div>
+
+  {% include "_scopes_table_card.html" %}
 </main>
 {% endblock %}
@@ -1,7 +1,8 @@
 """Top-level, read-only scope fit guide at ``/scopes``.

 The site's primary view: a table of scopes with their specs, plus one column per
-non-Scope part type listing the accessories that fit each scope.
+non-Scope part type listing the accessories that fit each scope. Supports HTMX
+search/filter over scope attributes and required accessory fits.
 """

 from fastapi import APIRouter, Depends, Request
@@ -9,6 +10,10 @@ from fastapi.responses import HTMLResponse
 from sqlalchemy.ext.asyncio import AsyncSession

 from app.core.database import get_db
+from app.crud import manufacturer as manufacturer_crud
+from app.crud import part_type as part_type_crud
+from app.crud import scope_model as scope_model_crud
+from app.crud import sub_part_type as sub_part_type_crud
 from app.models.user import User
 from app.services import scope_guide as scope_guide_service
 from app.web.admin import web_require
@@ -17,13 +22,82 @@ from app.web.templates import templates
 router = APIRouter(include_in_schema=False)


+def _to_int(value: str) -> int | None:
+    return int(value) if value.strip() else None
+
+
+async def _build(db: AsyncSession, filters: dict) -> dict:
+    """Run the guide query for the given raw (string) filter values."""
+    return await scope_guide_service.build(
+        db,
+        description=filters["description"],
+        manufacturer_id=_to_int(filters["manufacturer_id"]),
+        scope_model_id=_to_int(filters["scope_model_id"]),
+        sub_part_type_id=_to_int(filters["sub_part_type_id"]),
+        fits_part_type_id=_to_int(filters["fits_part_type_id"]),
+    )
+
+
+async def _filter_options(db: AsyncSession) -> dict:
+    """Dropdown option lists for the filter bar."""
+    scope_type = await part_type_crud.get_by_name(
+        db, scope_guide_service.SCOPE_TYPE_NAME
+    )
+    sub_part_types = [
+        spt
+        for spt in await sub_part_type_crud.list_all(db, limit=1000)
+        if scope_type is not None and spt.part_type_id == scope_type.id
+    ]
+    return {
+        "manufacturers": await manufacturer_crud.list_all(db, limit=1000),
+        "scope_models": await scope_model_crud.list_all(db, limit=1000),
+        "sub_part_types": sub_part_types,
+    }
+
+
@router.get("/scopes", response_class=HTMLResponse)
 async def scopes_page(
    request: Request,
+    description: str = "",
+    manufacturer_id: str = "",
+    scope_model_id: str = "",
+    sub_part_type_id: str = "",
+    fits_part_type_id: str = "",
    db: AsyncSession = Depends(get_db),
    user: User = Depends(web_require("augmented_parts:read", "fits:read")),
 ):
-    guide = await scope_guide_service.build(db)
+    filters = {
+        "description": description,
+        "manufacturer_id": manufacturer_id,
+        "scope_model_id": scope_model_id,
+        "sub_part_type_id": sub_part_type_id,
+        "fits_part_type_id": fits_part_type_id,
+    }
+    guide = await _build(db, filters)
    return templates.TemplateResponse(
-        request, "scopes.html", {"user": user, **guide}
+        request,
+        "scopes.html",
+        {"user": user, "filters": filters, **guide, **(await _filter_options(db))},
    )
+
+
+@router.get("/scopes/filter", response_class=HTMLResponse)
+async def scopes_filter(
+    request: Request,
+    description: str = "",
+    manufacturer_id: str = "",
+    scope_model_id: str = "",
+    sub_part_type_id: str = "",
+    fits_part_type_id: str = "",
+    db: AsyncSession = Depends(get_db),
+    _: User = Depends(web_require("augmented_parts:read", "fits:read")),
+):
+    filters = {
+        "description": description,
+        "manufacturer_id": manufacturer_id,
+        "scope_model_id": scope_model_id,
+        "sub_part_type_id": sub_part_type_id,
+        "fits_part_type_id": fits_part_type_id,
+    }
+    guide = await _build(db, filters)
+    return templates.TemplateResponse(request, "_scopes_table_card.html", guide)