OCP-01-Permit Issuing

Owned by Aneta Pałczyńska (Deactivated)
Last updated: Oct 24, 2023
5 min read

USE CASE STEP 

USE CASE: Online Construction Permit

STEP: Permit Issuing

TYPE: Online Permit Issuing
GitBook

PRECONDITIONS 

(list of conditions that MUST be met in order to be able to successfully execute this process)

  • Applicant’s construction permit application has been reviewed and approved successfully.

  • Optional in-person building site inspection has been conducted.

  • Permit construction standards of structural safety, fire safety, the control of toxic substances, ventilation, sanitation, fall-protection and general safety measures have been met and will be implemented during the design, installation and inspection of building construction works.

  • Applicant has the ability to accept payments as specified in the program (for example bank account).

  • Applicant has the ability to accept messages as specified in the program (for example email).

  • Applicant’s National Identification Number can be mapped to payment information coming from Payments BB mapping.

  • Ministry's or the municipalities' websites have infrastructure ready for storing and processing data involved in permit issueing process.

  • All necessary building blocks and workflows have been set up (including Scheduler BB and workflows connected to it from previous steps).

DATA INPUTS 

Data inputs will/ might be country/ municipality specific and thus here are listed these

Note: Details on Data Inputs will most likely depend on Building Blocks that are not yet available. For now high level inputs are listed.

  • permit

  • application

  • applicant

  • notification

ACTORS 

Human

  • Leading Organization (Ministry of Urban Development, housing and planning) or Government’s platform

  • Participators group(s) (citizens and professionals seeking the permit approval)

System 

  • Consent BB

  • Digital Registries BB

  • Information Mediator BB

  • Payments BB

  • Messaging BB

  • Scheduler BB

  • Workflow BB

NORMAL COURSE 

Description

Participator of the program will be issued a permit and notified via the permit issuing platform and/or be printed out the permit document with an official stamp.

Provided that

Their application was reviewed and approved, any optional in-person inspections have been conducted and all outstanding fees have been paid.

Step 1: Check the status of participator’s application

Description: System or governmental officials checks if the application was reviewed and successfully approved and if no payments are due and the application can be proceeded to be closed and permit be issued.

Step 1.1: Check whether the application was approved or not

Feature: Check the status of an application Scenerio: Participator's application has been approved Given the application has been approved And any optional in-person checks have been conducted When governmental official doesn't see any outstanding issues Then the application is ready to be closed And permit is ready to be issued

Relevant Digital Registries BB endpoints:

  • /data/{registryName}/{versionNumber}/{uuid}/readValue/{field}.{ext}

    • Verify that the application was reviewed

    • Verify that no additional checks are needed

Step 1.2: Check whether all fees were paid

Feature: Check payments for the permit of an application Scenerio: All payments connected to the application were paid Given the application has been approved And all final payments have been paid When governmental official doesn't see any outstanding issues Then the application is ready to be closed And permit is ready to be issued

Relevant Payments BB endpoints:

  • /api/v1/batch/detail

    • Check details of a payment

Step 2: Permit issuing

Description: Creating a workflow for procuring the permit and notifying all relevant individuals/stakeholders. Permit is issued on an official platform used for permit issuing. Governmental official can either use the created workflow or issue the permit manually.

Step 2.1: Create a workflow for issuing a permit (optional)

Feature: Create new workflow Scenerio: Create new workflow for issueing permit for the approved application Given that the application is ready to be closed And permit is ready to be issued When governmental official connects Workflow BB to Digital Registries BB And initilizes the workflow creation And governmental official sets the change of a the status of the application to "Permit Issued" as trigger And a new permit document is automatically created after the status change And all data from the application match data in the new permit document And the new permit document is uploaded on a governmental platform for issued permits Then new workflow is created And new trigger is created And a whole workflow is saved

Relevant Workflow BB endpoints:

  • /processes

    • POST a new process

Relevant Digital Registries endpoints:

  • /data/{registryName}/{versionNumber}

    • GET an application to check it

  • /data/{registryName}/{versionNumber}/update

    • UPDATE the application’s status

  • /data/{registryName}/{versionNumber}/create

    • CREATE a permit document

Step 2.2: Create workflow for notifing the participator of the issued permit (optional)

Relevant Workflow BB endpoints:

  • /processes

    • POST a new process

Relevant Messaging BB endpoints:

  • /send/email/single

    • Send email

Relevant Scheduler BB endpoints:

  • /event/modifications

    • Changes details of specific event

Relevant Consent BB endpoints:

  • /service/individual/{individualId}

    • GET the participator’s consent status

Step 2.3: Issue and publish the permit

Relevant Workflow BB endpoints:

  • /processes/{processId}

    • GET information about a workflow

  • /processes/{processId}/start

    • POST - initialize a workflow

Step 2.4: Notify the participator of the issued permit

Relevant Workflow BB endpoints:

  • /processes/{processId}

    • GET information about a workflow

  • /processes/{processId}/start

    • POST - initialize a workflow

Relevant Messaging BB endpoints:

  • /send/email/single

    • Send email

Step 3: Verify the issued permit authenticity and validity

Description: When there is a verification onsite for the construction, a governmental official conducting the verification can validate the permit of the person responsible for the construction.

Relevant Digital Registries endpoints:

  • /data/{registryName}/{versionNumber}

    • GET - checks the permit

ALTERNATIVE COURSE 

Participator of the program is notified that the permit was issued and needs to go to the local authorities to receive a physical copy of a permit document.

DATA OUTPUT 

Issued permit information is available on the governmental platform.

POST-CONDITIONS (SUCCESS CRITERIA)

  1. Applicant is informed about the successfully issued permit.

  2. Successfully issued permit is noted in the governmental and/or local database.

EXCEPTIONS 

  • Participator’s application was not approved

  • Participator hasn’t finished their payments

  • Participator has invoked their consent for communication

RELATED BBs

  • Consent BB

  • Digital Registries BB

  • Information Mediator BB

  • Payments BB

  • Messaging BB

  • Scheduler BB

  • Workflow BB

SEQUENCE DIAGRAM