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

This commit is contained in:
Neo
2026-02-23 23:02:20 +08:00
parent 254ccb1e77
commit fafc95e64c
1142 changed files with 10366960 additions and 36957 deletions

View File

@@ -0,0 +1,190 @@
- [P20260220-103424] 2026-02-20 10:34:24 +0800
- summary: CONTEXT TRANSFER: We are continuing a conversation that had gotten too long. Here is a summary: --- ## TASK 1: Full Prod…
- prompt:
```text
CONTEXT TRANSFER: We are continuing a conversation that had gotten too long. Here is a summary:
---
## TASK 1: Full Production Integration Test (api_full, verify_only, custom window)
**STATUS**: done
**USER QUERIES**: Initial context transfer, "继续监测 并debug", "定期检查并DEBUG"
**DETAILS**:
- ETL run `896b9647-4e3a-4e10-ac23-e6f59ee9c114` completed successfully
- `exit_code=0`, total duration 5,135 seconds (~85 minutes)
- 22 ODS tasks executed: 21 SUCC, 1 FAIL (`ODS_ASSISTANT_LEDGER` — expected JSONB bug, fix already in code)
- Top data volumes: `ODS_PLATFORM_COUPON` (219,732 records, 27min), `ODS_PAYMENT` (130,560, 13min), `ODS_TABLE_USE` (110,598, 16min)
- `verify_only` mode only executes ODS fetch + verification, does NOT run DWD/DWS tasks (by design)
- DWS/INDEX layers explicitly skipped in `_run_verification()` with `"lightweight_dws_index"` reason
- Reports generated: `etl_timing_20260220_091414.md` and `consistency_report_20260220_091414.md`
**FILEPATHS**:
- `export/ETL-Connectors/feiqiu/REPORTS/etl_timing_20260220_091414.md`
- `export/ETL-Connectors/feiqiu/REPORTS/consistency_report_20260220_091414.md`
---
## TASK 2: Fix consistency report issues (missing DWD fields + whitelist)
**STATUS**: in-progress
**USER QUERIES**: "2张dwd表省略 缺少的字段补齐", "fetched_at作为update_time这合理么", "increment_only 和 increment_verify 模式怎么运作的?"
**DETAILS**:
- Consistency report showed 4 issues:
1. `dwd.dim_member.update_time` — missing ODS mapping
2. `dwd.dwd_member_balance_change.principal_change_amount` — missing ODS mapping
3. `dwd.dwd_goods_stock_movement` — DWD table doesn't exist (user said skip)
4. `dwd.dwd_goods_stock_summary` — DWD table doesn't exist (user said skip)
- **`principal_change_amount` fix (DONE)**: Added mapping `COALESCE(CAST(principal_after AS numeric),0) - COALESCE(CAST(principal_before AS numeric),0)` in `FACT_MAPPINGS`
- **`update_time` fix (REVISED)**:
- Initially mapped to `fetched_at`, but user correctly pointed out `fetched_at` is ETL ingestion time, not business update time
- Confirmed via DB query: upstream API payload has NO `update_time`/`modify_time` field — only `create_time`
- Reverted the `fetched_at` mapping, now keeping it as NULL with a comment explaining why
- Started adding a `KNOWN_NO_SOURCE` whitelist dict in `check_ods_vs_dwd_mappings()` in `consistency_checker.py`
- **Whitelist implementation (PARTIALLY DONE — CUT OFF)**:
- Added `KNOWN_NO_SOURCE` dict at top of `check_ods_vs_dwd_mappings()` with `{"dwd.dim_member": {"update_time"}}`
- BUT: the actual logic to USE this whitelist (checking `col_lower in KNOWN_NO_SOURCE.get(dwd_table, set())` in the `else` branch that currently marks fields as "missing") was NOT yet added before context was cut off
- Need to also add `"dwd.dwd_member_balance_change": {"principal_change_amount"}` — wait, this one WAS mapped via FACT_MAPPINGS expression, so it should pass now. Only `dim_member.update_time` needs the whitelist.
- **Other fixes done in this session**:
- `test_cli_args.py`: Added `force_full=False` to `_make_args` defaults (was causing test failure)
- `README.md`: Added `--force-full` parameter documentation to CLI parameter table
- All 738 unit tests passing
- **User's unanswered question**: "increment_only 和 increment_verify 模式怎么运作的?" — needs explanation based on `flow_runner.py` code
**NEXT STEPS**:
1. Complete the whitelist logic in `consistency_checker.py` — add the branch in the `else` clause (around line 250) that checks `KNOWN_NO_SOURCE` before marking as "missing":
```python
no_source = KNOWN_NO_SOURCE.get(dwd_table, set())
if col_lower in no_source:
result.field_results.append(FieldCheckResult(col, "pass", "已知无源字段(上游 API 不提供)"))
result.passed_fields += 1
else:
# existing missing logic
```
2. Answer user's question about `increment_only` vs `increment_verify` modes (trace `flow_runner.py` code):
- `increment_only`: runs `task_executor.run_tasks()` for all resolved layers (ODS→DWD→DWS→INDEX), no verification
- `increment_verify`: same as above, then additionally runs `_run_verification()` after
3. Run unit tests again to confirm whitelist change doesn't break anything
**FILEPATHS**:
- `apps/etl/connectors/feiqiu/tasks/dwd/dwd_load_task.py` (MODIFIED — principal_change_amount mapping added, update_time reverted to NULL)
- `apps/etl/connectors/feiqiu/quality/consistency_checker.py` (PARTIALLY MODIFIED — KNOWN_NO_SOURCE dict added but logic to use it NOT yet implemented)
- `apps/etl/connectors/feiqiu/tests/unit/test_cli_args.py` (MODIFIED — force_full default)
- `apps/etl/connectors/feiqiu/docs/etl_tasks/README.md` (MODIFIED — --force-full docs)
---
## TASK 3: ODS_ASSISTANT_LEDGER JSONB fix (from prior session)
**STATUS**: done (code fix applied, awaiting next ETL run to verify)
**DETAILS**:
- `_mark_missing_as_deleted` in `ods_tasks.py` now detects ALL JSONB columns via `cols_info` udt_name and wraps dict/list values with `Json()`
- Fix at line ~654 with CHANGE comment dated 2026-02-20
- This run used old code (started before fix), so `ODS_ASSISTANT_LEDGER` still failed as expected
**FILEPATHS**: `apps/etl/connectors/feiqiu/tasks/ods/ods_tasks.py`
---
## KEY ARCHITECTURE (for new agent reference):
- Frontend: React + Vite + Ant Design at `apps/admin-web/` (localhost:5173)
- Backend: FastAPI at `apps/backend/` (localhost:8000)
- ETL subprocess launched by backend `task_executor.py`
- Auth: JWT tokens in localStorage
- ETL data goes to `test_etl_feiqiu` database, execution logs to `test_zqyy_app.public.task_execution_log`
- Four DB connections available: `mcp_pg_etl` (etl_feiqiu), `mcp_pg_etl_test` (test_etl_feiqiu), `mcp_pg_app` (zqyy_app), `mcp_pg_app_test` (test_zqyy_app)
## USER CORRECTIONS AND INSTRUCTIONS:
- All output text must be in simplified Chinese (language-zh.md steering)
- All file outputs must go through `export/` directory structure via `.env` environment variables
- Changes to high-risk paths require `/audit` trigger
- Python scripts preferred over PowerShell for complex operations
- Audit reminder is pending for: root-file, dir:admin-web, dir:backend, dir:db, db-schema-change, dir:tasks
- User explicitly asked to verify code claims — don't speculate about behavior, trace the actual code path
- `fetched_at` is ETL ingestion timestamp, NOT business update time — don't confuse them
- User said to skip the 2 missing DWD tables (`dwd_goods_stock_movement`, `dwd_goods_stock_summary`)
## Files to read
- `apps/etl/connectors/feiqiu/quality/consistency_checker.py` (IN PROGRESS — need to complete KNOWN_NO_SOURCE whitelist logic)
- `apps/etl/connectors/feiqiu/tasks/dwd/dwd_load_task.py` (verify current state of FACT_MAPPINGS for dim_member and dwd_member_balance_change)
- `apps/etl/connectors/feiqiu/orchestration/flow_runner.py` (to answer user's question about increment_only vs increment_verify modes)
USER QUERIES(most recent first):
1. verify_only 模式下,代码只执行 ODS 抓取 + 校验DWDDWD_LOAD_FROM_ODS和 DWS 聚合任务不会被 run_tasks() 调用。这是设计行为。要跑 DWD+DWS需要用 increment_only 或 increment_verify 模式。最合理的映射是用 fetched_at 作为 update_time这合理么我记得 fetched_at 是入库时间吧难道我记错了increment_only 和 increment_verify 模式怎么运作的?
2. Output:
Command executed successfully with no output.
Exit Code: 0
3. Output:
Command executed successfully with no output.
Exit Code: 0
4. verify_only 模式下,代码只执行 ODS 抓取 + 校验DWDDWD_LOAD_FROM_ODS和 DWS 聚合任务不会被 run_tasks() 调用。这是设计行为。要跑 DWD+DWS需要用 increment_only 或 increment_verify 模式。最合理的映射是用 fetched_at 作为 update_time这合理么我记得 fetched_at 是入库时间吧难道我记错了increment_only 和 increment_verify 模式怎么运作的?
5. Output:
Hook execution failed with exit code 1.
Error output:
[AUDIT REMINDER] Pending audit detected (root-file, dir:admin-web, dir:backend, dir:db, db-schema-change). Run /audit (Manual: Run /audit hook) to sync docs & write audit artifacts. (rate limit: 15min)
Exit Code: 1
6. Output:
Command executed successfully with no output.
Exit Code: 0
7. Output:
Command executed successfully with no output.
Exit Code: 0
8. 2张dwd表省略 缺少的字段补齐 dwd和 DWS没有执行么
9. Output:
Hook execution failed with exit code 1.
Error output:
[AUDIT REMINDER] Pending audit detected (root-file, dir:admin-web, dir:backend, dir:db, db-schema-change). Run /audit (Manual: Run /audit hook) to sync docs & write audit artifacts. (rate limit: 15min)
Exit Code: 1
10. Output:
Command executed successfully with no output.
Exit Code: 0
11. Output:
Command executed successfully with no output.
Exit Code: 0
12. 继续监测 并debug
13. Output:
Hook execution failed with exit code 1.
Error output:
[AUDIT REMINDER] Pending audit detected (root-file, dir:admin-web, dir:backend, dir:db, db-schema-change). Run /audit (Manual: Run /audit hook) to sync docs & write audit artifacts. (rate limit: 15min)
Exit Code: 1
14. Output:
Command executed successfully with no output.
Exit Code: 0
15. Output:
Command executed successfully with no output.
Exit Code: 0
---
METADATA:
The previous conversation had 8 messages.
INSTRUCTIONS: