# 阿尼坊小程序用户指南文档编写计划

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 编写用户指南文档，指引游客用户完成登录→实名认证→申摊流程，并介绍预约详情查看和Bug反馈方法。

**Architecture:** 采用模块化文档结构，每个流程独立成文，便于后续生成HTML5 PPT页面。文档包含清晰的步骤说明、截图占位符标注、关键提示框。

**Tech Stack:** Markdown文档 + 截图素材（来自测试记录目录）

---

## 文件结构规划

```
user-guide/
├── README.md                 # 文档总览和导航索引
├── 01-登录流程.md            # 微信登录绑定步骤
├── 02-实名认证.md            # 实名认证填写指引
├── 03-申摊流程.md            # 摊位申请完整流程
├── 04-预约详情.md            # 查看申请状态和订单
├── 05-问题反馈.md            # Bug反馈和客服联系指引
└── screenshots/              # 截图素材目录（待补充）
```

---

### Task 1: 创建文档目录结构

**Files:**
- Create: `user-guide/README.md`
- Create: `user-guide/screenshots/.gitkeep`

- [ ] **Step 1: 创建目录结构**

```bash
mkdir -p "D:/AI/knowledge-base/user-guide/screenshots"
touch "D:/AI/knowledge-base/user-guide/screenshots/.gitkeep"
```

- [ ] **Step 2: 创建导航索引文档**

Write to `user-guide/README.md`:

```markdown
# 阿尼坊小程序用户指南

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

## 目录

1. [登录流程](01-登录流程.md) - 微信授权登录
2. [实名认证](02-实名认证.md) - 完成身份验证
3. [申摊流程](03-申摊流程.md) - 申请摊位参展
4. [预约详情](04-预约详情.md) - 查看申请状态
5. [问题反馈](05-问题反馈.md) - 获取帮助和反馈问题

## 快速开始

如果您是新用户，建议按顺序阅读以上文档。如有问题，请参考[问题反馈](05-问题反馈.md)联系客服。

---
阿尼坊团队
```

- [ ] **Step 3: 验证目录结构**

```bash
ls -la "D:/AI/knowledge-base/user-guide/"
```

Expected: 显示 README.md 和 screenshots/ 目录

---

### Task 2: 编写登录流程文档

**Files:**
- Create: `user-guide/01-登录流程.md`

- [ ] **Step 1: 编写登录流程文档**

Write to `user-guide/01-登录流程.md`:

```markdown
# 登录流程

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

## 步骤说明

### 1. 打开小程序

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

> 📸 **截图占位**: 小程序首页界面

### 2. 授权登录

首次进入时，系统会弹出微信授权提示：

- 点击「允许」按钮，授权获取微信头像和昵称
- 系统自动为您创建会员账号

> 📸 **截图占位**: 微信授权弹窗界面

### 3. 完成登录

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

> 📸 **截图占位**: 「我的」页面展示用户信息

## 重要提示

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

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

## 下一步

完成登录后，请继续[实名认证](02-实名认证.md)以解锁完整功能。
```

- [ ] **Step 2: 验证文档内容**

```bash
cat "D:/AI/knowledge-base/user-guide/01-登录流程.md"
```

Expected: 显示完整文档内容

---

### Task 3: 编写实名认证文档

**Files:**
- Create: `user-guide/02-实名认证.md`

- [ ] **Step 1: 编写实名认证文档**

Write to `user-guide/02-实名认证.md`:

```markdown
# 实名认证

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

## 认证入口

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

> 📸 **截图占位**: 「我的」页面实名认证入口

## 认证信息填写

### 必填内容

| 字段 | 说明 | 示例 |
|------|------|------|
| 真实姓名 | 与身份证一致 | 张三 |
| 身份证号码 | 18位身份证号 | 123456789012345678 |
| 手机号码 | 接收验证码 | 13800138000 |

### 1. 填写姓名和身份证号

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

> 📸 **截图占位**: 实名认证表单界面

### 2. 手机号验证

输入手机号码后：
- 点击「发送验证码」按钮
- 系统发送6位验证码短信
- 30秒内不可重复发送

> 📸 **截图占位**: 验证码输入界面

### 3. 提交认证

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

> 📸 **截图占位**: 认证成功界面

## 重要提示

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

⚠️ **手机号修改限制**
- 注册后首次可自由修改
- 之后每次修改需等待30天冷却期

## 解锁功能

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

## 下一步

完成实名认证后，您可以：
- [申请摊位](03-申摊流程.md) - 参加动漫市集
- [预约设施](#) - 使用场地设施
```

- [ ] **Step 2: 验证文档内容**

```bash
cat "D:/AI/knowledge-base/user-guide/02-实名认证.md"
```

Expected: 显示完整文档内容

---

### Task 4: 编写申摊流程文档

**Files:**
- Create: `user-guide/03-申摊流程.md`

- [ ] **Step 1: 编写申摊流程文档**

Write to `user-guide/03-申摊流程.md`:

```markdown
# 申摊流程

本指南帮助您完成摊位申请，参加阿尼坊动漫市集。

## 前置条件

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

> 💡 未实名用户点击「申摊」时会弹出认证提示

## 申请入口

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

> 📸 **截图占位**: 市集页面申摊按钮位置

## 填写申请信息

### 必填内容

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

### 1. 填写标题和正文

输入吸引人的标题和详细的内容描述。

> 📸 **截图占位**: 申摊表单填写界面

### 2. 上传图片

点击上传按钮，选择一张清晰图片作为卡片封面。

> 📸 **截图占位**: 图片上传界面

### 3. 选择场次

从下拉菜单选择参展场次：
- 显示日期、星期、场地区域
- 同一天仅能申请一个区域

> 📸 **截图占位**: 场次选择下拉菜单

### 4. 添加动漫IP标签

点击标签输入框：
- 可搜索标签（如：名侦探柯南、EVA、龙珠）
- 至少选择1个标签，最多10个

> 📸 **截图占位**: 标签搜索选择界面

### 5. 查看须知弹窗

提交前需阅读申摊须知：
- 勾选「已阅读」选项
- 点击「确认提交」

> 📸 **截图占位**: 申摊须知弹窗

## 申请结果

提交成功后显示注意事项弹窗，可通过「预约详情」查看进度。

> 📸 **截图占位**: 申请成功提示界面

## 申请状态流转

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

## 重要提示

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

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

## 下一步

提交申请后，请前往[预约详情](04-预约详情.md)查看申请状态。
```

- [ ] **Step 2: 验证文档内容**

```bash
cat "D:/AI/knowledge-base/user-guide/03-申摊流程.md"
```

Expected: 显示完整文档内容

---

### Task 5: 编写预约详情文档

**Files:**
- Create: `user-guide/04-预约详情.md`

- [ ] **Step 1: 编写预约详情文档**

Write to `user-guide/04-预约详情.md`:

```markdown
# 预约详情

本页面展示您的摊位申请和设施预约记录。

## 入口位置

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

> 📸 **截图占位**: 「我的」页面预约详情入口

## 页面结构

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

> 📸 **截图占位**: 预约详情页面整体布局

## 摊位申请状态

### 状态说明

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

### 摊位号格式

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

示例：`2.1 A区13`

> 📸 **截图占位**: 成功状态显示摊位号

## 设施预约状态

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

> 📸 **截图占位**: 设施预约成功状态

## 支付操作

### 待缴费状态

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

> 📸 **截图占位**: 支付界面倒计时提示

### 退款申请

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

> 📸 **截图占位**: 退款申请界面

## 重要提示

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

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

## 下一步

如有问题，请参考[问题反馈](05-问题反馈.md)联系客服。
```

- [ ] **Step 2: 验证文档内容**

```bash
cat "D:/AI/knowledge-base/user-guide/04-预约详情.md"
```

Expected: 显示完整文档内容

---

### Task 6: 编写问题反馈文档

**Files:**
- Create: `user-guide/05-问题反馈.md`

- [ ] **Step 1: 编写问题反馈文档**

Write to `user-guide/05-问题反馈.md`:

```markdown
# 问题反馈

遇到问题或Bug时，请通过以下方式联系客服。

## 获取您的 UID

UID（用户编号）是客服定位您账号的关键信息。

### 查看位置

进入「我的」页面，头像下方显示您的 UID。

> 📸 **截图占位**: 「我的」页面 UID 显示位置

### UID 格式

格式：`UID: XXXXXX`（6位数字）

**反馈时请提供准确的 UID，帮助客服快速定位问题。**

## 意见反馈入口

进入「我的」页面，点击「意见反馈」。

> 📸 **截图占位**: 意见反馈入口位置

## 反馈内容填写

### 问题分类选择

| 分类 | 适用场景 |
|------|----------|
| 设施预约 | 场地预约问题 |
| 摊位申请 | 申摊流程问题 |
| 商铺发布 | 商铺卡片问题 |
| 支付/退款 | 支付退款问题 |
| 实名认证 | 认证相关问题 |
| 账号/登录 | 登录账号问题 |
| 内容审核 | 内容审核问题 |
| 活动公告 | 公告相关问题 |
| 功能建议 | 新功能建议 |
| 投诉举报 | 投诉举报问题 |
| 技术故障 | Bug技术问题 |
| 其他问题 | 其他类型问题 |

> 📸 **截图占位**: 问题分类选择界面

### 正文填写

- 字数限制：800字以内
- 请详细描述问题发生过程
- 包含：操作步骤、错误提示、发生时间

> 📸 **截图占位**: 反馈正文输入界面

### 上传限制

- 每小时仅限上传一次反馈
- 如需多次反馈，请等待一小时

## 联系客服渠道

### 入口位置

进入「我的」页面，点击「联系渠道」。

> 📸 **截图占位**: 联系渠道入口

### 联系方式弹窗

弹窗显示：
- 客服电话
- 客服微信
- 客服邮箱
- 工作时间

点击联系方式自动复制，显示提示气泡。

> 📸 **截图占位**: 联系方式弹窗界面

## Bug反馈指引

### 反馈内容模板

```
【问题描述】
简要描述遇到的问题

【UID】
您的用户编号

【发生时间】
问题发生的时间

【操作步骤】
1. 进入某页面
2. 点击某按钮
3. 出现某错误

【截图/视频】
如有截图或录屏请附上

【期望结果】
您期望的正常结果
```

### 示例反馈

```
【问题描述】
点击支付按钮后显示"服务器繁忙"

【UID】
123456

【发生时间】
2026年4月10日 下午3点

【操作步骤】
1. 进入预约详情
2. 点击"支付"按钮
3. 弹出"服务器繁忙"提示

【截图】
（附上截图）

【期望结果】
正常进入微信支付界面
```

## 重要提示

⚠️ **提供 UID**
反馈时务必提供您的 UID，客服需要通过 UID 定位账号。

⚠️ **详细描述**
请尽量详细描述操作步骤，帮助技术团队复现问题。

⚠️ **截图证据**
如有错误界面截图，请一并反馈，加速问题解决。
```

- [ ] **Step 2: 验证文档内容**

```bash
cat "D:/AI/knowledge-base/user-guide/05-问题反馈.md"
```

Expected: 显示完整文档内容

---

### Task 7: 创建截图素材说明文档

**Files:**
- Create: `user-guide/screenshots/README.md`

- [ ] **Step 1: 创建截图需求清单**

Write to `user-guide/screenshots/README.md`:

```markdown
# 截图素材需求清单

本文档列出各用户指南文档所需的截图素材，请按清单准备截图。

## 01-登录流程.md 截图需求

| 序号 | 截图名称 | 截图内容说明 |
|------|----------|--------------|
| 1 | `login-homepage.png` | 小程序首页界面 |
| 2 | `login-auth-popup.png` | 微信授权弹窗界面 |
| 3 | `login-my-page.png` | 「我的」页面展示用户信息 |

## 02-实名认证.md 截图需求

| 序号 | 截图名称 | 截图内容说明 |
|------|----------|--------------|
| 1 | `auth-entry.png` | 「我的」页面实名认证入口 |
| 2 | `auth-form.png` | 实名认证表单界面 |
| 3 | `auth-verify-code.png` | 验证码输入界面 |
| 4 | `auth-success.png` | 认证成功界面 |

## 03-申摊流程.md 截图需求

| 序号 | 截图名称 | 截图内容说明 |
|------|----------|--------------|
| 1 | `apply-button.png` | 市集页面申摊按钮位置 |
| 2 | `apply-form.png` | 申摊表单填写界面 |
| 3 | `apply-upload.png` | 图片上传界面 |
| 4 | `apply-session-select.png` | 场次选择下拉菜单 |
| 5 | `apply-tag-search.png` | 标签搜索选择界面 |
| 6 | `apply-notice-popup.png` | 申摊须知弹窗 |
| 7 | `apply-success.png` | 申请成功提示界面 |

## 04-预约详情.md 截图需求

| 序号 | 截图名称 | 截图内容说明 |
|------|----------|--------------|
| 1 | `detail-entry.png` | 「我的」页面预约详情入口 |
| 2 | `detail-layout.png` | 预约详情页面整体布局 |
| 3 | `detail-booth-success.png` | 成功状态显示摊位号 |
| 4 | `detail-facility.png` | 设施预约成功状态 |
| 5 | `detail-payment-timer.png` | 支付界面倒计时提示 |
| 6 | `detail-refund.png` | 退款申请界面 |

## 05-问题反馈.md 截图需求

| 序号 | 截图名称 | 截图内容说明 |
|------|----------|--------------|
| 1 | `feedback-uid.png` | 「我的」页面 UID 显示位置 |
| 2 | `feedback-entry.png` | 意见反馈入口位置 |
| 3 | `feedback-category.png` | 问题分类选择界面 |
| 4 | `feedback-form.png` | 反馈正文输入界面 |
| 5 | `feedback-contact-entry.png` | 联系渠道入口 |
| 6 | `feedback-contact-popup.png` | 联系方式弹窗界面 |

## 截图命名规范

- 使用英文小写字母
- 使用连字符分隔单词
- 文件格式：PNG 或 JPG
- 建议尺寸：宽度750px（适配移动端）

## 截图存放位置

将截图文件放入此目录（`user-guide/screenshots/`），然后在对应文档中替换截图占位符。
```

- [ ] **Step 2: 验证文档内容**

```bash
cat "D:/AI/knowledge-base/user-guide/screenshots/README.md"
```

Expected: 显示完整文档内容

---

### Task 8: 提交文档到 Git

**Files:**
- Modified: Git repository (新增 user-guide/ 目录)

- [ ] **Step 1: 检查新增文件**

```bash
git status
```

Expected: 显示 user-guide/ 目录下的所有新增文件

- [ ] **Step 2: 提交文档**

```bash
git add user-guide/
git commit -m "docs: 添加阿尼坊小程序用户指南文档

包含以下模块：
- 登录流程指引
- 实名认证步骤
- 申摊流程说明
- 预约详情查看
- 问题反馈指引
- 截图素材需求清单"
```

Expected: 提交成功

---

## 自检清单

### 1. 文档覆盖检查

| 需求项 | 对应文档 | 状态 |
|--------|----------|------|
| 登录流程 | 01-登录流程.md | ✅ |
| 实名认证 | 02-实名认证.md | ✅ |
| 申摊流程 | 03-申摊流程.md | ✅ |
| 预约详情 | 04-预约详情.md | ✅ |
| UID获取 | 05-问题反馈.md | ✅ |
| Bug反馈指引 | 05-问题反馈.md | ✅ |

### 2. 占位符检查

所有截图使用统一格式占位符：`> 📸 **截图占位**: [截图内容说明]`

### 3. 一致性检查

- UID 格式说明统一：`UID: XXXXXX`（6位数字）
- 摊位号格式统一：`月.日 + 区域 + 编号`
- 状态名称与需求文档一致