纺织品表面缺陷检测API系统

基于AI的智能纺织品质量检测解决方案

v1.0.0

🚀 快速开始

快速了解系统功能,开始使用API接口进行纺织品缺陷检测。

📚 API文档

查看完整的API接口文档,了解所有可用的端点和参数。

🤖 AI智慧查询

使用自然语言查询系统数据,支持多种响应类型和对话管理。集成DeepSeek AI和Vanna.ai,实现智能意图分析和Text-to-SQL转换。

新功能
查看文档

✨ 核心功能模块

📦
ZIP文件上传
批量上传图片进行检测
🧵
布料任务管理
任务创建、查询、状态跟踪
🔍
缺陷类型管理
缺陷类型定义和配置
🤖
检测模型管理
AI模型配置和版本管理
💬
AI智慧查询
自然语言查询,支持多轮对话和澄清
🏭
机台管理
机台信息配置和管理
📊
操作日志
用户操作记录和审计
🔔
实时通知
WebSocket实时消息推送
🔐
权限管理
基于角色的访问控制

🔗 主要API接口

POST /api/v1/smartQuery/query
🤖 AI智慧查询 - 使用自然语言查询系统数据,支持KPI卡片、表格、图表等多种响应类型
POST /api/v1/smartQuery/clarify
💬 澄清查询 - 处理多轮对话中的参数补充
GET /api/v1/smartQuery/conversations
📜 对话历史 - 查询用户的历史查询记录
POST /api/v1/uploadImagesZip
📦 ZIP文件上传 - 批量上传图片进行检测
POST /api/v1/fabricTask
➕ 创建任务 - 创建新的检测任务
GET /api/v1/fabricTask
🧵 任务列表 - 查询检测任务列表(支持分页和筛选)
GET /api/v1/fabricTask/{id}
📋 任务详情 - 获取任务详细信息和检测结果
PUT /api/v1/fabricTask/{id}
✏️ 更新任务 - 更新任务信息或状态
POST /api/v1/fabricType
➕ 创建布料类型 - 创建新的布料类型
GET /api/v1/fabricType
🧵 布料类型列表 - 获取布料类型列表和管理
POST /api/v1/fabricReference
➕ 创建布料参考 - 创建新的布料参考
GET /api/v1/fabricReference
📎 布料参考列表 - 获取布料参考信息
POST /api/v1/defectType
➕ 创建缺陷类型 - 创建新的缺陷类型
GET /api/v1/defectType
🔍 缺陷类型列表 - 获取所有缺陷类型和管理
POST /api/v1/models
🤖 创建模型 - 创建新的AI检测模型
GET /api/v1/models
🤖 模型列表 - 获取可用AI模型列表
POST /api/v1/machines
➕ 创建机台 - 创建新的机台
GET /api/v1/machines
🏭 机台列表 - 获取和管理机台信息
GET /api/v1/userOperationLog
📊 操作日志 - 查询用户操作记录和审计(支持分页和筛选)
POST /api/v1/smartQuery/templates
📝 创建查询模板 - 创建AI智慧查询模板
GET /api/v1/smartQuery/templates
📋 查询模板列表 - 获取所有查询模板
GET /api/v1/smartQuery/statistics
📈 查询统计 - 获取AI智慧查询使用统计
POST /api/v1/ocr
🔤 OCR识别 - 图片文字识别
GET /api/v1/system/status
💚 系统状态 - 获取系统运行状态和统计
GET /api/v1/health
🏥 健康检查 - 检查服务健康状态
GET /ws/stats
🔌 WebSocket - 实时任务状态推送

🏗️ 系统架构

系统采用现代化的混合部署架构,支持高效的本地开发和生产部署:

💡 技术栈

Python 3.12 FastAPI Celery PostgreSQL Redis RabbitMQ Azure Blob Storage WebSocket YOLOv8 DeepSeek AI Vanna.ai Docker Azure Container Apps

🤔 需要澄清