Mobicoop V3 configuration service
Go to file
Sylvain Briat f7de60fafe add match config 2023-10-31 09:14:07 +01:00
ci switch to redis 2023-10-25 09:09:45 +02:00
src add match config 2023-10-31 09:14:07 +01:00
.editorconfig initial commit 2023-01-25 10:50:05 +01:00
.env.dist add match config 2023-10-31 09:14:07 +01:00
.env.test switch to redis 2023-10-25 09:09:45 +02:00
.eslintrc.js lint pretty 2023-03-30 10:42:38 +02:00
.gitignore add configuration module 2023-01-25 15:16:13 +01:00
.gitlab-ci.yml remove empty integration tests 2023-10-25 10:00:26 +02:00
.prettierignore lint pretty 2023-03-30 10:42:38 +02:00
.prettierrc.json lint pretty 2023-03-30 10:42:38 +02:00
Dockerfile switch to redis 2023-10-25 09:09:45 +02:00
LICENSE add configuration module 2023-01-25 15:16:13 +01:00
README.md cast values 2023-10-26 17:18:11 +02:00
docker-compose.ci.service.yml clean compose 2023-02-28 10:56:39 +01:00
docker-compose.ci.tools.yml switch to redis 2023-10-25 09:09:45 +02:00
docker-compose.yml add health check rest service 2023-04-04 10:30:37 +02:00
jest-e2e.json add configuration module 2023-01-25 15:16:13 +01:00
nest-cli.json add configuration module 2023-01-25 15:16:13 +01:00
package-lock.json 2.3.0 2023-10-31 09:03:14 +01:00
package.json 2.3.0 2023-10-31 09:03:14 +01:00
tsconfig.build.json initial commit 2023-01-25 10:50:05 +01:00
tsconfig.json refactor configuration using dddlibrary 2023-10-19 17:16:05 +02:00

README.md

Mobicoop V3 - Configuration Service

Configuration items management. Used to configure and store configuration items for all Mobicoop V3 services using redis as database.

Each item consists in :

  • a domain : each service is associated with one or more domains, represented by an uppercase string (eg. USER)
  • a key : the key of the configuration item (a string)
  • a value : the value of the configuration item (always a string, each service must cast the value if needed)

Available domains

Domains are set in the configuration package.

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

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

Database migration

Redis database is automatically populated at the start of the service. If keys already exists in the database, items are preserved.

Usage

The app exposes the following gRPC services :

  • Get : get a configuration item by its domain and key

    {
        "domain": "CARPOOL",
        "key": "seatsProposed"
    }
    
  • Set : update a configuration item

    {
        "domain": "CARPOOL",
        "key": "seatsProposed",
        "value": "3"
    }
    

Tests / ESLint / Prettier

Tests are run outside the container for ease of use.

# 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 - Configuration Service is AGPL licensed.