Skip to content
Snippets Groups Projects
Commit f053c2a5 authored by Alessandro Cerioni's avatar Alessandro Cerioni
Browse files

First version of the changelog service doc

parent e86676a5
No related branches found
No related tags found
No related merge requests found
# Changelog service
## Features
This service allows end-users to keep track of the improvements that are applied to this project throughout its development. improvements are classified by three categories:
1. bugfixes
2. minor improvements
3. major improvements
Information it typically entered by developers and eventually presented to end-users via a dedicated page of data.grandlyon.com Web Portal.
A record in the underlying database includes the following information:
* `_id`: a technical unique identifier (automatically generated);
* `md5`: a business unique identifier (automatically generated);
* `createDate`: a creation date (automatically generated);
* `updateDate`: an update date (automatically generated);
* `version`: the version of the Web Portal to which the record refers to;
* `bugFixes`: a list of bugfixes;
* `minorImprovements`: a list of minor improvements;
* `majorImprovements`: a list of major improvements;
* `language`: the language it is typed in, either French of English. In fact, each changelog event is entered twice, once in French, once in English, in order for the log to be bilingual.
Bugfixes, minor and major improvements are simply modeled as strings of characters.
## Dependencies
This service has no dependencies from other components.
## Endpoints
This service exposes one single endpoint, `/changelog`, supporting all the CRUD methods in a RESTful fashion.
## Implementation
The service is implemented using the [NestJS](https://nestjs.com/) framework. We refer the reader to the [NestJS-based micro-services](../../miscellaneous/nestjs-micro-services.md) page for further details concerning the latter framework and the features it provides.
[MongoDB](https://www.mongodb.com/) is used for data persistence. Data modeling as well as connections to MongoDB are performed with [Mongoose](https://github.com/Automattic/mongoose).
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment