# abcd

**Repository Path**: brook132525/abcd

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-28
- **Last Updated**: 2025-12-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 二手交易管理平台

基于Django的智能二手交易平台，集成通义千问大模型实现商品性价比分析和个性化推荐。

## 项目特色

- 🤖 **AI智能推荐**: 基于通义千问大模型的商品对比分析系统
- 📊 **性价比分析**: 自动评估商品价格、成色、折扣等多维度指标
- 🔄 **完整闭环**: 实现感知-决策-执行的智能体完整循环
- 📝 **决策可追溯**: 记录AI决策全过程，支持分析和优化
- 💼 **完善的交易系统**: 支持商品发布、交易、消息通知等功能

## 技术栈

- **后端框架**: Django 6.0
- **数据库**: SQLite
- **AI模型**: 通义千问 (通过OpenAI SDK调用)
- **Python版本**: 3.8+

## 快速开始

### 1. 环境准备

```bash
# 克隆项目
cd /root/repo/sofrware-engineering-work

# 创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate

# 安装依赖
pip install -r requirements.txt
```

### 2. 配置环境变量

复制 `.env.example` 为 `.env` 并配置API密钥：

```bash
cp .env.example .env
```

编辑 `.env` 文件，填入你的通义千问API密钥：

```
QWEN_API_KEY=your_actual_api_key_here
QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
QWEN_MODEL=qwen-plus
```

### 3. 初始化数据库

```bash
python manage.py migrate
python manage.py createsuperuser  # 创建管理员账户
```

### 4. 加载测试数据（可选）

```bash
python manage.py shell < scripts/load_sample_data.py
```

### 5. 启动服务

```bash
python manage.py runserver
```

访问 http://127.0.0.1:8000

## 主要功能

### 用户功能
- 用户注册/登录
- 个人信息管理
- 商品收藏

### 商品管理
- 发布二手商品
- 商品浏览和搜索
- 分类筛选
- 价格排序

### AI智能推荐
- 多商品对比选择
- 用户需求描述
- 预算限制设置
- AI分析报告生成
- 推荐结果展示
- 决策过程可视化

### 交易系统
- 创建交易订单
- 交易状态管理
- 买卖双方消息沟通
- 交易历史记录

## 智能体架构

### 感知阶段 (Perception)
- 收集商品基本信息（价格、成色、分类等）
- 整理用户需求和预算限制
- 计算商品折扣率和性价比指标

### 分析阶段 (Analysis)
- 调用通义千问大模型
- 多维度商品对比分析
- 生成详细的推荐理由

### 决策阶段 (Decision)
- 基于置信度阈值判断
- 确定最终推荐商品
- 生成推荐消息

### 执行阶段 (Execution)
- 保存推荐结果
- 记录决策日志
- 返回推荐报告

## 项目结构

```
sofrware-engineering-work/
├── trading_platform/     # Django项目配置
├── users/               # 用户模块
├── goods/               # 商品模块
├── transactions/        # 交易模块
├── ai_agent/           # AI智能体模块
│   ├── models.py       # 数据模型
│   ├── agent.py        # 智能体核心逻辑
│   └── views.py        # 视图函数
├── templates/          # HTML模板
├── static/            # 静态文件
├── media/             # 用户上传文件
└── manage.py          # Django管理脚本
```

## 管理后台

访问 http://127.0.0.1:8000/admin

使用创建的超级用户账号登录，可以管理：
- 用户
- 商品分类和商品
- 交易订单
- AI推荐记录
- 智能体决策日志

## API文档

### AI推荐API

**Endpoint**: `POST /ai/api/recommend/`

**请求体**:
```json
{
  "goods_ids": [1, 2, 3],
  "requirements": "需要轻便的笔记本电脑",
  "budget": 3000
}
```

**响应**:
```json
{
  "success": true,
  "request_id": 1,
  "recommended_goods_id": 2,
  "confidence_score": 0.85,
  "ai_analysis": "详细分析报告..."
}
```

## 开发说明

### 添加测试数据

```python
python manage.py shell

from users.models import User
from goods.models import Category, Goods

# 创建测试分类
category = Category.objects.create(name='电子产品')

# 创建测试商品
goods = Goods.objects.create(
    title='iPhone 13',
    description='九成新',
    category=category,
    price=3999,
    original_price=5999,
    condition='like_new',
    seller=User.objects.first()
)
```

### 运行测试

```bash
python manage.py test
```

## 常见问题

### 1. API密钥配置错误
确保 `.env` 文件中的 `QWEN_API_KEY` 已正确配置。

### 2. 数据库迁移失败
删除 `db.sqlite3` 和所有 `migrations/` 目录下的文件（除了 `__init__.py`），重新运行迁移。

### 3. AI推荐失败
检查网络连接和API密钥，查看错误日志。

## 软件工程要求对照

✅ 面向对象编程（所有模块采用OO设计）  
✅ UML建模（用例图、类图、顺序图）  
✅ 数据持久化（SQLite数据库）  
✅ 智能体闭环（感知-决策-执行完整流程）  
✅ 大模型集成（通义千问API）  
✅ 完整文档（16章实验报告）  
✅ 一键部署（Docker-Compose支持）

## 贡献者

- AI Agent: 智能体模块设计与实现
- 团队成员: 待补充

## 许可证

MIT License

## 联系方式

如有问题，请提交 Issue 或联系项目维护者。