docs: 添加项目配置和开发计划文档

- 新增 CLAUDE.md 项目配置文件 - 新增 superpowers 开发计划文档
2026-04-20 00:00:53 +08:00
parent 00ca908209
commit 2cc6d646e1
4 changed files with 1753 additions and 0 deletions
@@ -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位数字）
+- 摊位号格式统一：`月.日 + 区域 + 编号`
+- 状态名称与需求文档一致