"Clearance" is a tool for producing OpenStreetMap data extracts and keeping them up to date while respecting quality rules.
It is based on partial and local updates incoming from OpenStreetMap changes. Changes may be rejected as not respecting quality rules. Thus, data must be fixed in OpenStreetMap, or accepted as is. This project helps to review the rejected data and accept changes when considered OK.
See on the Clearance project how it works.
The frontend home page lists all available projects. A project is a community based on a territory and a theme, sharing the same interest and agreeing to share the work of maintaining quality on some OpenStreetMap object types with the same quality rule set.
Each project contains a number of OpenStreetMap objects not complying with the quality rules and to be reviewed.
Each project also has a lag update delay, denoting when the last update from the original OpenStreetMap occurred. Extracts for OpenStreetMap FR are updated minutely and extracts from Geofabrik are updated daily.
Each project's details list OpenStreetMap changes to be reviewed according to the thematic interest and quality rules defined by the project configuration. Changes not targeted by rules or out of the area of interest are applied silently.
The changed objects may be filtered by thematic, OpenStreetMap contributing users...
The changes are spatially grouped, also known as LoCha. The validation should be done at the LoCha level to ensure local consistency.
For each object, there is a report of geometry and tags before (the current valid state) and after (the incoming changes from original OpenStreetMap). It may contain information about OpenStreetMap users contributing the changes and information about why quality rules have rejected the changes.
When the incoming state is not desirable, the data should be fixed in the original OpenStreetMap. Then, wait for the next update from OpenStreetMap.
If after the incoming update from OpenStreetMap the data now complies with the quality rules, the objects will disappear automatically from the review list.
In case the incoming changes from OpenStreetMap are desirable, the data can be accepted manually with the blue check button ✓. Only logged-in users with write access to the project can consider accepting incoming data manually.
Make sure to install the dependencies:
yarn install
Create a fresh environment variable file
cp .env.template .env # Set your variables accordingly
Start development server on http://localhost:3000
# On local computer
yarn dev
# Or with Docker Compose
docker compose up
npx @eslint/config-inspector
Visit http://localhost:7777/ to view and play with your ESLint config
Add DSN key and environment in .env file.
NUXT_PUBLIC_SENTRY_DSN="FILL THIS OUT"
NUXT_PUBLIC_SENTRY_ENVIRONMENT=production
Build the application for production:
yarn generate
yarn start
Locally preview production build:
yarn preview