统计分析开发文档

1. 文档概述

1.1 文档目的

本文档旨在详细说明CRMEB系统中统计分析模块的设计架构、核心功能、代码实现及开发规范，为系统开发人员提供完整的开发参考。

1.2 适用范围

本文档适用于CRMEB系统开发人员、维护人员及二次开发人员，用于指导统计分析模块的开发、扩展和维护工作。

1.3 术语定义

术语	解释
PV	页面访问量（Page View），即页面浏览次数
UV	独立访客数（Unique Visitor），即不同IP地址访问网站的用户数
转化率	转化次数与访问次数的比率，如注册转化率、下单转化率
复购率	重复购买用户数与总购买用户数的比率
环比	本期统计数据与上期统计数据的比较
同比	本期统计数据与上年同期统计数据的比较
资金流水	系统中所有资金的流入流出记录

2. 核心功能模块

2.1 流量统计

PV/UV统计：统计网站的页面访问量和独立访客数
访问趋势分析：支持按小时、日、周、月维度查看访问趋势
访问来源分析：分析用户的访问来源渠道
页面热度分析：统计各个页面的访问热度
访问设备分析：分析用户使用的设备类型（PC、移动端、平板等）

2.2 用户统计

用户基础信息统计：新增用户数、成交用户数、充值用户数、付费用户数
用户增长趋势：按时间维度查看用户增长情况
用户地域分布：统计用户的地域分布（按省份、城市）
用户性别分布：统计用户的性别分布
用户年龄分布：统计用户的年龄分布
微信用户分析：微信用户关注/取关统计
用户行为分析：用户浏览、搜索、购买等行为分析

2.3 销售统计

订单金额统计：统计订单总金额、实付金额、退款金额等
订单数量统计：统计订单总数、成交订单数、退款订单数等
订单趋势分析：按时间维度查看订单趋势
订单来源分析：分析订单的来源渠道
订单类型分布：统计不同类型订单的分布情况
实时交易数据：实时展示交易数据
支付方式分析：分析不同支付方式的使用情况

2.4 资金统计

资金流水统计：统计系统中的资金流入流出记录
账单记录：生成日/周/月账单
余额统计：统计用户余额情况
余额趋势分析：按时间维度查看余额趋势
余额来源分析：分析余额的来源渠道
余额类型分析：分析不同类型余额的分布

2.5 商品统计

商品销售基础数据：商品销售额、销量、访客数、转化率等
商品销售趋势：按时间维度查看商品销售趋势
商品排行：商品销售额排行、销量排行、访客数排行等
商品分类统计：按商品分类统计销售情况
商品属性分析：分析商品不同属性的销售情况

3. 代码结构与设计

3.1 架构设计

系统采用分层架构设计，严格遵循MVC设计模式：

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│    Controllers  │     │    Services     │     │     Daos        │
└─────────────────┘     └─────────────────┘     └─────────────────┘
         │                       │                       │
         └───────────────────────┼───────────────────────┘
                                 │
                         ┌─────────────────┐
                         │    Models       │
                         └─────────────────┘
                                 │
                         ┌─────────────────┐
                         │   数据库          │
                         └─────────────────┘

3.2 核心文件结构

3.2.1 控制器层（Controller）

统计分析控制器：/crmeb/app/adminapi/controller/v1/statistic/

FlowStatistic.php - 资金流水统计控制器
UserStatistic.php - 用户统计控制器
OrderStatistic.php - 订单统计控制器
TradeStatistic.php - 交易统计控制器
ProductStatistic.php - 商品统计控制器
BalanceStatistic.php - 余额统计控制器

3.2.2 服务层（Services）

统计分析服务：/crmeb/app/services/statistic/

CapitalFlowServices.php - 资金流水统计服务
UserStatisticServices.php - 用户统计服务
OrderStatisticServices.php - 订单统计服务
TradeStatisticServices.php - 交易统计服务
ProductStatisticServices.php - 商品统计服务
BalanceStatisticServices.php - 余额统计服务

3.2.3 数据访问层（Dao）

统计分析Dao：与各个业务模块的Dao共用，如用户Dao、订单Dao、商品Dao等

3.2.4 模型层（Model）

统计分析模型：与各个业务模块的模型共用，如用户模型、订单模型、商品模型等

4. 数据库设计

4.1 资金流水表（capital_flow）

字段名	数据类型	描述
id	int(10) unsigned	流水ID
uid	int(10)	用户ID
link_id	int(10)	关联ID（如订单ID、充值ID等）
type	varchar(20)	交易类型（pay-支付订单，refund-退款，recharge-充值，extract-提现等）
money	decimal(10,2)	交易金额
pm	tinyint(1)	收支方向（1-收入，0-支出）
balance	decimal(10,2)	交易后余额
mark	varchar(255)	备注
add_time	int(10)	添加时间

4.2 访问记录表（visit_log）

字段名	数据类型	描述
id	int(10) unsigned	记录ID
uid	int(10)	用户ID（0-游客）
ip	varchar(15)	访问IP
url	varchar(255)	访问URL
referer	varchar(255)	来源URL
user_agent	text	用户代理信息
device	varchar(20)	设备类型（pc, mobile, tablet）
browser	varchar(20)	浏览器
os	varchar(20)	操作系统
add_time	int(10)	访问时间

4.3 销售统计表（sale_statistics）

字段名	数据类型	描述
id	int(10) unsigned	统计ID
date	date	统计日期
order_count	int(10)	订单数量
order_amount	decimal(10,2)	订单总金额
pay_amount	decimal(10,2)	实付金额
refund_count	int(10)	退款订单数量
refund_amount	decimal(10,2)	退款金额
user_count	int(10)	成交用户数
add_time	int(10)	添加时间

5. API接口说明

5.1 流量统计接口

5.1.1 获取PV/UV统计

请求URL：/adminapi/v1/statistic/flow/pvuv
请求方法：GET
权限要求：statistic/flow/pvuv
请求参数：
- type：时间维度（hour, day, week, month）
- start_time：开始时间
- end_time：结束时间
返回结果：PV/UV统计数据

5.1.2 获取访问来源分析

请求URL：/adminapi/v1/statistic/flow/source
请求方法：GET
权限要求：statistic/flow/source
请求参数：
- start_time：开始时间
- end_time：结束时间
返回结果：访问来源分析数据

5.2 用户统计接口

5.2.1 获取用户基础统计

请求URL：/adminapi/v1/statistic/user/basic
请求方法：GET
权限要求：statistic/user/basic
请求参数：
- start_time：开始时间
- end_time：结束时间
返回结果：用户基础统计数据

5.2.2 获取用户增长趋势

请求URL：/adminapi/v1/statistic/user/trend
请求方法：GET
权限要求：statistic/user/trend
请求参数：
- type：时间维度（hour, day, week, month）
- start_time：开始时间
- end_time：结束时间
返回结果：用户增长趋势数据

5.2.3 获取用户地域分布

请求URL：/adminapi/v1/statistic/user/region
请求方法：GET
权限要求：statistic/user/region
请求参数：
- start_time：开始时间
- end_time：结束时间
返回结果：用户地域分布数据

5.3 销售统计接口

5.3.1 获取订单统计

请求URL：/adminapi/v1/statistic/order/basic
请求方法：GET
权限要求：statistic/order/basic
请求参数：
- start_time：开始时间
- end_time：结束时间
返回结果：订单统计数据

5.3.2 获取订单趋势

请求URL：/adminapi/v1/statistic/order/trend
请求方法：GET
权限要求：statistic/order/trend
请求参数：
- type：时间维度（hour, day, week, month）
- start_time：开始时间
- end_time：结束时间
返回结果：订单趋势数据

5.4 资金统计接口

5.4.1 获取资金流水列表

请求URL：/adminapi/v1/statistic/flow/list
请求方法：GET
权限要求：statistic/flow/list
请求参数：
- page：页码
- limit：每页数量
- type：交易类型
- start_time：开始时间
- end_time：结束时间
返回结果：资金流水列表数据

5.4.2 获取账单记录

请求URL：/adminapi/v1/statistic/flow/bill
请求方法：GET
权限要求：statistic/flow/bill
请求参数：
- type：账单类型（day, week, month）
- date：统计日期
返回结果：账单记录数据

5.5 商品统计接口

5.5.1 获取商品销售基础数据

请求URL：/adminapi/v1/statistic/product/basic
请求方法：GET
权限要求：statistic/product/basic
请求参数：
- product_id：商品ID
- start_time：开始时间
- end_time：结束时间
返回结果：商品销售基础数据

5.5.2 获取商品销售排行

请求URL：/adminapi/v1/statistic/product/rank
请求方法：GET
权限要求：statistic/product/rank
请求参数：
- type：排行类型（sales, amount, visitor）
- start_time：开始时间
- end_time：结束时间
- limit：返回数量
返回结果：商品销售排行数据

5. 开发规范与流程

5.1 代码规范

命名规范：
- 类名采用大驼峰命名法，如 UserStatisticServices
- 方法名采用小驼峰命名法，如 getUserBasicInfo
- 变量名采用小驼峰命名法，如 visitorCount
- 常量名采用全大写，下划线分隔，如 STATISTIC_TYPE_HOUR
代码结构：
- 严格遵循分层架构，禁止跨层调用
- 每个方法职责单一，代码行数控制在50行以内
- 适当添加注释，说明方法功能、参数含义和返回值
- 所有统计数据必须包含完整的时间范围
性能优化：
- 统计查询必须使用索引，避免全表扫描
- 复杂统计查询必须使用缓存，减少数据库压力
- 统计数据必须定期汇总，避免实时计算大量数据
- 使用合适的统计周期，如小时、日、周、月

5.2 开发流程

需求分析：明确统计分析的功能需求和业务逻辑
设计阶段：设计数据结构、API接口和业务流程
编码实现：
- 实现统计服务层逻辑
- 实现统计控制器接口
- 实现数据汇总和缓存机制
单元测试：编写单元测试，确保统计结果正确性
性能测试：对统计查询进行性能测试，优化查询效率
代码审查：提交代码审查，确保代码质量
部署上线：部署到生产环境

6. 常见问题与解决方案

6.1 统计数据不准确

问题：统计数据与实际数据不符 解决方案：

检查统计逻辑，确保统计范围正确
检查数据来源，确保数据完整
检查时间范围，确保时间格式正确
检查统计周期，确保周期划分正确
实现数据校验机制，定期核对统计数据

6.2 统计查询性能问题

问题：统计查询耗时过长，影响系统性能 解决方案：

使用索引优化查询
实现统计数据缓存
定期预计算统计数据
优化数据库结构，如分表、分区
使用数据仓库或OLAP数据库处理复杂统计

6.3 统计维度不足

问题：无法满足多维度统计需求 解决方案：

设计灵活的统计架构，支持自定义统计维度
实现统计维度扩展机制
使用数据立方体技术，支持多维数据分析

6.4 实时统计问题

问题：实时统计数据延迟或不准确 解决方案：

使用流处理技术，如Kafka、Flink等
实现准实时统计，平衡实时性和准确性
优化实时数据处理流程，减少延迟

7. 扩展与定制

7.1 添加新的统计维度

设计统计逻辑：确定新统计维度的计算逻辑
修改服务层：在相应的统计服务中添加新的统计方法
添加API接口：在相应的控制器中添加新的API接口
前端修改：在前端页面中添加新的统计图表和展示

7.2 实现自定义统计报表

设计报表结构：确定报表的字段、维度和指标
实现报表生成逻辑：在统计服务中添加报表生成方法
添加报表管理功能：实现报表的创建、编辑、删除功能
前端修改：在前端页面中添加报表展示和导出功能

7.3 集成第三方统计工具

设计集成方案：确定与第三方统计工具的集成方式
实现数据同步：实现与第三方统计工具的数据同步
添加API接口：添加获取第三方统计数据的API接口
前端修改：在前端页面中集成第三方统计图表

8. 文档更新记录

版本	更新日期	更新内容	更新人
1.0	2026-01-19	初始版本，包含流量统计、用户统计、销售统计、资金统计、商品统计等核心功能	AI Assistant

9. 附录

9.1 核心类关系图

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│    Controllers  │     │    Services     │     │     Daos        │
└─────────────────┘     └─────────────────┘     └─────────────────┘
         │                       │                       │
         └───────────────────────┼───────────────────────┘
                                 │
                         ┌─────────────────┐
                         │    Models       │
                         └─────────────────┘
                                 │
                         ┌─────────────────┐
                         │   数据库          │
                         └─────────────────┘

9.2 统计流程示意图

统计流程：
1. 系统收集原始数据（访问日志、订单数据、用户数据等）
2. 定期汇总原始数据，生成统计数据
3. 将统计数据存储到统计表中
4. 提供API接口，供前端查询统计数据
5. 前端展示统计图表和数据
6. 支持统计数据导出

9.3 支持的统计维度

维度名称	描述
时间维度	小时、日、周、月、年
地域维度	省份、城市
设备维度	PC、移动端、平板
渠道维度	微信、支付宝、APP、小程序等
商品维度	商品分类、商品属性、品牌等
用户维度	性别、年龄、会员等级等
订单维度	订单类型、支付方式、配送方式等

9.4 统计指标列表

指标名称	描述
PV	页面访问量
UV	独立访客数
新增用户数	新增注册用户数
成交用户数	完成交易的用户数
复购率	重复购买用户数与总购买用户数的比率
转化率	转化次数与访问次数的比率
订单总金额	订单的总金额
实付金额	实际支付的金额
订单数量	订单总数
客单价	平均每笔订单的金额
商品销售额	商品的销售总额
商品销量	商品的销售数量
资金流入	系统中的资金流入总额
资金流出	系统中的资金流出总额

提示：该文档由AI生成，仅供参考。

统计分析开发文档.md 17 KB History Raw