first commit

README.md

@@ -0,0 +1,40 @@
+# 拍立方 PLAYFUN
+
+Vue 3 + JavaScript + uni-app 微信小程序交互演示。当前使用本地 mock 数据，不请求接口、不登录、不创建真实订单，也不会发起微信支付。
+
+## 运行
+
+```bash
+npm install
+npm run dev:h5
+```
+
+规则测试：`node --test tests/mock-engine.test.js`。
+
+浏览器预览默认位于 `http://localhost:9876/`。开发服务监听所有网卡，同一局域网设备可通过 `http://<电脑局域网 IP>:9876/` 访问；电脑防火墙需允许该端口的入站连接。微信开发者工具可导入 `npm run build:mp-weixin` 生成的 `dist/build/mp-weixin`。当前 `manifest.json` 使用体验 AppID；真机预览与发布前需替换为自己的小程序 AppID。
+
+当前 mock 演示不访问接口。如需开发代理，在 `.env.local` 中设置 `VITE_API_PROXY_TARGET`，例如 `http://127.0.0.1:3000`，开发时 `/api/*` 会去掉 `/api` 前缀后转发到该目标。
+
+## 已实现的 mock 流程
+
+- 首页场地搜索、价格带筛选和场地详情。
+- 场地区域示意地图、设施信息、未来三天时段和本地剩余片数。
+- 约球页按段位筛选、发起拼场、加入拼场；待支付订单暂占名额 10 分钟，模拟付款后确认占位。
+- 从场地详情选择时段后，带入发起表单；发起人的待支付订单暂占一片演示场地，付款后拼场公开。
+- 拼场详情展示费用、人数、报名截止和状态；支持截止前取消、演示退款及模拟球友补位。
+- 我的订单可查看待支付、已支付、支付超时、取消和退款；“我的”页可推进演示时间验证截止规则。
+- “我的”页可指定演示日期和时间；场地时段与新生成的演示拼场跟随该时钟，回拨不会清空既有订单和赛果。
+- 成局后由演示平台确认具体球场；开场前 2 小时仍未确认或场地无法履约时，整场取消并模拟全额退款。
+- 开场前 30 分钟至开场后 15 分钟可签到；球友列表支持逐人模拟签到，未签到自动标记。签到截止时，2 人场必须 2 人签到、4 人场必须 4 人签到，否则整场取消；已签到用户退款，未签到用户不退款。完赛后已签到用户可提交比分与场地评价，由模拟对手确认；确认后按我方胜负结算段位积分，同场只结算一次。
+- 报名截止后可提交取消申请，再用详情页中的演示运营控件审核；审核通过取消整场并模拟全额退款。
+- 15 题自评、30 天重评限制、自评段位参与报名校验。
+- 段位页区分自评匹配段位与段位积分；已确认的拼场赛果我方胜利 +160 分、落败 +80 分。每周完成 2 场约球、赢得 1 场对局或完成 3 次赛后评价可分别领取一次 +60 分任务奖励。旧版一键积分赛的无依据积分在数据升级时清除，拼场、订单和自评记录保留。
+- 我的拼场与统计、本地昵称编辑和演示数据重置。
+
+演示操作使用小程序本地存储，重启后仍保留。所有价格、地址、时段和场地信息均为示例，不代表真实库存。首六个月平台服务费为 0；本阶段没有真实支付和退款。新版 mock 状态会保留上一阶段的本地拼场、订单、昵称和自评结果。
+
+## 后续阶段
+
+1. 明确真实场馆接单、球场分配和场地异常的运营责任。
+2. 定稿取消申请的审核依据、退款政策和未签到的争议处理。
+3. 在确认交互后，再接入订单、名额锁定、微信支付、退款和运营接口。