Huly — All-in-One Project Management Platform (alternative to Linear, Jira, Slack, Notion, Motion)
Go to file
Vyacheslav Tumanov 74e50f0b87
UBERF-4514: option for order of activity, pinned first in CommentPopup (#4122)
Signed-off-by: Vyacheslav Tumanov <me@slavatumanov.me>
2023-12-02 00:52:31 +07:00
.github Minor fixes (#4095) 2023-11-29 16:30:16 +07:00
.vscode Nevdex fixes (#3714) 2023-09-19 18:11:28 +07:00
common UBER-1074: Svelte 4 (#4014) 2023-11-20 17:01:43 +07:00
dev Fix deps (#4087) 2023-11-28 16:59:57 +07:00
models UBERF-4514: option for order of activity, pinned first in CommentPopup (#4122) 2023-12-02 00:52:31 +07:00
packages UBERF-4514: option for order of activity, pinned first in CommentPopup (#4122) 2023-12-02 00:52:31 +07:00
plugins UBERF-4514: option for order of activity, pinned first in CommentPopup (#4122) 2023-12-02 00:52:31 +07:00
pods Move ses (#4078) 2023-11-28 17:47:13 +07:00
products/tracker UBER-1074: Svelte 4 (#4014) 2023-11-20 17:01:43 +07:00
scripts Update creating workspace script and README.md (#3930) 2023-11-04 01:05:12 +07:00
server UBERF-4493: Mentions. When there is a lot of Applicants it's really difficult to mention employee (#4119) 2023-12-01 14:30:25 +07:00
server-plugins Move ses (#4078) 2023-11-28 17:47:13 +07:00
templates UBER-1074: Svelte 4 (#4014) 2023-11-20 17:01:43 +07:00
tests UBER-1083: Use hours and minutes to present less than a day durations (#4111) 2023-12-01 14:27:56 +07:00
tools/apm Update .gitignore, delete tools/apm/apm.js (#4041) 2023-11-22 17:02:54 +07:00
.gitattributes UBER-477: Uberflow dependencies (#3440) 2023-06-20 12:47:00 +07:00
.gitignore Update .gitignore, delete tools/apm/apm.js (#4041) 2023-11-22 17:02:54 +07:00
.npmrc Migrate to hcengineering and publish to github packages (#2273) 2022-09-21 14:08:25 +06:00
.nvmrc Configurable OpenAI (#2529) 2023-01-24 20:42:47 +07:00
.prettierrc UBER-1074: Svelte 4 (#4014) 2023-11-20 17:01:43 +07:00
changelog.md Bump version to 111 (#3500) 2023-07-13 20:34:56 +06:00
LICENSE Initial commit 2021-08-02 21:39:24 +02:00
README.md Update README.md (#4096) 2023-11-29 16:06:46 +07:00
rush.json Remove old automation (#3835) 2023-10-13 13:21:01 +07:00

Hardcore Engineering SaaS Platform

The Platform is a framework that helps in building business applications (such as CRM) fast. The current exemplary applications include Chat, Issue Management (Tracker), Applicant Tracking System, Boards, Leads, and HR. Several teams building products on top of the Platform including Zenflow and TraceX.

Pre-requisites

  • Make sure you have the following installed on your system:
  • Make sure what docker and docker-compose commands are available in your terminal (e.g. docker --version and docker-compose --version).
  • Make sure what docker and docker-compose commands can be executed without sudo (e.g. docker run hello-world and docker-compose --version).

Fast start

sh ./scripts/fast-start.sh

Installation

You need Microsoft's rush to install application.

Install rush with $ npm install -g @microsoft/rush command and run $ rush install from the repository root, followed by $ rush build or just:

sh ./scripts/presetup-rush.sh

Build and run

Development environment setup requires Docker to be installed on system.

Support is available for both amd64 and armv8 (arm64) containers on Linux and macOS.

cd ./dev/
rush build    # Will build all the required packages.
rush bundle   # Will prepare bundles.
rush docker:build   # Will build Docker containers for all applications in the local Docker environment.
docker-compose up -d --force-recreate # Will set up all the containers

or just:

sh ./scripts/build.sh

By default, Docker volumes named dev_db, dev_elastic, and dev_files will be created for the MongoDB, Elasticsearch, and MinIO instances.

Before you can begin, you need to create a workspace and an account and associate it with the workspace.

cd ./tool # dev/tool in the repository root
rushx run-local create-workspace ws1 -o DevWorkspace # Create workspace
rushx run-local create-account user1 -p 1234 -f John -l Appleseed # Create account
rushx run-local configure ws1 --list --enable '*' # Enable all modules, even if they are not yet intended to be used by a wide audience.
rushx run-local assign-workspace user1 ws1 # Assign workspace to user.
rushx run-local confirm-email user1 # To allow the creation of additional test workspaces.

or just:

sh ./scripts/create-workspace.sh

Accessing the URL http://localhost:8087 will lead you to the app in production mode.

Limitations:

  • Location installation does not allow sending emails, so password recovery and notification to email functionalities are not working.
  • Integrations with Telegram, Gmail, and other content sources are available only as Docker containers, built from private repository sources. However, these integrations can be used with the platform.

Run in development mode

Development mode allows for live reloading and a smoother development process.

cd dev/prod
rushx dev-server

Then go to http://localhost:8080

Use the following login credentials:

Email: user1
Password: 1234
Workspace: ws1

Update project structure and database

If the project's structure is updated, it may be necessary to relink and rebuild the projects.

rush update
rush build

It may also be necessary to upgrade the running database.

cd ./dev/tool
rushx upgrade -f

In cases where the project fails to build for any logical reason, try the following steps:

rush update
rush build --clean

Tests

Unit tests

rush test # To execute all tests

rushx test # For individual test execution inside a package directory

UI tests

cd ./tests
rush build
rush bundle
rush docker:build
## creates test Docker containers and sets up test database
./prepare.sh
## runs UI tests
rushx uitest

To execute tests in the development environment, please follow these steps:

cd ./tests
./create-local.sh ## use ./restore-local.sh if you only want to restore the workspace to a predefined initial state for sanity.
cd ./sanity
rushx dev-uitest # To execute all tests against the development environment.
rushx dev-debug -g 'pattern' # To execute tests in debug mode with only the matching test pattern.

Package publishing

node ./common/scripts/bump.js -p projectName

Additional testing

This project is tested with BrowserStack.