# Shanghai Rave Index

> Shanghai Rave Index is a source-backed Shanghai rave, techno, DJ, venue, and underground electronic music calendar maintained by Basement Dispatch. It helps readers compare current and upcoming Shanghai nightlife events by date, venue, sound, lineup, ticket/source status, poster evidence, and source confidence.

Use this file to understand the site quickly. Public, source-backed event pages are indexable and appear in the sitemap. Watchlist leads are kept out of search results until stronger evidence confirms date, venue, ticketing, or lineup details.

Important interpretation notes:
- The primary city is Shanghai, China. Geographic scope is Shanghai nightlife and nearby China-accessible electronic music planning.
- Event detail pages are generated from `data/events.json` and include MusicEvent JSON-LD when a listing is public enough to index.
- Poster art is evidence for scanning and archiving, not a commercial endorsement.
- Source confidence, source trails, correction routes, and commercial relationship notes are part of the editorial model.
- The site is English-first with concise Chinese support for local alert and contact flows.

## Primary Pages

- [Calendar](https://raveindexsh.top/): Main Shanghai rave calendar with source-backed event cards, DJ notes, routes, and watchlists.
- [Events Poster Wall](https://raveindexsh.top/poster-wall): Searchable event and poster wall. Supports URL filters such as `?search=techno`, `?city=Shanghai`, `?status=upcoming`, and `?vibe=hard-techno`.
- [Tonight Rooms](https://raveindexsh.top/live-room): Same-day event room flow for links, room-specific updates, and event pages.
- [DJ Set-Time Planner](https://raveindexsh.top/planner): Itinerary planner for exact and estimated DJ set times.
- [DJ Database](https://raveindexsh.top/djs): DJ and performer profiles linked to event appearances, venues, source links, and listening context.
- [Venues and Crews](https://raveindexsh.top/venues): Shanghai electronic music venue, club, organizer, and crew guide.
- [New to Techno](https://raveindexsh.top/new-to-techno): Beginner guide covering techno listening, room culture, safer nightlife, and source-backed planning.
- [Electronic Music Personality Test](https://raveindexsh.top/personality): Free bilingual music-discovery quiz with 12-, 30-, and 90-question modes. It processes answers locally by default and maps dancefloor preferences to main styles, hidden styles, ten sound axes, and exploration routes across 328 electronic music subgenres. Signed-in members may sync normalized answers and their result profile so later event recommendations can use those signals. It is not a clinical or standardized psychological assessment.
- [How We Recommend](https://raveindexsh.top/trust): Editorial standards, source confidence, corrections, and commercial-relationship policy.
- [Contribute](https://raveindexsh.top/contribute): Source-backed submission route for missing events, DJ evidence, venue facts, corrections, and additions.
- [Alerts](https://raveindexsh.top/subscribe): Basement Dispatch alerts for weekly picks, tonight updates, ticket changes, and source upgrades.

## Machine-Readable Data

- [Sitemap](https://raveindexsh.top/sitemap.xml): Indexable static routes and public event detail pages.
- [Personality model](https://raveindexsh.top/assets/personality/app.js): Local rule-based matching logic for all three test depths.
- [Personality taxonomy](https://raveindexsh.top/assets/personality/archetype-data.js): Browser-readable taxonomy containing 17 top-level categories and 328 electronic music subgenres.
- [Event data](https://raveindexsh.top/data/events.json): Canonical event payload used to generate event pages and the sitemap.
- [Poster wall data adapter](https://raveindexsh.top/assets/poster-wall-data.js): Browser adapter that normalizes Supabase and static event/poster data for the poster wall.
- [DJ source data](https://raveindexsh.top/data/dj-data.js): DJ profile data used by the DJ database.
- [Tracked DJ itineraries](https://raveindexsh.top/data/tracked-dj-itineraries.js): Future tour and itinerary context where available.
- [Venue directory data](https://raveindexsh.top/data/ra-venues.js): Imported venue-directory context used by the venue guide.

## Source And Trust Context

- [Source log](https://raveindexsh.top/SOURCE_LOG.md): Source tracking notes for event ingestion and verification.
- [Project overview](https://raveindexsh.top/docs/PROJECT_OVERVIEW.md): System overview for the static site, data pipeline, and Supabase-backed features.
- [Data model](https://raveindexsh.top/docs/DATA_MODEL.md): Event, source, poster, DJ, and contribution data concepts.
- [Glossary](https://raveindexsh.top/docs/GLOSSARY.md): Definitions for event status, source type, sound tags, decision tags, and quality terms.
- [FAQ](https://raveindexsh.top/docs/FAQ.md): Operational FAQ for running the project, event lifecycle, scraping, posters, and deployment.

## Optional

- [Rave Love Wall](https://raveindexsh.top/love-wall): Audience notes about dancefloor culture and community.
- [Rave Everywhere](https://raveindexsh.top/rave-everywhere): Preview-room and poster-generation experiment for collected DJ profiles.
- [Sound Buddy](https://raveindexsh.top/sound-buddy): Local browser listening companion for electronic music learning cues.
- [Sound Buddy Principles](https://raveindexsh.top/sound-buddy-principles): Technical and privacy explanation for Sound Buddy.
- [Support](https://raveindexsh.top/support): Donation route for supporting the calendar.