2021-10-30 13:32:30 +03:00
# Anticrm Platform
2021-10-30 16:12:06 +03:00
Anticrm Platform is a framework that help building business applications (such as CRM) fast. Current exemplary applications include Chat, Task Management, and Applicant Tracking System.
2021-10-30 13:32:30 +03:00
## Installation
2021-11-17 17:54:49 +03:00
You need Microsoft's [rush ](https://rushjs.io ) to install application. Install [rush ](https://rushjs.io ) with `$ npm install -g @microsoft/rush` command and run `$ rush install` from the repository root, followed by `$ rush build` .
2021-10-30 13:32:30 +03:00
2021-11-22 14:17:10 +03:00
## Build and run inside docker
It is possible to setup all environment required with local docker containers.
Supported both amd64 and armv8 containers.
```bash
2023-01-24 16:36:45 +03:00
cd ./dev/
2021-11-22 14:17:10 +03:00
rush build # Will build all required packages.
rush bundle # Will prepare bundles.
rush docker:build # Will build docker containers for all applications.
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.
```bash
2023-01-24 16:36:45 +03:00
cd ./tool
2021-11-22 14:17:10 +03:00
rushx run-local create-workspace ws1 -o DevWorkspace # Create workspace
rushx run-local create-account user1 -p 1234 -f John -l Appleseed # Create account
2023-04-25 10:34:10 +03:00
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
2021-11-22 14:17:10 +03:00
```
2023-04-25 10:34:10 +03:00
Following URL http://localhost:8087 will lead us to app in production mode.
2023-01-24 16:36:45 +03:00
## Run in development mode
```
cd dev/prod
rushx dev-server
```
2023-04-25 10:34:10 +03:00
Then go to http://localhost:8080
2022-04-04 14:11:37 +03:00
## Update project structure and database
If projects structure is updated it might be needed to relink and rebuild projects.
```bash
rush update
rush build
```
It also might be required to upgrade running database.
2023-04-25 10:34:10 +03:00
2022-04-04 14:11:37 +03:00
```bash
cd ./dev/tool
rushx upgrade
```
## Tests
### Unit tests
```bash
rush lint
```
### UI tests
```bash
cd ./tests
rush build
rush bundle
rush docker:build
## creates test docker containers and setups test database
./prepare.sh
2023-04-25 10:34:10 +03:00
## runs UI tests
2022-04-04 14:11:37 +03:00
rushx uitest
2022-09-21 11:08:25 +03:00
```
## Package publishing
2023-01-04 20:58:54 +03:00
```bash
2023-04-25 10:34:10 +03:00
node ./common/scripts/bump.js packageName
2023-01-04 20:58:54 +03:00
```