HCM v2.0

What's Changed

• Removed duplicate pgr build configs by @holashchand in #1619
• updated the jsoup library, Tracer version upgrade, Fixed the Employee DTO by @RajeswariGangula-egov in #1646
• Adding changes for Multi-Architecture Docker Images by @RajeswariGangula-egov in #1642
• updated few services using java17 by @RajeswariGangula-egov in #1649
• Adding changes for Multi-Architecture Docker Images by @RajeswariGangula-egov in #1652
• Downsync Issues Fixed by @holashchand in #1656
• Adding changes for Multi-Architecture Docker Images by @RajeswariGangula-egov in #1659
• updated PfProjectIdValidatorTest.java by @nitish-egov in #1683
• BUGFIX Added retry time to be configurable by @nitish-egov in #1688
• BUG Bash Fixes, Code cleanup & fixes on microplan by @ashish-egov in #1680
• All validations by @ashish-egov in #1698
• changed the locale from default request info to request from user by @nitish-egov in #1708
• refactored locale related changes in download template function by @nitish-egov in #1707
• Broker fix by @ashish-egov in #1714
• Project batch fix by @ashish-egov in #1715
• Fix for microplan flow Update campaignApis.ts by @ashish-egov in #1721
• Nitish patch 1 by @nitish-egov in #1684
• Dev by @nitish-egov in #1685
• Update onGoingCampaignUpdateUtils.ts for update fix by @ashish-egov in #1737
• Update Dockerfile by @ashish-egov in #1739
• BugFix : on Update campaign flow & status map api(#1742) by @ashish-egov in #1742
• Plan service additional details fix by @abishekTa-egov in #1744
• Fix project search reference id validation by @ashish-egov in #1751
• Added Excel ingestion service for campaign creation by @ritikegov in #1777
• project facctory code clean up by @ritikegov in #1776
• PR for Boundary management service by @ritikegov in #1778
• Console tenant id fix in 0.5 by @ritikegov in #1783
• email notification fix by @ritikegov in #1788
• NullPointer Gaurding by @abishekTa-egov in #1789
• BUGFIX Project factory tenant id fix by @ritikegov in #1779
• Email notification issue fix by @ritikegov in #1790
• same error coming multiple time -fix by @ritikegov in #1791
• add variable in config file by @ritikegov in #1794
• excel-llibraoffice-open-issue-fix by @ritikegov in #1796
• add branch for build by @ritikegov in #1800
• Kafka issue fix by @ritikegov in #1801
• fix bugs to excel opening by @ritikegov in #1803
• Excell cascarding by @ritikegov in #1805
• localization fix for userCredential sheet by @ritikegov in #1806
• Excel api cleanup 1 by @ritikegov in #1811
• Excel ingestion table fix by @ritikegov in #1813
• User credential sheet fix by @ritikegov in #1814
• fix boundary code and name in user credential sheet by @ritikegov in #1815
• adding a branch for build by @ritikegov in #1817
• Boundary service code fix by @ritikegov in #1818
• Pgr boundary search enhancments by @Sreejit-K in #1839
• added a branch for build by @ritikegov in #1841
• Pgr service enhancments master by @Sreejit-K in #1842
• New Email Template Changes by @ritikegov in #1843
• locale fix by @ritikegov in #1851
• email template type fix by @ritikegov in #1853
• config fix by @ritikegov in #1854
• add branch for build by @ritikegov in #1855
• campaign update - boundary data fix by @ritikegov in #1856
• fix user sheet and userCredential sheet by @ritikegov in #1858
• fix boundary name bug by @ritikegov in #1859
• Additional field validaton changes master by @Sreejit-K in #1857
• RELEASE HCM-2.0 & Console v1.0 services merge from develop by @ritikegov in #1860

New Contributors

• @ritikegov made their first contribution in #1777

Full Changelog: v1.8...v2.0

HCM v1.8

HCM v1.8 introduces multiple foundational enhancements focused on increasing field flexibility, enabling partner self-service, and ensuring robust offline operability. Key improvements span campaign configuration, Enumeration tool Productization, HCM Console v0.4, Microplanning v0.3, Beneficiary ID generation & Search, Transit Post, Attendance Revamp, and peer device sync, alongside a broad set of backend changes and bug fixes.

Modules Summary

Admin Console v0.4

Enables no-code configuration and campaign setup by partners without engineering intervention.

• Configure geography, duration, modules, and eligibility logic
• Enable or disable modules, features, and screens
• Template reuse, localization, and support for multiple delivery strategies
• Process optimized for data creation and validation
• Template generation optimized with improved structure and flexibility
• Data processing and generation logic made modular and loosely coupled
• Backend now handles app config and app localization creation
• Retry mechanism integrated to improve backend reliability

Server-Generated Beneficiary IDs

Offline-accessible unique IDs tied to household/individual records, shown under a new “Beneficiary IDs” section.

• Reduces QR code dependency
• Enables beneficiary registry reuse across campaigns

Enumeration Tool

A configurable module for collecting household- and individual-level data, with support for complex relationships and consent tracking.

• Conditional logic through attribute-based triggers
• Parent-child and household linking

Transit Post Mode

Allows rapid configuration and data capture at unstructured, high-footfall locations like bus stops or parks.

• Records aggregate-level delivery data
• Supports preloaded or dynamic site configurations

QR Code-based Attendance Verification

Adds offline-capable, supervisor-verified attendance tracking using QR codes assigned to employees.

Peer-to-Peer Data Sharing (Downsync)

Allows a single server-synced device to share data with others via Wi-Fi Direct, enabling immediate offline operations.

Backend Enhancements

• Central instance multi-tenancy
• Java 17 migration for multiple services (service-request, pgr-services, egov-hrms and product )

What's Changed

• Hlm 6385 irs changes by @kanishq-egov in #841
• Hcmpre 240 by @kanishq-egov in #846
• HLM rowmapper issue in household, referral fixed by @kanishq-egov in #848
• added logic for cascading project date updates by @nitish-egov in #834
• HLM fixed issues in useraction existent entity validator by @kanishq-egov in #850
• updated version for hcm v1.5 release by @kanishq-egov in #852
• Hcmpre 309 rebase by @kanishq-egov in #857
• HCMPRE-169 code review comments by @Priyanka-eGov in #835
• HCMPRE-218 adding validation for plan config name by @Priyanka-eGov in #844
• HCMPRE-646: added changes by @kanishq-egov in #897
• Update CODEOWNERS by @kavi-egov in #924
• Hcmpre 639 shashwat changes by @kanishq-egov in #919
• Fixed multiple role search in individual service by @shashwat-egov in #992
• Hcmpre 639 shashwat changes by @Shashwat12-egov in #973
• HCMPRE-371: Added service definition update api by @yashita-egov in #996
• Update ValidatorUtil.java by @Shashwat12-egov in #1112
• added-search-criterias-project-service by @nitish-egov in #1169
• Service additional field by @Shashwat12-egov in #1146
• Hcmpre 469 pagination all by @kanishq-egov in #891
• 0.4 by @ejagankumar in #1265
• some boundary bulk and microplan user changes by @ashish-egov in #1268
• localisation-cache-fix by @ashish-egov in #1270
• PR to develop branch for Microplanning v0.1 (changes in plan-service, resource-generator service) by @Priyanka-eGov in #1176
• Microplan fix by @ashish-egov in #1269
• Boundary fix message by @ashish-egov in #1279
• Facility Fix by @ashish-egov in #1282
• added gzip handler in middleware by @nitish-egov in #1290
• refactor target generate and validate for generic type by @nitish-egov in #1296
• Facility Singular Creation by @ashish-egov in #1302
• Update campaignUtils.ts for update target fix by @ashish-egov in #1304
• Allow facility capacity to be 0 in sheet uploads for microplan by @ashish-egov in #1303
• Implemented functionality to include all boundaries present in the fa… by @ashish-egov in #1306
• Optimized latitude and longitude validation logic for improved effici… by @ashish-egov in #1310
• HCMPRE-874: Model changes by @yashita-egov in #1305
• Hcmpre 874: Beneficiary Type Enum added by @yashita-egov in #1033
• updated changelog for health-services-model by @yashita-egov in #1313
• Implemented locale and campaign check by @ashish-egov in #1300
• refactored target tabs validate logic by @nitish-egov in #1330
• Update campaignUtils.ts by @ashish-egov in #1332
• added config for retry for resource creation completion by @nitish-egov in #1333
• refactored code for header localization by @nitish-egov in #1338
• feat: Implement facility list with inactive by default and toggle act… by @ashish-egov in #1343
• [HCMPRE-857, HCMPRE-1139, HCMPRE-1303, HCMPRE-1158] Changes in hrms-service for email notification feature, UUID and role search changes, Pagination and case insensitive fuzzy search in user name by @tanishi-egov in #1337
• Added support to search projects based on ancestor project id by @holashchand in #1298
• Console drop by @nitish-egov in #1359
• HCMPRE-1254-Adding household type for communal living facility by @shubhang-eGov in #1124
• enrich skill and localityCode in individual by @yashita-egov in #1363
• Dev merge resolve by @holashchand in #1364
• added changelog for household service by @yashita-egov in #1365
• Version upgraded for hrms service by @holashchand in #1366
• added locale column in generated resource table for generating template based on locale by @nitish-egov in #1351
• Created User issue fixed by @ashish-egov in #1370
• corrected migration file for proejct-factory by @nitish-egov in #1371
• added fix for type boundary-management by @nitish-egov in #1376
• User Jurisdiction enrichment by @ashish-egov in #1380
• HCMPRE-2248 : Removed unnecessary log.info, moved string literals to constants, moved common functions to utils class, modified additional_details filter query in plan, added comments for some functions by @tanishi-egov in #1375
• renamed migration file by @nitish-egov in #1393
• HCMPRE-2248: Cleanup for PlanEmployeeAssignment ...

HCM Mircoplanning v0.3 Release

Release Summary

1. View Audit Logs Post Microplan Finalization
Enabled viewing of audit logs for finalized Microplans via the user's inbox.
Logs include approval history, assumption changes, and column modifications.
Each entry captures user details and timestamps.
Logs are generated only after Microplan finalization to ensure accuracy.

2. Draft Microplan Download Before Finalization
Added a "Download Draft Microplan" option post formula entry for pre-finalization review.
Users can review assumptions and estimated resources before freezing the Microplan.
Once frozen, edits are disabled to ensure data integrity.
Draft reflects current assumptions and resources; finalization is mandatory for next steps.

3. Add Custom Columns in Microplan UI
Users can add non-calculative custom columns post formula entry.
Visible in Draft and Final estimates and exportable to Excel.
No impact on existing calculations.

4. UI Enhancements
Draft download - System admins can download draft microplan before doing setup complete.
Add new columns - System admins can add additional columns, those will be reflected in the microplan sheet and can be edited.
View Map : Supervisors can see villages and facilities on a map in plan inbox and facility inbox respectively.
Freeze Microplan : System admins can freeze microplans(setup complete) from Open microplans screen once they finalize the draft.
Draft Complete and Setup Complete : Bifurcated Setup complete into these 2 actions. From the Setup flow System Admin can only complete the draft and after multiple iterations they can finalize(Setup Complete) from the my microplans screen.

HCM-Microplanning v0.2

Release Summary
This release introduces significant enhancements to microplanning functionality, focusing on improved reporting, facility management, and filtering capabilities, supported by updates across Excel reports, facility management, and distribution strategies.

Module Highlights:

1. Reporting & Analytics - Enhanced Excel reports with localized headers and facility catchment details, removing redundant information.
2. Facility Management - Improved boundary validation and jurisdiction mapping, with support for zero/empty capacity values.
3. Distribution Strategy - Implemented mixed registration and distribution strategies with updated dashboard visualizations.
4. Search & Filter - Added comprehensive filtering options for village accessibility, security parameters, and facility-based searches.
5. User Experience - Enhanced draft management and boundary-user relationship handling.

Previous Limitations Addressed:

• Added village-level accessibility/security configuration
• Enabled zero capacity support for facilities
• Implemented mixed distribution strategies

This release significantly improves the microplanning system's usability while addressing key limitations from previous versions.

HCM v1.7

In the HCM 1.7 release, we are excited to introduce several technical improvements and functional enhancements, including three key capabilities Micro Planning, Admin Console and Payments.

Microplan Summary
This release introduces significant enhancements to microplanning functionality, focusing on improved reporting, facility management, and filtering capabilities, supported by updates across Excel reports, facility management, and distribution strategies.

Module Highlights:

1. Reporting & Analytics - Enhanced Excel reports with localized headers and facility catchment details, removing redundant information.
2. Facility Management - Improved boundary validation and jurisdiction mapping, with support for zero/empty capacity values.
3. Distribution Strategy - Implemented mixed registration and distribution strategies with updated dashboard visualizations.
4. Search & Filter - Added comprehensive filtering options for village accessibility, security parameters, and facility-based searches.
5. User Experience - Enhanced draft management and boundary-user relationship handling.

Previous Limitations Addressed:

• Added village-level accessibility/security configuration
• Enabled zero capacity support for facilities
• Implemented mixed distribution strategies

This release significantly improves the microplanning system's usability while addressing key limitations from previous versions.

Payments Summary
The primary purpose of this enhancement is to streamline attendance review and payment processing workflows for health campaign workers. It ensures that supervisors can:

1. Access tools and functionalities tailored to their responsibilities.
2. Maintain clear separation between proximity and campaign-specific workflows.
3. Facilitate accurate and timely payments for healthcare workers based on attendance.

Module Highlights:

1. Project Service enhancement to facilitate children level search through projectHierarchy and localityCode.
2. Health-HRMS enhancement to create users by localityCode

Note
These enhancements work in tandem with the following DIGIT-Works modules:

1. Attendance Service
2. Muster-roll Service
3. Expense Service
4. Health Expense Calculator

These modules are present here

Community Living Facilities Summary
This feature is to allows the registrar/distributor to enumerate beneficiaries in the Communal living facility.

Module Highlights:

1. Household service enhancement to facilitate creation of community type households

What's Changed

• HCM 1.7 :: Console v0.3.1 :: Patch Fixes & Improvements by @jagankumar-egov in #1367

Full Changelog: v1.7...HCM-ADMINCONSOLE-v0.3.1

What's Changed

• Dev by @holashchand in #1362
• Dev by @holashchand in #1368
• HCMPRE-1922 - Microplanning v0.2 master merge by @Priyanka-eGov in #1340
• Adding health in service-request build by @shubhang-eGov in #1373
• bumped health-service-models for household type by @shubhang-eGov in #1387
• Bumped patch version and updated changelog by @shubhang-eGov in #1391
• HCMPRE-2313 throwing error while validating string rows only when the column is r… by @Priyanka-eGov in #1394
• HCM 1.7 :: Console v0.3.1 :: Patch Fixes & Improvements by @jagankumar-egov in #1367
• Template validation issue by @Priyanka-eGov in #1399

Full Changelog: v1.6...v1.7

HCM v1.6

In the HCM 1.6 release, we are excited to introduce several technical improvements and functional enhancements, including two key capabilities Micro Planning and Admin Console.

Microplan summary

This module enables campaign workers to generate precise population estimates and optimize resource allocation, leading to significant time and cost savings in campaign execution.

This release introduces key modules for managing and validating microplans, assigning facilities, and finalising estimations, with support from three services: Plan Service, Resource Generator, and Census Service. Known limitations are also outlined.

Module Highlights:

1. Set Up & Manage

   • Set up and manage microplans, including campaign details and administrative boundaries.
   • Ingest top-down population and facility data.
   • Configure assumptions and estimation formulas.
   • Create and manage user access.
   • Reuse existing microplans.

2. Validation

   • Validate and finalize population data for microplanning.
   • Edit, approve, or reject population data updates.
   • Track status logs and user comments.

3. Map & Assign

   • Assign facilities to catchment areas and manage jurisdiction mappings.
   • De-assign or finalize mappings for service delivery.

4. Estimation

   • Validate, edit, and finalize microplan estimations.
   • Update assumptions for accessibility and security.
   • Review status logs, change logs, and user comments.
   • Export finalised microplans to Excel.

Services Used in Microplanning

• Plan Service: Manages campaign plans and configurations.
• Resource Generator: Facilitates resource estimation and allocation.
• Census Service: Provides population data for microplanning.

Known Limitations

• Estimation dashboard lacks village-level configuration for accessibility/security.
• Facility upload sheets don’t accept zero capacity.
• Mixed distribution strategies (Fixed post + House-to-House) are not configurable.

This release sets the foundation for effective microplanning while addressing limitations in upcoming updates.

Admin Console summary

The Console is a critical module within the HCM platform designed for System Administrators and Program Managers to efficiently set up, configure, and manage health campaigns. With the Console, users can:

• Set Up Campaigns: Create campaigns for specific diseases in under three hours.
• Configure Campaigns: Tailor HCM Mobile App features to align with country-specific needs within a day
• Manage Campaigns: Update or modify campaign data in real-time to adapt to the how the campaign is evolving

What the Admin Console Is Not:

• A module that lets you create new features and data models on HCM
• A Module that can create new campaign types

Future Potential:

• Management Dashboard: A centralized view for organisational leaders to oversee multiple campaigns at a strategic level.
• Organisational Insights: Provide actionable analytics not just at the campaign level but across the entire organisation.

Key values delivered:

• Effort Reduction: Simplifies campaign setup, minimizing coordination and manual effort
• Time Savings: Speeds up the campaign setup process
• Error Reduction: Decreases the risk of setup errors
• Lower Technical Barriers: Allows non-technical users to manage campaigns efficiently
• Enhanced Agility: Accommodates last-minute campaign data and app configuration changes without causing delays

Target users:

• System Administrators, Programme Managers, IT Managers, and non-technical personnel familiar with health campaign workflows.

HCM dashboard enhancements

Summary:

The Seasonal Malaria Chemo-prevention (SMC) campaign dashboard within the HCM system has been enhanced to provide greater flexibility, data visualisation, and actionable insights.

Key improvements include:

• Pre-Built Dashboards with Customisation: Out-of-the-box dashboards tailored for various campaign types (ITN, SMC, IRS) with the ability to configure custom charts for specific country/program needs using the open-source ElasticSearch Kibana dashboard.
• Data Evaluation Modules: New features to assess data quality, team performance, and attendance.
• Expanded Chart Capabilities:
  - Venn diagrams for advanced analysis. For example, in SMC campaigns, these charts help evaluate multi-cycle intervention delivery, such as determining how many beneficiaries received medication across all cycles, one cycle, or specific combinations.
  - Side-by-side comparison charts for multi-dimensional data with more than two bars.

Key Values Delivered:

• Customisation Flexibility: Partners and countries can add custom charts to suit specific country requirements integrated into ready-to-use campaign dashboards built in DIGIT’s DSS that have enhanced user experience.
• Targeted Insights: Enables evaluation of intervention coverage, such as tracking how many individuals received medication across multiple cycles.
• Advanced Visualization: Multi-dimensional data analysis through side-by-side charts and Venn diagrams. For example, inventory trends across different supply chain stages or intervention outcomes by region.

HCM v1.5

Release Summary

Features:

• Enhancement of DIGIT HCM for managing a new campaign such as IRS.
• Enhancement to provide the ability to link downloaded households to new campaigns.
• The product has been enhanced to capture information related to house structure, room details, and the number of pregnant women and children present in the house independent of the campaign type.
• Enhanced accuracy for geo coordinates capture in the app.
• Enhancement of DSS dashboards for new campaign adaption.
• Enhancement to provide the ability to view dashboards for District Supervisors in the mobile application.

Functional Changes

• Closed Household: This feature enables data collection on closed households by utilizing the existing registration and delivery package. It allows CDDs (Community Drug Distributors) to revisit households for registry updates efficiently.
• Registration and Delivery: Added intermediate screens to enhance registration of households to support new campaigns.

User Action:

Full CRUD functionality for project-related actions taken by the field worker that are not tasks related to the beneficiary like:

• Refusal of consent for data collection.
• Scanning of resources that will be reused for multiple deliveries.
• Marking a transit post-non-compliant (polio).
• Marking any incident that doesn't bear relation to the beneficiary.
• Location capture of the field worker app.

Dashboard Updates:

• Mobile Dashboard: Enabled the mobile dashboard for district supervisors and configured the Digit UI DSS Dashboard to support new campaigns (e.g. IRS).
• National Dashboard Enhancements: Introduced support for pie charts and bar charts.
• Map Configurations: Moved map configuration data to S3 assets.
• Chart Configurations: Added and modified chart configurations for both the Mobile and DSS Dashboards (e.g., IRS), including both new and existing charts.

Tech Debts

• Search Query Optimization: Enhanced search queries across the mobile application for improved performance.
• Boundary Localizations: Migrated boundary localizations from the ISAR (JSON) database to an SQL database in the mobile application for better efficiency.

Benefits of v1.5

• Configurable Project Dashboard: Previously, project dashboard configurations were hardcoded. Now, they are fully configurable based on boundary v2 and project-type codes.
• Removal of Hardcoded Context Paths: All hardcoded context paths have been removed throughout the application, improving flexibility and maintainability.
• Map Config Data Moved to S3: Due to the large size of the map configuration data, it could not be loaded into MDMS v2. This data has now been moved to S3 assets for better handling and storage.
• Search Query Enhancement: Previously, each entity had its own individual search. Now, we have implemented a unified query builder, which has significantly improved the performance of the search functionality.

HCM v1.4

Release Summary

DIGIT-HCM release v1.4 is a Tech only release with no major product changes

• 2.9 core LTS upgrade

  • Boundary v2 integration

    • Boundary data is now being fetched from the V2 service after the migration of data from MDMS v1

  • MDMS v2 integration

    • HCM is now integrated with MDMS v2
    • The search functionality will work similarly to MDMS v1
    • New schemas and data have been added for the new service as part of seed data collection
• Client reference Id missing validation added in all offline models
• health models reorganised with proper hierarchy relationship
• Handled reflection utils method issues due to restrictions in JAVA 9 and above on accessing in-build method
• All core services have been upgraded to core 2.9 LTS barring the services modified for offline use case
  • egov-hrms
  • pgr-services
  • service-request
• All Data models have been restructured with an is a relationship from base eGov model and base eGov search model.
• Missing unique validation on client ref ID added on all offline support services.
• Replacing single field to array field search to all parent key fields

HCM v1.3

Release Summary

DIGIT-HCM release v1.3 is a new release that offers new platform features and functions, the details of which are provided below.

Functional changes

• Integration with DIGIT-Works Attendance Module.
• Offline Enabled Functionality in Attendance Module.
• Capture Referral handled by Health Facility in Referral Management Service.
• Start and End Date Validation for Project Update in Project Service.
• Offline enabled Individual based User creation for HRMS Service.

HCM v1.2

Release Summary

DIGIT-HCM release v1.2 is a new release that offers new platform features and functions, the details of which are provided below.
Functional changes

• Added Proximity based search on Household and Individual
• Multi Round Campaign enabled in the mobile app
• Ability to configure cycles and deliveries
• formula to calculate dosage based on criteria added in MDMS
• Referral management & Side effect
• Total Count added in Household search
• Adding voucher Tag(QR code) during beneficiary registration
• Last mile delivery with QR code (only BE - exchange of inventory between any users using user uuid scanned from logged in user profile code)
• Down Sync API (v1.0)