Django驱动的帮助台票务跟踪器
项目描述
版权所有 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 pull或pip 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。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定要选择哪个,请了解更多关于安装包的信息。
源分布
构建分发版
django_helpdesk-1.2.0.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 320bbdbb7b68014ac48d857e3b9a202638fb45f2ecfd7efbbb0e8fa48a31cd74 |
|
MD5 | 80f4bc4e171887b75ea3a3094a42c819 |
|
BLAKE2b-256 | d623d7b5bd3981b05ebc7f9c08847d26952c09c0785c55a8f08c0cc2e52d3999 |
django_helpdesk-1.2.0-py3-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 12cf50058aa2b63b66618b50f8adeeec553d35d47e02f71522910c1e0d2628e6 |
|
MD5 | d17145e182889fd482dc3677d6970f22 |
|
BLAKE2b-256 | c3b3f42397c330ebac3817c86718f353b23b732ac9a93ae807fa82798fc5d2e8 |