Lightmeter 项目启动与配置教程

1. 项目目录结构及介绍

Lightmeter 项目的目录结构如下：

lightmeter/
├── .gitignore
├── .vscode
│   └── settings.json
├── Dockerfile
├── README.md
├── app.py
├── config.py
├── models.py
├── requirements.txt
├── run.py
├── static/
│   └── ...
├── templates/
│   └── ...
└── tests/
    └── ...

• .gitignore：Git 忽略文件列表，用于指定在执行 Git 命令时应该忽略的文件和目录。
• .vscode：Visual Studio Code 的配置目录，其中包含项目的个性化设置。
• Dockerfile：Docker 镜像构建文件，用于创建可运行的 Docker 容器。
• README.md：项目说明文件，通常包含项目的介绍、安装和使用指南。
• app.py：项目的主要 Python 应用程序文件。
• config.py：项目配置文件，包含项目运行所需的配置信息。
• models.py：定义项目数据模型的 Python 文件。
• requirements.txt：项目依赖文件，列出项目运行所需的 Python 包。
• run.py：用于启动项目的 Python 脚本。
• static/：静态文件目录，通常包含 CSS、JavaScript 和图像等文件。
• templates/：模板文件目录，包含项目的前端 HTML 模板文件。
• tests/：测试文件目录，包含项目的自动化测试脚本。

2. 项目的启动文件介绍

项目的启动文件为 run.py，该文件内容如下：

from app import app

if __name__ == "__main__":
    app.run()

该文件通过导入 app 模块中的 Flask 应用实例，并在主函数中调用 run() 方法启动应用。

3. 项目的配置文件介绍

项目的配置文件为 config.py，该文件定义了项目运行所需的各种配置信息。以下是一个示例配置：

import os

class Config:
    SECRET_KEY = os.environ.get('SECRET_KEY') or 'a-very-secret-key'
    DATABASE_URI = os.environ.get('DATABASE_URI') or 'sqlite:///example.db'
    SQLALCHEMY_TRACK_MODIFICATIONS = False
    ...

在这个配置文件中，定义了如 SECRET_KEY、DATABASE_URI 等配置项。这些配置项可以通过环境变量设置，如果没有设置环境变量，则使用默认值。例如，数据库的 URI 可以通过环境变量 DATABASE_URI 设置，如果未设置，则默认使用 SQLite 数据库。