USTC-iCourse项目启动与配置教程

1. 项目目录结构及介绍

USTC-iCourse项目的目录结构如下所示：

ustc-course/
├── app.py              # 项目的主要启动文件
├── config.py           # 项目的配置文件
├── course/             # 存放课程信息的目录
│   ├── __init__.py
│   ├── models.py       # 数据库模型文件
│   ├── routes.py       # 路由和视图函数
│   └── utils.py        # 工具函数
├── static/             # 静态文件目录，如CSS、JavaScript、图片等
│   ├── css/
│   ├── js/
│   └── images/
├── templates/          # HTML模板文件
│   ├── base.html       # 基础模板
│   ├── index.html      # 主页模板
│   └── ...
└── requirements.txt    # 项目依赖文件

• app.py: 项目的主要启动文件，用于启动Flask应用程序。
• config.py: 项目的配置文件，包含数据库连接配置、应用配置等。
• course/: 存放与课程相关的模块。
  • models.py: 定义数据库模型。
  • routes.py: 定义路由和视图函数。
  • utils.py: 存放一些工具函数。
• static/: 存放静态文件，如CSS样式表、JavaScript脚本和图片等。
• templates/: 存放HTML模板文件。
• requirements.txt: 记录项目依赖的Python包，使用pip安装时需要。

2. 项目的启动文件介绍

项目的启动文件是app.py，其主要功能如下：

• 导入Flask类和其他必要的组件。
• 创建Flask应用实例。
• 从config.py导入配置，并应用到应用实例。
• 注册蓝图（如果有的话）。
• 定义路由和视图函数。
• 启动应用服务器。

以下是一个简化的app.py文件示例：

from flask import Flask
from course import models, routes
import config

app = Flask(__name__)
app.config.from_object(config)

# 注册蓝图
app.register_blueprint(routes.bp)

if __name__ == '__main__':
    app.run(debug=True)

3. 项目的配置文件介绍

项目的配置文件是config.py，它包含了应用程序运行时所需的各种配置信息，如数据库连接信息、应用密钥、端口号等。

以下是一个简化的config.py文件示例：

import os

class Config:
    SECRET_KEY = os.environ.get('SECRET_KEY') or 'hard to guess string'
    SQLALCHEMY_DATABASE_URI = 'sqlite:///ustc_course.db'
    SQLALCHEMY_TRACK_MODIFICATIONS = False
    # 其他配置...

在上面的配置文件中，我们定义了一个Config类，其中包含了几个基本的配置项。例如，SECRET_KEY用于Flask应用的安全，SQLALCHEMY_DATABASE_URI定义了数据库的连接字符串。通过从环境变量中获取配置值，可以为部署到不同环境的应用提供灵活性。如果环境变量不存在，则使用默认值。