🏗️ architecture

Attendee Experience API

Last Updated: 2025-11-02

Last updated: December 20, 2025 Reading time: 5 minutes File size: 7.39 KB

Important: Attendee entity references User entity (ADR-004). Attendee does NOT duplicate email, name, or company fields. API responses combine User + Attendee data via JPQL joins.

This document outlines the Attendee Experience Domain API, which handles attendee registration, content discovery, and historical archive search across 20+ years of BATbern content.

Overview

The Attendee Experience API provides endpoints for:

  • Event registration management
  • Full-text content discovery and search
  • Personal attendee dashboard
  • Access to historical event archives

API Endpoints

Content Discovery & Search

Search Historical Content

yaml
GET /api/v1/content/search
tags: [Content]
summary: Search historical content
parameters:
  - name: query
    in: query
    required: true
    schema:
      type: string
    description: Search query for full-text content search
  - name: contentType
    in: query
    schema:
      type: string
      enum: [presentation, handout, video, document]
    description: Filter by content type
  - name: eventYear
    in: query
    schema:
      type: integer
    description: Filter by event year
  - name: username
    in: query
    schema:
      type: string

      description: Meaningful identifier (see ADR-003)
    description: Filter by speaker
  - name: limit
    in: query
    schema:
      type: integer
      default: 20
      maximum: 100
  - name: offset
    in: query
    schema:
      type: integer
      default: 0
responses:
  '200':
    description: Search results
    content:
      application/json:
        schema:
          type: object
          properties:
            results:
              type: array
              items:
                $ref: '#/components/schemas/ContentSearchResult'
            facets:
              $ref: '#/components/schemas/SearchFacets'
            pagination:
              $ref: 'common#/components/schemas/Pagination'

Core Workflows

Content Discovery & Search

sequenceDiagram participant A as Attendee participant AE as Attendee Experience Service participant Search as PostgreSQL Search participant S3 as AWS S3 participant Cache as Caffeine Cache A->>AE: Search "advanced architecture patterns" AE->>Cache: Check Search Cache alt Cache Miss AE->>Search: Execute Full-Text Search Search-->>AE: Content Matches + Scores AE->>AE: Apply User Preferences Filter AE->>Cache: Cache Results (15 min TTL) else Cache Hit Cache-->>AE: Cached Search Results end AE->>S3: Get Content Metadata S3-->>AE: File Details + Thumbnails AE-->>A: Ranked Search Results A->>AE: Download Presentation AE->>S3: Generate Presigned URL S3-->>AE: Secure Download Link AE-->>A: Direct Download Link

Schemas

Content Search Result

yaml
ContentSearchResult:
  type: object
  properties:
    id:
      type: string

      description: Meaningful identifier (see ADR-003)
    title:
      type: string
    description:
      type: string
    contentType:
      type: string
      enum: [presentation, handout, video, document]
    fileId:
      type: string

      description: Meaningful identifier (see ADR-003)
    eventCode:
      type: string

      description: Meaningful identifier (see ADR-003)
    eventTitle:
      type: string
    eventDate:
      type: string
      format: date-time
    username:
      type: string

      description: Meaningful identifier (see ADR-003)
    speakerName:
      type: string
    companyName:
      type: string
    thumbnailUrl:
      type: string
      format: uri
    downloadUrl:
      type: string
      format: uri
      description: Presigned download URL
    relevanceScore:
      type: number
      format: double
      description: Search relevance score (0-1)
    tags:
      type: array
      items:
        type: string
    viewCount:
      type: integer
      description: Number of times content was viewed
    downloadCount:
      type: integer
      description: Number of times content was downloaded
    createdAt:
      type: string
      format: date-time

Search Facets

yaml
SearchFacets:
  type: object
  description: Aggregated facets for refining search results
  properties:
    contentTypes:
      type: array
      items:
        type: object
        properties:
          type:
            type: string
          count:
            type: integer
    years:
      type: array
      items:
        type: object
        properties:
          year:
            type: integer
          count:
            type: integer
    speakers:
      type: array
      items:
        type: object
        properties:
          username:
            type: string

            description: Meaningful identifier (see ADR-003)
          speakerName:
            type: string
          count:
            type: integer
    companies:
      type: array
      items:
        type: object
        properties:
          companyName:
            type: string

            description: Meaningful identifier (see ADR-003)
          companyName:
            type: string
          count:
            type: integer
    tags:
      type: array
      items:
        type: object
        properties:
          tag:
            type: string
          count:
            type: integer

Content Discovery Features

Full-Text Search

The content search engine provides:

  • PostgreSQL Full-Text Search: Leveraging PostgreSQL’s built-in FTS capabilities
  • Relevance Ranking: Results ranked by relevance score
  • Fuzzy Matching: Handles typos and similar terms
  • Multi-field Search: Searches across titles, descriptions, abstracts, and tags
  • Language Support: English and German content indexing

Search Faceting

Faceted search allows attendees to:

  • Filter by Content Type: Presentations, handouts, videos, documents
  • Filter by Year: Browse historical content by year
  • Filter by Speaker: Find content from specific speakers
  • Filter by Company: Discover content from partner companies
  • Filter by Tags: Browse by topic tags and categories

Historical Archive

20+ years of BATbern content accessible through:

  • Year Browser: Browse events by year
  • Timeline View: Chronological view of all events
  • Speaker Archive: Complete history of speaker presentations
  • Topic Evolution: Track how topics evolved over time
  • Legacy Format Support: Access to older presentation formats

Caching Strategy

Content search employs multi-level caching:

  • Search Results: 15-minute Caffeine in-memory cache for query results (per service instance)
  • Content Metadata: 1-hour in-memory cache for file metadata
  • CDN Caching: CloudFront edge caching for static content
  • Browser Caching: Client-side caching with ETags

Performance Optimization

Search performance optimized through:

  • Database Indexing: GIN indexes on full-text search columns
  • Materialized Views: Pre-aggregated facet counts
  • Query Optimization: Prepared statements and connection pooling
  • Pagination: Cursor-based pagination for large result sets
  • Asynchronous Loading: Lazy loading of thumbnails and metadata