# shop-analysis

**Repository Path**: ylc3000/shop-analysis

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-29
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TK 电商数据分析平台

跨境电商多平台数据分析系统，支持 TikTok、Shopee、Lazada 三大平台的订单、广告、达人佣金、流量等数据的统一管理和利润分析。

## 技术栈

### 后端
- **框架**: FastAPI
- **数据库**: SQLite (aiosqlite)
- **数据处理**: Pandas
- **认证**: JWT (python-jose)

### 前端
- **框架**: React 18 + TypeScript
- **构建**: Vite
- **路由**: React Router
- **HTTP**: Axios
- **样式**: CSS

## 项目结构

```
app/
├── backend/                 # 后端服务
│   ├── api/                # API 路由
│   │   ├── auth.py        # 认证接口
│   │   ├── upload.py      # 文件上传
│   │   ├── process.py     # 数据处理
│   │   ├── analysis.py    # 利润分析
│   │   ├── report.py      # 报表接口
│   │   ├── shops.py       # 店铺管理
│   │   ├── skus.py        # SKU管理
│   │   └── ...
│   ├── services/          # 业务服务
│   │   ├── data_loader.py # 数据加载
│   │   ├── dwd_processor.py # DWD层处理
│   │   ├── dws_processor.py # DWS层处理
│   │   └── ...
│   ├── data/              # 数据库文件
│   ├── uploads/           # 上传文件
│   ├── config.py          # 配置
│   ├── database.py        # 数据库连接
│   ├── main.py            # 入口
│   └── requirements.txt   # 依赖
│
├── frontend/              # 前端应用
│   ├── src/
│   │   ├── pages/        # 页面组件
│   │   ├── components/   # 公共组件
│   │   ├── context/      # 上下文
│   │   ├── api/          # API 客户端
│   │   ├── App.tsx       # 根组件
│   │   └── main.tsx      # 入口
│   ├── package.json
│   └── vite.config.ts
│
└── HANDOVER.md            # 交接文档
```

## 数据分层架构

```
ODS (原始层)     →  DWD (明细层)    →  DWS (汇总层)    →  ADS (应用层)
├── 订单数据         ├── 数据清洗         ├── 店铺+SKU+日      ├── 店铺日报
├── 达人佣金         ├── 字段映射         ├── 费用分摊         └── 利润计算
├── 广告数据         └── 剔除取消单
└── 流量数据
```

## 快速开始

### 后端

```bash
cd backend

# 创建虚拟环境
python -m venv venv
venv\Scripts\activate  # Windows
# source venv/bin/activate  # Linux/Mac

# 安装依赖
pip install -r requirements.txt

# 初始化数据库
python init_app.py

# 启动服务
uvicorn main:app --reload --port 8000
```

### 前端

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

## 默认账号

- 用户名: `admin`
- 密码: `admin123`

## API 文档

启动后端后访问: http://localhost:8000/docs

## 主要功能

### 数据中心
- 支持 Excel/CSV 文件上传
- 支持文件夹批量上传
- 自动识别平台和国家
- 数据处理流水线

### 仪表盘
- 销售额/订单量/利润 KPI
- 成本结构分析
- 店铺排行榜
- 趋势图表

### 店铺管理
- 店铺信息维护
- 批量导入导出

### SKU 管理
- SKU 成本维护
- 分类管理

## 支持的数据类型

| 类型 | 平台 | 说明 |
|------|------|------|
| 订单数据 | TK/Shopee/Lazada | 订单明细 |
| 达人佣金 | TK/Shopee | 达人带货佣金 |
| 广告数据 | TK/Shopee | 广告投放费用 |
| 流量数据 | TK | 商品流量数据 |

## License

Private - All Rights Reserved