53 lines
2.9 KiB
Markdown
53 lines
2.9 KiB
Markdown
# Hertz Studio 后端
|
||
|
||
## **一、系统简介**
|
||
|
||
- 统一后端服务，提供 `REST API` 与 `WebSocket`，面向 AI 工作室与通用后台场景。
|
||
- 模块化设计，覆盖认证与权限、通知公告、日志、知识库、系统监控、AI 对话、代码生成、Sklearn 推理、YOLO 目标检测等。
|
||
- 基于 `ASGI` 架构，使用 `Daphne` 运行；默认使用 `SQLite`，可切换 `MySQL`；缓存与消息通道使用 `Redis`。
|
||
- 自动化启动脚本 `start_server.py` 支持数据库迁移与初始数据（菜单、角色、超级管理员）初始化，以及热重启文件监听。
|
||
|
||
## 二、**体验账户**
|
||
|
||
- 管理员
|
||
|
||
账号：hertz 密码：hertz
|
||
|
||
- 普通用户
|
||
|
||
账号：demo 密码：123456
|
||
|
||
## 三、**技术栈**
|
||
|
||
- 后端框架：`Django 5`、`Django REST Framework`、`Channels` + `Daphne`。
|
||
- 数据与缓存：`SQLite`（默认）/ `MySQL`（可选）、`Redis`（缓存、会话、Channel Layer）。
|
||
- API 文档：`drf-spectacular` 自动生成，提供 Swagger 与 Redoc 页面。
|
||
- 认证与安全：自定义 `AuthMiddleware` + `JWT`（`pyjwt`），`CORS` 支持。
|
||
- AI / ML：`Ultralytics YOLO`、`OpenCV`、`NumPy`、`Scikit-learn`、`Joblib`，以及本地 `Ollama` 对话集成。
|
||
- 工具与其他：`Mako` 模板（代码生成）、`Pillow`、`watchdog`、`psutil`、`GPUtil`。
|
||
|
||
## **四、功能**
|
||
|
||
- 认证与权限（`hertz_studio_django_auth`）
|
||
- 用户注册/登录/登出、密码管理、用户信息维护。
|
||
- `JWT` 发放与刷新，角色/菜单权限体系，接口权限由 `AuthMiddleware` 统一控制。
|
||
- 图形验证码（`hertz_studio_django_captcha`）
|
||
- 可配置验证码生成与校验、尺寸/颜色/噪声等参数支持。
|
||
- 通知公告（`hertz_studio_django_notice`）
|
||
- 公告 CRUD、状态管理，面向工作室信息发布。
|
||
- 日志管理（`hertz_studio_django_log`）
|
||
- 操作日志采集与查询，支持接口级日志记录装饰器。
|
||
- 知识库（`hertz_studio_django_wiki`）
|
||
- 文章与分类管理，面向知识内容沉淀与检索。
|
||
- 系统监控（`hertz_studio_django_system_monitor`）
|
||
- CPU/内存/磁盘/GPU 指标采集与展示，基于 `psutil`/`GPUtil`。
|
||
- AI 对话（`hertz_studio_django_ai`）
|
||
- 对接本地 `Ollama`，提供对话接口与 `WebSocket` 推送能力。
|
||
- 代码生成（`hertz_studio_django_codegen`）
|
||
- 基于 `Mako` 的 Django 代码与菜单生成器，支持 CLI 生成并同步权限。
|
||
- Sklearn/PyTorch 推理（`hertz_studio_django_sklearn`）
|
||
- 模型上传、元数据解析（特征/输入输出模式）、统一预测接口，支持 `predict_proba`。
|
||
- YOLO 目标检测（`hertz_studio_django_yolo`）
|
||
- 模型管理与启用切换、检测接口、结果中文别名标注与图像绘制；默认模型位于 `static/models/yolov12/weights/best.pt`。
|
||
- Demo 与首页（`hertz_demo`）
|
||
- 示例页面（验证码、邮件、WebSocket）与首页模板 `templates/index.html`。 |