# AlphaX Agent ｜ Crypto Docker 部署

这是 AlphaX Agent ｜ Crypto 的 Docker 化运行目录。当前运行时数据库已经一次性切换为 PostgreSQL；SQLite 只作为历史数据导入来源，不再作为应用运行时数据库。

## 重要原则

- Web 默认暴露到宿主机 `8191`，容器内端口 `8190`。
- 运行时数据库是 PostgreSQL，compose 内置 `postgres:16` 服务。
- `DATABASE_URL` 是应用唯一运行时数据库连接入口。
- 调度器以并发子进程运行，并通过业务锁组避免主推荐写入冲突。
- `.dockerignore` 排除了 `data/`、真实 `.env` 和所有 DB 文件，避免把数据库/密钥打进镜像。

## 快速启动

```bash
cp .env.example .env
# 按需编辑 .env 中的 POSTGRES_* / DATABASE_URL / 推送 / LLM / 链上 API key

docker compose build
docker compose up -d postgres alphax-web alphax-scheduler
```

访问：

```text
http://127.0.0.1:8191
```

首次空库启动时会自动创建默认管理员账号：

```text
邮箱：admin@alphax.local
密码：AlphaXAdmin123
```

建议首次登录后立刻修改密码。也可以在 `.env` 中覆盖：

```text
ALPHAX_BOOTSTRAP_ADMIN=1
ALPHAX_DEFAULT_ADMIN_EMAIL=your-admin@example.com
ALPHAX_DEFAULT_ADMIN_PASSWORD=change-me-to-a-strong-password
```

该初始化只会在 `app_user` 表为空时执行；迁移旧数据后不会覆盖已有账号。

## 数据库配置

本地 dev 默认：

```text
POSTGRES_DB=alphax_dev
POSTGRES_USER=alphax
POSTGRES_PASSWORD=alphax_dev_password
DATABASE_URL=postgresql://alphax:alphax_dev_password@postgres:5432/alphax_dev
ALPHAX_DB_BACKEND=postgres
```

生产环境建议只区分 `dev` 和 `production` 两套库：

```text
ALPHAX_ENV=production
DATABASE_URL=postgresql://<user>:<password>@<host>:5432/<database>
```

## SQLite 历史数据导入

SQLite 不再用于运行时。如果需要把旧 `altcoin_monitor.db` / `scheduler_state.db` 导入 PostgreSQL，先启动 PostgreSQL，再运行：

```bash
docker compose up -d postgres
docker compose run --rm alphax-web python scripts/postgres/run_migrations.py
docker compose run --rm alphax-web python scripts/postgres/import_from_sqlite.py \
  --sqlite-path /app/data/altcoin_monitor.db \
  --scheduler-sqlite-path /app/data/scheduler_state.db
docker compose run --rm alphax-web python scripts/postgres/validate_import.py \
  --sqlite-path /app/data/altcoin_monitor.db \
  --scheduler-sqlite-path /app/data/scheduler_state.db \
  --all-tables
```

导入完成后，应用运行只读写 PostgreSQL。

## 服务说明

- `postgres`：PostgreSQL 16，数据保存在 compose volume `postgres_data`。
- `alphax-web`：FastAPI + 静态页面。
- `alphax-scheduler`：调度器，读取 PostgreSQL 中的任务配置和运行状态。

默认任务周期：

| 任务 | 间隔 |
|---|---:|
| 事件舆情 | 60s |
| 价格跟踪 | 180s |
| 爆发确认 | 600s |
| 粗筛/细筛 | 900s |
| 舆情采集 | 1800s |
| LLM 舆情分析 | 1800s |
| 链上追踪 | 1800s |
| 复盘 | 86400s |

## 常用验证

```bash
python3 scripts/validate_docker_layout.py
docker compose config
docker compose ps
docker compose logs --tail=100 alphax-web
docker compose logs --tail=100 alphax-scheduler
```

容器内 API smoke：

```bash
docker compose exec alphax-web curl -fsS http://127.0.0.1:8190/api/stats
docker compose exec alphax-web curl -fsS 'http://127.0.0.1:8190/api/pipeline/runs?page=1&page_size=5'
docker compose exec alphax-web curl -fsS http://127.0.0.1:8190/api/onchain/overview
```

## LLM 解释层配置

LLM 是运行时系统能力，不属于策略参数，不写入 `rules.yaml`。在 `.env` 中配置：

```bash
ALPHAX_LLM_ENABLED=1
ALPHAX_LLM_BASE_URL=https://api.openai.com/v1
ALPHAX_LLM_API_KEY=your-key
ALPHAX_LLM_MODEL=gpt-4o-mini
```

生成缓存解释：

```bash
docker compose exec alphax-web python -m app.cli llm-insights --scope recommendations --limit 30
docker compose exec alphax-web python -m app.cli llm-insights --scope sentiment --limit 30
docker compose exec alphax-web python -m app.cli llm-insights --scope review --limit 10
```

## 备份与恢复

PostgreSQL 备份：

```bash
docker compose exec postgres pg_dump -U "$POSTGRES_USER" "$POSTGRES_DB" > alphax_backup.sql
```

恢复到空库：

```bash
cat alphax_backup.sql | docker compose exec -T postgres psql -U "$POSTGRES_USER" "$POSTGRES_DB"
```