# 新材料数据库系统

## 项目简介
新材料数据库管理系统是一个基于 Django + Vue3 的前后端分离系统，用于管理工厂、材料信息和数据字典，并提供数据大屏展示功能。

## 技术栈
- 后端：Python 3.9+ + Django 4.2 + Django REST Framework + JWT
- 数据库：PostgreSQL 14+
- 前端：Vue 3 + Vite + Element Plus + ECharts 5

## 项目结构
```
mat/
├── backend/                    # 后端项目
│   ├── config/                # 项目配置
│   │   ├── __init__.py
│   │   ├── settings.py        # 主配置文件
│   │   ├── urls.py            # 主路由
│   │   ├── wsgi.py
│   │   └── asgi.py
│   ├── apps/                  # 应用目录
│   │   ├── authentication/    # 认证应用
│   │   │   ├── __init__.py
│   │   │   ├── models.py      # 用户模型
│   │   │   ├── serializers.py
│   │   │   ├── views.py
│   │   │   └── urls.py
│   │   ├── factory/           # 工厂管理
│   │   │   ├── __init__.py
│   │   │   ├── models.py
│   │   │   ├── serializers.py
│   │   │   ├── views.py
│   │   │   └── urls.py
│   │   ├── material/          # 材料管理
│   │   │   ├── __init__.py
│   │   │   ├── models.py
│   │   │   ├── serializers.py
│   │   │   ├── views.py
│   │   │   └── urls.py
│   │   ├── dictionary/        # 数据字典
│   │   │   ├── __init__.py
│   │   │   ├── models.py
│   │   │   ├── serializers.py
│   │   │   ├── views.py
│   │   │   └── urls.py
│   │   └── statistics/        # 统计分析
│   │       ├── __init__.py
│   │       ├── views.py
│   │       └── urls.py
│   ├── media/                 # 媒体文件
│   ├── manage.py
│   └── requirements.txt
└── frontend/                   # 前端项目
    ├── public/
    ├── src/
    │   ├── api/              # API接口
    │   │   ├── auth.js
    │   │   ├── factory.js
    │   │   ├── material.js
    │   │   ├── dictionary.js
    │   │   └── statistics.js
    │   ├── assets/           # 静态资源
    │   ├── components/       # 公共组件
    │   │   ├── common/
    │   │   └── charts/       # 图表组件
    │   ├── layouts/          # 布局组件
    │   ├── router/           # 路由配置
    │   ├── stores/           # 状态管理
    │   ├── utils/            # 工具函数
    │   ├── views/            # 页面视图
    │   │   ├── auth/         # 认证相关
    │   │   ├── user/         # 用户管理
    │   │   ├── factory/      # 工厂管理
    │   │   ├── material/     # 材料管理
    │   │   ├── dictionary/   # 字典管理
    │   │   └── dashboard/    # 数据大屏
    │   │       ├── Overview.vue
    │   │       ├── MaterialLibrary.vue
    │   │       └── FactoryLibrary.vue
    │   ├── App.vue
    │   └── main.js
    ├── .env.development
    ├── .env.production
    ├── index.html
    ├── package.json
    └── vite.config.js
```

## 功能模块

### 1. 用户管理
- 管理员可以创建普通用户并分配工厂
- 普通用户可以登录系统

### 2. 工厂管理
- 管理员可以创建和管理工厂信息
- 普通用户可以完善所属工厂信息

### 3. 材料管理
- 管理员可以管理所有材料
- 普通用户可以录入材料并提交审核
- 支持材料审核流程（创建中、待审核、已审核）

### 4. 数据字典管理
- 管理员可以管理数据字典
- 支持字典类型、名称和值的管理

### 5. 数据大屏（仅管理员可见）
- 数据总览：展示材料总数、种类、品牌数等统计信息
- 材料库：展示材料星级对比、竞争优势、应用场景等图表
- 工厂库：展示工厂地区分布、材料分类分布等图表
- 数据每10秒自动刷新

## 数据库设计

### 1. 工厂表 (factory)
- id: 主键
- dealer_name: 经销商名称
- product_category: 产品分类
- factory_name: 生产工厂全称
- factory_short_name: 工厂简称
- province: 省
- city: 市
- district: 区
- address: 详细地址
- website: 官网链接
- created_at: 创建时间
- updated_at: 更新时间

### 2. 材料表 (material)
- id: 主键
- name: 材料名称
- major_category: 专业类别
- material_category: 材料分类
- material_subcategory: 材料子分类
- spec: 规格型号
- standard: 符合标准
- application_scene: 应用场景
- application_desc: 应用场景说明
- replace_type: 替代材料类型
- advantage: 竞争优势
- advantage_desc: 优势说明
- cost_compare: 成本对比百分数
- cost_desc: 成本说明
- cases: 案例
- brochure: 宣传页图片
- quality_level: 质量提升等级
- durability_level: 耐久可靠等级
- eco_level: 环保健康等级
- carbon_level: 循环低碳等级
- score_level: 总评分等级
- connection_method: 连接方式
- construction_method: 施工工艺
- limit_condition: 限制条件
- factory_id: 所属工厂
- status: 状态（draft/pending/approved）

### 3. 数据字典 (dictionary)
- id: 主键
- type: 字典类型
- name: 字典名称
- value: 字典值

## 部署说明

### 后端部署
1. 安装依赖：
```bash
cd backend
pip install -r requirements.txt
```

2. 配置数据库：
修改 `config/settings.py` 中的数据库配置

3. 初始化数据库：
```bash
python manage.py makemigrations
python manage.py migrate
```

4. 创建超级用户：
```bash
python manage.py createsuperuser
```

5. 启动服务：
```bash
python manage.py runserver
```

### 前端部署
1. 安装依赖：
```bash
cd frontend
npm install
```

2. 配置环境变量：
修改 `.env.development` 和 `.env.production` 文件

3. 启动开发服务器：
```bash
npm run dev
```

4. 构建生产版本：
```bash
npm run build
```

## API接口文档

### 认证接口
- POST /api/auth/login/ - 用户登录
- POST /api/auth/logout/ - 用户登出
- GET /api/auth/user/ - 获取当前用户信息

### 工厂接口
- GET /api/factory/ - 获取工厂列表
- POST /api/factory/ - 创建工厂
- GET /api/factory/{id}/ - 获取工厂详情
- PUT /api/factory/{id}/ - 更新工厂信息
- DELETE /api/factory/{id}/ - 删除工厂

### 材料接口
- GET /api/material/ - 获取材料列表
- POST /api/material/ - 创建材料
- GET /api/material/{id}/ - 获取材料详情
- PUT /api/material/{id}/ - 更新材料信息
- DELETE /api/material/{id}/ - 删除材料
- POST /api/material/{id}/submit/ - 提交审核
- POST /api/material/{id}/approve/ - 审核通过
- POST /api/material/{id}/reject/ - 审核拒绝

### 统计接口
- GET /api/statistics/overview/ - 数据总览
- GET /api/statistics/materials/ - 材料统计
- GET /api/statistics/factories/ - 工厂统计

### 字典接口
- GET /api/dictionary/ - 获取字典列表
- POST /api/dictionary/ - 创建字典
- GET /api/dictionary/{id}/ - 获取字典详情
- PUT /api/dictionary/{id}/ - 更新字典
- DELETE /api/dictionary/{id}/ - 删除字典