# douyin

**Repository Path**: NeoCharming/douyin

## Basic Information

- **Project Name**: douyin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-15
- **Last Updated**: 2025-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 抖音数据分析平台

专业的抖音数据分析系统，为选品和投流决策提供数据支持。

## 项目概述

本项目旨在构建一个全面的抖音数据分析平台，帮助电商从业者和内容创作者：

- **选品分析**：基于数据驱动的商品热度分析和趋势预测
- **投流优化**：广告投放策略优化和ROI预测
- **达人分析**：网红带货能力评估和合作建议
- **市场洞察**：行业趋势监控和竞品分析

## 技术栈

### 后端
- **FastAPI**: 高性能 API 框架
- **PostgreSQL**: 主数据库
- **Redis**: 缓存和会话管理
- **Celery**: 异步任务队列
- **SQLAlchemy**: ORM 数据映射
- **Alembic**: 数据库迁移工具

### 前端
- **Vue.js 3**: 渐进式前端框架
- **TypeScript**: 类型安全的JavaScript
- **Element Plus**: UI 组件库
- **Vue Router**: 路由管理
- **Pinia**: 状态管理
- **Vue-ECharts**: 数据可视化

### 数据处理
- **pandas**: 数据处理和分析
- **numpy**: 数值计算
- **scikit-learn**: 机器学习
- **requests**: HTTP 客户端
- **Beautiful Soup**: 网页解析

## 项目结构

```
douyin/
├── backend/                 # 后端服务
│   ├── src/                # 源代码
│   │   ├── main.py        # FastAPI 应用入口
│   │   ├── config.py      # 配置管理
│   │   ├── database/      # 数据库相关
│   │   ├── models/        # 数据模型
│   │   ├── routers/       # API 路由
│   │   ├── services/      # 业务逻辑
│   │   └── utils/         # 工具函数
│   ├── tests/             # 测试文件
│   ├── requirements.txt   # Python 依赖
│   └── alembic/           # 数据库迁移
├── frontend/              # 前端应用
│   ├── src/               # 源代码
│   │   ├── components/    # Vue 组件
│   │   ├── views/         # 页面组件
│   │   ├── stores/        # Pinia 状态
│   │   ├── router/        # 路由配置
│   │   └── api/           # API 客户端
│   ├── public/            # 静态资源
│   └── package.json       # Node.js 依赖
├── docs/                  # 文档
├── tests/                 # 集成测试
├── CLAUDE.md              # AI 助手指南
├── CODING_STANDARDS.md    # 代码规范
└── TODO.md                # 开发计划
```

## 快速开始

### 环境要求
- Python 3.9+
- Node.js 16+
- PostgreSQL 13+
- Redis 6+

### 后端设置
```bash
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\\Scripts\\activate
pip install -r requirements.txt
cp .env.example .env  # 配置环境变量
alembic upgrade head  # 运行数据库迁移
uvicorn src.main:app --reload --port 8000
```

### 前端设置
```bash
cd frontend
npm install
npm run dev
```

### 开发命令

#### 快速开始
```bash
# 安装依赖
make install

# 启动开发环境
make dev

# 查看所有可用命令
make help
```

#### 详细命令
```bash
# 开发环境
make dev                              # 启动完整开发环境（Docker）
make install                          # 安装所有依赖

# 代码质量
make lint                             # 运行代码质量检查
make test                             # 运行所有测试
make format                           # 格式化代码

# 构建和部署
make build                            # 构建生产版本
make deploy                           # 部署生产环境

# 数据库
make db-init                          # 初始化数据库
make db-migrate                       # 创建数据库迁移

# 工具
make clean                            # 清理构建文件
make check                            # 健康检查
make version                          # 显示版本信息
```

#### 手动启动（不使用Docker）
```bash
# 后端开发
cd backend
source venv/bin/activate
uvicorn src.main:app --reload --port 8000

# 前端开发
cd frontend
npm run dev
```

## 开发规范

本项目严格遵循《代码简洁之道》原则，详细规范请参考：
- [代码规范文档](CODING_STANDARDS.md)
- [开发计划](TODO.md)
- [AI助手指南](CLAUDE.md)

## 特性

### 核心功能
- 🔍 **智能选品**：基于多维度数据的商品热度分析
- 📊 **数据可视化**：直观的图表和仪表板
- 🤖 **自动化爬取**：稳定可靠的数据采集系统
- 🎯 **精准投放**：广告投放策略优化建议
- 👥 **达人分析**：网红带货能力全方位评估

### 技术特点
- 高性能异步架构
- 分布式任务处理
- 智能反爬虫机制
- 实时数据更新
- 响应式前端设计

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 贡献

欢迎提交 Issue 和 Pull Request！请确保：
1. 遵循项目代码规范
2. 添加必要的测试用例
3. 更新相关文档

## 联系我们

- 项目仓库：https://gitee.com/NeoCharming/douyin
- 问题反馈：提交 Issue
- 技术讨论：欢迎参与讨论