# Story 5.2: Post Management Dashboard

## Epic Reference
**Epic 5:** Posts/Blog System

## User Story
As an **admin**,
I want **a dashboard to manage all blog posts**,
So that **I can organize, publish, and maintain content efficiently**.

## Story Context

### Existing System Integration
- **Integrates with:** posts table, admin_logs table
- **Technology:** Livewire Volt with pagination
- **Follows pattern:** Admin list pattern (see similar components in `resources/views/livewire/admin/`)
- **Touch points:** Post CRUD operations, AdminLog audit trail
- **Note:** HTML sanitization uses `clean()` helper (from mews/purifier package, configured in Story 5.1)

## Acceptance Criteria

### List View
- [ ] Display all posts with:
  - Title (in current admin language)
  - Status (draft/published)
  - Created date
  - Last updated date
- [ ] Pagination (10/25/50 per page)

### Filtering & Search
- [ ] Filter by status (draft/published/all)
- [ ] Search by title or body content
- [ ] Sort by date (newest/oldest)

### Quick Actions
- [ ] Edit post
- [ ] Delete (with confirmation)
- [ ] Publish/unpublish toggle
- [ ] Bulk delete option (optional)

### Quality Requirements
- [ ] Bilingual labels
- [ ] Audit log for delete and status change actions
- [ ] Authorization check (admin only) on all actions
- [ ] Tests for list operations

### Edge Cases
- [ ] Handle post not found gracefully (race condition on delete)
- [ ] Per-page selector visible in UI (10/25/50 options)
- [ ] Bulk delete is **out of scope** for this story (marked optional)

## Technical Notes

### File Location
Create Volt component at: `resources/views/livewire/admin/posts/index.blade.php`

### Route
```php
// routes/web.php (admin group)
Route::get('/admin/posts', function () {
    return view('livewire.admin.posts.index');
})->middleware(['auth', 'admin'])->name('admin.posts.index');
```

### Volt Component
```php
<?php

use App\Models\Post;
use App\Models\AdminLog;
use Livewire\Volt\Component;
use Livewire\WithPagination;

new class extends Component {
    use WithPagination;

    public string $search = '';
    public string $statusFilter = '';
    public string $sortBy = 'created_at';
    public string $sortDir = 'desc';
    public int $perPage = 10;

    public function updatedSearch()
    {
        $this->resetPage();
    }

    public function sort(string $column): void
    {
        if ($this->sortBy === $column) {
            $this->sortDir = $this->sortDir === 'asc' ? 'desc' : 'asc';
        } else {
            $this->sortBy = $column;
            $this->sortDir = 'desc';
        }
    }

    public function togglePublish(int $id): void
    {
        $post = Post::findOrFail($id);
        $newStatus = $post->status === 'published' ? 'draft' : 'published';

        $post->update(['status' => $newStatus]);

        AdminLog::create([
            'admin_id' => auth()->id(),
            'action_type' => 'status_change',
            'target_type' => 'post',
            'target_id' => $post->id,
            'old_values' => ['status' => $post->getOriginal('status')],
            'new_values' => ['status' => $newStatus],
            'ip_address' => request()->ip(),
        ]);

        session()->flash('success', __('messages.post_status_updated'));
    }

    public function delete(int $id): void
    {
        $post = Post::findOrFail($id);

        AdminLog::create([
            'admin_id' => auth()->id(),
            'action_type' => 'delete',
            'target_type' => 'post',
            'target_id' => $post->id,
            'old_values' => $post->toArray(),
            'ip_address' => request()->ip(),
        ]);

        $post->delete();

        session()->flash('success', __('messages.post_deleted'));
    }

    public function with(): array
    {
        $locale = app()->getLocale();

        return [
            'posts' => Post::query()
                ->when($this->search, fn($q) => $q->where(function($q) use ($locale) {
                    $q->where("title_{$locale}", 'like', "%{$this->search}%")
                      ->orWhere("body_{$locale}", 'like', "%{$this->search}%");
                }))
                ->when($this->statusFilter, fn($q) => $q->where('status', $this->statusFilter))
                ->orderBy($this->sortBy, $this->sortDir)
                ->paginate($this->perPage),
        ];
    }
};
```

### Template
```blade
<div>
    <div class="flex justify-between items-center mb-6">
        <flux:heading>{{ __('admin.posts') }}</flux:heading>
        <flux:button href="{{ route('admin.posts.create') }}">
            {{ __('admin.create_post') }}
        </flux:button>
    </div>

    <!-- Filters -->
    <div class="flex gap-4 mb-4">
        <flux:input
            wire:model.live.debounce="search"
            placeholder="{{ __('admin.search_posts') }}"
            class="w-64"
        />
        <flux:select wire:model.live="statusFilter">
            <option value="">{{ __('admin.all_statuses') }}</option>
            <option value="draft">{{ __('admin.draft') }}</option>
            <option value="published">{{ __('admin.published') }}</option>
        </flux:select>
        <flux:select wire:model.live="perPage">
            <option value="10">10 {{ __('admin.per_page') }}</option>
            <option value="25">25 {{ __('admin.per_page') }}</option>
            <option value="50">50 {{ __('admin.per_page') }}</option>
        </flux:select>
    </div>

    <!-- Posts Table -->
    <table class="w-full">
        <thead>
            <tr>
                <th wire:click="sort('title_{{ app()->getLocale() }}')" class="cursor-pointer">
                    {{ __('admin.title') }}
                </th>
                <th>{{ __('admin.status') }}</th>
                <th wire:click="sort('created_at')" class="cursor-pointer">
                    {{ __('admin.created') }}
                </th>
                <th wire:click="sort('updated_at')" class="cursor-pointer">
                    {{ __('admin.updated') }}
                </th>
                <th>{{ __('admin.actions') }}</th>
            </tr>
        </thead>
        <tbody>
            @forelse($posts as $post)
                <tr>
                    <td>{{ $post->title }}</td>
                    <td>
                        <flux:badge :variant="$post->status === 'published' ? 'success' : 'secondary'">
                            {{ __('admin.' . $post->status) }}
                        </flux:badge>
                    </td>
                    <td>{{ $post->created_at->format('d/m/Y') }}</td>
                    <td>{{ $post->updated_at->diffForHumans() }}</td>
                    <td>
                        <div class="flex gap-2">
                            <flux:button size="sm" href="{{ route('admin.posts.edit', $post) }}">
                                {{ __('admin.edit') }}
                            </flux:button>
                            <flux:button
                                size="sm"
                                wire:click="togglePublish({{ $post->id }})"
                            >
                                {{ $post->status === 'published' ? __('admin.unpublish') : __('admin.publish') }}
                            </flux:button>
                            <flux:button
                                size="sm"
                                variant="danger"
                                wire:click="delete({{ $post->id }})"
                                wire:confirm="{{ __('admin.confirm_delete_post') }}"
                            >
                                {{ __('admin.delete') }}
                            </flux:button>
                        </div>
                    </td>
                </tr>
            @empty
                <tr>
                    <td colspan="5" class="text-center py-8 text-charcoal/70">
                        {{ __('admin.no_posts') }}
                    </td>
                </tr>
            @endforelse
        </tbody>
    </table>

    {{ $posts->links() }}
</div>
```

## Testing Requirements

### Test Scenarios
```php
// tests/Feature/Admin/PostManagementTest.php

test('admin can view posts list', function () {
    // Create admin, create posts, visit index, assert sees posts
});

test('admin can filter posts by status', function () {
    // Create draft and published posts
    // Filter by 'draft' - only drafts visible
    // Filter by 'published' - only published visible
    // Filter by '' (all) - all visible
});

test('admin can search posts by title in current locale', function () {
    // Create posts with known titles
    // Search by partial title - matches appear
    // Search with no matches - empty state shown
});

test('admin can search posts by body content', function () {
    // Create posts with known body content
    // Search by body text - matches appear
});

test('admin can sort posts by date', function () {
    // Create posts with different dates
    // Sort desc - newest first
    // Sort asc - oldest first
});

test('admin can toggle post publish status', function () {
    // Create draft post
    // Toggle - becomes published, AdminLog created
    // Toggle again - becomes draft, AdminLog created
});

test('admin can delete post with confirmation', function () {
    // Create post
    // Delete - post removed, AdminLog created
});

test('pagination works correctly', function () {
    // Create 15 posts
    // Page 1 shows 10, page 2 shows 5
});

test('audit log records status changes', function () {
    // Toggle status, verify AdminLog entry with old/new values
});

test('audit log records deletions', function () {
    // Delete post, verify AdminLog entry with old values
});
```

## Definition of Done

- [ ] List displays all posts
- [ ] Filter by status works
- [ ] Search by title/body works
- [ ] Sort by date works
- [ ] Quick publish/unpublish toggle works
- [ ] Delete with confirmation works
- [ ] Pagination works
- [ ] Per-page selector works (10/25/50)
- [ ] Audit log for actions
- [ ] All test scenarios pass
- [ ] Code formatted with Pint

## Dependencies

- **Story 5.1:** Post creation - `docs/stories/story-5.1-post-creation-editing.md`
- **Requires:** Post model with bilingual accessors, AdminLog model

## Estimation

**Complexity:** Medium
**Estimated Effort:** 3-4 hours