feat(competitions): sitemap, OG images and JSON-LD

[AnayDhawan]

Blocked by #198.

50 competition detail pages are 50 new indexable URLs, and this is the kind of content people search for by name. Give them proper metadata.

Files

• src/app/sitemap.ts - add competition routes
• src/app/competitions/[slug]/opengraph-image.tsx - new
• src/lib/jsonld.ts - extend, it already exists and is tested
• src/app/competitions/[slug]/page.tsx - wire up generateMetadata

Sitemap

src/app/sitemap.ts already maps over places (:14) and docsNav (:20). Add /competitions and every /competitions/<id>.

Use a real lastModified from verified.on or the most recently changed date in the record. Do not use new Date(). That is precisely the bug open issue #163 exists for on the places side, so do not reproduce it here.

OG images

src/app/city/[slug]/opengraph-image.tsx is the working precedent, including :150-169 where it renders category counts into the image. @vercel/og 1.0.1 is already a dependency.

Per competition: name, organizer, category, next deadline. Keep it legible at thumbnail size, which means a short name and large type rather than the full metadata table.

JSON-LD

src/lib/jsonld.ts exists and has tests at src/lib/jsonld.test.ts. Follow that structure.

Competitions map cleanly onto schema.org Event or, for scholarships, EducationalOccupationalProgram. Include name, description, startDate and endDate from dates[], organizer, url, eventAttendanceMode from format, and isAccessibleForFree from fee.

Only emit dates that are estimated: false. Publishing an estimated date as structured data invites search engines to present a guess as a fact.

Acceptance criteria

• All 51 routes in the sitemap with real lastModified values
• Every detail page has a distinct title and description
• OG image renders and is legible as a thumbnail
• JSON-LD validates in Google's Rich Results Test
• Estimated dates excluded from structured data
• Unit tests extended in src/lib/jsonld.test.ts

[yakew7]

Implemented in 0186878:

• src/app/sitemap.ts: added /competitions plus all 50 detail routes (51 total, matching the acceptance count). Each detail route's lastModified is real: verified.on when a contributor has re-checked the record, else the latest of that record's own dates[] entries - never new Date(), which is exactly the seo: sitemap sets lastModified = new Date() on every build, destroying the lastmod signal #163 bug. The /competitions index uses the freshest of all 50. Added src/app/sitemap.test.ts (there wasn't one before) asserting all 51 routes are present and none of their lastModified values land within a second of "now" (the new Date() smell).
• src/lib/jsonld.ts: competitionJsonLd/competitionJsonLdScript. @type is Event, or EducationalOccupationalProgram for the scholarship category. Includes name, description, url (StudyMap's own page, matching placeJsonLd's convention), organizer (nested Organization with organizer_url), eventAttendanceMode mapped from format, and isAccessibleForFree from fee. startDate/endDate are built only from dates[] entries with estimated: false, sorted for the earliest/latest, and omitted entirely when every date on the record is still estimated - so no guess is ever published as fact.
• src/app/competitions/[slug]/page.tsx: renders that JSON-LD in a <script> tag. generateMetadata already gave every page a distinct title (the competition name) and description (its own description), so no change needed there.
• src/app/competitions/[slug]/opengraph-image.tsx: new, modeled directly on src/app/city/[slug]/opengraph-image.tsx (same Space Grotesk font-loading approach with a system-font fallback). Shows category, competition name (capped height so a long name can't push the rest of the card off-canvas), organizer, and the next upcoming date - legible at thumbnail size, large type, no full metadata table.
• src/lib/og.ts: added ogCompetitionSummary (pure, testable) alongside the existing ogCitySummary, used by the new image.

Extended src/lib/jsonld.test.ts and src/lib/og.test.ts with full coverage of the new functions.

Tests: npm run typecheck, npm run lint, npm run test:unit (290 passing), npm run validate:competitions, npm run check:freshness, and npm run build all pass - the build generates all 50 competition OG images and the /docs/competitions page from #206 stays static. JSON-LD structure follows the same pattern already validated by the existing placeJsonLd tests; I did not have a way to run this through Google's actual Rich Results Test tool in this environment, so that specific acceptance box is worth a manual check before/after deploy.