Florence

The publishing platform used for the ONS website.

Getting started

To run Florence you must have Golang installed on a UNIX machine.

Once you have installed those dependencies and cloned this repo you need to run the following:

Move into the correct directory
```
cd florence
```
Build node modules (you won't need to do this everytime only when the assets need to be rebuilt)
```
make node-modules
```
Run the server
```
make debug
```

Steps 2 & 3 can also be run with the following command:

make dev

This will build the node modules and then run the server

Browse to the Florence homepage http://localhost:8081/florence
If you are running Florence for the first time you will need to login with the setup credentials. You will be asked to change this password.

Further guidance on how to use Florence can be found in usage.md

There are other ONS digital applications that you'll need to run to allow Florence to work end-to-end:

The following environment variables are available when running the Go server.

Environment variable	Default	Description
BIND_ADDR	:8080	Host and port to bind to. Note: running `make debug` will run Florence on `:8081`
ROUTER_URL	http://localhost:20000	URL that the frontend router can be accessed on
ZEBEDEE_URL	http://localhost:8082	URL that Zebedee can be accessed on
IMPORT_API_URL	http://localhost:21800	URL that the dataset import API can be accessed on
RECIPE_API_URL	http://localhost:22300	URL that the dataset recipes API can be accessed on
DATASET_API_URL	http://localhost:22000	URL that the dataset API can be accessed on
TABLE_RENDERER_URL	http://localhost:23300	The URL that dp-table-renderer can be accessed on
DATASET_CONTROLLER_URL	http://localhost:24000	Dataset controller url
GRACEFUL_SHUTDOWN_TIMEOUT	10s	The graceful shutdown timeout in seconds
HEALTHCHECK_INTERVAL	30s	The period of time between health checks
HEALTHCHECK_CRITICAL_TIMEOUT	90s	The period of time after which failing checks will result in critical global check status

The following envrionment variables are available when running the Go server and within the React application:

Environment variable	Default	Description
ENABLE_DATASET_IMPORT	true	Displays the screens to allow filterable datasets to be imported through Florence (note: it requires the whole CMD stack to be running)
ENABLE_NEW_SIGN_IN	false	Enables the new sign in using the identity API (rather than zebedee)
ENABLE_NEW_UPLOAD	false	Enables the image upload functionality via static files service
ENABLE_PERMISSION_API	false
ENABLE_CANTABULAR_JOURNEY	false	Enables the cantabular journey

For example:

make debug BIND_ADDR=:20000

Run all tests

npm run test

Testing a single file

npm run test:file --file=<YOUR_FILE>

See CONTRIBUTING for details.

Released under MIT license, see LICENSE for details.