مواد کی طرف جائیں (Skip to main content)
علمی، فکری، تحقیقی و دعوتی ترجمان — قائم شدہ: 1978ء
تازہ شمارہ: جولائی تا ستمبر 2026ء
Home/Docs/migration-readiness.md
Raw Markdown

ماہنامہ حیاتِ نو — 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].astro for 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.astro to make the brand badge 1978ء تا حال collapse on mobile screens (hidden sm:inline-block), allowing comfortable header margin on narrow screens (320px).
  • Adjusted breadcrumbs in src/pages/articles/[slug].astro to 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)
  • Fallbacks with 301 wildcards for remaining category, tag, and author queries.

3. Next Steps: Full Archive Ingestion Protocol

When full archive ingestion begins:

  1. Batch Pipeline: Ingest the remaining 127 WordPress posts in batches of 25 using the validated content-cleaning and normalization script.
  2. Media Caching: Download and store 300 PDF issues in Cloud Object Storage (or CDN bucket) with standardized filenames (hayat-e-nau-YYYY-MM.pdf).
  3. Automated Fidelity Validation: Run the automated length and diff percentage checker on every batch to ensure zero truncated articles enter the production repository.