Railway stations MVP (US1): schema kind + reference seam + search/mark

Add 'station' as a place kind backed by a Wikidata (CC0) railway dataset,
resolved through the reference-data seam like airports/heritage.

- schema: kind enum gains "station"; SCHEMA_VERSION bump + version history
- reference: Station type, allStations/stationById/searchStations/stationsOf,
  STATIONS_URL fetch mapping .stations (absent -> empty), sync init param
- coord resolvers gain a station branch (distance, myPlaces, placeCoords,
  StoryMap, exportCsv); place flag 🚉
- search: name-only station results + country-intent station block
- Places: placeMeta + row glyph for stations; i18n places.meta.station
- dev fixture public/reference/railways.json (13 real stations, placeholder
  coords) until `pnpm railways` fetches the full CC0 set
- tests: tests/unit/stations.spec.ts (seam), tests/e2e/stations.spec.ts
  (offline search + mark, zero egress)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014W6tgHRgLEugCsbKC9ccST

Author: davd-gzl

apps/postcards/public/reference/railways.json

@@ -0,0 +1,24 @@
+{
+  "_source": {
+    "dataset": "Wikidata railway stations (instance of Q55488)",
+    "url": "https://query.wikidata.org/",
+    "license": "CC0-1.0",
+    "retrieved": "2026-07-24",
+    "note": "DEVELOPMENT FIXTURE — a small placeholder set of well-known mainline stations (approximate public coordinates, non-authoritative ids). Replace with the authoritative Wikidata CC0 dataset by running `pnpm railways` where query.wikidata.org is reachable."
+  },
+  "stations": [
+    { "id": "fx-paris-gare-de-lyon", "name": "Paris Gare de Lyon", "countryIso2": "FR", "subdivisionId": null, "lat": 48.8443, "lon": 2.3735 },
+    { "id": "fx-paris-gare-du-nord", "name": "Paris Gare du Nord", "countryIso2": "FR", "subdivisionId": null, "lat": 48.8809, "lon": 2.3553 },
+    { "id": "fx-lyon-part-dieu", "name": "Lyon Part-Dieu", "countryIso2": "FR", "subdivisionId": null, "lat": 45.7605, "lon": 4.8592 },
+    { "id": "fx-marseille-saint-charles", "name": "Marseille Saint-Charles", "countryIso2": "FR", "subdivisionId": null, "lat": 43.3026, "lon": 5.3804 },
+    { "id": "fx-london-st-pancras", "name": "London St Pancras International", "countryIso2": "GB", "subdivisionId": null, "lat": 51.5313, "lon": -0.1263 },
+    { "id": "fx-london-kings-cross", "name": "London King's Cross", "countryIso2": "GB", "subdivisionId": null, "lat": 51.5312, "lon": -0.1236 },
+    { "id": "fx-berlin-hauptbahnhof", "name": "Berlin Hauptbahnhof", "countryIso2": "DE", "subdivisionId": null, "lat": 52.5250, "lon": 13.3694 },
+    { "id": "fx-munchen-hauptbahnhof", "name": "München Hauptbahnhof", "countryIso2": "DE", "subdivisionId": null, "lat": 48.1402, "lon": 11.5586 },
+    { "id": "fx-roma-termini", "name": "Roma Termini", "countryIso2": "IT", "subdivisionId": null, "lat": 41.9010, "lon": 12.5020 },
+    { "id": "fx-madrid-atocha", "name": "Madrid Puerta de Atocha", "countryIso2": "ES", "subdivisionId": null, "lat": 40.4065, "lon": -3.6895 },
+    { "id": "fx-tokyo-station", "name": "Tokyo Station", "countryIso2": "JP", "subdivisionId": null, "lat": 35.6812, "lon": 139.7671 },
+    { "id": "fx-kyoto-station", "name": "Kyoto Station", "countryIso2": "JP", "subdivisionId": null, "lat": 34.9858, "lon": 135.7588 },
+    { "id": "fx-newyork-penn", "name": "New York Penn Station", "countryIso2": "US", "subdivisionId": null, "lat": 40.7506, "lon": -73.9935 }
+  ]
+}

apps/postcards/src/features/backup/exportCsv.ts

@@ -19,6 +19,10 @@ function coordOf(ref: ReferenceData, v: Visit): { lat: number; lon: number } | n
     const a = ref.airportById(p.id);
     return a ? { lat: a.lat, lon: a.lon } : null;
   }
+  if (p.kind === "station") {
+    const s = ref.stationById(p.id);
+    return s ? { lat: s.lat, lon: s.lon } : null;
+  }
   if (p.kind === "custom" && p.lat != null && p.lon != null) return { lat: p.lat, lon: p.lon };
   return null;
 }

apps/postcards/src/features/journal/StoryMap.tsx

@@ -36,6 +36,10 @@ function coordOf(ref: ReferenceData, p: PlaceRef): { lon: number; lat: number }
     const a = ref.airportById(p.id);
     return a ? { lon: a.lon, lat: a.lat } : null;
   }
+  if (p.kind === "station") {
+    const s = ref.stationById(p.id);
+    return s ? { lon: s.lon, lat: s.lat } : null;
+  }
   if (p.kind === "custom") {
     return p.lat != null && p.lon != null ? { lon: p.lon, lat: p.lat } : null;
   }

apps/postcards/src/features/travel/distance.ts

@@ -12,6 +12,10 @@ export function coordsOf(place: PlaceRef, ref: ReferenceData): { lon: number; la
     const a = ref.airportById(place.id);
     return a ? { lon: a.lon, lat: a.lat } : null;
   }
+  if (place.kind === "station") {
+    const s = ref.stationById(place.id);
+    return s ? { lon: s.lon, lat: s.lat } : null;
+  }
   if (place.kind === "heritage") {
     const h = ref.heritageById(place.id);
     // Some sites have no coordinate in the source (stored as 0,0) — treat as unknown.

apps/postcards/src/features/travel/myPlaces.ts

@@ -6,7 +6,7 @@ import { countryFlag } from "../../lib/format/format";
 /** The emoji that stands in for a place in the trip UI — a plane for airports,
  *  else the country flag. One definition shared by every trip picker/row. */
 export const placeFlag = (p: PlaceRef): string =>
-  p.kind === "airport" ? "✈️" : countryFlag(p.countryId);
+  p.kind === "airport" ? "✈️" : p.kind === "station" ? "🚉" : countryFlag(p.countryId);
 
 // The pool the trip composer picks stops from (spec 019, fast-reconstruction): ONLY
 // places you've already been — your visited records plus every place already used in
@@ -36,6 +36,10 @@ function coordOf(ref: ReferenceData, p: PlaceRef): { lon: number; lat: number }
     const a = ref.airportById(p.id);
     return a ? { lon: a.lon, lat: a.lat } : null;
   }
+  if (p.kind === "station") {
+    const s = ref.stationById(p.id);
+    return s ? { lon: s.lon, lat: s.lat } : null;
+  }
   if (p.kind === "heritage") {
     const h = ref.heritageById(p.id);
     return h && (h.lat !== 0 || h.lon !== 0) ? { lon: h.lon, lat: h.lat } : null;

apps/postcards/src/features/visits/PlacesScreen.tsx

@@ -134,6 +134,10 @@ function placeMeta(
     const a = ref.airportById(v.place.id);
     return { coord: a ? { lon: a.lon, lat: a.lat } : null, sub: `${t("places.meta.airport")} · ${country}` };
   }
+  if (v.place.kind === "station") {
+    const s = ref.stationById(v.place.id);
+    return { coord: s ? { lon: s.lon, lat: s.lat } : null, sub: `${t("places.meta.station")} · ${country}` };
+  }
   if (v.place.kind === "heritage") {
     const h = ref.heritageById(v.place.id);
     const coord = h && (h.lat !== 0 || h.lon !== 0) ? { lon: h.lon, lat: h.lat } : null;
@@ -299,7 +303,9 @@ const VisitRow = memo(function VisitRow({ v, wishlist }: { v: Visit; wishlist?:
       ? heritageGlyph(ref.heritageById(v.place.id)?.category)
       : v.place.kind === "airport"
         ? "✈️"
-        : countryFlag(v.place.countryId);
+        : v.place.kind === "station"
+          ? "🚉"
+          : countryFlag(v.place.countryId);
 
   return (
     <li className={"city-row compact" + (menuOpen ? " menu-open" : "")}>
@@ -391,7 +397,9 @@ const BrowseRowItem = memo(function BrowseRowItem({ r }: { r: BrowseRow }) {
       ? countryFlag(r.countryIso2)
       : r.kind === "airport"
         ? "✈️"
-        : heritageGlyph(r.category);
+        : r.kind === "station"
+          ? "🚉"
+          : heritageGlyph(r.category);
   // Only a real dataset category becomes a tag — never an invented one (FR-008).
   const cat =
     r.kind === "heritage" &&

apps/postcards/src/features/visits/search.ts

@@ -46,6 +46,15 @@ export function searchPlaces(ref: ReferenceData, query: string, limit = 8): Sear
     };
   });
 
+  // Railway stations — name-only (a QID is not a code), like heritage.
+  const stationResults: SearchResult[] = ref.searchStations(q, limit).map((s) => {
+    const country = ref.countryByIso2(s.countryIso2);
+    return {
+      place: { kind: "station", id: s.id, name: s.name, countryId: s.countryIso2 },
+      detail: country ? `Station · ${country.name}` : "Station",
+    };
+  });
+
   // A query typed as an explicit UPPERCASE 3-letter IATA code (e.g. "LAX", "CDG")
   // means the airport — surface it first, ahead of a like-named city ("Laxou").
   // Lowercase/mixed prefix typing ("por", "san") is treated as a place name, so
@@ -60,7 +69,7 @@ export function searchPlaces(ref: ReferenceData, query: string, limit = 8): Sear
       limit * 2,
     );
   }
-  const grouped = [...countryResults, ...cityResults, ...airportResults, ...heritageResults];
+  const grouped = [...countryResults, ...cityResults, ...airportResults, ...stationResults, ...heritageResults];
   // Rank by HOW a name matches, not by what kind it is: "Ista" must put
   // Istanbul (prefix) above Afghanistan (mid-word hit). The sort is stable, so
   // within a rank the kind order above still breaks ties.
@@ -97,12 +106,19 @@ export function searchPlaces(ref: ReferenceData, query: string, limit = 8): Sear
         place: { kind: "airport", id: a.id, name: `${a.name} (${a.id})`, countryId: iso2 },
         detail: `Airport · ${[a.city, cName].filter(Boolean).join(", ")}`,
       }));
+    const sta: SearchResult[] = ref
+      .stationsOf(iso2)
+      .slice(0, limit)
+      .map((s) => ({
+        place: { kind: "station" as const, id: s.id, name: s.name, countryId: iso2 },
+        detail: `Station · ${cName}`,
+      }));
     const country: SearchResult = {
       place: { kind: "country", id: iso2, name: cName, countryId: iso2 },
       detail: "Country",
     };
     const seen = new Set<string>();
-    return [country, ...her, ...air, ...ranked]
+    return [country, ...her, ...air, ...sta, ...ranked]
       .filter((r) => {
         const k = `${r.place.kind}:${r.place.id}`;
         if (seen.has(k)) return false;

apps/postcards/src/lib/i18n/en.ts

@@ -333,6 +333,7 @@ export const en = {
   "places.rowMenu.notePlaceholder": "A short note",
   "places.row.removedToast": "Removed {name}",
   "places.meta.airport": "Airport",
+  "places.meta.station": "Station",
   "places.meta.monument": "Monument",
   "places.meta.yourPlace": "Your place",
   "places.meta.country": "Country",

apps/postcards/src/lib/i18n/fr.ts

@@ -327,6 +327,7 @@ export const fr: Messages = {
   "places.rowMenu.notePlaceholder": "Une courte note",
   "places.row.removedToast": "{name} retiré",
   "places.meta.airport": "Aéroport",
+  "places.meta.station": "Gare",
   "places.meta.monument": "Monument",
   "places.meta.yourPlace": "Votre lieu",
   "places.meta.country": "Pays",

apps/postcards/src/lib/i18n/ko.ts

@@ -327,6 +327,7 @@ export const ko: Messages = {
   "places.rowMenu.notePlaceholder": "짧은 메모",
   "places.row.removedToast": "{name} 삭제됨",
   "places.meta.airport": "공항",
+  "places.meta.station": "역",
   "places.meta.monument": "기념물",
   "places.meta.yourPlace": "내 장소",
   "places.meta.country": "국가",