OCP-01-Registration

Owned by Aneta Pałczyńska (Deactivated)
Last updated: Sep 27, 2023
7 min read

USE CASE STEP 

USE CASE: Online Construction Permit

STEP: Applicant Registration

TYPE: Online registration
GitBook

PRECONDITIONS 

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

  • Data sharing agreement between Registration BB and respective registries where information is queried from has been signed (contract) and respective REST API services in Information Mediator has been opened to Registration BB.

  • Applicant has already been registered in a national identification system (ID BB).

  • Applicant has assigned National Identification Number (ID BB) used in the GovStack system to determine identity

  • Applicant has not yet been registered for Online Construction Permit program

  • 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 registration process.

  • All necessary building blocks and workflows have been set up.

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.

Citizens

  • First Name

  • Last Name

  • National ID

  • Occupation

  • Contact Information:

    • Email Address

    • Phone Number

Specialists (Architects / Engineers / Supervisors /Town Planners)

  • First Name

  • Last Name

  • National ID

  • Occupation

  • Corporate Name

  • Corporate Unique ID

  • Certificate from Council of Architecture/ Other authorities

  • Educational Qualification

  • Contact Information:

    • Email Address

    • Phone Number

Consent Policy

  • Organization Name

  • Policy Name

  • Url

  • Jurisdiction

  • Industry Sector

  • No of days for data retention

  • Storage policy

  • Geographic Restrictions

Consent Record

  • Individual ID

  • Signature

  • Policy ID

Confirmation Email

  • Sender Name

  • Title

  • Content

  • Confirmation link

Registration Entry

  • Individual ID

  • First Name

  • Last Name

  • National ID

  • Occupation

  • Contact Information:

    • Email Address

    • Phone Number

  • Authorization Token

ACTORS 

Human

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

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

System 

  • Consent BB

  • Registration BB

  • Digital Registries BB

  • Identity BB

  • Information Mediator BB

  • Messaging BB

  • Workflow BB

External system

  • National digital registry

NORMAL COURSE 

Description

On condition a platform (web page) is created for registering applicants, and later processing their Construction permits and managing them, applicant will provide their personal details and submit them manually (fill in the form by hand using a computer) into this specialized platform.

Provided that

On the platform, a registration form will provide a list of initial details required to proceed with the registration (eligibility verification, required documents, required fees), so that applicant knows exactly what is needed to finish the registration process successfully.

Step 1: Applicant session id is saved for registration process after providing data for successful registration

Description: User’s session id is saved in order to finish the registration process. No data is yet saved at this point in database, just in the session.

Step 1.1: Applicant provides data in registration form

Feature: Registration form Scenerio: Applicant provides data in registration form Given Applicant has not yet registered in the platform And Applicant's National ID was not used to register And the eligibility criteria are listed And the platform is connected to Registry BB When Applicant fills in data fields correctly And their National ID pulls in chosen public data And the the data was validated Then Applicant is marked as eligible And Applicant is shown Consent Agreement

Relevant Digital Registries BB endpoints:

  • /data/{registryname}/{versionnumber}/{uuid}/read-value/{field}.{ext} or /applications/{fileId} (Registration BB)

    • Searches for the possible previous registration for the same National ID

Relevant Registration BB endpoints:

  • /eForms/{eFormId}

    • Fetches the Registration form

Step 1.2: Applicant has to sign the Consent Agreement

Description: The platform fetches the prepared Consent Agreement with data processing details for the Registration process to be successful.

Step 1.2.1: Fetch relevant Consent Agreement for the platform

Feature: Get Consent Agreement Scenario: Registration App retrieves Consent Agreement for Applicant   Given a Consent Agreement for Applicant registration exists in Consent BB And Registration App has Applicant's <ID> and auth token for the registration session   When Registration App fetches a Consent Agreement for user registration   Then Registration App gets a valid Draft Consent Agreement associated with Applicant's ID

Relevant Consent BB endpoints:

  • /service/agreement/{agreementId}/

    • Fetch agreement that will be managed by Registration App

  • /service/policy/{policyId}/

    • Get related policy  that will be managed by Registration App

  • /service/purpose/{purposeId}/

    • Get related purpose 

  • /service/agreement/{agreementId}/agreementdata/

    • Get related agreement data

Step 1.2.2 (optional): Create Applicant in Consent system

Description: Applicant is given a unique ID in the Consent BB

Feature: Create Applicant entry in the Consent BB registry   Scenario: Registration App create Individual in Consent BB on behalf of the Applicant  Given Applicant is not recorded in Consent BB  When Consent Agreement is send    Then Consent BB creates new Individual entity in Consent system

Relevant Consent BB endpoints: 

  • /service/individual/

    • Register Applicant in Consent system 

Step 1.2.3: Sign consent agreement for the Applicant

Description: When Applicant chooses to accept the Consent Agreement, the Consent Agreement is signed digitally and paired with the Applicant unique ID within Consent BB.

Relevant Consent BB endpoints: 

  • /service/individual/record/agreement/{agreementId}/

    • Create new Consent Record in the Consent system 

 

Step 2: Applicant is sent a confirmation email to access the platform

Description: After correctly filling in the form and singing the consent policy, user is send an email to confirm the registration process. By clicking the link in the email, their registration form is saved in Registry BB.

Relevant Messaging BB endpoints:

  • /send/email/single

    • Send confirmation email to the Applicant

Relevant Digital Registry BB endpoints:

  • /data/{registryname}/{versionnumber}/read

    • Fetch data from Digital Registry

  • /data/{registryname}/{versionnumber}/create

    • Save data in Digital Registry

 

Step 3: Applicant is authorized successfully, received a token and is logged into the app

Description:

Relevant Identity BB endpoints:

  • /authorize

    • Used to redirect and authorize applicant

Relevant Digital Registry BB endpoints: 

  • /data/{registryname}/{versionnumber}/exists

    • Can be used just to confirm the identity of the applicant.

  • /data/{registryname}/{versionnumber}/read

    • Can be used if we want to automatically pull all relevant applicant information available in population registry 

 

ALTERNATIVE COURSE 

  1. Applicant enters a specialized platform for issuing construction permits and provides their national id, which pulls information about the user into construction permit platform automatically.

  2. Applicant enters national digital registry system and can proceed with the online construction permit inside it.

DATA OUTPUT 

The successful completion of the registration process will result in validated Applicant data stored in digital-registry relevant for OCP decision making, new consent record for OCP processing purposes, confirmation and issuance of a program-specific ID that can be used by the Applicant future interactions with the program.

POST-CONDITIONS (SUCCESS CRITERIA)

  1. Applicant is informed about successful registration process.

  2. Applicant can submit and process their construction permit via the designated platform.

EXCEPTIONS 

  1. Applicant is a foreigner and there is no option to verify or authenticate data/applicant in the national registry. 

  2. Applicant is from a local community but has not been registered in the Population Registry/national registry. 

  3. Applicant has already been registered for Online Construction Permit program.

  4. Applicant does not accept data processing in Terms and Conditions or Privacy Policy regulations.

RELATED BBs

  • Consent BB

  • Digital Registries BB

  • Registration BB

  • Identity BB

  • Information Mediator BB

  • Messaging BB

  • Workflow BB

SEQUENCE DIAGRAM