Add permits profile for permits and licences - #2
Merged
Merged
Conversation
Building permits and business licences are the highest-volume records most governments hold. schema:GovernmentPermit is a real type and supplies the grant itself - issuedBy, validFrom, validUntil, validIn - but nothing about the application that produced it: who applied, when, what was decided, what it concerns, what it cost, on what conditions. That is where nearly all the public interest lies, so those fields are minted here. permitType is deliberately generic. The same permission is a building permit in the US, planning permission in the UK, a permis de construire in France and a Baugenehmigung in Germany, so a code list of national names would not travel. BLDS is the closest existing standard and is US-only, which is why this profile takes the _core scheme-qualified identifier approach rather than adopting it. Refusals, withdrawals and revocations are in the status list, not only the happy path: a dataset containing only granted permits cannot answer what proportion of applications succeed, which is one of the main questions asked of this data. Processing time is enforced rather than assumed. applicationDate with decisionDate is what makes 'how long does this take' answerable, so the validator rejects a permit decided before it was applied for, completed before it was decided, expiring before it becomes valid, or marked issued or completed with no decisionDate. applicant is optional by design. A business licence names a business and that is public; a residential building permit ties a named private individual to their home address, which is a disclosure decision the authority must take deliberately rather than one the schema forces. The fixtures show both - a company named on a commercial conversion, and a residential repair published with the works, value and dates but no applicant and no street address. 10 profiles, 29 schemas, 32 code lists, 292 namespace URLs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Building permits and business licences are the highest-volume records most governments hold. schema:GovernmentPermit is a real type and supplies the grant itself - issuedBy, validFrom, validUntil, validIn - but nothing about the application that produced it: who applied, when, what was decided, what it concerns, what it cost, on what conditions. That is where nearly all the public interest lies, so those fields are minted here.
permitType is deliberately generic. The same permission is a building permit in the US, planning permission in the UK, a permis de construire in France and a Baugenehmigung in Germany, so a code list of national names would not travel. BLDS is the closest existing standard and is US-only, which is why this profile takes the _core scheme-qualified identifier approach rather than adopting it.
Refusals, withdrawals and revocations are in the status list, not only the happy path: a dataset containing only granted permits cannot answer what proportion of applications succeed, which is one of the main questions asked of this data.
Processing time is enforced rather than assumed. applicationDate with decisionDate is what makes 'how long does this take' answerable, so the validator rejects a permit decided before it was applied for, completed before it was decided, expiring before it becomes valid, or marked issued or completed with no decisionDate.
applicant is optional by design. A business licence names a business and that is public; a residential building permit ties a named private individual to their home address, which is a disclosure decision the authority must take deliberately rather than one the schema forces. The fixtures show both - a company named on a commercial conversion, and a residential repair published with the works, value and dates but no applicant and no street address.
10 profiles, 29 schemas, 32 code lists, 292 namespace URLs.