Skip to content
🏛️ Partner ⚙️

⚙️How heritage.maahir.io Works

The complete system — from data sources to what each stakeholder gets. This is the workflow you present in every meeting.

📥 1 · Data Sources

  • DOAM — 6,220 sites (national inventory API)
  • Wikipedia — histories in EN + Urdu (REST API)
  • Wikivoyage — tickets, trains, hotels (API)
  • UNESCO — WHC descriptions, ICH films (CC BY-SA)
  • Wikidata — coordinates via SPARQL
  • MET Museum — Gandhara objects, CC0 (API)
  • Open-Meteo — live weather + climate (free API)
  • OSRM — routing/travel times (free API)
  • Aladhan — prayer times (free API)
  • Gov books — OCR'd into searchable articles

🔄 2 · Pipeline (automated)

  • fetch-doam.php — imports 6,220+ sites
  • fetch-wikipedia.php — enriches with content
  • fetch-wikivoyage.php — adds travel data
  • fetch-wikidata.php — fills coordinates
  • generate-briefs.php — AI writes descriptions
  • fetch-met.php — museum objects
  • fetch-unesco.php — source links
  • run-all.php — one-click orchestrator

Triggered from admin panel or cron.

🗄️ 3 · MariaDB (19 tables)

  • sites — 6,220 heritage locations
  • pois — GPS-tagged points of interest
  • visit_info — tickets, hours, transport
  • articles — OCR'd book content
  • ich_elements — UNESCO living heritage
  • archive_submissions — citizen documentation
  • analytics — every interaction logged
  • + 12 more tables

🤖 4 · AI Layer

  • Roshni — AI guide answering in 9 languages
  • Scripted mode — works without any API key
  • Live mode — connects to any OpenAI-compatible LLM
  • Voice — browser speech synthesis + recognition
  • Personas — Dastango (Urdu), Kids, Scholar

🧳 5 · Public Experience

  • Explorer — interactive map of 6,220 sites
  • Site pages — history, POIs, tickets, trains, weather
  • Trip Planner — AI itineraries with routing
  • Virtual Visits — narrated cinematic walkthroughs
  • Quiz — 43 questions, daily mode, share cards
  • Sound Map — UNESCO living heritage films
  • Library — government books, OCR'd & readable
  • Archive — citizens record heritage (audio+photo)

📊 6 · Partner Dashboard

  • Page views, guide sessions, quiz plays
  • Language mix, top sites, geo distribution
  • Archive submissions & review status
  • CSV export for grant reporting
  • Every interaction = M&E evidence

The Value Chain — why stakeholders buy

🧳 Traveler

Gets a free guide in their language. Their visit = engagement data.

→

📊 Dashboard

Every quiz, question, and visit logged. The data World Bank says doesn't exist.

→

🏛️ Government/Donor

Gets provable impact metrics. Funds the next phase. Zero platform cost.

🔌 Live API Integrations

APIPurposeWhere UsedStatus
Open-MeteoLive weather + climateSite pages, trip planner✓ Live
OSRMRouting & travel timesTrip planner✓ Live
AladhanPrayer timesPractical page✓ Live
Wikipedia RESTSite histories EN/URPipeline → database✓ Pipeline
DOAMNational site inventoryPipeline → database✓ 6,220 sites
MET MuseumGandhara objects (CC0)Gallery, pipelineReady
Wikidata SPARQLCoordinates batchPipeline → databaseReady
Google News RSSHeritage headlinesNews page✓ Live
LLM (optional)AI guide enhancementGuide chatConfig

What each stakeholder sees

🧳 Public sees

  • Free heritage guide
  • AI chat in their language
  • Trip planner
  • Quiz & games
  • Sound map

🏛️ Government sees

  • Their content, beautifully presented
  • Live engagement dashboard
  • Parliament-ready answers
  • SCO 2027 showcase
  • Zero cost to them

🤝 Donor sees

  • Auto-generated M&E reports
  • Every rupee traceable
  • ROI calculator
  • Logframe exports
  • SDG-aligned data

💰 The Sales Pitch — 30 seconds

"Pakistan's heritage has no digital layer. The government's own content sits in PDFs on a website that crashes. We've already built the platform — 6,220 sites mapped, AI guide in 9 languages, live dashboard — using their own data, on free APIs, at zero cost to the public. One MoU letter unlocks the full 10,000+ sites, digitizes the national book collection, and gives you the M&E dashboard donors demand. The SCO 2027 chairmanship is in [counting] days. This platform is ready before that deadline."

🚑