user/README.md

43 lines
987 B
Markdown
Raw Normal View History

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).