Membership Registration

/membership/register/:membershipPeriodId

https://app.example.com/membership/register/42?u=abc123xyz&h=5d41402abc4b2a76b9719d911017c592

export const membershipGuard: CanActivateFn = (route: ActivatedRouteSnapshot) => {
  const router = inject(Router);
  const membershipPeriodId = route.paramMap.get('membershipPeriodId');
  const pathUserKey = route.paramMap.get('u');
  const queryUserKey = route.queryParamMap.get('u');
  const userKey = pathUserKey || queryUserKey;
  const providedHash = route.queryParamMap.get('h');

  // Both userKey and hash must be present
  if (!userKey || !providedHash) {
    router.navigate(['/membership/register', membershipPeriodId], {
      queryParams: { error: 'Missing security verification parameters' }
    });
    return false;
  }

  // Verify hash
  const expectedHash = Md5.hashStr(SECRET_KEY + userKey);
  if (expectedHash !== providedHash) {
    router.navigate(['/membership/register', membershipPeriodId], {
      queryParams: { error: 'Invalid security verification' }
    });
    return false;
  }

  return true;
};

private loadMembership(): void {
  this.loading = true;
  this.formService
    .getFormMembership(this.membershipPeriodId, this.userKey)
    .pipe(
      tap(formState => {
        this.formDTO = formState;
        this.linkedPersons = formState.people
          ? Array.from(formState.people)
          : [];
        this.processId = formState.processId;

        // Set selected persons based on API response
        this.selectedPersons = this.linkedPersons
          .filter(person => person.selected);

        if (formState.processState === ProcessInstanceDTO.StatusEnum.Running ||
            formState.processState === ProcessInstanceDTO.StatusEnum.Resume) {
          this.showProcessDialog();
        }
      }),
      takeUntil(this.destroy$),
      finalize(() => (this.loading = false))
    )
    .subscribe();
}

{
  "processId": "proc-123",
  "step": 1,
  "processState": "NONE",
  "people": [
    {
      "id": 1,
      "firstName": "John",
      "lastName": "Smith",
      "dateOfBirth": "1985-03-15",
      "status": "Available",
      "canSelect": true,
      "selected": false
    },
    {
      "id": 2,
      "firstName": "Jane",
      "lastName": "Smith",
      "dateOfBirth": "1987-07-20",
      "status": "Available",
      "canSelect": true,
      "selected": false
    },
    {
      "id": 3,
      "firstName": "Billy",
      "lastName": "Smith",
      "dateOfBirth": "2010-11-03",
      "status": "Available",
      "canSelect": true,
      "selected": false
    }
  ]
}

showProcessDialog(): void {
  this.sharedDialogService
    .show({
      header: 'Existing Registration',
      message: 'A previous registration attempt has been detected. ' +
               'Would you like to continue with that, or start fresh?',
      buttons: [
        {
          label: 'Start Fresh',
          action: ProcessAction.RESET,
          class: 'p-button-success',
        },
        {
          label: 'Resume',
          action: ProcessAction.RESUME,
          class: 'p-button-primary',
        },
      ],
    })
    .pipe(takeUntil(this.destroy$))
    .subscribe(result => {
      if (result === ProcessAction.RESET || result === ProcessAction.RESUME) {
        this.handleProcessAction(result as ProcessAction);
      }
    });
}

register(): void {
  this.loading = true;
  const selectedPersonsDTO = this.linkedPersons
    .filter(person => person.selected)
    .map(person => ({ id: person.id }) as FormPersonDTO);

  this.formService
    .next({
      processId: this.processId,
      step: this.formDTO.step,
      people: selectedPersonsDTO,
    })
    .pipe(
      tap(response => this.handleNextFormResponse(response)),
      takeUntil(this.destroy$),
      finalize(() => {
        this.loading = false;
      })
    )
    .subscribe({
      next: () => {
        this.showQuestionBox = true;
      },
      error: error => {
        this.showQuestionBox = false;
        this.handleError(error);
      }
    });
}

{
  "processId": "proc-123",
  "step": 1,
  "people": [
    { "id": 1 },
    { "id": 3 }
  ]
}

{
  "processId": "proc-123",
  "step": 2,
  "processState": "RUNNING",
  "question": "Does anyone have any medical conditions?",
  "questionType": "BCB",
  "required": true,
  "options": null,
  "people": [
    {
      "id": 1,
      "firstName": "John",
      "lastName": "Smith",
      "answer": null,
      "hide": false
    },
    {
      "id": 3,
      "firstName": "Billy",
      "lastName": "Smith",
      "answer": null,
      "hide": false
    }
  ],
  "paymentUrl": null
}

next() {
  this.loading = true;
  this.selectedPeople = this.people.map(_person => ({
    answer: _person.answer || '0',
    id: _person.id,
  }));

  this.formService
    .next({
      processId: this.questionData.processId,
      step: this.questionData.step,
      people: this.selectedPeople,
    })
    .pipe(finalize(() => (this.loading = false)))
    .subscribe(_response => {
      this.questionData = _response;
      this.people = Array.from(this.questionData?.people || [])
        .map(p => ({
          ...p,
          answer: p.answer || '',
        })) || [];
    });
}

isValid(): boolean {
  if (!this.questionData.required) {
    return true;
  }

  if (this.questionData.questionType === 'ITC') {
    // For ITC (Terms), all people must have answer '1' (checked)
    return this.people.every(person => person.answer === '1');
  }

  return this.people.every(person => {
    if (person.hide) {
      return true;
    }

    if (this.questionData.questionType === 'BCB') {
      return true; // Binary checkboxes are always valid
    }

    if (this.questionData.questionType === 'ONE') {
      // For required ONE type, at least one person should have answer '1'
      return this.people.some(p => p.answer === '1');
    }

    return person.answer !== null &&
           person.answer !== undefined &&
           person.answer !== '';
  });
}

pay() {
  if (this.questionData.paymentUrl) {
    this.messageService.add({
      severity: 'info',
      summary: 'Payment Portal',
      detail: 'Redirecting to payment portal...',
      sticky: true,
      life: 5000,
    });

    setTimeout(() => {
      if (this.questionData.paymentUrl) {
        window.location.href = this.questionData.paymentUrl;
      }
    }, 5000);
  }
}

https://payment.gateway.com/pay?reference=REF123&amount=800.00&return=https://app.example.com/membership/payment-return

Payment Successful!

Membership Numbers:
- John Smith: M2024-1523
- Billy Smith: M2024-1524

A confirmation email has been sent to [email protected]