Sprint 4 : decisions et mandats -- workflow complet + vote integration

Backend: 7 nouveaux endpoints (advance, assign, revoke, create-vote-session),
services enrichis avec creation de sessions de vote, assignation de mandataire
et revocation. 35 nouveaux tests (104 total). Frontend: store mandates, page
cadrage decisions, detail mandats, composants DecisionWorkflow, DecisionCadrage,
DecisionCard, MandateTimeline, MandateCard. Documentation mise a jour.

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

frontend/app/pages/decisions/[id].vue

@@ -1,4 +1,6 @@
 <script setup lang="ts">
+import type { DecisionStep, DecisionStepCreate } from '~/stores/decisions'
+
 const route = useRoute()
 const decisions = useDecisionsStore()
 
@@ -18,26 +20,36 @@ watch(decisionId, async (newId) => {
   }
 })
 
+// --- Status helpers ---
+
 const statusColor = (status: string) => {
   switch (status) {
-    case 'active':
-    case 'in_progress': return 'success'
     case 'draft': return 'warning'
-    case 'completed': return 'info'
+    case 'qualification': return 'info'
+    case 'review': return 'info'
+    case 'voting': return 'primary'
+    case 'executed': return 'success'
     case 'closed': return 'neutral'
     case 'pending': return 'warning'
+    case 'active': return 'success'
+    case 'in_progress': return 'success'
+    case 'completed': return 'info'
     default: return 'neutral'
   }
 }
 
 const statusLabel = (status: string) => {
   switch (status) {
+    case 'draft': return 'Brouillon'
+    case 'qualification': return 'Qualification'
+    case 'review': return 'Revue'
+    case 'voting': return 'En vote'
+    case 'executed': return 'Execute'
+    case 'closed': return 'Clos'
+    case 'pending': return 'En attente'
     case 'active': return 'Actif'
     case 'in_progress': return 'En cours'
-    case 'draft': return 'Brouillon'
     case 'completed': return 'Termine'
-    case 'closed': return 'Ferme'
-    case 'pending': return 'En attente'
     default: return status
   }
 }
@@ -47,33 +59,12 @@ const typeLabel = (decisionType: string) => {
     case 'runtime_upgrade': return 'Runtime upgrade'
     case 'document_change': return 'Modification de document'
     case 'mandate_vote': return 'Vote de mandat'
-    case 'custom': return 'Personnalise'
+    case 'parameter_change': return 'Changement de parametre'
+    case 'other': return 'Autre'
     default: return decisionType
   }
 }
 
-const stepTypeLabel = (stepType: string) => {
-  switch (stepType) {
-    case 'qualification': return 'Qualification'
-    case 'review': return 'Revue'
-    case 'vote': return 'Vote'
-    case 'execution': return 'Execution'
-    case 'reporting': return 'Compte rendu'
-    default: return stepType
-  }
-}
-
-const stepTypeIcon = (stepType: string) => {
-  switch (stepType) {
-    case 'qualification': return 'i-lucide-check-square'
-    case 'review': return 'i-lucide-eye'
-    case 'vote': return 'i-lucide-vote'
-    case 'execution': return 'i-lucide-play'
-    case 'reporting': return 'i-lucide-file-text'
-    default: return 'i-lucide-circle'
-  }
-}
-
 function formatDate(dateStr: string): string {
   return new Date(dateStr).toLocaleDateString('fr-FR', {
     day: 'numeric',
@@ -82,10 +73,121 @@ function formatDate(dateStr: string): string {
   })
 }
 
-const sortedSteps = computed(() => {
-  if (!decisions.current) return []
-  return [...decisions.current.steps].sort((a, b) => a.step_order - b.step_order)
+// --- Terminal state check ---
+
+const terminalStatuses = ['executed', 'closed']
+const isTerminal = computed(() => {
+  if (!decisions.current) return true
+  return terminalStatuses.includes(decisions.current.status)
 })
+
+const isDraft = computed(() => decisions.current?.status === 'draft')
+
+// --- Advance action ---
+
+const advancing = ref(false)
+
+async function handleAdvance() {
+  advancing.value = true
+  try {
+    await decisions.advance(decisionId.value)
+  } catch {
+    // Error handled by store
+  } finally {
+    advancing.value = false
+  }
+}
+
+// --- Create vote session ---
+
+async function handleCreateVoteSession(step: DecisionStep) {
+  try {
+    await decisions.createVoteSession(decisionId.value, step.id)
+  } catch {
+    // Error handled by store
+  }
+}
+
+// --- Edit modal ---
+
+const showEditModal = ref(false)
+const editData = ref({
+  title: '',
+  description: '' as string | null,
+  context: '' as string | null,
+})
+const saving = ref(false)
+
+function openEdit() {
+  if (!decisions.current) return
+  editData.value = {
+    title: decisions.current.title,
+    description: decisions.current.description,
+    context: decisions.current.context,
+  }
+  showEditModal.value = true
+}
+
+async function saveEdit() {
+  saving.value = true
+  try {
+    await decisions.update(decisionId.value, editData.value)
+    showEditModal.value = false
+  } catch {
+    // Error handled by store
+  } finally {
+    saving.value = false
+  }
+}
+
+// --- Delete ---
+
+const showDeleteConfirm = ref(false)
+const deleting = ref(false)
+
+async function handleDelete() {
+  deleting.value = true
+  try {
+    await decisions.delete(decisionId.value)
+    navigateTo('/decisions')
+  } catch {
+    // Error handled by store
+  } finally {
+    deleting.value = false
+    showDeleteConfirm.value = false
+  }
+}
+
+// --- Add step ---
+
+const showAddStep = ref(false)
+const newStep = ref<DecisionStepCreate>({
+  step_type: 'qualification',
+  title: '',
+  description: '',
+})
+const addingStep = ref(false)
+
+const stepTypeOptions = [
+  { label: 'Qualification', value: 'qualification' },
+  { label: 'Revue', value: 'review' },
+  { label: 'Vote', value: 'vote' },
+  { label: 'Execution', value: 'execution' },
+  { label: 'Compte rendu', value: 'reporting' },
+]
+
+async function handleAddStep() {
+  addingStep.value = true
+  try {
+    await decisions.addStep(decisionId.value, newStep.value)
+    showAddStep.value = false
+    newStep.value = { step_type: 'qualification', title: '', description: '' }
+  } catch {
+    // Error handled by store
+  } finally {
+    addingStep.value = false
+  }
+}
 </script>
 
 <template>
@@ -125,18 +227,51 @@ const sortedSteps = computed(() => {
 
     <!-- Decision detail -->
     <template v-else-if="decisions.current">
-      <!-- Header -->
-      <div>
-        <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
-          {{ decisions.current.title }}
-        </h1>
-        <div class="flex items-center gap-3 mt-2">
-          <UBadge variant="subtle" color="primary">
-            {{ typeLabel(decisions.current.decision_type) }}
-          </UBadge>
-          <UBadge :color="statusColor(decisions.current.status)" variant="subtle">
-            {{ statusLabel(decisions.current.status) }}
-          </UBadge>
+      <!-- Header with actions -->
+      <div class="flex items-start justify-between">
+        <div>
+          <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
+            {{ decisions.current.title }}
+          </h1>
+          <div class="flex items-center gap-3 mt-2">
+            <UBadge variant="subtle" color="primary">
+              {{ typeLabel(decisions.current.decision_type) }}
+            </UBadge>
+            <UBadge :color="statusColor(decisions.current.status)" variant="subtle">
+              {{ statusLabel(decisions.current.status) }}
+            </UBadge>
+          </div>
+        </div>
+
+        <!-- Action buttons -->
+        <div class="flex items-center gap-2">
+          <UButton
+            v-if="!isTerminal"
+            icon="i-lucide-fast-forward"
+            label="Avancer la decision"
+            color="primary"
+            variant="soft"
+            size="sm"
+            :loading="advancing"
+            @click="handleAdvance"
+          />
+          <UButton
+            icon="i-lucide-pen-line"
+            label="Modifier"
+            variant="soft"
+            color="neutral"
+            size="sm"
+            @click="openEdit"
+          />
+          <UButton
+            v-if="isDraft"
+            icon="i-lucide-trash-2"
+            label="Supprimer"
+            variant="soft"
+            color="error"
+            size="sm"
+            @click="showDeleteConfirm = true"
+          />
         </div>
       </div>
 
@@ -184,88 +319,146 @@ const sortedSteps = computed(() => {
 
       <!-- Steps timeline -->
       <div>
-        <h2 class="text-lg font-semibold text-gray-900 dark:text-white mb-4">
-          Etapes du processus
-        </h2>
-
-        <div v-if="sortedSteps.length === 0" class="text-center py-8">
-          <UIcon name="i-lucide-list-checks" class="text-4xl text-gray-400 mb-3" />
-          <p class="text-gray-500">Aucune etape definie pour cette decision</p>
+        <div class="flex items-center justify-between mb-4">
+          <h2 class="text-lg font-semibold text-gray-900 dark:text-white">
+            Etapes du processus
+          </h2>
+          <UButton
+            v-if="!isTerminal"
+            icon="i-lucide-plus"
+            label="Ajouter une etape"
+            variant="soft"
+            color="primary"
+            size="sm"
+            @click="showAddStep = true"
+          />
         </div>
 
-        <div v-else class="relative">
-          <!-- Timeline line -->
-          <div class="absolute left-4 top-0 bottom-0 w-0.5 bg-gray-200 dark:bg-gray-700" />
-
-          <!-- Steps -->
-          <div class="space-y-4">
-            <div
-              v-for="(step, index) in sortedSteps"
-              :key="step.id"
-              class="relative pl-12"
-            >
-              <!-- Timeline dot -->
-              <div
-                class="absolute left-2 w-5 h-5 rounded-full border-2 flex items-center justify-center"
-                :class="{
-                  'bg-green-500 border-green-500': step.status === 'completed',
-                  'bg-primary border-primary': step.status === 'active' || step.status === 'in_progress',
-                  'bg-yellow-400 border-yellow-400': step.status === 'pending',
-                  'bg-white dark:bg-gray-900 border-gray-300 dark:border-gray-600': step.status === 'draft',
-                }"
-              >
-                <UIcon
-                  v-if="step.status === 'completed'"
-                  name="i-lucide-check"
-                  class="text-white text-xs"
-                />
-              </div>
-
-              <UCard>
-                <div class="space-y-2">
-                  <div class="flex items-center justify-between">
-                    <div class="flex items-center gap-2">
-                      <UIcon :name="stepTypeIcon(step.step_type)" class="text-gray-500" />
-                      <span class="text-sm font-mono text-gray-400">Etape {{ step.step_order }}</span>
-                      <UBadge variant="subtle" color="neutral" size="xs">
-                        {{ stepTypeLabel(step.step_type) }}
-                      </UBadge>
-                    </div>
-                    <UBadge :color="statusColor(step.status)" variant="subtle" size="xs">
-                      {{ statusLabel(step.status) }}
-                    </UBadge>
-                  </div>
-
-                  <h3 v-if="step.title" class="font-medium text-gray-900 dark:text-white">
-                    {{ step.title }}
-                  </h3>
-
-                  <p v-if="step.description" class="text-sm text-gray-600 dark:text-gray-400">
-                    {{ step.description }}
-                  </p>
-
-                  <div v-if="step.outcome" class="flex items-center gap-2 mt-2">
-                    <UIcon name="i-lucide-flag" class="text-gray-400" />
-                    <span class="text-sm text-gray-600 dark:text-gray-400">
-                      Resultat : {{ step.outcome }}
-                    </span>
-                  </div>
-
-                  <div v-if="step.vote_session_id" class="mt-2">
-                    <UButton
-                      size="xs"
-                      variant="soft"
-                      color="primary"
-                      icon="i-lucide-vote"
-                      label="Voir la session de vote"
-                    />
-                  </div>
-                </div>
-              </UCard>
-            </div>
-          </div>
-        </div>
+        <DecisionsDecisionWorkflow
+          :steps="decisions.current.steps"
+          :current-status="decisions.current.status"
+          @create-vote-session="handleCreateVoteSession"
+        />
       </div>
     </template>
+
+    <!-- Edit modal -->
+    <UModal v-model:open="showEditModal">
+      <template #content>
+        <div class="p-6 space-y-4">
+          <h3 class="text-lg font-semibold text-gray-900 dark:text-white">
+            Modifier la decision
+          </h3>
+
+          <div class="space-y-1">
+            <label class="block text-sm font-medium text-gray-700 dark:text-gray-300">Titre</label>
+            <UInput v-model="editData.title" />
+          </div>
+
+          <div class="space-y-1">
+            <label class="block text-sm font-medium text-gray-700 dark:text-gray-300">Description</label>
+            <UTextarea v-model="editData.description" :rows="4" />
+          </div>
+
+          <div class="space-y-1">
+            <label class="block text-sm font-medium text-gray-700 dark:text-gray-300">Contexte</label>
+            <UTextarea v-model="editData.context" :rows="3" />
+          </div>
+
+          <div class="flex justify-end gap-2 pt-4 border-t border-gray-200 dark:border-gray-700">
+            <UButton
+              label="Annuler"
+              variant="ghost"
+              color="neutral"
+              @click="showEditModal = false"
+            />
+            <UButton
+              label="Enregistrer"
+              icon="i-lucide-save"
+              color="primary"
+              :loading="saving"
+              :disabled="!editData.title?.trim()"
+              @click="saveEdit"
+            />
+          </div>
+        </div>
+      </template>
+    </UModal>
+
+    <!-- Delete confirmation modal -->
+    <UModal v-model:open="showDeleteConfirm">
+      <template #content>
+        <div class="p-6 space-y-4">
+          <h3 class="text-lg font-semibold text-red-600">
+            Confirmer la suppression
+          </h3>
+          <p class="text-sm text-gray-600 dark:text-gray-400">
+            Etes-vous sur de vouloir supprimer cette decision ? Cette action est irreversible.
+          </p>
+          <div class="flex justify-end gap-2 pt-4 border-t border-gray-200 dark:border-gray-700">
+            <UButton
+              label="Annuler"
+              variant="ghost"
+              color="neutral"
+              @click="showDeleteConfirm = false"
+            />
+            <UButton
+              label="Supprimer"
+              icon="i-lucide-trash-2"
+              color="error"
+              :loading="deleting"
+              @click="handleDelete"
+            />
+          </div>
+        </div>
+      </template>
+    </UModal>
+
+    <!-- Add step modal -->
+    <UModal v-model:open="showAddStep">
+      <template #content>
+        <div class="p-6 space-y-4">
+          <h3 class="text-lg font-semibold text-gray-900 dark:text-white">
+            Ajouter une etape
+          </h3>
+
+          <div class="space-y-1">
+            <label class="block text-sm font-medium text-gray-700 dark:text-gray-300">
+              Type d'etape <span class="text-red-500">*</span>
+            </label>
+            <USelect
+              v-model="newStep.step_type"
+              :items="stepTypeOptions"
+            />
+          </div>
+
+          <div class="space-y-1">
+            <label class="block text-sm font-medium text-gray-700 dark:text-gray-300">Titre</label>
+            <UInput v-model="newStep.title" placeholder="Titre de l'etape..." />
+          </div>
+
+          <div class="space-y-1">
+            <label class="block text-sm font-medium text-gray-700 dark:text-gray-300">Description</label>
+            <UTextarea v-model="newStep.description" :rows="3" placeholder="Description de l'etape..." />
+          </div>
+
+          <div class="flex justify-end gap-2 pt-4 border-t border-gray-200 dark:border-gray-700">
+            <UButton
+              label="Annuler"
+              variant="ghost"
+              color="neutral"
+              @click="showAddStep = false"
+            />
+            <UButton
+              label="Ajouter"
+              icon="i-lucide-plus"
+              color="primary"
+              :loading="addingStep"
+              @click="handleAddStep"
+            />
+          </div>
+        </div>
+      </template>
+    </UModal>
   </div>
 </template>

frontend/app/pages/decisions/index.vue

@@ -9,16 +9,18 @@ const typeOptions = [
   { label: 'Runtime upgrade', value: 'runtime_upgrade' },
   { label: 'Modification de document', value: 'document_change' },
   { label: 'Vote de mandat', value: 'mandate_vote' },
-  { label: 'Personnalise', value: 'custom' },
+  { label: 'Changement de parametre', value: 'parameter_change' },
+  { label: 'Autre', value: 'other' },
 ]
 
 const statusOptions = [
   { label: 'Tous les statuts', value: undefined },
   { label: 'Brouillon', value: 'draft' },
-  { label: 'En cours', value: 'in_progress' },
-  { label: 'Actif', value: 'active' },
-  { label: 'Termine', value: 'completed' },
-  { label: 'Ferme', value: 'closed' },
+  { label: 'Qualification', value: 'qualification' },
+  { label: 'Revue', value: 'review' },
+  { label: 'En vote', value: 'voting' },
+  { label: 'Execute', value: 'executed' },
+  { label: 'Clos', value: 'closed' },
 ]
 
 async function loadDecisions() {
@@ -38,10 +40,11 @@ watch([filterType, filterStatus], () => {
 
 const statusColor = (status: string) => {
   switch (status) {
-    case 'active':
-    case 'in_progress': return 'success'
     case 'draft': return 'warning'
-    case 'completed': return 'info'
+    case 'qualification': return 'info'
+    case 'review': return 'info'
+    case 'voting': return 'primary'
+    case 'executed': return 'success'
     case 'closed': return 'neutral'
     default: return 'neutral'
   }
@@ -49,11 +52,12 @@ const statusColor = (status: string) => {
 
 const statusLabel = (status: string) => {
   switch (status) {
-    case 'active': return 'Actif'
-    case 'in_progress': return 'En cours'
     case 'draft': return 'Brouillon'
-    case 'completed': return 'Termine'
-    case 'closed': return 'Ferme'
+    case 'qualification': return 'Qualification'
+    case 'review': return 'Revue'
+    case 'voting': return 'En vote'
+    case 'executed': return 'Execute'
+    case 'closed': return 'Clos'
     default: return status
   }
 }
@@ -63,7 +67,8 @@ const typeLabel = (decisionType: string) => {
     case 'runtime_upgrade': return 'Runtime upgrade'
     case 'document_change': return 'Modif. document'
     case 'mandate_vote': return 'Vote de mandat'
-    case 'custom': return 'Personnalise'
+    case 'parameter_change': return 'Param. change'
+    case 'other': return 'Autre'
     default: return decisionType
   }
 }
@@ -80,13 +85,21 @@ function formatDate(dateStr: string): string {
 <template>
   <div class="space-y-6">
     <!-- Header -->
-    <div>
-      <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
-        Decisions
-      </h1>
-      <p class="mt-1 text-sm text-gray-600 dark:text-gray-400">
-        Processus de decision collectifs de la communaute
-      </p>
+    <div class="flex items-start justify-between">
+      <div>
+        <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
+          Decisions
+        </h1>
+        <p class="mt-1 text-sm text-gray-600 dark:text-gray-400">
+          Processus de decision collectifs de la communaute
+        </p>
+      </div>
+      <UButton
+        to="/decisions/new"
+        icon="i-lucide-plus"
+        label="Nouvelle decision"
+        color="primary"
+      />
     </div>
 
     <!-- Filters -->

frontend/app/pages/decisions/new.vue

@@ -0,0 +1,72 @@
+<script setup lang="ts">
+import type { DecisionCreate } from '~/stores/decisions'
+
+const decisions = useDecisionsStore()
+
+const formData = ref<DecisionCreate>({
+  title: '',
+  description: '',
+  context: '',
+  decision_type: 'other',
+  voting_protocol_id: null,
+})
+
+const submitting = ref(false)
+
+async function onSubmit() {
+  submitting.value = true
+  try {
+    const decision = await decisions.create(formData.value)
+    if (decision) {
+      navigateTo(`/decisions/${decision.id}`)
+    }
+  } catch {
+    // Error is handled by the store
+  } finally {
+    submitting.value = false
+  }
+}
+</script>
+
+<template>
+  <div class="space-y-6">
+    <!-- Back link -->
+    <div>
+      <UButton
+        to="/decisions"
+        variant="ghost"
+        color="neutral"
+        icon="i-lucide-arrow-left"
+        label="Retour aux decisions"
+        size="sm"
+      />
+    </div>
+
+    <!-- Header -->
+    <div>
+      <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
+        Nouvelle decision
+      </h1>
+      <p class="mt-1 text-sm text-gray-600 dark:text-gray-400">
+        Cadrage d'un nouveau processus de decision collectif
+      </p>
+    </div>
+
+    <!-- Error -->
+    <UCard v-if="decisions.error">
+      <div class="flex items-center gap-3 text-red-500">
+        <UIcon name="i-lucide-alert-circle" class="text-xl" />
+        <p>{{ decisions.error }}</p>
+      </div>
+    </UCard>
+
+    <!-- Form -->
+    <UCard>
+      <DecisionsDecisionCadrage
+        v-model="formData"
+        :submitting="submitting"
+        @submit="onSubmit"
+      />
+    </UCard>
+  </div>
+</template>