Sprint 2 : moteur de documents + sanctuaire

Backend:
- CRUD complet documents/items/versions (update, delete, accept, reject, reorder)
- Service IPFS (upload/retrieve/pin via kubo HTTP API)
- Service sanctuaire : pipeline SHA-256 + IPFS + on-chain (system.remark)
- Verification integrite des entrees sanctuaire
- Recherche par reference (document -> entrees sanctuaire)
- Serialisation deterministe des documents pour archivage
- 14 tests unitaires supplementaires (document service)

Frontend:
- 9 composants : StatusBadge, MarkdownRenderer, DiffView, ItemCard,
  ItemVersionDiff, DocumentList, SanctuaryEntry, IPFSLink, ChainAnchor
- Page detail item avec historique des versions et diff
- Page detail sanctuaire avec verification integrite
- Modal de creation de document + proposition de version
- Archivage document vers sanctuaire depuis la page detail

Documentation:
- API reference mise a jour (9 nouveaux endpoints)
- Guides utilisateur documents et sanctuaire enrichis

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

frontend/app/components/documents/DocumentList.vue

@@ -0,0 +1,88 @@
+<script setup lang="ts">
+import type { Document } from '~/stores/documents'
+
+const props = withDefaults(defineProps<{
+  documents: Document[]
+  loading?: boolean
+}>(), {
+  loading: false,
+})
+
+const typeLabel = (docType: string): string => {
+  switch (docType) {
+    case 'licence': return 'Licence'
+    case 'engagement': return 'Engagement'
+    case 'reglement': return 'Reglement'
+    case 'constitution': return 'Constitution'
+    default: return docType
+  }
+}
+
+function formatDate(dateStr: string): string {
+  return new Date(dateStr).toLocaleDateString('fr-FR', {
+    day: 'numeric',
+    month: 'short',
+    year: 'numeric',
+  })
+}
+</script>
+
+<template>
+  <!-- Loading state -->
+  <div v-if="loading" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+    <USkeleton v-for="i in 6" :key="i" class="h-48 w-full" />
+  </div>
+
+  <!-- Empty state -->
+  <UCard v-else-if="documents.length === 0">
+    <div class="text-center py-8">
+      <UIcon name="i-lucide-book-open" class="text-4xl text-gray-400 mb-3" />
+      <p class="text-gray-500">Aucun document de reference pour le moment</p>
+    </div>
+  </UCard>
+
+  <!-- Document grid -->
+  <div v-else class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+    <UCard
+      v-for="doc in documents"
+      :key="doc.id"
+      class="cursor-pointer hover:ring-2 hover:ring-primary/50 transition-all"
+      @click="navigateTo(`/documents/${doc.slug}`)"
+    >
+      <div class="space-y-3">
+        <!-- Header -->
+        <div class="flex items-start justify-between">
+          <h3 class="font-semibold text-gray-900 dark:text-white text-sm leading-tight">
+            {{ doc.title }}
+          </h3>
+          <CommonStatusBadge :status="doc.status" type="document" />
+        </div>
+
+        <!-- Type + Version -->
+        <div class="flex items-center gap-2">
+          <UBadge variant="subtle" color="primary" size="xs">
+            {{ typeLabel(doc.doc_type) }}
+          </UBadge>
+          <span class="text-xs text-gray-500 font-mono">v{{ doc.version }}</span>
+        </div>
+
+        <!-- Description -->
+        <p
+          v-if="doc.description"
+          class="text-xs text-gray-600 dark:text-gray-400 line-clamp-2"
+        >
+          {{ doc.description }}
+        </p>
+
+        <!-- Footer -->
+        <div class="flex items-center justify-between pt-2 border-t border-gray-100 dark:border-gray-800">
+          <div class="flex items-center gap-1 text-xs text-gray-500">
+            <UIcon name="i-lucide-list" class="text-sm" />
+            <span>{{ doc.items_count }} items</span>
+          </div>
+          <span class="text-xs text-gray-400">{{ formatDate(doc.updated_at) }}</span>
+        </div>
+      </div>
+    </UCard>
+  </div>
+</template>

frontend/app/components/documents/ItemCard.vue

@@ -0,0 +1,89 @@
+<script setup lang="ts">
+import type { DocumentItem } from '~/stores/documents'
+
+const props = withDefaults(defineProps<{
+  item: DocumentItem
+  documentSlug: string
+  showActions?: boolean
+}>(), {
+  showActions: false,
+})
+
+const emit = defineEmits<{
+  propose: [item: DocumentItem]
+}>()
+
+const itemTypeLabel = (itemType: string): string => {
+  switch (itemType) {
+    case 'clause': return 'Clause'
+    case 'rule': return 'Regle'
+    case 'verification': return 'Verification'
+    case 'preamble': return 'Preambule'
+    case 'section': return 'Section'
+    default: return itemType
+  }
+}
+
+function navigateToItem() {
+  navigateTo(`/documents/${props.documentSlug}/items/${props.item.id}`)
+}
+</script>
+
+<template>
+  <UCard
+    class="cursor-pointer hover:ring-2 hover:ring-primary/50 transition-all"
+    @click="navigateToItem"
+  >
+    <div class="space-y-3">
+      <!-- Item header -->
+      <div class="flex items-center justify-between">
+        <div class="flex items-center gap-3">
+          <UBadge variant="solid" color="primary" size="xs">
+            {{ item.position }}
+          </UBadge>
+          <span v-if="item.title" class="text-sm font-semibold text-gray-900 dark:text-white">
+            {{ item.title }}
+          </span>
+          <UBadge variant="subtle" color="neutral" size="xs">
+            {{ itemTypeLabel(item.item_type) }}
+          </UBadge>
+        </div>
+        <div class="flex items-center gap-2">
+          <UBadge
+            v-if="item.voting_protocol_id"
+            color="info"
+            variant="subtle"
+            size="xs"
+          >
+            Sous vote
+          </UBadge>
+          <UBadge
+            v-else
+            color="neutral"
+            variant="subtle"
+            size="xs"
+          >
+            Pas de vote
+          </UBadge>
+        </div>
+      </div>
+
+      <!-- Item text -->
+      <div class="pl-2">
+        <CommonMarkdownRenderer :content="item.current_text" />
+      </div>
+
+      <!-- Actions -->
+      <div v-if="showActions" class="flex justify-end pt-2 border-t border-gray-100 dark:border-gray-800">
+        <UButton
+          label="Proposer une modification"
+          icon="i-lucide-pen-line"
+          variant="soft"
+          color="primary"
+          size="xs"
+          @click.stop="emit('propose', item)"
+        />
+      </div>
+    </div>
+  </UCard>
+</template>

frontend/app/components/documents/ItemVersionDiff.vue

@@ -0,0 +1,95 @@
+<script setup lang="ts">
+import type { ItemVersion } from '~/stores/documents'
+
+const props = defineProps<{
+  version: ItemVersion
+}>()
+
+const emit = defineEmits<{
+  accept: [versionId: string]
+  reject: [versionId: string]
+}>()
+
+const auth = useAuthStore()
+
+function formatDate(dateStr: string): string {
+  return new Date(dateStr).toLocaleDateString('fr-FR', {
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+  })
+}
+
+function truncateAddress(address: string | null): string {
+  if (!address) return 'Inconnu'
+  if (address.length <= 16) return address
+  return address.slice(0, 8) + '...' + address.slice(-6)
+}
+</script>
+
+<template>
+  <UCard>
+    <div class="space-y-4">
+      <!-- Header -->
+      <div class="flex items-start justify-between">
+        <div class="flex items-center gap-3">
+          <CommonStatusBadge :status="version.status" type="version" />
+          <span class="text-sm text-gray-500">
+            Propose par
+            <span class="font-medium text-gray-700 dark:text-gray-300 font-mono text-xs">
+              {{ truncateAddress(version.proposed_by) }}
+            </span>
+          </span>
+        </div>
+        <span class="text-xs text-gray-400">
+          {{ formatDate(version.created_at) }}
+        </span>
+      </div>
+
+      <!-- Rationale -->
+      <div v-if="version.rationale" class="bg-gray-50 dark:bg-gray-800/50 rounded-lg p-3">
+        <p class="text-xs font-semibold text-gray-500 uppercase mb-1">Justification</p>
+        <p class="text-sm text-gray-700 dark:text-gray-300">{{ version.rationale }}</p>
+      </div>
+
+      <!-- Diff view -->
+      <div v-if="version.diff">
+        <p class="text-xs font-semibold text-gray-500 uppercase mb-2">Modifications</p>
+        <CommonDiffView :diff="version.diff" />
+      </div>
+
+      <!-- Proposed text (fallback if no diff) -->
+      <div v-else-if="version.proposed_text">
+        <p class="text-xs font-semibold text-gray-500 uppercase mb-2">Texte propose</p>
+        <div class="bg-green-50 dark:bg-green-900/10 border border-green-200 dark:border-green-800 rounded-lg p-3">
+          <CommonMarkdownRenderer :content="version.proposed_text" />
+        </div>
+      </div>
+
+      <!-- Actions for authenticated users -->
+      <div
+        v-if="auth.isAuthenticated && version.status === 'proposed'"
+        class="flex items-center gap-3 pt-2 border-t border-gray-100 dark:border-gray-800"
+      >
+        <UButton
+          label="Accepter"
+          icon="i-lucide-check"
+          color="success"
+          variant="soft"
+          size="xs"
+          @click="emit('accept', version.id)"
+        />
+        <UButton
+          label="Rejeter"
+          icon="i-lucide-x"
+          color="error"
+          variant="soft"
+          size="xs"
+          @click="emit('reject', version.id)"
+        />
+      </div>
+    </div>
+  </UCard>
+</template>