# 藏猫猫计划

一个面向朋友聚会、校园活动、亲子活动和团队团建的线下真人捉迷藏微信小程序原型。

当前交付版本：`0.1.0-mvp`。该版本适合单设备产品演示和用户访谈，不适合直接组织真实多人户外活动。

当前版本使用微信小程序原生 JavaScript 开发，内置本地模拟数据，无需后端即可跑通：

- 创建游戏与配置规则
- 通过房间码加入游戏
- 候场与身份分配
- 准备阶段和游戏倒计时
- 模糊位置线索、雷达与静默技能
- 动态口令抓捕
- 游戏结算与战报

## 运行方式

1. 安装并打开微信开发者工具。
2. 选择“导入项目”，目录选择本仓库。
3. AppID 可使用测试号；仓库中的 `project.config.json` 默认使用游客 AppID。
4. 编译后从首页开始体验。

推荐使用演示房间码 `731204`，或创建房间后由系统自动补充模拟玩家。

## 自动检查

本项目不依赖 npm。安装 Node.js 后可直接运行：

```bash
node tests/run-all.js
```

自动检查覆盖本地游戏服务、页面事件绑定和发布文件完整性。微信特有能力仍需按照 [真机验收清单](docs/DEVICE_TEST_CHECKLIST.md) 在开发者工具和真机上确认。

## 交付文档

- [一周实施规划](docs/ONE_WEEK_MVP_PLAN.md)
- [5 分钟演示脚本](docs/DEMO_GUIDE.md)
- [测试报告](docs/TEST_REPORT.md)
- [真机验收清单](docs/DEVICE_TEST_CHECKLIST.md)
- [版本说明与已知限制](docs/RELEASE_NOTES.md)

原型中的房间、玩家和游戏状态保存在本机 `wx.setStorageSync` 中。创建房间后，候场页会自动加入模拟玩家，便于单人体验完整流程。

## 目录

```text
.
├─ docs/
│  ├─ PRD.md                    产品需求文档
│  ├─ TECHNICAL_DESIGN.md       技术设计与后端演进方案
│  ├─ ONE_WEEK_MVP_PLAN.md      一周实施规划与完成记录
│  ├─ DEMO_GUIDE.md             5 分钟演示脚本
│  ├─ TEST_REPORT.md            自动回归报告
│  ├─ DEVICE_TEST_CHECKLIST.md  真机验收清单
│  └─ RELEASE_NOTES.md          版本说明与已知限制
├─ pages/
│  ├─ home/                  首页
│  ├─ create/                创建游戏
│  ├─ join/                  加入房间
│  ├─ lobby/                 游戏候场
│  ├─ game/                  游戏进行中
│  ├─ result/                游戏结算
│  └─ rules/                 安全规则
├─ services/
│  └─ game-service.js        本地模拟游戏服务
├─ tests/                     自动回归与发布检查
└─ utils/
   ├─ constants.js           模式与规则常量
   └─ format.js              通用格式化方法
```

## 下一阶段

进入真实多人测试前，需要将 `services/game-service.js` 替换为云开发或自有后端，并补齐：

- 微信登录和服务端身份校验
- WebSocket 房间状态同步
- 授权后的真实定位上报
- 服务端计时、口令签名和防作弊
- 内容安全、未成年人保护和数据删除机制

详细说明见 [产品需求](docs/PRD.md) 和 [技术设计](docs/TECHNICAL_DESIGN.md)。