# Project Profile — chan (缠论)

> Agent 第一次读这个文件。不要重新猜技术栈；偏离见 Forbidden + ADR。

## Type
Trading System（缠论分析引擎 + 可视化 Web；Freqtrade 策略目录独立、默认只读）

## Stack Lock

| Layer | Choice |
|-------|--------|
| Language | Python 3 |
| Engine package | `chanlun/` |
| Backend | Flask |
| Realtime | 主站 `/`：请求式分析 + 定时自动刷新（HTTP）；全版 `/chan_tv`：TradingView datafeed + WebSocket（`DATA_SERVICE_WS_URL`，可与 REST 分域名） |
| Database | 无（行情外部 DATA_SERVICE / CCXT / A 股接口） |
| Frontend | 主站 Lightweight Charts（`web/static/js/app/`）；全版 TradingView Charting Library（`/chan_tv`） |
| Deployment | gunicorn / systemd（web） |
| Architecture Pattern | 包化引擎 + Web services/blueprints + 根目录兼容 shim |

## Forbidden（无 ADR / 无 ECR 禁止）

- 无 ADR 修改笔 / 线段 / 中枢 / 买卖点算法语义
- 无 ECR 修改 `config/`、`strategies/` 策略逻辑或参数
- 无 ECR 破坏 `/api/analyze` JSON 契约（可增不可删）
- 引入 Kafka / MongoDB / 微服务拆分（除非新 ADR）
- 本轮引入 Vite/React/TS 构建流水线
- 威科夫等**独立分析叠层**须走 ECR（可增 API 字段）；不得借机改缠论算法

## Versioning

- `system_version`：软件/分析系统（见 `docs/STATE/CURRENT.md`、Release tag）
- `strategy_version`：Freqtrade 策略资产；与 system 解耦；改 strategies/config 须独立 ECR +（L2）EXP

## Active anchors

- ECR: ECR-002/003/004 Reviewed；ECR-007 Final Approval（Live Structure，待合入 `dev`）
- EXP: N/A
- TRACEABILITY: `docs/TRACEABILITY.md`
- Memory: `docs/AGENT_MEMORY.md`
- Loop archive: `docs/runs/LOOP-RUN-005/`

## Pointers

- Rules: `PROJECT_RULES.md`
- Stack detail: `TECH_STACK.md`
- Agent entry: `AGENTS.md` / `CLAUDE.md`