Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

学生论文管理系统

项目介绍

学生论文管理系统是一个基于Django框架开发的Web应用,旨在帮助学校和教师更有效地管理学生的论文和毕业设计相关工作。

主要功能

  • 用户管理:支持管理员、教师和学生三种角色
  • 课题管理:教师可以添加、编辑和管理课题
  • 论文管理:学生可以上传论文,教师可以查看和管理学生论文
  • 用户认证:基于Django的认证系统,支持登录和权限控制
  • 个人资料管理:用户可以查看和编辑个人信息

技术栈

  • 后端:Python 3.12, Django 5.2.8
  • 数据库:MySQL
  • 前端:HTML, CSS, JavaScript
  • 静态文件:自定义CSS和JavaScript

项目结构

xilc_bs_web/
├── users/              # 主要应用
│   ├── static/         # 静态文件
│   │   ├── css/        # CSS文件
│   │   └── js/         # JavaScript文件
│   ├── templates/      # 模板文件
│   │   ├── admin/      # 管理员模板
│   │   ├── student/    # 学生模板
│   │   └── teacher/    # 教师模板
│   ├── migrations/     # 数据库迁移文件
│   ├── models.py       # 数据模型
│   ├── views.py        # 视图函数
│   ├── urls.py         # URL配置
│   └── admin.py        # 后台管理配置
├── xilc_bs_web/        # 项目配置
│   ├── settings.py     # 项目设置
│   ├── urls.py         # 项目URL配置
│   └── wsgi.py         # WSGI配置
├── manage.py           # 管理脚本
└── db.sqlite3          # SQLite数据库文件(开发环境)

快速开始

环境要求

  • Python 3.12+
  • MySQL 5.7+
  • Django 5.2.8+

安装步骤

  1. 克隆项目

    git clone https://github.com/xingchen-026/python-web-.git
    cd python-web-
  2. 创建虚拟环境

    python -m venv venv
    # Windows
    venv\Scripts\activate
    # Linux/Mac
    source venv/bin/activate
  3. 安装依赖

    pip install django mysqlclient
  4. 配置数据库

    修改 xilc_bs_web/settings.py 文件中的数据库配置:

    DATABASES = {
        "default": {
            "ENGINE": "django.db.backends.mysql",
            "NAME": "tesk",  # 数据库名称
            "USER": "root",  # 数据库用户名
            "PASSWORD": "041026",  # 数据库密码
            "HOST": "127.0.0.1",  # 数据库主机
            "PORT": "3306",  # 数据库端口
            "OPTIONS": {
                'autocommit': True,
            },
        }
    }
  5. 运行数据库迁移

    python manage.py migrate
  6. 创建超级用户

    python manage.py createsuperuser
  7. 启动开发服务器

    python manage.py runserver

    然后访问 http://127.0.0.1:8000/ 即可进入系统。

角色说明

管理员

  • 管理所有用户(添加、编辑、删除)
  • 查看所有课题和论文
  • 系统设置和配置

教师

  • 管理自己的课题(添加、编辑、删除)
  • 查看和管理自己学生的论文
  • 查看学生信息

学生

  • 查看和选择课题
  • 上传和管理自己的论文
  • 查看个人信息

核心功能模块

1. 用户认证模块

  • 登录/登出功能
  • 基于角色的权限控制
  • 密码重置功能

2. 课题管理模块

  • 课题的CRUD操作
  • 课题状态管理
  • 课题分配功能

3. 论文管理模块

  • 论文上传和下载
  • 论文状态跟踪
  • 论文评价功能

4. 用户管理模块

  • 用户信息管理
  • 角色分配
  • 用户状态管理

配置说明

主要配置文件

  • settings.py:项目的主要配置文件,包含数据库配置、应用配置、静态文件配置等
  • urls.py:URL路由配置
  • models.py:数据模型定义

关键配置项

  • AUTH_USER_MODEL:自定义用户模型配置
  • STATICFILES_DIRS:静态文件目录配置
  • LOGIN_URL:登录URL配置
  • DATABASES:数据库连接配置

开发指南

代码规范

  • 遵循Django代码规范
  • 前端代码分离:HTML代码放到templates目录下,CSS代码放到static/css目录下,js代码放到static/js目录下
  • 命名规范:使用清晰、有意义的命名

开发流程

  1. 创建新功能分支
  2. 实现功能
  3. 运行测试
  4. 提交代码
  5. 合并到主分支

测试

运行测试

python manage.py test

测试覆盖范围

  • 模型测试
  • 视图测试
  • 表单测试
  • 权限测试

部署

生产环境部署

  1. 配置生产环境设置

    修改 settings.py 文件:

    DEBUG = False
    ALLOWED_HOSTS = ['your-domain.com']
  2. 收集静态文件

    python manage.py collectstatic
  3. 使用Gunicorn作为WSGI服务器

    pip install gunicorn
    gunicorn xilc_bs_web.wsgi:application
  4. 使用Nginx作为反向代理

    配置Nginx:

    server {
        listen 80;
        server_name your-domain.com;
    
        location / {
            proxy_pass http://127.0.0.1:8000;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    
        location /static/ {
            alias /path/to/project/staticfiles/;
        }
    }

注意事项

  • 本系统使用MySQL数据库,需要确保MySQL服务正常运行
  • 开发环境下使用SQLite数据库,生产环境请使用MySQL
  • 系统默认使用中文界面,如需修改语言请修改 settings.py 中的 LANGUAGE_CODE 配置
  • 系统默认时区为上海,如需修改请修改 settings.py 中的 TIME_ZONE 配置

许可证

本项目采用MIT许可证。

联系方式

如有问题或建议,请联系:

版本历史

  • v1.0.0:初始版本,实现了基本功能

感谢使用学生论文管理系统!

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages