Global Referee Registry & Cross-Tenant Lending

The GlobalReferee model lives in the FIPJP tenant. Each entry carries a global referee identifier (FIPJP-REF-YYYY-NNNN), a foreign key to the player passport, the list of certifications aggregated from national umpire registries, languages spoken, and current status. The passport_id has a unique index so a referee can never be duplicated across the global registry. National federations opt in via TenantConfig.fipjp_referee_publish_enabled; once enabled, an automated sync service pulls UmpireCertification records from the national tenant and reconciles them into the GlobalReferee certifications list.

FIPJP referee admin endpoints provide CRUD plus sync-certifications, promote, status change, and sync-from-nation (machine-to-machine). The public referee search exposes lookup by passport and a multi-filter search by discipline, level, language, and availability; contact information is deliberately omitted to preserve privacy. Federations searching for an external official can therefore identify candidates without scraping personal data.

The RefereeLoanArrangement model orchestrates cross-tenant lending. The arrangement progresses through REQUESTED, ACCEPTED (by the referee), APPROVED (by the source federation), ACTIVE (during the event), and COMPLETED. The borrower federation creates a request specifying the event, dates, and required grade; the referee receives the offer and accepts or declines; the source federation then reviews and approves, rejects, or asks for amendments. Conflict detection prevents double-booking by checking the referee's calendar across all known assignments in any tenant; an attempted overlap returns HTTP 409. Compensation terms (per-event fee, travel cost, per-diem) are recorded in the arrangement and form the financial reconciliation between federations after the event. A cancel transition is available before ACTIVE; complete fires after the event closes and writes the assignment back into the referee's GlobalReferee statistics. The full approval history is stored for audit, and the admin UI offers two dashboards (FIPJP referee management and loan arrangement tracking) for FIPJP and national administrators.