DWD完成

etl_billiards/.env

@@ -1,53 +1,49 @@
-# 数据库配置（真实库）
+# -*- coding: utf-8 -*-
+# 文件说明：ETL 环境变量（config/env_parser.py 读取），用于数据库连接、目录与运行参数。
+
+# 数据库连接字符串，config/env_parser.py -> db.dsn，所有任务必需
 PG_DSN=postgresql://local-Python:Neo-local-1991125@100.64.0.4:5432/LLZQ-test
+# 数据库连接超时秒，config/env_parser.py -> db.connect_timeout_sec
 PG_CONNECT_TIMEOUT=10
-# 如需拆分配置：PG_HOST=... PG_PORT=... PG_NAME=... PG_USER=... PG_PASSWORD=...
 
-# API配置（如需走真实接口再填写）
-API_BASE=https://api.example.com
-API_TOKEN=your_token_here
-# API_TIMEOUT=20
-# API_PAGE_SIZE=200
-# API_RETRY_MAX=3
-
-# 应用配置
+# 门店/租户ID，config/env_parser.py -> app.store_id，任务调度记录使用
 STORE_ID=2790685415443269
-# TIMEZONE=Asia/Taipei
-# SCHEMA_OLTP=billiards
-# SCHEMA_ETL=etl_admin
+# 时区标识，config/env_parser.py -> app.timezone
+TIMEZONE=Asia/Taipei
 
-# 路径配置
-EXPORT_ROOT=C:\dev\LLTQ\export\JSON
+# API 基础地址，config/env_parser.py -> api.base_url，FETCH 类任务调用
+API_BASE=https://api.example.com
+# API 鉴权 Token，config/env_parser.py -> api.token，FETCH 类任务调用
+API_TOKEN=your_token_here
+# API 请求超时秒，config/env_parser.py -> api.timeout_sec
+API_TIMEOUT=20
+# API 分页大小，config/env_parser.py -> api.page_size
+API_PAGE_SIZE=200
+# API 最大重试次数，config/env_parser.py -> api.retries.max_attempts
+API_RETRY_MAX=3
+
+# 日志根目录，config/env_parser.py -> io.log_root，Init/任务运行写日志
 LOG_ROOT=C:\dev\LLTQ\export\LOG
-FETCH_ROOT=
-INGEST_SOURCE_DIR=
-WRITE_PRETTY_JSON=false
-PGCLIENTENCODING=utf8
+# JSON 导出根目录，config/env_parser.py -> io.export_root，FETCH 产出及 INIT 准备
+EXPORT_ROOT=C:\dev\LLTQ\export\JSON
 
-# ETL配置
+# FETCH 模式本地输出目录，config/env_parser.py -> pipeline.fetch_root
+FETCH_ROOT=C:\dev\LLTQ\export\JSON
+# 本地入库 JSON 目录，config/env_parser.py -> pipeline.ingest_source_dir，MANUAL_INGEST/INGEST_ONLY 使用
+INGEST_SOURCE_DIR=C:\dev\LLTQ\export\test-json-doc
+
+# JSON 漂亮格式输出开关，config/env_parser.py -> io.write_pretty_json
+WRITE_PRETTY_JSON=false
+
+# 运行流程：FULL / FETCH_ONLY / INGEST_ONLY，config/env_parser.py -> pipeline.flow
+PIPELINE_FLOW=FULL
+# 指定任务列表（逗号分隔，覆盖默认），config/env_parser.py -> run.tasks
+# RUN_TASKS=INIT_ODS_SCHEMA,MANUAL_INGEST
+
+# 窗口/补偿参数，config/env_parser.py -> run.*
 OVERLAP_SECONDS=120
 WINDOW_BUSY_MIN=30
 WINDOW_IDLE_MIN=180
 IDLE_START=04:00
 IDLE_END=16:00
 ALLOW_EMPTY_RESULT_ADVANCE=true
-
-# 清洗配置
-LOG_UNKNOWN_FIELDS=true
-HASH_ALGO=sha1
-STRICT_NUMERIC=true
-ROUND_MONEY_SCALE=2
-
-# 测试/离线模式（真实库联调建议 ONLINE）
-TEST_MODE=ONLINE
-TEST_JSON_ARCHIVE_DIR=tests/source-data-doc
-TEST_JSON_TEMP_DIR=/tmp/etl_billiards_json_tmp
-
-# 测试数据库
-TEST_DB_DSN=postgresql://local-Python:Neo-local-1991125@100.64.0.4:5432/LLZQ-test
-
-# ODS <20>ؽ<EFBFBD><D8BD>ű<EFBFBD><C5B1><EFBFBD><EFBFBD>ã<EFBFBD><C3A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ã<EFBFBD>
-JSON_DOC_DIR=C:\dev\LLTQ\export\test-json-doc
-ODS_INCLUDE_FILES=
-ODS_DROP_SCHEMA_FIRST=true
-