Programs Integration#

Module: spp_grm_programs

Overview#

Link GRM tickets to OpenSPP programs, entitlements, and payments

This module is designed to:

Link GRM tickets to programs: Associate grievance tickets with specific programs, program memberships, cycles, entitlements, and payments.
Display program context on tickets: Show enrollment status, entitlement amounts, and payment amounts directly on the ticket form.
Auto-fill related fields: Cascade field values when a program, membership, cycle, entitlement, or payment is selected on a ticket.

Dependency	Purpose
`spp_security`	Central security definitions for OpenSPP modules
`spp_grm`	Provides a centralized Grievance Redress Mechanism for re...
`spp_programs`	Manage cash and in-kind entitlements, integrate with inve...

The module adds the following fields to spp.grm.ticket:

Field	Description
Related Program	The program related to the complaint
Program Membership	Specific enrollment related to the complaint
Program Cycle	Specific cycle related to the complaint
Related Entitlement	Specific entitlement being disputed
Related Payment	Specific payment being disputed
Enrollment Status	Computed from the linked program membership state
Entitlement Amount	Computed from the linked entitlement record
Payment Amount	Computed from the linked payment record

When a user selects a value in one of the program-related fields, downstream fields are automatically populated:

spp_grm: Extends spp.grm.ticket with program-related fields and onchange logic.
spp_programs: Links to spp.program, spp.program.membership, spp.cycle, spp.entitlement, and spp.payment models.
Auto-install: This module auto-installs when both spp_grm and spp_programs are present.