Chan/docs/PROJECT_RULES.md

Project Rules — chan

Scope boundaries

1. config/、strategies/：Freqtrade 策略资产，默认只读；任何改动需独立 ECR。
2. chanlun/：缠论引擎正式包；算法变更需 L2+ ECR + 回归基线。
3. 根目录 Chan*.py / TF_DF.py：兼容 shim，保持 from ChanLun import ChanLun 可用。
4. web/：可视化与 API；/api/analyze 契约冻结于 ECR-001（可增不可删）；结构继续演进见 ECR-002 Draft。
5. 双前端：/ Lightweight + HTTP 刷新；/chan_tv Charting Library + WS。主站勿无 ECR 擅自接 WS。
6. system_version ≠ strategy_version：策略资产变更须独立 ECR（L2+ 含 EXP）。

Change levels

• L0 docs / L1 bugfix / L2 behavior / L3 architecture — 见 ESS CHANGE_MANAGEMENT。
• 结构重构默认 L3；若触及缠论识别结果 → 升为 L2 并要求 RISK_REVIEW + EXP。

Compatibility

• 正式导入：from chanlun import ChanLun, TF_DF；from chanlun.core.ChanEnum import ...
• 根目录 Chan*.py / TF_DF.py 为兼容 shim（旧脚本可用）；新代码与 strategies 应使用 chanlun 包
• Web URL 与 /api/analyze 字段名/结构保持兼容
• 策略文件通过 sys.path.append(仓库根) 保证能找到 chanlun 包

Language

• 代码注释与提交说明优先中文。