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

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