Design

1. Overview

This module contains detailed design documentation for the Registration Portal features and implementation. It covers feature workflows, technical design decisions, and development guides.

2. Feature Design

2.1. LinkedPerson Management

Design for managing groups of related people:

  • Person search and matching algorithms

  • Relationship type classification

  • Permission model for linked persons

  • UI workflow for adding and editing persons

See LinkedPerson Management for details.

2.2. Membership Registration

Design for the membership registration workflow:

  • Person selection interface

  • Pricing calculation logic

  • Question workflow integration

  • Payment processing flow

See Membership Registration for details.

2.3. Event Registration

Design for the event participant registration workflow:

  • Event selection and display

  • Participant eligibility validation

  • Question workflow integration

  • Confirmation and notification

See Event Registration for details.

3. Technical Design

3.1. Process Flow Integration

The Registration Portal leverages ProcessDefinition entities to create dynamic, sequential form workflows:

  • Sequential steps with back navigation

  • Batch processing for multiple participants

  • Dynamic form generation

  • Progress tracking

See Process Flow Integration for details.

3.2. Question Types

Form question types (FormField implementations) used in registration workflows:

  • Generic questions (CON, PHN, EMC, CLV)

  • CSA identification and compliance (CSI, CSM, CSL)

  • Event category and race selection (ECA, ERT)

  • Equipment management (NSR, TSR)

See Question Types for details.

3.3. Security Implementation

Implementation details for the security architecture:

  • Hash-based authentication endpoint (AuthenticationResource)

  • OIDC authentication with backend token exchange

  • JWT session management and automatic refresh

  • JWT relay filter for backend requests

  • Tenant context handling

See Security Implementation for details.

3.4. Phase 2 Registration Design

Unified registration flow design for Event and Membership registration:

  • Optional OIDC authentication with anonymous fallback

  • Unified person management

  • Configurable question workflows

  • Flexible payment options

See Phase 2 Registration Design for details.

3.5. Payment API Design

API design for the P2 payment flow:

  • Separation of order creation from payment initiation

  • Multiple payment methods (Online, EFT, Manual)

  • Reference code generation for non-online payments

  • Order review before payment

See Payment API Design for details.

4. Development Guides