Sprint 3 : protocoles de vote et boite a outils

Backend:
- Sessions de vote : list, close, tally, threshold details, auto-expiration
- Protocoles : update, simulate, meta-gouvernance, formulas CRUD
- Service vote enrichi : close_session, get_threshold_details, nuanced breakdown
- Schemas : ThresholdDetailOut, VoteResultOut, FormulaSimulationRequest/Result
- WebSocket broadcast sur chaque vote + fermeture session
- 25 nouveaux tests (threshold details, close, nuanced, simulation)

Frontend:
- 5 composants vote : VoteBinary, VoteNuanced, ThresholdGauge, FormulaDisplay, VoteHistory
- 3 composants protocoles : ProtocolPicker, FormulaEditor, ModeParamsDisplay
- Simulateur de formules interactif (page /protocols/formulas)
- Page detail protocole (/protocols/[id])
- Composable useWebSocket (live updates)
- Composable useVoteFormula (calcul client-side reactif)
- Integration KaTeX pour rendu LaTeX des formules

Documentation:
- API reference : 8 nouveaux endpoints documentes
- Formules : tables d'inertie, parametres detailles, simulation API
- Guide vote : vote binaire/nuance, jauge, historique, simulateur, meta-gouvernance

55 tests passes (+ 1 skipped), 126 fichiers total.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

backend/app/schemas/protocol.py

@@ -33,6 +33,25 @@ class FormulaConfigCreate(BaseModel):
     nuanced_threshold_pct: int | None = Field(default=None, ge=0, le=100, description="Threshold percentage for nuanced vote")
 
 
+class FormulaConfigUpdate(BaseModel):
+    """Partial update payload for a formula configuration (all fields optional)."""
+
+    name: str | None = Field(default=None, min_length=1, max_length=128)
+    description: str | None = None
+
+    duration_days: int | None = Field(default=None, ge=1)
+    majority_pct: int | None = Field(default=None, ge=1, le=100)
+    base_exponent: float | None = Field(default=None, ge=0.0, le=1.0)
+    gradient_exponent: float | None = Field(default=None, ge=0.0, le=2.0)
+    constant_base: float | None = Field(default=None, ge=0.0, le=1.0)
+
+    smith_exponent: float | None = Field(default=None, ge=0.0, le=1.0)
+    techcomm_exponent: float | None = Field(default=None, ge=0.0, le=1.0)
+
+    nuanced_min_participants: int | None = Field(default=None, ge=0)
+    nuanced_threshold_pct: int | None = Field(default=None, ge=0, le=100)
+
+
 class FormulaConfigOut(BaseModel):
     """Full formula configuration representation."""
 
@@ -67,6 +86,16 @@ class VotingProtocolCreate(BaseModel):
     is_meta_governed: bool = Field(default=False, description="Whether this protocol is itself governed by meta-vote")
 
 
+class VotingProtocolUpdate(BaseModel):
+    """Partial update payload for a voting protocol (meta-governance)."""
+
+    name: str | None = Field(default=None, min_length=1, max_length=128)
+    description: str | None = None
+    vote_type: str | None = Field(default=None, max_length=32)
+    mode_params: str | None = Field(default=None, max_length=64)
+    is_meta_governed: bool | None = None
+
+
 class VotingProtocolOut(BaseModel):
     """Full voting protocol representation including formula config."""
 
@@ -81,3 +110,32 @@ class VotingProtocolOut(BaseModel):
     is_meta_governed: bool
     created_at: datetime
     formula_config: FormulaConfigOut
+
+
+# ── Formula Simulation ───────────────────────────────────────────
+
+
+class FormulaSimulationRequest(BaseModel):
+    """Request payload for simulating a WoT threshold formula computation."""
+
+    wot_size: int = Field(..., ge=1, description="Size of the WoT (eligible voter corpus)")
+    total_votes: int = Field(..., ge=0, description="Number of votes cast (for + against)")
+    majority_pct: int = Field(default=50, ge=1, le=100, description="Majority percentage M")
+    base_exponent: float = Field(default=0.1, ge=0.0, le=1.0, description="Base exponent B")
+    gradient_exponent: float = Field(default=0.2, ge=0.0, le=2.0, description="Gradient exponent G")
+    constant_base: float = Field(default=0.0, ge=0.0, le=1.0, description="Constant base C")
+    smith_wot_size: int | None = Field(default=None, ge=1, description="Smith sub-WoT size")
+    smith_exponent: float | None = Field(default=None, ge=0.0, le=1.0, description="Smith exponent S")
+    techcomm_size: int | None = Field(default=None, ge=1, description="TechComm size")
+    techcomm_exponent: float | None = Field(default=None, ge=0.0, le=1.0, description="TechComm exponent T")
+
+
+class FormulaSimulationResult(BaseModel):
+    """Result of a formula simulation."""
+
+    wot_threshold: int
+    smith_threshold: int | None = None
+    techcomm_threshold: int | None = None
+    participation_rate: float
+    required_ratio: float
+    inertia_factor: float

backend/app/schemas/vote.py

@@ -55,6 +55,74 @@ class VoteSessionOut(BaseModel):
     created_at: datetime
 
 
+class VoteSessionListOut(BaseModel):
+    """Lighter vote session representation for list endpoints (no nested votes)."""
+
+    model_config = ConfigDict(from_attributes=True)
+
+    id: UUID
+    decision_id: UUID | None = None
+    item_version_id: UUID | None = None
+    voting_protocol_id: UUID
+
+    # Snapshot at session start
+    wot_size: int
+    smith_size: int
+    techcomm_size: int
+
+    # Dates
+    starts_at: datetime
+    ends_at: datetime
+
+    # Status
+    status: str
+
+    # Tallies
+    votes_for: int
+    votes_against: int
+    votes_total: int
+    threshold_required: float
+    result: str | None = None
+
+    created_at: datetime
+
+
+# ── Threshold Details ────────────────────────────────────────────
+
+
+class ThresholdDetailOut(BaseModel):
+    """Detailed threshold computation result for a vote session."""
+
+    wot_threshold: int
+    smith_threshold: int | None = None
+    techcomm_threshold: int | None = None
+    votes_for: int
+    votes_against: int
+    votes_total: int
+    wot_passed: bool
+    smith_passed: bool | None = None
+    techcomm_passed: bool | None = None
+    overall_passed: bool
+    participation_rate: float
+    formula_params: dict
+
+
+# ── Vote Result ──────────────────────────────────────────────────
+
+
+class VoteResultOut(BaseModel):
+    """Structured vote result response."""
+
+    session_id: UUID
+    result: str | None = None  # adopted, rejected
+    threshold_required: float
+    votes_for: int
+    votes_against: int
+    votes_total: int
+    adopted: bool
+    nuanced_breakdown: dict | None = None  # for nuanced votes
+
+
 # ── Vote ─────────────────────────────────────────────────────────