QC Master Test Plan
AEO / structured-data checks
AEO / structured-data checks — documentation pending.
Complete
AEO QC verifies that every page emits the right JSON-LD structured data, that the JSON-LD validates against schema.org, and that entity references in mentions/about/superEvent properties resolve to real URLs. Where SEO QC is about metadata, AEO QC is about machine-readable semantic claims — the layer that powers Knowledge Panels, event carousels, and AI answer surfaces.
Per-route JSON-LD checklist
- Every public route emits at least one <script type="application/ld+json"> in the page <head>. Routes missing this fail the AEO smoke layer.
- Emitted JSON-LD parses as valid JSON (no trailing commas, no unquoted keys, no script-injection breaks).
- Schema.org @type is correct for the page kind (Event for /calendar/events/:slug; NewsArticle for /coverage/:slug recap; Person for /founders/:slug; Organization for /startups/:slug; etc).
- Required schema fields per @type are present and non-empty. Validate against Google Rich Results Test for the targeted result type.
- Entity reference URLs (mentions/about/superEvent/sameAs) resolve to live pages — no 404s. A broken reference is worse than a missing one.
- inLanguage property matches the page locale (en or ar).
- datePublished / dateModified use ISO 8601 with timezone offset; no naked YYYY-MM-DD strings.
Per-module @type mapping (regression reference)
- Editorial article → Article. NewsArticle only when the piece is hard news with a publication date and journalist byline.
- Startup details → Organization with founder: Person[], subjectOf: Article[], event: Event[].
- Opportunity details → CreativeWork (v1); planned migration to BusinessEvent for deadline-anchored programs.
- Founder profile → Person with worksFor: Organization[], performerIn: Event[].
- Founder file details → CreativeWork (Book or DigitalDocument subtype depending on file format).
- Calendar event details → Event (or BusinessEvent / EducationEvent / Hackathon subtype per category).
- Coverage article details → NewsArticle (recap/highlights/pitch-result), Article (analysis), BlogPosting (sponsor-spotlight).