Skip to content
Snippets Groups Projects
Select Git revision
  • 519062f341d7c3e6c3e4827c50aa885730dfa4c9
  • master default protected
  • improved-skeleton
  • xsrf-token
4 results

credits.md

Blame
  • Credits service

    Features

    This service allows the editorial team to manage a catalog of the Open Source initiatives enabling and powering this development project.

    Each record of the catalog includes the following information:

    • id: a technical unique identifier acting as primary key in the underlying database
    • uuid: a business unique identifier
    • name: the name of the credited initiative
    • description: a short description of the credited initiative, in particular of the role the latter plays in this project
    • links: a collection of URLs related to the credited initiative, modeled as a One-To-Many relationship
    • logo: the URL of the logo of the credited initiative
    • published: a boolean flag, indicating whether the record is published or not (draft)

    Dependencies

    This service has no dependency on other components.

    Endpoints

    The service provides two endpoints,

    1. /credits;

    allowing one to perform CRUD operations on credits in a RESTful manner. Moreover, an healtcheck endpoint is provided,

    1. /health,

    returning a 200 HTTP code if the API is healthy, 503 otherwise. For the service to be healthy, the underlying database must be up.

    Implementation

    credits-service

    The service is implemented using the NestJS framework. We refer the reader to the NestJS-based micro-services page for further details concerning NestJS and the features it provides.

    Data persistence is achieved by using PostgreSQL and TypeORM.