Worklenz

Task Management | Time Tracking | Analytics | Resource Management | Project Templates

Worklenz is a project management tool designed to help organizations improve their efficiency. It provides a comprehensive solution for managing projects, tasks, and collaboration within teams.

Features

Project Planning: Create and organize projects, assign tasks to team members.
Task Management: Break down projects into smaller tasks, set due dates, priorities, and track progress.
Collaboration: Share files, leave comments, and communicate seamlessly with your team members.
Time Tracking: Monitor time spent on tasks and projects for better resource allocation and billing.
Reporting: Generate detailed reports on project status, team workload, and performance metrics.

Tech Stack

This repository contains the frontend and backend code for Worklenz.

Frontend: Built using React with Ant Design as the UI library.
Backend: Built using TypeScript, Express.js, with PostgreSQL as the database.

Requirements

Node.js version v18 or newer
PostgreSQL version v15 or newer
Docker and Docker Compose (for containerized setup)

Getting Started

These instructions will help you set up and run the Worklenz project on your local machine for development and testing purposes.

Prerequisites

Node.js (version 18 or higher)
PostgreSQL database
An S3-compatible storage service (like MinIO) or Azure Blob Storage

Option 1: Manual Installation

Clone the repository

git clone https://github.com/Worklenz/worklenz.git
cd worklenz

Set up environment variables
- Copy the example environment files
```
cp .env.example .env
cp worklenz-backend/.env.example worklenz-backend/.env
```
- Update the environment variables with your configuration
Install dependencies

# Install backend dependencies
cd worklenz-backend
npm install

# Install frontend dependencies
cd ../worklenz-frontend
npm install

Set up the database

# Create a PostgreSQL database named worklenz_db
cd worklenz-backend

# Execute the SQL setup files in the correct order
psql -U your_username -d worklenz_db -f database/sql/0_extensions.sql
psql -U your_username -d worklenz_db -f database/sql/1_tables.sql
psql -U your_username -d worklenz_db -f database/sql/indexes.sql
psql -U your_username -d worklenz_db -f database/sql/4_functions.sql
psql -U your_username -d worklenz_db -f database/sql/triggers.sql
psql -U your_username -d worklenz_db -f database/sql/3_views.sql
psql -U your_username -d worklenz_db -f database/sql/2_dml.sql
psql -U your_username -d worklenz_db -f database/sql/5_database_user.sql

Start the development servers

# In one terminal, start the backend
cd worklenz-backend
npm run dev

# In another terminal, start the frontend
cd worklenz-frontend
npm run dev

Access the application at http://localhost:5000

Option 2: Docker Setup

The project includes a fully configured Docker setup with:

Frontend React application
Backend server
PostgreSQL database
MinIO for S3-compatible storage

Clone the repository:

git clone https://github.com/Worklenz/worklenz.git
cd worklenz

Start the Docker containers (choose one option):

Using Docker Compose directly

docker-compose up -d

The application will be available at:
- Frontend: http://localhost:5000
- Backend API: http://localhost:3000
- MinIO Console: http://localhost:9001 (login with minioadmin/minioadmin)
To stop the services:

docker-compose down

Configuration

Environment Variables

Worklenz requires several environment variables to be configured for proper operation. These include:

Database credentials
Session secrets
Storage configuration (S3 or Azure)
Authentication settings

Please refer to the .env.example files for a full list of required variables.

MinIO Integration

The project uses MinIO as an S3-compatible object storage service, which provides an open-source alternative to AWS S3 for development and production.

MinIO Console: http://localhost:9001
- Username: minioadmin
- Password: minioadmin
Default Bucket: worklenz-bucket (created automatically when the containers start)

Security Considerations

For production deployments:

Use strong, unique passwords and keys for all services
Do not commit .env files to version control
Use a production-grade PostgreSQL setup with proper backup procedures
Enable HTTPS for all public endpoints
Review and update dependencies regularly

Contributing

We welcome contributions from the community! If you’d like to contribute, please follow our contributing guidelines.

Security

If you believe you have found a security vulnerability in Worklenz, we encourage you to responsibly disclose this and not open a public issue. We will investigate all legitimate reports.

Email [email protected] to disclose any security vulnerabilities.

License

This project is licensed under the MIT License.

Screenshots

Contributing

We welcome contributions from the community! If you’d like to contribute, please follow our contributing guidelines.

License

Worklenz is open source and released under the GNU Affero General Public License Version 3 (AGPLv3).

By contributing to Worklenz, you agree that your contributions will be licensed under its AGPL.

Worklenz React

This repository contains the React version of Worklenz with a Docker setup for easy development and deployment.

Getting Started with Docker

The project includes a fully configured Docker setup with:

Frontend React application
Backend server
PostgreSQL database
MinIO for S3-compatible storage

Prerequisites

Docker and Docker Compose installed on your system
Git

Quick Start

Clone the repository:

git clone https://github.com/Worklenz/worklenz.git
cd worklenz

Start the Docker containers (choose one option):

Option 1: Using the provided scripts (easiest)

On Windows:
```
start.bat
```
On Linux/macOS:
```
./start.sh
```

Option 2: Using Docker Compose directly

docker-compose up -d

The application will be available at:
- Frontend: http://localhost:5000
- Backend API: http://localhost:3000
- MinIO Console: http://localhost:9001 (login with minioadmin/minioadmin)
To stop the services (choose one option):

Option 1: Using the provided scripts

On Windows:
```
stop.bat
```
On Linux/macOS:
```
./stop.sh
```

Option 2: Using Docker Compose directly

docker-compose down

MinIO Integration

The project uses MinIO as an S3-compatible object storage service, which provides an open-source alternative to AWS S3 for development and production.

Working with MinIO

MinIO provides an S3-compatible API, so any code that works with S3 will work with MinIO by simply changing the endpoint URL. The backend has been configured to use MinIO by default, with no additional configuration required.

MinIO Console: http://localhost:9001
- Username: minioadmin
- Password: minioadmin
Default Bucket: worklenz-bucket (created automatically when the containers start)

Backend Storage Configuration

The backend is pre-configured to use MinIO with the following settings:

// S3 credentials with MinIO defaults
export const REGION = process.env.AWS_REGION || "us-east-1";
export const BUCKET = process.env.AWS_BUCKET || "worklenz-bucket";
export const S3_URL = process.env.S3_URL || "http://minio:9000/worklenz-bucket";
export const S3_ACCESS_KEY_ID = process.env.AWS_ACCESS_KEY_ID || "minioadmin";
export const S3_SECRET_ACCESS_KEY = process.env.AWS_SECRET_ACCESS_KEY || "minioadmin";

The S3 client is initialized with special MinIO configuration:

const s3Client = new S3Client({
  region: REGION,
  credentials: {
    accessKeyId: S3_ACCESS_KEY_ID || "",
    secretAccessKey: S3_SECRET_ACCESS_KEY || "",
  },
  endpoint: getEndpointFromUrl(), // Extracts endpoint from S3_URL
  forcePathStyle: true, // Required for MinIO
});

Environment Configuration

The .env file includes the necessary configuration for using MinIO:

STORAGE_PROVIDER=s3
AWS_REGION=us-east-1
AWS_BUCKET=worklenz-bucket
S3_ACCESS_KEY_ID=minioadmin
S3_SECRET_ACCESS_KEY=minioadmin
S3_URL=http://minio:9000

When the backend service starts, it will use these environment variables to connect to MinIO for file storage.

Development

For development, you can use the provided Docker setup which includes all necessary dependencies. The code will be running inside containers, but you can still edit files locally and see changes reflected in real-time.

Production Deployment

For production deployment:

Update the .env file with production settings
Build custom Docker images or use the provided ones
Deploy using Docker Compose or a container orchestration platform like Kubernetes

For MinIO in production, consider:

Setting up proper credentials (change default minioadmin/minioadmin)
Configuring persistent storage
Setting up proper networking and access controls
Using multiple MinIO instances for high availability

Worklenz: 高效团队的全方位项目管理工具

Worklenz

Features

Tech Stack

Requirements

Getting Started

Prerequisites

Option 1: Manual Installation

Option 2: Docker Setup

Configuration

Environment Variables

MinIO Integration

Security Considerations

Contributing

Security

License

Screenshots

Contributing

License

Worklenz React

Getting Started with Docker

Prerequisites

Quick Start

MinIO Integration

Working with MinIO

Backend Storage Configuration

Environment Configuration

Development

Production Deployment