Skip to content

Het berichten component is ontwikkeld voor de gemeente Utrecht en heeft als doel het functionele berichten verkeer voor commonground te faciliteren. Denk hier bij aan berichten via een email naar een klant waar een, mogelijk, sjabloon in gebruikt wordt

License

Notifications You must be signed in to change notification settings

ConductionNL/berichtservice

Repository files navigation

berichtservice

BCH compliance StyleCI Docker Image CI Artifact HUB Componenten Catalogus

Status badge

Description

De Berichtenservice faciliteert het versturen van berichten (bijvoorbeeld aan de hand van WRC sjablonen) en het rapporteren daarover. Hiervoor levert het zowel bulk-capaciteiten (voor bijvoorbeeld het versturen van mailings), als opvolg-capaciteiten (voor het controleren van bijvoorbeeld het aankomen van emails).

Vooralsnog ondersteunt de Berichtenservice het versturen van mails en sms-berichten, maar er wordt nagedacht over het toevoegen van een post route en chatfunctionaliteit (social media). Het kan hierbij zowel zelfstandig opereren, als een front leveren voor functionaliteit van derden (Mailgun, Mailchimp, Messagbird, etc)

Additional Information

Installation

We differentiate between two way's of installing this component, a local installation as part of the provided developers toolkit or an helm installation on an development or production environment.

Local installation

First make sure you have docker desktop running on your computer. Then clone the repository to a directory on your local machine through a git command or git kraken (ui for git). If successful you can now navigate to the directory of your cloned repository in a command prompt and execute docker-compose up.

$ docker-compose up

This will build the docker image and run the used containers and when seeing the log from the php container: "NOTICE: ready to handle connections", u are ready to view the documentation at localhost on your preferred browser.

Instalation on Kubernetes or Haven

As a haven compliant commonground component this component is installable on kubernetes trough helm. The helm files can be found in the api/helm folder. For installing this component trough helm simply open your (still) favorite command line interface and run

$ helm install [name] ./api/helm --kubeconfig kubeconfig.yaml --namespace [name] --set settings.env=prod,settings.debug=0,settings.cache=1

For an in depth installation guide you can refer to the installation guide contained with the helm files, it also contains a short tutorial on getting your cluster ready to expose your installation to the world

Standards

This component adheres to international, national and local standards (in that order), notable standards are:

This component is based on the following schema.org sources:

Developers toolkit and technical information

You can find the data model, OAS documentation and other helpfull developers material like a postman collection under api/public/schema, development support is provided trough the samenorganiseren slack channel.

Couple of quick tips when you start developing

  • If you not yet have setup the component locally read the Tutorial for setting up your local environment.
  • You can find the other components on Github.
  • Take a look at the commonground componenten catalogus to prevent development collitions.
  • Use Commongroun.conduction.nl for easy deployment of test environments to deploy your development to.
  • For information on how to work with the component you can refer to the tutorial here.

Contributing

First of al please read the Contributing guideline's ;)

But most imporantly, welcome! We strife to keep an active community at commonground.nl, please drop by and tell is what you are thinking about so that we can help you along.

Credits

Information about the authors of this component can be found here

Copyright © Utrecht 2019

About

Het berichten component is ontwikkeld voor de gemeente Utrecht en heeft als doel het functionele berichten verkeer voor commonground te faciliteren. Denk hier bij aan berichten via een email naar een klant waar een, mogelijk, sjabloon in gebruikt wordt

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages