Groundhog Charging System 项目启动与配置教程

1. 项目目录结构及介绍

groundhog-charging-system/
├── Dockerfile              # Docker构建文件
├── LICENSE                 # 项目许可证文件
├── README.md               # 项目说明文件
├── charging-api/           # 充电API模块
│   ├── __init__.py
│   ├── app.py              # API应用主文件
│   ├── config.py           # 配置文件
│   └── models.py           # 数据模型文件
├── charging-background/    # 后台充电管理模块
│   ├── __init__.py
│   ├── app.py              # 后台应用主文件
│   ├── config.py           # 配置文件
│   └── tasks.py            # 后台任务文件
├── common/                # 公共模块
│   ├── __init__.py
│   └── utilities.py        # 公共工具函数
├── requirements.txt        # 项目依赖文件
└── tests/                 # 测试模块
    ├── __init__.py
    └── test_app.py         # 应用测试文件

• Dockerfile: 用于构建Docker镜像的文件。
• LICENSE: 项目的开源许可证。
• README.md: 项目介绍和文档。
• charging-api: 充电API模块，提供充电状态和数据的接口。
• charging-background: 后台充电管理模块，处理充电任务和调度。
• common: 公共模块，包含项目共用的工具和函数。
• requirements.txt: 项目所需的Python包依赖。
• tests: 测试模块，用于项目的单元测试。

2. 项目的启动文件介绍

充电API模块启动文件

充电API模块的启动文件位于 charging-api/app.py。

from flask import Flask
from .config import Config
from .models import db

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

# 初始化数据库
db.init_app(app)

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

该文件创建了一个Flask应用实例，并加载了配置文件，然后初始化了数据库。

后台充电管理模块启动文件

后台充电管理模块的启动文件位于 charging-background/app.py。

from flask import Flask
from .config import Config
from .tasks import make_celery

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

# 初始化Celery
celery = make_celery(app)

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

该文件创建了一个Flask应用实例，并加载了配置文件，然后初始化了Celery任务队列。

3. 项目的配置文件介绍

配置文件位于 charging-api/config.py 和 charging-background/config.py。

这两个模块的配置文件内容相似，主要包括数据库配置、Celery配置和其他通用配置。

class Config:
    SECRET_KEY = 'your_secret_key'
    SQLALCHEMY_DATABASE_URI = 'sqlite:///your_database.db'
    CELERY_BROKER_URL = 'redis://localhost:6379/0'
    CELERY_RESULT_BACKEND = 'redis://localhost:6379/0'

配置文件中定义了应用的密钥、数据库连接字符串、Celery消息代理和结果后端的配置。这些配置可以根据实际部署环境进行调整。