Station pages reference SnowObs stations by center; the index moves to Payload

[rchlfryn]

Description

Makes the weather station pages center-aware, moves the /weather/stations index into Payload, gives each station page an editable, ordered list of the SnowObs stations it shows, and gives the Accumulated Precipitation table its own per-center setting. NWAC renders exactly as before.

AvyWeb stores only what SnowObs cannot know: the pages, which stations each one shows and in what order, and which gauges the precip table shows. A station is a (source, stid) reference and nothing more. Names, elevations and coordinates are read live from SnowObs on the public page and in the admin, where the stations field is a table of the page's stations with a search over the center's SnowObs tracking list and an Add button (station/tracking/, which is scoped by the token's client across every source: NWAC 213, SAC 139). There is no local copy of the station list and nothing to sync. See ADR 021 for the reasoning and the API findings behind it.

Everything that assumed NWAC now takes the center: the SnowObs service reads the center's token from its AFP config and sends source as the distinct sources of the stations requested, so a page can mix nwac, snotel and mesowest loggers in one request. Routes 404 for a center with no pages. The /weather/stations index is a normal page under the Weather dropdown, so the URL is unchanged and an editor owns the content. The detail, precipitation and map routes stay native.

Related Issues

Closes #1169. Supersedes #1308 (closed; the sync it added is unnecessary once nothing is mirrored) and the closed #1202. Follow-ups: #1303, #1304.

Key Changes

• fields/stations: stationsField(), a JSON field of ordered { stid, source } pairs with StationsInput: a table of the chosen stations (live name, id, source, elevation, partner) with drag-to-reorder and a remove button per row, and under it a search over the tracking list with an Add button; the search reads "Name · source" and takes one or several picks. A field can name a required variable: the precip list needs precip_accum_one_hour, so its picker offers only stations reporting it and a listed station that has stopped is marked in its row. A station that has left tracking is marked in its row; when SnowObs is unreachable the table shows stored ids and adding is disabled. validateStations keeps the value to well-formed pairs with no repeats.
• collections/StationPages: displayName, slug (unique per tenant), archived, stations. hooks/ensureStationsUnique keeps a station on one page per tenant and names the other page on conflict.
• collections/WeatherStationSettings ("Page Settings" in the admin): one document per center (unique tenant, ADR 016). The Precipitation Table tab holds the stations list; the precip page shows exactly that, top to bottom, dropping a station with no precipitation series and showing "missing" for a gauge that reported none. Station note icons are gone from that table. The Precipitation Columns tab picks which columns the table shows after the station name (services/stations/precipColumns; empty means all). getWeatherStationSettings caches both under the station-pages tag.
• StationPages/endpoints/trackedStations: GET /api/stationPages/tracked-stations?center=<slug>, signed-in only, proxies station/tracking/ joined with station/data/current/ (so each station carries the variables in its latest observation) with the center's token, cached an hour.
• services/snowobs/access.ts: token resolution and SnowObsError, free of the Payload config so collection code can import it. snowobs.ts: fetchStationTimeseries(centerSlug, StationRef[], options). stationTracking.ts: the tracking fetch.
• services/stations/: assemble pages from the array, cache per center, revalidate on change; allStations() maps a bare stid back to its source for the graph-data and CSV routes.
• services/snowobs/deriveColumns.ts: table columns from the variables the stations report, variable-major.
• constants/weatherStations.ts, the built-in weather/stations/page.tsx and the stations collection are gone. The seed gives NWAC a stations page instead of the built-in row.

How to test

1. pnpm seed, then pnpm dev.
2. Admin → Weather → Station Pages: 32 pages. Open Alpental: three rows with live names, ids, elevations and partners, in table order. The search under the table covers the 213 stations NWAC tracks across sources (try "Nooksack", a SNOTEL site); pick one and press Add; drag the handle to reorder; X removes.
   2a. Admin → Weather → Page Settings: one document, titled with the center name. The Precipitation Table tab lists 52 stations; remove one and reload /weather/stations/accumulated-precipitation; its row is gone. The Precipitation Columns tab: pick 24H, 72H and Elevation only, save, reload; the table has four columns.
3. Save with a station that is already on another page: the error names that page.
4. nwac.localhost:3000/weather/stations: the "Weather Data" Payload page, reached from the Weather dropdown.
5. /weather/stations/alpental and /weather/stations/accumulated-precipitation: as on main. Reorder the rows on Alpental and reload; the columns follow.
6. sac.localhost:3000/weather/stations/alpental: 404. /weather/stations/map still renders.

Prod: the stations page under Weather in the NWAC admin already exists; point the nav at it and delete the "Weather Data" built-in row.

Screenshots / Demo video

TODO: the Alpental edit form with the add search open, and the settings document.

Migration Explanation

20260918_203650_station_pages creates station_pages (unique (tenant, slug), stations as JSON) and weather_station_settings (unique tenant, with its precip_columns select table), then for the nwac tenant seeds the 32 pages and their station references from migrations/data/nwacStationPages.ts, a settings document whose precip list is the 19 stations with a gauge in page order, and adds both collections to each center's Admin role. Idempotent: a page or settings document that exists is left alone. The .json beside it is Payload's full schema snapshot, as with every migration. The migration-safety bot flags the ON DELETE set null foreign keys and the ALTER TABLE … ADD on payload_locked_documents_rels; those are Payload's standard clauses.

Future enhancements / Questions

• variable/tracking/ serves per-center units and rounding; it would replace SENSOR_LABELS, UNIT_LABELS and metricUnits.ts (SnowObs says wind's metric unit is m/s; we hardcode km/h).
• Multi-source fetches were verified with three stations over six hours; worth a check at real page sizes and a season window before a center mixes sources.
• The spec lists the public token as accepted on the tracking write endpoints. Not probed; a question for Snowbound, along with whether station/tracking/ stays readable with the public token.
• Station pages: read the display timezone from the center #1303, Station pages for a second center #1304.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YDHvoY5YQsE8iV24NuUqcL

[github-actions]

Preview deployment: https://featxstations-snowobs-overlay.preview.avy-fx.org

[github-actions]

Migration Safety Check

Found 5 potential issues:

20260918_203650_station_pages.ts

Warning (line 19): DELETE keyword detected - review for data loss

FOREIGN KEY (\`tenant_id\`) REFERENCES \`tenants\`(\`id\`) ON UPDATE no action ON DELETE set null

Warning (line 38): DELETE keyword detected - review for data loss

FOREIGN KEY (\`parent_id\`) REFERENCES \`weather_station_settings\`(\`id\`) ON UPDATE no action ON DELETE cascade

Warning (line 54): DELETE keyword detected - review for data loss

FOREIGN KEY (\`tenant_id\`) REFERENCES \`tenants\`(\`id\`) ON UPDATE no action ON DELETE set null

Warning (line 67): ALTER keyword detected - review for data loss

sql`ALTER TABLE \`payload_locked_documents_rels\` ADD \`station_pages_id\` integer REFERENCES station_pages(id);`,

Warning (line 70): ALTER keyword detected - review for data loss

sql`ALTER TABLE \`payload_locked_documents_rels\` ADD \`weather_station_settings_id\` integer REFERENCES weather_station_settings(id);`,

---

Review these patterns and add backup/restore logic if needed. See docs/migration-safety.md for guidance.

[rchlfryn]

Closing in favour of a stack built from this branch's final tree: #1315 (station pages collection, picker, center-dynamic routes, the station_pages migration) and #1316 on top of it (the index page in Payload, Page Settings for the precipitation table; no migration, handled by hand). The history here stays for reference.