文档: 更新 README,添加 Docker 部署说明和最新功能列表

This commit is contained in:
2026-01-10 19:02:41 +08:00
parent fd8f6f7a02
commit 3e58ab7255
+34 -40
View File
@@ -17,16 +17,15 @@
- **双视图模式** - 支持卡片视图和表格视图切换 - **双视图模式** - 支持卡片视图和表格视图切换
- **表格排序** - 点击表头实现数据排序(升序/降序/原始顺序) - **表格排序** - 点击表头实现数据排序(升序/降序/原始顺序)
### 🎨 用户界面 ### 🎨 用户界面 (New)
- **现代化设计** - 采用渐变色彩和卡片式布局 - **玻璃拟态设计** - 采用现代流行的 Glassmorphism 风格,视觉精致小巧。
- **响应式设计** - 完美适配桌面和移动设备 - **移动端深度优化** - 针对手机屏幕调整布局,商品信息单行显示,更紧凑易读。
- **专业图标** - 使用Font Awesome图标系统 - **流畅交互** - 添加数字滚动、展开/折叠等微交互动画。
- **加载优化** - 骨架屏和进度条提升用户体验
### 🔧 技术特性 ### 🔧 技术特性
- **高性能** - 基于Flask框架,快速响应 - **智能解析** - 支持“扁平表”和“层级表”两种格式,精准识别交易时间(精确到秒)。
- **安全性** - 文件上传安全验证和清理功能 - **高性能** - 基于 Pandas 向量化操作,快速处理大数据量。
- **可扩展** - 模块化设计,易于扩展新功能 - **Docker支持** - 提供完整的 Docker 容器化部署方案。
## 🚀 快速开始 ## 🚀 快速开始
@@ -104,44 +103,33 @@ pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:8000 app:app gunicorn -w 4 -b 0.0.0.0:8000 app:app
``` ```
#### 使用Docker部署 ### 使用 Docker Compose 部署 (推荐)
```dockerfile
FROM python:3.9-slim
WORKDIR /app 我们在项目中提供了 `docker-compose.yml`,这是最简单的部署方式。
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . . 1. **一键启动**
EXPOSE 5000 ```bash
docker-compose up -d
```
CMD ["python", "app.py"] 2. **访问应用**
``` 浏览器访问 `http://localhost:5000`
#### Nginx反向代理配置 3. **修改端口 (可选)**
```nginx ```bash
server { # Linux/Mac
listen 80; APP_PORT=8080 docker-compose up -d
server_name your-domain.com;
# Windows PowerShell
location / { $env:APP_PORT="8080"; docker-compose up -d
proxy_pass http://127.0.0.1:8000; ```
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
```
### 环境变量配置 ### 环境变量配置
```bash ```bash
# 设置Flask环境 # 设置Flask环境
export FLASK_ENV=production
export FLASK_DEBUG=False export FLASK_DEBUG=False
# 设置端口 (手动运行 python app.py 时生效,Docker使用映射端口)
# 设置上传文件大小限制(默认16MB) export PORT=5000
export MAX_CONTENT_LENGTH=16777216
``` ```
## 📁 项目结构 ## 📁 项目结构
@@ -150,10 +138,16 @@ export MAX_CONTENT_LENGTH=16777216
SaleShow/ SaleShow/
├── app.py # Flask应用主文件 ├── app.py # Flask应用主文件
├── requirements.txt # Python依赖包列表 ├── requirements.txt # Python依赖包列表
├── Dockerfile # Docker构建文件
├── docker-compose.yml # Docker Compose配置
├── static/ # 静态资源目录
│ ├── css/
│ │ └── style.css # 样式文件
│ └── js/
│ └── main.js # 交互逻辑
├── templates/ ├── templates/
│ └── index.html # 前端HTML模板 │ └── index.html # 前端HTML模板
├── uploads/ # 上传文件存储目录(自动创建 ├── uploads/ # 上传文件存储目录(持久化挂载
├── __pycache__/ # Python缓存文件
└── README.md # 项目说明文档 └── README.md # 项目说明文档
``` ```
@@ -202,6 +196,6 @@ SaleShow/
--- ---
**最后更新时间:** 2026年1月3 **最后更新时间:** 2026年1月10
*享受数据分析的乐趣!📊✨* *享受数据分析的乐趣!📊✨*