雪团 XueTuan

以厦门大学马来西亚分校（XMUM）为起点的社区吃喝玩乐地图：记录自己去过的地方，打分、拍照、写点评，公开的部分合并到公共地图上。

• 需求文档：docs/PRD-V2.md（V2.0，现在的方向），docs/PRD.md（V1.0）
• 改进方案和步骤：docs/PLAN.md

运行

直接用浏览器打开 index.html 即可（需要联网加载地图和 MapLibre）。数据存在 Supabase；地址后面加 ?local 用只存在本机的本地版。

上线步骤见 docs/DEPLOY.md，数据库结构在 supabase/migrations/。

测试

pip install playwright pillow
python tests/test_app.py

测试用 tests/stub_maplibre.js 替换真实地图库、tests/stub_supabase.js 替换 Supabase（带一样的权限规则）、用假数据替换地点搜索（Photon），所以不需要联网。

地图数据

底图 © OpenFreeMap © OpenMapTiles © OpenStreetMap contributors。 地点搜索：Photon，数据来自 OpenStreetMap。