refactor: 缠论引擎包化与 Web 分层（ECR-001）

将根目录引擎迁入 chanlun/ 并保留兼容 shim；拆分 TF_DF 与 web 服务；
前端模块化；strategies 改用 chanlun 导入；补充 ESS 文档与 golden 回归。

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/ECR/ECR-001-chan-web-restructure.md

@@ -0,0 +1,70 @@
+# ECR-001
+
+**Title:** 缠论引擎包化 + Web 分层重构（行为冻结）  
+**Status:** Approved  
+**Date:** 2026-08-05  
+**Change Level:** L3  
+
+## Change
+
+将根目录扁平 `Chan*.py` / `TF_DF.py` 包化为 `chanlun/`，拆分 `web/app.py` 与巨型 `index.html` inline JS；算法与 `/api/analyze` 契约冻结；`config/` / `strategies/` 不动。
+
+## Motivation
+
+根目录与 Web 单体过大、职责混杂，难以维护与测试；需在不影响 Freqtrade 策略导入的前提下重整结构。
+
+## Scope
+
+### Allowed
+
+- 创建 `chanlun/`（core / pipeline / indicators / analysis）与根目录兼容 shim
+- 拆分 `TF_DF` 为 builders + 门面（公开方法签名不变）
+- Web：`config` + `services` + `api` blueprints；配置外置（proxy / DATA_SERVICE）
+- 前端：`index.html` 业务 JS 外置到 `static/js/app/`；隔离未接线 TS/TSX
+- 示例与笔记迁入 `examples/` / `docs/notes/`
+- Golden / 契约回归测试
+
+### Forbidden
+
+- 修改笔 / 线段 / 中枢 / 买卖点算法语义
+- 破坏 `/api/analyze` JSON 字段（可增不可删）
+- 修改 `config/`、`strategies/`
+- 引入 Vite/React/TS 构建
+- 重做 UI 视觉或更换 TradingView
+
+## Risk
+
+| Risk | Mitigation |
+|------|------------|
+| 策略 import 断裂 | 根 shim + 冒烟导入 |
+| 拆文件改算法 | 仅搬移；golden fixture |
+| 前端事件遗漏 | 按块抽取 + 手工/冒烟 |
+| API 字段漂移 | analyze 契约测试 |
+
+## Acceptance Criteria
+
+- [x] `from ChanLun import ChanLun` / `from ChanEnum import ...` 仍可用
+- [x] Golden：同一 fixture 下 bi/seg/zs/bsp 序列化结果与基线一致
+- [x] `/api/analyze` 关键字段集合兼容（契约冒烟）
+- [x] `web/app.py` 瘦身为 factory；业务在 services/api
+- [x] `index.html` 不再含大体量业务 inline JS
+- [x] ESS docs 齐全；TEST_REPORT / IMPLEMENTATION_REPORT / CHANGELOG
+- [x] `config/`、`strategies/` 无内容变更
+
+**Status:** Done（待 Reviewer 签核）
+
+## Rollback
+
+单分支 / 单 PR 回滚；shim 期可整体 `git revert`。
+
+## Risk Review
+
+- Path: `docs/RISK_REVIEW/ECR-001.md` — N/A（不改交易语义）
+
+## Linked
+
+- PRD / PRODUCT_SPEC: `docs/PRODUCT_SPEC/ECR-001-restructure.md`
+- ENGINEERING_SPEC: `docs/ENGINEERING_SPEC/ECR-001-restructure.md`
+- ADR: `docs/ADR/ADR-001-package-layout.md`
+- EXPERIMENT: N/A
+- TRACEABILITY: Yes