This repository has been archived on 2026-04-19. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
knowledge-base/docs/superpowers/plans/2026-04-18-user-guide-docs.md
T
sujianhua 2cc6d646e1 docs: 添加项目配置和开发计划文档
- 新增 CLAUDE.md 项目配置文件
- 新增 superpowers 开发计划文档
2026-04-20 00:00:53 +08:00

755 lines
18 KiB
Markdown
Raw 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.
# 阿尼坊小程序用户指南文档编写计划
> **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位数字)
- 摊位号格式统一:`月.日 + 区域 + 编号`
- 状态名称与需求文档一致