Sprint 1 : scaffolding complet de Glibredecision

Plateforme de decisions collectives pour Duniter/G1.
Backend FastAPI async + PostgreSQL (14 tables, 8 routers, 6 services,
moteur de vote avec formule d'inertie WoT/Smith/TechComm).
Frontend Nuxt 4 + Nuxt UI v3 + Pinia (9 pages, 5 stores).
Infrastructure Docker + Woodpecker CI + Traefik.
Documentation technique et utilisateur (15 fichiers).
Seed : Licence G1, Engagement Forgeron v2.0.0, 4 protocoles de vote.
30 tests unitaires (formules, mode params, vote nuance) -- tous verts.

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

frontend/app/pages/documents/[slug].vue

@@ -0,0 +1,230 @@
+<script setup lang="ts">
+const route = useRoute()
+const documents = useDocumentsStore()
+
+const slug = computed(() => route.params.slug as string)
+
+onMounted(async () => {
+  await documents.fetchBySlug(slug.value)
+})
+
+onUnmounted(() => {
+  documents.clearCurrent()
+})
+
+watch(slug, async (newSlug) => {
+  if (newSlug) {
+    await documents.fetchBySlug(newSlug)
+  }
+})
+
+const statusColor = (status: string) => {
+  switch (status) {
+    case 'active': return 'success'
+    case 'draft': return 'warning'
+    case 'archived': return 'neutral'
+    default: return 'neutral'
+  }
+}
+
+const statusLabel = (status: string) => {
+  switch (status) {
+    case 'active': return 'Actif'
+    case 'draft': return 'Brouillon'
+    case 'archived': return 'Archive'
+    default: return status
+  }
+}
+
+const typeLabel = (docType: string) => {
+  switch (docType) {
+    case 'licence': return 'Licence'
+    case 'engagement': return 'Engagement'
+    case 'reglement': return 'Reglement'
+    case 'constitution': return 'Constitution'
+    default: return docType
+  }
+}
+
+const itemTypeLabel = (itemType: 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 formatDate(dateStr: string): string {
+  return new Date(dateStr).toLocaleDateString('fr-FR', {
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric',
+  })
+}
+</script>
+
+<template>
+  <div class="space-y-6">
+    <!-- Back link -->
+    <div>
+      <UButton
+        to="/documents"
+        variant="ghost"
+        color="neutral"
+        icon="i-lucide-arrow-left"
+        label="Retour aux documents"
+        size="sm"
+      />
+    </div>
+
+    <!-- Loading state -->
+    <template v-if="documents.loading">
+      <div class="space-y-4">
+        <USkeleton class="h-8 w-96" />
+        <USkeleton class="h-4 w-64" />
+        <div class="space-y-3 mt-8">
+          <USkeleton v-for="i in 5" :key="i" class="h-24 w-full" />
+        </div>
+      </div>
+    </template>
+
+    <!-- Error state -->
+    <template v-else-if="documents.error">
+      <UCard>
+        <div class="flex items-center gap-3 text-red-500">
+          <UIcon name="i-lucide-alert-circle" class="text-xl" />
+          <p>{{ documents.error }}</p>
+        </div>
+      </UCard>
+    </template>
+
+    <!-- Document detail -->
+    <template v-else-if="documents.current">
+      <!-- Header -->
+      <div>
+        <div class="flex items-start justify-between">
+          <div>
+            <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
+              {{ documents.current.title }}
+            </h1>
+            <div class="flex items-center gap-3 mt-2">
+              <UBadge variant="subtle" color="primary">
+                {{ typeLabel(documents.current.doc_type) }}
+              </UBadge>
+              <UBadge :color="statusColor(documents.current.status)" variant="subtle">
+                {{ statusLabel(documents.current.status) }}
+              </UBadge>
+              <span class="text-sm text-gray-500 font-mono">
+                v{{ documents.current.version }}
+              </span>
+            </div>
+          </div>
+        </div>
+
+        <!-- Description -->
+        <p v-if="documents.current.description" class="mt-4 text-gray-600 dark:text-gray-400">
+          {{ documents.current.description }}
+        </p>
+      </div>
+
+      <!-- Metadata -->
+      <UCard>
+        <div class="grid grid-cols-2 md:grid-cols-4 gap-4 text-sm">
+          <div>
+            <p class="text-gray-500">Cree le</p>
+            <p class="font-medium text-gray-900 dark:text-white">
+              {{ formatDate(documents.current.created_at) }}
+            </p>
+          </div>
+          <div>
+            <p class="text-gray-500">Mis a jour le</p>
+            <p class="font-medium text-gray-900 dark:text-white">
+              {{ formatDate(documents.current.updated_at) }}
+            </p>
+          </div>
+          <div>
+            <p class="text-gray-500">Nombre d'items</p>
+            <p class="font-medium text-gray-900 dark:text-white">
+              {{ documents.current.items_count }}
+            </p>
+          </div>
+          <div>
+            <p class="text-gray-500">Ancrage IPFS</p>
+            <p class="font-medium text-gray-900 dark:text-white">
+              <template v-if="documents.current.ipfs_cid">
+                <span class="font-mono text-xs">{{ documents.current.ipfs_cid.slice(0, 16) }}...</span>
+              </template>
+              <template v-else>
+                <span class="text-gray-400">Non ancre</span>
+              </template>
+            </p>
+          </div>
+        </div>
+      </UCard>
+
+      <!-- Document items -->
+      <div>
+        <h2 class="text-lg font-semibold text-gray-900 dark:text-white mb-4">
+          Contenu du document ({{ documents.items.length }} items)
+        </h2>
+
+        <div v-if="documents.items.length === 0" class="text-center py-8">
+          <UIcon name="i-lucide-file-plus" class="text-4xl text-gray-400 mb-3" />
+          <p class="text-gray-500">Aucun item dans ce document</p>
+        </div>
+
+        <div v-else class="space-y-4">
+          <UCard
+            v-for="item in documents.items"
+            :key="item.id"
+          >
+            <div class="space-y-3">
+              <!-- Item header -->
+              <div class="flex items-center justify-between">
+                <div class="flex items-center gap-3">
+                  <span class="text-sm font-mono font-bold text-primary">
+                    {{ item.position }}
+                  </span>
+                  <UBadge variant="subtle" color="neutral" size="xs">
+                    {{ itemTypeLabel(item.item_type) }}
+                  </UBadge>
+                  <span v-if="item.title" class="text-sm font-semibold text-gray-900 dark:text-white">
+                    {{ item.title }}
+                  </span>
+                </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-8">
+                <p class="text-sm text-gray-700 dark:text-gray-300 whitespace-pre-wrap leading-relaxed">
+                  {{ item.current_text }}
+                </p>
+              </div>
+            </div>
+          </UCard>
+        </div>
+      </div>
+    </template>
+  </div>
+</template>

frontend/app/pages/documents/index.vue

@@ -0,0 +1,191 @@
+<script setup lang="ts">
+const documents = useDocumentsStore()
+
+const filterType = ref<string | undefined>(undefined)
+const filterStatus = ref<string | undefined>(undefined)
+
+const docTypeOptions = [
+  { label: 'Tous les types', value: undefined },
+  { label: 'Licence', value: 'licence' },
+  { label: 'Engagement', value: 'engagement' },
+  { label: 'Reglement', value: 'reglement' },
+  { label: 'Constitution', value: 'constitution' },
+]
+
+const statusOptions = [
+  { label: 'Tous les statuts', value: undefined },
+  { label: 'Brouillon', value: 'draft' },
+  { label: 'Actif', value: 'active' },
+  { label: 'Archive', value: 'archived' },
+]
+
+const columns = [
+  { key: 'title', label: 'Titre' },
+  { key: 'doc_type', label: 'Type' },
+  { key: 'version', label: 'Version' },
+  { key: 'status', label: 'Statut' },
+  { key: 'items_count', label: 'Items' },
+  { key: 'updated_at', label: 'Mis a jour' },
+]
+
+async function loadDocuments() {
+  await documents.fetchAll({
+    doc_type: filterType.value,
+    status: filterStatus.value,
+  })
+}
+
+onMounted(() => {
+  loadDocuments()
+})
+
+watch([filterType, filterStatus], () => {
+  loadDocuments()
+})
+
+const statusColor = (status: string) => {
+  switch (status) {
+    case 'active': return 'success'
+    case 'draft': return 'warning'
+    case 'archived': return 'neutral'
+    default: return 'neutral'
+  }
+}
+
+const statusLabel = (status: string) => {
+  switch (status) {
+    case 'active': return 'Actif'
+    case 'draft': return 'Brouillon'
+    case 'archived': return 'Archive'
+    default: return status
+  }
+}
+
+const typeLabel = (docType: 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>
+  <div class="space-y-6">
+    <!-- Header -->
+    <div class="flex items-center justify-between">
+      <div>
+        <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
+          Documents de reference
+        </h1>
+        <p class="mt-1 text-sm text-gray-600 dark:text-gray-400">
+          Documents fondateurs de la communaute Duniter/G1 sous vote permanent
+        </p>
+      </div>
+    </div>
+
+    <!-- Filters -->
+    <div class="flex flex-wrap gap-4">
+      <USelect
+        v-model="filterType"
+        :items="docTypeOptions"
+        placeholder="Type de document"
+        class="w-48"
+      />
+      <USelect
+        v-model="filterStatus"
+        :items="statusOptions"
+        placeholder="Statut"
+        class="w-48"
+      />
+    </div>
+
+    <!-- Loading state -->
+    <template v-if="documents.loading">
+      <div class="space-y-3">
+        <USkeleton v-for="i in 5" :key="i" class="h-12 w-full" />
+      </div>
+    </template>
+
+    <!-- Error state -->
+    <template v-else-if="documents.error">
+      <UCard>
+        <div class="flex items-center gap-3 text-red-500">
+          <UIcon name="i-lucide-alert-circle" class="text-xl" />
+          <p>{{ documents.error }}</p>
+        </div>
+      </UCard>
+    </template>
+
+    <!-- Empty state -->
+    <template v-else-if="documents.list.length === 0">
+      <UCard>
+        <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>
+    </template>
+
+    <!-- Documents table -->
+    <template v-else>
+      <UCard>
+        <div class="overflow-x-auto">
+          <table class="w-full text-sm">
+            <thead>
+              <tr class="border-b border-gray-200 dark:border-gray-700">
+                <th v-for="col in columns" :key="col.key" class="text-left px-4 py-3 font-medium text-gray-500 dark:text-gray-400">
+                  {{ col.label }}
+                </th>
+              </tr>
+            </thead>
+            <tbody>
+              <tr
+                v-for="doc in documents.list"
+                :key="doc.id"
+                class="border-b border-gray-100 dark:border-gray-800 hover:bg-gray-50 dark:hover:bg-gray-800/50 cursor-pointer"
+                @click="navigateTo(`/documents/${doc.slug}`)"
+              >
+                <td class="px-4 py-3">
+                  <div class="flex items-center gap-2">
+                    <UIcon name="i-lucide-file-text" class="text-gray-400" />
+                    <span class="font-medium text-gray-900 dark:text-white">{{ doc.title }}</span>
+                  </div>
+                </td>
+                <td class="px-4 py-3">
+                  <UBadge variant="subtle" color="primary">
+                    {{ typeLabel(doc.doc_type) }}
+                  </UBadge>
+                </td>
+                <td class="px-4 py-3 text-gray-600 dark:text-gray-400 font-mono text-xs">
+                  v{{ doc.version }}
+                </td>
+                <td class="px-4 py-3">
+                  <UBadge :color="statusColor(doc.status)" variant="subtle">
+                    {{ statusLabel(doc.status) }}
+                  </UBadge>
+                </td>
+                <td class="px-4 py-3 text-gray-600 dark:text-gray-400">
+                  {{ doc.items_count }}
+                </td>
+                <td class="px-4 py-3 text-gray-500 text-xs">
+                  {{ formatDate(doc.updated_at) }}
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </UCard>
+    </template>
+  </div>
+</template>