# DjangoProject

**Repository Path**: complexshao/django-project

## Basic Information

- **Project Name**: DjangoProject
- **Description**: 阀门生命周期信息管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-17
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 阀门生命周期管理系统

一个基于Django 5.2.8开发的阀门全生命周期管理系统，用于管理阀门信息、维护记录、备件库存和相关文档。

## 快速开始

### 前置要求
- Python 3.11+
- MySQL 5.7+

### 一键启动（推荐）

**Linux/macOS:**
```bash
./start.sh
```

**Windows:**
```cmd
start.bat
```

### 手动启动

1. **安装依赖**
```bash
pip install -r requirements.txt
```

2. **配置数据库**

编辑 `DjangoProject/settings.py`，修改数据库配置：
```python
DATABASES = {
    'default': {
        'NAME': 'valve_management',
        'USER': 'root',          # 你的MySQL用户名
        'PASSWORD': '123456',    # 你的MySQL密码
        'HOST': 'localhost',
        'PORT': '3306',
    }
}
```

3. **创建数据库**
```sql
CREATE DATABASE valve_management CHARACTER SET utf8mb4;
```

4. **运行迁移**
```bash
python manage.py migrate
```

5. **创建管理员**
```bash
python manage.py createsuperuser
```

6. **启动服务器**
```bash
python manage.py runserver
```

7. **访问系统**

打开浏览器访问: http://127.0.0.1:8000/

## 功能模块

- **用户认证** - 登录/登出功能，保护所有页面
- **首页** - 系统概览和统计信息
- **阀门管理** - 阀门信息的增删改查
- **维护记录** - 记录阀门维护操作历史
- **备件管理** - 备件库存管理，低库存预警
- **文档附件** - 阀门相关文档管理

## 默认测试账号

如果使用快速启动脚本，可以创建自己的管理员账号。

## 技术栈

- **后端框架**: Django 5.2.8
- **数据库**: MySQL (pymysql)
- **前端框架**: Bootstrap 5.3.0
- **图标库**: Bootstrap Icons 1.10.0

## 项目结构

```
DjangoProject/
├── DjangoProject/              # 项目配置
│   ├── settings.py            # 设置文件（包含数据库配置）
│   └── urls.py                # 根URL配置
├── ValveLifecycleManager/      # 主应用
│   ├── models.py              # 数据模型
│   ├── views.py               # 视图函数
│   ├── urls.py                # 应用URL
│   └── forms.py               # 表单定义
├── templates/                  # 模板文件
│   ├── registration/          # 登录模板
│   └── ValveLifecycleManager/ # 应用模板
├── requirements.txt           # Python依赖
├── DEPLOYMENT.md             # 完整部署文档
├── start.sh                  # Linux/macOS启动脚本
├── start.bat                 # Windows启动脚本
└── README.md                 # 本文件
```

## 详细文档

查看 [DEPLOYMENT.md](DEPLOYMENT.md) 获取完整的部署和配置指南。

## 常见问题

### Q: 启动失败，提示MySQL连接错误？
A: 检查MySQL服务是否运行，并确认 `settings.py` 中的数据库配置正确。

### Q: 提示cryptography包错误？
A: 运行 `pip install cryptography`

### Q: 登出按钮无效？
A: 项目已修复此问题，确保使用最新版本的 `base.html` 模板。

### Q: 需要从其他设备访问？
A: 使用 `python manage.py runserver 0.0.0.0:8000` 启动，并在 `settings.py` 中添加服务器IP到 `ALLOWED_HOSTS`。

## 更新日志

- **2025-11-20**
  - ✅ 添加用户登录认证功能
  - ✅ 修复登出功能（POST方法）
  - ✅ 创建部署文档和启动脚本
  - ✅ 保护所有页面，要求登录访问

## 许可证

本项目仅供学习和内部使用。

## 支持

如遇问题，请查看 [DEPLOYMENT.md](DEPLOYMENT.md) 中的"常见问题"章节。