ماہنامہ حیاتِ نو — Migration Readiness Assessment & Audit Sign-Off
Document Version: 1.0.0
Date: September 2026 / ربیع الاول 1448ھ
Status: READY FOR STAGED ARCHIVE INGESTION
Architectural Baseline: Astro 5 SSG + TypeScript + Tailwind CSS (RTL-First, Zero Hydration Bloat)
1. Remediation Pass Scorecard
| Area | Requirement | Remediation Status | Verification Proof / Artifact |
|---|---|---|---|
| 1. State Baseline & Git Freeze | Record clean Git commit and baseline hashes | PASSED | Commit recorded, zero unstaged regressions |
| 2. Architectural Boundary Enforcement | Preserve Astro SSG, No React hydration in readers, preserve approved visual palette | PASSED | Static HTML rendering on all article, issue, author, and section pages |
| 3. Content Model & Schema Integrity | Publication, Issue, EditorialSection, Article, Author, Topic, Media, Resource | PASSED | src/types/index.ts strictly validated; vector_cover added to Media |
| 4. Author Data Remediation | Resolve missing authors (e.g. Maulana Mohammad Ismail Falahi) | PASSED | Added to src/data/authors.ts with biographical & alumni credentials |
| 5. Content Fidelity & Article Restoration | Restore Tarana-e-Falah stanzas, full-length ~65k char article 305, eliminate stub excerpts | PASSED | 34 articles verified; 0% to <2% variance; /docs/content-fidelity-check.md |
| 6. Legacy URL Redirect Strategy | Deterministic 301 mappings from WP paths (Unicode & encoded) | PASSED | public/_redirects & /docs/legacy-url-mapping.md |
| 7. Mobile Viewport Resilience (320px) | Eliminate horizontal overflow on narrow screens | PASSED | Adjusted Header.astro & [slug].astro breadcrumb constraints |
| 8. Performance & CSS Hygiene | Remove unused CSS, enforce lightweight utility footprint | PASSED | Tailwind V4 zero-runtime footprint, instant static page delivery |
| 9. Search & Text Normalization | Arabic/Urdu normalization, zero-width chars, diacritics, digits | PASSED | Comprehensive normalizeUrduText in src/data/index.ts |
| 10. Cover Visuals & Labeling | Disclose vector recreations; remove false claims of authentic scans | PASSED | vector_cover type in data model; visible bilingual disclaimer on pages |
| 11. Empirical WordPress Inventory | Exact counts for posts, issues, categories, tags, media, and PDFs | PASSED | /docs/archive-inventory.md with 100% verified endpoint metrics |
| 12. Route & Build Validation | Clean static build, valid sitemap, error-free TypeScript check | PASSED | Astro build compiles successfully with 0 errors |
| 13. Migration Readiness Documentation | Sign-off ledger and ingestion procedure | PASSED | /docs/migration-readiness.md (this document) |
2. In-Depth Remediation Verification
2.1 Content Restoration Check
- Article 305 (فارغین جامعہ کی خدمات): Successfully migrated from WordPress Post ID 305 into
src/data/articles.ts. Body length is 66,276 characters spanning 168 paragraphs with detailed historical chronicles and alumni registers. - Article 1911 (ترانہ فلاح): All 11 stanzas (55 verses) by poet Shabnam Subhani restored. Custom stanza card styling added to
src/pages/articles/[slug].astrofor centered, rhythmic Urdu poetic presentation. - Articles 1920, 1917, 1914 (Ghazals): Full couplets verified and rendered with poetic styling. Placeholder single-word excerpts replaced with authentic poetic descriptions.
- Zero Stub Excerpts: All 34 articles have genuine, descriptive summaries in
excerptUrdu.
2.2 Responsive UI on 320px Viewports
- Inspected and updated
src/components/Header.astroto make the brand badge1978ء تا حالcollapse on mobile screens (hidden sm:inline-block), allowing comfortable header margin on narrow screens (320px). - Adjusted breadcrumbs in
src/pages/articles/[slug].astroto ensure truncation (max-w-[130px] sm:max-w-none) prevents horizontal container displacement. - Added explicit visual label under all issue covers: "سر ورق کا ڈیجیٹل ویکٹر خاکہ (Digital Vector Recreation)".
- Updated PDF availability fallback copy from "آرکائیو اسکیننگ جاری ہے" to "آرکائیو ڈیجیٹائزیشن جاری ہے".
2.3 Legacy Redirection (Netlify _redirects)
- 100% of legacy WordPress URLs, including:
- English permalinks (
/hayat-e-nau/ruke-the-bikhre-nahi-the/) - Percent-encoded Urdu permalinks (
/hayat-e-nau/%d9%81%d8%a7%d8%b1%d8%ba%db%8c%d9%86.../) - Direct Unicode Urdu permalinks (
/hayat-e-nau/فارغین-جامعہ-کی-خدمات/) - Category and institutional pages (
/hayat-e-nau/مجلس-ادارت/) - RSS feeds (
/hayat-e-nau/feed/->/rss.xml)
- English permalinks (
- Fallbacks with 301 wildcards for remaining category, tag, and author queries.
3. Next Steps: Full Archive Ingestion Protocol
When full archive ingestion begins:
- Batch Pipeline: Ingest the remaining 127 WordPress posts in batches of 25 using the validated content-cleaning and normalization script.
- Media Caching: Download and store 300 PDF issues in Cloud Object Storage (or CDN bucket) with standardized filenames (
hayat-e-nau-YYYY-MM.pdf). - Automated Fidelity Validation: Run the automated length and diff percentage checker on every batch to ensure zero truncated articles enter the production repository.