Operations

1. Overview

This module documents operational procedures for managing the Event and Membership Administration System in production environments. It covers API-based management access and cache eviction procedures that do not require application restarts.

This module focuses on runtime operations. For deployment and infrastructure, see the Deployment module.

2. Management API

  • Management API Access - Authenticate and access Spring Boot Actuator endpoints using API keys for log level management, health checks, and configuration inspection.

3. Cache Management

  • Cache Management - Understand the caching architecture (Spring + Hibernate L2 + Hazelcast) and evict caches cluster-wide without restarting pods.

4. Email

  • SMTP Configuration - Outbound email setup for EMS services: production Exchange Online connector, dev GreenMail, shared spring.mail.* config surface, multi-tenant From-address considerations.

5. Observability

  • OpenTelemetry Configuration - OTel javaagent + SDK configuration for admin-service, collector topology, trace/metric/log correlation, sampling strategy, and the known gap of OTel not yet enabled on registration-portal.

6. Data Imports

  • Import Operations Guide - Step-by-step operator guide for Event Participant and Result imports: endpoint / mode / points-calculator selection, pre-flight checklist, response interpretation, and recovery from mode-mismatch data loss.

7. Number & Tag Management

  • Number & Tag Runbook - Manual procedures for processing returned boards, updating assignments from race results, linking numbers to persons, and pre-assigning numbers to future events.

  • Number & Tag API Operations Guide - Operator guide for driving the WS1a/WS1b lifecycle endpoints directly (stock view, return, flag-unfit, dispose, timing feed, manual reassignment) while admin-ui is not available.