# DataOps Platform 发布包清单

> 版本以打包日期为准，开发侧执行 `sync_release.sh` + `package_release.sh` 生成。

## 核心文件

| 文件 | 说明 |
|------|------|
| `deploy_dataops.sh` | **一键部署入口**，复制代码、建 venv、配置 Supervisor |
| `dataops.env` | 生产环境变量模板 → `/etc/dataops-platform/dataops.env` |
| `.env.production.example` | 环境变量说明副本 |
| `requirements.txt` | Python 依赖（pip install -r） |
| `wsgi.py` | Gunicorn WSGI 入口 |
| `gunicorn_config.py` | Gunicorn 配置（post_worker_init 初始化日志） |
| `__init__.py` | 包入口（可选） |

## 应用代码

| 目录 | 说明 |
|------|------|
| `app/` | Flask 应用完整源码 |
| `app/config/config.py` | 主配置（含生产默认连接、MinIO/LLM 回退） |
| `app/core/llm/deepseek_client.py` | DeepSeek SDK 封装（base_url 规范化） |
| `app/core/llm/llm_service.py` | LLM 翻译/SQL 生成 |
| `app/core/llm/ddl_parser.py` | DDL 解析（HTTP `/v1/chat/completions`） |
| `app/api/` | 全部 API 路由 |
| `database/` | PostgreSQL SQL 脚本 |

## 运维脚本

| 脚本 | 说明 |
|------|------|
| `scripts/dataops-common.sh` | 公共配置、健康检查、Supervisor 配置 |
| `scripts/run_dataops.sh` | Supervisor 调用，加载 env 启动 Gunicorn |
| `scripts/start_dataops.sh` | 启动服务 |
| `scripts/stop_dataops.sh` | 停止服务 |
| `scripts/restart_dataops.sh` | 重启服务 |
| `scripts/deploy_dataops.sh` | 已安装环境下的增量部署（可选） |

## 配置模板

| 文件 | 说明 |
|------|------|
| `config/nginx-dataops-platform.conf` | Nginx 反向代理（SSL、ddlparse 超时） |
| `config/supervisor-dataops-platform.conf` | Supervisor 参考配置（deploy 脚本会自动生成） |

## 开发/打包工具

| 脚本 | 说明 |
|------|------|
| `sync_release.sh` | 从仓库根目录同步最新代码到 deployment/ |
| `package_release.sh` | 打包 `dist/dataops-platform-release-YYYYMMDD.tar.gz` |

## 文档

| 文件 | 说明 |
|------|------|
| `README.md` | 快速开始 |
| `DEPLOYMENT_GUIDE.md` | 完整部署手册 |
| `CHECKLIST.md` | 部署检查清单 |
| `MANIFEST.md` | 本文件 |

## 部署目标路径

| 源 | 目标 |
|----|------|
| `app/` | `/opt/dataops-platform/app/` |
| `database/` | `/opt/dataops-platform/database/` |
| `scripts/` | `/opt/dataops-platform/scripts/` |
| `requirements.txt` 等 | `/opt/dataops-platform/` |
| `dataops.env` | `/etc/dataops-platform/dataops.env` |

## 近期重要变更（2026-05）

- DeepSeek：`LLM_BASE_URL=https://api.deepseek.com`，模型默认 `deepseek-v4-pro`
- `ddl_parser` 修正 API 路径为 `/v1/chat/completions`
- MinIO 配置整组加载，避免 host/密钥混搭
- 翻译接口修复空结果回退逻辑
- 运维脚本统一 LF，env 权限 640 root:ubuntu
- Gunicorn 日志绝对路径 `LOG_FILE`