Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Functional overview for stakeholders
This module enables Architects / Engineers / Supervisors /Town Planners etc. to register Online. Provision to migrate already registered Architects/ Engineers / Supervisors details in the system with current status and validity of registration. Provision to renew the registration.
Centralized Registration: Provide a single interface for the registration of all architects (across the state), who intend to do a transaction with the ULBs.
Online Application for Registration: Identify the applicant with reference to a unique ID. Capture the following minimum information of the applicant with appropriate validations.
Unique ID
Name
Address
Corporate Information
Certificate from Council of Architecture/ Other authorities
Educational Qualification
This module will also consist of the following:-
Facility for uploading of attachments as required by ULB for establishing identity and past experience etc.
Enable online submission of registration fee.
Assigning a unique application number to each applicant.
Enable tracking the status of the application.
The OBPS product features can be broadly classified as the following modules:
Online registration of Architects/ Engineers / Supervisors etc.
Online Real Time Scrutiny of Drawing/Plan
Submission of Application and uploading Documents
Application Process by the Department
Online Payment
Certificate
Notice
General requirements
Module 1: Online registration of Architects/ Engineers / Supervisors etc.
Approval of Applications: Enable the Competent Authority to approve/reject the applications for registration; based on a workflow system and business rules. Communication of successful registration/ rejection to the applicant through an e-mail alert & SMS.
Renewal of Registrations: Enable the Competent Authority to renew the applications for registration according to workflow/business rules. Communication of successful renewal will be sent to the applicant through an e-mail alert & SMS.
Search: Enable authorized officials to search the database for list of registered architects based on the ‘search’ criteria such as - line of business, turnover, past experience or as decided by ULB.
Help: Provide an online handbook and user manual for registration. Provide FAQs on the registration process. ULB official will provide help desk assistance for resolving architects queries on registration process.
Module 2: Online Real Time Scrutiny of Drawing/Plan
The Module enables the Architect/Engineer to submit the Drawing in Drawing Interchange Format(DXF) format from any Open Source CAD tools of their choice. The condition for the following are:
The drawing should adhere to the Standards stipulated.
The Standards will be provided to the Architect in the native format (DXF) .
The Module enables the Architect/Engineer to submit the Application for various Services as listed above along with required supporting documents. Under the current provision, the document checklist will aid the Architect/Engineer.
The scrutiny process is online realtime and the Architect/Engineer will get the detailed Scrutiny report within minutes of submitting the Plan.
Scrutiny reports will list the Bye-laws and sub-clauses with the approved values against the extracted values.
Based on the extracted value range validation will be done by the system.
Only on clearance of all the Rules Scrutinised the Report will reflect ACCEPTED.
On Accepted Report a unique number of the Scrutiny will be generated
Scrutiny Parameters for all types of building meant for different usage; as per building bye laws and approved master plan will be taken into scrutiny. The major Plan provisions are as under :
Plot area / shape
Road width details
MOS (Marginal open space)
Ground coverage
FAR (Floor area ratio)
Building height
Use of building (Floor wise including mixed use in floors)
Parking provision
Amenities
Components of building
Services Evaluation
Firefighting requirement
Green building norms
Rain Water Harvesting
Water supply
Water treatment
Solid waste management provisions
NOC required on the basis of drawing details
Module 3: Submission and processing of Application
The entire process from the time of submission of drawing to scrutiny completion is automatic without any human intervention and instantaneous.
If the Scrutiny report REJECT the drawing the Report will have the details of the clauses in which it was rejected and also the values of the parameters.
The Architect/Engineer can correct the drawing and can resubmit the drawing till he gets the approval.
Only on approval the unique reference number for the Scrutiny Report will be generated.
Only with this number the Submission of Application can be initiated.
The OBPS handles the Plan Scrutiny in Online Real time mode and there is no need for any wait time, once the Plan is drawn. Scrutiny gets completed in less than a minute..
From the Plan submitted by the Architect the System will generate all the relevant plan in PDF format automatically. These are the set of Plans which will be issued to the end user with certification on successful completion of the Application Process.
The Application can be filled and required documents can be uploaded by the Architect once he has the Plan Scrutiny Reference number.
On Submission the Citizen need to validate and self certify the Application.
Module -4: Application Process by the Department
Workflow is configurable as per the requirements and will be done during the Customisation phase of the Project
All approvals will be electronically signed (e-sign) with QR code
The application captures all relevant details for all internal and external agencies; relevant data needs to be forwarded to corresponding agencies for issuing NOCs.
SLA on NOC is also validated by the System. If the required date is passed without a reply from the NOC department the NOC will be taken as Deemed approved.
In addition a single window mechanism is also built into the system. This feature can be used by Departments which do not have the IT system for their process in full.
Provision for entering onsite inspection details and geo-tagged images (document upload facility) of the Site Inspection.
The product has for the staff and the management for viewing the completed and pending tasks / works / applications.
The product has features for Online single window system, and integrations with all internal and external agencies required to provide applicable NOCs/approvals (Fire Services, Water and Sewerage Department, Discoms, AAI, NMA, Forest, Labour, Factory Directorate)
A Statewide Dashboard is also available which can be used by State Administrators to see the flow of applications and the pendency or exceptions.
The product offers Security on User Authentication with Role based access
The product will generate various MIS reports as per requirements of the Departments from time to time. MIS reports based on the payment received, dues position, plans passed, pending proposals, delayed approvals be generated as per Department requirement.
The Product has well-defined inspection report format at various levels to guide the inspectors which is also configurable.
The Product incorporates digital signature (e-sign) for approval of application at different levels in the application system, Building permission letter, approved drawing, notices, letters, completion cum occupancy certificates etc.
Product has well defined service levels and the escalation matrix to officials regarding time limit for processing an application automatically in the system.
The Product after the Citizen validates the application the system will schedule the Document Verification visit date. This date can be rescheduled by both the parties once.
SMS/Email Alerts enabled in the Product
Document Verification Meeting
Field Verification
Fee Computed and Demand Generated
Plan Permit Approved and Digitally Signed
The Checklist for the Document Verification will be filled up by the officials on the Document Verification meeting. In the system the the Checklist is configurable.
The Product offers provision to incorporate the changes of building by-laws as intimated by the department in the application within time frame.
Product has the feature to capture the history of changes and based on the original application submission date the relevant rules will be taken into account for scrutiny.
The Product has the feature of provisioning ther Revoking/Cancelling of Building Permission.
On completion of the Document Verification the applicable NOC Departments will be addressed by the System for NOC.
Field Verification Schedule will be assigned by the System with reschedule option for both the parties once.
The officials can do the Field Verification, update the report in a checklist format and forward for approval
Module-5: Online Fee Payments
The solution is integrated with the payment gateway for Online Payments and facilitate for Fee collection, Fee calculation, refund calculation and generate online fee receipts based on the submitted Building plan.
Upon approval of the report and NOC clearances the Fees are computed automatically by the system.
The Fee computation uses the Plan Parameters and the applicable laws and rules of the State which are configurable.
The Plans in PDF will be generated by the System with QR Code without any manual intervention.
Citizen/Architect can pay the Fees Online
Upon payment of Fees Plan Permit Approval process will be initiated and approved with Digital Signature. The Permit has been incorporated with QR Code.
The Fees can be collected under various heads of accounts and the Reports for the collections against the Heads of Accounts will be generated. This will enable the user to account the collections accordingly.
Module-6: Certificate(s)
The product has provision to generate certificates with e-Sign/ digital signature and QR code which can be downloaded by the applicant.
Module-7: Notice(s)
The notices, acknowledgment letters, approval letters, deviation or the rejection letters will be system generated with e-sign.
Every communication sent/received from/by an applicant will be received online only and reflected in the case as well as in the reports which can be used in court cases & for any other purpose.
Module-8: General requirements
The software tracks delays in approval steps and maintain an audit log of the approval process steps.
System generates an alert against each application when it nears the time limit for disposing it.
The solution allows extraction of system logs to excel/pdf formats for internal analysis of cases.
The product have provisions where in providing basic parameters like certificate no., name, area etc. would generate basic information about approved certificate and hence would enable easy third party verification.
The Checklist, FAQ, User guide with video should be provided for end users.
The product provision to get month wise approved/ rejected/ pending application and status of pending approval.
Below mentioned table mention the functionality of the offered product as per the recommendations under the guidelines mentioned under the Ease of Doing Business(EODB) guidelines of 2019.
Manual processes related to scrutiny, approval, or rejection of building construction or renovation plans is a time-consuming process for both citizens and employees. The DIGIT OBPAS module automates the entire building plan approval process right from enabling online submission of plans, documents to initiating verification and final approval of the plan. Citizens can now track their plan approval or inspection status, pay fees online, download and print the Permit Order and Occupancy Certificate online. The module streamlines the building plan approval system with configurable workflows for effective management through different phases of approval.
Centralized login page for citizen, officials and stakeholders
Citizen functionalities
Online application submission - New construction
Occupancy certificate request
Field Inspection Report Capture
Pay fee online and generate permit order online
Inspection of applications and online status
Configurable workflow
Auto fee calculation
Online and offline payment collection
Rejection process
Revocation process
Configurable functionalities
None as of now.
Apply for building permits, occupancy certificates, register stakeholders, pay fees online and lots more
Manual processes related to scrutiny, approval, or rejection of building construction or renovation plans is a time-consuming process for both citizens and employees. The DIGIT OBPAS module automates the entire building plan approval process right from enabling online submission of plans, documents to initiating verification and final approval of the plan. Citizens can now track their plan approval or inspection status, pay fees online, download and print the Permit Order and Occupancy Certificate online. The module streamlines the building plan approval system with configurable workflows for effective management through different phases of approval.
Centralized login page for citizens, officials and stakeholders
Citizen functionalities
Online application submission - new construction
Occupancy certificate request
Field inspection report capture
Pay fee online and generate permit orders online
Inspection of applications and online status
Configurable workflow
Auto fee calculation
Online and offline payment collection
Rejection process
Revocation process
Configurable functionalities
This section contains all docs and information required to understand the OBPAS module, its key features, functional scope, and configuration details. Click on the links below to learn more about deploying, configuring, customizing, and using the OBPAS module.
OBPAS Roadmap
OBPAS Workflows
Navigation Tips
Click on the embedded links within the content to browse topic details
Use the Contents links available on the right side of the screen to move to a specific heading
Find the list of Related Docs links at the bottom of each page to browse through additional product details
Reach out to us through any of the below-mentioned contact channels for any assistance or additional information on OBPAS module deployment.
#147/J, 1st floor, 10th Cross, 12th Main, 3rd Block, Koramangala, Bangalore 560034
+91 80 4125 5708
contact@digit.org
DIGIT-Online Building Permission System (OBPS) enables local government to bring in transparency, accountability and time-bound service for the public. With DIGIT-OBPS, professionals like architects, engineers, supervisors can seek permission for construction of a building from any Urban Local Bodies/District Town and Country Planning/Centre for Municipal Administration with a speedy, hassle-free and user-friendly procedure, online.
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
The Fee Structure masters list contains the fee details applicable for processing specific services. All fee-related information collected by the authorities during the course of building plan approval is maintained in this masters.
Sr No. | Service Type* | Application Type* | Application Subtype | Fee Subtype* | BPA Fees* | Amount* | Calculation Logic |
---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify the combination of attributes for with the fee is defined and then fill into the given template.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
No objection certificates (NOC) are certifications or permissions acquired from various bodies like Airport authority, monument authority, etc before any construction activities actually take place.
To acquire a building permit, an applicant needs to acquire NOC from the concerned authorities. Add the specific authorities at the State/ULB level in the NOC Departments master list for automated processing of NOCs. Refer to the for details on State/ULB specific NOC requirements.
Sr. No. | Government Department* | Application type* | Integration Type* | SLA |
---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify all the departments, services and the approach on integration and then fill into the given template.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
Sr. No | Reform | Recommendation | Remarks | |
---|---|---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
All content on this page by is licensed under a .
All content on this page by is licensed under a .
Sr. No. | Checklist Parameter | Example |
---|
All content on this page by is licensed under a .
Sr. No. | Checklist Parameter | Example |
---|
All content on this page by is licensed under a .
1
Uniform Building Code
Enact a comprehensive uniform building code/building by-law with the following features:
● Prepare a uniform building code. The State may have separate sections within the uniform building code/ building by-law which apply to specific geographic areas or are under the administrative control of different agencies/ bodies
● OBPS Product offers these features: It has the functionality uniform building code, and the by-laws for the state can be configured.
● Applicable to all urban areas and industrial estates/parks in the State
● Bylaws can be configured by based on Usage.
● Provisions for risk-based classification of buildings
● Risk can be classified in the application.
● Accreditation programs and clear responsibilities for professionals including architects and engineers engaged in the construction process along with qualifications for accreditation under the program
● State Team's support is needed on this recommendation.
2
Master Plans
Develop Master plans/ Zonal plans/ land use plans with legal sanction for all urban areas and make it available online in public domain
● State Team's support is needed on this recommendation.
3
Construction Permit Approval
Mandate timelines such that the following approvals/ NOCs are provided within 45 days:
● Building Plan approval is granted within 30 days
● Plinth Inspection is done within seven days of intimation
● Final Completion/Occupancy Certificate is provided within eight days ( 7 days for inspection + 1 day for issuing the certificate)
OBPS Product offered has this functionality - it can be configured from state to state
4
Construction Permit Approval
Design and develop an online single window system for granting construction permits with following functionalities:
● A common integrated application provided on the online unique window system, for all internal and external agencies required to provide applicable NOCs/approvals (Fire Services, Water and Sewerage Department, Discoms, AAI, NMA, Forest, Labor, Factory Directorate)
● OBPS Product offered has this functionality: Integrated application - one window portal for all stakeholders are available
● Provision for making an online application with integrated payment without the need for a physical touchpoint for document submission and verification
● Online payment interface is present is OBPS Product offered
● The system should allow auto scrutiny of building plans from the compliance perspective according to the uniform Building Codes/Building By-law using AutoDCR (or similar) software
● Auto e-DCR scrutiny is available in the product offered based on the bylaws defined in the system
● Provision for e-intimation of commencement of construction
● OBPS Product offered has this functionality
● Provision for e-intimation of plinth level completion
● OBPS Product offered has this functionality
● Provision for online form for Completion/ Occupancy Certificate application with online payment of a fee
● OBPS Product offered has this functionality
● Provision for online issuance of the certificate of inspections
● OBPS Product offered has this functionality
● Provision for online issuance of digitally signed Completion/ Occupancy Certificate to the applicant
● OBPS Product offered has this functionality
5
Construction Permit Approval
Mandate that a single, joint site inspection will be carried out by all concerned authorities such as Fire, Water and Sewerage, Electricity, Labor (such as Factory license) Department and other internal Departments responsible for granting construction permits in urban areas and IDCs
● OBPS Product offered has this functionality
6
Construction Permit Approval
Implement a system which allows the grant of approval to Low-Risk buildings based on third party certification (during building plan approval and/or construction and/or completion stage) of structural design and architectural drawings across all urban areas and IDCs
● Grant of approval for the low-risk building is available in the product offered. Third-party certification is not necessary
7
Inspection by Building Proposal Office/ relevant agency as part of Building Plan Approval Process, Plinth Level Inspection and obtaining completion/ occupancy certificate
Publish a well-defined inspection procedure, a checklist on the Department’s web site and mandate that inspections (except in case of complaint-based inspection) shall be limited to the checklist
State Team's support is needed on this recommendation.
8
Inspection by Building Proposal Office/ relevant agency as part of Building Plan Approval Process, Plinth Level Inspection and obtaining completion/ occupancy certificate
Design and implement a computerised system which is capable of:
Yes, the product offered has this functionality
● Identifying buildings/areas that need to be inspected based on risk assessment
● Computerised allocation of inspectors
9
Inspection by Building Proposal Office/ relevant agency as part of Building Plan Approval Process, Plinth Level Inspection and obtaining completion/ occupancy certificate
Mandate online submission of the inspection report within 48 hours to the Department
● OBPS Product offered has this functionality
1 | new construction | PERMIT APPLICATION | | application fee | Application Fees | 50 | |
2 | new construction | PERMIT APPLICATION | Medium Risk | sanction fee | Additional Fees | 0 | |
3 | new construction | PERMIT APPLICATION | Low Risk | application fee | Land Development Charges | 50 | |
4 | new construction | OCCUPANCY CERTIFICATE | High Risk | sanction fee | Charges for Well | 50 | |
1 | Service type | Text | 256 | Yes | The type of OBPS service for which the fees is to be collected. Refer to the Data Table above for illustration |
2 | Application Type | Text | 256 | Yes | List of application types for which the fees are to be calculated. Refer to the Data Table above for illustration |
3 | Application Subtype | Text | 56 | No | Application subtype is mentioned here such as type of risk |
4 | Fee Subtype | Text | 256 | Yes | Type of fees so collected to be mentioned here. Refer to the Data Table above for illustration |
5 | BPA Fee | Text | 56 | Yes | The type of OBPS service for which the fees is to be collected. Refer to the Data Table above for illustration |
6 | Amount | Integer | 6 | Yes | Fee Amount collected is mentioned here. Refer to the Data Table above for illustration |
7 | Calculation Logic | Text | 1024 | No | Fees calculation logic if any is mentioned here |
1 | Airport Authority of India (AAI) | Permit | Web API | 15 |
2 | National Monument Authority (NMA) | Occupancy certificate | Manual | 15 |
1 | Government Department | Text | 256 | Yes | Name of the department from where a NOC has to be acquired. This needs to be provided and uploaded into the system |
2 | Application Type | Text | 256 | Yes | The type of applications for which NOC is required. Check the Data Table for illustration |
3 | Integration Type | Text | 256 | Yes | This is about the approach of integration to be adopted with government departments systems |
4 | SLA | Integer | 2 | No | Timelines required (if any) for the NOC to be acquired. This information needs to be updated in the SLA column |
1 | Make sure that each and every point in this reference list has been taken care of |
1 | Make sure that each and every point in this reference list has been taken care of |
Construction or renovation of buildings is regulated by Municipal Body in India. One must get permission from the ULB prior to construction. This process involves submitting the building plan to ULB along with other documents, ULB verifies the plan with other documents and approves the construction. The document which authorizes the construction is called “Permit Order” One must have this permit order with him till the completion of construction. ULB officials will inspect various stages of construction and make sure it is in compliance with the plan. When construction completed, after inspection Secretary provides a “Completion certificate” and finally will provide an “Occupancy Certificate”. This entire process is known as “Building Plan Approval”.
This section covers the high-level details of the functionalities available in the Building Plan Application system.
Centralized login page for citizen, official and stakeholders
Citizen functionalities
Online application submission - New construction
Occupancy certificate request
FieldInspection Report Capture
Pay fee online and generate permit order online
Inspection of applications and online status
Configurable workflow
Auto fee calculation
Online and offline payment collection
Rejection process
Revocation process
Configurable functionalities
Knowledge of Java/J2EE(preferably Java 8 version)
Knowledge of Spring Boot and spring-boot microservices
Knowledge of Git or any version control system
Knowledge of RESTful Web services
Knowledge of the Lombok library will helpful
knowledge of eGov-mdms service, eGov-persister, eGov-idgen, eGov-sms, eGov-email,eGov-user, eGov-localization, eGov-workflow-service,dcr, land-services, bpa-calculator will be helpful
in the case of IntelliJ, the plugin can be installed directly, for eclipse the Lombok jar location has to be added in eclipse.ini file in this format javaagent:lombok.jar
Here we are listing the configs apart from dependent service host, URLs, DB and Flyway configs.
kafka topics persister configs for eGov persister to save and update BPA Data
persister.save.buildingplan.topic=save-bpa-buildingplan
persister.update.buildingplan.topic=update-bpa-buildingplan
persister.update.buildingplan.workflow.topic=update-bpa-workflow
persister.update.buildingplan.adhoc.topic=update-bpa-adhoc-buildingplan
Receipt kafka topics where BPA application listens to move the application Status after payment completion
kafka.topics.receipt.create=egov.collection.payment-create
Config for Demand Business service codes for different fees to be paid for BPA
egov.receipt.businessservice=
BPA.NC_APP_FEE := Building Plan Approval Application Fee
BPA.NC_SAN_FEE := Building Plan Approval Sanction Fee
BPA.LOW_RISK_PERMIT_FEE := Building Plan Approval Low Risk Permit Fee
BPA.NC_OC_APP_FEE := Building Plan Approval Occupancy Certificate Application Fee
BPA.NC_OC_SAN_FEE := Building Plan Approval Occupancy Certificate Sanction Fee
Application and Permit Number Formats
egov.idgen.bpa.applicationNum.format=PB-BP-[cy:yyyy-MM-dd]-[SEQ_EG_BP_APN]
egov.idgen.bpa.permitNum.format=PB-BP-[cy:yyyy-MM-dd]-[SEQ_EG_BP_PN]
SMS Notification Topic to push the SMS and Notification’s to be sent by BPA module
kafka.topics.notification.sms=egov.core.notification.sms
Payment Notification Config
egov.ui.app.host=https://egov-micro-dev.egovernments.org
egov.usr.events.create.topic=persist-user-events-async
egov.usr.events.pay.link=citizen/otpLogin?mobileNo=$mobile&redirectTo=egov-common/pay?consumerCode=$applicationNo&tenantId=$tenantId&businessService=$businessService
egov.usr.events.pay.code=PAY
List of Application Statuses on which payment notification to be sent
egov.usr.events.pay.triggers=PENDING_SANC_FEE_PAYMENT,PENDING_APPL_FEE,PENDING_FEE
Validity of the permit order generated in no of months
egov.bpa.validity.date.in.months=36
Workflow code for the combination of applicationType , ServiceType
appSrvTypeBussSrvCode={"BUILDING_PLAN_SCRUTINY":{"NEW_CONSTRUCTION":"BPA,BPA_LOW"},"BUILDING_OC_PLAN_SCRUTINY":{"NEW_CONSTRUCTION":"BPA_OC"}}
Application Status on which SKIP_PAYMENT action to be considered
egov.bpa.skippayment.status=PENDING_APPL_FEE,PENDING_SANC_FEE_PAYMENT,PENDING_FEE
Business Service Code for WorkflowCode and Application Status
workflowStatusFeeBusinessSrvMap={"BPA":{"PENDING_APPL_FEE":"BPA.NC_APP_FEE","PENDING_SANC_FEE_PAYMENT":"BPA.NC_SAN_FEE"},"BPA_LOW":{"PENDING_FEE":"BPA.LOW_RISK_PERMIT_FEE"},"BPA_OC":{"PENDING_APPL_FEE":"BPA.NC_OC_APP_FEE","PENDING_SANC_FEE_PAYMENT":"BPA.NC_OC_SAN_FEE"}}
NOC application Integration configs
Config to validate the status of applicable noc’s status to allow the application to move forward from NOC_VERIFICATION_PENDING Workflow State
validate.required.nocs.statuses=APPROVED,AUTO_APPROVED,REJECTED,VOIDED
NOC workflow initiate action code to initiate the workflow of the NOC when the appliation reachers the respective nocTrigerState
egov.noc.initiate.action=INITIATE
NOC workflow void action code to void the applicable NOC’s, when the application moved to REJECTED State
egov.noc.void.action=VOID
NOC workflow action goes for AutoAprove to auto-approve offline NOC , while moving from NOC_VERIFICATION_PENDING to the next state
egov.noc.autoapprove.action=AUTO_APPROVE
egov-user - (Manage user)
tl-services - Stakeholder Registration (Registration process of Stakeholder is handled by this service)
egov-user-event (What’s New and Events)
egov-filestore (To store the documents uploaded by the user)
egov-idgen (To generate the application No, Permit No)
egov-indexer (To index the BPA data)
egov-localization (To use the localized messages)
egov-location (To store the address locality)
egov-mdms (Configurations/master data used in the application is served by MDMS)
egov-notification-sms (Service to send SMS to the users involved in the application)
egov-persister (Helps to persist the data)
egov-searcher (Search query used to simplify the search)
egov-workflow-v2 (Workflow configuration for different BPA application is configured)
pdf-service (Receipt’s, permit order etc.. and prepared)
billing-service (Create demands and bills for the fees to be collected)
collection-services (Create a receipt for the payment received for the bills)
bpa-calculator (Calculates the fees to be collected at different stages)
land-services (land information related to BPA application is stored)
dcr-services (get and validate EDCR data)
noc-services (NOC application)
Under the data/<state code> folder you can find the BPA which has all the MDMS JSON’s
master-config.json for BPA
Action Test : URL Actions adding
Access to the Roles for the above Actions
BusinessService Config for Fee’s to be collected
Application Fee, Sanction Fee BPA High/Medium Risk
Application Fee, Sanction Fee for BPA Low Risk
Application Fee, Sanction Fee for BPA OC
Tax Head for BPA High/Medium Risk
TaxHead config for BPA Low Risk
TaxHead config for BPA OC
TaxPeriod MDMS for BPA High/Medium Risk
TaxPeriod MDMS for BPA Low Risk
TaxPeriod Config for BPA OC
BPA Application Number format Config
BPA Permit Number format Config
BPA Receipt Number format config
BPA OC Receipt Number format config
BPA and BPA OC Workflow Stages
BPA workflow configuration is for Building Plan Approval Apply High and Medium Risk Types.
BPA OC workflow configuration is for Building Plan Approval Occupancy Certificate irrespective of RiskTypes
Both the workflow flows as depicted below.
In the above Flow Chart
Rectangle Indicates the Workflow State
Line connecting two states indicates the action
Action name is in black colour text
User Role who can take action is in Blue colour Text
Specific Configurations and How To’s
System allows configuring the Documents that can be visible, allowed to upload and Mandatory to move from the current state in DocumentTypeMapping MDMS as described in MDMS Details Table DocumentTypeMapping Row
Application Creation Sage
Process
DCR system is integrated to get the applicationType, serviceType and riskType based on the EDCR Number populated by the architect.
DCR system is integrated to validate the status of the EDCRNumber populated
New BPA or BPAOC application cannot be created if there is existing un ended( application status other than approved or rejected is considered as unended) application with the same EDCR
How To add new Document
Should add new documentType group in DocumentTypeMapping MDMS with the applicable applicationType, serviceType, riskType, wfState (refer existing sample for understanding)
Can configure allow, required as well as the order for each documentType
Initiated Stage
Process
NOC’s from the NocTypeMapping MDMS matching to the application data will get created
How To add new NocType
Should add new NOCType in NocTypeMapping MDMS
New NocType should add in noc-services application as well
Citizen Approval Pending Stage
Process
According to the example in the NocTypeMapping Data in the MDMS Details Table, Once BPA or BPA OC reaches this Staus all the Applicable Noc’s workflow would be initiated.
How to change NOC workflow initiation step
Should change the nocTriggerState in NocTypeMapping to the desired application status.
InProgress Stage
Process
Application fee Demand gets generated by the bpa-calculator
Notification to the Stakeholder and owner will be sent regarding the fee payment
How To change the Fee Amount
Will be discussed in bpa-calculator service
Document Verification Pending Stage
Process
Nothing Specific
How To
NA
FieldInspection Pending Stage
Process
At this stage, FieldInspector should answer the checklist questions and attached the documents which will be configured in checklist MDMS, as described in MDMS Details Table CheckList Row
Field Inspector can create multiple FieldInspection Reports
How to add new questions and documents
Should add/modify the questions for the desired combination of applicationType, serviceType, risktype
with the localization code for question text
specify the fieldType ( ass of now only YES/NO/NA only supported )
Should add/modify documents for the desired combination of applicationType, serviceType, risktype
Noc Verification Pending State
Process
NOC verifier can upload the Documents to the NOC application’s if available.
Offline Noc’s would get auto-approved while NOC verifier is forwarding the BPA or BPAOC application from the current state
BPA or BPAOC application cannot be forwarded if any NOC is not in matching the status configured for validate.required.nocs.statuses in application.properties
How to change the NOC application status to be verified to move forward
should update the validate.required.nocs.statuses property in value in application.properties with the list of status to be considered to move forward
Approval Pending Stage
Process
Approver can select the predefined conditions for approval updated in CheckList MDMS, as described in MDMS Details Table checkList Row
Approver can add new conditions as well for approval
Sanction fee Demand gets generated by the bpa-calculator
Notification to the Stakeholder and owner will be sent regarding the fee payment
How to add/remove/modify conditions
Should add/modify the conditions array for the desired combination of applicationType, serviceType, riskType
Approved Stage
Process
System generates PermitOrder for the application
System Stamps the validate date for the permit Order by adding the no of months configured for the property egov.bpa.validity.date.in.months in application.properties
How to change the validity period of the permit order which will generate from now
Change the value of the property egov.bpa.validity.date.in.months in application.properties file to the desired no of months
How to change Permit Order
Can be changed by changing the data and format configs of the permit order, please refer to PDFs section of Permit Order
Rejected Stage
Process
NA
BPA LOW Workflow
BPA with risk Type low has a separate workflow, which is almost the same as the BPA workflow as depicted below.
In the above Flow Chart
Rectangle Indicates the Workflow State
Line connecting two states indicates the action
Action name is in black colour text
User Role who can take action is in Blue colour Text
Specific Configurations and How To’s which are not common to BPA Workflow
InProgress Stage
Process
Application and Sanction Fee together gets calculated and Demand gets generated by the bpa-calculator
Notification to the Stakeholder and owner will be sent regarding the fee payment
How To change the Fee Amount
Will be discussed in bpa-calculator service
Document Verification Pending Stage
Process
System generates PermitOrder for the application
System Stamps the validate date for the permit Order by adding the no of months configured for the property egov.bpa.validity.date.in.months in application.properties
How to change the validity period of the permit order which will generate from now
Change the value of the property egov.bpa.validity.date.in.months in application.properties file to the desired no of months
Approved Stage
Process
NA
Revocated Stage
Process
System generates Revocation letter
How to change Revocation Letter format
Can be changed by changing the data and format configs of the revocation letter, please refer PDF’s section of Revocation letter
On Workflow action of Every Stage, System verifies the Documents Configured for the given stage of the workflow from the DocumentTypeMapping MDMS and validates the required Documents attached to move forward
DropDown values to be validated against the MDMS values, Value in those fields should be one of the MDMS value.
Notifications Message codes for SMS and User Events are prepared as follows
ApplicationType_ServiceType_WorkflowAction_ApplicationStatus.
Example BPA Apply Application (i.e applicationType is BUILDING_PLAN_SCRUTINY) with ServiceType NEW_CONSTRUCTION and the current application status is DOCUMENT_VERIFICATION_PENDING and workflow Action of the request is FORWARD then the localized message for this notification will be looked for the code: BUILDING_PLAN_SCRUTINY_NEW_CONSTRUCTION_FORWARD_DOCUMENT_VERIFICATION_PENDING
The message text for the above code is sent through SMS and Notification filling in the owner, serviceType, application Number and other values.
BPA supports below PDF’s
Building Sub Occupancy details refer to sub-categorization of primary occupancy types. For instance, residential buildings can be further classified as apartments or old age homes depending on the specific usage of the buildings. Refer to the National Bye-Laws to view the prescribed list of sub-occupancy types.
Sr. No. | Sub Occupancy Code* | Sub Occupancy Name* (In English) | Sub Occupancy Name* (In Local Language) | Occupancy Code* |
---|---|---|---|---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|---|---|---|---|---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify the sub occupancy which is applicable. Refer to National Bye-Laws to learn more about occupancy types and names.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
The list of services in the OBPS module refers to the various types of services offered to citizens or end-users. The Data Table below contains an indicative list of services and details required to configure the building plan approval module.
Sr. No. | Service Code* | Service Name* (In English) | Service Name (In Local Language) | Plan required for service * | Occupancy Certificate applicable for service | Plan Validity of this service (In Years)* | Renewal Validity of the service (in Years) |
---|---|---|---|---|---|---|---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|---|---|---|---|---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify the services provided by the DIGIT OBPAS system and enter them into the template with other configurable parameters given in the template.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
The computerised and automatic building permission system offered under the National Urban Stack(NUS) facilitates citizens who seek permission for construction of a building within any Urban Local Body with a transparent, speedy, hassle-free and user-friendly procedure. Online Building Permission System (OBPS) is one of the components of a smart city that has the capability of providing a single window for acquiring building permits, NOCs, and clearances from multiple agencies or departments. Keeping in mind the benefits associated with the product offered, the proposed system is about to be implemented in 500+ ULBs across the country in 15 states and Union Territories. (For details on product features refer to Section-2).
For the offered product, the implementation process can be divided into six major distinctive stages. Each stage has predefined entry and exit criteria, roles & responsibilities to assure objective monitoring and decision making for the overall success of the engagement. The whole implementation lifecycle is typical of 35-40 weeks keeping in mind the entry, and exit criteria defined at the beginning and end of each stage is met within the recommended time.
Stage Zero-program setup and onboarding is a pre-requisite for the initiative to kick-off and requires setup of the governance model, implementation Team and decision regarding other significant elements of the initiative like funding and procurement process.
Stage One of the initiative requires scoping of the initiative and deciding on the priorities for implementation by the state implementation Team.
In stage three, the state Team will work upon identifying and finding solutions to the significant gaps in the product offered w.r.t. to the needs of the state.
Configuration and customisation of the product offered in the primary objective of stage four. This involves working on various aspects of state-specific needs and incorporating them into the product suite offered.
In stage four and five, post doing UAT and including all the necessary feedback on the product, the roll-out of the product is done at the state level (Go Live) from a couple of ULBs to pan state coverage. (For details on the implementation plan refer to Section-3).
The whole implementation cycle requires a Team of individuals with specific skill sets to work very closely. The state implementation unit comprises individuals with Program management, business analysis, implementation engineering, software engineering, architecture (DCR Domain) and capacity building skills. Depending upon the phases of implementing the initiative is in, the amount of effort by each participant in the smaller units will vary. (For details on resource sizing and requirements refer to Section-5)
Based on close deliberations with various stakeholders, it is recommended that the budgetary allocation for the implementation of the initiative should be around 3 crores to 3.8 crores1 for statewide implementation and Operation and Maintenance Cost (per Year )for the initiative will be approximately 1.35 crores to 2.0 crores2. The budget allocated needs to be utilised for human resources requirements primarily. The budgetary allocation is recommended as per the NICSI standards published on https://www.nicsi.com/ (Check Annexure 1 for NICSI standard rates). The estimation of the budget will increase or decrease based on the rates applicable to the resources required. (For details on budgetary allocation guidelines refer to Section 5).
1 Assuming NICSI standard rate cards and 20% range on the actual estimated cost
2 Assuming NICSI standard rate cards and 20% range on the actual estimated cost.
This section provides an overview of the methodology for the state-wide implementation of OBPS. Implementation of OBPS is distributed across six distinct stages. Each stage has predefined entry and exit criteria, roles & responsibilities to assure objective monitoring and decision making for the overall success of the engagement. Details of each stage are defined in this section.
OBPS implementation program is expected to be completed within approximately 37 weeks with the resource deployment by the State and System Integrator(SI) Team (as defined below). However, it is critical that activities and exit criteria set for each stage are achieved to adhere to this timeline.
Set of initial critical activities that are undertaken on receiving a Letter of Enrollment from the state. Successful completion of these activities assures that the program is started with crucial personnel, System Integrator(SI) Teams and funds.
This stage envisages the in-person interaction of crucial State officials and implementation System Integrator(SI) Teams to kick-start the program. This stage may require multiple interactions/meetings with different interest groups. The principal objective of these interactions is to identify Pilot ULBs, create an active collaboration & Governance approach and agree on a high-level timeline for the engagement.
During the Solution design stage key state officials and members, who are subject matter experts, are expected to share state by-laws and also help interpret these laws for the System Integrator(SI) Team. This stage baselines the State-specific product features in the Product Configuration report.
Configuration & customisation stage, spread across 12 weeks, envisages configuration of the product as per the baselined Product Configuration report and identified state-specific customisations. Active involvement of domain experts from the state Team is required in this stage to validate the implementation of state by-laws.
During this stage, the active involvement of Pilot ULB officials is expected for thorough testing of the configured product. Training of the key ULB officials will also be undertaken during this stage, along with the promotion of the solution. The establishment of the State support Team and required processes are initiated in this stage.
On successful rollout in the Pilot ULBs, the solution will be rolled out to the rest of the ULBs in batches. Guidance and support from the State Team will be required to create the rollout plans and assure the necessary infrastructure for training and deployment is available at each ULB.
Note: The rollout phase needs to be detailed out for iterative activities of onboarding ULBs in batches.
This section outlines the activities involved in each stage of the implementation along with the responsibility and accountability of critical stakeholders - State, NUS Team and Implementation Team onboard.
OBPS Cell: OBPS Cell is the government-appointed body chaired by the Principal Secretary/Secretary, Urban Development Department with members from the Town and Country Planning Organization, Urban Development Department etc.
NUS Team: NUS Team is the National Program Management Unit established in Delhi which will provide all necessary support to the state concerning the implementation, Program Designing etc.
System Integrator (SI)Team: SI Team will be responsible for the rollout of the initiative in the state, providing all end to end support to the state w.r.t. The implementation of the products in the ULBs.
Execute - One who owns the accountability to complete the activity
Consult - One who may initiate, guide and in the process, handhold the execution of the activity
The summary of the budgeting is as per the NICSI rates(Please refer to annexure-1) and assuming a 20% range.
Note: Overall Budget Summary (in INR) is as per NICSI rates
Note: Designation mentioned above are as per designations known driving OBPS implementation at the state level as explained below
Project Sponsor: Is the Head of the OBPS Cell who will drive the project from the State Side
Plan Process Expert: The two resources that will provide the BPA application process and workflow. Validate the UAT in compliance with the expected outcome.
Development Control Rules Experts: they should have the domain skills on the drawings and plan along with the DCR rules of the State. They would provide the templatization of the DCR Rules, validate the same once configured in the Application and approve.
Nodal Officer: He would play the organise role who will provide all logistics support and scheduling of activities related to the project, Rollout and training of both Engineers and ULB officials across the State.
The Building Usage data allows States/ULBs to classify the buildings based on occupancy types, sub-types and its actual usage. Permits and approval process are dependent on the Usage type. The Data Table provides the details required to configure the Building Usage types. Refer to the National Bye-Laws to view the prescribed list of usage types.
Sr. No. | Usage Code* | Usage Name* (In English) | Usage Name* (In Local Language) | Sub Occupancy Code* | Sub Occupancy Name |
---|---|---|---|---|---|
Data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|---|---|---|---|---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify all the building usage and its mapping with sub occupancy and then fill into the template.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
Service-wise documents list tells about the documents required for processing of listed services. Citizens can view the checklist based on the selected service. States/ULBs can configure the list of supporting documents required for each service.
Sr. No. | Service Code* | Service Name | Document Name* | Is Mandatory?* |
---|---|---|---|---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|---|---|---|---|---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify the documents which are needed to avail the services and fill into the given template.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
Building Occupancy classifications help in categorizing structures based on the proposed use of the building. Occupancy categories determine the required permits and approvals. The Building Occupancy types data is hence a vital parameter used to define approval workflows in the OBPS module. Refer to the National Bye-Laws to view the prescribed list of occupancy types.
Sr. No. | Occupancy Code* | Occupancy Name (In English)* | Occupancy Name (In Local Language) |
---|---|---|---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|---|---|---|---|---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify the occupancy which is applicable. Refer to National Bye-Laws to learn more about occupancy types and names.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
Stakeholders refer to the technical persons and end-users of the OBPS system. The Stakeholders Type masters list allows the registration of stakeholders in the OBPS system. The list of stakeholders varies from one State/ULB to another.
Sr. No. | Code* | Stakeholder Type Name* | Stakeholder Permit Validity (In Years) | Limitations on construction |
---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
Town Planning Schemes masters list contains all building plan approval schemes and sub-schemes available for the benefits of the citizens. Create a list of the available schemes and map these schemes to specific Occupancy Types.
Sr. No. | Code | Sub Scheme* | Scheme* | Occupancy Code* | Occupancy Name |
---|
Data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify all the scheme and sub-schemes and fill into the given template.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
Feature release doc
The Stakeholder registration process is done to allow any user access to the Building plan approval portal. The user registers the application for the desired role. Upon approval of the application, the user gets the role based on the application. This role will be stake level role. The user can also register on behalf of the organisation.
Notes:
Users can register for one role with a mobile number only once
After submission of the application user login is required to pay and view the status of his application
The citizen will get a state-level role on approval of his application
Employees performing actions on user applications must have suitable state-level roles
License types: Engineer, Town Planner, Builder, Architect, Structural Engineer
Actors: Citizen, Document Verifier, Approver
States of any application: Initiated, Pending for payment, Pending for document verification, Pending for approval, Approved, Rejected
Promote latest MDMS
MDMS
TradeLicense:- added type field in existing records and added new trade types
StakeholderRegistraition:- Contains additional information for each of the trade types being used in BPA registration
Endpoints:
Please whitelist the endpoint from Zuul wherever required
/tl-services/v1/BPAREG/_create:- mixed (both whitelisted and auth based)
/tl-services/v1/BPAREG/_update:- mixed (both whitelisted and auth based)
Auth based access:- CITIZEN,BPAREG_DOC_VERIFIER, BPAREG_EMPLOYEE, BPAREG_APPROVER
/tl-services/v1/BPAREG/_search :- Citizen, Approver, Document Verifier
/tl-calculator/v1/BPAREG/_getbill:- mixed (both whitelisted and auth based)
Auth based access:- CITIZEN,BPAREG_DOC_VERIFIER, BPAREG_EMPLOYEE, BPAREG_APPROVER
Users:
Create users with state level roles(tenantId=’pb’) , BPAREG_DOC_VERIFIER, EMPLOYEE, BPAREG_APPROVER
Create an anonymous user(related to whitelisting). Please refer to the end of this doc
Workflow config file -
Service Builds (use these or newer builds from master)
Billing-service-5f944c55c5-4dqcx
TL-service: tl-services-db:42-bpa-work-9371fe2
TL-calculator: tl-calculator-db:10-bpa-work-128d676
Citizen - citizen:210-Nov-15-Release-49699801
Employee - employee:238-Nov-15-Release-49699801
Zuul: zuul:21-master-5368046
Workflow: egov-workflow-v2:9-WF_MULTITENANCY-40d533f
Restart user and encryption service
Persister Config
Localisation File:
SQL Query:
Please run the below SQL script to add state-level bank account:
insert into egf_bank ( id,code,name,active,tenantid) values ( '23','AXIS','AXIS BANK',t,'pb')
insert into egf_bankbranch(id,bankid,code,name,address,city,state,contactperson,active,createddate ,lastmodifieddate,tenantid) values ('8','23','123','Axis_Bank_Ltd_Punjab','Amritsar','Amrisar','Punjab','ABCD','t','2019-08-16 21:04:32.064' ,'2019-08-16 21:04:32.064','pb')
insert into egf_bankaccount(id,bankbranchid ,chartofaccountid,fundid , accountnumber,accounttype , active ,type, createddate, lastmodifieddate ,tenantid) values ('8','123','1234','12', '91101055559123', 'SAVINGS' ,'t' ,'RECEIPTS_PAYMENTS', '2018-08-16 21:24:48.837','2018-08-16 21:24:48.837','pb')
Add ANONYMOUS role and create a system user as given below
For automatic building plan scrutiny
Building plan approval (BPA) is one of the key activities performed by Urban Local Bodies and Planning Authorities. The Online Building Plan Application Software (OBPAS) automates the various steps in the plan approval process. The core intelligence of OBPAS resides in the automatic scrutiny of building plans with reference to the Development Control Regulations of the state. This functionality is called eDCR (eGov-DCR). It involves extracting the key plan parameters from the CADD drawing and evaluating the parameters against the defined rules in the State Development Control Regulations. Once the Plan Scrutiny is completed the application will be processed for other workflow stages like Document Verification, Field Verification, NOC Certificates, Fee Computation, and Permit Generation.
DIGIT offers the complete OBPAS as an open-source application and eDCR is an integral part of it. The automatic scrutiny capability provided by eDCR can be leveraged by States which already have existing BPA software through simple integration. This enables the States to reduce the manual and time-consuming process of evaluation of rules and ensures uniformity of evaluation.
This doc helps in understanding the integration process of eDCR Service with an existing Building Plan Application software. At a broad level, competencies in the below technical and functional areas are necessary for integrating eDCR system,
Integration expertise is backed by a sound understanding of the architecture of the existing ecosystem, its uniqueness, features, flaws, and a complete understanding of the challenges involved in making them successfully work together.
Subject matter expertise on Building Plans and DCR Rules to interpret DCR Rule Validation algorithm from the DCR Rules.
A good understanding of the configuration of the DCR Rule Validations in the Validation Engine of the eDCR Service
Note: The detailed training prerequisites for integrating eDCR into any legacy BPA system are listed in section.
The eDCR process typically involves the below sequence of steps,
Capture drawing files in DXF format along with city identifier
Submit DXF format drawing file to eDCR system for scrutiny
Collect generated reports from eDCR system with status as accepted or rejected. The eDCR system will generate additional information like floor-wise area details, compound wall length, number of wells, etc
The DXF file can be resubmitted any number of times into the system, irrespective of the acceptance or rejection status
An accepted status of the drawing indicates that it is validated and approved against all the bylaws configured in the system. The integrating system can use this for further processing
The eDCR status report and associated details can be retrieved at a later point also by sending the unique Transaction Number to eDCR system
The eDCR service has Extraction, Validation, and Repository as the key components. The architecture depicted here covers integration aspects and API requirements.
The diagram below clearly illustrates the process flow in the eDCR system. There are two major stages in the process:
Upload and Scrutinize Plan
Get Details (To check plan scrutiny status)
eDCR system will provide REST APIs to push drawing files (DXF format) along with a unique ID. The Integrating system will provide a unique Transaction Number. The same will be used by both systems to track applications.
eGov will publish two REST APIs.
Upload And Scrutinize Plan: The integrating system should call this API with the required parameters explained in the API structure. The system will scrutinize the plan and reply with a response as explained in the API structure. The Status "Accepted" indicates the plan is ready to use for further process. "Rejected" will indicate that either plan violates the rule or is missing basic information. Both rejected and accepted plans can be resubmitted. But eDCR system will consider each request as a new one.
Get Details: The integrating system will call this API with parameters specified in the API structure. The eDCR system will search for the details in the eDCR repository and respond with a) Status - accepted/rejected b) Scrutiny report c) Plan details (details present in Dxf) d) DXF file e) Generated Plan pdfs. If the transaction number or Autodcr number does not exist in the system, an appropriate message is published.
Note: The REST API reference information with Request/Response Structures, Request Urls, Methods, Status Messages, and Samples will be shared in subsequent documents.
For integrating eDCR the below knowledge and infrastructure requirements need to be addressed
State building by-laws with the latest amendments (hard or soft copy)
Subject matter expert (SME) from the ULB side, who understands the by-laws and building plan domain
An architect who can draw diagrams for the team to test – He or She should be able to understand the by-laws given by the SME and create diagrams to validate those by-laws in the diagram scrutiny
The technical team should have resources with 5+ years of experience in J2EE technology - Java, Spring, Hibernate, Postgress, Jboss/Wildfly, and GIT
The technical team should be equipped with LINUX machines preferably UBUNTU and the following
Maven v3.2.x
PostgreSQL v9.6
Elastic Search v2.3.5
Git 2.8.3
JDK 8 update 112 or higher
Eclipse or any IDE
Cloud instance for deployment (Azure / AWS)
BPA application and BPA Occupancy Certificate application has Fee involved. Based on the Application Type, RiskType and ServiceType Fee to be calculated and generates a demand for the calculated amount for Payment. This service used to generate Application Fee, Sanction Fee, Low Application Permit Fee, Deviation Charges for BPA application and Occupancy Certificate Application.
Knowledge of Java/J2EE(preferably Java 8 version)
Knowledge of Spring Boot and spring-boot microservices.
Knowledge of Git or any version control system.
Knowledge of RESTful Web services.
Knowledge of the Lombok library will helpful.
knowledge of eGov-mdms service, eGov-persister, eGov-idgen, eGov-sms, eGov-email, eGov-user, eGov-localization, bpa-services will be helpful.
bpa calculator services present in municipal services provide multiple functionalities like calculating Application Fee, Sanction Fee, Low Permit Fee, OC Deviation Charges, generating demands for a particular BPA, BPA OC applications, updating demands, The different functionalities provided by sewerage calculator services are:
The is present among the municipal services group of applications available in the eGov-services git repository with the folder name bpa-calculator. The spring boot application needs the Lombok* extension added in your IDE to load it. Once the application is up and running API requests can be posted to the URL and ids can be generated.
in case of IntelliJ, the plugin can be installed directly, for eclipse the Lombok jar location has to be added in eclipse.ini file in this format javaagent:lombok.jar
Business service codes for
BPA High/Medium Risk Application Fee
egov.demand.appl.businessservice=BPA.NC_APP_FEE
BPA High/Medium Risk Sanction Fee
egov.demand.sanc.businessservice=BPA.NC_SAN_FEE
BPA Low Risk Permit Fee
egov.demand.lowriskpermit.businessservice=BPA.LOW_RISK_PERMIT_FEE
BPA OC Application Fee
egov.demand.oc.appl.businessservice=BPA.NC_OC_APP_FEE
BPA OC Sanction Fee
egov.demand.oc.sanc.businessservice=BPA.NC_OC_SAN_FEE
Tax Head Code for
BPA High/Medium Risk Application Fee
egov.appl.fee=BPA_APPL_FEES
BPA High/Medium Risk Sanction Fee
egov.sanc.fee= BPA_SANC_FEES
BPA Low Risk Sanction Fee
egov.low.sanc.fee= BPA_LOW_SANC_FEES
BPA Low Risk Application Fee
egov.low.appl.fee=BPA_LOW_APPL_FEES
BPA OC Application Fee
egov.oc.appl.fee=BPA_OC_APPL_FEES
BPA OC Sanction Fee
egov.oc.sanc.fee= BPA_OC_SANC_FEES
External Application references
dcr-services (Use Edcr data )
egov-mdms ( Configurations/master by MDMS )
billing-service ( Generate and update demands )
bpa-services (Get the bpa application data for fee calculation )
bpa-calculator/v1/_calculate End point to calculate the Fee and create Demand with the applicable businessService and TaxHeads
Access MDMS Config
bpa-calculator cannot be accessed publicly, Only called by the bpa-calculator
Billing Service MDMS Config
BusinessService Config for Fee’s to be collected
Application Fee, Sanction Fee BPA High/Medium Risk
Application Fee, Sanction Fee for BPA Low Risk
Application Fee, Sanction Fee for BPA OC
TaxHead MDMS
Tax Head for BPA High/Medium Risk
TaxHead config for BPA Low Risk
TaxHead config for BPA OC
TaxPeriod MDMS Config
TaxPeriod MDMS for BPA High/Medium Risk
TaxPeriod MDMS for BPA Low Risk
TaxPeriod Config for BPA OC
NA
NA
NA
NA
NA
The is present among the municipal services group of applications available in the eGov-services git repository with the folder name bpa-services. The spring boot application needs the Lombok* extension added in your IDE to load it. Once the application is up and running API requests can be posted to the URL and ids can be generated.
Please refer to Swagger API for YAML file details. Link - .
``
``
Setup the locality Search query in the as a new entry. Add RoleAction Test and Role Action for the URL “
/egov-searcher/locality/bpa-services/_get
“
- Building Plan Approval Apply High/Medium Risk
– Building Plan Approval Apply Low Risk
- Building Plan Approval Occupancy Certificate Apply
Make sure the new documentType added exists in documentType of
All content on this page by is licensed under a .
Sr. No. | Checklist Parameter | Example |
---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Sr. No. | Checklist Parameter | Example |
---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Implementation of the Online Building Permission System (OBPS) requires meticulous planning and close coordination between various stakeholders at the centre and state level. The success of the initiative is dependent upon many factors like strong Program governance, availability of the trained resource, financial planning, targeted implementation Team onboarding, focus on last-mile capacity building and ensuring necessary support to urban centres. Achievement of all these factors will provide the most effective and efficient roll-out and adoption of the Building Permission System in the state.
Stage 0 - Program Setup/ On-Boarding | |
---|---|
Stage 1 - Program kick-off | |
---|---|
Stage 2 - Solution Design | |
---|---|
Stage 3 – Configuration & Customization | |
---|---|
Stage 4 – UAT & Go Live | |
---|---|
Stage 5 – Rollout | |
---|---|
Task/Activity | NUS Team | OBPS Cell | SI Team |
---|---|---|---|
Stage 2 - Solution Design | |||
---|---|---|---|
Stage 3 – Configuration & Customization | |||
---|---|---|---|
Stage 4 – UAT & Go Live | |||
---|---|---|---|
Stage 5: Rollout | |||
---|---|---|---|
Implementation Effort/Cost Summary (Stage 1 to Stage 5) (In Man-Months) | |||
---|---|---|---|
Operations and Maintenance Cost Summary per year(in Cr) | ||
---|---|---|
One time Cost for Statewide Implementation (Stage 1- Stage 5) | 3.0 Cr – 3.8 Cr |
---|---|
Resource Name | No. Of Resources |
---|---|
Sr. No. | Checklist Parameter | Example |
---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Sr. No. | Checklist Parameter | Example |
---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Sr. No. | Checklist Parameter | Example |
---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Identify the stakeholders and fill into the given template. Refer to the for more details on stakeholder types and defined limitations.
Sr. No. | Checklist Parameter | Example |
---|
All content on this page by is licensed under a .
Sr. No. | Checklist Parameter | Example |
---|
All content on this page by is licensed under a .
All content on this page by is licensed under a .
1
OAH
Old Age Home
वृद्धाश्रम
R1
2
AF
Apartment/Flat
अपार्टमेंट/ फ्लैट
R1
3
FH
Farm House
फार्म हाउस
R1
1
Sub Occupancy code
Alphameric
3
Yes
A unique identifier for the given sub occupancy type
2
Sub Occupancy Name (In English)
Text
64
Yes
Names for sub occupancy types. For example - Old age home, apartments, farmhouse
3
Sub Occupancy Name (In Local Language)
Text
64
Yes
Names for sub occupancy types in local language e.g. in Hindi, Telugu etc.
4
Occupancy Code
Reference
3
Yes
Corresponding Building Occupancy for the given sub occupancy type
1
Make sure that each and every point in this reference list has been taken care of
1
NC
New Construction
Yes
No
2
2
2
ADD
Addition
Yes
Yes
1
1
1
Service Code
Alphanumeric
64
Yes
Unique Identifier for the listed services for reference
2
Service Name (In English)
Text
64
Yes
Names of applicable services such as Permit for New Construction, Reconstruction, Alteration, or Demolition
3
Service Name (In Local Language)
Text
64
No
Service names in Local language
4
The plan required for service
Text
3
Yes
Building drawing (Plan) required to submit for the listed services. The radio button for marking Yes or No
5
Occupancy Certificate applicable for service
Text
3
No
Whether Occupancy Certificate requires to be generated for this service. Radio button to mark Yes or No
6
Plan validity for this service (In Years)
Integer
2
Yes
Define the validity period of the permit order generated for the listed service
7
Renewal Validity of the service (in Years)
Integer
2
No
It can be 1 or 2 or 3 years based on the State/ULB needs
1
Make sure that each and every point in this reference list has been taken care of
Key Activities
Setting up development environments
Customisation & configuration of DCR Rules
Customisation of BPA Workflow
Customisation of fee calculation
Development/customisation of reports and dashboards
Development/Integration of portal
Third-Party Integrations (NOC, Payment gateway, Digital signature)
Validation of DCR Rules
Updation of user manuals and other key documents
Preparation & execution of Test Cases
Setup support & maintenance processes & tools
Exit Criteria
Configured/Customized product that is fit for use by the State
Stage 0 - Program Setup/ On-Boarding
Appoint State Program Head/Nodal Officer
Consult
Execute
Identify funding for the program
Consult
Execute
Define State-specific procurement process
Consult
Execute
System Integrator(SI) Team Onboarding
Consult
Execute
Provide the state-specific resource and infrastructure requirements
Execute
Consult
Stage 1 - Program kick-off
Identify & agree on high-level scope and exclusions
Consult
Consult
Execute
Identify Pilot ULBs
Execute
Consult
Project kick-off meeting and stakeholders consultation
Consult
Consult
Execute
Product Walkthroughs
Consult
Execute
Define Project Steering Committee structure and Project Governance process
Execute
Consult
Identify Key Team Members from State/Client End for
DCR Plan Scrutiny
BPA Workflow Process and Standards
Infra requirements procurement
Project Management
Execute
Execute
Agreement on Deployment Priorities and high-level delivery timelines
Execute
Execute
Appoint Data collection Team and arrange for data collection asks for Pilot ULBs
Execute
Consult
Implementation of Team formation and appointment
Execute
Consult
Cloud Infrastructure procurement
Execute
Consult
Project Office Space allocation
Execute
Consult
Capture State-specific processes
Consult
Execute
Set-up Project Management processes
Communication
Escalations & Risk management
Status reporting
Execute
Execute
Identify the Team Members for the Project
Execute
Consult
Attend the Kick-Off Meeting
Execute
Consult
Depute Full-Time Team Members for
DCR Plan Scrutiny
BPA Workflow Process and Standards
Infra requirements procurement
Project Management
Execute
Consult
Provide inputs for the Detailed Scope and Requirements
Execute
Consult
Initiate the Procurement Process for the Infra
Execute
Consult
Initiate System Integrator(SI) Team procurement
Execute
Consult
Initiate Program for Capacity Building
Execute
Consult
Initiate master data collection from pilot ULBs
Execute
Consult
Sign Off Project Charter
Execute
Consult
Product Walkthroughs with subject matter experts (Urban Town Planners & Architects) and State implementation Team
Consult
Execute
Walkthrough on state by-laws, eDCR and product process flows.
Review DCRs captured in the template
Define OBPS feature implementation across phases/ULBs.
Provide process study questionnaires to identify product deviations
Define Artefacts to be collected during the study
Product documentation
Master Data templates
Execute (State bye-laws & EDCR)
Execute
Capture State-specific Product configuration requirements (if any) based on product walkthrough demos and discussions for Pilot ULBs
Consult
Execute
Coordinate and Organize Pre UAT Workshop with relevant stakeholders of identified Pilot ULBs
Execute
Execute
Preparation of Product Configuration Report
Consult
Execute
Capture state Bylaws into DCR template
Execute
Consult
Provide Test data (drawings to be uploaded)
Execute
Consult
Attend Product Demo and Offer required inputs
Execute
Consult
Validation of DCR Rules Templates
Execute
Consult
Participate in Pre UAT workshop and provide inputs for the Product configuration
Execute
Consult
Product Configuration Report Sign Off
Execute
Consult
Setting up development & UAT environments
Consult
Execute
Customization & configuration of DCR Rules
Consult
Execute
Customisation of BPA Workflow
Consult
Execute
Development of reports and dashboards
Consult
Execute
Development/Integration of portal
Consult
Execute
Third-Party Integrations (NOC, Payment gateway, Digital signature)
Consult
Execute
Validation of DCR Rules
Execute
Consult
Preparation & execution of Test Cases
Consult
Execute
Setup support & maintenance processes & tools
Consult
Execute
Provide clarification and guidance on the interpretation of state Bylaws
Execute
Consult
Test configured product and provide feedback
Execute
Consult
Provide support in integrating Third-Party State services/departments
Execute
Consult
Test product features and provides feedback
Execute
Consult
Support System Integrator(SI) Team in integration with Third-party solutions
Execute
Consult
Readiness Checklist
Consult
Execute
UAT guidelines
Consult
Execute
Pilot checklist
Consult
Execute
Marketing and public outreach strategies
Consult
Execute
Provide Training for Pilot ULBs (Architects, Users & trainers)
Consult
Execute
Provide User manuals and help documents
Consult
Execute
Getting Product Ready for UAT
Infra configurations and UAT deployment Master Data Finalization
Employee Data Finalization
Consult
Execute
Setting up support processes
Consult
Execute
Master Data uploads
Consult
Execute
Legacy data (if applicable) capture
Consult
Execute
UAT Support
Consult
Execute
Preparation/update User Manuals to make it relevant for State
Consult
Execute
Making the Pilot ULBs live
Consult
Execute
Testing and signoff
Execute
Consult
Identify and share issues & help analyse issues/defects
Execute
Consult
Deployment of Support Resources
Execute
Consult
Provision of Training Facility
Execute
Consult
Setting up of Support Center/Help Desk
Execute
Consult
Communicate with NOC Departments
Execute
Consult
Readiness assessment
Execute
Consult
Coordinate with Pilot ULBs to ensure public outreach
Execute
Consult
Ensure the announcement of the Pilot launch
Execute
Consult
Setting up a help desk to handhold ULBs undergoing Pilot
Execute
Consult
Setting up a review process to review the health of the Pilot launch for 2-3 weeks
Execute
Consult
Training the Architects (District Level)
Consult
Execute
Training the State/Client Users (District Level)
Consult
Execute
Stabilisation Period Support with On Field Support
Consult
Execute
Statewide Rollout
Execute
Execute
Operations and Support
Execute
Execute
Product Support
Execute
Execute
Provision of Training Facility at Districts
Execute
Consult
Program Management of Training
Execute
Consult
Program Management of Client/User Infra
Execute
Consult
Program Management of Rollout
Execute
Consult
Type of Resources
Effort(in Man-Months)
Total Cost(in Cr)
Program Management
Project Director
Program Manager
Project Manager
18
0.668
Configuration and Customization
Business Analyst
Cloud Engineer
Software
Engineer
63
1.658
UAT and Go Live support
Support Engineer
IEC Consultant
20
0.36
Capacity Building
Consultant
3
0.108
Help Desk
Helpdesk Support
15
0.09
District Level Support
Business Analyst
Support Engineer
Consultant
23
0.533
Total
142
3.417
Type of Resources
Total Budget Required(in Cr)
Program Management
Project Manager
0.432
Application Support
Business Analyst/ Support Engineer
0.84
Help Desk
Helpdesk Support
0.144
Hosting Infrastructure
0.28
Total
1.69
Recurring Cost (YoY)-(Operating and Maintenance Cost)
1.35 Cr – 2.0 Cr
Project Sponsor
1
Plan Process Expert
2
Nodal Officer
1
Development Control Rules (DCR) Expert
2
1
A-AF-AH
Apartment type
अपार्टमेंट प्रकार
AF
Apartment/Flat
2
A-AF-FR
Family residential
परिवार आवासीय
AF
Apartment/Flat
3
A-AF-RF
Residential flat
आवासीय फ्लैट
AF
Apartment/Flat
1
Usage Code
Alphameric
7
Yes
Unique Code for listed Usage name. It can be a combination of alphabets and numbers
2
Usage Name (In English)
Text
64
Yes
Type of usage of the building to be mentioned here
3
Usage Name (In Local Language)
Text
64
Yes
Type of usage of the building to be mentioned here
4
Sub Occupancy Code
Alphameric
7
Yes
Sub Occupancy code to be mentioned here. Maps the Building Usage details to specific sub occupancy type
5
Sub Occupancy Name
Text
64
No
Sub Occupancy Name to be mentioned here. Maps the Building Usage details to specific sub occupancy type
1
Make sure that each and every point in this reference list has been taken care of
1
NC
New Construction
Aadhar Card
No
2
NC
New Construction
Fire NOC
Yes
1
Service Code
Alphanumeric
64
Yes
Code of service - Refer to the service list to understand in detail
2
Service Name
Text
64
No
Name of service - Refer to the service list to understand in detail
Document Name*
Text
256
Yes
Name of documents which are needed to avail the service
3
Is Mandatory?
Text
3
Yes
It indicates if the provided document is mandatory or not to avail the service
1
Make sure that each and every point in this reference list has been taken care of
1
R1
Residential
आवासीय
2
E1
Educational
शैक्षिक
3
I1
Institutional
संस्थागत
1
Occupancy Code
Alphameric
2
Yes
Unique Code provided with respect to occupancy name. It can be numeric and alphanumeric as well
2
Occupancy Name (In English)
Text
64
Yes
Name provided for occupancy name which is used to configure in the OBPAS module. Refer to National Bye-Laws for more details
3
Occupancy Name (In Local Language)
Text
64
No
Occupancy Name in the local language. e.g. Hindi, Telugu, etc.
1
Make sure that each and every point in this reference list has been taken care of
1 | BLD | Builders | 2 | N/A |
2 | ARC | Architect | 2 | N/A |
3 | TPR | Town Planner | 5 | Can construct 3 floors building, up to a height of 300 mts. |
1 | Code | Alphameric | 3 | Yes | Unique Code provided with respect to Stakeholders type. It can be alphabetical, numeric, and alphanumeric as well |
2 | Stakeholder Type Name | Text | 64 | Yes | Name provided for stakeholder type which is ideally the technical qualification of the person registering |
3 | Stakeholder Permit Validity (In Years) | Numeric | 64 | No | All the permits (Permits to the stakeholders) have a validity period within which he/she is authorized |
4 | Limitations on construction | Text | 612 | No | Building Bye-laws defines and permits the limitations on the type of construction any technical person can take up to. This field captures such information |
Entry Criteria
Acceptance Letter sent by State
Exit Criteria
State Program Head/Nodal Officer Appointed
Identify funding for the program
Define State-specific procurement process
System Integrator(SI) Team Onboarding
Entry Criteria
Program setup is complete
Key Activities
Identify & agree on high-level scope and exclusions
Identify pilot ULBs
Project kick-off meeting and stakeholders consultation
Product Walkthroughs
Define Project Steering Committee structure and Project Governance process
Define phases of deployment
Agreement on Deployment Priorities and high-level delivery timelines
Exit Criteria
Implementation plan agreement with priority applications and broad timelines
Master data collection kickoff from Pilot ULBs
Implementation Team formed and appointed
Cloud Infrastructure procured
Project Office Space allocated
Capture State-specific processes
Entry Criteria
State by-laws and scope available to Implementation Team
Key Activities
Templatization of DCR Rules
Validation of Templatization
Pre-UAT workshop to define product configuration
Initiate collection of master data from pilot ULBs
Solutioning approach for identified gaps
Optional: Define uniform by-laws across ULBs. May require a Business Process Re- engineering effort
Exit Criteria
By-laws available in a required format and reviewed by state Team
Product Configuration Report Sign Off
Solution agreement for required state-specific customisations
Entry Criteria
Product Configuration Report has been Signed Off by the State
Customisation and solution approach agreement with State Team
Entry Criteria
Configured/Customized product ready to be deployed
Pilot ULBs available for UAT & Training
Key Activities
UAT Env Setup
UAT Testing
Issues/bug resolution
UAT Sign off from Pilot ULBs
Setting up the Production environment
Setting up Support Center & processes (Help Desk)
Training (Architects, Users, trainer)
Training the Support Resources
Marketing & promotion activities
Go Live & launch event
Exit Criteria
UAT Sign-off & Go Live for Pilot ULBs
Entry Criteria
Product/solution has been configured as per the baselined fitment study report, and the same has been tested by Key state members
Key Activities
ULB configurations
Logistics planning for training
Training the Architects/Users at the district level
Roll Out - All Locations
Stabilise product
Exit Criteria
Statewide Rollout in batches (of approximately 30 ULBs each)
1 | Make sure that each and every point in this reference list has been taken care of |
MDMS Name | MDMS Path | Description | Example |
ServiceType | Values for ServiceType Dropdown | NA |
Application Type | Values for Application Type Dropdown | NA |
Occupancy Type | Values for Occupancy Type Dropdown | NA |
SubOccupancy Type | Values for SubOccupancy Type Dropdown | NA |
DocumentTypeMapping | List’s out the documents required at the given stage of the application for Given ApplicationType, ServiceType, RiskType and WorklowState. In the docTypes we have
|
Above example indicates Documents from the common-master documentTypes starting with code(s) in the above example should be displayed in BPA Application UI when the Application of ApplicationType -BUILDINGPLAN_SCRUTINY ServiceType- NEW_CONSTRUCTION RiskType- LOW Workflow State - INPROGRESS Out of this, IDENTITY documentType is not allowed to upload in this stage and not mandatory. ADDRESSPROOF documentType is allowed to upload in this stage and mandatory to move forward from this stage. |
CalculationType | Used by bpa-calculator Service which Defines the Fee to be collected for Given ApplicationType, ServiceType, RiskType and feeType |
From the above example
|
RiskTypeComputation | Helps to Defines the RiskType of the Application based on the building Height and plotArea received from the EDCR System |
|
CheckList |
The Example indicates Four Questions with fieldType “YES/NO/NA“ ( Which indicates that field of type dropdown with Yes, NO and NA options) should be asked. Readable question will be available in 2. Used to configure the conditions for Approval Stage Condition checkboxes to be shown before approve which can be considered as Conditions for Approval |
2. Conditions for Approval Stage |
NocTypeMapping | Mapping of the NOC Types applicable for BPA ApplicationType, ServiceType and riskType From the Example AIRPORT_AUTHORITY, NOC_FIRE NOC’s are applicable for applicationType → BULDING_PLAN_SCRUTINY serviceType-> NEW_CONSTRUCTION riskType-> ALL ( Any ) NocTypes-> list out the NOC Type object and NOC Applications get created when BPA is created by the NOC’s Workflow would be initiated when the BPA application Status is equl to the nocTriggerState configured. ( According to this example, when the application status changes to Citizen Approval Pending, all the NOc’s workflow would be initiated) |
|
PDF Name | Description | Config’s |
BPA Permit Order | PDF Generated for the Permit Order on approval of the BPA HIGH and MEDIUM RISK Applications |
BPA LOW Permit Order | PDF Generated for the Permit Order on approval of the BPA LOW RISK Applications |
Revocation Letter | PDF of the Revocation Letter Generated when the LOW RISK BPA Application is Rejected |
Occupancy Certificate | PDF Germinated for the Occupancy Certificate on Approval of the Occupancy Certificate Application |
1 | SCM1 | Sub scheme 1 for Ward No. 1 | DTP Scheme for Ward No. 1 | R1 | Residential |
2 | SCM2 | Sub scheme 2 for Ward No. 1 | DTP Scheme for Ward No. 1 | C1 | Commercial |
3 | SCM3 | Sub scheme 1 for Ward No. 7 | DTP Scheme for Ward No. 7 | C1 | Commercial |
1 | Code | Alphanumeric | 64 | Yes | Unique code to record |
2 | Sub scheme | Text | 256 | Yes | Sub scheme name |
3 | Scheme | Text | 256 | Yes | Name of the schemes available at a ULB/state level |
4 | Occupancy Code | Alphanumeric | 64 | Yes |
5 | Occupancy Name | Text | 64 | No |
1 | Make sure that each and every point in this reference list has been taken care of |
MDMS Name | Path | Description | Example Json |
CalculationType | Used by bpa-calculator Service which Defines the Fee to be collected for Given ApplicationType, ServiceType, RiskType and feeType 2. Second Example defines the calculation logic to figure out the fee for the Service, considering the different parameters from EDCR information of the BPA. ParameterPath indicates the EDCR Response Data path to get the data point. from Indicates the from value of the data point to be considered to Indicates the to value of the data point to be considered MF multiplication factor to be considered to multiple the datapoint value to calculate the value when data point value falls between from and to UOM UOM to be considered to multiple the datapoint value and MF to calculate the Fee when data point value falls between from and to |
From the above example
|
This service is the major service supporting bpa-services which handles the data of the land like land details, owner information, unit, address and documents which has the complete information of the land.
Which can be used as input for the bpa-services to create and process the Building Plan Application.
This section covers the high-level details of the functionalities available Land Service
UI integrated as part of BPA screens
Ability to create/update Land Details
Knowledge of Java/J2EE(preferably Java 8 version)
Knowledge of Spring Boot and spring-boot microservices.
Knowledge of Git or any version control system.
Knowledge of RESTful Web services.
Knowledge of the Lombok library will helpful.
knowledge of eGov-mdms service, eGov-persister, eGov-idgen, eGov-user, eGov-localization will be helpful.
The Application is present among the municipal services group of applications available in the eGov-services git repository with the folder name land-services. The spring boot application needs the Lombok* extension added in your IDE to load it. Once the application is up and running API requests can be posted to the URL and ids can be generated.
in case of IntelliJ, the plugin can be installed directly, for eclipse the Lombok jar location has to be added in eclipse.ini file in this format javaagent:lombok.jar
Please refer to Swagger API for YAML file details. Link - API Specs.
Here we are listing the configs apart from dependent service host, url’s, DB and Flyway configs.
kafka topics persister configs for eGov persister to save and update land Data
persister.save.landinfo.topic=save-landinfo
persister.update.landinfo.topic=update-landinfo
egov-user - ( Manage user )
egov-filestore ( To store the documents uploaded by the user )
egov-idgen ( To generate the application No, Permit No )
egov-indexer ( To index the bpa data )
egov-localization ( To use the localized messages )
egov-location ( To store the address locality )
egov-mdms ( Configurations/master data used in the application is served by MDMS )
egov-persister ( Helps to persist the data )
There is not MDMS config for Land Service exists as of now.
Access MDMS Config
Action Test : URL Actions adding
Access to the Roles for the above Actions
NA
NA
NA
An illustrative guide to using the OBPAS module
The Building Plan Approval or BPA module allows stakeholders to submit building plans for approval by the concerned ULB departments. The construction or renovation of buildings is regulated by the Municipal Body in India. One must get permission from ULB prior to construction. This process involves submitting the building plan to ULB along with other documents. The ULB verifies the plan with other documents and approves the construction. The document which authorizes the construction is called Permit Order. One must have this permit order with him till the completion of construction. ULB officials will inspect various stages of construction and make sure it is compliant with the plan. Once the construction is complete, the Inspection Secretary inspects the building and releases a Completion certificate and finally an Occupancy Certificate. This completes the Building Plan Approval process.
The module supports the following key functions -
eDCR scrutiny
Online submission of application for building permits and occupancy certificates
Document Scrutiny
Field inspection report capture
Pay fee, generate permit order and occupancy certificate online
Inspection of applications and online status
Configurable workflows
Auto fee calculation
Send applications back to citizens or reject applications
Integration with NOC department
Refer to the table below to understand the different user roles and the scope of action linked to each role. The applicable user roles and action items can vary from one State to another. DIGIT customizes the workflows to suit the requirements defined at the State level.
This section of the user manual guides you through the user login process. Citizens can sign up to use the module through the online web portal or the mobile application login interface.
Refer to the Logging Into DIGIT page to learn more about DIGIT user registration, logging in, editing user profile, and logging out.
This section guides you through the details of using the BPA module for each role. Click on the relevant role below to learn more about how to use the module.
This page provides details on the Stakeholder Registration workflow in the OBPAS module. Citizens have the option to submit registration applications for various stakeholders such as architects and construction companies.
Users can apply for stakeholder application by clicking on the “Register as a Stakeholder”, and while going through the workflow, can add all the information, according to the question asked, in the middle of the workflow after the correspondence address Create API will be called, and at the end of the flow, a summary screen will be visible for the review of the answers and on clicking the submit button an Update API will be called which will change the status from Initiated to Applied and Registration Application will get updated.
The stakeholder Document Required screen is displayed after login, which helps the user to understand the necessary documents needed to complete the new registration for stakeholders. A citizen info card is also shown at the bottom of the page containing additional information such as the maximum size of the file that can be uploaded.
The TimeLine component is present on all pages. It informs the users about the steppers in completing the application for registration.
In this step, users need to provide information about the License type and Licensee.
The system asks for the type of license that the user is registering for. If the user selects architecture, then a new field is displayed i.e. architecture number. For all other roles, no additional information user is required. All the roles are populated from the MDMS.
Here users have to provide the information of the person for whom the license application is being generated. By default, the name and mobile number field will be automatically pre-filled with the logged-in user data. Edits to this detail are disabled. Applicants must fill in the remaining information accordingly.
In this step, users have to enter their address details.
Users have to provide a permanent address. This is mandatory information that the user needs to provide to move to proceed with the application.
Here user gets the option to either pre-fill the form with the permanent address provided earlier or enter a different address. Users can also skip this step as it is non-mandatory.
Clicking on the Next button calls the Create API. Further information is available in the technical Implementation details section.
This screen displays a list of documents and their type (in dropdown format) from the MDMS. The document list displayed is as per the role selected by the user in the license step. Users have to upload all the mandatory documents in order to proceed further.
Users can cross-verify the data entered throughout the flow on the Summary page. In case of any change or update required, the edit icon available adjacent to the section header allows the users to make the changes. It redirects users to the particular section page and the whole flow is repeated again in order to submit the application.
Along with the application details, the fee estimate for the corresponding application is also shown on the summary page.
The Update API is called for the BPAREG Application update. Update API snippet is given below:
If the API response is successful, the Acknowledgement Screen is displayed. Else, the Failed Acknowledgement Screen is displayed.
Click on the Make Payment option to pay the registration fees on the summary screen.
All the screen has been developed using the new-UI structure followed previously in FSM, PGR, PT and TL, few new components have been introduced such as TimeLine, Multi upload Document etc
The link for the Stakeholder Registration Main Index is given below, it can be used to understand the starting point of the flow:
The OBPAS module is segregated into a specified structure. The screen configuration details are available in the PageComponent folder and the configuration for routing of the pages is available in the config folder which is common for both citizens as well as employees. New components like TimeLine are defined in the component folder. Below is the snippet for folder structure and routing configuration.
The stakeholder config responsible for the routing of the pages is defined under the config folder. Click on the link below to access the code.
The Pages folder contains the high-level configuration for controlling the whole flow for citizens and employees. The flows for citizens include Apply flows, Send Back flows, Application details etc. These carry the index (the main starting point of the whole flow).
The main difference between the Stakeholder registration flow from the apply flow in other modules is that the Create API is called in between the flow and at the end, the Update API is called.
The code for Create API request object generation is found inside the correspondence address component. This API call is triggered when the user clicks on the Next button on the correspondence address page.
The hook used for this API call is Digit.OBPSService.BPAREGCreate(payload, tenantId)
and payload can be found inside the gonext() method in the following file:
Code reference:
The Utils folder basically contains all the methods that are used throughout the OBPAS module, and if any common method needs to be declared here, which in turn can be imported into other files.
For updating an application the Update API from BPAREG is called using the React hooks, which have been declared under hooks/elements/obps as OBPSService.
The response object from the Create API is used for the request object of Update API, with the addition of document details that the user has entered. This marks the status of the Application as Applied instead of initiated.
Below is the hook used for fetching the update API call.
This API is called in the Stakeholder Acknowledgement code, using the useEffect Hook.
Code reference:
Throughout the flow, a few of the page data is imported from MDMS. Following is the list of pages that use MDMS data. These pages .js files can be found under page components.
For calling the MDMS data, React Hooks are used, so that it could be shared throughout the modules. Below is the little code snippet for the MDMS call.
Localization keys are added in the ‘rainmaker-bpareg’ locale module. In future, if any new labels are implemented in the OBPS - Stakeholder (Citizen) they should be pushed in the locale DB under rainmaker-bpareg locale module. Below is an example of a few locale labels.
To provide the facility for the employee users to update the BPA application state.
The application details page is used to display the details of the application and also showcase all the actions that can be taken on the application.
The various step for the application:
In this step, the user can upload multiple documents and/or approve the already uploaded documents.
The user approves the uploaded NOC documents.
The user fills in the inspection details (date, time, question, remarks) and submits.
Here the user approves the required permit conditions and can also add new conditions.
All the screens are developed using the new-UI structure followed previously in FSM, PGR, PT, and TL. Certain new components have been introduced such as Multi-Document Upload, Approval Checks, etc.
Throughout the flow, some data is imported from the MDMS. Following is the list of MDMS data:
Checklist
RiskTypeComputation
Below is the MDMS config used to fetch MDMS data:
The localization module used across the OBPS module was rainmaker-bpa and rainmaker-common, out of which we initialized rainmaker-bpa with module initialization.
Technical Doc
DSS has two sides to it. One is the process in which the data is pooled into ElasticSearch and the other is the way it is fetched, aggregated, computed, transformed and sent across.
As this revolves around a variety of data sets, there is a need for making this configurable. So that, tomorrow, given a new scenario is introduced, it is just a configuration away from getting the newly introduced scenario involved in this flow of the process.
This document explains the steps on how to define the configurations for the analytics side Of DSS for OBPS.
What is analytics?
Analytics: Micro Service which is responsible for building, fetching, aggregating and computing the Data on ElasticSearch to a consumable Data Response. Which shall be later used for visualizations and graphical representations.
Analytics Configurations: Analytics contains multiple configurations. we need to add the changes related to OBPS in this dashboard analytics. Here is the location : configs/egov-dss-dashboards/dashboard-analytics at qa · egovernments/configs
Below is a list of configurations that need to be changed to run OBPS successfully.
Chart API Configuration
Master Dashboard Configuration
Role Dashboard Mappings Configuration
Each visualization has its own properties. Each visualization comes from different data sources (Sometimes it is a combination of different data sources).
In order to configure each visualization and its properties, we have a Chart API configuration document.
In this, visualization code, which happens to be the key, will have its properties configured as a part of the configuration and easily changeable.
Below is the sample ChartApiConfiguration.json data for the OBPS.
Click here to check the complete configuration
Master dashboard configuration is the main configuration which defines which Dashboards are to be painted on screen.
It includes all the visualizations, their groups, the charts which come within them and even their dimensions as what should be their height and width.
Click here for the complete configuration
Master dashboard configuration which was explained earlier hold the list of Dashboards which are available. Given the instance where Role Action Mapping is not maintained in the application service, this configuration acts as the Role-Dashboard mapping configuration.
In this, each role is mapped against the dashboard which they are authorized to see. This was used earlier when the role action mapping of eGov was not integrated.
Later, when the role action mapping started controlling the dashboards to be seen on the client side, this configuration was just used to enable the dashboards for viewing.
Click here to check the configuration
common-masters/uiCommonConstants.json
Click here to check the complete configuration
roleaction.json
Click here to check the complete configuration
Action test.json:
Click here to check the complete configuration
OBPS-State DSS consists of multiple graphs which represent the data of OBPS. Each graph has its own configuration which describes the chart and its type.
State DSS consists of the following charts in OBPS:
Overview-Revenue
Overview-Service
Total Cumulative Collection
Total permits issued vs Total OC submitted vs Total OC issued
Collection by Payment Mode
Top 3 Performing States/ULBs/Ward
Bottom 3 Performing States/ULBs/Ward
Permits Issued by Risk Type
Permits Issued by Occupancy Type
Service Report
More details about the respective charts are below:
Overview-Revenue: The Overview-Revenue chart contains multiple data information as below in the selected time period.
Today's Collection - This represents today’s collection amount for OBPS Application Fee + Permit Fee.
Total Collection - This represents the total collection amount for OBPS Application Fee + Permit Fee.
Overview-Service: The Overview-Service chart contains multiple data information as below in the selected time period.
Total Plans Scrutinized - This represents the total number of plans submitted by an architect for scrutiny for new construction to the concerned authority.
Total permits issued - This represents the total number of new permits issued by the concerned authority.
Total sq m of land applied in the BPA system - This represents the total area in square meters approved for construction.
Avg. days to issue permits - This represents the average number of days taken to issue a permit application.
SLA Compliance (Permits) - This represents the total percentage of permits issued within SLA.
Avg. days to issue OC - This represents the average number of days taken to issue an OC.
SLA Compliance (OC) - This represents the percentage of OCs issued within SLA
Total Cumulative Collection: This graph contains the OBPS collection amount information on a monthly basis as a cumulative line graph for each OBPS collection separately. This changes as per the denomination amount filter selection.
line - this graph/chart is data representation on date histograms or date groupings.
Total permits issued vs Total OC submitted vs Total OC issued: This graph shows the total permits issued vs total OC submitted vs total OC issued for a given time period in the form of a line chart.
line - this graph/chart is data representation on date histograms or date groupings.
Collection by Payment Mode: This chart is a pie chart showing the bifurcation of total collections by payment mode (online, cash, card, cheque) which is the sum of revenue collected from the OBPS module for the applied date filter.
Top 3 Performing ULBs: This card will show the Top 3 Performing ULBs based on the percentage of permits issued. The number of permits issued / Number of applications.
Bottom 3 Performing States: This card shows the bottom 3 Performing States/ULBs/Wards based on the percentage of permits issued. Number of Permits issued / Number of applications
Permits Issued by Risk Type: This chart is a pie chart showing the bifurcation of total permits issued by risk type (low risk, medium risk, high risk) for the applied date filter.
Permits Issued by Occupancy Type: This chart is a pie chart showing the bifurcation of total permits issued by occupancy type (Residential, Institutional etc) for the applied date filter.
Service Report: This tabular chart representation graph shows information about multiple OBPS-related categories like Total Collection or Total Cumulative Collection, Total Plans Scrutinized, Total applications submitted, Total permits issued, Avg. days to issue a permit, SLA Compliance (Permits), Total OC Plans scrutinized, Total OC submitted, Total OC issued, Deviation Percentage, Avg. days to issue OC, SLA Compliance (OC), Total OCs with deviation. This table also shows the data at the state level and also has the drill-down chart for each state to ULB and from ULB to ward level data for the same.
Clicking on any DDR name drills down the charts to show the specified state data.
Clicking on the ULB navigates to the ward-level data for the specified ULB.
isRoundOff: This property is introduced to round off the decimal values. For instance, if the value is 25.43 by using isRoundOff property in the configuration, the value is displayed as 25. Similarly, if the value is 22.56 round of value is displayed as 23. This can be used for insights configuration as well for overview graphs.
Key(eg: bpaTotalCollection): This is the visualization code. This key is referred to in further visualization configurations. This is the key which will be used by the client application to indicate which visualization is needed for display.
chartName: The name of the chart which has to be used as a label on the dashboard. The name of the chart will be a detailed name. In this configuration, the Name of the Chart will be the code of Localization which will be used by the Client Side.
queries: Some visualizations are derived from a specific data source. While some others are derived from different data sources and are combined together to get a meaningful representation.
The queries of aggregation which are to be used to fetch out the right data in the right aggregated format are configured here.
queries.module: The module/domain level, on which the query should be applied i.e., OBPS
queries.indexName: The name of the index upon which the query has to be executed is configured here.
queries.aggrQuery: The aggregation query in itself is added here. Based on the Module and the Index name specified, this query is attached to the filter part of the complete search request and then executed against that index
queries.requestQueryMap: Client Request would carry certain fields which are to be filtered. The parameters specified in the Client Request are different from the parameters in each of these indexed documents.
In order to map the parameters of the request to the parameters of the ElasticSearch Document, this mapping is maintained.
queries.dateRefField: Each of these modules have separate indexes. And all of them have their own date fields.
When there is a date filter applied against these visualizations, each of them has to apply it against their own date reference fields.
In order to maintain what is the date field in which index, we have this configured in this configuration parameter.
chartType: As there are different types of visualizations, this field defines what is the type of chart/visualization that this data should be used to represent.
metric - this represents the aggregated amount/value for records filtered by the aggregate es query
pie - this represents the aggregated data on grouping. This is can be used to represent any line graph, bar graph, pie chart or donuts
line - this graph/chart is data representation on date histograms or date groupings
perform - this chart represents groping data performance-wise.
table - represents a form of plots and values with headers as grouped on and a list of its key, values pairs.
xtable - represents an advanced feature of the table, it has the addition capabilities for adding dynamic header values.
valueType - In any instance of data, the values which are sent for plotting, might be a percentage, sometimes an amount or sometimes just a count.
In order to represent them and differentiate the numbers from the amount from the percentage, this field is used to indicate the type of value that this visualization will be sending.
action: Some of the visualizations are not just aggregations of data sources. There might be some cases where we have to do a post-aggregation computation.
For example, in the case of the Top 3 performing ULBs, the target and total collection are obtained and then the percentage is calculated. In these kinds of cases, the action that has to be performed on the data obtained is defined in this parameter.
documentType: The type of document upon which the query has to be executed is defined here.
drillChart: If there is a drill down on the visualization, then the code of the Drill Down Visualization is added here. This will be used by Client Service to manage drill-downs.
aggregationPaths : All the queries will be having Aggregation names in it. In order to fetch the value out of each Aggregation Responses, the name of the aggregation in the query will be an easy bet. These aggregation paths will have the names of Aggregation in them.
insights: It is to show the data with the comparison of last year with arrow symbols, it will show the data in how much % is increased or decreased.
_comment: In order to display information on the “i” symbol of each visualization, Visualization Information is maintained in this field.
To provide the facility for the stakeholder users to create and submit the eDCR Application. Stakeholders include Architects, Builders.....etc.
Users can generate and submit the eDCR application by clicking on the “Registered Architect Login”, through which only registered stakeholders (Stakeholders including Architect, Builder.....etc) can log in. Other users will not be able to proceed further.
Stakeholders can generate the eDCR scrutiny number by clicking on Plan Scrutiny For New Construction link. They can add all the information, according to the questions asked, after filling in the information in the eDCR form click on the Submit button. This triggers the Create API call. The success or failure of the API routes the user to the acknowledgement screen. If eDCR API is Success => it routes to the acknowledgement screen. Stakeholders can see the eDCR number, application number and download option. If eDCR API is Failure => it routes to the acknowledgement screen. Stakeholders can see the application number and download option but not eDCR number.
Users need to provide their City, Applicant Name and Upload dxf file in order to generate the eDCR number.
The acknowledgement Page gets displayed after the success of eDCR creates call. Here stakeholders can see -
eDCR Number
Application Number
Download option for downloading the scrutiny report
Apply for the building plan permit button for creating the BPA application( OBPS BPA/OCBPA - ARCHITECT )
Go Back To Home button to navigate to the home page
The failure acknowledgement page gets displayed if the eDCR Create API call results in failure due to some reason. Here stakeholders can see -
Application Number
Download option for downloading the scrutiny report
Go Back To Home button to navigate back to the home page
Users can apply for the OC eDCR application by clicking on the Registered Architect Login link through which only registered stakeholders (Stakeholders including Architect, Builder.....etc) can log in. Other users will not be able to proceed further. Stakeholders can generate the OC eDCR scrutiny number by clicking on the OC Plan Scrutiny for new Construction link. They can add all the information, according to the question asked, and after filling in the information in the eDCR form steps clicking on the Submit button triggers the Create API call. Depending on the success or failure of the API call users are routed to the acknowledgement screen.
The Permit Date and Permit Number of BPA are required to generate the OC eDCR. The permit details enable the search for specific BPA records followed by a search for the OLD eDCR details (BPA eDCR). These details are used to generate the OC eDCR Number.
1. Data Required
Click on OC Plan Scrutiny for new Construction link. This routes the user to the Data Required screen and the screen provides information about the data required to generate OC eDCR number.
Clicking on the Next button routes the user to the OC eDCR scrutiny details screen.
2. OC eDCR Scrutiny Details
After entering the permit number and permit date, stakeholders need to click the Search button. Internally BPA and eDCR search fetches the required data.
The BPA and eDCR search results display all details regarding the application along with the proceed for OC scrutiny button on a separate card.
On clicking the Procced for OC scrutiny button users are redirected to the Upload OC Plan Diagram screen.
File Path:
3. Upload OC Plan Diagram
Users have to upload the dxf file and click on the Submit button that triggers the Create API call.
File Path:
The Success Acknowledgement Page gets displayed after a successful eDCR create call. Here stakeholders can see -
eDCR Number
Application Number
Download option, for downloading the scrutiny report
Apply for OC For New Construction button, for creating the BPA application( OBPS BPA/OCBPA - ARCHITECT )
Go Back To Home button to navigate back to the home screen
Creating preview...
File Path:
The Failure Acknowledgement Page gets displayed in case the eDCR create call fails for some reason. Here stakeholders can see -
Application Number
Download option, for downloading the scrutiny report
Go Back To Home button to navigate back to the home screen
Creating preview...
File Path:
All screens have been developed using the new-UI structure followed previously in FSM, PGR, PT and TL.
The link for the eDCR & OC eDCR Main Index is given below. It helps in understanding the starting point of the flow:
Config responsible for the routing of each flow
eDCR:
OC eDCR:
Throughout the flow, a few of the page data is imported from MDMS. Following is the list of pages that are using MDMS data. These pages .js files can be found under page components.
For calling the MDMS data React Hooks has been used, so that it can be shared across modules. Below is the little code snippet for the call used for MDMS.
Localization keys are added under the ‘rainmaker-bpa’ locale module. In future, if any new labels are implemented in the OBPS - Architect (Citizen) they should also be pushed to the locale DB under rainmaker-bpa locale module. Below is an example of a few locale labels.
Users can view all the applications assigned to them in the employee inbox. And it provides multiple filters and search options to filter the applications.
OBPS Inbox uses InboxComposer React HOC to create the Inbox through various child components, for both mobile and Desktop Components.
The API used to fetch applications in the inbox
For viewing OBPS inbox these roles are necessary "BPA_FIELD_INSPECTOR", "BPA_NOC_VERIFIER", "BPA_APPROVER", "BPA_VERIFIER", "CEMP"
The MDMS links (blue text hyperlinks) are used while selecting the OBPS application type, service type, risk type with business service and status filters.
Refer to the config below for risk type definition:-
To provide the facility for the user for creating New Building Permit Application by the citizen.
Every application which is created is a part of the workflow.
Users can apply for a new building permit application by clicking on the “Registered Architect Login”. This option can be used only by registered architects to log in. Other users will not be able to proceed further.
Architects will first need to generate an eDCR Scrutiny Number if it is not already available. For this click on “Plan Scrutiny For New Construction”. If the eDCR Scrutiny Number is available, navigate directly to “Building Plan Permit For New Construction”. Add all required information while going through the workflow.
The Create API is called in the middle of the workflow after owner details. And, at the end of the flow, a summary screen is visible for the review of the entered details. Click on the submit button calls the Update API that changes the status from Initiated to Applied and the Registration Application gets updated.
Users must provide the City, Applicant Name and upload the dxf file in order to generate eDCR number.
The Acknowledgement Page gets displayed. Users can apply for the building permit by clicking on the Apply for Building Plan Permit button. Or, they can go back and apply from the home page as mentioned in the previous section.
The New Building Permit Document Required screen is displayed after login, which helps the user to understand the necessary documents needed to complete the new registration for New Building Permit. A Citizen Info card is also shown at the bottom of the page for any additional information such as the maximum size of the file that can be uploaded.
The TimeLine component is present on all pages of the application. It informs the user about each stepper in completing the registration application.
In this step, the users need to provide and verify the details from the scrutiny API.
Users will need to verify the basic details received from the API, using the eDCR scrutiny number. In case the scrutiny number is not entered, users can enter the number and search for the result.
The data asked here is not compulsory - users can enter or skip it too.
On this page, half of the details are received from the scrutiny details API and a drop-down for sub-occupancy which is multiple in nature. Users can select accordingly.
Users can click on the GIS icon and select and pinpoint the current address on the geolocation component.
If the user does not want to select the location on the map, they can enter the Pincode. The city and locality get selected accordingly.
In this step, users have to provide details about the owner. Owners could be single or multiple.
Select the type of owner and enter owner's details
In case, the multiple owner option is selected, the Add Owner button is visible. The Primary Owner checkbox is also available. Click on the Add Owner button allows users to add multiple owners accordingly. Click on the Next button calls the Create API.
Users have to select the document type. Upload multiple documents if needed using the document upload component. If the type is only one, then it came pre-selected for user convenience. Also, the documents which are mandatory are defined in MDMS from where it is fetched.
An info card is also visible which informs the user about the application number of the application created in the create API call.
Users need to verify and upload the documents, if required, for the NOC details. This information is also fetched from the MDMS.
Users can cross-verify the data entered throughout the flow on the Summary page. In case any change or update is required, they can click on the edit icon available adjacent to the section headers. This redirects them to the relevant page and the entire flow is repeated again in order to submit the application.
Along with this Fee estimate for the corresponding application is also shown on the summary page.
For BPA Application the Update API call is made. Below is the snippet of the Update API used:
If the API response is successful, then the Acknowledgement Screen is displayed. Else, the Failed Acknowledgement Screen is displayed.
The OCBPA flow is similar to the BPA flow detailed above with the exception of a few steps that are not necessary and therefore omitted in this flow.
Click on the OC Plan Scrutiny for New Construction button to generate an OC eDCR number. Users need the Permit Number and the Date that is generated upon the completion of the BPA application.
The Documents Required screen lists all the documents or data required to generate the OC eDCR number.
Once the user provides the Permit Number and Date, the application details are pre-populated.
After verifying the details the user needs to upload the DXF file in order to generate the OC Scrutiny number.
The success acknowledgement page is shown in case of no errors in the application.
Clicking on Apply for OC New Construction redirects users to the Apply for new building permit form page. The Location & Owner Details will get auto-populated from the previous application details. The application triggers the Create API call from the scrutiny details page. The remaining flow is the same as for New Building Plan Permit.
All the screens have been developed using the new-UI structure followed previously in FSM, PGR, PT and TL. Some new components have been introduced such as the TimeLine, Multi-Document Upload feature etc.
The links for the BPA & EDCR Main Index are given below. These help in understanding the starting point of the flow:
The links for the OCBPA & OCEDCR Main Index are given below. These help in understanding the starting point of the flow:
The OBPS Module is segregated into a specified structure. All the screen configurations are available inside the PageComponent Folder and the configuration for routing of the pages are available within the config folder which is common for both Citizen as well as Employees. New components like TimeLine are defined within the component folder. Below is the snippet for folder structure and routing configuration.
Config responsible for the routing of each flow
BPA (new building permit application):
EDCR (scrutiny number):
OCBPA (OC new building permit application):
OCEDCR (OC Scrutiny number):
The Pages Folder is where the high-level configuration for controlling the whole flow is defined, for citizens and employees. Citizen configuration details include Apply flows, send backflows, Application details etc. The folder contains the index (the main starting point of the whole flow).
The main difference in the BPA/OCBPA registration flow from other modules is in the apply flow. The create API is called in between the flow and the Update API is called at the end.
The code for Create API request object generation is available inside the Owner details or scrutiny details component for BPA & OCBPA respectively. This API call is triggered when the user clicks on the Next button on the Correspondence Address page.
The BPA/OBPS Create API call uses the Digit.OBPSService.create
method to call the API. The code details are available within the gonext() method in the following files respectively.
Code reference:
https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/obps/src/pageComponents/OwnerDetails.js / https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/obps/src/pageComponents/ScrutinyDetails.js
The Utils Folder basically contains all the methods which are being used throughout the OBPS module, and if any common method needs to be declared here, it can be imported to other files.
Throughout the flow, the Download button is mentioned according to the current state of the Application. These documents are generated from the server side and are dependent on the business service of the application. Refer to the code below to define the business service and the following keys.
Following are the hooks used for the download PDF call:
For Occupancy Certificate use: occupancy-certificate
and for Permit orders: buildingpermit-low
For updating an Application, the update API from BPA is called using the React hooks, which is declared under hooks/elements/obps as OBPSService.
The response object from the Create API is used for the request object of Update API, in addition to the document details that users have entered. This changes the status of the Application as Applied instead of initiated. Along with this NOC Update API is also called which updates the status of the NOC aligned with the particular application.
Update API for NOC, BPA & OCBPA, the hook used for calling the API is:
1Digit.Hooks.obps.useObpsAPI( 2 data?.address?.city ? data.address?.city?.code : tenantId, 3 true 4 );
This API is called in the respective Acknowledgement Page:
https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/obps/src/pages/citizen/OCBuildingPermit/OBPSAcknowledgement.js / https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/obps/src/pages/citizen/OCBuildingPermit/OBPSAcknowledgement.js
Throughout the flow, a few of the page data is imported from the MDMS. Following is the list of pages that are using MDMS data. These pages .js files can be found under page components.
For calling MDMS data React Hooks has been used, so that it can be shared throughout the modules. Below is the little code snippet used for the MDMS call.
Localization keys are added in the ‘rainmaker-bpa’ locale module. In future, if any new labels are implemented in the OBPS - Architect (Citizen) they should also be pushed in the locale DB under rainmaker-bpa locale module. Below is an example of a few locale labels.
Users can view all the applications assigned to them in the stakeholder inbox. And it provides multiple filters and search options to filter the applications.
Stakeholder Inbox uses InboxComposer React HOC to create the Inbox through various child components, for both mobile and Desktop Components.
Inbox wrapper API used to fetch the inbox data:-
For viewing OBPS inbox these roles are necessary "BPAREG_APPROVER", "BPAREG_DOC_VERIFIER"
The search application feature provides a filter-based search tool to employees.
OBPS search application is used to search all the applications independent from the workflow/process instance data, which eliminates the presence of valid roles to search for an application from any business service.
Make use of the already documented applicationType and serviceType MDMS. Create a couple of hooks to coordinate and easily use the available filters.
To provide the facility for the citizen user to view the application details, update the BPA application state and make the payment.
Users can review the list of applications and their status registered using their mobile number on the My Applications page. Each Application initially displays the Application Number, Application Type, Service Type, status, and SLA with the View Details option.
Click on the View Applications by Citizen link routes users to the My Applications screen. The screen provides BPA, OC-BPA and stakeholder registration applications and details. The BPA search API and the Stakeholder Registration search APIs are called and the application cards are visible after getting the response from the APIs.
File Path
Click on the View Details button. It routes users to the application details screen. 1. BPA Application Details
Clicking on the BPA/OC BPA application card routes users to the BPA application details page. The application details page displays the details of the application and also showcases all the actions that can be taken on the application.
Clicking on the Action button provides the citizen users with the actions list. Clicking on any one of the options opens a popup window. Users can enter comments and upload documents. Clicking on the Submit or Forward button triggers the Update API call.
File Path
When employees click on the Send Back to Citizen button, the applications are routed back to the My Applications list of the citizen. The Application Details screen allows users to make the required changes. The forward action button routes the citizen to the Summary screen. Users can attach the documents and submit the application.
File Path
Citizens can download the receipts which include Application Fee, Sanction Fee, Permit order, Revocation pdf, Comparison report etc based on the conditions.
File Path
Clicking on the Stakeholder Application card routes the user to the stakeholder application details. The application details page displays the details of the application and also showcases all the actions that can be taken on the application.
File Path
The Timeline component is present at the end of the application details and provides information on the current status.
All the screens have been developed using the new-UI structure followed previously in FSM, PGR, PT and TL.
OBPS Hooks Details
File Path
OBPS Search API Hook
OBPS Update API Hook
OBPS WorkFlow API Hook
OBPS MDMS Hooks
Collection Services Hooks(For Receipts and Amount display)
Stakeholder Hooks
File Path
Search Hook
MDMS Hook
Collection Service Hook(For Receipts and Amount display)
Localisation keys are added under the ‘rainmaker-bpa’ and ‘rainmaker-bpareg’ locale modules. In future, if any new labels are implemented in the OBPS - Architect (Citizen) they should also be pushed to the locale DB under 'rainmaker-bpa' locale module. Below is an example of a few locale labels.
This section illustrates the steps for different employee user roles at the ULB level
The Document Verifier (DV) is responsible for verifying the required and supporting documents uploaded by the citizen or the stakeholder with the building permit or occupancy certificate application. The application is forwarded to the Field Inspector for further review once the DV finds the documents uploaded meet the requirements. Else, the application is either sent back to the citizen for refurbishing the documents or rejected.
DV can
DV can send the application back to the citizen for any corrections or if any vital document has not been uploaded. The DV can also upload the documents on behalf of the citizens.
To send the application back to the citizen
Click on the OBPS Inbox option on the home screen.
Click on the Application No. hyperlink available in the list of applications Inbox of the employee dashboard.
Or, enter Application No. or any other search parameter to search for the application.
Click on the Application No. link to open the application.
Scroll down the application page to review the filled-in details.
Review the documents uploaded by the citizen.
Click on the Take Action button at the bottom of the application page once the review is complete.
Click on the Send Back to Citizen button if the documents do not meet the application requirements or any document is missing.
Select the applicable Assignee Name. State the reasons for sending the application back to the citizen in the Comments section.
Click on the Choose File button to upload any supporting documents. Click on the Send Back to Citizen button.
The application is placed back in the Citizen queue for required edits.
The DV can reject the application if the documents and information furnished by the citizen do not meet the permit or occupancy guidelines.
To reject application
Enter the Application No. or any other search parameter to search for the application. Click on the Application No. link to open the application.
Scroll down the application page to review the filled-in details.
Click on the Take Action button at the bottom of the application page once the review is complete.
Click on the Reject button if the documents do not meet the application requirements or the information provided in the application is inaccurate.
State the reasons for rejecting the application in the Comments section. Click on the Upload Files button to upload any supporting documents. Click on the Reject button.
The application is rejected and a notification is sent to the owner informing the same.
Permit orders are sanctioned instantly for low-risk applications. However, the application goes through the normal workflows for document verification, field inspection, and NOC verification. The ULB authorities can revoke the permit order in case any anomalies are detected during the verification process.
Applications can be revoked at any stage by the Document Verifier, Field Inspector, or NOC Verifier.
To revoke application
Click on Application No. in the employee Inbox or enter Application No. or any other search parameter to search for the application.
Click on the Application No. link to open the application. Scroll down the application page to review the filled-in details.
Click on the Take Action button at the bottom of the application page once the review is completed.
Click on the Revocate button if the application details do not meet the permit requirements.
Enter the reason for revoking the permit in the Comments field.
Click on Choose File to attach supporting documents. Click on the Revocate button. The permit order is revocated.
The DV verifies and forwards the application if the documents and information provided in the application are found satisfactory and complete.
To verify and forward the application
Enter the Application No. or any other search parameter to search for the application. Click on the Application No. link to open the application.
Scroll down the application page to review the filled-in details. Click on the Take Action button at the bottom of the application page once the review is complete.
Click on the Forward button once all documents are verified.
Select the applicable Assignee Name who will carry out the next phase of verification. Provide any additional information for the assignee in the Comments section.
Click on the Choose File button to upload any supporting documents. Click on the Forward button.
The application is forwarded to the field inspector for further processing.
The field inspector or FI is responsible for conducting the field inspection of the construction site and premises. The FI prepares the inspection report based on the observations on the defined inspection parameters.
The FI can
FI prepares the field inspection report and attaches the report to the application.
To prepare the inspection report
Click on the Application No. hyperlink available in the list of applications available in the employee Inbox.
Or, enter Application No. or any other search parameter to search for the application. Click on the Application No. link to open the application.
Scroll down the application page to review the filled-in details. Enter the Inspection Date and Inspection Time in the panel. FI can add multiple field inspection reports as required.
Mark Yes or No as applicable for each item in the Inspection Checklist. Enter any additional information in the Remarks section available for each item in the checklist.
Select the applicable Document Type for each of the listed Documents. Click on the Upload File button to upload the relevant documents.
Click on +Add Another Field Inspection Report button to append additional inspection details.
Click on the Take Action button at the bottom of the application page once the review is complete.
To send the application back to the citizen
Click on Send Back to Citizen if any information or document is missing from the application.
Select the applicable Assignee Name. State the reasons for sending the application back to the citizen in the Comments section.
Click on the Choose File button to upload any supporting documents. Click on the Send Back to Citizen button.
The application is placed back in the Citizen queue for required edits.
The FI can reject the application if the documents and information furnished by the citizen do not meet the permit or occupancy guidelines.
To reject the application
Click on the Reject button if the documents do not meet the application requirements or the information provided in the application is inaccurate.
State the reasons for rejecting the application in the Comments section. Click on the Choose File button to upload any supporting documents. Click on the Reject button.
The application is rejected and a notification is sent to the owner informing the same.
The FI can revocate an application if the documents and information furnished by the citizen do not meet the guidelines.
To revocate the application
Click on the Take Action button.
Enter the reason for revoking the application in the Comments field. Click on Choose File to attach supporting documents. Click on the Revocate button.
The FI verifies and forwards the application if the documents and information provided in the application are found satisfactory and complete.
To forward the applications
Click on the Verify and Forward button.
Select the applicable Assignee Name who will carry out the next phase of verification. Provide any additional information for the assignee in the Comments section.
Click on the Choose File button to upload any supporting documents. Click on the Verify and Forward button.
The application is forwarded to the NOC Verifier for further processing.
The NOC Verifier is responsible for checking the no-objection permissions obtained for various civic authorities in the context of the building construction. Commonly, a NOC is required from the Airports Authority and the Fire department to certify all guidelines are met by the builder and owner. If all requirements are met the NOC verifier forwards the application to the BPA Approver.
NOC Verifier can
Send applications back to citizens
The NOC Verifier can send the application back to the citizen in case there are some details missing in the form.
To send the application back to the citizen
Click on the OBPS Inbox option on the home screen.
Click on the Application No. hyperlink available in the list of applications in the employee Inbox. Or, enter Application No. or any other search parameter to search for the application.
Click on the Application No. link to open the application.
Scroll down the application page to review the filled-in details.
Review the inspection report and NOC documents uploaded with the application. Click on the Choose File button to upload NOC documents on behalf of the NOC issuing authority like Fire or Airport.
Click on the Take Action button at the bottom of the application page once the review is complete.
Click on the Send Back to Citizen button if the documents do not meet the application requirements or if any document is missing.
Select the applicable Assignee Name. State the reasons for sending the application back to the citizen in the Comments section.
Click on the Choose File button to upload any supporting documents. Click on the Send Back to Citizen button.
The application is placed back in the Citizen queue for required edits.
The NOC Verifier can reject the application if the documents and information furnished by the citizen do not meet the prescribed guidelines.
To reject the application
State the reasons for rejecting the application in the Comments section. Click on the Choose File button to upload any supporting documents. Click on the Reject button.
The application is rejected and a notification is sent to the owner informing the same.
The NOC Verifier can revocate the application if the documents and information furnished by the citizen do not meet the prescribed guidelines.
To revocate the application
Click on the Application No. link to open the application. Scroll down the application page to review the filled in details.
Click on the Take Action button at the bottom of the application page once the review is completed.
Click on the Revocate button if the application details do not meet the permit requirements.
Enter the reason for revoking the permit in the Comments field.
Click on Choose File to attach supporting documents. Click on the Revocate button.
The NOC Verifier verifies and forwards the application to the BPA Approver if the documents and information provided in the application are found satisfactory and complete.
The NOC Verifier cannot forward the application to the BPA Approver until and unless the NOC from the respective authorities is received.
To forward the applications
Click on the Verify and Forward button once all details are verified and found satisfactory.
Select the applicable Assignee Name who will carry out the next phase of verification. Provide any additional information for the assignee in the Comments section. Click on the Choose File button to upload any supporting documents. Click on the Verify and Forward button.
The application is forwarded to the BPA Approval for final approval.
The BPA Approver is responsible for approving or rejecting the application for building permits or occupancy certificates. Once approved the owner can download the permit or the occupancy certificate from the portal.
The BPA Approver can
The BPA Approver approves the application for a building permit or occupancy certificate once the verification is complete and prescribed guidelines are met.
To approve applications
Click on the OBPS Inbox option on the home screen.
Click on the Application No. hyperlink available in the list of applications section of the employee dashboard.
Or, enter Application No. or any other search parameter to search for the application.
Click on the Application No. link to open the application.
Scroll down the application to review the filled-in details.
Review the documents uploaded with the application
Check the applicable conditions in the Permit Conditions list.
Click on the Take Action button at the bottom of the application page once the review is complete.
Provide any additional information for the assignee in the Comments section.
Click on the Choose File button to upload any supporting documents.
Click on the Approve button once all requirements are complete.
The application is approved. The citizen or the stakeholder can now download and print the building permit or occupancy certificate from their account only after paying the permit fee. There is no fee applicable for an occupancy certificate.
BPA Approver can reject the application if the documents and information furnished by the citizen do not meet the prescribed guidelines.
To reject applications
State the reasons for rejecting the application in the Comments section. Click on the Choose File button to upload any supporting documents. Click on the Reject button.
Learn how to register new stakeholders, make payments, apply for building permits and occupancy certificates
Citizens represent individuals, groups, and communities who are the building owners or occupants. The BPA module provides the citizens with the scope to view building permit applications submitted by the stakeholders or architects. They can request the stakeholders to make any changes in the application if required. Citizens approve the applications and make the payment.
The citizen can -
The citizen user portal allows stakeholders to register themselves on the OBPAS system. Stakeholders constitute architects, builders, engineers, supervisors, or town planners. A unique license number is generated for each stakeholder on the system.
Citizens can have multi-stakeholder access. Hence, a citizen can be registered as an architect, a builder, and a normal citizen.
The registered stakeholder will have state-level access permission to apply for new building permits or occupancy certificates.
To register stakeholders
Select the Language to proceed.
Select your Location.
Select service as BPA.
Click on Register as a Stakeholder option on the screen.
Enter your Mobile Number.
Make a note of the documents required to register new stakeholders.
Select the appropriate License Type that you wish to apply for.
Enter the Licensee Details such as Name, Gender, Mobile Number, Email, and PAN Number.
Enter the Licensee Permanent Address.
Enter the Licensee Correspondence Address. Check the Same as Permanent Address box if both address are same.
Upload the required documents.
Review the application details in the Summary view.
The application submitted successfully message screen provides the stakeholder registration application number.
The registration application is now in queue for document verification and approval by the Document Verifier and Approver.
Once the stakeholder is approved the applicant receives a notification. In addition, the Building Permit New Construction, Occupancy Certificate New Building Construction, and the DIGIT DCR Scrutiny options are added to the system menu.
The view application option allows citizens to review the application submitted by the stakeholder. In case there are any mistakes or changes required in the application the citizen can request the stakeholder to make these edits.
To view application status
Click on View applications by Citizen.
The My Applications screen will list all the applications submitted by the stakeholders on behalf of the citizen. The application details will display the status of each application.
The Application Timeline shows the past actions completed for that application.
Building permit applications submitted by the architects or any other stakeholders are routed to the citizens or the owner to verify details. The owner reviews the application details and sends back the application to the stakeholders if there is any mistake or any changes required in the application.
To request edits or approve applications
Click on View Applications by Citizen option.
Click on View Details button available for the relevant application.
Scroll down the application page to review the details submitted in the application.
Click on the Take Action button. Click on the Send to Architect button if some details require editing. This will open the Forward Application panel.
Enter the information you want to pass on to the architect in context to the application in the Comments section. Click on the Upload Files button to upload any supporting documents for the application.
Click on the Send To Architect button. The application is now in the stakeholder’s queue for further processing.
Click on the Approve button if there are no changes required in the application. This will open the Forward Application panel.
Enter any Comments in context to the application in the panel. Click on the Upload Files button to upload any supporting documents for the application. Click on the Approve button. The system displays the approved success acknowledgement message.
The Make Payment button is enabled once the stakeholder submits the building permit or occupancy certificate application on behalf of the owner.
Click on the View Details button to make the payment.
Click on the Take Action and then the Pay button at the bottom of the screen.
The Payment Collection Details panel displays the Total Amount payable towards Application Fee along with the break-ups.
Select the relevant payment method. Enter the payment details.
The payment success acknowledgement message is displayed along with the Payment Receipt No. Click on the Download/View Receipt button to view or download the receipt in pdf format or click on the Print icon to print the receipt.
Stakeholders represent the registered builders, architects, town planners, engineers or supervisors. The stakeholder role within the system encompasses submitting details for eDCR scrutiny, obtaining building permit orders, completion certificates, and occupancy certificates.
Stakeholders can
The DIGIT-DCR Scrutiny option in the BPA module allows stakeholders to upload and submit building plan diagrams. The scrutiny process checks if the drawing meets the required standards and applicable compliance guidelines. Once the scrutiny is complete, the plan is either approved or rejected depending on the scrutiny findings.
To submit plans and diagrams for DIGIT-DCR Scrutiny
Navigate to the eDCR Scrutiny menu card on the screen. Click on the Plan scrutiny for new construction option.
Select the applicable City for the proposed construction. Enter the Applicant Name. Click on the Upload File button to upload the plans and diagrams. The system accepts only .dxf files and the maximum file size should not exceed 30MB.
Click on the Submit button to submit the plans for scrutiny. Click on the Clear Form button to start a fresh application.
The system displays a success acknowledgement message along with a unique eDCR Scrutiny Number. Note this number for future reference. This number is required at the time of applying for a new building permit.
Click on the Create Building Permit Application button to apply for a permit.
Follow the same steps to apply for Occupancy Certificate eDCR Scrutiny for New Building.
Click on the OC Plan Scrutiny for new construction option in the eDCR Scrutiny card.
Check the list of required details to process the OC eDCR scrutiny.
Enter the Building Permit Number and Building Permit Date. Click on the Search button
Your application details are visible on the screen. Review the details and then click on Proceed for OC Scrutiny button.
Upload the OC Plan Diagram. Click on the Submit button.
The OC Building Plan eDCR Scrutiny process is successfully completed. Make a note of the Scrutiny Number. Click on the Download Scrutiny Report button to download and print the report.
In case of any errors or lapses the plan scrutiny is rejected and the system displays a failure message. In such a case make the changes and resubmit for scrutiny.
Stakeholders can apply for building permits for new construction once the eDCR Scrutiny is approved.
To apply for building permits for new construction
Click on the Building Plan Permit New Construction option in the Building Plan Approval card.
Make a note of the list of documents required for the building plan permit. Click on Next to proceed.
Enter the eDCR Scrutiny Number.
This fetches the scrutiny details.
Enter the Holding Number and Land Registration Details.
Click on Skip and Continue button to skip inputting these details.
Enter the Location Details.
Enter the GIS location details.
Enter the City, Street Name and Landmark details.
Enter the Owner Details.
Upload the required documents.
Enter the NOC Details.
Review the Application details.
Click on Send Application to Citizen. The application is routed back to the citizen for action. The citizen has to pay the fee and submit the application for processing.
The New Building Plan Application is submitted successfully. Make a note of the Application reference number for tracking status and details. This number is also shared with the applicant on their registered mobile number.
Click on OC for New Construction option in the Building Plan Approval card.
Make a note of the required documents to complete and submit the OC application.
Enter the Holding Number and the Land Registration Details.
The Scrutiny Details are auto-populated and available for review.
Upload the required documents.
Upload the NOC Details.
Review the application details in the Summary section. The system displays the estimated fee for processing the application based on the given details. Click on the Submit button to submit the application.
The application submission message screen provides the application reference number.
The stakeholder search application screen is used to search all the applications independent of its workflow or process instance data, which eliminates the presence of valid roles to search an application from any business service.
The details for this screen are the same as discussed in the . Please refer to the same.
All content on this page by is licensed under a .
Code - Refers to the DocumentType parentGroup from from common masters MDMS
Occupancy code - Refer to to know more about it
Name provided for occupancy in
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
All content on this page by is licensed under a .
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
https://github.com/egovernments/DIGIT-Dev/tree/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/obps/src/pages/citizen/OCEDCR - Connect to preview eDCR and OC eDCR are part of OBPS (OBPS DIGIT-UI )
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
S.No. | API | Action ID | Roles |
---|---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
All content on this page by is licensed under a .
All content on this page by is licensed under a .
All content on this page by is licensed under a .
Follow the steps outlined for in the Citizens section.
Enter the eDCR Scrutiny Number. Click on the Search icon. This fetches the building and application details from the scrutiny report.
All content on this page by is licensed under a .
PageComponent
MDMS Detail
Module Details Name
Master Detail Name
StakeholderDocsRequired
List of documents required for registration
StakeholderRegistraition
StakeholderRegistraition
LicenseType
License role options
StakeholderRegistraition
StakeholderRegistraition
LicenseDetails
Gender
common-masters
GenderType
StakeholderDocsRequired
Documents and its drop downs
StakeholderRegistraition
StakeholderRegistraition
S.No.
API
Action id
Roles
1
/egov-mdms-service/v1/_search
954
CITIZEN
2
/tl-services/v1/BPAREG/_create
CITIZEN
3
/filestore/v1/files/url
1528
CITIZEN
4
/billing-service/bill/v2/_fetchbill
1862
CITIZEN
5
/tl-calculator/billingslab/_search
1684
CITIZEN
6
/tl-services/v1/BPAREG/_update
CITIZEN
7
/localization/messages/v1/_search
1531
CITIZEN
8
/tl-calculator/v1/BPAREG/_getbill
CITIZEN
PageComponent
MDMS Detail
Module Details Name
Master Detail Name
EDCRForm
City list
tenant
citymodule
S.No.
API
Action id
Roles
1
/egov-mdms-service/v1/_search
954
CITIZEN
2
/edcr/rest/dcr/scrutinize
2075
BPA_ARCHITECT
, BPA_TOWNPLANNER
, BPA_BUILDER
, BPA_STRUCTURALENGINEER
, BPA_ENGINEER
, BPA_SUPERVISOR
3
/edcr/rest/dcr/scrutinydetails
CITIZEN
4
/bpa-services/v1/bpa/_search
CITIZEN
5
/filestore/v1/files/url
1528
CITIZEN
6
/localization/messages/v1/_search
1531
CITIZEN
EDCRForm
City list
tenant
citymodule
DocsRequired
Documents required List
BPA
common-masters
DocTypeMapping
DocumentType
BasicDetails
Risk Type
BPA
RiskTypeComputation
OwnerDetails
Gender & Ownership category
common-masters
OwnerShipCategory
GenderType
1
/egov-mdms-service/v1/_search
954
CITIZEN
2
/edcr/rest/dcr/scrutinydetails
CITIZEN
3
/filestore/v1/files/url
1528
CITIZEN
4
/billing-service/bill/v2/_fetchbill
1862
CITIZEN
5
/bpa-services/v1/bpa/_create
1684
CITIZEN
6
/noc-services/v1/noc/_search
CITIZEN
7
/localization/messages/v1/_search
1531
CITIZEN
8
/noc-services/v1/noc/_update
CITIZEN
9
/bpa-services/v1/bpa/_update
CITIZEN
10
/bpa-services/v1/bpa/_search
CITIZEN
User Role | Scope of Action | Role Description |
Citizen | View BPA Application Status Download Payment Receipts Provide concurrence to the Architect to submit the application Make payment for an application Download Building Permit Order | Individuals and society groups/communities who engage stakeholder/architects to construct buildings for them |
Stakeholder/Architect | Create BPA Application Send application to the citizen for approval Make payment for the application Download permits Download receipts Check application status | Architects, builders, or engineers who register as a stakeholder in the BPA system - submit applications on behalf of the citizens |
Document Verifier (DV) | Send application back to citizen Reject applications Upload document on behalf of citizen Verify and forward applications to FI | DV is the ULB employee responsible for verifying all documents uploaded by the stakeholder/citizen along with the building permit or occupancy certificate application. |
Field Inspector (FI) | Prepare Inspection Report Send application back to the citizen Reject applications Verify and forward applications to NOC Verifier | FI is the ULB employee responsible for inspecting construction onsite details submitted by the stakeholder or owner. |
NOC Verifier | Send back to citizen Reject applications Update NOC details on behalf of NOC department users Verify and forward applications to BPA Approver | NOC Verifier is the ULB employee responsible for verifying NOC details obtained from concerned authorities. |
BPA Approver | Reject application Update permit conditions Approve application | The BPA Approver is the ULB employee responsible for rejecting or approving building permit or occupancy certificate applications. |
API
| Action id | Roles |
1 |
|
|
|
2 |
|
|
|
3 |
|
|
|
4 |
|
|
|
5 |
|
|
|
6 |
|
|
|
7 |
|
|
|
8 |
|
|
|
9 |
|
|
|
10 |
|
|
|
11 |
|
|
|
12 |
|
|
|
13 |
|
|
|
Welcome to the OBPAS product demo script. The key objective of the demo script is to walk users through the OBPAS module and highlight module capabilities and functions.
The Online Building Permission and Approval System or the OBPAS module offers a comprehensive platform that automates the entire building plan approval process. The OBPAS module along with the eDCR scrutiny application streamlines the entire process right from the point of uploading plans for approval to fetching no-objection certificates from concerned authorities and final issue of approvals or permits.
The module aims to address key challenges that include -
Any construction in the city requires prior approval from the local body authorities. Architects and building owners submit a plan diagram that is validated as per the state/city bylaws.
Most of the building plan applications and drawing plans are submitted manually in paper format since there is a high cost involved for the AUTOCAD license and the absence of cost-effective plan scrutiny solutions.
The major drawback of the manual permit application process is that it takes more than 45 days to get one permit.
Iterative plan corrections complicate the process.
Lack of transparency is another major setback for all stakeholders.
Key benefits of using the OBPAS application -
Scrutiny is real-time which reduces the time taken for diagram scrutiny. The module routes the uploaded plans through defined workflows for required inspections and approvals.
It provides access to all authorized stakeholders including department staff, Architects/Consultants, Building owners and Senior Management team based on their role entitlement.
Being an online system, DIGIT BPA is available anywhere, any place and on any device to the various stakeholders mentioned above. The intuitiveness of the DIGIT-BPA system becomes apparent when even a layman is able to track the status of their submission easily.
Consolidated OBPAS application help ULBs -
Plan city infrastructure (roads, culverts, drains, streetlights, garbage bins) details better resulting in effective decisions depending upon the type of buildings and their occupancies
Since capital infra is the second highest expenditure category for any ULB, it is important to know where to invest the funds and resources
Ensure buildings are not constructed in restricted areas zones (AAI / Water bodies /Monuments)
Generate revenue and facilitate prompt services to the citizen
The eDCR Scrutiny application digitises the building plan approval. The application features a rules engine required to evaluate the drawing against the existing building by-laws, the scrutiny of the application, configure the internal workflow - inspection, NOCs and finally issuance of approval.
A stakeholder can be an Architect/Licensed business engineer/town planner who is registered within the ULB. Only a registered stakeholder (architect) can create an application on behalf of the citizen.
eDCR (development control rules) - which is a rules engine that basically validates the uploaded diagram with that of the by-laws of the state and provides an O/P.
UNique reference eDCR number is generated only if it is successful.
In case of a failure - the errors are marked in the diagram which can be corrected by the architect and submitted again. This can be iteratively done till scrutiny is successfully completed.
Using the successfully scrutinized plan diagram parameters, an application is created. Any value which is populated from the plan diagram cannot be modified. There is no manual intervention allowed.
Discuss the EODB guideline which discusses getting all the application info from citizens in one shot.
Here showcase one application from OBPS is getting forked into 3 applications (one for the department to process the permit, one for airport NOC and one for FIRE NOC)
Discuss application is smart enough to figure out the list of NOCs required based on the location info gathered from the diagram.
The Architect on the creation of an application forwards it to get it concurred from the citizen. If there are any changes, the citizen requests an architect to make those changes or else can inform the architect to submit the application.
After getting approval from the citizen, the architect submits the application. On submit, the application fee is auto-generated based on configured payment details. Once the payment is made, the application is forwarded to the department.
Application fee can be either paid by the citizen or architect or the citizen can walk into any ULB designated collection counter and make the payment.
Submitted applications are available in the ULB clerk inbox for the required processing. Actions by the ULB clerk or counter employee include -
Scrutinize the application and documents submitted and check for correctness.
Request for additional documents from the applicant
Or Upload documents on behalf of the applicant
Or Reject the application citing the reason for a rejection
Or if the application and documents are in order, the clerk forwards the application for field inspection.
The Town planning overseer/Engineer does the field inspection of an application. Actions by the Field inspector include -
Schedule a meeting with the applicant offline after receiving the request and visit the actual location on the day of field inspection
The entire application is designed in a mobile-first approach which will enable the field inspector to use the application on the ground on a mobile phone
The field inspection report is designed as a series of checklists with yes and no options to make the process easier for a field inspector.
Also, the FI can take photographs of the site and tag them to the application.
If no violations are found - FI forwards the application for NOC verification
If due to some practical reasons, field inspection is not completed in a single visit - FI does multiple field inspections; the application supports the entry of multiple field inspection details.
If some violations are identified, the FI rejects the application.
NOC Verification - NOC verification responsibility lies with the superintendent of the department.
Refer back to the Forking of applications during the application created by Architect
Now showcase the status of all 3 applications at the NOC level where you can see the NOC applications are of status in progress.
Now login as a FIRENOC department user - process the NOC application and approve it.
Now login as Superintendent - showcase the status change from in progress to approved and discuss 3 use cases of NOC integration.
One API integration
Allowing NOC department users to log in to DIGIT and process the application
Completely manual where either the NOC is provided by citizens during application creation or by the Department employee by discussing with the NOC department user.
Now approve the NOC step of the application and recommend for approval.
Executive Engineer/Superintendent engineer can approve the application by entering the permit conditions.
There is a calculation logic that runs in the background to calculate the Permit fee using the built-up area and floor area.
Also, discuss the importance of permit conditions.
Now approve the file.
The next step is for the Architect or the Citizen to make payment for the permit fee and generate the permit order online.
Discuss the info in the permit order
QR code info
Payment info
Approver info
Possible use case scenarios for the demo -
Architect to do eDCR scrutiny
Architect to apply for permit application
Architect to apply for OC application
Citizen to approve/validate the application created by architect
Architect and citizen can make payment for application
The employee does document scrutiny - can add additional documents if needed
The employee does field inspection - update field inspection report- attach photographs of the site if needed
The employee does NOC verification - update NOC documents on behalf of NOC department user or citizen if needed.
NOC department user to update the NOC details
The employee can update the permit conditions
Citizens and architects can download the permit order/Occupancy certificate/comparison report, revocation permit PDF and other payment artefacts.
The Architect can generate permit orders on create of applications for low-risk applications.
Refer to the OBPAS User Manual for step-by-step instructions on these demo scenarios.
For every building plan application, there is a need to get the No objection certificate from the concerned departments. Based on the configuration we have for the NOCs, for every application, there will be a set of NOCs required. There should be a provision to allow the NOC department user to login to our system and upload the required NOC. We are providing a user to one NOC department. Based on the workflow mode(online/offline) of each NOC type, the NOC department user can perform the action.
Online mode – NOC department user can log in to the system and approve/reject the application.
Offline mode – NOC application will be auto-approved.
Knowledge of Java/J2EE(preferably Java 8 version)
Knowledge of Spring Boot and spring-boot microservices.
Knowledge of Git or any version control system.
Knowledge of RESTful Web services.
Knowledge of the Lombok library will helpful.
knowledge of eGov-mdms service, eGov-persister, eGov-idgen, eGov-user, eGov-localization will be helpful.
egov-user (Manage user)
egov-idgen (To generate the application No)
egov-localization (To use the localized messages)
egov-location (To store the address locality)
egov-mdms (Configurations/master data used in the application is served by MDMS)
egov-notification-sms (Service to send SMS to the users involved in the application)
egov-persister (Helps to persist the data)
egov-workflow-v2 (Workflow configuration for different BPA application is configured)
Fire Noc: online configuration
Airport Authority: online configuration
NA
NA
The Inspection checklist contains the list of activities that a field inspector should consider and check while on the field. The checklist is configurable at the State/ULB level.
Sr. No. | Service Type* | Description* |
---|---|---|
The data given in the table is sample data for reference.
Sr. No. | Column Name | Data Type | Data Size | Is Mandatory? | Description |
---|---|---|---|---|---|
Download the data template attached to this page.
Refer to the ‘Data Definition’ section of this document to understand the headers in the template sheet, their data type, size, and definitions.
Reach out to the person who shared the template for further details or to clear your doubts. Identify if the State/ULB has a provision for capturing pipe size for connections.
Identify all the checkpoints service wise and then fill into the given template.
Go through the checklist to verify the data. Make sure that each and every point mentioned in the checklist is covered.
The checklist is a set of activities to be performed once the data is filled into a template to ensure data entry requirements are met. These activities have been divided into 2 groups as given below.
This checklist covers all the activities which are common across the entities.
There is no separate entity-specific checklist for this entity.
Java 1.8
Eclipse
Postgres
PhpPgAdmin
Postman (Application)
Respective Git MiddleWare
Kubectl
Kafka
Take the code pull from the git:
Need to consider 2 repositories for code to run locally
Municipal services - where our BPA code exists and some dependency services also available here https://github.com/egovernments/municipal-services.git - Connect to preview
Core Services - Where dependency services exist to run our code locally https://github.com/egovernments/core-services.git - Connect to preview
Import the required projects to eclipse
From municipal-services import bpa-services, bpa-calculator and land-services. From core-services import user service, idgen service, mdms service, location service, localization service, workflow service, egov-persister.
Before running the application make sure the following setups are complete to ensure the application runs smoothly.
kafka set up in your system which is running fine. Download the latest version of kafka from here. https://kafka.apache.org/downloads
Run the below commands based on your system types
For linux: in kafka folder path
Example: D:\kafka_2.13-2.4.0
> bin/zookeeper-server-start.sh config/zookeeper.properties > bin/kafka-server-start.sh config/server.properties
Ref: https://kafka.apache.org/quickstart
For Windows: in windows path
Example: D:\kafka_2.13-2.4.0\bin\windows start zookeeper-server-start.bat ....\config\zookeeper.properties start kafka-server-start.bat ....\config\server.properties
And lombok setup for eclipse For ref: https://www.journaldev.com/18124/java-project-lombok
Kubectl setup based on the requirement To get the pods: kubectl get pods To port forward: kubectl port-forward <<pod name>> <<port number>>:8080 To get the logs: kubectl get logs
After all the setups are done successfully, try to run the application locally.
BPA-Services How to run the application in local:
Check the services which are connected to local and which are connected to dev
Which are connected to dev no need to change anything.
If it is connected to local check the services are in below list IDGEN – can run locally or can point to dev from cmd prompt PERSISTER – can run locally MDMS – can directly point to dev or can run in local LOCATION – can directly point to dev WORKFLOW – can point to dev or can run locally LOCALIZATIONS – we can directly point this to dev USER-SERVICE – need to point to dev from cmd prompt LAND-SERVICE – need to run locally BPA-CALCULATOR – can run locally or can point to dev.
If the changes are from these services follow the below process to run those respective services.
For core services:
IDGEN:
Approach 1: Directly point this to dev from the application.properties in bpa-services Approach 2: Point this to local and give the port forward to dev by using kubctl.
Note: We are not running this service locally.
PERSISTER:
U need to run it in local and need to add respective yaml files in persister resource folder which are bpa-persister.yml and egov-workflow-v2-persister.yml and also land-persister.yml
And need to add these in persister application.properties repo path
Note: Please check whether data is is saving or not in local data base(DB).
MDMS:
to run local: For running this in local need to change in 2 file that is application.properties and MDMSApplicationRunnerImpl
In application.properties need to change the paths for the master-config url as path of master-config.json and for config path as upto pb/bh
In MDMS ApplicationRunnerImpl need to change the data in a function from the path to file.
to point to dev: Approach 1: Directly point this to dev from the application.properties in bpa-services
Approach 2: Give it as local connection in BPA application.properties and port forward to dev by using kubectl.
Postman Collection https://www.getpostman.com/collections/c59b5c6190719ecd306a
LOCATION
Approach 1: Give it a local connection in BPA application.properties and port forward to dev by using kubectl.
Approach 2: Directly point this to dev from the application.properties in bpa-services
Note: Not tried it in local / may got errors so pointing to dev.
Postman collection https://www.getpostman.com/collections/4f6a25a4fb32572af5ff
WORKFLOW
to point to dev: Approach 1: Directly point this to dev from the application.properties in bpa-services
Approach 2: Give it as local connection in BPA application.properties and port forward to dev by using kubectl.
to run local:
can run locally by pointing to the local database, but for this need to create the workflow locally using the workflow create API.
Postman collection https://www.getpostman.com/collections/aa30be8a8b9de4c13aa8
USER-SERVICE Approach 1: Give it as local connection in BPA application.properties and port forward to dev by using kubectl.
Approach 2: Directly point this to dev from the application.properties in bpa-services
Note: In local not able to run the application successfully, so the following dev.
Postman Collection: https://www.getpostman.com/collections/60bbd6aed27605dcc270
LOCALIZATIONS
Approach 1: Directly point this to dev from the application.properties in bpa-services
Approach 2: Give it as local connection in BPA application.properties and port forward to dev by using kubectl.
Postman Collection https://www.getpostman.com/collections/12cc4c3855be9699c278
Changes from Municipal services
BPA-Calculator:
to run local:
can run locally by pointing to the local database.
to point to dev: Approach 1: Directly point this to dev from the application.properties in bpa-services
Approach 2: Give it as local connection in BPA application.properties and port forward to dev by using kubectl.
Land-Service:
to run local:
can run locally by pointing to the local database.
to point to dev: Approach 1: Directly point this to dev from the application.properties in bpa-services
Approach 2: Give it as local connection in BPA application.properties and port forward to dev by using kubectl.
Other than these services can directly by pointing to dev url.
Note: After running the application successfully please check if the data is saving in db or not.
egov-user - (Manage user)
tl-services - Stakeholder Registration (Registration process of Stakeholder is handled by this service)
egov-user-event (What’s New and Events)
egov-filestore (To store the documents uploaded by the user)
egov-idgen (To generate the application No, Permit No)
egov-indexer (To index the BPA data)
egov-localization (To use the localized messages)
egov-location (To store the address locality)
egov-mdms (Configurations/master data used in the application is served by MDMS)
egov-notification-sms (Service to send SMS to the users involved in the application)
egov-persister (Helps to persist the data)
egov-searcher (Search query used to simplify the search)
egov-workflow-v2 (Workflow configuration for different BPA application is configured)
pdf-service (Receipt’s, permitorder etc.. and prepared)
billing-service (Create demands and bills for the fees to be collected)
collection-services (Create a receipt for the payment received for the bills)
bpa-calculator (Calculates the fees to be collected at different stages)
land-services (land information related to BPA application is stored)
dcr-services (get and validate EDCR data)
We are using re-indexing to get all the data to respective indexer. We have 2 steps for this. First as to run the connector from playground, which is followed by legacyindexer service call from indexer service, which internally call the respective plain search service to get the data and to send to respective indexer.
Prerequisites:
Access to kubectl of the environment targetted
Postman scripts
Plain search apis in the respective services
OBPS reindexing steps
Connect to playground pod.
Delete the kafka connector if already exists with the kafka connection, using below command through playground pod.
Run below kafka connector curl from playground pod:
port forward to egov-indexer pod and run below curl throw postman.
Delete the kafka connection after all the data has been re-indexed by follwing below command through playground pod.
Alias water-services-enriched as water-services through kibana server.
This document mainly covers all the steps that one needs to do for setting up a new instance of eDCR (Development Control Regulations). Say when a new State is to be set up, there are some activities to be executed in a defined order. Setting up an instance of an application server and configuring customer-specific rules, and data, etc are a few of the key activities.
Centralized Server hosting all the ULBs within a state
All ULBs access the software over API calls.
Uniform code base supporting all the ULBs for the state. City-specific changes are maintained using client-specific implementation repositories.
A separate schema for each ULB in the database.
Prior Knowledge of Java/J2EE.
Prior Knowledge of Spring and Hibernate
Prior knowledge of Maven
Prior knowledge of Git.
Install the below version of the software in local machine
maven v3.2.x
PostgreSQL v9.6
Git 2.8.3
JDK 8 update 112 or higher
eDCR Service repository will be used to define default rules. The statewide rules to be defined within the client implementation repository.
How to set up a client implementation repository
After creating a client implementation repository, If you want to override rules processing for features, then create a project under egov directory like egov-client-impl.
The client-specific rules are configurable in the individual client implementation module. Here the rules are fetched by state wise, district wise, ULB wise, or grade-wise.
How to override rule processing across the state for a feature
The EG_CITY table, master data is used to decide the rules.
If the rules are the same for a feature across the state then the filename must need to keep like Far_{Client.id}.
The client id used with the feature class name and configures in the properties file should match, then only the system will pick features and process otherwise it won't pick the file.
How to override rule processing district, city, and grade wise for a feature
If the rules varying across district, city, and grade wise within a state then must need to follow the following naming conventions.
If the rules are varying from district to district, then the respective district-related rules need code under separate files with a filename like Far_{District Name}. eg: Far_Udalguri.
Similarly, if rules varying for city and grade wise then those respective rules need to code under separate files with a filename like Far_{City Name}, Far_{Grade}. eg: Far_Dispur, Far_Corp
The district, city, and grade information will be reading from the eg_city table, so in this table need to update that information before starting the coding.
In a state, only for one or two cities if the rules are changing then need to override rules only for those cities in a separate file, for other all cities the default code will pick. Here default code is state level (Far_{Client id}) configured one.
Configuration Changes to setup State and Cities
The state is configured by adding property tenant.{domain_name}=schema_name (state_name) in egov-erp-override.properties**.**
Each new ULB is enabled by adding a schema name and domain name in egov-erp-override.properties file(Available in Wildfly server under ${HOME_DIR}/wildfly-11.0.0.Final/modules/system/layers/base/org/egov/settings/main/config). Schema names should follow a naming standard, It should be the same as that of the city name.
Each ULB can be configured by adding an entry like tenant.{domain_name}=schema_name (city_name) in egov-erp-override.properties file.
Insert data into eg_city, in the city table domain URL value should be the same as configured tenant domain_name in the egov-erp-override.properties.
Changes required for local machine workspace setup
After set up is done, the local ubuntu machine need to update the domain URLs in the host file which you are going to use for scrutinizing and fetching the plan.
Navigate to the root directory and from there open the host config file available in the location 'etc/hosts'. Map the domain URLs with a local IP address in the hosts file and save the changes.
Update settings in standalone.xml
under ${HOME_DIR}/wildfly-11.0.0.Final/standalone/configuration
Add 'max-post-size' attribute with value 100mb in bytes in the below location,
<server name="default-server"> <http-listener name="default" socket-binding="http" max-post-size="104857600" redirect-socket="https" enable-http2="true"/> <https-listener name="https" max-post-size="104857600" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/> <host name="default-host" alias="localhost"> <location name="/" handler="welcome-content"/> <http-invoker security-realm="ApplicationRealm"/> </host> </server>
MDMS Integration
If you want to fetch master data from MDMS for following ApplicationType, ServiceType, OccupancyType, SubOccupancyType, Usages then the following configurations are needed,
Add the property and update the MDMS search URL, mdms.searchurl=/egov-mdms-service/v1/_search in application-config-client.properties file or egov-erp-override.properties file
By default, the master data will be fetched from the database.
If you want to fetch from MDMS instead of the database then the above configurations are required.
After setup is done APIs one must use state domain URL and in the contract tenantId of concern, the city has to be passed to scrutinize multiple cities.
One should not use the city domain URL to scrutinize or fetch plan if used that way, the response will be empty.
The tenantId used should follow {state_name.city_name} naming convention, then the state_name passed in the request and city code in the state schema must be the same.
.
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Please refer to Swagger API for YAML file details. Link - .
All content on this page by is licensed under a .
Sr. No. | Checklist Parameter | Example |
---|---|---|
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Branch out and create a eDCR service repository from master repository. Refer for the client implementation setup has been done.
Here client id nothing but a state name, the client.id need to update with the state name in application-config-client.properties file (Available in ) or in egov-erp-override.properties file(Available in Wildfly server under ${HOME_DIR}/wildfly-11.0.0.Final/modules/system/layers/base/org/egov/settings/main/config).
Eg: Here filename to be added as Far_Assam.java for the Assam state rules.
Setup your eDCR service workspace by following the instructions provided in
Enable fetch master data from MDMS by adding mdms.enable=true property in application-config-client.properties file (Available in ) or in egov-erp-override.properties file(Available in Wildfly server under ${HOME_DIR}/wildfly-11.0.0.Final/modules/system/layers/base/org/egov/settings/main/config).
Add the property and update the MDMS hostname, mdms.host=HOST_NAME} in application-config-client.properties file or egov-erp-override.properties file
Title | Link |
---|
All content on this page by is licensed under a .
1
New Construction
As per Site
2
New Construction
As per document
3
New Construction
Access to Plot As per site plan
4
New Construction
The height of building - Whether marked correct and the same value of height is given in PDF?
5
Occupancy Certificate Request
As per the site plan
6
Occupancy Certificate Request
As per Document
1
Service Type
Text
64
Yes
Type of Permit allowed eg. New construction, reconstruction, alteration, and demolition. This is a mandatory field
2
Description
Text
256
Yes
This field provides the details that field inspectors must consider during field inspections. The field inspector can check and mark True or False as per their findings
1
Make sure that each and every point in this reference list has been taken care of
Design and Architecture |
API Contracts |
Repository the default rule processing code available |
Sample client implementation repository |
Configuring MDMS |
The employee stakeholder flow consists of 2 independent screens and 1 application details page. Users have access to this flow using links in the Inbox and the Search application page.
The stakeholder MDMS data is used to filter views and service types displayed on the screen in accordance with the existing user role. The TradeTypeToRoleMapping MDMS data is also used to filter views based on the selected business service.
The localization module used in the OBPS module comprises rainmaker-bpareg and rainmaker-common. The rainmaker-bpareg is initialized for module localization.
User access to the stakeholder flows and BPAREG business service is role-based. Roles can be - "BPAREG_EMPLOYEE", "BPAREG_APPROVER", "BPAREG_DOC_VERIFIER", "BPAREG_DOC_VERIFIER"