feat: 完整功能部署 v1.0

新增功能:
- 天网协作系统 (HTTP API 端口 6060)
- 三种工作流 (查找图片/处理图片/转人工派单)
- 图片任务数据库 (支持客户后续增加需求)
- 图绘派单系统集成 (API: 8005)
- 文字检测与加价 (60-80 元高价值订单)
- 风险评估与接单判断
- 作图失败自动转人工

新增文档:
- 项目功能汇总.md
- 三种工作流功能说明.md
- 文字加价功能说明.md
- 风险评估功能说明.md
- 图片任务数据库功能说明.md
- 图绘派单系统集成说明.md
- 作图失败转接人工说明.md
- DEPLOYMENT.md
- TIANWANG_INTEGRATION.md

核心修改:
- core/pydantic_ai_agent.py
- core/workflow.py
- core/websocket_client.py
- image/image_analyzer.py
- services/service_tuhui_dispatch.py
- db/image_tasks_db.py

版本:v1.0
日期:2026-02-28
This commit is contained in:
2026-02-28 11:20:40 +08:00
parent 5aedf1665d
commit a6c42d505a
171 changed files with 7979 additions and 328 deletions

View File

@@ -0,0 +1,247 @@
# 图片任务数据库功能说明
## 📋 功能说明
图片任务现在会保存到 SQLite 数据库,支持:
1. ✅ 任务持久化(重启不丢失)
2. ✅ 客户后续增加需求细节
3. ✅ 需求变更历史记录
4. ✅ 任务状态追踪
---
## 🗄️ 数据库表结构
### 1. image_tasks图片任务表
| 字段 | 类型 | 说明 |
|------|------|------|
| task_id | TEXT | 任务 ID主键 |
| customer_id | TEXT | 客户 ID |
| customer_name | TEXT | 客户名称 |
| original_image | TEXT | 原图 URL |
| operation | TEXT | 操作类型enhance/remove_bg/vectorize |
| requirements | TEXT | 需求 JSON复杂度、比例、透视等 |
| customer_notes | TEXT | 客户备注/需求细节 |
| status | TEXT | 状态pending/paid/processing/completed/failed |
| created_at | TEXT | 创建时间 |
| paid_at | TEXT | 付款时间 |
| started_at | TEXT | 开始处理时间 |
| completed_at | TEXT | 完成时间 |
| result_image | TEXT | 结果图 URL |
| error_message | TEXT | 错误信息 |
| retry_count | INTEGER | 重试次数 |
| acc_id | TEXT | 店铺 ID |
| acc_type | TEXT | 平台类型 |
---
### 2. task_requirement_changes需求变更表
| 字段 | 类型 | 说明 |
|------|------|------|
| id | INTEGER | 自增 ID主键 |
| task_id | TEXT | 任务 ID外键 |
| change_type | TEXT | 变更类型add_note/modify_operation/add_requirement |
| old_value | TEXT | 旧值 |
| new_value | TEXT | 新值 |
| changed_at | TEXT | 变更时间 |
| changed_by | TEXT | 变更者customer/staff |
---
## 🎯 使用场景
### 场景 1客户发送图片创建任务
```python
# AI 识别图片后自动创建
workflow.image_analysis_result(
customer_id="customer_123",
image_url="https://xxx.com/image.jpg",
complexity="normal",
aspect_ratio="1:1",
perspective="no"
)
# 自动保存到数据库
# 任务状态pending待付款
```
---
### 场景 2客户付款开始处理
```python
# 客户付款后
workflow.trigger_processing_on_payment(
customer_id="customer_123"
)
# 任务状态更新pending → paid → processing
```
---
### 场景 3客户增加需求细节
```python
# 客户说:"对了,需要去掉背景"
await workflow.add_customer_requirement(
task_id="TASK_20260227_001",
customer_id="customer_123",
requirement="需要去掉背景"
)
# 数据库记录:
# customer_notes: "[02-27 18:00] 需要去掉背景"
# 任务变更表新增记录
```
---
### 场景 4客户修改操作类型
```python
# 客户说:"改成要分层文件"
await workflow.modify_operation(
task_id="TASK_20260227_001",
customer_id="customer_123",
new_operation="remove_bg_and_layer"
)
# 数据库更新:
# operation: "enhance" → "remove_bg_and_layer"
# 任务变更表新增记录
```
---
### 场景 5查看需求变更历史
```python
# 查看客户修改了哪些需求
history = workflow.get_task_requirement_history("TASK_20260227_001")
# 返回:
# [
# {"change_type": "modify_operation", "old_value": "enhance", "new_value": "remove_bg_and_layer", ...},
# {"change_type": "add_note", "old_value": "无", "new_value": "需要去掉背景", ...}
# ]
```
---
## 🔄 任务状态流转
```
pending待付款
paid已付款
processing处理中
awaiting_confirm待确认
completed已完成
[failed失败] ← 可能失败
```
---
## 📝 API 接口
### 创建任务
```python
workflow.create_image_task(
customer_id="customer_123",
original_image="https://xxx.com/image.jpg",
operation="enhance"
)
```
### 添加需求
```python
await workflow.add_customer_requirement(
task_id="TASK_001",
customer_id="customer_123",
requirement="需要高分辨率"
)
```
### 修改操作
```python
await workflow.modify_operation(
task_id="TASK_001",
customer_id="customer_123",
new_operation="vectorize"
)
```
### 查询任务
```python
task = workflow.get_task("TASK_001")
tasks = workflow.get_customer_tasks("customer_123")
```
### 查询历史
```python
history = workflow.get_task_requirement_history("TASK_001")
```
---
## 🔍 数据库操作
### 查看数据库文件
```bash
sqlite3 /root/ai_customer_service/ai_cs/db/image_tasks.db
```
### 查询所有任务
```sql
SELECT task_id, customer_id, status, created_at FROM image_tasks ORDER BY created_at DESC LIMIT 10;
```
### 查询待处理任务
```sql
SELECT * FROM image_tasks WHERE status='pending';
```
### 查询客户需求变更
```sql
SELECT task_id, change_type, old_value, new_value, changed_at, changed_by
FROM task_requirement_changes
WHERE task_id='TASK_001'
ORDER BY changed_at DESC;
```
---
## ⚠️ 注意事项
1. **任务持久化**:所有任务自动保存到数据库,重启不丢失
2. **需求变更**:客户可以随时增加需求细节(付款前)
3. **操作修改**:付款前可以修改操作类型,付款后不允许
4. **历史记录**:所有变更都有记录,可追溯
5. **状态管理**:任务状态自动流转,无需手动更新
---
## 📊 数据库位置
```
/root/ai_customer_service/ai_cs/db/image_tasks.db
```
数据库管理器:
```
/root/ai_customer_service/ai_cs/db/image_tasks_db.py
```
---
**文档版本**: v1.0
**更新日期**: 2026-02-27