# ecommerce_api

**Repository Path**: Disss44/ecommerce_api

## Basic Information

- **Project Name**: ecommerce_api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: feature/lightweight-mock
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-27
- **Last Updated**: 2025-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎉 电商API项目部署成功！

## 部署概述

项目已成功部署到Docker容器环境中，包含MySQL数据库和FastAPI应用。

## 📊 服务状态

| 服务 | 状态 | 端口 | 健康状态 |
|------|------|------|----------|
| MySQL数据库 | 🟢 运行中 | 8020 | ✅ 健康 |
| API服务 | 🟢 运行中 | 9099 | ✅ 健康 |

## 🔗 访问地址

### 主要入口
- **API文档 (Swagger UI)**: http://localhost:9099/docs
- **健康检查**: http://localhost:9099/health
- **API基础路径**: http://localhost:9099/api/v1

### 数据库
- **MySQL连接**: localhost:8020
- **数据库名**: ecommerce
- **用户名**: ecommerce_user
- **密码**: ecommerce_pass

## 🔐 默认账户

### 管理员账户
```
用户名: admin
密码: admin123
权限: 完整管理员权限
```

### 演示账户
```
用户名: demo
密码: demo123
权限: 普通用户权限
```

## 🛠️ 常用操作命令

### 查看日志
```bash
# 查看所有服务日志
docker compose logs -f

# 查看API日志
docker compose logs -f api

# 查看MySQL日志
docker compose logs -f mysql
```

### 服务管理
```bash
# 停止所有服务
docker compose down

# 重启服务
docker compose restart

# 重启API服务
docker compose restart api

# 重启MySQL服务
docker compose restart mysql
```

### 容器管理
```bash
# 查看容器状态
docker compose ps

# 进入API容器
docker compose exec api bash

# 进入MySQL容器
docker compose exec mysql mysql -u root -p
```

## 📋 API测试指南

### 1. 使用Swagger UI (推荐)
- 访问 http://localhost:9099/docs
- 点击右上角 "Authorize" 按钮
- 输入Bearer Token (通过 `/auth/login` 获取)

### 2. 命令行测试
```bash
# 健康检查
curl http://localhost:9099/health

# 用户登录获取token
curl -X POST http://localhost:9099/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123"}'

# 使用token访问受保护端点
curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://localhost:9099/api/v1/products
```

## 📁 项目结构

```
/opt/ecommerce_api/
├── app/                    # 应用源码
│   ├── api/v1/            # API路由
│   ├── core/              # 核心配置
│   ├── db/                # 数据库相关
│   ├── models/            # 数据模型
│   ├── repositories/      # 数据仓库层
│   └── schemas/           # Pydantic模式
├── tests/                 # 测试文件
├── docker-compose.yml     # Docker编排配置
├── Dockerfile            # Docker镜像配置
└── requirements.txt      # Python依赖
```

## 🎯 下一步操作

1. **测试API**: 访问 http://localhost:9099/docs 体验交互式API文档
2. **查看代码**: 探索 `app/` 目录了解项目架构
3. **运行测试**: 执行 `python -m pytest tests/ -v` 验证功能
4. **开发调试**: 使用 `docker compose logs -f api` 监控实时日志

---

✅ **部署完成！** 项目已准备就绪，可以开始开发和测试！