README.md

Le logiciel PIA / The PIA Software

Le logiciel PIA est un outil distribué librement par la CNIL afin de faciliter la réalisation d’analyses d’impact sur la protection des données prévues par le RGPD. PIA-BACK est développé avec le framework RubyOnRails mettant à disposition une API RESTful à destination des outils PIA et PIA-APP.

The PIA software is a free tool published by the CNIL which aims to help data controllers build and demonstrate compliance to the GDPR. PIA-BACK is developped with RubyOnRails providing a RESTful API for the PIA and PIA-APP applications.

Wiki for a production environment

You can follow for a full production installation of the pia (frontend) and pia-back (backend) applications on an Ubuntu server.

Requirements

• pia (front-end) application
• Ruby 3.1.x
• Rails 7.0.x
• PostgreSQL 12.0+

System requirements

• CPU : i5
• Ram: 4Go
• Disk Space : 20Go
• OS : preferably Linux but other OS works as well

Ruby installation

See the Install Ruby page in the Wiki.

PostgreSQL installation

See the Install PostgreSQL page in the Wiki.

Run the application in a development environment

• bin/rails s your server will be accessible with the URL localhost:3000

• You can specify the option -b to bind to a public IP address or domain name and -p to use a different port.

  For example: bin/rails s -b 123.456.789.101 -p 8080 your server will be accessible with the URL 123.456.789.101:8080

• Then, in the pia (front-end) application, use this URL to enable the server mode.

• Fill the field in "Tools" > "Settings"

• Every user will have to fill the server URL, the client ID and the client SECRET fields to access the authentication interface.

How to update to the latest version in a development environment

Go to the folder pia-back : cd pia-back

Update the repository : git pull

Update the dependencies : bundle install

Update the database : bin/rake db:migrate