Jobsworth 项目管理技术文档

1. 安装指南

数据库配置

首先，您需要创建一个新的数据库以及具有完全权限的用户。您可以使用 MySQL、MariaDB、Percona 或 PostgreSQL。

Servlet 容器安装

安装 Apache Tomcat（或其他 Java Servlet 容器），并确保您能够访问默认的安装主页。关于如何安装 Tomcat 或其他 Servlet 容器的详细信息，请参考官方文档。大部分 XML 配置文件可以保留默认设置。

您需要编辑的文件是 context.xml。此文件定义了应用程序的所有配置。将示例文件 context.example.xml 复制到 Tomcat 配置文件夹中，并根据您的系统设置所有变量。

安装 Jobsworth

完成所有设置后，我们可以安装软件。只需从 GitHub 发布页面中获取 ROOT.war 文件，并将其复制到 Tomcat 的 webapps 文件夹中。如果您将来需要升级，只需替换这个文件即可。

连接

打开 Web 浏览器并连接到您的 Jobsworth 服务器。默认用户名是 "admin"，密码是 "password"。请记得更改此用户的密码或禁用该账户。

设置邮件接收（可选）

Jobsworth 发送任务更新 outgoing emails 时，将使用如下回复地址：

[e-mail]

如果用户回复此邮件，您希望将其添加到任务评论中。以下是使用 Sendmail 设置此功能的步骤，您需要根据自己邮件服务器的情况调整脚本。

Sendmail

在 /etc/mail/local-host-names 文件中为您的 hostname 添加一个条目：

acme.domain.com.au

在 /etc/mail/aliases 文件中创建一个别名，该别名将电子邮件转发给一个脚本：

jobsworth: "|/usr/local/share/jobsworth/mail_script.sh"

在 /etc/mail/virtusertable 文件中，将所有发往您域的电子邮件重定向到上述别名：

@acme.domain.com.au        jobsworth

在 /etc/mail 目录下运行 make; make restart 命令以重建 sendmail 数据库。

现在，在 /usr/local/share/jobsworth/mail_script.sh 创建一个脚本，内容如下：

#!/bin/sh
SECRET=password1234
URL=https://acme.domain.com.au/emails
cat $2 | /usr/local/bin/curl -s -k --data-urlencode secret=${SECRET} --data-urlencode email@- ${URL}

确保更改密码，并使其与 context.xml 文件中的密码相同。

2. 项目的使用说明

Jobsworth 是一个项目管理、支持票务和 CRM 系统。它适用于帮助台支持票务、客户联络、资源管理（例如系统和密码跟踪）以及具有一系列 CRM 类型的功能。您可以规划项目，查看您的日程安排，了解您是否落后以及原因。时间跟踪和详尽的报告可以帮助您向客户准确展示您的工作内容和时长。

3. 项目 API 使用文档

Jobsworth 项目目前没有提供详细的 API 使用文档。建议您直接查看项目源代码以获取更多关于如何使用 API 的信息。

4. 项目安装方式

请参考上文提到的安装指南来安装 Jobsworth。安装方式包括数据库创建、Servlet 容器安装、Jobsworth 软件安装以及邮件接收设置（可选）。