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,154 @@
+# Story 4.3: Timeline Archiving
+
+## Epic Reference
+**Epic 4:** Case Timeline System
+
+## User Story
+As an **admin**,
+I want **to archive completed cases and unarchive if needed**,
+So that **I can organize active and completed case timelines**.
+
+## Story Context
+
+### Existing System Integration
+- **Integrates with:** timelines table
+- **Technology:** Livewire Volt
+- **Follows pattern:** Soft state change pattern
+- **Touch points:** Timeline list views
+
+## Acceptance Criteria
+
+### Archive Timeline
+- [ ] Archive button on timeline detail
+- [ ] Status changes to 'archived'
+- [ ] Timeline remains visible to client
+- [ ] No further updates can be added (until unarchived)
+- [ ] Visual indicator shows archived status
+
+### Unarchive Timeline
+- [ ] Unarchive button on archived timelines
+- [ ] Status returns to 'active'
+- [ ] Updates can be added again
+
+### List Filtering
+- [ ] Filter timelines by status (active/archived/all)
+- [ ] Archived timelines sorted separately in client view
+- [ ] Bulk archive option for multiple timelines
+
+### Quality Requirements
+- [ ] Audit log for status changes
+- [ ] Bilingual labels
+- [ ] Tests for archive/unarchive
+
+## Technical Notes
+
+### Timeline Model Methods
+```php
+class Timeline extends Model
+{
+    public function archive(): void
+    {
+        $this->update(['status' => 'archived']);
+    }
+
+    public function unarchive(): void
+    {
+        $this->update(['status' => 'active']);
+    }
+
+    public function isArchived(): bool
+    {
+        return $this->status === 'archived';
+    }
+
+    public function scopeActive($query)
+    {
+        return $query->where('status', 'active');
+    }
+
+    public function scopeArchived($query)
+    {
+        return $query->where('status', 'archived');
+    }
+}
+```
+
+### Volt Component Actions
+```php
+public function archive(): void
+{
+    if ($this->timeline->isArchived()) {
+        return;
+    }
+
+    $this->timeline->archive();
+
+    AdminLog::create([
+        'admin_id' => auth()->id(),
+        'action_type' => 'archive',
+        'target_type' => 'timeline',
+        'target_id' => $this->timeline->id,
+        'ip_address' => request()->ip(),
+    ]);
+
+    session()->flash('success', __('messages.timeline_archived'));
+}
+
+public function unarchive(): void
+{
+    if (!$this->timeline->isArchived()) {
+        return;
+    }
+
+    $this->timeline->unarchive();
+
+    AdminLog::create([
+        'admin_id' => auth()->id(),
+        'action_type' => 'unarchive',
+        'target_type' => 'timeline',
+        'target_id' => $this->timeline->id,
+        'ip_address' => request()->ip(),
+    ]);
+
+    session()->flash('success', __('messages.timeline_unarchived'));
+}
+
+public function bulkArchive(array $ids): void
+{
+    Timeline::whereIn('id', $ids)->update(['status' => 'archived']);
+
+    foreach ($ids as $id) {
+        AdminLog::create([
+            'admin_id' => auth()->id(),
+            'action_type' => 'archive',
+            'target_type' => 'timeline',
+            'target_id' => $id,
+            'ip_address' => request()->ip(),
+        ]);
+    }
+
+    session()->flash('success', __('messages.timelines_archived', ['count' => count($ids)]));
+}
+```
+
+## Definition of Done
+
+- [ ] Can archive active timeline
+- [ ] Can unarchive archived timeline
+- [ ] Cannot add updates to archived timeline
+- [ ] Filter by status works
+- [ ] Bulk archive works
+- [ ] Visual indicators correct
+- [ ] Audit log created
+- [ ] Tests pass
+- [ ] Code formatted with Pint
+
+## Dependencies
+
+- **Story 4.1:** Timeline creation
+- **Story 4.2:** Timeline updates
+
+## Estimation
+
+**Complexity:** Low
+**Estimated Effort:** 2 hours