release: 发布系统版本 v1.0.0（ECR-001）

落盘 CODE_REVIEW Approve 与 RELEASE_REPORT，标记首个正式 release。

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

docs/CHANGELOG/CHANGELOG.md

@@ -1,11 +1,13 @@
 # CHANGELOG
 
-## 2026-08-05 — ECR-001
+## v1.0.0 — 2026-08-05（首个正式 Release）
+
+对应 ECR-001 / tag `v1.0.0`。详见 `docs/RELEASE/ECR-001-v1.0.0.md`。
 
 ### Added
 
 - 正式包 `chanlun/`（core / pipeline / builders / indicators / analysis）
-- ESS 文档树 `docs/`（PROFILE / ECR-001 / SPEC / ADR / HANDOFF）
+- ESS 文档树 `docs/`（PROFILE / ECR / SPEC / ADR / HANDOFF / CODE_REVIEW / RELEASE）
 - Web `config.py`、`services/`、`api/` blueprints
 - 前端 `web/static/js/app/` 模块
 - Golden 回归 `tests/generate_golden.py` + fixtures
@@ -17,14 +19,13 @@
 - `web/app.py` 瘦身为 `create_app()`
 - `index.html` 去掉巨型 inline 业务 JS
 - HTTP 代理改为环境变量配置
+- strategies / web / tests / examples → `from chanlun...` 导入
 
 ### Fixed
 
 - 恢复缺失的 `TF_DF.get_zs_list`（委托 `get_seg_zs_list`）
 
-### 2026-08-05 — ECR-001 follow-through
+### Moved
 
-- strategies / web / tests / examples → `from chanlun...` 导入；绝对 `sys.path` 改为相对仓库根
+- 示例 → `examples/`；笔记 → `docs/notes/`
-- `chart.js` → `chart_format/view/tv/sync/tables.js`
+- 未接线 TSX/TS → `static/js/_unused/`
-- `chan_engine` / `datafeed` / `chan_indicator` 迁入 `static/js/app/`，`chan_tv` 与主站共用
-- 根目录 shim 保留作兼容；正式入口为 `chanlun` 包

docs/CODE_REVIEW/ECR-001.md

@@ -0,0 +1,75 @@
+# CODE_REVIEW — ECR-001
+
+**Role:** REVIEWER  
+**Date:** 2026-08-05  
+**Commit:** `74dec4e` (`refactor: 缠论引擎包化与 Web 分层（ECR-001）`)  
+**Decision:** Approve  
+
+## Evidence loaded
+
+- `docs/ECR/ECR-001-chan-web-restructure.md`
+- `docs/ENGINEERING_SPEC/ECR-001-restructure.md`
+- `docs/IMPLEMENTATION_REPORT/ECR-001.md`
+- `docs/TEST_REPORT/ECR-001.md`
+- `docs/HANDOFF/ECR-001-engineer-to-reviewer.md`
+- Diff `e2e45bc..74dec4e`；本地复跑测试
+
+## Acceptance ↔ Evidence
+
+| Acceptance | Verdict | Evidence |
+|------------|---------|----------|
+| `from ChanLun import ChanLun` / `ChanEnum` 仍可用 | PASS | 复跑 shim+package 同一对象；`test_compat_shim_still_works` |
+| Golden bi/seg/zs/bsp 与基线一致 | PASS | `python tests/generate_golden.py --check` → GOLDEN OK；pytest 含 golden |
+| `/api/analyze` 关键字段兼容 | PASS | `analyze_contract_keys.json` + 路由注册冒烟（未做实盘拉行情 E2E，见 Findings） |
+| `web/app.py` 瘦身 factory | PASS | `web/app.py` 32 行；`create_app` + blueprints |
+| `index.html` 无大体量 inline 业务 JS | PASS | ~1482 行；业务在 `static/js/app/*` |
+| ESS docs / TEST / IMPL / CHANGELOG | PASS | `docs/` 齐全 |
+| `config/` 无内容变更 | PASS | `git diff e2e45bc..HEAD -- config` 空 |
+| `strategies/` 无内容变更 | **AMENDED** | 见下「范围修订」 |
+
+## 范围修订（Human 后续指示）
+
+原 ECR Forbidden 写「不改 strategies/」。实现后期 Human 要求「一次性做完」导入迁移：strategies 仅改 import / `sys.path`（26 files, +75/−75），**无策略交易逻辑变更**。  
+审阅结论：视为 **L3 结构收尾的允许增补**，不构成交易语义 L2；建议 ECR Acceptance 改为「strategies 仅允许 import/path 迁移，禁止改买卖逻辑」。  
+**不据此 Request changes。**
+
+## 复跑结果（Reviewer）
+
+```text
+shim+package OK
+GOLDEN OK {klu:400, klc:208, bi:14, seg:2, zs:0, bsp:3}
+pytest tests/test_golden_pipeline.py web/tests/test_analyze_contract.py → 6 passed
+```
+
+## Findings
+
+### Non-blocking（记入债务，需新 ECR 再动）
+
+1. **`web/services/runtime.py` ~1176 行** — 已从 app 抽出但仍是大模块；facade 再导出符合计划，建议 ECR-002 继续按 data/analyze/serialize 物理拆分。
+2. **`web/static/js/app/chart_tv.js` ~4664 行** — `initTradingView` 单体；行为冻结下可接受。
+3. **`/api/analyze` 契约测试偏浅** — 仅关键字段清单 + 路由存在；无固定 fixture 的端到端 JSON 快照（需 mock 行情）。
+4. **TEST_REPORT 写「5 passed」** — 现为 6（含 shim 兼容测）；Release 前可改正文（L0 docs）。
+5. **L1：`TF_DF.get_zs_list` 恢复** — 合理兼容修复；golden 走 analyze 路径未覆盖 `TF_DF(df,...)` 全量 `__init__`，建议后续加一条 init 冒烟（非阻断）。
+
+### No blockers
+
+未发现违反「算法语义冻结 / API 可增不可删 / 无 Vite-React / config 未改」的证据。
+
+## Decision
+
+**Approve**
+
+- ECR-001 可进入 Release（本变更无交易 EXP 门禁）。
+- 非阻断项进入 backlog / 未来 ECR，不阻塞 tag。
+
+## Next owner
+
+`release_manager` — 写 RELEASE_REPORT、打 tag（需 Human 确认发布动作）。
+
+## Traceability
+
+| Item | Updated |
+|------|---------|
+| Acceptance mapping | 本文件 |
+| STATE.owner | → release_manager |
+| ECR Status | → Done (Reviewed) |

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

@@ -28,7 +28,7 @@
 
 - 修改笔 / 线段 / 中枢 / 买卖点算法语义
 - 破坏 `/api/analyze` JSON 字段（可增不可删）
-- 修改 `config/`、`strategies/`
+- 修改 `config/`；修改 `strategies/` 交易逻辑或参数（import/`sys.path` 迁移除外，见 CODE_REVIEW）
 - 引入 Vite/React/TS 构建
 - 重做 UI 视觉或更换 TradingView
 
@@ -49,9 +49,9 @@
 - [x] `web/app.py` 瘦身为 factory；业务在 services/api
 - [x] `index.html` 不再含大体量业务 inline JS
 - [x] ESS docs 齐全；TEST_REPORT / IMPLEMENTATION_REPORT / CHANGELOG
-- [x] `config/`、`strategies/` 无内容变更
+- [x] `config/` 无内容变更；`strategies/` 仅允许 import/`sys.path` 迁移（Human 增补，无交易逻辑变更）
 
-**Status:** Done（待 Reviewer 签核）
+**Status:** Done (Released as `v1.0.0`)
 
 ## Rollback
 

docs/HANDOFF/ECR-001-engineer-to-reviewer.md

@@ -12,12 +12,16 @@
 - [x] PRODUCT_SPEC / ENGINEERING_SPEC / ADR / RISK N/A
 - [x] IMPLEMENTATION_REPORT
 - [x] TEST_REPORT
-- [ ] CODE_REVIEW
+- [x] CODE_REVIEW → Approve（`docs/CODE_REVIEW/ECR-001.md`）
 
 ## Goal for receiver
 
 对照 ECR-001 Acceptance 做代码审阅；确认 strategies/config 无 diff；golden 与路由契约通过。
 
+## Reviewer outcome
+
+**Approve**（strategies 仅 import 迁移，记为范围修订）。Next → release_manager。
+
 ## References
 
 - `docs/IMPLEMENTATION_REPORT/ECR-001.md`

docs/RELEASE/ECR-001-v1.0.0.md

@@ -0,0 +1,56 @@
+# RELEASE_REPORT — ECR-001 / v1.0.0
+
+**Role:** RELEASE_MANAGER  
+**Date:** 2026-08-05  
+**System version:** `v1.0.0`（首个正式 Release）  
+**Strategy version:** 不变（本 release 不改策略交易语义；strategies 仅 import 迁移）  
+**Git commit:** `74dec4e` + 本 release 文档提交  
+**Branch:** `dev`  
+
+## Scope
+
+缠论引擎包化（`chanlun/`）+ Web 分层 + 前端模块化 + ESS 治理文档落盘（ECR-001 L3，行为冻结）。
+
+## Gates
+
+| Gate | Status | Evidence |
+|------|--------|----------|
+| ECR Approved | PASS | `docs/ECR/ECR-001-chan-web-restructure.md` |
+| ENGINEERING_SPEC / ADR | PASS | `docs/ENGINEERING_SPEC/` · `docs/ADR/ADR-001-package-layout.md` |
+| TEST_REPORT | PASS | `docs/TEST_REPORT/ECR-001.md`；golden + pytest |
+| CODE_REVIEW | PASS Approve | `docs/CODE_REVIEW/ECR-001.md` |
+| RISK_REVIEW / EXP | N/A | 不改交易决策语义 |
+| Human release intent | PASS | Human：「作为第一 release 版本」 |
+
+## Checklist
+
+- [x] Acceptance 已由 Reviewer 对照通过
+- [x] `config/` 无策略参数变更
+- [x] Rollback：`git revert` / 回到 tag 前 commit；Web 回滚同 tag
+- [x] 环境：Web Flask（`FLASK_PORT` 默认 8128）；行情依赖 `DATA_SERVICE_URL`
+- [x] Tag：`v1.0.0`
+
+## Artifacts
+
+| Kind | Path |
+|------|------|
+| CODE_REVIEW | `docs/CODE_REVIEW/ECR-001.md` |
+| RELEASE | 本文件 |
+| CHANGELOG | `docs/CHANGELOG/CHANGELOG.md` |
+
+## Promote note
+
+本 tag 标记 **系统软件 v1.0.0**（分析引擎 + Web）。  
+**非** Freqtrade Live 交易 Promote；若上 Live 策略仍需独立 Paper/EXP + Human 批准。
+
+## Rollback
+
+```bash
+git checkout v1.0.0   # 钉在本版本
+# 或回退到上一提交
+git checkout e2e45bc
+```
+
+## Decision
+
+**Release `v1.0.0`** — ship on `dev` with annotated tag.

docs/STATE/CURRENT.md

@@ -1,10 +1,11 @@
 # STATE
 
-**owner:** reviewer  
+**owner:** done  
 **active_ecr:** ECR-001  
-**phase:** review  
+**phase:** released  
+**system_version:** v1.0.0  
 **updated:** 2026-08-05  
 
 ## Notes
 
-Engineer hop complete. See IMPLEMENTATION_REPORT + TEST_REPORT.
+First release `v1.0.0` shipped. See `docs/RELEASE/ECR-001-v1.0.0.md`.