update readme
This commit is contained in:
parent
75402c90cd
commit
e69c626fda
52
README.md
52
README.md
|
@ -22,15 +22,61 @@ docker-compose up -d
|
||||||
|
|
||||||
The app runs automatically on the port defined in `SERVICE_PORT` of `.env` file (default : _3001_).
|
The app runs automatically on the port defined in `SERVICE_PORT` of `.env` file (default : _3001_).
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
The app exposes the following [gRPC](https://grpc.io/) services :
|
||||||
|
|
||||||
|
- **FindByUuid** : find a user by its uuid
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"uuid": "80126a61-d128-4f96-afdb-92e33c75a3e1"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- **FindAll** : find all users; you can use pagination with `page` (default:_1_) and `perPage` (default:_10_)
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"page": 1,
|
||||||
|
"perPage": 10
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Create** : create a user (note that uuid is optional, a uuid will be automatically attributed if it is not provided)
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"email": "jezabel.doe@email.com",
|
||||||
|
"firstName": "Jezabel",
|
||||||
|
"lastName": "Doe"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Update** : update a user
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"firstName": "Jezabel-Katarina",
|
||||||
|
"email": "jezabel-katarina.doe@email.com",
|
||||||
|
"uuid": "30f49838-3f24-42bb-a489-8ffb480173ae"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Delete** : delete a user by its uuid
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"uuid": "80126a61-d128-4f96-afdb-92e33c75a3e1"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
## Test
|
## Test
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# unit tests
|
# unit tests
|
||||||
docker exec v3_user sh -c "npm run test"
|
docker exec v3_user sh -c "npm run test"
|
||||||
|
|
||||||
# e2e tests
|
|
||||||
docker exec v3_user sh -c "npm run test:e2e"
|
|
||||||
|
|
||||||
# test coverage
|
# test coverage
|
||||||
docker exec v3_user sh -c "npm run test:cov"
|
docker exec v3_user sh -c "npm run test:cov"
|
||||||
```
|
```
|
||||||
|
|
Loading…
Reference in New Issue