在前后端开发联调前 的提交20260223

.env

@@ -14,28 +14,95 @@ DB_USER=local-Python
 DB_PASSWORD=Neo-local-1991125
 
 # ------------------------------------------------------------------------------
-# 数据库名称（开发/测试环境使用测试库，生产环境切换为 etl_feiqiu / zqyy_app）
+# 数据库名称
 # CHANGE 2026-02-15 | 默认指向测试库，避免开发时误操作生产数据
+# CHANGE 2026-02-19 | 移除 PG_NAME（未被代码引用，仅 .env.template 分离式配置预留）
+#
+# 数据库清单：
+#   etl_feiqiu      — ETL 流程（飞球连接器），正式环境
+#   test_etl_feiqiu — ETL 流程（飞球连接器），开发/测试环境
+#   zqyy_app        — 小程序业务库，正式环境
+#   test_zqyy_app   — 小程序业务库，开发/测试环境
 # ------------------------------------------------------------------------------
-PG_NAME=test_etl_feiqiu
 APP_DB_NAME=test_zqyy_app
 ETL_DB_NAME=test_etl_feiqiu
 
 # ------------------------------------------------------------------------------
-# 组合式 DSN（analyze_dataflow.py / 后端等需要完整连接串的场景使用）
+# 组合式 DSN（各子系统 / 脚本需要完整连接串时使用）
 # 格式：postgresql://user:password@host:port/dbname
 # CHANGE 2026-02-16 | 新增，供 dataflow_analyzer 等跨模块脚本直接读取
+# CHANGE 2026-02-19 | 多库 DSN：PG_DSN（ETL 库，向后兼容）+ APP_DB_DSN（业务库）
 # ------------------------------------------------------------------------------
 PG_DSN=postgresql://local-Python:Neo-local-1991125@100.64.0.4:5432/test_etl_feiqiu
+APP_DB_DSN=postgresql://local-Python:Neo-local-1991125@100.64.0.4:5432/test_zqyy_app
 
-# ------------------------------------------------------------------------------
-# 数据流结构分析输出目录（analyze_dataflow.py 使用）
-# 缺省时回退到 docs/reports/
-# ------------------------------------------------------------------------------
-SYSTEM_ANALYZE_ROOT=C:/NeoZQYY/export/dataflow_analysis
+# CHANGE 2026-02-21 | 显式定义测试库 DSN，运维脚本/集成测试优先使用
+TEST_DB_DSN=postgresql://local-Python:Neo-local-1991125@100.64.0.4:5432/test_etl_feiqiu
+TEST_APP_DB_DSN=postgresql://local-Python:Neo-local-1991125@100.64.0.4:5432/test_zqyy_app
 
 # ------------------------------------------------------------------------------
 # 通用
 # ------------------------------------------------------------------------------
 TIMEZONE=Asia/Shanghai
 LOG_LEVEL=INFO
+
+# ==============================================================================
+# 统一输出路径配置（export/ 目录）
+# ==============================================================================
+# CHANGE 2026-02-19 | 统一规划 export 目录结构，所有输出路径集中管理
+#
+# 目录总览：
+#   export/
+#   ├── ETL-Connectors/feiqiu/
+#   │   ├── JSON/          — API 原始 JSON 导出（ODS 抓取落盘）
+#   │   ├── LOGS/          — ETL 运行日志（每次 run 一个 .log）
+#   │   └── REPORTS/       — ETL 质检/完整性报告（JSON 格式）
+#   ├── SYSTEM/
+#   │   ├── LOGS/          — 系统级运维日志
+#   │   ├── REPORTS/
+#   │   │   ├── dataflow_analysis/  — 数据流结构分析报告（Markdown）
+#   │   │   ├── field_audit/        — 字段排查报告
+#   │   │   └── full_dataflow_doc/  — 全链路数据流文档
+#   │   └── CACHE/
+#   │       └── api_samples/        — API 样本缓存（gen_full_dataflow_doc 使用）
+#   └── BACKEND/
+#       └── LOGS/          — 后端结构化日志（预留）
+
+# ------------------------------------------------------------------------------
+# ETL Connector（飞球）输出路径
+# ------------------------------------------------------------------------------
+# JSON 导出根目录（ODS 抓取落盘，按 TASK_CODE/run_id 自动建子目录）
+EXPORT_ROOT=C:/NeoZQYY/export/ETL-Connectors/feiqiu/JSON
+# ETL 运行日志根目录
+LOG_ROOT=C:/NeoZQYY/export/ETL-Connectors/feiqiu/LOGS
+# 在线抓取 JSON 输出根目录（FETCH_ONLY 模式使用）
+FETCH_ROOT=C:/NeoZQYY/export/ETL-Connectors/feiqiu/JSON
+# ETL 质检/完整性报告输出目录
+ETL_REPORT_ROOT=C:/NeoZQYY/export/ETL-Connectors/feiqiu/REPORTS
+
+# ------------------------------------------------------------------------------
+# 系统级输出路径
+# ------------------------------------------------------------------------------
+# 数据流结构分析报告输出目录（gen_dataflow_report.py / analyze_dataflow.py）
+SYSTEM_ANALYZE_ROOT=C:/NeoZQYY/export/SYSTEM/REPORTS/dataflow_analysis
+# 字段排查报告输出目录（field_audit.py）
+FIELD_AUDIT_ROOT=C:/NeoZQYY/export/SYSTEM/REPORTS/field_audit
+# 全链路数据流文档输出目录（gen_full_dataflow_doc.py）
+FULL_DATAFLOW_DOC_ROOT=C:/NeoZQYY/export/SYSTEM/REPORTS/full_dataflow_doc
+# API 样本缓存目录（gen_full_dataflow_doc.py 的 24h 缓存）
+API_SAMPLE_CACHE_ROOT=C:/NeoZQYY/export/SYSTEM/CACHE/api_samples
+# 系统级运维日志目录
+SYSTEM_LOG_ROOT=C:/NeoZQYY/export/SYSTEM/LOGS
+
+# ------------------------------------------------------------------------------
+# 后端输出路径（预留）
+# ------------------------------------------------------------------------------
+# 后端结构化日志目录
+BACKEND_LOG_ROOT=C:/NeoZQYY/export/BACKEND/LOGS
+
+# ------------------------------------------------------------------------------
+# 阿里云百炼 AI 配置
+# CHANGE 2026-02-23 | 从 PRD 文档迁移至 .env，禁止在文档中明文存放
+# ------------------------------------------------------------------------------
+BAILIAN_API_KEY=sk-6def29cab3474cc797e52b82a46a5dba
+BAILIAN_TEST_APP_ID=541edb3d5fcd4c18b13cbad81bb5fb9d