https://github.com/defra/phi-etl-fera-backend
Git repository for service phi-etl-fera-backend
https://github.com/defra/phi-etl-fera-backend
backend cdp node service
Last synced: 4 months ago
JSON representation
Git repository for service phi-etl-fera-backend
- Host: GitHub
- URL: https://github.com/defra/phi-etl-fera-backend
- Owner: DEFRA
- License: other
- Created: 2024-03-28T12:59:44.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-14T10:40:59.000Z (6 months ago)
- Last Synced: 2026-01-14T14:32:42.088Z (6 months ago)
- Topics: backend, cdp, node, service
- Language: JavaScript
- Size: 66.3 MB
- Stars: 0
- Watchers: 0
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# phi-etl-fera-backend
Core delivery platform Node.js Backend Template.
- [Requirements](#requirements)
- [Node.js](#nodejs)
- [Local development](#local-development)
- [Setup](#setup)
- [Development](#development)
- [Production](#production)
- [Npm scripts](#npm-scripts)
- [API endpoints](#api-endpoints)
- [Calling API endpoints](#calling-api-endpoints)
- [Postman](#postman)
- [Docker](#docker)
- [Development Image](#development-image)
- [Production Image](#production-image)
- [Licence](#licence)
- [About the licence](#about-the-licence)
## Requirements
### Node.js
Please install [Node.js](http://nodejs.org/) `>= v18` and [npm](https://nodejs.org/) `>= v9`. You will find it
easier to use the Node Version Manager [nvm](https://github.com/creationix/nvm)
To use the correct version of Node.js for this application, via nvm:
```bash
cd phi-etl-fera-backend
nvm use
```
## Local development
### Setup
Install application dependencies:
```bash
npm install
```
### Development
To run the application in `development` mode run:
```bash
npm run dev
```
### Production
To mimic the application running in `production` mode locally run:
```bash
npm start
```
### Npm scripts
All available Npm scripts can be seen in [package.json](./package.json)
To view them in your command line run:
```bash
npm run
```
## API endpoints
| Endpoint | Description |
| :------------------ | :-------------------------------- |
| `GET: /populateDb` | creates collections in mongodb |
| `GET: /updatePest` | writes pest data into collection |
| `GET: /updatePlant` | writes plant data into collection |
| `POST: /search/plants` | get plant info for seach input from user |
| `GET: /search/countries` | writes plant data into collection |
| `POST: /workflow` | initiates workflow to get annex6 and annex11 rules for plant |
Master JSON files
countries.json
serviceFormat.json
plant_annex6.json (Will be provided by DEFRA)
plant_annex11.json (Will be provided by DEFRA)
The following transactional files are integral to the application, and currently being generated from the
dump received from FERA. Post Inegration with FERA through the API's exposed by them, the
following files will be generated automatically from the response from the APIs.
plant_name.json
pest_name.json
pest_plant_link.json
pest_distribution.json
pest_fcpd
pest_pras
plant_pest_reg
## Calling API endpoints
### Postman
A [Postman](https://www.postman.com/) collection and environment are available for making calls to the Teams and
Repositories API. Simply import the collection and environment into Postman.
- [CDP Node Backend Template Postman Collection](postman/phi-etl-fera-backend.postman_collection.json)
- [CDP Node Backend Template Postman Environment](postman/phi-etl-fera-backend.postman_environment.json)
## Docker
### Development image
Build:
```bash
docker build --target development --no-cache --tag phi-etl-fera-backend:development .
```
Run:
```bash
docker run -e GITHUB_API_TOKEN -p 3008:3008 phi-etl-fera-backend:development
```
### Production image
Build:
```bash
docker build --no-cache --tag phi-etl-fera-backend .
```
Run:
```bash
docker run -e GITHUB_API_TOKEN -p 3001:3001 phi-etl-fera-backend
```
## Licence
THIS INFORMATION IS LICENSED UNDER THE CONDITIONS OF THE OPEN GOVERNMENT LICENCE found at:
The following attribution statement MUST be cited in your products and applications when using this information.
> Contains public sector information licensed under the Open Government license v3
### About the licence
The Open Government Licence (OGL) was developed by the Controller of Her Majesty's Stationery Office (HMSO) to enable
information providers in the public sector to license the use and re-use of their information under a common open
licence.
It is designed to encourage use and re-use of information freely and flexibly, with only a few conditions.