83 lines
2.6 KiB
Markdown
83 lines
2.6 KiB
Markdown
# 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 |