# Functional Specification

## Goal
Build a platform for fandom communities (jam bands, TV shows, additional verticals) that enables archival, discovery, cross-referencing, and rich social interaction around content (songs, shows, episodes).

## User Roles
- **Visitor**: Can explore public content, search, try basic mind map tools (limited), and read reviews/stats.
- **Registered User**: One account, multi-identity across verticals; can participate, comment, tag, vote, make private groups, earn achievements.
- **Moderator/Admin**: Oversee content, resolve disputes, manage users/groups.
- **Band/Brand/Show Owner**: Create and administer white-labeled or private community spaces.

## Core Features
- **Massive Archive**: Shows/episodes, performances, venues, metadata (setlists, dates, locations, characters, etc.).
- **Tours**: Grouping shows into tours (e.g., "Fall 2023", "Summer Tour").
- **User Attendance**: "I was there" tracking for personal stats and badges.
- **Entity Notes**: Rich text notes on Shows, Venues, Songs, and Tours to handle details like "Guest Artist", "Cover Song", "Original Artist", or "Historical Context".
- **Artist Tracking**: First-class support for Band Members and Guest Musicians. Tag them in shows/performances to track their stats and history wiki-style.
- **Advanced Tagging & Search**: Wiki-style linking (Obsidian-style backlinks), cross-vertical support.
- **Tags**: Granular tagging for shows and songs (e.g., "Soundcheck", "Tease", "Jam").
- **Mind Maps**: Visual tools for connecting entities (episode, show, tour, performance, character, venue).
- **Discussion & Social**: Forums, commenting, voting, peer ranking, reviewing.
- **"Just Saw" Mode**: Live post-event discussion for instant impressions and stats.
- **Community Stats**: Trending content, charts, "On this Day," automated highlights.

## New Features (from Honkingversion Comparison)
- **Social Interaction**:
    - **Reviews**: Formal reviews with a 1-10 rating, a "blurb" (one-liner/pullquote), and full text. Distinct from comments.
    - **Comments**: Threaded discussions on Shows, Songs, and Venues.
    - **Ratings/Voting**: Quick 1-10 ratings for Performances and Shows.
    - **Activity Feed**: Global and user-specific activity streams.
- **Gamification**:
    - **Badges**: Achievements for attendance, ratings, and contributions.
    - **Stats Engine**: "Times Played", "Gap Charts", "Personal Stats".
- **Advanced Content**:
    - **Performance Nicknames ("City Songs")**: Community-suggested aliases for specific performances (e.g., "Tahoe Tweezer").
    - **Sequences**: Explicit tracking of song transitions (Segues).
- **Enhanced Moderation**:
    - **Role Hierarchy**: Power User, Moderator, Admin.
    - **Moderation Queue**: Approval workflow for Nicknames and content reports.

## Social & Privacy
- **Visibility Control**: Pseudonymous or linked profiles per vertical.
- **Interaction**: Tagging, mentions, friend/follow, group/private DM.
- **Interaction**: Tagging, mentions, friend/follow, group/private DM.
- **Wiki Mode**: Granular control to disable social overlays (comments, ratings) for a pure archive experience.
- **Groups**: White-label and private group support.

## Monetization (Freemium)
- **Free**: Access to archive, basic stats, read-only community.
- **Premium**:
    - **Wiki Mode**: Distraction-free browsing (no social clutter).
    - **Advanced Stats**: Deep analytics, gap charts, personal attendance stats.
    - **Offline Mode**: Download setlists/stats for offline viewing.
    - **Badges**: Exclusive profile badges.s.
- **Add-ons**: Purchasable extras for groups and power users.