generated sotries

2025-12-20 21:04:23 +02:00
parent d889b24f12
commit 8f95089814
65 changed files with 9501 additions and 0 deletions
@@ -0,0 +1,146 @@
+# Story 5.3: Post Deletion
+
+## Epic Reference
+**Epic 5:** Posts/Blog System
+
+## User Story
+As an **admin**,
+I want **to permanently delete posts**,
+So that **I can remove outdated or incorrect content from the website**.
+
+## Story Context
+
+### Existing System Integration
+- **Integrates with:** posts table
+- **Technology:** Livewire Volt
+- **Follows pattern:** Permanent delete pattern
+- **Touch points:** Post management dashboard
+
+## Acceptance Criteria
+
+### Delete Functionality
+- [ ] Delete button on post list and edit page
+- [ ] Confirmation dialog before deletion
+- [ ] Permanent deletion (no soft delete per PRD)
+- [ ] Success message after deletion
+
+### Restrictions
+- [ ] Cannot delete while post is being viewed publicly (edge case)
+- [ ] Admin-only access
+
+### Audit Trail
+- [ ] Audit log entry preserved
+- [ ] Old values stored in log
+
+### Quality Requirements
+- [ ] Clear warning in confirmation
+- [ ] Bilingual messages
+- [ ] Tests for deletion
+
+## Technical Notes
+
+### Delete Confirmation Modal
+```blade
+<flux:modal wire:model="showDeleteModal">
+    <flux:heading>{{ __('admin.delete_post') }}</flux:heading>
+
+    <flux:callout variant="danger">
+        {{ __('admin.delete_post_warning') }}
+    </flux:callout>
+
+    <p class="my-4">
+        {{ __('admin.deleting_post', ['title' => $postToDelete?->title]) }}
+    </p>
+
+    <div class="flex gap-3">
+        <flux:button wire:click="$set('showDeleteModal', false)">
+            {{ __('common.cancel') }}
+        </flux:button>
+        <flux:button variant="danger" wire:click="confirmDelete">
+            {{ __('admin.delete_permanently') }}
+        </flux:button>
+    </div>
+</flux:modal>
+```
+
+### Delete Logic
+```php
+public ?Post $postToDelete = null;
+public bool $showDeleteModal = false;
+
+public function delete(int $id): void
+{
+    $this->postToDelete = Post::findOrFail($id);
+    $this->showDeleteModal = true;
+}
+
+public function confirmDelete(): void
+{
+    if (!$this->postToDelete) {
+        return;
+    }
+
+    // Create audit log BEFORE deletion
+    AdminLog::create([
+        'admin_id' => auth()->id(),
+        'action_type' => 'delete',
+        'target_type' => 'post',
+        'target_id' => $this->postToDelete->id,
+        'old_values' => $this->postToDelete->toArray(),
+        'ip_address' => request()->ip(),
+    ]);
+
+    // Permanently delete
+    $this->postToDelete->delete();
+
+    $this->showDeleteModal = false;
+    $this->postToDelete = null;
+
+    session()->flash('success', __('messages.post_deleted'));
+}
+```
+
+### Testing
+```php
+it('permanently deletes post', function () {
+    $post = Post::factory()->create();
+
+    $this->actingAs($admin)
+        ->delete(route('admin.posts.destroy', $post));
+
+    expect(Post::find($post->id))->toBeNull();
+});
+
+it('creates audit log on deletion', function () {
+    $post = Post::factory()->create();
+
+    $this->actingAs($admin)
+        ->delete(route('admin.posts.destroy', $post));
+
+    expect(AdminLog::where('target_type', 'post')
+        ->where('target_id', $post->id)
+        ->where('action_type', 'delete')
+        ->exists()
+    )->toBeTrue();
+});
+```
+
+## Definition of Done
+
+- [ ] Delete button shows confirmation
+- [ ] Confirmation explains permanence
+- [ ] Post deleted from database
+- [ ] Audit log created with old values
+- [ ] Success message displayed
+- [ ] Tests pass
+- [ ] Code formatted with Pint
+
+## Dependencies
+
+- **Story 5.1:** Post creation
+- **Story 5.2:** Post management dashboard
+
+## Estimation
+
+**Complexity:** Low
+**Estimated Effort:** 1-2 hours