chore: 项目初始化 — 工程文档、配置与目录骨架

- AGENT.md / docs/ARCHITECTURE.md 约束与架构文档入库（README 覆盖远端模板）
- 根级配置：.gitignore / .env.example / config.yaml（密钥只走 .env，不入库）
- 目录占位：data(parquet/qlib/raw/normalized) / experiments / docker / frontend/web / scripts

.env.example

@@ -0,0 +1,24 @@
+# ============================================================
+# 复制本文件为项目根目录 .env 并填入真实值。
+# .env 已被 .gitignore 忽略 —— 严禁把真实密钥提交进 Git。
+# 各变量用途：被根目录 config.yaml 中对应 *_env 字段引用，
+# 或由后端 app.core.config 直接读取。
+# ============================================================
+
+# ---- Tushare Pro token（首选数据源，Phase 1 数据管线使用）----
+TUSHARE_TOKEN=
+
+# ---- 数据库连接 ----
+# 留空时使用默认 SQLite：<项目根>/data/quant.db（相对路径自动解析到项目根）
+DATABASE_URL=
+# SQLite 示例（显式指定）：
+# DATABASE_URL=sqlite:///./data/quant.db
+# MySQL 示例（未来切换，仅需改此值，业务代码不变）：
+# DATABASE_URL=mysql+pymysql://user:password@127.0.0.1:3306/quant
+
+# ---- AI Agent / LLM（Phase 5 接入，先留空）----
+LLM_API_KEY=
+LLM_BASE_URL=
+
+# ---- API 应用密钥（必须修改为随机值）----
+APP_SECRET_KEY=please-change-me