# 阿尼坊小程序用户指南

欢迎使用阿尼坊小程序！本指南将帮助您快速上手。

## 快速导航

登录认证 → 申请摊位 → 查看状态

---

## 一、登录流程

首次打开小程序时，系统会引导您完成微信登录。

### 步骤说明

**步骤 1：打开小程序**

通过微信搜索"阿尼坊"或扫描二维码进入小程序。

**步骤 2：触发登录**

当需要登录的功能（如申摊、预约）时，系统弹出登录提示。

![市集页面整体界面，右上角申摊按钮位置](screenshots/1_市集界面_右上角申摊.png)

点击「申摊」按钮，若未登录将弹出登录提示。

![未登录时点击申摊弹出的登录提示弹窗](screenshots/2_前往登录弹窗.jpg)

点击「去登录」按钮进入登录流程。

**步骤 3：填写个人信息**

![登录表单界面，填写头像、昵称，勾选用户协议](screenshots/3_填写昵称_头像信息.png)

- **头像选择** - 点击头像区域选择或上传头像
- **昵称填写** - 输入您的昵称（用于展示）
- **用户协议** - 勾选同意用户协议

填写完成后点击「登录」按钮。

**步骤 4：手机号授权**

![手机号授权弹窗，申请获取微信绑定号码](screenshots/4_登录后授权手机号弹窗.png)

点击「允许」按钮完成授权，手机号将用于：
- 接收验证码
- 订单通知
- 客服联系

**步骤 5：完成登录**

登录成功后：
- 您的头像和昵称显示在「我的」页面
- 系统自动生成唯一 UID（用户编号）

### 游客用户限制

未登录的游客用户仅可浏览：
- 活动公告
- 商铺卡片详情
- 摊位卡片详情

需要登录后才能使用：
- 设施预约
- 摊位申请
- 评论点赞
- 收藏功能

---

## 二、实名认证

实名认证是使用设施预约和摊位申请功能的前置条件。

### 认证入口

进入「我的」页面，点击「前往实名认证」按钮。

![登录后「我的」页面，实名认证入口按钮（同时可见预约详情入口）](screenshots/5_我的界面_前往实名认证.png)

### 认证信息填写

| 字段 | 说明 | 要求 |
|------|------|------|
| 真实姓名 | 与身份证一致 | 2-20个汉字 |
| 身份证号码 | 18位身份证号 | 正确格式验证 |

![实名认证表单，填写姓名和身份证号码](screenshots/6_填写实名认证信息.png)

输入您的真实姓名和身份证号码，确保信息准确无误。

填写完成后点击「提交」按钮，系统进行身份验证：
- 验证身份证号与姓名是否匹配
- 验证成功后显示「已实名」标签

### 重要提示

⚠️ **认证后不可修改**
实名认证完成后，姓名和身份证号不可更改。如需修改请联系客服。

⚠️ **信息准确性**
请确保填写的信息与身份证一致，错误信息可能导致认证失败。

### 解锁功能

实名认证后可使用：
- ✅ 设施预约（舞蹈室、练习室等）
- ✅ 摊位申请（动漫市集参展）
- ✅ 商铺卡片发布（商铺会员专属）

---

## 三、申摊流程

申请摊位参加阿尼坊动漫市集。

### 前置条件

申请摊位前请确保：
- ✅ 已完成微信登录
- ✅ 已完成实名认证

> 💡 未登录用户点击「申摊」时，会弹出登录提示（见登录流程）

### 申请入口

进入「市集」页面，点击右上角「申摊」按钮。

### 填写申请信息

| 字段 | 限制 | 说明 |
|------|------|------|
| 标题 | 50字以内 | 卡片标题 |
| 正文 | 500字以内 | 内容描述，可用 #标签 |
| 图片 | 1张，≤5MB | 卡片封面图 |
| 联系QQ | 可修改 | 客服联系渠道 |
| 预约场次 | 下拉选择 | 日期+区域 |
| 动漫IP标签 | 1-10个 | 必选至少1个 |

**填写步骤：**

1. 输入吸引人的标题和详细的内容描述（正文最多500字，可用 #标签）
2. 点击上传按钮，选择一张清晰图片作为卡片封面（≤5MB）
3. 从下拉菜单选择参展场次（显示日期、星期、场地区域），同一天仅能申请一个区域
4. 点击标签输入框搜索并选择标签（如：名侦探柯南、EVA、龙珠），至少选择1个，最多10个
5. 提交前需阅读申摊须知，勾选「已阅读」选项后点击「确认提交」

### 申请状态流转

| 状态 | 说明 |
|------|------|
| 待抽签 | 申请已提交，等待抽签 |
| 审核中 | 抽签中签，等待审核 |
| 待缴费 | 审核通过，等待支付 |
| 未中签 | 抽签未中 |
| 审核驳回 | 审核未通过（显示原因） |
| 成功 | 已公布摊位号 |

### 重要提示

⚠️ **场次限制**
- 每天仅能申请一个场次
- 申请前请确认场次信息

⚠️ **存稿机制**
- 系统自动保存上次填写内容
- 30天后自动清理存稿

---

## 四、预约详情

查看摊位申请和设施预约记录。

### 入口位置

进入「我的」页面，点击「预约详情」入口。

### 页面结构

页面分为两个栏目：
- **摊位栏目** - 摊位申请记录
- **设施栏目** - 设施预约记录

### 摊位申请状态

| 状态 | 显示内容 | 操作 |
|------|----------|------|
| 待抽签 | 场次信息、备注 | 无 |
| 待缴费 | 场次信息、订单号、金额、截止时间 | 「支付」「取消」按钮 |
| 未中签 | 场次信息 | 无 |
| 审核驳回 | 场次信息、驳回原因 | 无 |
| 待公布 | 场次信息、订单号、备注、退款提示 | 「申请退款」按钮 |
| 成功 | 场次信息、摊位号、订单号、备注 | 无 |
| 已失效 | 场次信息、订单号、备注 | 无 |

**摊位号格式**

公布后的摊位号格式：`月.日 + 区域 + 编号`

示例：`2.1 A区13`

### 设施预约状态

| 状态 | 显示内容 | 操作 |
|------|----------|------|
| 待缴费 | 设施名称、时间段、时长、金额、截止时间 | 「支付」「取消」按钮 |
| 成功 | 设施名称、时间段、订单号、退款提示 | 「申请退款」按钮 |
| 已失效 | 设施名称、时间段、订单号 | 无 |
| 已退款 | 设施名称、时间段、订单号 | 无 |

### 支付操作

**待缴费状态**

点击「支付」按钮进入微信支付流程，请在截止时间前完成支付，超时将自动取消订单。

**退款申请**

符合退款条件时点击「申请退款」按钮，系统处理退款请求，退款成功后状态变更为「已退款」。

### 重要提示

⚠️ **支付时限**
请在截止时间前完成支付，超时订单自动取消。

⚠️ **退款截止时间**
各场次有退款截止时间，请留意提示。

---

## 截图素材清单

### 已有截图

| 文件名 | 截图内容说明 | 对应章节 |
|--------|--------------|----------|
| `1_市集界面_右上角申摊.png` | 市集页面整体界面，右上角申摊按钮位置 | 一、登录流程 |
| `2_前往登录弹窗.jpg` | 未登录时点击申摊弹出的登录提示弹窗 | 一、登录流程 |
| `3_填写昵称_头像信息.png` | 登录表单界面，填写头像、昵称，勾选用户协议 | 一、登录流程 |
| `4_登录后授权手机号弹窗.png` | 手机号授权弹窗，申请获取微信绑定号码 | 一、登录流程 |
| `5_我的界面_前往实名认证.png` | 登录后「我的」页面，实名认证入口按钮 | 二、实名认证 |
| `6_填写实名认证信息.png` | 实名认证表单，填写姓名和身份证号码 | 二、实名认证 |

截图存放于 `screenshots/` 目录。

### 待补充截图

以下章节目前缺少对应截图，待后续补充：

- 三、申摊流程
- 四、预约详情

---

## 演示页面

可打开以下 HTML 文件在浏览器中查看完整指南：
- [演示h5_v1.html](演示h5_v1.html)
- [演示h5_v2_iPhone16竖屏比例.html](演示h5_v2_iPhone16竖屏比例.html)

### 本地预览方式

由于浏览器安全限制（CORS 策略），直接双击打开 HTML 文件（`file://` 协议）会导致图片无法加载。

**推荐方式：启动本地 HTTP 服务器**

双击运行 `start-server.bat` 启动脚本，然后浏览器访问：

```
http://localhost:3000/user-guide/演示h5_v2_iPhone16竖屏比例.html
```

或命令行启动：

```bash
cd user-guide
npx serve -l 3000
```

---

阿尼坊团队