Make a production profile for an authority

A production profile lets you deliver to an authority without the PROFILE NOT AUTHORITY-VERIFIED marking. It is a new file, not a change to ruumica. This page is for the office person who prepares it together with whoever operates the server.

Before you start

You need two things from the authority, for example the city of Tallinn:

1. its layer and symbol specification for as-built drawings: layer names, colours, line types, symbols and title-block fields;
2. at least one drawing it has accepted, as a DXF file.

Steps

1. Put the accepted drawing in fixtures/authority/ee/, named after the authority: fixtures/authority/ee/tallinn-sample.dxf. If its licence does not allow sharing it, it stays out of the repository, and only its fingerprint is recorded.

2. Take its fingerprint:

   sha256sum fixtures/authority/ee/tallinn-sample.dxf
   

3. Copy the provisional profile to a new file named after the authority. Never edit ee.default.v1.toml itself; it stays the provisional default:

   cp profiles/ee.default.v1.toml profiles/ee.tallinn.v1.toml
   

4. In the new file (Export profile file):

   • set id = "ee.tallinn.v1";
   • replace every layer, colour, line type, symbol and title-block tag with the specification’s;
   • set authority_spec to the specification’s title and date;
   • set sample_dxf_sha256 to the fingerprint from step 2;
   • set production = true.

5. Export a project with the new profile, then check the drawing against the profile and the accepted drawing. The check reads the drawing back, compares every coordinate with the database, and requires every layer of the export to be a layer of the accepted drawing:

   asbuilt export --project <project> --profile ee.tallinn.v1 --frozen-at <instant> --out check
   python3 -I scripts/oracle/dxf_audit.py check/<project>.dxf --profile profiles/ee.tallinn.v1.toml \
       --project <project> --frozen-at <instant> --authority-dir fixtures/authority/ee
   

Check

An export with --profile ee.tallinn.v1 works without --allow-unverified-profile, carries no banner, and its manifest.json records production: true.

What can go wrong

You see	Meaning	Do
production = true is not allowed while authority_spec is PENDING (or sample_dxf_sha256)	A production profile needs both.	Fill them in.
A layer of the export is not in the accepted drawing	The profile names a layer the authority did not use.	Correct the layer name from the specification.
A recorded fingerprint that does not match the drawing	The drawing changed or is another file.	Take the fingerprint again from the accepted file.

The whole procedure is rehearsed automatically on every self-test with a stand-in profile and drawing, so a real one works the first time.