# 数据分析模块文档目录

> 本目录包含数据分析模块的所有相关文档。

## 📁 文档结构

```
pages/mall/analytics/docs/
├── README.md                      # 本文件（文档索引）
├── ANALYTICS_DB_DESIGN.md        # 数据库设计文档
├── ANALYTICS_DB_QUICK_START.md   # 数据库快速开始指南
├── ANALYTICS_PAGES_ANALYSIS.md   # 页面分析文档
├── ANALYTICS_UI_DESIGN.md        # UI 设计文档
└── IMPLEMENTATION_STATUS.md       # 实现状态文档
```

## 📚 文档说明

### 1. ANALYTICS_DB_DESIGN.md

**数据库设计文档** - 完整的数据表结构、字段说明、索引、RLS策略、RPC函数设计。

**内容包含：**
- 7个 Analytics 专用表的详细字段定义
- 索引建议
- RLS（Row Level Security）权限策略
- RPC 函数设计（实时KPI、趋势数据）
- 使用说明和前端调用示例

**适用场景：**
- 数据库架构设计
- 表结构参考
- 权限策略配置
- RPC 函数开发

### 2. ANALYTICS_DB_QUICK_START.md

**快速开始指南** - 数据库部署和使用的快速参考。

**内容包含：**
- 文件位置说明
- 快速部署步骤（3步）
- 创建的表列表
- RPC 函数使用说明
- 测试数据说明
- 前端使用示例
- 验证部署方法
- 问题排查

**适用场景：**
- 首次部署数据库
- 快速查找使用方法
- 问题排查参考

### 3. ANALYTICS_PAGES_ANALYSIS.md

**页面分析文档** - 数据分析模块所有页面的功能需求和分析。

**内容包含：**
- 已实现的页面清单
- 需要实现的页面清单
- 页面功能模块分析
- 统计指标需求
- 页面依赖关系
- 组件复用分析
- 数据接口需求

**适用场景：**
- 页面开发规划
- 功能需求参考
- 接口设计参考

### 4. ANALYTICS_UI_DESIGN.md

**UI 设计文档** - 数据分析页面的 UI 设计规范和实现说明。

**内容包含：**
- 页面访问 URL
- UI 设计规范
- 组件使用说明
- 响应式设计
- 交互设计

**适用场景：**
- UI 开发参考
- 组件使用指南
- 设计规范参考

### 5. IMPLEMENTATION_STATUS.md

**实现状态文档** - 记录各页面的实现进度和状态。

**内容包含：**
- 页面实现状态
- 功能完成度
- 待办事项
- 问题记录

**适用场景：**
- 项目进度跟踪
- 开发计划制定

## 🔗 相关资源

### SQL 脚本

所有 SQL 脚本位于：`pages/mall/analytics/test/`

- `ANALYTICS_DB_SCHEMA.sql` - 完整的表结构、索引、RLS、RPC
- `ANALYTICS_TEST_SEED.sql` - 完整的测试数据
- `01_create_tables.sql` - 分步：创建表结构
- `02_insert_test_data.sql` - 分步：插入测试数据
- `03_test_queries.sql` - 验证查询示例
- `04_cleanup.sql` - 清理测试数据

### 测试文档

测试相关文档位于：`pages/mall/analytics/test/`

- `README.md` - 测试数据说明和使用方法
- `SQL_USAGE_GUIDE.md` - SQL 脚本执行详细指南

### 项目文档

- `docs/ANALYTICS_PAGES_ANALYSIS.md` - 页面分析文档
- `docs/ANALYTICS_UI_DESIGN.md` - UI 设计文档
- `pages/mall/mall.md` - 项目需求文档（第2.6节：数据分析端，第10节：数据统计分析）

## 🚀 快速开始

1. **阅读设计文档**：`ANALYTICS_DB_DESIGN.md`
2. **执行部署**：参考 `ANALYTICS_DB_QUICK_START.md`
3. **插入测试数据**：使用 `pages/mall/analytics/test/` 中的 SQL 脚本

## 📝 文档更新记录

- **2026-01-23** - 创建文档目录和索引
- **2026-01-23** - 添加数据库设计文档和快速开始指南