bb83ece433
Signed-off-by: Alexander Platov <sas_lord@mail.ru> |
||
---|---|---|
.github | ||
.vscode | ||
common | ||
dev | ||
models | ||
packages | ||
plugins | ||
pods | ||
products/tracker | ||
server | ||
server-plugins | ||
templates | ||
tests | ||
tools/apm | ||
.gitattributes | ||
.gitignore | ||
.npmrc | ||
.nvmrc | ||
.prettierrc | ||
changelog.md | ||
LICENSE | ||
README.md | ||
rush.json |
Anticrm Platform
Anticrm Platform is a framework that help building business applications (such as CRM) fast. Current exemplary applications include Chat, Issue Management(Tracker), and Applicant Tracking System, Boards, Leads, HR.
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
.
Build and run
Development environment setup require Docker to be installed on system.
Supported both amd64 and armv8(arm64) containers on Linux and Macos.
cd ./dev/
rush build # Will build all required packages.
rush bundle # Will prepare bundles.
rush docker:build # Will build docker containers for all applications in local docker environment.
docker-compose up -d --force-recreate # Will setup all containers
By default docker volumes dev_db
dev_elastic
dev_files
will be created for mongo/elastic/minio instances.
Before we could start we need to create workspace/account and associate it with workspace.
cd ./tool
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 sanity-ws --list --enable '*' # Enable all modules, then if they are not yet intended to be used by wide audience.
rushx run-local assign-workspace user1 ws1 # Assign workspace to user
rushx run-local confirm-email user1 # To allow create of more test workspaces.
Following URL http://localhost:8087 will lead us to app in production mode.
Limitations:
- Location installation do not allow to send emails, so password recovery and notification to email functionality is not working.
- Telegram/Gmail/Content integrations are available only as docker container and they are build from private repository sources, but could be used with platform.
Run in development mode
Development mode allow to live reload and smooth development process.
cd dev/prod
rushx dev-server
Then go to http://localhost:8080
Update project structure and database
If projects structure is updated it might be needed to relink and rebuild projects.
rush update
rush build
It also might be required to upgrade running database.
cd ./dev/tool
rushx upgrade
In cases when project doesn't build for any logical reason try:
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 setups test database
./prepare.sh
## runs UI tests
rushx uitest
To execute tests in development environment, please do following steps:
cd ./tests
./create-local.sh ## use ./restore-local.sh to just restore sanity workspace to predefined initial state.
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 test matching pattern.
Package publishing
node ./common/scripts/bump.js -p projectName
Additional testing
This project is tested with BrowserStack.