# 湾豚工单系统V2

**Repository Path**: monox-zhihao/monox_WorldOrder-system-v2

## Basic Information

- **Project Name**: 湾豚工单系统V2
- **Description**: 湾豚工单系统V2，工作订单
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2024-11-20
- **Last Updated**: 2025-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 湾豚工单系统 V2
湾豚工单系统是一个基于 FastAPI 的工单管理平台，支持创建、分派、关闭、查询工单，以及基于前端分页的可视化操作。适用于企业内部任务分配及进度跟踪。

### 功能特性


### 后端功能

● 创建工单：新增任务工单，并保存到数据库。

● 分派工单：将工单分配给指定负责人，更新状态为处理中。

● 关闭工单：标记工单为已完成，更新状态为关闭。

● 查询工单：

  ○ 支持按状态分页查询（如全部、已提交、处理中、已关闭）。

  ○ 查看单个工单详情。

● 配置化数据库连接：通过 config.json 配置数据库参数。

● API 文档：基于 Swagger 的自动化接口文档，访问路径 /docs。

### 前端功能

● 工单管理页面：基于 Bootstrap 构建的用户界面。

● 创建工单表单：通过模态框输入信息创建新工单。

● 动态分页：支持上一页、下一页及页码选择的分页功能。

● 状态过滤：通过下拉框筛选工单状态（如处理中、已关闭等）。

● 操作按钮：查看详情、分派负责人、关闭工单等。

### 技术栈

● 后端：FastAPI、PyMySQL

● 前端：HTML、JavaScript、Bootstrap 5

● 数据库：MySQL

### 快速开始

### 环境要求

Python 3.8+

MySQL 5.7+ 或 MariaDB

推荐使用 uvicorn 作为开发和部署服务器。

本地运行步骤

1 克隆仓库


```
git clone https://github.com/your-repo/monox-order-system.git
cd monox-order-system
```
2 安装依赖
```
pip install -r requirements.txt
```
3 配置数据库 创建数据库并导入 tickets 表（SQL 脚本参考下面的数据库设计）。
编辑 config.json 文件：

```
{
    "db_config": {
        "host": "localhost",
        "user": "root",
        "password": "yourpassword",
        "database": "yourdatabase"
    }
}
```
4 运行后端服务

```
uvicorn monox_WorldOrder:app --reload
```
5 访问前端 在浏览器中打开 http://127.0.0.1:8000/static/index.html。

访问 API 文档 在浏览器中打开 http://127.0.0.1:8000/docs。

### 数据库设计

示例 tickets 表结构：

```
CREATE TABLE tickets (
    id INT AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    description TEXT NOT NULL,
    submitter VARCHAR(100) NOT NULL,
    assignee VARCHAR(100),
    status ENUM('open', 'in_progress', 'closed') NOT NULL DEFAULT 'open',
    f_create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    f_update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);
```
### 项目目录结构

```
monox-order-system/
├── monox_WorldOrder.py    # 后端主文件
├── static/                # 前端静态资源目录
│   └── index.html         # 前端页面
├── config.json            # 数据库配置文件
├── requirements.txt       # 项目依赖文件
└── README.md              # 项目说明文件
```
### API 路由
| 方法   | 路由                  | 描述       |
|------|---------------------|----------|
| POST | /create_ticket      | 创建工单     |
| POST | /assign_ticket      | 分派工单     |
| POST | /close_ticket       | 关闭工单     |
| GET  | /tickets            | 获取所有工单   |
| GET  | /tickets_paginated  | 分页获取工单   |
| GET  | /ticket/{ticket_id} | 获取单个工单详情 |
### 贡献

欢迎提交 issue 和 pull request，改进功能或修复 bug。

### 开源协议

MIT License