From 96075f98802493c23f23a090104e0168d1f50ba4 Mon Sep 17 00:00:00 2001
From: Daniel Stock <daniel.stock@tooloop.de>
Date: Fri, 21 Nov 2025 08:36:31 +0100
Subject: [PATCH] Add procedural documentatino (for GODB)

---
 .../js/pages/ProceduralDocumentation.vue      | 217 ++++++++++++++++++
 routes/web.php                                |   5 +
 2 files changed, 222 insertions(+)
 create mode 100644 resources/js/pages/ProceduralDocumentation.vue

diff --git a/resources/js/pages/ProceduralDocumentation.vue b/resources/js/pages/ProceduralDocumentation.vue
new file mode 100644
index 0000000..c150511
--- /dev/null
+++ b/resources/js/pages/ProceduralDocumentation.vue
@@ -0,0 +1,217 @@
+<script setup lang="ts">
+import AppLayout from '@/layouts/AppLayout.vue';
+import { Table, TableCell, TableFooter, TableBody, TableHead, TableHeader, TableRow, } from '@/components/ui/table';
+</script>
+
+<template>
+
+    <AppLayout title="Verfahrensdokumentation">
+        <div class="pl-4 max-w-5xl">
+
+            <h1>Verfahrensdokumentation</h1>
+            <h2>GoBD-konforme Rechnungsverwaltung</h2>
+
+            <section>
+                <h3>1. Systembeschreibung</h3>
+                <p><strong>Zweck</strong>: Erstellung, Verwaltung und Archivierung von Rechnungen gemäß §14 UStG und
+                    GoBD.</p>
+                <p><strong>Technologie</strong>: Laravel (Backend), Vue.js (Frontend), SQLite/MySQL (Datenbank), S3
+                    (Speicher).</p>
+            </section>
+
+            <section>
+                <h3>2. Prozesse</h3>
+                <h4>2.1 Rechnungserstellung</h4>
+
+                <ol>
+                    <li>
+                        Nutzer erstellt <strong>Entwurf</strong> (Status: `draft`).
+                    </li>
+                    <li>
+                        System speichert Entwurf <strong>ohne Rechnungsnummer</strong>.
+                    </li>
+                    <li>
+                        Bei "Rechnung stellen":
+                        <ul>
+                            <li>
+                                System vergibt <strong>fortlaufende Nummer</strong> (z. B. `RE-2023-001`).
+                            </li>
+                            <li>
+                                Status wird auf `issued` gesetzt.
+                            </li>
+                            <li>
+                                <strong>PDF/XML</strong> wird generiert und <strong>unveränderlich</strong> gespeichert
+                                (S3 mit Versionierung).
+                            </li>
+                            <li>
+                                <strong>Audit-Log</strong> wird erstellt.
+                            </li>
+                        </ul>
+                    </li>
+                </ol>
+            </section>
+
+
+            <h4>2.2 Rechnungsstornierung</h4>
+
+            <ol>
+                <li>
+                    Nutzer wählt "Stornieren" und gibt <strong>Grund</strong> an (GoBD-Pflicht!).
+                </li>
+                <li>
+                    System:
+                    <ul>
+                        <li>Setzt Status auf `cancelled`.</li>
+                        <li>Erstellt <strong>Gutschrift</strong> (Credit Note) mit negativem Betrag.</li>
+                        <li>Speichert Stornierungsgrund im <strong>Audit-Log</strong>.</li>
+                    </ul>
+                </li>
+            </ol>
+
+
+            <h4>2.3 Archivierung</h4>
+
+            <ol>
+                <li><strong>Automatische Backups</strong> täglich um 3:00 Uhr (`spatie/laravel-backup`).</li>
+                <li><strong>Aufbewahrungsfrist</strong>: 10 Jahre (S3 Lifecycle Policy).</li>
+                <li><strong>Speicherformat</strong>: PDF + XML (ZUGFeRD-konform).</li>
+            </ol>
+
+
+            <h3>3. Technische Maßnahmen</h3>
+
+
+            <Table>
+                <TableHeader>
+                    <TableRow>
+                        <TableHead>Maßnahme</TableHead>
+                        <TableHead>Umsetzung</TableHead>
+                    </TableRow>
+                </TableHeader>
+                <TableBody>
+                    <TableRow>
+                        <TableCell>Unveränderbarkeit</TableCell>
+                        <TableCell>Rechnungen nach Stellung als `readonly` markiert. Datenbank-Trigger verhindern
+                            Änderungen.</TableCell>
+                    </TableRow>
+                    <TableRow>
+                        <TableCell>Nachvollziehbarkeit</TableCell>
+                        <TableCell>`laravel-auditing` protokolliert alle Änderungen (wer, wann, was).</TableCell>
+                    </TableRow>
+                    <TableRow>
+                        <TableCell>Vollständigkeit</TableCell>
+                        <TableCell>Fortlaufende Nummernvergabe ohne Lücken (Datenbank-Transaktionen).</TableCell>
+                    </TableRow>
+                    <TableRow>
+                        <TableCell>Aufbewahrung</TableCell>
+                        <TableCell>Tägliche Backups auf S3 mit Versionierung (10 Jahre Aufbewahrung).</TableCell>
+                    </TableRow>
+                    <TableRow>
+                        <TableCell>Zugriffsschutz</TableCell>
+                        <TableCell>Laravel Policies schränken Berechtigungen ein (z. B. nur Buchhalter dürfen
+                            stornieren).</TableCell>
+                    </TableRow>
+                    <TableRow>
+                        <TableCell>Prüfbarkeit</TableCell>
+                        <TableCell>Audit-Logs und Revisionsprotokolle sind über Admin-Oberfläche einsehbar.</TableCell>
+                    </TableRow>
+                </TableBody>
+            </Table>
+
+
+            <h3>4. Verantwortlichkeiten</h3>
+
+            <Table>
+                <TableHeader>
+                    <TableRow>
+                        <TableHead>Rolle</TableHead>
+                        <TableHead>Verantwortung</TableHead>
+                    </TableRow>
+                </TableHeader>
+                <TableBody>
+                    <TableRow>
+                        <TableCell>Buchhaltung</TableCell>
+                        <TableCell>Erstellung, Stellung und Stornierung von Rechnungen.</TableCell>
+                    </TableRow>
+                    <TableRow>
+                        <TableCell>IT-Administration</TableCell>
+                        <TableCell>Wartung der Systeme, Backups, Zugriffsrechte.</TableCell>
+                    </TableRow>
+                    <TableRow>
+                        <TableCell>Geschäftsführung</TableCell>
+                        <TableCell>Freigabe von Prozessen, regelmäßige Prüfung der GoBD-Konformität.</TableCell>
+                    </TableRow>
+                </TableBody>
+            </Table>
+
+
+            <h3>5. Prüfprotokolle</h3>
+
+            <ul>
+                <li><strong>Monatlich</strong>: Automatischer Report aller gestellten/stornierten Rechnungen (via
+                    `laravel-excel`).</li>
+                <li><strong>Jährlich</strong>: Manuelle Prüfung der Archivierung durch Steuerberater.</li>
+            </ul>
+
+
+        </div>
+    </AppLayout>
+</template>
+
+<style scoped>
+h1 {
+    font-size: var(--text-xl);
+    font-weight: var(--font-weight-bold);
+    color: var(--color-primary-foreground);
+}
+
+h2 {
+    font-size: var(--text-lg);
+    color: var(--color-muted-foreground);
+}
+
+h3 {
+    font-size: var(--text-lg);
+    margin-top: calc(var(--spacing) * 12);
+    margin-bottom: calc(var(--spacing) * 6);
+}
+
+h4 {
+    font-size: var(--text-md);
+    margin-top: calc(var(--spacing) * 12);
+    margin-bottom: calc(var(--spacing) * 6);
+    color: var(--color-muted-foreground);
+}
+
+h3+h4 {
+    margin-top: calc(var(--spacing) * -3);
+    ;
+}
+
+section {
+    margin-block: calc(var(--spacing) * 12);
+}
+
+p {
+    margin-block: calc(var(--spacing) * 3);
+}
+
+ul {
+    list-style-type: disc;
+    margin: calc(var(--spacing) * 4);
+}
+
+ol {
+    list-style-type: decimal;
+    margin: calc(var(--spacing) * 4);
+}
+
+li {
+    margin-block: calc(var(--spacing) * 1);
+}
+
+th,
+td {
+    font-size: var(--text-base);
+}
+</style>
\ No newline at end of file
diff --git a/routes/web.php b/routes/web.php
index a048743..2f9672e 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -50,6 +50,11 @@
     Route::get('timesheets', function () {
         return Inertia::render('Timesheets');
     })->name('timesheets');
+    
+    // Procedural Documentation
+    Route::get('proceduralDocumentation', function () {
+        return Inertia::render('ProceduralDocumentation');
+    })->name('proceduralDocumentation');
 });