# xwsbxt

**Repository Path**: king_nd/xwsbxt

## Basic Information

- **Project Name**: xwsbxt
- **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-29
- **Last Updated**: 2026-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 玄武守备系统 (Xuanwu Defense System)

## 项目简介
本项目旨在构建一个轻量级、高效的售后交付管理系统，涵盖基础管理、售后项目管理、项目工单管理三大核心模块，并提供数据可视化大屏支持。

## 技术栈

### 前端 (Frontend)
- **核心框架**: Vue 3 + Vite
- **UI 组件库**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router

### 后端 (Backend)
- **核心框架**: FastAPI (Python)
- **ORM**: SQLModel (SQLAlchemy)
- **数据库**: MySQL (兼容 PostgreSQL/人大金仓)
- **对象存储**: MinIO

## 快速开始

### 1. 环境准备
- Node.js (v16+)
- Python (v3.10+)
- MySQL (已配置)
- MinIO (已配置)

### 2. 启动后端

```bash
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
```
后端启动后，会自动检查并创建数据库 `ywxt` 以及相关数据表。
API 文档地址: `http://localhost:8000/docs`

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev
```
前端访问地址: `http://localhost:5173`

## 配置信息

后端配置位于 `backend/app/core/config.py`。
默认配置已适配当前开发环境：
- MySQL: 10.168.2.12:3306 (user: root)
- MinIO: 10.168.2.12:9000