fix(seo): canonical self-deindexing on /docs/*, truthful llms.txt, real sitemap dates, RSS feed, breadcrumbs, per-article OG images

- /docs subpages canonicalized to /docs and had no descriptions; each now
  uses pageMetadata with its own path (was: Google could index at most one)
- llms.txt claimed Team EUR 149, RBAC/SLA and BYO-cloud that do not exist;
  regenerated from lib/seo.ts truth + new llms-full.txt with docs content
- sitemap stamped lastModified=now on every request; now real per-route dates
  from new lib/articles.ts registry (single source for guides index/sitemap/RSS)
- new /feed.xml RSS 2.0 route + alternates link in root layout
- articleJsonLd: image (per-guide opengraph-image via lib/og-article.tsx),
  Person author, wordCount; new breadcrumbJsonLd on guides + docs
- GSC verification via NEXT_PUBLIC_GSC_VERIFICATION (documented in .env.example)
- dropped fabricated Enterprise EUR 499 offer from SoftwareApplication JSON-LD
- article-shell: OL/Table/Note primitives for upcoming articles

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXUwmPVRTD8AKQtio6gCN5
This commit is contained in:
Marco Sadjadi
2026-07-08 23:00:02 +02:00
parent 3dc65e4f4d
commit cba45402ce
25 changed files with 652 additions and 75 deletions

View File

@@ -97,6 +97,8 @@ const SOFTWARE_FEATURES = [
'Self-hostable control plane with BYO Postgres and Redis',
];
// Enterprise is deliberately absent: its price is "Custom" and schema.org
// Offers with fabricated numeric prices are exactly what commit ee4713f purged.
const OFFERS = [
{
name: 'Hobby',
@@ -114,12 +116,6 @@ const OFFERS = [
price: '199',
description: '25 servers, 10M tool calls/month, audit log, shared Slack support.',
},
{
name: 'Enterprise',
price: '499',
description:
'Unlimited servers; custom infrastructure and data residency on request; dedicated hosting and SSO/SAML scoped per contract; customer success.',
},
];
/** Organization + WebSite + SoftwareApplication graph — emitted sitewide. */
@@ -191,7 +187,17 @@ export function articleJsonLd(opts: {
path: string;
datePublished: string;
dateModified?: string;
/**
* Absolute or site-relative image URL. Defaults to the route's generated
* opengraph-image (1200×630), which satisfies Google Discover's large-image
* requirement once the route ships an opengraph-image.tsx.
*/
image?: string;
/** Named human author. Falls back to the Organization. */
authorName?: string;
wordCount?: number;
}): object {
const image = opts.image ?? `${SITE_URL}${opts.path}/opengraph-image`;
return {
'@context': 'https://schema.org',
'@type': 'TechArticle',
@@ -199,11 +205,29 @@ export function articleJsonLd(opts: {
description: opts.description,
url: `${SITE_URL}${opts.path}`,
mainEntityOfPage: { '@type': 'WebPage', '@id': `${SITE_URL}${opts.path}` },
image: image.startsWith('http') ? image : `${SITE_URL}${image}`,
datePublished: opts.datePublished,
dateModified: opts.dateModified ?? opts.datePublished,
inLanguage: 'en',
author: { '@id': `${SITE_URL}/#organization` },
author: opts.authorName
? { '@type': 'Person', name: opts.authorName }
: { '@id': `${SITE_URL}/#organization` },
publisher: { '@id': `${SITE_URL}/#organization` },
...(opts.wordCount ? { wordCount: opts.wordCount } : {}),
};
}
/** BreadcrumbList structured data. Pass the trail from root to current page. */
export function breadcrumbJsonLd(trail: { name: string; path: string }[]): object {
return {
'@context': 'https://schema.org',
'@type': 'BreadcrumbList',
itemListElement: trail.map((crumb, i) => ({
'@type': 'ListItem',
position: i + 1,
name: crumb.name,
item: `${SITE_URL}${crumb.path}`,
})),
};
}