Add Bandcamp WebHarbor mirror

[Lxr-max]

Site

• Site name: Bandcamp
• Site slug: bandcamp
• Upstream URL: https://bandcamp.com/
• Contribution type: New Website
• Contributor: XuanRui LI / Lxr-max
• Contact email: mingduanmu845@gmail.com

Implementation Summary

This PR adds a self-contained local Bandcamp mirror built with Flask, SQLAlchemy, Jinja2, and SQLite. The mirror covers music discovery, artist and album detail pages, track detail sections, merch listings, wishlist/cart flows, mock checkout, fan collection, order history, and comparison-style browsing for release formats.

The site uses deterministic local data and local SVG artwork rather than copied Bandcamp-owned album art. There are no external runtime calls, no real payment flow, and no live dependency on Bandcamp.

Key User Flows

• Discover music by genre, tag, location, and search query
• Browse artist, album, track, merch, label, and scene pages
• Add albums to wishlist and merch/releases to cart
• Complete a deterministic mock checkout flow
• View fan collection, account details, order history, and release comparisons

Seed Row Counts

• artists: 40
• albums: 80
• tracks: 400
• merch_items: 80
• users: 4
• genres: 12
• tags: 90
• scenes: 9
• labels: 10
• wishlist_items: 16
• cart_items: 9
• orders: 5
• order_items: 9
• fan_collection_items: 6
• fan_comments: 4

Benchmark Users

• alice.j@test.com
• bob.c@test.com
• carol.d@test.com
• david.k@test.com
• Password: TestPass123!

Tasks

• Task count: 18
• Task categories: search, discover filters, artist/album lookup, merch lookup, price/format comparison, wishlist, cart, checkout, account editing, order history, fan collection, track facts, multi-page reasoning

WebSyn Port

• Selected port: 40015

Verification Summary

• Docker build and container run completed successfully
• Key routes including home, discover, search, artist, album, track, merch, and compare returned 200
• Login/register/logout, search, wishlist, cart, mock checkout, and account edit flows were smoke-tested successfully
• Reset endpoint POST /reset/bandcamp returned ready successfully
• instance/bandcamp.db and instance_seed/bandcamp.db matched after reset
• MD5: d01789ec232e5b038c99359686bbde78

Screenshot Paths

• Local review screenshots: C:\Users\34475\Desktop\VScode\WebHarborRepo\sites\bandcamp\scraped_data\submission_review

HF Asset Status

HF asset PR is open and pending merge: https://huggingface.co/datasets/ChilleD/WebHarbor/discussions/26

This GitHub PR is opened for code review first. The local instance_seed DB and static assets were prepared locally and uploaded through the HF asset workflow.

Known Limitations

• Uses deterministic local SVG assets rather than copied Bandcamp-owned artwork
• No real audio playback backend or payment processing
• Final .assets-revision update still depends on HF asset PR merge

Manual Review Notes

• Please review visual fidelity of the discover and album layouts against Bandcamp
• Please spot-check mobile spacing and mock player treatment
• Please confirm task wording avoids answer leakage

[reacher-z]

I completed a runnable review of this Bandcamp environment and opened #79 with the review fixes while preserving this PR's original commit and XuanRui LI authorship.

The review adds deterministic answer/navigation verifiers for all 18 tasks and direct SQLite before/after checks for wishlist, cart, checkout, and profile changes. It also rebases the environment onto current main, resolves the current Merriam-Webster port conflict, supplies usable seeded credentials, and updates the 17-site runtime/docs consistently.

Validation on #79: 7 verifier test groups pass; all 18 positive/no-op/prior-knowledge/wrong-answer matrices pass; all four stateful false claims fail without a real DB transition; Docker reports 17/17 sites alive; and the four write flows pass through real HTTP plus live SQLite checks. I also completed rendered-browser QA of the main release, merch, auth, checkout, orders, and profile flows.

The remaining integration dependency is the companion asset submission in ChilleD/WebHarbor discussion #26.