Mobicoop V3 territory service
Go to file
Fanch a849c1c980 copy file from v3 gitlab template repo 2024-02-05 19:16:04 +01:00
.gitlab/merge_request_templates copy file from v3 gitlab template repo 2024-02-05 19:16:04 +01:00
ci use node lts image for docker 2024-01-22 16:57:44 +01:00
prisma remove db from service --check 2023-03-20 10:23:59 +01:00
src clean using es6 2023-05-05 16:39:28 +02:00
.dockerignore basic requirements 2023-02-06 13:50:07 +01:00
.editorconfig basic requirements 2023-02-06 13:50:07 +01:00
.env.dist use full registry path for docker image 2024-01-11 16:58:04 +01:00
.env.test remove db from service --check 2023-03-20 10:23:59 +01:00
.eslintrc.js basic requirements 2023-02-06 13:50:07 +01:00
.gitignore basic requirements 2023-02-06 13:50:07 +01:00
.gitlab-ci.yml Improve security : add sast and secret detection in gitlab ci 2023-11-06 08:58:22 +01:00
.prettierignore copy file from v3 gitlab template repo 2024-02-05 19:16:04 +01:00
.prettierrc.json lint pretty 2023-03-30 10:54:13 +02:00
Dockerfile use node lts image for docker 2024-01-22 16:57:44 +01:00
LICENSE basic requirements 2023-02-06 13:50:07 +01:00
README.md lint pretty 2023-03-30 10:54:13 +02:00
docker-compose.ci.service.yml clean compose 2023-02-28 11:16:14 +01:00
docker-compose.ci.tools.yml remove db from service --check 2023-03-20 10:23:59 +01:00
docker-compose.yml add health check rest service 2023-04-04 10:52:30 +02:00
jest-e2e.json basic requirements 2023-02-06 13:50:07 +01:00
nest-cli.json basic requirements 2023-02-06 13:50:07 +01:00
package-lock.json update from npm audit fix 2024-01-11 16:57:37 +01:00
package.json use prisma deploy as default for migrate, add migrate:dev command 2024-01-31 12:47:27 +01:00
tsconfig.build.json basic requirements 2023-02-06 13:50:07 +01:00
tsconfig.json basic requirements 2023-02-06 13:50:07 +01:00

README.md

Mobicoop V3 - Territory Service

Territory data management.

Requirements

You need Docker and its compose plugin.

You also need NodeJS installed locally : we strongly advise to install Node Version Manager and use the latest LTS version of Node (check that your local version matches with the one used in the Dockerfile).

The API will run inside a docker container, but the install itself is made outside the container, because during development we need tools that need to be available locally (eg. ESLint, Prettier...).

A RabbitMQ instance is also required to send / receive messages when data has been inserted/updated/deleted.

Installation

  • copy .env.dist to .env :

    cp .env.dist .env
    

    Modify it if needed.

  • install the dependencies :

    npm install
    
  • start the containers :

    docker compose up -d
    

    The app runs automatically on port 5004.

Database migration

Before using the app, you need to launch the database migration (it will be launched inside the container) :

npm run migrate

Usage

The app exposes the following gRPC services :

  • FindForPoint : find all territories that include a given point (represented by its longitude and latitude)

    {
        "lon": 5.493345,
        "lat": 46.143376
    }
    
  • FindForPoints : find all territories that include a list of given points (represented by their longitude and latitude)

    {
        "points": [
            {
                "lon": 5.493345,
                "lat": 46.143376
            },
            {
                "lon": 6.493345,
                "lat": 47.143376
            }
        ]
    }
    
  • FindByUuid : find a territory by its uuid

    {
        "uuid": "80126a61-d128-4f96-afdb-92e33c75a3e1"
    }
    
  • FindAll : find all territories; you can use pagination with page (default:1) and perPage (default:10)

    {
        "page": 1,
        "perPage": 10
    }
    
  • Create : create a territory (note that uuid is optional, a uuid will be automatically attributed if it is not provided)

    {
        "name": "Ain",
        "shape": "[[[[ 4.7953935, 46.2200671 ], [ 4.793835, 46.2155098 ], ... [ 4.7967607, 46.2219542 ], [ 4.7953935, 46.2200671 ]]]]"
    }
    

    Note that shape must be a string representation of the coordinates value of a GeoJSON MultiPolygon

  • Update : update a territory

    {
        "uuid": "80126a61-d128-4f96-afdb-92e33c75a3e1",
        "name": "Ain",
        "shape": "[[[[ 4.7953935, 46.2200671 ], [ 4.793835, 46.2155098 ], ... [ 4.7967607, 46.2219542 ], [ 4.7953935, 46.2200671 ]]]]"
    }
    

    Note that shape must be a string representation of the coordinates value of a GeoJSON MultiPolygon

  • Delete : delete a territory by its uuid

    {
        "uuid": "80126a61-d128-4f96-afdb-92e33c75a3e1"
    }
    

Messages

As mentionned earlier, RabbitMQ messages are sent after these events :

  • Create (message : the created territory informations, without the shape)

  • Update (message : the updated territory informations, without the shape)

  • Delete (message : the uuid of the deleted territory)

Various messages are also sent for logging purpose.

Tests / ESLint / Prettier

Tests are run outside the container for ease of use (switching between different environments inside containers using prisma is complicated and error prone). The integration tests use a dedicated database (see db-test section of docker-compose.yml).

# run all tests (unit + integration)
npm run test

# unit tests only
npm run test:unit

# integration tests only
npm run test:integration

# coverage
npm run test:cov

# ESLint
npm run lint

# Prettier
npm run pretty

License

Mobicoop V3 - Territory Service is AGPL licensed.