cars: Wikimedia Commons photos (cars.photos, card heroes, model gallery + lightbox, brand hero/logo), cars:photos + cars:refresh with --report-new, fold duplicate names (Golf VI, Peugot, Mustang Mach 1, Model 3/Y, i10/i30, Ceed, Lynk & Co)

src/lib/server/db/schema/cars.ts

@@ -7,6 +7,7 @@ import {
 	real,
 	smallint,
 	text,
+	timestamp,
 	uniqueIndex
 } from 'drizzle-orm/pg-core';
 import { carsSchema } from './schemas';
@@ -38,6 +39,16 @@ export const carBrands = carsSchema.table(
 		firstYear: smallint('first_year'),
 		lastYear: smallint('last_year'),
 		sources: text('sources').array().notNull().default([]),
+		/** Wikidata item of the brand/manufacturer and its enwiki article (scripts/cars-photos.ts). */
+		wikidata: text('wikidata'),
+		wikipedia: text('wikipedia'),
+		/** Logo thumbnail (Wikimedia Commons, 250px) and its credit. */
+		logo: text('logo'),
+		logoFile: text('logo_file'),
+		logoAuthor: text('logo_author'),
+		logoLicense: text('logo_license'),
+		/** Hero photo: lead photo of the brand's most common model. */
+		photo: text('photo'),
 		...timestamps
 	},
 	(t) => [uniqueIndex('brands_slug_key').on(t.slug)]
@@ -96,6 +107,13 @@ export const carModels = carsSchema.table(
 		usYears: smallint('us_years').array().notNull().default([]),
 		variantCount: integer('variant_count').notNull().default(0),
 		sources: text('sources').array().notNull().default([]),
+		/** Matched Wikidata item / enwiki article (scripts/cars-photos.ts); null = no confident match. */
+		wikidata: text('wikidata'),
+		wikipedia: text('wikipedia'),
+		/** Lead photo thumbnail URL (960px), denormalised from cars.photos for the card grid. */
+		photo: text('photo'),
+		photoCount: smallint('photo_count').notNull().default(0),
+		photosCheckedAt: timestamp('photos_checked_at', { withTimezone: true }),
 		...timestamps
 	},
 	(t) => [
@@ -135,3 +153,28 @@ export const carVariants = carsSchema.table(
 	},
 	(t) => [index('variants_model_year_idx').on(t.modelId, t.year)]
 );
+
+/** Freely licensed photos from Wikimedia Commons; only thumbnail URLs are stored, nothing is downloaded. */
+export const carPhotos = carsSchema.table(
+	'photos',
+	{
+		id: id(),
+		modelId: integer('model_id')
+			.notNull()
+			.references(() => carModels.id, { onDelete: 'cascade' }),
+		position: smallint('position').notNull(),
+		/** lead (Wikidata image), generation, article (enwiki), commons (Commons category). */
+		kind: text('kind').notNull(),
+		/** Commons file name without the "File:" prefix. */
+		file: text('file').notNull(),
+		caption: text('caption'),
+		/** 960px thumbnail on upload.wikimedia.org; other standard widths are derived from it. */
+		thumb: text('thumb').notNull(),
+		width: integer('width').notNull(),
+		height: integer('height').notNull(),
+		author: text('author'),
+		license: text('license'),
+		licenseUrl: text('license_url')
+	},
+	(t) => [uniqueIndex('photos_model_position_key').on(t.modelId, t.position)]
+);