docs: 添加项目配置和开发计划文档
- 新增 CLAUDE.md 项目配置文件 - 新增 superpowers 开发计划文档
This commit is contained in:
@@ -0,0 +1,83 @@
|
||||
# CLAUDE.md
|
||||
|
||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||
|
||||
## 项目概述
|
||||
|
||||
阿尼坊（Anifang）知识库 - 微信小程序前端与后台管理系统的需求文档和测试资料存储库。
|
||||
|
||||
## 文档结构
|
||||
|
||||
### 核心需求文档
|
||||
|
||||
| 文档 | 位置 | 说明 |
|
||||
|------|------|------|
|
||||
| 小程序会员系统需求 | `mini-app/阿尼坊会员系统功能需求MD.md` | 小程序前端功能规范，含UI设计、交互逻辑、流程图 |
|
||||
| 后台管理系统需求 | `mini-app/阿尼坊后台管理系统功能需求文档.md` | 后台功能模块定义、数据字段、权限配置 |
|
||||
|
||||
### 测试资料
|
||||
|
||||
- **BUG-优化收集**: `mini-app/BUG-优化收集/{日期}/` - 按日期组织的 bug 记录
|
||||
- Excel 表格: `BUG-优化收集.xlsx`
|
||||
- 图片证据: `图片/` 目录
|
||||
- 视频证据: `视频/` 目录
|
||||
- **测试记录**: `mini-app/测试记录/` - 功能测试截图和视频
|
||||
|
||||
## 核心业务模块
|
||||
|
||||
### 小程序端
|
||||
|
||||
1. **活动公告** - 轮播图、公告文章、评论、点赞
|
||||
2. **设施预约** - 日历式时间选择、时段锁定机制、支付流程
|
||||
3. **商摊市集** - 摊位卡片/商铺卡片瀑布流、申摊/发布、热度排序
|
||||
4. **我的** - 用户信息、预约详情、收藏、意见反馈
|
||||
|
||||
### 后台管理端
|
||||
|
||||
1. **内容管理** - 公告、卡片审核、评论管理
|
||||
2. **设施预约** - 设施配置、价格规则、订单管理
|
||||
3. **摊位市集** - 场次管理、申摊审核、抽签系统、摊位分配
|
||||
4. **用户管理** - 实名认证、会员类型、黑名单
|
||||
5. **系统管理** - 管理员账号、权限、操作日志
|
||||
|
||||
## 关键业务逻辑
|
||||
|
||||
### 摊位申请流程
|
||||
|
||||
```
|
||||
用户提交申摊 → 待抽签 → 抽签执行 → (中签)审核中 → 审核通过 → 待缴费 → 缴费成功 → 待公布 → 成功(公布摊位号)
|
||||
```
|
||||
|
||||
状态流转详见需求文档中的 mermaid 流程图。
|
||||
|
||||
### 设施预约时段锁定
|
||||
|
||||
- 用户确认预订后临时锁定15分钟
|
||||
- 超时未支付自动释放
|
||||
- 支付成功转为正式占用
|
||||
|
||||
### 热度值计算
|
||||
|
||||
```
|
||||
热度值 = 基础热度分 × 时间衰减系数 × 编辑惩罚系数
|
||||
基础热度分 = 点击数×点击权重 + 点赞数×点赞权重 + 评论数×评论权重
|
||||
```
|
||||
|
||||
## 文档约定
|
||||
|
||||
- 需求文档使用 mermaid 图表描述流程
|
||||
- UI设计参考：微信公众号、小红书、酒店APP等
|
||||
- 功能优先级：P0(核心必须) / P1(重要功能)
|
||||
- 数据字段在需求文档中逐模块定义
|
||||
|
||||
## Git 提交规范
|
||||
|
||||
提交消息使用中文描述，遵循约定式提交格式：
|
||||
|
||||
```
|
||||
<类型>: <描述>
|
||||
|
||||
<可选正文>
|
||||
```
|
||||
|
||||
类型：feat, fix, refactor, docs, test, chore, perf, ci
|
||||
@@ -0,0 +1,755 @@
|
||||
# 阿尼坊小程序用户指南文档编写计划
|
||||
|
||||
> **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位数字）
|
||||
- 摊位号格式统一：`月.日 + 区域 + 编号`
|
||||
- 状态名称与需求文档一致
|
||||
@@ -0,0 +1,160 @@
|
||||
# 用户指南 HTML 文件调整实现计划
|
||||
|
||||
> **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:** 根据 README.md 目录结构，移除两个 HTML 文件中的"问题反馈"章节，使内容与基准文档保持一致。
|
||||
|
||||
**Architecture:** 直接修改 HTML 文件，删除"问题反馈"相关内容，调整页码和导航结构。不涉及逻辑变更，纯内容调整。
|
||||
|
||||
**Tech Stack:** HTML5, CSS, JavaScript（仅 v1.html 有滚动监听脚本）
|
||||
|
||||
---
|
||||
|
||||
## 文件结构变更
|
||||
|
||||
| 文件 | 操作 | 变更内容 |
|
||||
|------|------|----------|
|
||||
| `user-guide/演示h5_v1.html` | 修改 | 移除侧边栏"05-问题反馈"、首页目录第5项、整个问题反馈section |
|
||||
| `user-guide/演示h5_v2_ iPhone16竖屏比例.html` | 修改 | 移除封面第5项、第8页卡片、调整页码为01/07~07/07、工具栏提示改为7页 |
|
||||
|
||||
---
|
||||
|
||||
### Task 1: 调整演示h5_v1.html
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/演示h5_v1.html:27,65-69,236-261`
|
||||
|
||||
- [ ] **Step 1: 移除侧边栏导航中的问题反馈项**
|
||||
|
||||
修改第27行附近的侧边栏导航，删除 `<li><a href="#feedback">05 - 问题反馈</a></li>`：
|
||||
|
||||
```html
|
||||
<ul class="nav-links">
|
||||
<li><a href="#readme">首页：用户指南</a></li>
|
||||
<li><a href="#login">01 - 登录流程</a></li>
|
||||
<li><a href="#auth">02 - 实名认证</a></li>
|
||||
<li><a href="#booth">03 - 申摊流程</a></li>
|
||||
<li><a href="#reservation">04 - 预约详情</a></li>
|
||||
</ul>
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 移除首页目录中的问题反馈项**
|
||||
|
||||
修改第65-69行附近的目录列表，删除第5项：
|
||||
|
||||
```html
|
||||
<ol>
|
||||
<li><a href="#login" style="color:var(--primary-color)">登录流程</a> - 微信授权登录</li>
|
||||
<li><a href="#auth" style="color:var(--primary-color)">实名认证</a> - 完成身份验证</li>
|
||||
<li><a href="#booth" style="color:var(--primary-color)">申摊流程</a> - 申请摊位参展</li>
|
||||
<li><a href="#reservation" style="color:var(--primary-color)">预约详情</a> - 查看申请状态</li>
|
||||
</ol>
|
||||
```
|
||||
|
||||
同时更新第71行的快速开始提示：
|
||||
|
||||
```html
|
||||
<h2>快速开始</h2>
|
||||
<p>如果您是新用户，建议按顺序阅读以上文档。如有问题，请通过「我的」-「意见反馈」联系客服。</p>
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 移除整个问题反馈section**
|
||||
|
||||
删除第236-261行左右的 `<section id="feedback" class="section">` 整个区块（约25行代码）。
|
||||
|
||||
- [ ] **Step 4: 验证文件**
|
||||
|
||||
在浏览器中打开文件，确认：
|
||||
- 侧边栏仅有5项（首页 + 4个流程）
|
||||
- 目录仅有4项
|
||||
- 无问题反馈section
|
||||
- 滚动监听脚本正常工作
|
||||
|
||||
---
|
||||
|
||||
### Task 2: 调整演示h5_v2_ iPhone16竖屏比例.html
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/演示h5_v2_ iPhone16竖屏比例.html:145-146,157-163,346-377`
|
||||
|
||||
- [ ] **Step 1: 更新工具栏提示页数**
|
||||
|
||||
修改第145-146行的工具栏提示：
|
||||
|
||||
```html
|
||||
<div class="toolbar">
|
||||
💡 页面布局已调整为 iPhone 16 竖屏比例 (393x852) - 共 7 页，请直接框选白色卡片范围进行截图。
|
||||
</div>
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 调整封面列表**
|
||||
|
||||
修改第157-163行的封面列表，移除第5项并调整内容：
|
||||
|
||||
```html
|
||||
<ol>
|
||||
<li><strong style="color:var(--primary-color)">登录流程</strong> - 微信授权登录</li>
|
||||
<li><strong style="color:var(--primary-color)">实名认证</strong> - 完成身份验证</li>
|
||||
<li><strong style="color:var(--primary-color)">申摊流程</strong> - 申请摊位参展</li>
|
||||
<li><strong style="color:var(--primary-color)">预约详情</strong> - 查看申请状态</li>
|
||||
</ol>
|
||||
```
|
||||
|
||||
同时更新第165行的底部提示：
|
||||
|
||||
```html
|
||||
<p style="margin-top: 30px; font-size: 13px;">欢迎使用阿尼坊！本指南将帮助您快速上手，顺利参与动漫市集。如有问题请通过「我的」-「意见反馈」联系客服。</p>
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 删除第8页（问题反馈）卡片**
|
||||
|
||||
删除第346-377行的整个 Page 8 卡片：
|
||||
|
||||
```html
|
||||
<!-- Page 8: 问题反馈 -->
|
||||
<div class="iphone-card">
|
||||
...
|
||||
</div>
|
||||
```
|
||||
|
||||
- [ ] **Step 4: 调整所有页码**
|
||||
|
||||
逐页更新页码显示：
|
||||
- 第150行：`01 / 08` → `01 / 07`
|
||||
- 第172行：`02 / 08` → `02 / 07`
|
||||
- 第197行：`03 / 08` → `03 / 07`
|
||||
- 第222行：`04 / 08` → `04 / 07`
|
||||
- 第248行：`05 / 08` → `05 / 07`
|
||||
- 第281行：`06 / 08` → `06 / 07`
|
||||
- 第315行：`07 / 08` → `07 / 07`
|
||||
|
||||
- [ ] **Step 5: 验证文件**
|
||||
|
||||
在浏览器中打开文件，确认：
|
||||
- 工具栏显示"共7页"
|
||||
- 封面列表仅有4项
|
||||
- 页码为 01/07 ~ 07/07
|
||||
- 无第8页问题反馈卡片
|
||||
|
||||
---
|
||||
|
||||
### Task 3: 最终验证与提交
|
||||
|
||||
**Files:**
|
||||
- Verify: `user-guide/README.md` (基准文档)
|
||||
|
||||
- [ ] **Step 1: 对比验证**
|
||||
|
||||
确认两个 HTML 文件的内容与 README.md 目录结构一致：
|
||||
- 登录流程 ✓
|
||||
- 实名认证 ✓
|
||||
- 申摊流程 ✓
|
||||
- 预约详情 ✓
|
||||
- 无问题反馈章节 ✓
|
||||
|
||||
- [ ] **Step 2: 提交变更**
|
||||
|
||||
```bash
|
||||
git add user-guide/演示h5_v1.html user-guide/演示h5_v2_ iPhone16竖屏比例.html
|
||||
git commit -m "docs: 根据 README.md 调整 HTML 文件，移除问题反馈章节"
|
||||
```
|
||||
@@ -0,0 +1,755 @@
|
||||
# 用户指南截图集成实施计划
|
||||
|
||||
> **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:** 根据现有6张截图内容，调整user-guide目录中的md文档和html文件，将截图正确引用到文档中。
|
||||
|
||||
**Architecture:** 分析现有截图与文档的映射关系，更新文档中的截图占位符为实际截图引用，并调整文档描述使其与截图内容一致。
|
||||
|
||||
**Tech Stack:** Markdown文档, HTML演示页面
|
||||
|
||||
---
|
||||
|
||||
## 截图与文档映射分析
|
||||
|
||||
| 截图文件 | 内容描述 | 对应文档位置 |
|
||||
|----------|----------|--------------|
|
||||
| `1_市集界面_右上角申摊.png` | 市集页面，底部导航"市集"高亮，右上角"申摊"按钮 | 03-申摊流程.md 申请入口 |
|
||||
| `2_前往登录弹窗.jpg` | 登录提示弹窗，"请前往登录"，有"取消"和"去登录"按钮 | 01-登录流程.md 或 03-申摊流程.md（未登录触发） |
|
||||
| `3_填写昵称_头像信息.png` | 登录表单，头像选择、昵称输入、用户协议勾选 | 01-登录流程.md 授权登录部分 |
|
||||
| `4_登录后授权手机号弹窗.png` | 手机号授权弹窗，显示微信绑定号码 | 01-登录流程.md 新增手机号授权部分 |
|
||||
| `5_我的界面_前往实名认证.png` | "我的"页面，有"前往实名认证"按钮和"预约详情"入口 | 02-实名认证.md 认证入口 |
|
||||
| `6_填写实名认证信息.png` | 实名认证表单，姓名和身份证号输入框 | 02-实名认证.md 认证信息填写 |
|
||||
|
||||
---
|
||||
|
||||
## Task 1: 更新 01-登录流程.md
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/01-登录流程.md`
|
||||
|
||||
- [ ] **Step 1: 调整登录流程文档结构**
|
||||
|
||||
根据截图内容，登录流程实际包含以下步骤：
|
||||
1. 打开小程序（待补充截图）
|
||||
2. 触发登录弹窗（对应图2）
|
||||
3. 填写昵称头像（对应图3）
|
||||
4. 手机号授权（对应图4）
|
||||
5. 完成登录显示"我的"页面（待补充截图）
|
||||
|
||||
更新文档内容：
|
||||
|
||||
```markdown
|
||||
# 登录流程
|
||||
|
||||
首次打开阿尼坊小程序时，系统会引导您完成微信登录。
|
||||
|
||||
## 步骤说明
|
||||
|
||||
### 1. 打开小程序
|
||||
|
||||
通过微信搜索"阿尼坊"或扫描二维码进入小程序。
|
||||
|
||||
> 📸 **截图**: 小程序首页界面（待补充）
|
||||
|
||||
### 2. 触发登录
|
||||
|
||||
当需要登录的功能（如申摊、预约）时，系统弹出登录提示。
|
||||
|
||||
|
||||
|
||||
点击「去登录」按钮进入登录流程。
|
||||
|
||||
### 3. 填写个人信息
|
||||
|
||||
登录表单包含以下内容：
|
||||
- **头像选择** - 点击头像区域选择或上传头像
|
||||
- **昵称填写** - 输入您的昵称（用于展示）
|
||||
- **用户协议** - 勾选同意用户协议
|
||||
|
||||
|
||||
|
||||
填写完成后点击「登录」按钮。
|
||||
|
||||
### 4. 手机号授权
|
||||
|
||||
系统申请获取您的微信绑定手机号：
|
||||
|
||||
|
||||
|
||||
点击「允许」按钮完成授权，手机号将用于：
|
||||
- 接收验证码
|
||||
- 订单通知
|
||||
- 客服联系
|
||||
|
||||
### 5. 完成登录
|
||||
|
||||
登录成功后：
|
||||
- 您的头像和昵称显示在「我的」页面
|
||||
- 系统自动生成唯一 UID（用户编号）
|
||||
|
||||
> 📸 **截图**: 「我的」页面展示用户信息（待补充）
|
||||
|
||||
## 重要提示
|
||||
|
||||
⚠️ **游客用户限制**
|
||||
未登录的游客用户仅可浏览：
|
||||
- 活动公告
|
||||
- 商铺卡片详情
|
||||
- 摊位卡片详情
|
||||
|
||||
需要登录后才能使用：
|
||||
- 设施预约
|
||||
- 摊位申请
|
||||
- 评论点赞
|
||||
- 收藏功能
|
||||
|
||||
## 下一步
|
||||
|
||||
完成登录后，请继续[实名认证](02-实名认证.md)以解锁完整功能。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Task 2: 更新 02-实名认证.md
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/02-实名认证.md`
|
||||
|
||||
- [ ] **Step 1: 更新实名认证文档截图引用**
|
||||
|
||||
现有截图覆盖：认证入口（图5）和认证表单（图6）。
|
||||
|
||||
更新文档内容：
|
||||
|
||||
```markdown
|
||||
# 实名认证
|
||||
|
||||
实名认证是使用设施预约和摊位申请功能的前置条件。
|
||||
|
||||
## 认证入口
|
||||
|
||||
进入「我的」页面，点击「前往实名认证」按钮。
|
||||
|
||||
|
||||
|
||||
> 💡 从截图可见，「我的」页面还包含「预约详情」入口，方便查看申请状态。
|
||||
|
||||
## 认证信息填写
|
||||
|
||||
### 必填内容
|
||||
|
||||
| 字段 | 说明 | 要求 |
|
||||
|------|------|------|
|
||||
| 真实姓名 | 与身份证一致 | 2-20个汉字 |
|
||||
| 身份证号码 | 18位身份证号 | 正确格式验证 |
|
||||
|
||||
### 填写表单
|
||||
|
||||
|
||||
|
||||
输入您的真实姓名和身份证号码，确保信息准确无误。
|
||||
|
||||
### 提交认证
|
||||
|
||||
填写完成后点击「提交」按钮，系统进行身份验证：
|
||||
- 验证身份证号与姓名是否匹配
|
||||
- 验证成功后显示「已实名」标签
|
||||
|
||||
> 📸 **截图**: 认证成功界面（待补充）
|
||||
|
||||
## 重要提示
|
||||
|
||||
⚠️ **认证后不可修改**
|
||||
实名认证完成后，姓名和身份证号不可更改。如需修改请联系客服。
|
||||
|
||||
⚠️ **信息准确性**
|
||||
请确保填写的信息与身份证一致，错误信息可能导致认证失败。
|
||||
|
||||
## 解锁功能
|
||||
|
||||
实名认证后可使用：
|
||||
- ✅ 设施预约（舞蹈室、练习室等）
|
||||
- ✅ 摊位申请（动漫市集参展）
|
||||
- ✅ 商铺卡片发布（商铺会员专属）
|
||||
|
||||
## 下一步
|
||||
|
||||
完成实名认证后，您可以：
|
||||
- [申请摊位](03-申摊流程.md) - 参加动漫市集
|
||||
- [预约设施](04-预约详情.md) - 使用场地设施
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Task 3: 更新 03-申摊流程.md
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/03-申摊流程.md`
|
||||
|
||||
- [ ] **Step 1: 更新申摊流程文档**
|
||||
|
||||
现有截图覆盖：申摊入口（图1）。图2可作为未登录时的提示示例。
|
||||
|
||||
更新文档内容：
|
||||
|
||||
```markdown
|
||||
# 申摊流程
|
||||
|
||||
本指南帮助您完成摊位申请，参加阿尼坊动漫市集。
|
||||
|
||||
## 前置条件
|
||||
|
||||
申请摊位前请确保：
|
||||
- ✅ 已完成微信登录
|
||||
- ✅ 已完成实名认证
|
||||
|
||||
> 💡 未登录用户点击「申摊」时，会弹出登录提示（见登录流程文档）
|
||||
|
||||
## 申请入口
|
||||
|
||||
进入「市集」页面，点击右上角「申摊」按钮。
|
||||
|
||||
|
||||
|
||||
> 💡 从截图可见，市集页面底部导航高亮「市集」，页面展示摊位卡片瀑布流。
|
||||
|
||||
## 未登录提示
|
||||
|
||||
如果您未登录，点击「申摊」后会弹出登录提示：
|
||||
|
||||
|
||||
|
||||
点击「去登录」按钮，完成登录后再继续申摊。
|
||||
|
||||
## 填写申请信息
|
||||
|
||||
### 必填内容
|
||||
|
||||
| 字段 | 限制 | 说明 |
|
||||
|------|------|------|
|
||||
| 标题 | 50字以内 | 卡片标题 |
|
||||
| 正文 | 500字以内 | 内容描述，可用 #标签 |
|
||||
| 图片 | 1张，≤5MB | 卡片封面图 |
|
||||
| 联系QQ | 可修改 | 客服联系渠道 |
|
||||
| 预约场次 | 下拉选择 | 日期+区域 |
|
||||
| 动漫IP标签 | 1-10个 | 必选至少1个 |
|
||||
|
||||
### 1. 填写标题和正文
|
||||
|
||||
输入吸引人的标题和详细的内容描述。
|
||||
|
||||
> 📸 **截图**: 申摊表单填写界面（待补充）
|
||||
|
||||
### 2. 上传图片
|
||||
|
||||
点击上传按钮，选择一张清晰图片作为卡片封面。
|
||||
|
||||
> 📸 **截图**: 图片上传界面（待补充）
|
||||
|
||||
### 3. 选择场次
|
||||
|
||||
从下拉菜单选择参展场次：
|
||||
- 显示日期、星期、场地区域
|
||||
- 同一天仅能申请一个区域
|
||||
|
||||
> 📸 **截图**: 场次选择下拉菜单（待补充）
|
||||
|
||||
### 4. 添加动漫IP标签
|
||||
|
||||
点击标签输入框：
|
||||
- 可搜索标签（如：名侦探柯南、EVA、龙珠）
|
||||
- 至少选择1个标签，最多10个
|
||||
|
||||
> 📸 **截图**: 标签搜索选择界面（待补充）
|
||||
|
||||
### 5. 查看须知弹窗
|
||||
|
||||
提交前需阅读申摊须知：
|
||||
- 勾选「已阅读」选项
|
||||
- 点击「确认提交」
|
||||
|
||||
> 📸 **截图**: 申摊须知弹窗（待补充）
|
||||
|
||||
## 申请结果
|
||||
|
||||
提交成功后显示注意事项弹窗，可通过「预约详情」查看进度。
|
||||
|
||||
> 📸 **截图**: 申请成功提示界面（待补充）
|
||||
|
||||
## 申请状态流转
|
||||
|
||||
| 状态 | 说明 |
|
||||
|------|------|
|
||||
| 待抽签 | 申请已提交，等待抽签 |
|
||||
| 审核中 | 抽签中签，等待审核 |
|
||||
| 待缴费 | 审核通过，等待支付 |
|
||||
| 未中签 | 抽签未中 |
|
||||
| 审核驳回 | 审核未通过（显示原因） |
|
||||
| 成功 | 已公布摊位号 |
|
||||
|
||||
## 重要提示
|
||||
|
||||
⚠️ **场次限制**
|
||||
- 每天仅能申请一个场次
|
||||
- 申请前请确认场次信息
|
||||
|
||||
⚠️ **存稿机制**
|
||||
- 系统自动保存上次填写内容
|
||||
- 30天后自动清理存稿
|
||||
|
||||
## 下一步
|
||||
|
||||
提交申请后，请前往[预约详情](04-预约详情.md)查看申请状态。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Task 4: 更新 04-预约详情.md
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/04-预约详情.md`
|
||||
|
||||
- [ ] **Step 1: 更新预约详情文档**
|
||||
|
||||
图5（我的界面）中可见「预约详情」入口，可作为入口截图引用。
|
||||
|
||||
更新文档内容：
|
||||
|
||||
```markdown
|
||||
# 预约详情
|
||||
|
||||
本页面展示您的摊位申请和设施预约记录。
|
||||
|
||||
## 入口位置
|
||||
|
||||
进入「我的」页面，点击「预约详情」入口。
|
||||
|
||||
|
||||
|
||||
> 💡 从截图可见，「预约详情」入口位于「我的」页面中。
|
||||
|
||||
## 页面结构
|
||||
|
||||
页面分为两个栏目：
|
||||
- **摊位栏目** - 摊位申请记录
|
||||
- **设施栏目** - 设施预约记录
|
||||
|
||||
> 📸 **截图**: 预约详情页面整体布局（待补充）
|
||||
|
||||
## 摊位申请状态
|
||||
|
||||
### 状态说明
|
||||
|
||||
| 状态 | 显示内容 | 操作 |
|
||||
|------|----------|------|
|
||||
| 待抽签 | 场次信息、备注 | 无 |
|
||||
| 待缴费 | 场次信息、订单号、金额、截止时间 | 「支付」「取消」按钮 |
|
||||
| 未中签 | 场次信息 | 无 |
|
||||
| 审核驳回 | 场次信息、驳回原因 | 无 |
|
||||
| 待公布 | 场次信息、订单号、备注、退款提示 | 「申请退款」按钮 |
|
||||
| 成功 | 场次信息、摊位号、订单号、备注 | 无 |
|
||||
| 已失效 | 场次信息、订单号、备注 | 无 |
|
||||
|
||||
### 摊位号格式
|
||||
|
||||
公布后的摊位号格式：`月.日 + 区域 + 编号`
|
||||
|
||||
示例：`2.1 A区13`
|
||||
|
||||
> 📸 **截图**: 成功状态显示摊位号（待补充）
|
||||
|
||||
## 设施预约状态
|
||||
|
||||
| 状态 | 显示内容 | 操作 |
|
||||
|------|----------|------|
|
||||
| 待缴费 | 设施名称、时间段、时长、金额、截止时间 | 「支付」「取消」按钮 |
|
||||
| 成功 | 设施名称、时间段、订单号、退款提示 | 「申请退款」按钮 |
|
||||
| 已失效 | 设施名称、时间段、订单号 | 无 |
|
||||
| 已退款 | 设施名称、时间段、订单号 | 无 |
|
||||
|
||||
> 📸 **截图**: 设施预约成功状态（待补充）
|
||||
|
||||
## 支付操作
|
||||
|
||||
### 待缴费状态
|
||||
|
||||
点击「支付」按钮：
|
||||
- 进入微信支付流程
|
||||
- 请在截止时间前完成支付
|
||||
- 超时将自动取消订单
|
||||
|
||||
> 📸 **截图**: 支付界面倒计时提示（待补充）
|
||||
|
||||
### 退款申请
|
||||
|
||||
符合退款条件时：
|
||||
- 点击「申请退款」按钮
|
||||
- 系统处理退款请求
|
||||
- 退款成功后状态变更为「已退款」
|
||||
|
||||
> 📸 **截图**: 退款申请界面（待补充）
|
||||
|
||||
## 重要提示
|
||||
|
||||
⚠️ **支付时限**
|
||||
请在截止时间前完成支付，超时订单自动取消。
|
||||
|
||||
⚠️ **退款截止时间**
|
||||
各场次有退款截止时间，请留意提示。
|
||||
|
||||
## 下一步
|
||||
|
||||
如有问题，请参考[问题反馈](05-问题反馈.md)联系客服。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Task 5: 更新 05-问题反馈.md
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/05-问题反馈.md`
|
||||
|
||||
- [ ] **Step 1: 更新问题反馈文档**
|
||||
|
||||
图5可作为UID位置参考，但无直接截图。文档保持现有结构，标注待补充截图。
|
||||
|
||||
```markdown
|
||||
# 问题反馈
|
||||
|
||||
遇到问题或Bug时，请通过以下方式联系客服。
|
||||
|
||||
## 获取您的 UID
|
||||
|
||||
UID（用户编号）是客服定位您账号的关键信息。
|
||||
|
||||
### 查看位置
|
||||
|
||||
进入「我的」页面，头像下方显示您的 UID。
|
||||
|
||||
> 📸 **截图**: 「我的」页面 UID 显示位置（参考图5，待补充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 定位账号。
|
||||
|
||||
⚠️ **详细描述**
|
||||
请尽量详细描述操作步骤，帮助技术团队复现问题。
|
||||
|
||||
⚠️ **截图证据**
|
||||
如有错误界面截图，请一并反馈，加速问题解决。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Task 6: 更新 HTML 演示文件
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/演示htlm_v1.html`
|
||||
|
||||
- [ ] **Step 1: 更新HTML文件中的截图引用**
|
||||
|
||||
将HTML中的截图占位符替换为实际图片引用：
|
||||
|
||||
1. 登录流程部分：
|
||||
- 添加图2（登录弹窗）
|
||||
- 添加图3（登录表单）
|
||||
- 添加图4（手机号授权）
|
||||
|
||||
2. 实名认证部分：
|
||||
- 添加图5（认证入口）
|
||||
- 添加图6（认证表单）
|
||||
|
||||
3. 申摊流程部分：
|
||||
- 添加图1（申摊入口）
|
||||
- 添加图2作为未登录提示示例
|
||||
|
||||
- [ ] **Step 2: 添加图片显示样式**
|
||||
|
||||
在CSS中添加实际图片显示样式（替换占位符样式）：
|
||||
|
||||
```css
|
||||
/* 实际截图样式 */
|
||||
.actual-img {
|
||||
width: 100%;
|
||||
max-width: 375px; /* 移动端宽度 */
|
||||
border-radius: 8px;
|
||||
margin: 1.5rem 0;
|
||||
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
|
||||
}
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 替换登录流程部分的占位符**
|
||||
|
||||
找到登录流程section（id="login"），替换截图占位符为实际图片：
|
||||
|
||||
```html
|
||||
<!-- 01 登录流程 -->
|
||||
<section id="login" class="section">
|
||||
<h1>登录流程</h1>
|
||||
<p>首次打开阿尼坊小程序时，系统会引导您完成微信登录。</p>
|
||||
|
||||
<h2>步骤说明</h2>
|
||||
<h3>1. 打开小程序</h3>
|
||||
<p>通过微信搜索"阿尼坊"或扫描二维码进入小程序。</p>
|
||||
<div class="img-placeholder">📸 截图: 小程序首页界面（待补充）</div>
|
||||
|
||||
<h3>2. 触发登录</h3>
|
||||
<p>当使用需要登录的功能时，系统弹出登录提示。</p>
|
||||
<img src="screenshots/2_前往登录弹窗.jpg" alt="登录提示弹窗" class="actual-img">
|
||||
|
||||
<h3>3. 填写个人信息</h3>
|
||||
<p>登录表单包含头像选择、昵称填写和用户协议勾选。</p>
|
||||
<img src="screenshots/3_填写昵称_头像信息.png" alt="登录表单" class="actual-img">
|
||||
|
||||
<h3>4. 手机号授权</h3>
|
||||
<p>系统申请获取微信绑定手机号，用于验证码接收和客服联系。</p>
|
||||
<img src="screenshots/4_登录后授权手机号弹窗.png" alt="手机号授权" class="actual-img">
|
||||
|
||||
<h3>5. 完成登录</h3>
|
||||
<p>登录成功后，头像和昵称显示在「我的」页面。</p>
|
||||
<div class="img-placeholder">📸 截图: 「我的」页面展示用户信息（待补充）</div>
|
||||
|
||||
<!-- ... 其余内容保持不变 -->
|
||||
</section>
|
||||
```
|
||||
|
||||
- [ ] **Step 4: 替换实名认证部分的占位符**
|
||||
|
||||
找到实名认证section（id="auth"），替换截图：
|
||||
|
||||
```html
|
||||
<!-- 02 实名认证 -->
|
||||
<section id="auth" class="section">
|
||||
<h1>实名认证</h1>
|
||||
<p>实名认证是使用设施预约和摊位申请功能的前置条件。</p>
|
||||
|
||||
<h2>认证入口</h2>
|
||||
<p>进入「我的」页面，点击「前往实名认证」按钮。</p>
|
||||
<img src="screenshots/5_我的界面_前往实名认证.png" alt="实名认证入口" class="actual-img">
|
||||
|
||||
<!-- ... 表格内容保持不变 -->
|
||||
|
||||
<h3>1. 填写姓名和身份证号</h3>
|
||||
<img src="screenshots/6_填写实名认证信息.png" alt="实名认证表单" class="actual-img">
|
||||
|
||||
<!-- ... 其余内容保持不变 -->
|
||||
</section>
|
||||
```
|
||||
|
||||
- [ ] **Step 5: 替换申摊流程部分的占位符**
|
||||
|
||||
找到申摊流程section（id="booth"），替换截图：
|
||||
|
||||
```html
|
||||
<!-- 03 申摊流程 -->
|
||||
<section id="booth" class="section">
|
||||
<h1>申摊流程</h1>
|
||||
<p>本指南帮助您完成摊位申请，参加阿尼坊动漫市集。</p>
|
||||
|
||||
<!-- ... 前置条件保持不变 -->
|
||||
|
||||
<h2>申请入口</h2>
|
||||
<p>进入「市集」页面，点击右上角「申摊」按钮。</p>
|
||||
<img src="screenshots/1_市集界面_右上角申摊.png" alt="申摊入口" class="actual-img">
|
||||
|
||||
<h2>未登录提示</h2>
|
||||
<p>未登录用户点击「申摊」会弹出登录提示：</p>
|
||||
<img src="screenshots/2_前往登录弹窗.jpg" alt="登录提示" class="actual-img">
|
||||
|
||||
<!-- ... 其余内容保持不变 -->
|
||||
</section>
|
||||
```
|
||||
|
||||
- [ ] **Step 6: 替换预约详情部分的入口截图**
|
||||
|
||||
```html
|
||||
<!-- 04 预约详情 -->
|
||||
<section id="reservation" class="section">
|
||||
<h1>预约详情</h1>
|
||||
<p>本页面展示您的摊位申请和设施预约记录。</p>
|
||||
|
||||
<h2>入口位置</h2>
|
||||
<p>进入「我的」页面，点击「预约详情」入口。</p>
|
||||
<img src="screenshots/5_我的界面_前往实名认证.png" alt="预约详情入口" class="actual-img">
|
||||
|
||||
<!-- ... 其余内容保持不变 -->
|
||||
</section>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Task 7: 更新 README.md
|
||||
|
||||
**Files:**
|
||||
- Modify: `user-guide/README.md`
|
||||
|
||||
- [ ] **Step 1: 更新README添加截图状态说明**
|
||||
|
||||
```markdown
|
||||
# 阿尼坊小程序用户指南
|
||||
|
||||
欢迎使用阿尼坊小程序！本指南将帮助您快速上手。
|
||||
|
||||
## 目录
|
||||
|
||||
1. [登录流程](01-登录流程.md) - 微信授权登录
|
||||
2. [实名认证](02-实名认证.md) - 完成身份验证
|
||||
3. [申摊流程](03-申摊流程.md) - 申请摊位参展
|
||||
4. [预约详情](04-预约详情.md) - 查看申请状态
|
||||
5. [问题反馈](05-问题反馈.md) - 获取帮助和反馈问题
|
||||
|
||||
## 截图状态
|
||||
|
||||
当前已集成以下截图：
|
||||
|
||||
| 文档 | 已有截图 | 待补充截图 |
|
||||
|------|----------|------------|
|
||||
| 登录流程 | 登录弹窗、登录表单、手机号授权 | 首页界面、"我的"页面 |
|
||||
| 实名认证 | 认证入口、认证表单 | 认证成功界面 |
|
||||
| 申摊流程 | 申摊入口、登录提示 | 表单填写、场次选择等 |
|
||||
| 预约详情 | 入口截图 | 详情页面、支付界面等 |
|
||||
| 问题反馈 | 无 | 全部截图 |
|
||||
|
||||
详见 [screenshots/README.md](screenshots/README.md) 了解完整截图清单。
|
||||
|
||||
## 快速开始
|
||||
|
||||
如果您是新用户，建议按顺序阅读以上文档。如有问题，请参考[问题反馈](05-问题反馈.md)联系客服。
|
||||
|
||||
## 演示页面
|
||||
|
||||
可打开 [演示htlm_v1.html](演示htlm_v1.html) 在浏览器中查看完整指南。
|
||||
|
||||
---
|
||||
阿尼坊团队
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 自检清单
|
||||
|
||||
完成以上任务后，请验证：
|
||||
|
||||
- [ ] 所有md文档中的截图引用路径正确（相对路径）
|
||||
- [ ] HTML文件中的图片src路径正确
|
||||
- [ ] 文档描述与截图内容一致
|
||||
- [ ] 待补充截图已明确标注
|
||||
- [ ] README.md已更新截图状态说明
|
||||
Reference in New Issue
Block a user