# Hayat-e-Nau — Structured Data (JSON-LD) Specification & Audit Fixes

This document details the Schema.org JSON-LD implementation across all page types on the Hayat-e-Nau platform.

## Audit Finding & Remediation

- **Identified Issue:** The preliminary prototype incorrectly outputted the `@type: "Periodical"` schema globally across all non-article routes (including individual issue pages, author profiles, categories, and informational pages).
- **Remediation:** Structured data generation has been strictly contextualized by `pageType`. Root `Periodical` schema is reserved **exclusively** for the publication homepage. Sub-pages implement specialized schemas (`PublicationIssue`, `ScholarlyArticle`, `ProfilePage`, `CollectionPage`, `SearchResultsPage`, `AboutPage`, and `WebPage`).

---

## Page-Type Schema Matrix

| Page Route Pattern | Page Type | Schema.org `@type` | Key Properties & Entity Relations |
|---|---|---|---|
| `/` (Homepage) | `home` | `Periodical` | `name`, `alternateName`, `issn`, `publisher`, `parentOrganization` |
| `/issues/[slug]/`, `/current-issue/` | `issue` | `PublicationIssue` | `name`, `issueNumber`, `volumeNumber`, `datePublished`, `isPartOf` (Periodical) |
| `/articles/[slug]/` | `article` | `ScholarlyArticle` | `headline`, `author` (Person with affiliation), `datePublished`, `isPartOf` (PublicationIssue & Periodical) |
| `/authors/[slug]/` | `author` | `ProfilePage` | `mainEntity` (`Person` with `name`, `affiliation`, `jobTitle`, `url`) |
| `/sections/[slug]/`, `/topics/[slug]/` | `section` / `topic` | `CollectionPage` | `name`, `description`, `isPartOf` (WebSite) |
| `/issues/`, `/articles/`, `/authors/` | `section` | `CollectionPage` | `name`, `description`, `isPartOf` (WebSite) |
| `/article-index/` (Search) | `search` | `SearchResultsPage` | `name`, `description`, `inLanguage` |
| `/about/`, `/jamia/` | `about` | `AboutPage` | `mainEntity` (`Periodical` & institutional publisher) |
| `/contact/` | `webpage` | `WebPage` | `name`, `description`, `url` |

---

## Detailed Schema Examples

### 1. Root Publication (`/` Homepage)
```json
{
  "@context": "https://schema.org",
  "@type": "Periodical",
  "name": "ماہنامہ حیاتِ نو",
  "alternateName": "Monthly Hayat-e-Nau",
  "description": "ماہنامہ حیاتِ نو: انجمن طلبہ قدیم جامعۃ الفلاح کا علمی، فکری، تحقیقی و دعوتی ترجمان (1978ء تا حال)۔",
  "url": "https://hayat-e-nau.in",
  "inLanguage": "ur",
  "issn": "2321-0427",
  "publisher": {
    "@type": "Organization",
    "name": "انجمن طلبہ قدیم جامعۃ الفلاح",
    "url": "https://hayat-e-nau.in",
    "logo": {
      "@type": "ImageObject",
      "url": "https://hayat-e-nau.in/icon.png"
    },
    "parentOrganization": {
      "@type": "EducationalOrganization",
      "name": "جامعۃ الفلاح، بلریا گنج، اعظم گڑھ"
    }
  }
}
```

### 2. Issue Pages (`/issues/jul-sep-2026/`)
```json
{
  "@context": "https://schema.org",
  "@type": "PublicationIssue",
  "name": "حیاتِ نو — جولائی تا ستمبر 2026ء | ماہنامہ حیاتِ نو",
  "description": "حیاتِ نو — جولائی تا ستمبر 2026ء — اداریہ: اخلاقی زوال اور علمی بیداری...",
  "url": "https://hayat-e-nau.in/issues/jul-sep-2026/",
  "image": "https://hayat-e-nau.in/covers/hayat-2026-q3.svg",
  "issueNumber": 3,
  "volumeNumber": 48,
  "datePublished": "2026-07-01",
  "inLanguage": "ur",
  "isPartOf": {
    "@type": "Periodical",
    "name": "ماہنامہ حیاتِ نو",
    "issn": "2321-0427",
    "url": "https://hayat-e-nau.in"
  }
}
```

### 3. Article Pages (`/articles/tarana-e-falah/`)
```json
{
  "@context": "https://schema.org",
  "@type": "ScholarlyArticle",
  "headline": "ترانۂ فلاح — حیاتِ نو کی پہلی اشاعت کا تاریخی ترانہ — مولانا حامد الانصاری انجمؔ",
  "description": "جامعۃ الفلاح کا باوقار تاریخی ترانہ جو حیاتِ نو کے پہلے شمارے (اپریل 1978ء) میں شائع ہوا۔",
  "inLanguage": "ur",
  "url": "https://hayat-e-nau.in/articles/tarana-e-falah/",
  "image": "https://hayat-e-nau.in/covers/hayat-1978.svg",
  "datePublished": "1978-04-01",
  "author": {
    "@type": "Person",
    "name": "مولانا حامد الانصاری انجمؔ",
    "affiliation": {
      "@type": "Organization",
      "name": "استاذ جامعۃ الفلاح و شاعرِ فلاح"
    }
  },
  "publisher": {
    "@type": "Organization",
    "name": "ماہنامہ حیاتِ نو",
    "alternateName": "Monthly Hayat-e-Nau",
    "url": "https://hayat-e-nau.in",
    "logo": {
      "@type": "ImageObject",
      "url": "https://hayat-e-nau.in/icon.png"
    }
  },
  "isPartOf": {
    "@type": "PublicationIssue",
    "name": "ماہنامہ حیاتِ نو",
    "isPartOf": {
      "@type": "Periodical",
      "name": "ماہنامہ حیاتِ نو",
      "issn": "2321-0427"
    }
  }
}
```

### 4. Author Profiles (`/authors/dr-khalil-ahmad/`)
```json
{
  "@context": "https://schema.org",
  "@type": "ProfilePage",
  "url": "https://hayat-e-nau.in/authors/dr-khalil-ahmad/",
  "name": "ڈاکٹر خلیل احمد — مضامین و سوانحی خاکہ | ماہنامہ حیاتِ نو",
  "description": "بانی و معمارِ جامعۃ الفلاح، مایہ ناز معالج، سابق صدر انجمن طلبہ قدیم...",
  "mainEntity": {
    "@type": "Person",
    "name": "ڈاکٹر خلیل احمد",
    "description": "بانی و معمارِ جامعۃ الفلاح، مایہ ناز معالج، سابق صدر انجمن طلبہ قدیم...",
    "affiliation": {
      "@type": "Organization",
      "name": "بانی و سرپرست جامعۃ الفلاح"
    },
    "url": "https://hayat-e-nau.in/authors/dr-khalil-ahmad/"
  }
}
```

### 5. Section & Topic Pages (`/sections/idariya/`, `/topics/quran/`)
```json
{
  "@context": "https://schema.org",
  "@type": "CollectionPage",
  "name": "اداریہ / اپنی بات — شعبہ جاتی مضامین | ماہنامہ حیاتِ نو",
  "description": "شمارہ جات کے کلیدی فکری اداریے اور مدیر کی تحریریں",
  "url": "https://hayat-e-nau.in/sections/idariya/",
  "inLanguage": "ur",
  "isPartOf": {
    "@type": "WebSite",
    "name": "ماہنامہ حیاتِ نو",
    "url": "https://hayat-e-nau.in"
  }
}
```