# 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