2022-12-13 14:27:28 +00:00
# Mobicoop V3 - User Service
2022-12-13 12:31:25 +00:00
2022-12-15 08:51:08 +00:00
Mobicoop V3 - User service. Manages user-related data.
2022-12-13 12:31:25 +00:00
2022-12-13 12:39:06 +00:00
## Installation
2022-12-13 12:31:25 +00:00
2022-12-15 08:51:08 +00:00
You need [Docker ](https://docs.docker.com/engine/ ) and [Docker-compose ](https://docs.docker.com/compose/ ).
2022-12-13 12:31:25 +00:00
2022-12-15 08:51:08 +00:00
Copy `.env.dist` to `.env` :
2022-12-13 12:31:25 +00:00
2022-12-13 12:39:06 +00:00
```bash
2022-12-15 08:51:08 +00:00
cp .env.dist .env
```
and modify it to suit your needs.
2022-12-13 12:31:25 +00:00
2022-12-15 08:51:08 +00:00
Then execute :
2022-12-13 12:31:25 +00:00
2022-12-15 08:51:08 +00:00
```bash
docker-compose up -d
2022-12-13 12:39:06 +00:00
```
2022-12-13 12:31:25 +00:00
2022-12-15 08:51:08 +00:00
The app runs automatically on the port defined in `SERVICE_PORT` of `.env` file (default : _3001_ ).
2022-12-13 12:39:06 +00:00
## Test
2022-12-13 12:31:25 +00:00
2022-12-13 12:39:06 +00:00
```bash
# unit tests
2022-12-15 08:51:08 +00:00
docker exec v3_user sh -c "npm run test"
2022-12-13 12:31:25 +00:00
2022-12-13 12:39:06 +00:00
# e2e tests
2022-12-15 08:51:08 +00:00
docker exec v3_user sh -c "npm run test:e2e"
2022-12-13 12:31:25 +00:00
2022-12-13 12:39:06 +00:00
# test coverage
2022-12-15 08:51:08 +00:00
docker exec v3_user sh -c "npm run test:cov"
2022-12-13 12:39:06 +00:00
```
2022-12-13 12:31:25 +00:00
2022-12-15 08:51:08 +00:00
Note : you can run all npm commands directly _outside_ the container (see _scripts_ section of `package.json` for available commands), but you need NodeJS installed locally. We **strongly** advise to install [Node Version Manager ](https://github.com/nvm-sh/nvm ) !
2022-12-13 12:31:25 +00:00
## License
2022-12-13 14:27:28 +00:00
Mobicoop V3 - User Service is [AGPL licensed ](LICENSE ).