Hertz System 文档

Appearance

快速了解 ​

本页帮你用最少的步骤把 Hertz System 在本地跑起来：

  1. 启动后端 Hertz Server Django
  2. 启动前端管理端 hertz_server_diango_ui_2
  3. 打开浏览器验证主要功能模块

详细环境与安装步骤请参考《安装指南》《环境配置》《后端项目部署及运行》。

一、启动后端（Hertz Server Django） ​

1. 克隆并进入后端项目 ​

bash
git clone <repository-url>
cd Hertz_server_django

<repository-url> 为实际后端仓库地址（例如 HzGit 上的 hertz_django）。

2. 创建虚拟环境并安装依赖 ​

bash
# Windows
python -m venv venv
venv\Scripts\activate

# Linux / macOS
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install --upgrade pip
pip install -r requirements.txt

3. 配置基础环境变量 ​

在项目根目录创建 .env 文件，至少包含以下内容：

ini
DEBUG=True
SECRET_KEY=your-secret-key
ALLOWED_HOSTS=localhost,127.0.0.1
USE_REDIS_AS_DB=True
REDIS_URL=redis://127.0.0.1:6379/0

更多数据库 / Redis / JWT / 邮件配置详见《环境配置》。

4. 初始化数据库并启动 ​

bash
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser   # 创建超级管理员

# 推荐：一键启动（自动迁移与初始化）
python start_server.py
# 或仅用于开发调试
# python manage.py runserver 0.0.0.0:8000

后端默认监听：http://localhost:8000，API 前缀为 /api/。

二、启动前端管理端（hertz_server_diango_ui_2） ​

1. 进入前端项目并安装依赖 ​

bash
cd ../hertz_server_diango_ui_2   # 实际目录名称以你的仓库为准
npm install

2. 配置前端环境变量 ​

在前端项目根目录创建 .env（或 .env.development）：

bash
VITE_API_BASE_URL=http://localhost:8000/api
VITE_APP_TITLE=HzSystem Admin

3. 启动前端开发服务器 ​

bash
npm run dev

Vite 默认会在类似 http://localhost:5173 的地址提供前端页面（以终端输出为准）。

三、验证系统是否正常运行 ​

  1. 打开浏览器访问前端地址（如 http://localhost:5173）。
  2. 在登录页使用文档中提供的默认账号（例如：
    • 普通用户：demo / 123456
    • 超级管理员：hertz / hertz ）。
  3. 登录后你可以在左侧菜单中看到：
    • 仪表盘 / 用户与权限 / 文章管理 / 通知与日志
    • YOLO 模型与数据集 / 训练管理 / 检测历史
    • 系统监控 / AI 助手 / 知识库 / 个人中心 等模块。

如果上述步骤都正常，说明前后端环境已经搭建成功，可以继续阅读：

  • 《项目介绍》：整体架构与模块地图
  • 《后端总体文档》：后端目录结构与运行流程
  • 《前端项目介绍》：前端页面与接口设计
  • 《后端项目部署及运行》：后端整体部署流程与运行说明