跳转到主要内容

Django驱动的帮助台票务跟踪器

项目描述

Build Status https://codecov.io/gh/django-helpdesk/django-helpdesk/branch/develop/graph/badge.svg

版权所有 2009-2023 Ross Poulton 和 django-helpdesk 贡献者。版权所有。有关详情请参阅 LICENSE。

django-helpdesk 以前被称为 Jutda Helpdesk,这个名字来源于最初创建它的公司。截至 2011 年 1 月,这个名字已经改为反映其实际内容:一个由 Django 驱动的票务跟踪器,其贡献者远超 Jutda。

完整的文档可以在 docs/ 目录中找到,或者在线查看 http://django-helpdesk.readthedocs.org/

演示快速入门

django-helpdesk 包含一个基本的演示 Django 项目,这样您可以轻松开始测试或开发 django-helpdesk。演示项目位于 demo/ 最高级文件夹中。

您只需运行以下命令即可启动演示项目服务器(考虑在运行之前创建一个虚拟环境)

make rundemo

或者使用 docker

docker build . -t demodesk
docker run --rm -v "$PWD:/app" -p 8080:8080 demodesk

然后在您的网络浏览器中输入 http://localhost:8080(以用户 admin 身份登录,密码 Test1234)。

有关更多信息选项,请参阅 demo/README.rst 文件。

关于 SQLITE 和搜索的注意事项: 演示项目使用 sqlite 作为其数据库。Sqlite 不允许不区分大小写的搜索,因此搜索功能可能不如支持不区分大小写搜索的其他数据库(如 PostgreSQL 或 MySQL)那样有效。有关更多信息,请参阅 Django 文档中的此 注意事项

当您尝试使用 sqlite 进行关键词搜索时,将显示一条消息,提醒您此不足之处。对此我们很抱歉,没有其他解决办法。

安装

开发者环境

按照以下步骤设置您的开发环境,以贡献 helpdesk
  • 将 helpdesk 应用检查到您的本地文件系统

    git clone https://github.com/django-helpdesk/django-helpdesk.git
  • 安装并激活虚拟环境

    python -m venv .venv && source .venv/bin/activate
  • 安装开发所需的依赖项

    pip install -r requirements.txt -r requirements-dev.txt
  • 您还可以安装测试所需的依赖项

    pip install -r requirements-testing.txt

要停止虚拟环境,请使用 deactivate。然后要重新激活它,只需运行

source .venv/bin/activate

要查看Makefile的选项,请运行:make

项目在CI/CD管道中强制执行标准化格式。为确保您有正确的格式,请运行

make checkformat

要自动格式化任何代码,请使用这个

make format

测试

您可以从命令行运行测试,使用:make test

有关使用方法的详细信息,请参阅quicktest.py

如果您需要为新功能创建测试,请将您的测试添加到tests模块中的测试文件,并在测试VENV中调用它们:

python quicktest.py helpdesk.tests.test_my_new_features -v 2

从旧版本升级

如果您是从使用迁移的旧版本django-helpdesk升级,请获取代码库的最新版本(例如,通过使用git pullpip install –upgrade django-helpdesk),然后迁移数据库

python manage.py migrate helpdesk --db-dry-run # DB untouched
python manage.py migrate helpdesk

最后,重新启动您的Web服务器软件(例如Apache)或FastCGI实例,以确保使用最新的更改。

不幸的是,如果是从迁移之前的版本(即2011年之前)的django-helpdesk升级,我们无法提供帮助。

如果需要,您可以继续到“初始配置”区域。

贡献

我们很高兴接受任何类型的贡献!这可以包括

  • 后端Python/Django代码开发

  • 前端Web开发(HTML/JavaScript,特别是jQuery)

  • 语言翻译

  • 编写改进的文档和演示

有关贡献的更多信息,请参阅CONTRIBUTING.rst文件。

许可

django-helpdesk在BSD 3条款许可证的条款下进行许可。有关完整的许可条款,请参阅LICENSE文件。

请注意,django-helpdesk附带第三方产品,它们有自己的许可证。有关包含的包的许可条款,请参阅LICENSE.3RDPARTY。

项目详情


发布历史 发布通知 | RSS源

下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解更多关于安装包的信息。

源分布

django_helpdesk-1.2.0.tar.gz (9.4 MB 查看哈希值)

上传时间 源码

构建分发版

django_helpdesk-1.2.0-py3-none-any.whl (10.4 MB 查看哈希值)

上传时间 Python 3

支持者