To learn more about the Health Campaign Management (HCM) product, click here.
Set up and manage microplan
Capture campaign details and administrative boundary
Manage microplan data: Top-down population and facility data ingestion
Configure microplan assumptions and estimation formula
Create microplan users and manage their access
Re-use existing microplan
Validate and finalise population data for microplanning
Validate top-down ingested population data of the villages
Edit and update ingested population data of the villages
Approve or reject updated/edited population data of the villages
View status logs and user comments whenever population data is updated
Finalise the microplan population data for the campaign region
Assign facilities or point-of-services to their catchment areas
View list of facilities belonging to the user’s jurisdiction
Assign the catchment areas under the user’s jurisdiction to the facilities for service delivery
De-assign the already assigned catchment areas under the user’s jurisdiction
Finalise the facility-to-boundary mapping for the campaign region
Validate and finalise microplan estimation
Validate microplan estimation created by the system
Update microplan assumptions based on area accessibility and security levels
Approve or reject updated/edited microplan estimation
View status logs, change logs, and user comments whenever microplan estimation gets updated
Finalise the microplan estimation for the campaign region
Download and view the finalised microplan as an Excel
There are some known limitations in the current release of the product and the required change requests have been raised to cater to the limitations. Some of the limitations are:
Configuration of microplan assumptions as per the village’s/settlement’s accessibility or security in the estimation dashboard will not be available.
The facility upload sheet will not accept the capacity of a facility as 0.
Configuration of mixed distribution strategy (Fixed post + House-to-House) will not be available.
Click below to access the document:
Upload Data: Upload population and facility data required for census data approval, facility catchment and resource estimates. This data can be provided in the format of .xlsx (Excel)
Note: While uploading data, it is important to note that location coordinates (latitude and longitude) are not mandatory for microplanning.
Assumptions Configuration:
Assumptions Configuration: Configure assumptions essential for the microplanning estimation processes. These assumptions might include demographic factors, resource availability, and operational constraints.
Formula Configuration:
Set up the formulae to calculate estimated resources, such as human resources, commodities, and budgets. This includes human resources, commodities, and budgets.
Activity Management: Define and manage the sequence and dependencies of activities required for a campaign.
Resource Estimation: Saves the necessary resources for each activity, ensuring that all required materials and personnel are planned.
Condition Monitoring: Set and monitor conditions that must be satisfied for activities to commence, ensuring the right prerequisites are met.
Target Setting and Tracking: Define performance targets against these metrics to ensure campaign goals are met.
Output Generation:
Generate and save microplans.
Hierarchical Assignment: Assign employees to roles based on different hierarchy levels (e.g., Province, District, or Village).
Role Definition: Specify roles for employees, such as PLAN_ESTIMATION_APPROVER
, to clearly define their responsibilities within the microplanning process.
Jurisdiction Mapping: Link employees to one or more jurisdictions, ensuring operational clarity for each role and its geographical coverage.
Plan Configuration Association
The planConfigurationId
links the facility mapping to a specific plan, allowing resources and operations to align with the corresponding microplanning requirements.
Facility Details
The facilityId
uniquely identifies a facility (e.g., health center, warehouse), providing precise mappings for service delivery or logistical purposes.
Residing and Service Boundaries
Residing Boundary: Defines the geographical location or administrative boundary where the facility resides.
Service Boundaries: Specifies the areas serviced by the facility, supporting multi-boundary coverage.
Custom Metadata (Extensibility)
The additionalDetails
field allows for capturing detailed metadata about the facility, such as:
Facility type (e.g., "Warehouse").
Operational status (e.g., "Permanent").
Resource capacities (e.g., "Capacity: 500").
Fixed post status and population served.
File Parsing and Resource Estimation:
The service processes multiple file formats (Excel, Shapefiles, GeoJSON) to estimate the resources required for a microplanning campaign.
It reads the input data, applies predefined assumptions and formulas, and calculates the necessary resources.
Triggers for Plan-Facility Creation, Census Data Creation, and Plan Generation:
Plan-Facility Creation Trigger: When a facility file is uploaded, the service triggers the Plan-Facility Creation API from the project-factory
. This ensures that the facilities are created based on the file contents.
Census Data Creation Trigger: When a population file is uploaded, the service triggers the Census Data Creation process. This involves reading the population file, processing the data, and updating the system with the relevant census information.
Plan Generation Trigger: After the census data is approved, the service reads the updated population file, updates the census data, and triggers the resource estimation and microplan generation based on the latest data detailing the necessary resources and their distribution for the campaign.
Resource Mapping:
The service enriches the mapping of resource columns from the data upload to a predefined set of attributes required for each campaign. This ensures the resources are aligned with the necessary specifications.
Upload Updated Result Sheet:
After the microplan is created and have gone through the estimation approval process, the updated approved resource estimations sheet is uploaded to the filestore and updated back into the plan configuration ensuring the latest version of the resource data is securely stored and accessible.
HCM Console Integration:
The service integrates with the HCM Console, updating the project factory with the estimated resources. This ensures that the project factory always has the most accurate and up-to-date resource requirements for effective campaign planning and execution.
Category | Services | Docker Image | Comments |
---|---|---|---|
Service | API's | Description |
---|
Plan Service
git tag
1.0 tag added
Resource Generator
git tag
1.0 tag added
Census Service
git tag
1.0 tag added
HCM Admin Console v0.2
project-factory:v0.2.0-1ea8b5b5b9-9
updated
workbench-ui:v0.2.0-6f08f64238-535
updated
HCMv1.5
health-project:v1.1.5-8208b6fc8f-69
updated
DEVOPS v1.0
1.0 tag added
CONFIGS v1.0
1.0 tag added
Localisation v1.0
1.0 tag added
MDMS v1.0
we added the seed data as part of release kit
CORE Services LTS2.9
Plan | /plan-service/plan/_create | Create microplan |
/plan-service/plan/_search | Search for microplans |
/plan-service/plan/_update | Update microplans with resources, targets etc. |
/plan-service/plan/bulk/_update | Bulk updates microplans for a workflow action |
Plan configuration | /plan-service/config/_create | Create plan configuration with files, assumptions, hypothesis' and resource mappings |
/plan-service/config/_search | Search for plan configurations |
/plan-service/config/_update | Update plan configurations |
Plan employee | /plan-service/employee/_create | Creates assignment mapping between plan and employee |
/plan-service/employee/_search | Searches assignment mapping between plan and employee |
/plan-service/employee/_update | Updates assignment mapping between plan and employee |
Plan facility | /plan-service/facility/_create | Creates assignment mapping between plan and facility |
/plan-service/facility/_search | Searches assignment mapping between plan and facility |
/plan-service/facility/_update | Updates assignment mapping between plan and facility |
Census | /census-service/_create | Creates census records for a particular boundary |
/census-service/_search | Searches census records |
/census-service/_update | Updates census records |
/census-service/bulk/_update | Bulk updates census records for a workflow action |
S.No | Checklist | Yes/No/Partially | Reference link | Owner | Reviewer | Remarls |
---|---|---|---|---|---|---|
1
Development is completed for all the features that are part of the release.
Yes
Code was frozen by 27-11-2024.
2
Test cases are documented by the QA team, and reviewed by the product owners, and test results are updated in the test cases sheet.
Yes
Test Cases for Microplanning v1.0
All test cases are reviewed by the Product Owner and results have been updated in the sheet. QA sign-off is given accordingly.
3
The incremental demo of the features showcased during the sprint showcase and feedback is incorporated. If possible, list out the JIRA tickets for feedback.
Yes
Demo Link
Demo given on 14-11-2024 for Microplanning
4
UI/UX audit review by UX architect is completed along with feedback incorporation for any changes in UI/UX.
Yes
UI/UX Audit Sheet
Nipun Arora
@ AndrewJones
UI/UX audit is done and review comments are incorporated.
5
Incremental demos to the product owners are completed as part of the sprint and feedbacks are incorporated.
Yes
Demo Link
Demo given on 14-11-2023 for Microplanning
6
QA sign-off is completed by the QA team and communicated to the product owners. All the tickets' QA sign-off status is updated in JIRA.
Yes
Test Cases for Microplanning v1.0
All test cases are reviewed by the Product Owner and QA sign-off is given accordingly.
7
UI, API technical documents are updated for the release along with the configuration documents.
Yes
UI documentation for Microplanning
Nipun Arora
8
UAT promotion and regression testing from the QA team is completed. QA team has shared the UAT regression test cases with the product owners.
Yes
Test Cases for Microplanning v1.0
All test cases are reviewed by the Product Owner.
9
API automation scripts are updated for new APIs or changes to any existing APIs for the release. API automation regression is completed on UAT, the automation test results are analysed, and necessary actions are taken to fix the failure cases. Publish the list of failure use cases with a reason for failure and the resolution taken to fix these failures for the release.
Yes
Automation script is reviewed by the Tech Lead.
10
The API backward compatibility testing is completed.
Yes
Tested on 20-NOV-2024.
11
The communication is shared with the product owners for the completion of UAT promotion and regression by the QA team. The product owners have to give a product sign-off within one week of this communication.
Yes
UAT sign-off was completed. Sign-off dates 29-NOV-2024 for Microplanning
12
The UAT product sign-off communication is received from the product owners along with the release notes and user guides (if applicable).
Yes
UAT sign-off was completed. Sign-off dates 29-NOV-2024 for Microplanning.
13
The GIT tags and releases are created for the code changes for the release.
Service Build Update
Added a new git tag V1.0
14
Verify whether the release notes are updated.
15
Verify whether all UAT builds are updated along with the GIT tag details.
Service Build Update
All the budils are added with release tag V1.0
16
Verify whether all MDMS, configs, InfraOps configs are updated.
Mdms Changes, Config Changes
17
Verify whether all docs will be published to http://health.digit.org by the Technical Writer as part of the release.
Link
18
Verify whether all test cases are up to date and updated along with necessary permissions to view the test cases sheet. The test cases sheet is verified by the Test Lead.
Test Cases for Microplanning v1.0
19
Verify whether the UAT credentials sheet is updated with the details of new users and roles, if any.
UAT Credential Sheet
20
Verify whether all the localisation data was added in UAT, including Hindi, and updated in the release kits.
Localisation
All localisations added as part of the release.
21
Verify whether the product release notes and user guides are updated and published.
22
The demo of the released features is done by the product team as part of the sprint/release showcase.
Demo Link
23
Technical and product workshops/demos are conducted by the engineering and product teams to the implementation team (Implementation handover).
Plan service Resource Estimation Service
Technical and product handover to impel conducted on 04-JUN-2024. Signoff on handover is given on 04-JUN-2024
24
Architect sign-off and technical quality report.
Technical Release Summary
Signed off on 02-JUN-2024.
25
Success metrics and product roadmap.
Link
26
Success metrics and product roadmap.
Link
27
Programme roll-out plan.
Link
28
Implementation checklist.
Impel checklist
29
Implementation roll-out plan.
Roll-out plan
30
Gate 2
31
The internal release communication along with all the release artefacts are shared by the engineering/product teams.
32
Plan for upgrading the staging/demo instance with the release product - within 2-4 weeks based on the period where no demos are planned from staging for the previous version of the released product.
33
The release communication to partners is shared by the GTM team and the webinar is arranged by the GTM team after the release communication - within 2-4 weeks of the release.
Product showcase done on 10-JUN-2024 by