Aller au contenu principal
Petanque Life

Rules & Regulations

F01.04 7 fonctionnalités Planifié

En bref

Rules & Regulations is the federation's living rule book — a versioned repository of FIPJP statutes, national supplements, regional variations, official interpretations and case-law precedents — wrapped in a draft→proposed→approved→archived workflow, multilingual translation status tracking across 43 languages, BFS cross-reference graph search, a precedent-chained interpretation database and a notification fan-out that warns subscribed federations the moment a rule changes.

Comment ça fonctionne

Four core models drive the domain. RuleDocument represents a regulation (FIPJP playing rules, national supplement, regional bylaw); RuleVersion holds each immutable revision with a structured diff against its predecessor; RuleInterpretation classifies clarifications as faq, case_law or guidance and chains them through a precedent_of relationship so an interpretation can quote and extend earlier ones; RuleChangeSubscription expresses 'tenant X wants notified when rule Y or any rule in domain Z changes'. Every RuleDocument moves through a workflow draft → proposed → approved → archived.

While in proposed, the change goes through the normal commission process from F01.02 (motion → discussion → adoption decision); once approved the new RuleVersion becomes effective on its activation date. Translation status is tracked per language (43 supported), with explicit pending/in_review/published states so a multilingual federation can see which articles still need to be translated before activation. Search is multilingual and returns hits across the whole repository; cross-reference walking uses a BFS graph so an operator can trace 'show me every regulation that references FIPJP article 19' two or three hops out.

The interpretation database supports the same search and exposes a precedent chain view. When a RuleVersion is published, the change-event fan-out runs: it loads every RuleChangeSubscription that matches, writes a RuleChangeEvent (per-tenant, audit-grade), and emits a FEDERATION_CIRCULAR notification through the F01.05 correspondence channel. The whole surface is scoped per tenant — an SBF rule supplement is invisible to FFPJP unless a public sharing flag is explicitly set.

Capacités clés

  • Maintain a versioned rule repository with immutable revisions and machine-readable diffs.
  • Layer national, regional and club supplements over the FIPJP base rules.
  • Run rule changes through a typed proposal workflow integrated with commission decisions.
  • Track translation status per language and prevent activation when critical translations are missing.
  • Search rules and walk the cross-reference graph with BFS to find every related article.
  • Curate an interpretation database with FAQ, case-law and precedent chains.
  • Notify subscribed federations automatically when a rule changes via auditable change events.

En pratique

A FIPJP technical officer publishes a clarified version of article 19 (foot-fault tolerance) on a Monday morning. She opens the RuleDocument, drafts a new RuleVersion with the redlined text, attaches a RuleInterpretation tagged case_law that cites two earlier precedents, and moves the document from draft to proposed. The umpire commission convenes, votes, and the resulting Decision flips the version to approved.

The fan-out runs: 38 RuleChangeSubscription rows match (every national federation plus the two continental confederations), 38 RuleChangeEvent records are written, 38 FEDERATION_CIRCULAR notifications are queued. By Tuesday afternoon, the SBF translation officer sees the new version pending in Swedish, runs the BFS cross-reference to confirm no other Swedish supplement contradicts it, publishes the translation, and the version goes live for SBF on its activation date.

Fonctionnalités de ce sous-système

7
ID Status Fonctionnalités
F01.04.01 Livré Rule repository with versioning (FIPJP official rules) ✅ PL-F0104a
F01.04.02 Livré National/regional rule variations and supplements ✅ PL-F0104a
F01.04.03 Livré Rule change proposal workflow ✅ PL-F0104a
F01.04.04 Livré Rule translation management (multi-language) ✅ PL-F0104a
F01.04.05 Livré Rule search and cross-reference (incl. BFS graph walk) ✅ PL-F0104b
F01.04.06 Livré Rule interpretation database (FAQs, case law, precedent chain) ✅ PL-F0104b
F01.04.07 Livré Notification of rule changes to affected federations ✅ PL-F0104b