# 场馆预约产品设计资产

本仓库是场馆预约产品后续设计迭代与发布的统一入口。

## 产品目录

```text
venue-reservation-ui/
├── consumer-miniapp/
│   ├── v1.0.0-overview/       # 消费者端八屏总览
│   └── v1.1.0-flow-demo/      # 消费者端可点击交易原型（当前）
├── merchant-miniapp/
│   └── v0.1.0/                # 商户工作台首版（当前）
├── pc-admin/
│   └── v0.1.0/                # PC 超级管理员端首版（当前）
├── shared/                    # 共用 Token 与本地运行依赖
├── FIGMA-SYNC-PLAN.md         # Figma 页面结构与续传方案
├── index.html                 # 设计资产发布入口
└── CHANGELOG.md               # 跨产品变更记录
```

## 版本规则

每个产品端独立维护版本，采用语义化版本：`主版本.次版本.修订版本`。

- 主版本：信息架构或视觉系统发生不兼容调整；
- 次版本：新增页面、流程或重要交互；
- 修订版本：文案、间距、颜色、状态和小范围修复；
- 探索阶段从 `v0.1.0` 开始，评审冻结后进入 `v1.0.0`；
- 旧版本不覆盖，在对应产品目录下新增版本文件夹；
- 首页在每个产品端下方维护自己的版本记录，并标记当前开发版本。

每个版本目录至少包含：原型 HTML、预览图、页面清单、已知限制和数据说明。

## 本地预览

在仓库根目录运行：

```bash
python3 -m http.server 8765 --bind 127.0.0.1
```

然后打开：<http://127.0.0.1:8765/>

原型使用 `shared/vendor/` 中固定版本的 React 与 Babel，无需外网即可运行。

## Figma

- 文件：<https://www.figma.com/design/5Deu70txLRGl9dUbHB5gQL>
- File Key：`5Deu70txLRGl9dUbHB5gQL`
- 页面建议：`00-Cover`、`01-Foundations`、`10-Consumer-v1.x`、`20-Merchant-v0.x`、`30-PC-Admin-v0.x`、`90-Archive`。
- 续传计划见 [`FIGMA-SYNC-PLAN.md`](./FIGMA-SYNC-PLAN.md)。