Federation Affiliation

Affiliation is the legal layer that sits above club membership and licensing — a club must be affiliated with the federation to issue licenses, and a federation must be affiliated with FIPJP/CEP to participate in international competition. The AffiliationApplication model drives the workflow through draft → submitted → under_review → approved/rejected, with parent-org validation that ensures the applicant attaches to the correct OrgNode in the tenant's hierarchy. When a club application is approved, the system auto-creates the Club entity and links it to the parent OrgNode; document uploads (statutes, insurance proof, board composition, etc.) are required as part of the application package and stored alongside the affiliation record.

Annual affiliation renewal runs as a federation-driven cycle, typically tied to the same season as licensing. The affiliation fee is calculated based on member count using the federation's configured pricing model (flat, per-member, or tiered) — most federations bill clubs once a year using a snapshot of active members at a configured cut-off date. Status management uses dedicated suspend, reinstate, and terminate endpoints that enforce valid status transitions (returning HTTP 409 on invalid transitions) and write structured audit log entries for every change, so suspended clubs cannot issue licenses or enter competitions until reinstated.

Member-count reporting flows upward through the OrgNode tree. The MemberCountReport model aggregates active members and licensed members at club, district, and federation levels; persisted snapshots are generated on a configurable cadence and exposed for FIPJP and CEP annual reporting. This gives FIPJP a consistent dataset for global statistics without ad-hoc data pulls, and gives national federations the documentation they need for grant applications and government reporting. The combination of affiliation status, document management, and member-count reporting forms the formal compliance backbone that all higher-level operations (competitions, transfers, ITC) rely on.