在准备环境前提交次全部更改。

This commit is contained in:
Neo
2026-02-19 08:35:13 +08:00
parent ded6dfb9d8
commit 4eac07da47
1387 changed files with 6107191 additions and 33002 deletions

View File

@@ -0,0 +1,84 @@
- [P20260219-063120] 2026-02-19 06:31:20 +0800
- summary: CONTEXT TRANSFER: We are continuing a conversation that had gotten too long. Here is a summary: --- ## TASK 1: Analyze a…
- prompt:
```text
CONTEXT TRANSFER: We are continuing a conversation that had gotten too long. Here is a summary:
---
## TASK 1: Analyze and update outdated documentation in `apps/etl/connectors/feiqiu/docs/`
**STATUS**: done
**USER QUERIES**: 1 ("根据apps\etl\connectors\feiqiu\docs\README.md逐一分析apps\etl\connectors\feiqiu\docs内的文档哪些过期了帮我按照项目现状更新文档。")
**DETAILS**:
All documentation updates have been completed across 3 conversation sessions. The work involved:
1. **Phase 1 (previous session)**: Used context-gatherer to map codebase structure, read all source code truth files and all documentation files, completed analysis identifying specific outdated items per document.
2. **Phase 2 (previous session)**: Started making targeted edits to key documents.
3. **Phase 3 (this session)**: Completed all remaining updates:
- Read `base_dws_task.py` to verify schema prefixes — confirmed code uses `DWS_SCHEMA = "dws"` and `DWD_SCHEMA = "dwd"` (short names, not `billiards_*`)
- Updated `system_overview.md`: removed PySide6/Flask/GUI references, replaced with FastAPI + admin-web, fixed ODS task count 16→23, removed `ETLScheduler` reference, added `--force-full`, fixed data source section, updated PostgreSQL schema diagram to show 6-layer architecture
- Updated `data_flow.md`: fixed all schema names, added INDEX layer to data flow diagram
- Updated `base_task_mechanism.md`: fixed DWD task count 5→2, updated registration example to remove legacy `ORDERS` task
- Updated `environment_setup.md`: changed pip→uv sync, removed PySide6/flask deps, updated to 6-layer schema table, fixed DDL paths to `db/etl_feiqiu/schemas/`, updated run entries (removed GUI/batch files, added FastAPI + admin-web)
- Updated `scheduling.md`: added missing CLI params (`--force-full`, `--window-split-unit`, `--window-split-days`, `--window-compensation-hours`), fixed `etl_admin`→`meta` for cursor storage
- **Bulk schema name replacement**: Created and ran Python script `scripts/ops/fix_schema_names_in_docs.py` that updated 144 .md files, replacing `billiards_ods`→`ods`, `billiards_dwd`→`dwd`, `billiards_dws`→`dws`, and `etl_admin`→`meta` (with precise regex for etl_admin to avoid changing file name references)
- Fixed remaining `etl_admin` description text in `utility_tasks.md` and `etl_tasks/README.md`
- Added CHANGELOG entry for 2026-02-19 documenting the full documentation refresh
- Deleted the one-time batch replacement script
- Final verification confirmed zero remaining old schema names in core docs (architecture/, etl_tasks/, operations/)
**Skipped files (intentionally)**:
- `CHANGELOG.md` — historical records should not be modified
- `reports/` directory — auto-generated reports are historical snapshots
- File name references like `schema_etl_admin.sql` and config key `schema.etl_admin_file` — these are actual identifiers, not schema names
- `architecture/ods_taskspec_refactor_proposal.md` — already marked as completed, no update needed
- `docs/README.md` — directory name references (`ETL_Admin/`) are actual folder names
**FILEPATHS** (all modified):
- `apps/etl/connectors/feiqiu/docs/architecture/system_overview.md`
- `apps/etl/connectors/feiqiu/docs/architecture/data_flow.md`
- `apps/etl/connectors/feiqiu/docs/etl_tasks/base_task_mechanism.md`
- `apps/etl/connectors/feiqiu/docs/etl_tasks/utility_tasks.md`
- `apps/etl/connectors/feiqiu/docs/etl_tasks/README.md`
- `apps/etl/connectors/feiqiu/docs/etl_tasks/ods_tasks.md`
- `apps/etl/connectors/feiqiu/docs/etl_tasks/dws_tasks.md`
- `apps/etl/connectors/feiqiu/docs/etl_tasks/index_tasks.md`
- `apps/etl/connectors/feiqiu/docs/etl_tasks/ods_task_params_matrix.md`
- `apps/etl/connectors/feiqiu/docs/operations/environment_setup.md`
- `apps/etl/connectors/feiqiu/docs/operations/scheduling.md`
- `apps/etl/connectors/feiqiu/docs/operations/troubleshooting.md`
- `apps/etl/connectors/feiqiu/docs/CHANGELOG.md`
- Plus 131 additional files in `docs/database/`, `docs/business-rules/`, `docs/audit/`, `docs/api-reference/` (bulk schema name replacement)
**USER CORRECTIONS AND INSTRUCTIONS**:
- User wants docs updated according to current project state ("按照项目现状更新文档")
- Language: Chinese (user communicates in Chinese, docs are mixed Chinese/English)
- All explanatory text must be in simplified Chinese per `language-zh.md` steering
- This is a docs-only change — no code files should be modified
- Governance note: docs-only changes are low risk and don't require `/audit`
- Schema naming convention: 6-layer architecture per `tech.md` — `meta`(调度元数据), `ods`(原始数据), `dwd`(明细数据), `core`(跨门店标准化), `dws`(汇总数据), `app`(RLS 视图层)
- DDL files are at `db/etl_feiqiu/schemas/`, migrations at `db/etl_feiqiu/migrations/`, seeds at `db/etl_feiqiu/seeds/`
- Project uses uv workspace (not pip), FastAPI (not Flask), admin-web React app (not PySide6 GUI)
USER QUERIES(most recent first):
1. Output:
Command executed successfully with no output.
Exit Code: 0
2. Output:
Command executed successfully with no output.
Exit Code: 0
---
METADATA:
The previous conversation had 2 messages.
INSTRUCTIONS:
Continue working until the user query has been fully addressed. Do not ask for clarification - proceed with the work based on the context provided.
IMPORTANT: you need to read from the files to Read section
```