The Business Use Case

The use case is described in detail in Appendix A, but basically the objective is to evaluate a household consisting of a number of members (parents, children) to determine first the eligibility of the children and then the eligibility of the parents and finally the eligibility of the household.

The core eligibility conditions are

  • is deprived of the support or care of a parent;
  • lives with a parent or specified relative; and
  • Is less than 18 years of age or under age 19 and a full-time student in high school or in a high school equivalency program.

 

Once eligibility is determined, Assistance Groups are assigned to the household and members are allocated to the various assistance groups (NHEP, UP, IDP_TANF, APTD)

Finally payment periods are determined. Basically there will be three periods:

  • From the request date until 10 days after
  • From day 11 until the end of the month
  • From the beginning of the next month onward



Building the Data Model

The business entities that are in this model are

Household (which comprises a number of Persons)

Persons (each of whom is related to other Persons)

In the use case, the relationship that concerns us is the Parent-Child relationship because affects the eligibility determination and also once we know that we can deduce other relationships such as the sibling relation.

The Parent-Child relationship can be represented using the standard UML notation:

Figure 1 the Parent-Child Relationship in UML

Figure 2 the Parent-Child Relationship in Corticon

Because parents may have multiple children and children have more than one parent we use the many to many association.

In the tester this can be represented in several ways:

Figure 3 Hierarchical Representation

  

Figure 4 Flat Representation (with references to show the structure)

Figure 5 Mixed Representation

Figure 6 Representation using the Parent reference

All of these different forms are logically identical



 

Modeling the Child Eligibility Rules

The core eligibility rules apply to the children.

A child is eligible for TANF if they meet the following criteria:

  • is deprived of the support or care of a parent;
  • lives with a parent or specified relative; and
  • Is less than 18 years of age or under age 19 and a full-time student in high school or in a high school equivalency program

These rules can be represented in decision table format like this:

Figure 7 Basic Child Eligibility Rules

Notice the use of the scope section to define a context for the rules.

At the highest level we want to consider a Household (which is referred to using the alias HH). There may be more than one household and the alias HH serves to pick out just one of them at a time . Corticon will automatically evaluate all Households that are in the data payload.

Within the context of each HH we want Corticon to examine each of the members. At scope line 2 we use the alias “child” to refer to each member of the household (though at this point we don’t know if they are actually children or parents. The FILTER serves to define what we mean by “child”.

The filter only allows those that have age < 19 to pass down to the logic expressed in the decision table.

Each child with age < 19 is then evaluated and if they meet the criteria will have the status changed to “eligible”.

Additionally we add that eligible child to the collection of children in the Household. The alias eligibleKids refers to HH.children – which is different from the children of a parent (some of whom may not be eligible).

It might perhaps be better to use the name “eligibleChildren” as the association role name to make it very clear that this collection contains only the eligible ones and not all of them.




Modeling Rules about Family Relationships

When the decision service is invoked, the calling program will be required to pass in data about each individual. It must also indicate which individuals belong to the household. It must indicate which individuals are the children of which other individuals (note that it’s possible that a child may also be a parent).

If we know the parent-child relationship then it’s possible to deduce the sibling relationship.  In its simplest form two children are siblings if they share a parent.

Technically it’s a bit more involved – full siblings must share both parents.

If they only share the mother then they are referred to as uterine siblings and if they only share the father then they are referred to as agnate siblings.

For the purpose of this example we will consider two children simply siblings if they have at least one parent in common.

Here is the rulesheet that deduces the sibling relationship:

Figure 8 Rulesheet to deduce sibling from parent-child relationship

First we identify the context – which is Person (it’s not important at this point what household they might belong to). We name the alias “theParent” to reinforce the idea that we are examining parents (though we can call the alias anything we like)

Then, at lines 2 and 3 we create TWO aliases to the children of that parent (kid1 and kid2). Corticon will automatically try every child as kid1 and kid2.

At line 4 we create an alias to the siblings of kid1 (initially there won’t be any, but it serves to name the collection that will eventually contain the siblings of kid1)

But siblingship only applies between two DIFFERENT people – we express this in the filter by saying that the two aliases (kid1 and kid2) must be different people.

Any two children that get through this filter are therefore siblings.

At line N.1 we add kid2 to the collection of siblings of kid1.

Eg that Ashley is a sibling of Julie

Also since Corticon will automatically try every combination we will also create the inverse. i.e Julie is a sibling of Ashley




Modeling the Sibling Eligibility Rules

Now that we have established who is a sibling of whom we can model the rule that states “Siblings of eligible child are eligible who satisfies the criteria above and living with the eligible child”

This is bit odd because if they satisfy the requirements then they would have already been classified as eligible by the child eligibility rulesheet.

However, let’s go ahead and model a rule that uses the sibling relationship:

It looks like this:

Figure 9 Rulesheet for Sibling Eligibility

We use the scope to identify a kid in the household. We also create an alias for the siblings of that kid (there could be several)

Then the rule says if any sibling is eligible (condition 1) and lives with parent (and therefore with the kid) then the kid is eligible

 


Modeling Rules about Parent Eligibility

The business rule states that the parent of an eligible child is also eligible.

This is expressed in the following rulesheet:

Figure 10 Rulesheet for Parent Eligibility

Modeling Rules about Household Eligibility

Figure 11 Rulesheet for Houshold Eligibility

Modeling Rules about the Target

Figure 12 Rulesheet to identify the Target Child

Notice the use of the expression “child.age = child.age ->max”

This rather odd expression is doing something very powerful.

The first reference to “child.age” means the age of any specific child whereas the reference “child.age->max” means “look at the entire collection of child ages and find the largest one”. The overall effect of this is that the action will only be executed for the one child whose age is the greatest.

Modeling Rules about Assistance Groups

Here are the rules that determine which assistance groups need to be created:

Figure 13 Rulesheet to Create Assistance Groups

So, depending on the household we will get NHEP only, UP only or IDP_TANF + APTD.

These are then populated by the appropriate sheets. If an Assistance Group was not created then the corresponding sheet is bypassed

Figure 14 Rulesheet to add members to NHEP

Figure 15 Add members to UP

Figure 16 Add members to IDP_TANF

This sheet could be made more specific by restricting it only to non-incapacitated members

For the APTD group only eligible incapacitated members are assigned

Figure 17 Add members to APTD

Modeling Rules about Payment Periods

Figure 18 Attaching Payment Periods to Assistance Groups’

Notice the reference to various dates (such as requestPlus10, MonthEnd etc) these are calculated as follows

 

Modeling Rules about Dates

Figure 19 Determine if the request date is a leap year

Figure 20 Calculate the various dates for the payment periods

Figure 21 Logical Dependency Graph

Figure 22 Execution Sequence




Test Cases

Case 1

Figure 23 Test Data

Figure 24 Test Results

 

Case 4:

Figure 25 Case 4 Test Data

Figure 26 Case 4 Test Results

Figure 27 Case 4 Messages



 

Appendix A - Eligibility Scenarios 

Case 1: 1 Parent, 2 Children

Household of Mother and 2 children requesting TANF assistance who are living together. The data that is needed to determine the basic criteria of household eligibility is depicted below.

 

TANF basic requirements:

  1. *Household has a dependent child who meets the criteria below:
  • is deprived of the support or care of a parent;
  • lives with a parent or specified relative; and
  • Is less than 18 years of age or under age 19 and a full-time student in high school or in a high school equivalency program.
  • **Siblings of eligible child are eligible who satisfies the criteria above and living with the eligible child.
  • ***Parents are considered eligible if their dependent child is eligible.
  • **** Target is the individual on whom the assistance group is based on. It is the eldest individual that satisfies the criteria for the assistance group.
  • Disabled adults will not be part of TANF assistance rather they will receive the disability assistance.

 

Individual Data: 

Individual

Date of Birth

Age

Living Arrangement

Education

Incapacitated

Bonie Campbell

06/01/1970

41

In Apartment

College Graduate/Not enrolled

No

Ashley Campbell

02/01/2001

11

In Apartment

5th grade complete/Enrolled

No

Julie Campbell

01/01/2008

3

In Apartment

Not Enrolled

No

 

Relationships: 

Individual

Relation

Individual

Bonie Campbell

Mother

Ashley Campbell

Bonie Campbell

Mother

Julie Campbell

Ashley Campbell

Daughter

Bonie Campbell

Ashley Campbell

Sister

Julie Campbell

Julie Campbell

Daughter

Bonie Campbell

Julie Campbell

Sister

Ashley Campbell

 

Relationships (simplified): 

Individual

Relation

Individual

Bonie Campbell

Mother

Daughter

Ashley Campbell

Bonie Campbell

Mother

Daughter

Julie Campbell

Ashley

Sister

Sister

Julie Campbell

 

 

Results:

System should build assistance group named NHEP in this scenario, with following eligibility for each individual in household.

NHEP

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Bonie Campbell

Eligible

Adult

Parent of an eligible child

No

Ashley Campbell

Eligible

Child

Satisfies the deprivation requirements

Yes

Julie Campbell

Eligible

Child

Satisfies the deprivation requirement and sibling of an eligible child

No



Case 2: 2 Parents, 2 Children

Household of 2 parents (unemployed) and 2 children requesting TANF assistance who are living together. The data that is needed to determine the basic criteria of household eligibility is depicted below.

Individual

Date of Birth

Age

Living Arrangement

Education

Incapacitated

Bonie Campbell

06/01/1970

41

In Apartment

College Graduate/Not enrolled

No

Joe Campbell

05/01/1969

42

In Apartment

College Graduate/Not enrolled

No

Ashley Campbell

02/01/2001

11

In Apartment

5th grade complete/Enrolled

No

Julie Campbell

01/01/2008

3

In Apartment

Not Enrolled

No

 

Relationships:

Individual

Relation

Individual

Joe Campbell

Father

Ashley Campbell

Joe Campbell

Father

Julie Campbell

Joe Campbell

Husband

Bonie Campbell

Bonie Campbell

Mother

Ashley Campbell

Bonie Campbell

Mother

Julie Campbell

Bonie Campbell

Wife

Joe Campbell

Ashley Campbell

Daughter

Bonie Campbell

Ashley Campbell

Daughter

Joe Campbell

Ashley Campbell

Sister

Julie Campbell

Julie Campbell

Daughter

Joe Campbell

Julie Campbell

Daughter

Bonie Campbell

Julie Campbell

Sister

Ashley Campbell

 

Relationships (simplified): 

Individual

Relation

Individual

Joe Campbell

Husband

Wife

Bonie Campbell

Joe Campbell

Father

Daughter

Ashley Campbell

Joe Campbell

Father

Daughter

Julie Campbell

Bonie Campbell

Mother

Daughter

Ashley Campbell

Bonie Campbell

Mother

Daughter

Julie Campbell

Ashley

Sister

Sister

Julie Campbell

 

 

Results:

System should build assistance group named UP in this scenario, with following eligibility for each individual in household.

UP Assistance:

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Eligible

Adult

Parent of an eligible child

No

Bonie Campbell

Eligible

Adult

Parent of an eligible child

No

Ashley Campbell

Eligible

Child

Satisfies the deprivation requirements

Yes

Julie Campbell

Eligible

Child

Satisfies the deprivation requirement and sibling of an eligible child

No



Case 3: Disabled Parent

Household of 2 parents (unemployed) and 2 children requesting TANF assistance who are living together. One of the parents is disabled. The hierarchy of the process is to evaluate the aged and disabled criteria before the able bodied criteria.

Individual

Date of Birth

Age

Living Arrangement

Education

Incapacitated

Bonie Campbell

06/01/1970

41

In Apartment

College Graduate/Not enrolled

No

Joe Campbell

05/01/1969

42

In Apartment

College Graduate/Not enrolled

Disabled

Ashley Campbell

02/01/2001

11

In Apartment

5th grade complete/Enrolled

No

Julie Campbell

01/01/2008

3

In Apartment

Not Enrolled

No

 

Relationships: 

Individual

Relation

Individual

Joe Campbell

Father

Ashley Campbell

Joe Campbell

Father

Julie Campbell

Joe Campbell

Husband

Bonie Campbell

Bonie Campbell

Mother

Ashley Campbell

Bonie Campbell

Mother

Julie Campbell

Bonie Campbell

Wife

Joe Campbell

Ashley Campbell

Daughter

Bonie Campbell

Ashley Campbell

Daughter

Joe Campbell

Ashley Campbell

Sister

Julie Campbell

Julie Campbell

Daughter

Joe Campbell

Julie Campbell

Daughter

Bonie Campbelll

Julie Campbell

Sister

Ashley Campbell

 

Relationships (simplified): 

Individual

Relation

Individual

Joe Campbell

Husband

Wife

Bonie Campbell

Joe Campbell

Father

Daughter

Ashley Campbell

Joe Campbell

Father

Daughter

Julie Campbell

Bonie Campbell

Mother

Daughter

Ashley Campbell

Bonie Campbell

Mother

Daughter

Julie Campbell

Ashley

Sister

Sister

Julie Campbell

 

 

Results:

System should build 2 assistance groups (1) APTD (2) IDP-TANF in this scenario, with following eligibility for each individual in household.

 

APTD assistance:

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Eligible

Adult

 Disabled Adult aged

Yes

Bonie Campbell

Ineligible

Adult

 

No

Ashley Campbell

Ineligible

Child

 

No

Julie Campbell

Ineligible

Child

 

No

 

IDP-TANF

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Ineligible

Adult

 Due to eligibility in higher assistance APTD.

No

Bonie Campbell

Eligible

Adult

Parent of an eligible child

No

Ashley Campbell

Eligible

Child

Satisfies the deprivation requirements

Yes

Julie Campbell

Eligible

Child

Satisfies the deprivation requirement and sibling of an eligible child

No



Case 4: Considering date of application

Household of 2 parents (unemployed) and 2 children requesting TANF assistance who are living together. One of the parents is disabled. The hierarchy of the process is to evaluate the aged and disabled criteria before the able bodied criteria.

 

The rules for building the payment periods based on request date and the breaks in eligibility the type of assistance will have.

For example the Medicaid may have following breaks in eligibility. And based on these breaks the eligibility payment periods are built.

  • Break for 10 days from application date / eligibility determination date
  • Break at the end of month.
  • Breaks for any data that is collected.

 

Consider the application request date of 10/19/2011 and the request is for Medicaid, the payment periods and assistance groups for each payment periods that should be built in this scenario is depicted in the results section.

Individual

Date of Birth

Age

Living Arrangement

Education

Incapacitated

Bonie Campbell

06/01/1970

41

In Apartment

College Graduate/Not enrolled

No

Joe Campbell

05/01/1969

42

In Apartment

College Graduate/Not enrolled

Disabled

Ashley Campbell

02/01/2001

11

In Apartment

5th grade complete/Enrolled

No

Julie Campbell

01/01/2008

3

In Apartment

Not Enrolled

No

 

Relationships: 

Individual

Relation

Individual

Joe Campbell

Father

Ashley Campbell

Joe Campbell

Father

Julie Campbell

Joe Campbell

Husband

Bonie Campbell

Bonie Campbell

Mother

Ashley Campbell

Bonie Campbell

Mother

Julie Campbell

Bonie Campbell

Wife

Joe Campbell

Ashley Campbell

Daughter

Bonie Campbell

Ashley Campbell

Daughter

Joe Campbell

Ashley Campbell

Sister

Julie Campbell

Julie Campbell

Daughter

Joe Campbell

Julie Campbell

Daughter

Bonie Campbelll

Julie Campbell

Sister

Ashley Campbell

 

Relationships (simplified):

Individual

Relation

Individual

Joe Campbell

Husband

Wife

Bonie Campbell

Joe Campbell

Father

Daughter

Ashley Campbell

Joe Campbell

Father

Daughter

Julie Campbell

Bonie Campbell

Mother

Daughter

Ashley Campbell

Bonie Campbell

Mother

Daughter

Julie Campbell

Ashley

Sister

Sister

Julie Campbell

 

 

Results:

System should build 2 assistance groups (1) APTD (2) IDP-TANF in this scenario, with following eligibility for each individual in household. 

Assistance:

 

Payment Begin

Payment End date

APTD

10/19/2011

10/29/2011

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Eligible

Adult

 Disabled Adult aged

Yes

Bonie Campbell

Ineligible

Adult

 

No

Ashley Campbell

Ineligible

Child

 

No

Julie Campbell

Ineligible

Child

 

No

 

Assistance:

 

Payment Begin

Payment End date

APTD

10/30/2011

10/31/2011

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Eligible

Adult

 Disabled Adult aged

Yes

Bonie Campbell

Ineligible

Adult

 

No

Ashley Campbell

Ineligible

Child

 

No

Julie Campbell

Ineligible

Child

 

No

 

Assistance:

 

Payment Begin

Payment End date

APTD

11/01/2011

Ongoing (9999-12-31)

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Eligible

Adult

 Disabled Adult aged

Yes

Bonie Campbell

Ineligible

Adult

 

No

Ashley Campbell

Ineligible

Child

 

No

Julie Campbell

Ineligible

Child

 

No

 

Assistance:

 

Payment Begin

Payment End date

IDP TANF

10/19/2011

10/29/2011

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Ineligible

Adult

 Due to eligibility in higher assistance APTD.

No

Bonie Campbell

Eligible

Adult

Parent of an eligible child

No

Ashley Campbell

Eligible

Child

Satisfies the deprivation requirements

Yes

Julie Campbell

Eligible

Child

Satisfies the deprivation requirement and sibling of an eligible child

No

 

Assistance:

 

Payment Begin

Payment End date

IDP TANF

10/30/2011

10/31/2011

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Ineligible

Adult

 Due to eligibility in higher assistance APTD.

No

Bonie Campbell

Eligible

Adult

Parent of an eligible child

No

Ashley Campbell

Eligible

Child

Satisfies the deprivation requirements

Yes

Julie Campbell

Eligible

Child

Satisfies the deprivation requirement and sibling of an eligible child

No

 

Assistance:

 

Payment Begin

Payment End date

IDP TANF

11/01/2011

Ongoing (9999-12-31)

Individual

Eligible

Adult/Child

Eligibility criteria

Target

Joe Campbell

Ineligible

Adult

 Due to eligibility in higher assistance APTD.

No

Bonie Campbell

Eligible

Adult

Parent of an eligible child

No

Ashley Campbell

Eligible

Child

Satisfies the deprivation requirements

Yes

Julie Campbell

Eligible

Child

Satisfies the deprivation requirement and sibling of an eligible child

No