System Blueprint

Scalable architecture for culture, real-time data, media, and user participation.

This page converts the product plan into implementation-ready structure: system layers, Firestore collections, CRUD ownership, livestream flow, security, and monetization.

Recommended stack

Next.js + Firebase + YouTube + Mapbox

Mobile-first, cloud scalable, admin-controlled, and ready for real-time updates.

System Architecture
Users, tourists, diaspora, admins
Next.js React app: SSR, ISR, 3D hero, map, feed, admin
Firebase Auth, Firestore, Storage, Analytics
↙ ↓ ↘
YouTube Live embed · Mapbox route layers · Ad/tourism partners
Non-functional Requirements
Fast loadStatic archive pages, image optimization, lazy 3D/map bundles, CDN media.
Mobile responsiveRoute and live surfaces designed first for crowded on-site usage.
Secure authFirebase custom claims: user, moderator, admin, superAdmin.
Scalable cloudFirestore indexes, pagination, Storage CDN, Vercel edge delivery.

Database Schema

Firestore collections

users/{userId}
posts/{postId}
posts/{postId}/comments/{commentId}
articles/{articleId}
routeStops/{stopId}
routes/{routeId}
houseHotspots/{hotspotId}
quizzes/{quizId}
quizzes/{quizId}/questions/{questionId}
liveStreams/{streamId}
sponsors/{sponsorId}
sources/{sourceId}
reports/{reportId}

Real-World Data

Public sources currently backing the prototype.

Radio Nepal, Apr 20 2026

Bungadya Jatra began on Akshaya Tritiya; deity names and rain/agriculture context.

Open source

The Rising Nepal, Apr 22 2026

2026 chariot procession route, women-pulling day, Bhoto Jatra context, 50-foot chariot note.

Open source

The Kathmandu Post, Apr 8 2026

Artisans assembling the traditional wooden chariot in Lalitpur; about 20 metres tall.

Open source

The Rising Nepal, Mar 14 2026

Four wheels crafted in traditional style; wheel replacement cycle and 2026 preparation dates.

Open source

Kantipur/RSS, Apr 26 2026

Chariot reached Lagankhel via Gabahal, Mangalbazar, Sundhara, and Chabahal.

Open source

The Annapurna Express, Apr 28 2026

Lalitpur Metropolitan City holiday for coconut-dropping day; pulling began Apr 21.

Open source

Nepal Tourism Board

Over 1600 years of devotion; Matsyanath, Guru Karunamaya, Bung Dhya names.

Open source

ICHCAP field survey PDF

Intangible cultural heritage profile: community participation, Narendra Dev and Gorakhnath legend, Bhoto display at Jawalakhel.

Open source

CRUD Matrix

Feature ownership and operations

ModuleCreateReadUpdateDelete
UsersRegister by email, Google, or phone.Profile, badges, contribution history.Edit profile, role, moderation status.Disable or anonymize account.
PostsUpload image/video with caption.Approved feed, profile posts, pending queue.Edit caption, approval status, reports.User delete or moderator removal.
ArticlesAdmin article with media, language, and source URL.Archive, detail pages, related stories, citations.Edit body, cover, status, taxonomy, source notes.Archive or hard-delete draft.
Route StopsAdmin stop, coordinates, ritual notes, source URL.Map markers, timeline, active route, verified source.Timing, crowd level, active stop, source confidence.Remove draft stop or archive old route.
House HotspotsPositioned hotspot with media and permission level.Interactive sacred house exploration.Coordinates, copy, permissions, status.Remove outdated or restricted hotspot.
QuizQuiz, questions, rewards, and source references.Playable quiz and leaderboard.Question bank, answer, badge, citations.Retire seasonal quiz.

Live Streaming Integration

Camera to YouTube RTMP to public embed.

Production streams are created in YouTube Studio. The encoder sends RTMP to YouTube, then the admin panel stores the public video ID and live status for the Next.js page.

Camera / OBS / Mobile encoder
↓ RTMP
YouTube Live event
↓ video ID
Firestore liveStreams/{streamId}
Next.js live page iframe embed

Monetization Model

Revenue that supports preservation and operations.

AdSense on archive,

AdSense on archive, route, and article pages after Core Web Vitals pass.

Premium streams only

Premium streams only after an official YouTube stream ID and rights path are confirmed.

Tourism partnerships with

Tourism partnerships with Nepal Tourism Board, Lalitpur Metropolitan City, Patan Museum, guides, and heritage walks.

Sponsored map stops

Sponsored map stops and archive features clearly labeled as sponsored, never mixed with ritual instructions.

Donation module for

Donation module for documentation, preservation, crowd safety, and source verification work.

Merchandise marketplace for

Merchandise marketplace for licensed prints, books, and local artisan products.

Frontend

Next.js App Router, React components, Three.js hero, mobile-first UX, lazy-loaded media and maps.

Backend

Firebase Auth, Firestore, Storage, rules, custom claims, indexes, pagination, and analytics events.

Streaming

YouTube Live RTMP, embeddable video ID, live/offline states, sponsor slots, and premium future path.