knowledge-base/CLAUDE.md

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