Files
playFun-uni/README.md
2026-10-12 11:22:26 +08:00

41 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 拍立方 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. 在确认交互后,再接入订单、名额锁定、微信支付、退款和运营接口。