# ai-management

**Repository Path**: webjarry/ai-management

## Basic Information

- **Project Name**: ai-management
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 电商管理后台

基于 LangChain 的智能电商管理后台，支持自然语言查询商品、订单、用户等数据。

## 功能特性

- **AI 智能查询**: 使用自然语言查询电商数据，如"帮我查询近一个月某个产品的销量走势"
- **商品管理**: 商品的增删改查
- **订单管理**: 订单查询、状态更新
- **用户管理**: 用户列表和详情
- **数据可视化**: 查询结果支持图表展示

## 技术栈

- **后端**: FastAPI + SQLAlchemy + PostgreSQL
- **AI**: LangChain + OpenAI GPT-4
- **认证**: JWT Token

## 快速开始

### 1. 环境要求

- Python 3.10+
- PostgreSQL 14+
- OpenAI API Key

### 2. 安装依赖

```bash
cd backend
pip install -r requirements.txt
```

### 3. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env 文件，填入数据库连接信息和 OpenAI API Key
```

### 4. 启动 PostgreSQL (使用 Docker)

```bash
docker run -d \
  --name postgres \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=postgres \
  -e POSTGRES_DB=ai_ecommerce \
  -p 5432:5432 \
  postgres:15
```

### 5. 初始化数据库和种子数据

```bash
cd backend
python -m app.scripts.seed_data
```

### 6. 启动服务

```bash
cd backend
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

### 7. 访问 API 文档

打开浏览器访问: http://localhost:8000/docs

## API 文档

### 认证

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | /api/auth/register | 注册用户 |
| POST | /api/auth/login | 登录获取 Token |

### 商品管理

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/products | 商品列表 |
| POST | /api/products | 创建商品 |
| GET | /api/products/{id} | 商品详情 |
| PUT | /api/products/{id} | 更新商品 |
| DELETE | /api/products/{id} | 删除商品 |

### 订单管理

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/orders | 订单列表 |
| GET | /api/orders/{id} | 订单详情 |
| PUT | /api/orders/{id}/status | 更新订单状态 |

### 用户管理

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/users | 用户列表 |
| GET | /api/users/{id} | 用户详情 |
| POST | /api/users | 创建用户 |

### AI 查询

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | /api/ai/query | 自然语言查询 |
| GET | /api/ai/history | 查询历史 |
| GET | /api/ai/capabilities | 支持的能力列表 |

## AI 查询示例

```
POST /api/ai/query
{
  "question": "近一个月 iPhone 的销量走势"
}
```

## 默认账户

- 用户名: `admin`
- 密码: `admin123`

## 项目结构

```
backend/
├── app/
│   ├── api/          # API 路由
│   ├── core/         # 核心配置
│   ├── models/       # 数据模型
│   ├── schemas/      # Pydantic 模型
│   ├── ai/           # LangChain AI
│   └── main.py       # FastAPI 入口
├── requirements.txt
└── .env.example
```