DataOps Platform 发布包清单

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

第一阶段 Compose 离线包由 compose/package_offline.sh 生成；本清单前半部分的 Supervisor 文件继续作为既有单机兼容交付。

核心文件

文件	说明
`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`	已安装环境下的增量部署（可选）
`scripts/edge_gateway_admin.py`	P3-WP04 边缘本地 init/CSR/注册材料/轮换/撤销状态/签名发布/回滚工具；私钥不出边缘

文件	说明
`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`
`compose/package_offline.sh`	生成含默认镜像、版本清单和 SHA-256 的 Compose 离线包
`compose/product_engineering.py`	环境、就绪、晋级、迁移、版本清单和 SBOM 控制面
`compose/reproducible_archive.py`	生成规范时间戳、属主、权限和顺序的可复现归档

文件	说明
`compose/preflight.sh`	校验包、Compose、镜像和 Alembic current/head
`compose/install_offline.sh`	先验签、载入镜像、`--no-build` 启动和健康检查
`compose/backup.sh`	PostgreSQL 逻辑导出、维护窗口和全部托管卷冷快照
`compose/restore.sh`	精确目标确认、同名拒绝、先验签和新项目恢复
`compose/rollback.sh`	使用上一版离线包和升级前备份恢复候选项目
`compose/.env.rehearsal.example`	隔离恢复演练的端口和网络模板
`environments/`	开发、测试和预生产隔离配置及差异检查输入
`compose/README.md`	离线交付、备份、恢复、回滚和企业门禁
`edge/`	P3-WP04 pull-only 边缘 Compose、无秘密 env 示例和工程部署契约
`edge/Dockerfile.edge`	P3-WP04 可运行的 pull-only Edge 镜像入口，无入站监听
`edge/edge.config.schema.json`	Edge 运行文件的闭合 JSON Schema；credential/signing keys/CRL 由只读文件注入

文件	说明
`README.md`	快速开始
`DEPLOYMENT_GUIDE.md`	完整部署手册
`CHECKLIST.md`	部署检查清单
`MANIFEST.md`	本文件
`docs/runbooks/EDGE_GATEWAY_OPERATIONS.md`	P3-WP04 安装、CSR、注册、轮换、撤销、升级、verified bundle 回滚与恢复步骤
`docs/phase3/P3_WP04_EDGE_GATEWAY.md`	P3-WP04 架构、数据边界和企业 UAT 边界
`docs/validation/P3_WP04_EDGE_GATEWAY_EVIDENCE.md`	P3-WP04 本地定向验证证据与剩余门禁
`docs/validation/P3_WP04_FAILURE_INJECTION.json`	机器可读故障注入台账；企业项保持 `TBD_EXTERNAL`
`docs/architecture/OPENAPI.yaml`	完整 API 合同，含 Edge human bearer 与 machine mTLS 组合
`SHA256SUMS`	发布归档内全部文件的 SHA-256 闭包（打包时生成）

源	目标
`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`

发布副本与 app/、database/、migrations/ 完整同步并建立一致性测试
默认应用镜像使用稳定离线标签，全部对外端口支持恢复项目隔离覆盖
Compose 离线包包含默认 profile 镜像、版本清单和全文件 SHA-256
备份恢复默认失败关闭、禁止同项目原位恢复、禁止数据库 downgrade
开发/测试/预生产隔离配置、六类就绪监控、受控晋级和客户迁移 dry-run
固定构建时间的可复现离线归档，以及 OpenAPI、SBOM、迁移和源码互相追溯
P3-WP04 发布包包含与源码精确一致的边缘 admin/status 工具、可运行 pull-only Edge 镜像、闭合配置 schema、完整 OpenAPI、Failure Injection、运行手册、架构边界和验证证据；包内 SHA256SUMS 覆盖全部文件且打包前执行秘密形态扫描；工具与 Compose 统一 runtime UID/GID 和 secrets/client.key 路径，企业来源、网络和安全法务 UAT 仍为外部门禁