# Mahanama Hayat-e-Nau — Issue & Serial Architecture Model

## 1. Context & Architectural Problem
In legacy WordPress, Mahanama Hayat-e-Nau never utilized a dedicated Custom Post Type for issues. Instead, issues were represented through a loose arrangement of:
- **Hierarchical Taxonomy**: WordPress Categories representing publication years (e.g. `2023`, `2022`, `2015`, `1978`).
- **Annual Index Posts (جملہ شمارے)**: Long container posts listing monthly download links for that specific year.
- **Single-Issue Stubs**: Occasional standalone posts containing only a PDF embed.

This document establishes the **formal canonical Issue Schema** for the Astro platform.

---

## 2. Canonical Issue Field Specifications

### 2.1 Volume (Jild / جلد)
- **Definition**: Represents the annual publishing cycle of Hayat-e-Nau.
- **Base Volume**: Volume 1 (`جلد 1`) corresponds to the founding year **1978**.
- **Formula**: `volumeNumber = publicationYear - 1977` (e.g., 2026 corresponds to Jild 47; 2023 corresponds to Jild 45).
- **Display Format**: `جلد 47` (with localized Urdu numerals `جلد ۴۷`).

### 2.2 Issue Number (Shumara / شمارہ)
- **Definition**: The specific issue within a publishing year.
- **Quarterly Periods (سہ ماہی)**:
  - شمارہ 1: جنوری تا مارچ (January - March)
  - شمارہ 2: اپریل تا جون (April - June)
  - شمارہ 3: جولائی تا ستمبر (July - September)
  - شمارہ 4: اکتوبر تا دسمبر (October - December)
- **Bimonthly / Special Combinations**:
  - ششماہی خصوصی اشاعت: جولائی تا دسمبر (July - December)

### 2.3 Continuous Number (Musalsal Shumara / مسلسل شمارہ)
- **Definition**: The sequential numbering running continuously from Issue #1 (April 1978).
- **Historical Anchor**: 
  - Issue 1: April 1978 (Musalsal 1)
  - Issue July-Dec 2023: Musalsal 472
  - Issue July-Sept 2026: Musalsal 485

### 2.4 Date Representations
- **Gregorian Dates (عیسوی تاریخ)**:
  - Internal ISO: `YYYY-MM` (e.g. `2026-07`)
  - Urdu Display: `جولائی تا ستمبر 2026ء`
- **Hijri Dates (ہجری تقویم)**:
  - Urdu Display: `محرم تا ربیع الاول 1448ھ`
  - Derived from printed editorial colophons and covers.

### 2.5 Special Issues (خصوصی اشاعتیں / نمبرات)
- **Model Property**: `isSpecialIssue: boolean`
- **Theme Field**: `specialIssueTheme?: string`
- **Historical Special Issues**:
  - `jul-dec-2023`: یادگارِ ڈاکٹر خلیل احمد و اتحادِ امت نمبر
  - `nov-2015`: یادگارِ شبلی نمبر
  - `apr-may-1993`: پندرہ سالہ جشنِ سیمیں نمبر
  - `apr-1978`: بانی شمارہ (افتتاحی اشاعت)

### 2.6 Cover Scans vs. Vector Recreations
- **Model Property**: `coverType: 'vector_recreation' | 'historical_scan' | 'unavailable'`
- **Current Practice**: High-fidelity SVG vector recreations (`/covers/hayat-*.svg`) accurately reflecting masthead typography, institutional seals, and editorial hierarchy.
- **Editorial Label**: Explicitly rendered as `سر ورق کا ڈیجیٹل ویکٹر خاکہ (Digital Vector Recreation)`.
- **Scan Ingestion Protocol**: When high-resolution physical scans are digitized from the Jamia archives, replacing `coverImage.url` with `/covers/scans/{slug}.webp` and switching `coverType` to `historical_scan` seamlessly updates the presentation without breaking schema contracts.

### 2.7 Issue PDF Association
- **Model Property**: `fullPdfResource: Resource`
- **Target URL**: Self-hosted static path `/archive/issues/{issueSlug}.pdf`
- **Verified Offline**: Stored locally in `storage/pdfs/` and served from `public/archive/issues/`.

---

## 3. Registered Issue Inventory in Current Astro Build (11 Issues)

| Issue Slug | Title (عنوان) | Jild | Shumara | Musalsal | Year | Gregorian Date | Hijri Date | Special Theme | PDF Status | Cover Type |
| :--- | :--- | :---: | :---: | :---: | :---: | :--- | :--- | :--- | :---: | :---: |
| `jul-sep-2026` | حیاتِ نو — جولائی تا ستمبر 2026ء | 47 | 3 | 485 | 2026 | جولائی تا ستمبر 2026ء | محرم تا ربیع الاول 1448ھ | نہیں | خود میزبان (Self-Hosted) | `vector_recreation` |
| `jul-dec-2023` | حیاتِ نو — جولائی تا دسمبر 2023ء | 45 | 3 | 472 | 2023 | جولائی تا دسمبر 2023ء | محرم تا جمادی الثانی 1445ھ | **ہاں** (یادگارِ ڈاکٹر خلیل احمد و اتحادِ امت) | خود میزبان (Self-Hosted) | `vector_recreation` |
| `aug-2018` | حیاتِ نو — اگست 2018ء | 40 | 8 | 421 | 2018 | اگست 2018ء | ذو القعدہ تا ذو الحجہ 1439ھ | نہیں | خود میزبان (Self-Hosted) | `vector_recreation` |
| `nov-2016` | حیاتِ نو — نومبر 2016ء | 38 | 11 | 400 | 2016 | نومبر 2016ء | صفر 1438ھ | نہیں | خود میزبان (Self-Hosted) | `vector_recreation` |
| `dec-2015` | حیاتِ نو — دسمبر 2015ء | 37 | 12 | 399 | 2015 | دسمبر 2015ء | صفر تا ربیع الاول 1437ھ | نہیں | عدم دستیاب (Missing Scan) | `vector_recreation` |
| `sep-2015` | حیاتِ نو — ستمبر 2015ء | 37 | 9 | 396 | 2015 | ستمبر 2015ء | ذو القعدہ تا ذو الحجہ 1436ھ | نہیں | خود میزبان (Self-Hosted) | `vector_recreation` |
| `apr-1978` | حیاتِ نو — اپریل 1978ء (شمارہ اول / بانی شمارہ) | 1 | 1 | 1 | 1978 | اپریل 1978ء | جمادی الاولیٰ 1398ھ | **ہاں** (شمارہ اول — تاسیسی اشاعت) | خود میزبان (Self-Hosted) | `vector_recreation` |
| `jan-feb-1978` | حیاتِ نو — جنوری تا فروری 1978ء | 1 | — | — | 1978 | جنوری تا فروری 1978ء | محرم تا صفر 1398ھ | نہیں | خود میزبان (Self-Hosted) | `vector_recreation` |
| `jan-1980` | حیاتِ نو — جنوری 1980ء | 3 | 1 | 21 | 1980 | جنوری 1980ء | صفر 1400ھ | نہیں | خود میزبان (Self-Hosted) | `vector_recreation` |
| `nov-2015` | حیاتِ نو — نومبر 2015ء (یادگارِ شبلی نمبر) | 37 | 11 | 398 | 2015 | نومبر 2015ء | محرم 1437ھ | **ہاں** (علامہ شبلی نعمانی صد سالہ یادگار نمبر) | خود میزبان (Self-Hosted) | `vector_recreation` |
| `apr-may-1993` | حیاتِ نو — اپریل تا مئی 1993ء (خصوصی اشاعت) | 16 | 4 | 184 | 1993 | اپریل تا مئی 1993ء | شوال تا ذو القعدہ 1413ھ | **ہاں** (جامعۃ الفلاح تیس سالہ تاسیسی جائزہ) | خود میزبان (Self-Hosted) | `vector_recreation` |