+
+
+ }
+ sx={{ textTransform: 'none' }}
+ >
+ Export
+
+
+
+
+
+ {/* Hidden file input for import */}
+
+
+
+ {/* Instructions when no search */}
+ {!searchQuery && (
+
+
+ Search for Vehicles
+
+
+ Enter a search term like "2024 Toyota Camry" or "Honda Civic" to find vehicles in the
+ catalog.
+
+
+ Use Import/Export buttons to manage catalog data in bulk via CSV files.
+
+
+ )}
+
+ {/* No Results */}
+ {noResults && (
+
+
+ No Results Found
+
+
+ No vehicles match "{searchQuery}". Try a different search term.
+
+
+ )}
+
+ {/* Results Table */}
+ {hasResults && (
+
+ {/* Bulk Actions */}
+ {selectedIds.size > 0 && (
+
+ }
+ onClick={handleBulkDeleteClick}
+ sx={{ textTransform: 'none' }}
+ >
+ Delete Selected ({selectedIds.size})
+
+
+ )}
+
+
+
+
+
+
+ 0 && selectedIds.size < items.length}
+ checked={selectedIds.size === items.length && items.length > 0}
+ onChange={handleSelectAll}
+ size="small"
+ />
+
+ Year
+ Make
+ Model
+ Trim
+ Engine
+ Transmission
+ Actions
+
+
+
+ {items.map((row) => (
+
+
+ handleSelectRow(row.id)}
+ size="small"
+ />
+
+ {row.year}
+ {row.make}
+ {row.model}
+ {row.trim}
+ {row.engineName || '-'}
+ {row.transmissionType || '-'}
+
+
+ handleDeleteClick(row)}
+ >
+
+
+
+
+
+ ))}
+
+
+
+
+
+
+ )}
+
+ {/* Audit Log */}
+
+
+ {/* Delete Confirmation Dialog */}
+
-
- }
- variant="contained"
- onClick={() => setDialogState({ mode: 'create' })}
- sx={{ textTransform: 'none' }}
- >
- Add
-
- }
- variant="outlined"
- color="primary"
- disabled={selectedRows.length !== 1}
- onClick={() =>
- setDialogState({
- mode: 'edit',
- row: selectedRows[0],
- })
- }
- sx={{ textTransform: 'none' }}
- >
- Edit
-
- }
- variant="outlined"
- color="error"
- disabled={selectedRows.length === 0}
- onClick={() => setBulkDialogOpen(true)}
- sx={{ textTransform: 'none' }}
- >
- {selectedRows.length > 1 ? 'Bulk Delete' : 'Delete'}
-
+ {/* Import Preview Dialog */}
+
);
};
-
-interface CatalogCombinationDialogProps {
- open: boolean;
- mode: 'create' | 'edit';
- row?: CatalogGridRow;
- submitting: boolean;
- onSubmit: (values: CatalogCombinationFormValues) => Promise
;
- onClose: () => void;
- existingOptions: {
- makes: CatalogMake[];
- models: CatalogModel[];
- years: CatalogYear[];
- trims: CatalogTrim[];
- };
-}
-
-const CatalogCombinationDialog: React.FC = ({
- open,
- mode,
- row,
- submitting,
- onSubmit,
- onClose,
- existingOptions,
-}) => {
- const {
- control,
- handleSubmit,
- watch,
- reset,
- formState: { errors },
- } = useForm({
- defaultValues: {
- makeName: row?.makeName ?? '',
- modelName: row?.modelName ?? '',
- year: row?.yearValue ?? new Date().getFullYear(),
- trimName: row?.trimName ?? '',
- engineName: row?.engineName ?? '',
- transmission: row?.transmission ?? 'Automatic',
- },
- });
-
- useEffect(() => {
- reset({
- makeName: row?.makeName ?? '',
- modelName: row?.modelName ?? '',
- year: row?.yearValue ?? new Date().getFullYear(),
- trimName: row?.trimName ?? '',
- engineName: row?.engineName ?? '',
- transmission: row?.transmission ?? 'Automatic',
- });
- }, [reset, row]);
-
- const selectedMakeName = watch('makeName');
- const selectedModelName = watch('modelName');
- const selectedYearValue = watch('year');
-
- const filteredModels = useMemo(() => {
- if (!selectedMakeName) {
- return existingOptions.models;
- }
- const make = existingOptions.makes.find(
- (item) => normalizeName(item.name) === normalizeName(selectedMakeName)
- );
- if (!make) {
- return [];
- }
- return existingOptions.models.filter((model) => model.makeId === make.id);
- }, [existingOptions.models, existingOptions.makes, selectedMakeName]);
-
- const filteredTrims = useMemo(() => {
- if (!selectedYearValue) {
- return existingOptions.trims;
- }
-
- const matchingYears = existingOptions.years.filter(
- (item) => item.year === selectedYearValue
- );
-
- if (matchingYears.length === 0) {
- return [];
- }
-
- if (selectedModelName) {
- const model = existingOptions.models.find(
- (item) => normalizeName(item.name) === normalizeName(selectedModelName)
- );
- if (model) {
- const yearForModel = matchingYears.find((year) => year.modelId === model.id);
- if (yearForModel) {
- return existingOptions.trims.filter((trim) => trim.yearId === yearForModel.id);
- }
- }
- }
-
- if (matchingYears.length === 1) {
- return existingOptions.trims.filter((trim) => trim.yearId === matchingYears[0].id);
- }
-
- return existingOptions.trims;
- }, [existingOptions.trims, existingOptions.years, existingOptions.models, selectedYearValue, selectedModelName]);
-
- const submitHandler = handleSubmit((values) => onSubmit(values));
-
- return (
-
- );
-};
` usage with an authenticated fetch that includes the JWT (via existing Axios `apiClient` interceptors), then render via `blob:` object URL.
- - Add a small component like `StationPhoto` used by `StationCard`:
- - `apiClient.get('/stations/photo/:reference', { responseType: 'blob' })`
- - `URL.createObjectURL(blob)` for display
- - `URL.revokeObjectURL` cleanup on unmount / reference change
- - graceful fallback (hide image) on 401/500
-- Backend: no route auth changes required.
-
-Tradeoffs:
-- Slightly more frontend code, but minimal security risk.
-- Must ensure caching behavior is acceptable (browser cache won’t cache `blob:` URLs; rely on backend caching headers + client-side memoization).
-
-### Option B (Remove Images): Simplify Cards
-
-Why: If image delivery adds too much complexity or risk, remove images from station cards.
-
-Implementation outline:
-- Frontend: remove `CardMedia` photo block from `StationCard` and any other station photo rendering.
-- Leave `photoReference` in API/types untouched for now (or remove later as a cleanup task, separate PR).
-- Update any tests that assert on image presence.
-
-Tradeoffs:
-- Reduced UX polish, but simplest and most robust.
-
-## Feature: Navigation Links on Saved/Favorite Stations
-
-### UX Requirements
-
-- On saved station UI (desktop + mobile), provide 3 explicit navigation options:
- - Google Maps
- - Apple Maps
- - Waze
-- “Saved/favorite” is interpreted as “stations in the Saved list”; favorites are a subset.
-
-### URL Construction (Preferred)
-
-Use coordinates if available; fall back to address query if not.
-
-- Google Maps:
- - Preferred: `https://www.google.com/maps/dir/?api=1&destination=LAT,LNG&destination_place_id=PLACE_ID`
- - Fallback: `https://www.google.com/maps/search/?api=1&query=ENCODED_QUERY`
-- Apple Maps:
- - Preferred: `https://maps.apple.com/?daddr=LAT,LNG`
- - Fallback: `https://maps.apple.com/?q=ENCODED_QUERY`
-- Waze:
- - Preferred: `https://waze.com/ul?ll=LAT,LNG&navigate=yes`
- - Fallback: `https://waze.com/ul?q=ENCODED_QUERY&navigate=yes`
-
-Important: some saved stations may have `latitude/longitude = 0` if cache miss; treat `(0,0)` as “no coordinates”.
-
-### UI Placement Recommendation
-
-- Desktop saved list: add a “Navigate” icon button that opens a small menu with the 3 links (cleaner than inline links inside `ListItemText`).
- - File: `frontend/src/features/stations/components/SavedStationsList.tsx`
-- Mobile bottom sheet (station details): add a “Navigate” section with the same 3 links as buttons.
- - File: `frontend/src/features/stations/mobile/StationsMobileScreen.tsx`
-
-## Work Breakdown for Multiple Agents
-
-### Agent 1 — Confirm Root Cause + Backend Adjustments (If Needed)
-
-Deliverables:
-- Confirm whether photo requests return `401` due to missing Authorization.
-- Confirm whether `photoReference` is a raw reference token vs a URL string.
-- Implement backend changes only if Option A2 is chosen.
-
-Files likely touched (Option A2 only):
-- `backend/src/features/stations/api/stations.routes.ts` (remove auth preHandler on photo route)
-- `backend/src/features/stations/api/stations.controller.ts` (add stricter validation; keep cache headers)
-- `backend/src/features/stations/docs/API.md` (update auth expectations for photo endpoint)
-
-### Agent 2 — Frontend Photo Fix (Option A1) OR Photo Removal (Option B)
-
-Deliverables:
-- Option A1: implement authenticated blob photo loading for station cards.
-- Option B: remove station photos from cards cleanly (no layout regressions).
-
-Files likely touched:
-- `frontend/src/features/stations/components/StationCard.tsx`
-- Option A1:
- - Add `frontend/src/features/stations/components/StationPhoto.tsx` (or similar)
- - Potentially update `frontend/src/features/stations/utils/photo-utils.ts`
- - Add unit tests under `frontend/src/features/stations/__tests__/`
-
-### Agent 3 — Navigation Links for Saved Stations (Desktop + Mobile)
-
-Deliverables:
-- Create a single URL-builder utility with tests.
-- Add a “Navigate” menu/section in saved stations UI (desktop + mobile).
-
-Files likely touched:
-- `frontend/src/features/stations/utils/` (new `navigation-links.ts`)
-- `frontend/src/features/stations/components/SavedStationsList.tsx`
-- `frontend/src/features/stations/mobile/StationsMobileScreen.tsx`
-- Optional: reuse in `frontend/src/features/stations/components/StationCard.tsx` (only if product wants it outside Saved)
-
-### Agent 4 — Tests + QA Pass (Update What Breaks)
-
-Deliverables:
-- Update/extend tests to cover:
- - navigation menu/links present for saved stations
- - photo rendering behavior per chosen option
-- Ensure both desktop and mobile flows still pass basic E2E checks.
-
-Files likely touched:
-- `frontend/cypress/e2e/stations.cy.ts`
-- `frontend/src/features/stations/__tests__/components/StationCard.test.tsx`
-- New tests for `navigation-links.ts`
-
-## Acceptance Criteria
-
-- Station photos render on station cards via Option A1 without exposing Google API key (no `401` responses for photo requests in Network).
-- Saved stations show 3 navigation options (Google, Apple, Waze) on both desktop and mobile.
-- No lint/test regressions; container build succeeds.
-
-## Validation (Container-First)
-
-- Rebuild and watch logs: `make rebuild` then `make logs`
-- Optional focused logs: `make logs-frontend` and `make logs-backend`
-- Run feature tests where available (prefer container exec):
- - Backend: `docker compose exec mvp-backend npm test -- features/stations`
- - Frontend: `docker compose exec mvp-frontend npm test -- stations`
- - E2E: `docker compose exec mvp-frontend npm run e2e`
diff --git a/backend/src/features/admin/api/admin.routes.ts b/backend/src/features/admin/api/admin.routes.ts
index 4b8e5a7..929308a 100644
--- a/backend/src/features/admin/api/admin.routes.ts
+++ b/backend/src/features/admin/api/admin.routes.ts
@@ -20,6 +20,7 @@ import { StationOversightService } from '../domain/station-oversight.service';
import { StationsController } from './stations.controller';
import { CatalogController } from './catalog.controller';
import { VehicleCatalogService } from '../domain/vehicle-catalog.service';
+import { CatalogImportService } from '../domain/catalog-import.service';
import { PlatformCacheService } from '../../platform/domain/platform-cache.service';
import { cacheService } from '../../../core/config/redis';
import { pool } from '../../../core/config/database';
@@ -35,7 +36,9 @@ export const adminRoutes: FastifyPluginAsync = async (fastify) => {
// Initialize catalog dependencies
const platformCacheService = new PlatformCacheService(cacheService);
const catalogService = new VehicleCatalogService(pool, platformCacheService);
+ const catalogImportService = new CatalogImportService(pool);
const catalogController = new CatalogController(catalogService);
+ catalogController.setImportService(catalogImportService);
// Admin access verification (used by frontend auth checks)
fastify.get('/admin/verify', {
@@ -205,6 +208,49 @@ export const adminRoutes: FastifyPluginAsync = async (fastify) => {
handler: catalogController.getChangeLogs.bind(catalogController)
});
+ // Search endpoint - full-text search across vehicle_options
+ fastify.get('/admin/catalog/search', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.searchCatalog.bind(catalogController)
+ });
+
+ // Cascade delete endpoints - delete entity and all its children
+ fastify.delete('/admin/catalog/makes/:makeId/cascade', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.deleteMakeCascade.bind(catalogController)
+ });
+
+ fastify.delete('/admin/catalog/models/:modelId/cascade', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.deleteModelCascade.bind(catalogController)
+ });
+
+ fastify.delete('/admin/catalog/years/:yearId/cascade', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.deleteYearCascade.bind(catalogController)
+ });
+
+ fastify.delete('/admin/catalog/trims/:trimId/cascade', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.deleteTrimCascade.bind(catalogController)
+ });
+
+ // Import/Export endpoints
+ fastify.post('/admin/catalog/import/preview', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.importPreview.bind(catalogController)
+ });
+
+ fastify.post('/admin/catalog/import/apply', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.importApply.bind(catalogController)
+ });
+
+ fastify.get('/admin/catalog/export', {
+ preHandler: [fastify.requireAdmin],
+ handler: catalogController.exportCatalog.bind(catalogController)
+ });
+
// Bulk delete endpoint
fastify.delete<{ Params: { entity: CatalogEntity }; Body: BulkDeleteCatalogInput }>('/admin/catalog/:entity/bulk-delete', {
preHandler: [fastify.requireAdmin],
diff --git a/backend/src/features/admin/api/catalog.controller.ts b/backend/src/features/admin/api/catalog.controller.ts
index 5b6d69e..e4a9701 100644
--- a/backend/src/features/admin/api/catalog.controller.ts
+++ b/backend/src/features/admin/api/catalog.controller.ts
@@ -5,11 +5,18 @@
import { FastifyRequest, FastifyReply } from 'fastify';
import { VehicleCatalogService } from '../domain/vehicle-catalog.service';
+import { CatalogImportService } from '../domain/catalog-import.service';
import { logger } from '../../../core/logging/logger';
export class CatalogController {
+ private importService: CatalogImportService | null = null;
+
constructor(private catalogService: VehicleCatalogService) {}
+ setImportService(importService: CatalogImportService): void {
+ this.importService = importService;
+ }
+
// MAKES ENDPOINTS
async getMakes(_request: FastifyRequest, reply: FastifyReply): Promise