# Aethon（安拓）快速上手指南

> 面向初次使用者的 10 分钟上手文档。完整功能说明见 [USER_GUIDE.md](USER_GUIDE.md)，部署见 [DEPLOYMENT.md](DEPLOYMENT.md)。

## 1. 这是什么

Aethon 是一套面向中国离散制造业的 **AI MES（制造执行系统）+ 制造智能体平台**：

- **MES 能力**：设备监控、生产工单、库存、质量、维护、采购、追溯、MRP、APS、WMS……
- **AI 能力**：AI 助手（Copilot）、5 大智能体、AI 洞察、预测维护、AI RFQ 报价、RAG 知识库、Agent 授权与反馈闭环
- **开放能力**：MCP 协议输出，可被 BYOE / Claude / VS Code 等外部智能体驱动

## 2. 环境要求

| 组件 | 要求 |
|------|------|
| Python | 3.11+ |
| Node.js | 18+（前端构建用） |
| 数据库 | 默认 SQLite（零配置）；生产用 PostgreSQL |
| 浏览器 | 任意现代浏览器（Chrome/Edge/Firefox） |

## 3. 五分钟跑起来

### 3.1 启动后端

```bash
cd backend
pip install -r requirements.txt
python -m uvicorn app.main:app --host 0.0.0.0 --port 8200
```

首次启动自动完成：
- 建表（`Base.metadata.create_all`）
- 写入种子数据（2 个租户、17 台设备、订单/库存/质量/工艺路线/知识库等全量演示数据）
- 启动工厂模拟器（每 45 秒滚动更新遥测/生产记录）

后端地址：`http://localhost:8200`，健康检查：`http://localhost:8200/health`

### 3.2 启动前端（二选一）

**开发模式**（热更新）：

```bash
cd frontend
npm install
npm run dev
```

**生产模式**（构建后静态托管）：

```bash
cd frontend
npm run build
npx serve out -l 3000
```

> 前端通过 `NEXT_PUBLIC_API_URL` 指向后端，默认 `http://localhost:8200`。部署时在 `.env.local` 或构建时设置该变量。

### 3.3 访问系统

浏览器打开 `http://localhost:3000`，使用内置账号登录：

| 账号 | 密码 | 租户 | 角色 | 用途 |
|------|------|------|------|------|
| `admin` | `admin@2026` | DEFAULT | Admin | 管理员，全部功能 |
| `demo` | `demo@2026` | DEMO | Supervisor | 演示账号（独立数据租户） |

## 4. 五分钟演示剧本

系统按产品角度看板 **六大模块** 组织：`总览 / 设计器 / 生产运营 / 分析 / 智能平台 / 系统`。按顺序走一遍即可覆盖主要功能：

1. **总览**：看 OEE、告警、工单、停机概况（入口 `/overview`）
2. **生产运营 → 设备 → 预测维护**：看设备健康评分与风险因素（含 IoT 遥测温度/振动/负载）
3. **智能平台 → AI 助手（Copilot）**：输入「工厂整体状况如何？」？看 AI 自动调用工具回答（需配置 LLM key；未配置则走规则引擎）
4. **智能平台 → 智能体**：点击「运行巡检」，看 5 大 Agent 产出动作（维护/质量/补货/升级/风险），动作库进入授权流程
5. **生产运营 → 物料 → MRP**：查看缺料清单，对动作点击「应用」生成采购/工单
6. **生产运营 → 质量**：查看质检记录、SPC 控制图、NCR 不合格品处置
7. **生产运营 → 物料 → 仓储 WMS**：查看循环盘点与库存流水
8. **系统 → 审计日志 / 事件日志**：查看系统操作留痕

## 5. 启用 AI 智能体（可选但推荐）

未配置 LLM 时，AI 功能自动降级为规则引擎（仍可用，只是不会"思考"）。要启用真实 LLM：

```bash
# 编辑 backend/.env，追加：
AETHON_LLM_API_KEY=sk-xxxx
AETHON_LLM_BASE_URL=https://api.deepseek.com/
AETHON_LLM_MODEL=deepseek-chat
```

支持多 Provider 链式回退（见 [USER_GUIDE.md](USER_GUIDE.md#配置-llm)）。配置后重启后端，Copilot / 巡检 / 编排将使用 `toolchain` 引擎。

## 6. 常见问题

| 现象 | 解决 |
|------|------|
| 前端打不开页面 | 检查后端是否已启动（`/health` 返回 200）；检查 `NEXT_PUBLIC_API_URL` 指向 |
| 登录提示未认证 | token 过期，重新登录即可 |
| 页面显示空数据 | 先确认登录的是有数据的租户（admin=DEFAULT）；演示数据在首次启动自动写入 |
| Copilot 回答像模板 | 未配置 LLM key，当前走规则引擎；配置后自动升级 |
| 端口被占用 | 后端 8200、前端 3000 可改；前端改 `NEXT_PUBLIC_API_URL` 对应 |

## 7. 下一步

- 完整功能手册：[USER_GUIDE.md](USER_GUIDE.md)
- 生产部署：[DEPLOYMENT.md](DEPLOYMENT.md)
- AI/智能体/MCP 深度说明：[USER_GUIDE.md#智能平台](USER_GUIDE.md#智能平台)
