flashexam 2.0.1__py3-none-any.whl

flashexam/__init__.py

@@ -0,0 +1,198 @@
+"""FlashExam - Intelligent Online Examination System with AI Grading."""
+
+__version__ = "2.0.1"
+
+from flask import Flask
+from flask_login import LoginManager
+from flask_session import Session
+import os
+import sys
+from datetime import timedelta
+import json
+import time
+
+current_dir = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, current_dir)
+
+try:
+    import psutil
+    PSUTIL_AVAILABLE = True
+except ImportError:
+    PSUTIL_AVAILABLE = False
+    print("[WARNING] psutil未安装，将使用模拟数据")
+
+_app_start_time = time.time()
+_request_count = 0
+_active_connections = 0
+
+def load_development_config(app, static_folder):
+    """加载开发环境配置"""
+    app.config.update({
+        'SECRET_KEY': os.environ.get('SECRET_KEY') or 'flashexam-dev-key-2024',
+        'UPLOAD_FOLDER': os.path.join(static_folder, 'uploads'),
+        'MAX_CONTENT_LENGTH': 16 * 1024 * 1024,
+        'TEMPLATES_AUTO_RELOAD': True,
+        'JSON_AS_ASCII': False,
+        'DEBUG': True
+    })
+
+def load_production_config(app, static_folder):
+    """加载生产环境配置"""
+    is_https = os.environ.get('HTTPS', '').lower() in ('1', 'true', 'on')
+    
+    app.config.update({
+        'SECRET_KEY': os.environ.get('SECRET_KEY') or 'flashexam-prod-key-2024',
+        'UPLOAD_FOLDER': os.path.join(static_folder, 'uploads'),
+        'MAX_CONTENT_LENGTH': 32 * 1024 * 1024,
+        'TEMPLATES_AUTO_RELOAD': False,
+        'JSON_AS_ASCII': False,
+        'SEND_FILE_MAX_AGE_DEFAULT': 43200,
+        'SESSION_COOKIE_SECURE': is_https,
+        'SESSION_COOKIE_HTTPONLY': True,
+        'SESSION_COOKIE_SAMESITE': 'Lax',
+        'DEBUG': False
+    })
+
+def load_high_performance_config(app, static_folder):
+    """加载高性能环境配置"""
+    is_https = os.environ.get('HTTPS', '').lower() in ('1', 'true', 'on')
+    
+    app.config.update({
+        'SECRET_KEY': os.environ.get('SECRET_KEY') or 'flashexam-hp-key-2024',
+        'UPLOAD_FOLDER': os.path.join(static_folder, 'uploads'),
+        'MAX_CONTENT_LENGTH': 64 * 1024 * 1024,
+        'TEMPLATES_AUTO_RELOAD': False,
+        'JSON_AS_ASCII': False,
+        'SEND_FILE_MAX_AGE_DEFAULT': 86400,
+        'SESSION_COOKIE_SECURE': is_https,
+        'SESSION_COOKIE_HTTPONLY': True,
+        'SESSION_COOKIE_SAMESITE': 'Lax',
+        'PERMANENT_SESSION_LIFETIME': timedelta(hours=8),
+        'DEBUG': False
+    })
+
+def create_app(config_name='development'):
+    """
+    Flask应用工厂函数
+    支持多种配置模式：development, production, high-performance
+    """
+    template_folder = os.path.join(os.path.dirname(__file__), 'templates')
+    static_folder = os.path.join(os.path.dirname(__file__), 'static')
+    
+    app = Flask(__name__, 
+                template_folder=template_folder,
+                static_folder=static_folder)
+    
+    if config_name == 'production':
+        load_production_config(app, static_folder)
+    elif config_name == 'high-performance':
+        load_high_performance_config(app, static_folder)
+    else:
+        load_development_config(app, static_folder)
+    
+    app.config['SESSION_TYPE'] = 'filesystem'
+    app.config['SESSION_PERMANENT'] = True
+    if 'PERMANENT_SESSION_LIFETIME' not in app.config:
+        app.config['PERMANENT_SESSION_LIFETIME'] = timedelta(hours=24)
+    app.config['SESSION_USE_SIGNER'] = True
+    app.config['SESSION_KEY_PREFIX'] = 'flashexam:'
+    app.config['SESSION_FILE_DIR'] = os.path.join(os.path.dirname(__file__), 'storage', 'sessions')
+    app.config['DATABASE_PATH'] = os.path.join(os.path.dirname(__file__), 'storage', 'exam_database.db')
+    
+    Session(app)
+    
+    login_manager = LoginManager()
+    login_manager.init_app(app)
+    login_manager.login_view = 'auth.login'
+    login_manager.login_message = '请先登录系统'
+    login_manager.login_message_category = 'warning'
+    
+    app.jinja_env.globals['hasattr'] = hasattr
+    
+    @app.before_request
+    def before_request():
+        global _request_count, _active_connections
+        _request_count += 1
+        _active_connections += 1
+    
+    @app.after_request
+    def after_request(response):
+        global _active_connections
+        _active_connections = max(0, _active_connections - 1)
+        return response
+    
+    @app.template_filter('from_json')
+    def from_json_filter(value):
+        try:
+            if isinstance(value, str):
+                return json.loads(value)
+            return value
+        except (json.JSONDecodeError, TypeError):
+            return []
+    
+    @app.template_filter('rjust')
+    def rjust_filter(value, width, fillchar=' '):
+        try:
+            return str(value).rjust(int(width), str(fillchar))
+        except (ValueError, TypeError):
+            return str(value)
+    
+    @app.template_filter('ljust')
+    def ljust_filter(value, width, fillchar=' '):
+        try:
+            return str(value).ljust(int(width), str(fillchar))
+        except (ValueError, TypeError):
+            return str(value)
+    
+    @app.template_filter('zfill')
+    def zfill_filter(value, width):
+        try:
+            return str(value).zfill(int(width))
+        except (ValueError, TypeError):
+            return str(value)
+    
+    @login_manager.user_loader
+    def load_user(user_id):
+        from .user import User
+        return User.get_by_id(user_id)
+    
+    from .auth import auth_bp
+    from .teacher import teacher_bp
+    from .student import student_bp
+    from .api import api_bp
+    from .main import main_bp
+    from .admin import admin_bp
+    
+    app.register_blueprint(auth_bp, url_prefix='/auth')
+    app.register_blueprint(teacher_bp, url_prefix='/teacher')
+    app.register_blueprint(student_bp, url_prefix='/student')
+    app.register_blueprint(api_bp, url_prefix='/api')
+    app.register_blueprint(main_bp)
+    app.register_blueprint(admin_bp, url_prefix='/admin')
+    
+    os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
+    os.makedirs(app.config['SESSION_FILE_DIR'], exist_ok=True)
+    
+    @app.errorhandler(404)
+    def not_found_error(error):
+        try:
+            from flask import render_template
+            return render_template('errors/404.html'), 404
+        except:
+            return '<h1>404 - 页面不存在</h1><p>抱歉，您访问的页面不存在。</p><a href="/">返回首页</a>', 404
+
+    @app.errorhandler(500)
+    def internal_error(error):
+        try:
+            from flask import render_template
+            return render_template('errors/500.html'), 500
+        except:
+            return '<h1>500 - 服务器错误</h1><p>抱歉，服务器遇到了错误。</p><a href="/">返回首页</a>', 500
+    
+    print("[SUCCESS] FlashExam 初始化完成")
+    return app
+
+__all__ = [
+    "__version__",
+    "create_app",
+]

flashexam/admin.py

@@ -0,0 +1,198 @@
+"""
+管理员管理模块
+提供教师账户管理和系统管理功能
+"""
+
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify
+from flask_login import login_required, current_user
+import os
+from datetime import datetime
+
+from .database import Database
+
+admin_bp = Blueprint('admin', __name__)
+
+def require_admin():
+    """检查是否为管理员（教师角色）"""
+    if not current_user.is_authenticated or not current_user.is_teacher():
+        return False
+    return True
+
+@admin_bp.route('/')
+@login_required
+def index():
+    """管理面板首页"""
+    if not require_admin():
+        flash('需要管理员权限', 'error')
+        return redirect(url_for('auth.login'))
+    
+    db = Database()
+    
+    stats = {
+        'total_students': len(db.get_all_students()),
+        'total_exams': len(db.get_exams()),
+        'active_exams': len([e for e in db.get_exams() if e.is_active]),
+        'total_questions': len(db.get_questions())
+    }
+    
+    return render_template('admin/index.html', stats=stats)
+
+@admin_bp.route('/teachers')
+@login_required
+def teachers():
+    """教师账户列表"""
+    if not require_admin():
+        return jsonify({'success': False, 'message': '需要管理员权限'}), 403
+    
+    db = Database()
+    
+    return render_template('admin/teachers.html')
+
+@admin_bp.route('/teachers/add', methods=['POST'])
+@login_required
+def add_teacher():
+    """添加教师账户"""
+    if not require_admin():
+        return jsonify({'success': False, 'message': '需要管理员权限'}), 403
+    
+    try:
+        data = request.get_json() if request.is_json else request.form
+        username = data.get('username', '').strip()
+        password = data.get('password', '').strip()
+        name = data.get('name', '').strip()
+        email = data.get('email', '').strip()
+        
+        if not all([username, password, name]):
+            return jsonify({'success': False, 'message': '请填写所有必填字段'}), 400
+        
+        if len(password) < 6:
+            return jsonify({'success': False, 'message': '密码长度至少6位'}), 400
+        
+        db = Database()
+        
+        if db.get_teacher_info(username):
+            return jsonify({'success': False, 'message': '用户名已存在'}), 400
+        
+        success = db.set_teacher_password(username, password, name, email)
+        
+        if success:
+            return jsonify({'success': True, 'message': '教师账户添加成功'})
+        else:
+            return jsonify({'success': False, 'message': '添加失败，请重试'}), 500
+            
+    except Exception as e:
+        return jsonify({'success': False, 'message': str(e)}), 500
+
+@admin_bp.route('/teachers/<username>/password', methods=['PUT'])
+@login_required
+def update_teacher_password(username):
+    """更新教师密码"""
+    if not require_admin():
+        return jsonify({'success': False, 'message': '需要管理员权限'}), 403
+    
+    try:
+        data = request.get_json()
+        new_password = data.get('new_password', '').strip()
+        
+        if not new_password:
+            return jsonify({'success': False, 'message': '新密码不能为空'}), 400
+        
+        if len(new_password) < 6:
+            return jsonify({'success': False, 'message': '密码长度至少6位'}), 400
+        
+        db = Database()
+        
+        if not db.get_teacher_info(username):
+            return jsonify({'success': False, 'message': '用户不存在'}), 404
+        
+        success = db.update_teacher_password(username, new_password)
+        
+        if success:
+            return jsonify({'success': True, 'message': '密码更新成功'})
+        else:
+            return jsonify({'success': False, 'message': '更新失败，请重试'}), 500
+            
+    except Exception as e:
+        return jsonify({'success': False, 'message': str(e)}), 500
+
+@admin_bp.route('/students')
+@login_required
+def manage_students():
+    """学生管理页面"""
+    if not require_admin():
+        flash('需要管理员权限', 'error')
+        return redirect(url_for('auth.login'))
+    
+    return redirect(url_for('teacher.students'))
+
+@admin_bp.route('/settings')
+@login_required
+def settings():
+    """系统设置"""
+    if not require_admin():
+        flash('需要管理员权限', 'error')
+        return redirect(url_for('auth.login'))
+    
+    return render_template('admin/settings.html')
+
+@admin_bp.route('/api/teachers')
+@login_required
+def api_get_teachers():
+    """获取教师列表API"""
+    if not require_admin():
+        return jsonify({'success': False, 'message': '需要管理员权限'}), 403
+    
+    db = Database()
+    
+    try:
+        db.conn.row_factory = None
+        cursor = db.conn.execute('''
+            SELECT username, name, email, created_at
+            FROM teachers
+            ORDER BY created_at DESC
+        ''')
+        rows = cursor.fetchall()
+        
+        teachers_list = []
+        for row in rows:
+            teachers_list.append({
+                'username': row[0],
+                'name': row[1],
+                'email': row[2] or '',
+                'created_at': row[3] or ''
+            })
+        
+        return jsonify({
+            'success': True,
+            'teachers': teachers_list,
+            'count': len(teachers_list)
+        })
+        
+    except Exception as e:
+        return jsonify({'success': False, 'message': str(e)}), 500
+
+@admin_bp.route('/api/stats')
+@login_required
+def api_get_stats():
+    """获取系统统计API"""
+    if not require_admin():
+        return jsonify({'success': False, 'message': '需要管理员权限'}), 403
+    
+    db = Database()
+    
+    try:
+        stats = {
+            'total_students': len(db.get_all_students()),
+            'total_exams': len(db.get_exams()),
+            'active_exams': len([e for e in db.get_exams() if e.is_active]),
+            'total_questions': len(db.get_questions()),
+            'database_size': os.path.getsize(db.db_path) if hasattr(db, 'db_path') else 0
+        }
+        
+        return jsonify({
+            'success': True,
+            'stats': stats
+        })
+        
+    except Exception as e:
+        return jsonify({'success': False, 'message': str(e)}), 500