Application: local-links-manager

Manages local links from local authorities on GOV.UK

• GitHub: local-links-manager
• Ownership: #govuk-patterns-and-pages-tech
• Category: Publishing apps
• Links:
  • local-links-manager.publishing.service.gov.uk
  • Sentry (error tracking)
  • App dashboard: request rates, errors, durations
  • Kibana App Logs (Production, last 3 hours)
  • Kibana Worker Logs (Production, last 3 hours)
  • Argo CD (local-links-manager)

Example pages published by local-links-manager

• Reigate and Banstead Borough Council
• South Ribble Borough Council
• Epping Forest District Council
• North Hertfordshire District Council
• Torridge District Council
• Staffordshire Moorlands District Council
• Flintshire County Council
• Halton Borough Council
• East Lindsey District Council
• London Borough of Bromley

README

Admin interface for managing Local Authorities’ links including all their services and interactions.

For example, this service uses Local Links Manager to determine the URL of the garden waste disposal page on the Local Authority website which corresponds to the postcode a user has entered.

Note that Local Links Manager does not determine a user’s Local Authority based on their postcode.

This app maps RESTful URLs onto a persistence layer. It doesn’t face public users.

Nomenclature

• SNAC - Standard Names And Code - The old identifier code for locations. This is being phased out in favour of GSS codes.
• GSS - Government Statistical Service - The new identifier code for locations.
• LGSL - Local Government Services List
• LGIL - Local Government Interactions List

Both LGSL and LGIL codes are used for the lookups for each Local Authority and its service interactions.

Technical documentation

This is a Ruby on Rails app, and should follow our Rails app conventions.

You can use the GOV.UK Docker environment to run the application and its tests with all the necessary dependencies. Follow the usage instructions to get started.

Running the bare application without any test data isn’t very useful, you can replicate the app’s Postgres database using GOV.UK Docker.

Use GOV.UK Docker to run any commands that follow.

Running the test suite

$ bundle exec rake

Further documentation

• Enable or create a service
• Removing a service
• Deleting a local transaction link
• Importing Local Authorities data
• Exporting Local Authority links to services
• Checking links
• Example API output

Licence

MIT License