Twelve editorial diagrams covering the whole stack — from the UA-router that splits desktop and mobile traffic, through the FLEET Mongo shape, the Wikivoyage crawl, the 10K media pipeline, the PWA service worker, and the Vercel deploy.
A user's request splits at the middleware, hits either the desktop tree or the mobile /m/* tree, and both draw from the same FLEET Mongo + S3 com27 + Wikivoyage stack.
src/middleware.ts sniffs UA, checks the wbp_layout cookie + ?desktop/?mobile query param, and rewrites (not redirects) the response for mobile clients.
Shared MongoDB collection with {app:'wbp'} discriminator + kind field. Filter by kind='city' to get cities, etc. 13,496 wbp docs today.
Optional per-slug overrides for hero image, wiki editorial URL, audio narration, and video loop. 6,795 wbp docs. Rendered by <PlaceMedia />.
scripts/bootstrap-wikivoyage.ts crawls Star + Guide + Useable articles from en.wikivoyage.org, writes to FLEET.items, caches locally at .cache/wikivoyage/.
For every seeded place, produce wiki text + hero image + audio narration + video loop, then upload to S3 and upsert to FLEET.media. Job queue at media_jobs.
src/app/m/_components/Feed.tsx cycles between mode (featured/guides/random/search/explore), fetches via /api/wiki/*, and opens StructuredArticle overlay on tap.
/m/explore uses src/lib/wbp-hierarchy.ts helpers over FLEET.items. Country doc lacks continent? Fallback via src/lib/continents.ts ISO→continent map.
Public routes bypass. /bo and /api/bo require an authenticated Supabase user whose email is in ALLOWED_EMAILS (['mat@matsiems.com']).
Client POSTs to /api/worldai/chat, which streams from OpenRouter (openai/gpt-oss-120b). Rate-limited (10/60s/IP). Gracefully degrades when OR is offline.
/sw.js registered from /m routes. Cache-first for shell + static, network-first (24h stale) for /api/wiki, LRU-25 for /m/read/*. Manifest scope: /.
Manual vercel --prod (GitHub Login Connection was never re-linked; the auto-deploy webhook is not wired). matsiems scope, project prj_AdhKeXQJjtegWFu4J3UTM7EfAxKO.