reviewd epic 7 stories

docs/stories/story-7.2-my-consultations-view.md

@@ -8,19 +8,24 @@ As a **client**,
 I want **to view all my consultations**,
 So that **I can track upcoming appointments and review past sessions**.
 
+## Dependencies
+- **Story 7.1:** Client Dashboard Overview (navigation context)
+- **Epic 3:** Consultation model with scopes (`approved()`, `pending()`)
+- **Story 3.6:** Calendar file generation (.ics) for download functionality
+
 ## Acceptance Criteria
 
 ### Upcoming Consultations Section
-- [ ] Date and time
+- [ ] Date and time (formatted per locale)
 - [ ] Consultation type (free/paid)
 - [ ] Status (approved/pending)
-- [ ] Payment status (for paid)
+- [ ] Payment status (for paid consultations)
 - [ ] Download .ics calendar file button
 
 ### Pending Requests Section
 - [ ] Submitted bookings awaiting approval
 - [ ] Submission date
-- [ ] Problem summary preview
+- [ ] Problem summary preview (truncated)
 - [ ] Status: "Pending Review"
 
 ### Past Consultations Section
@@ -29,14 +34,38 @@ So that **I can track upcoming appointments and review past sessions**.
 - [ ] Date and type
 
 ### Features
-- [ ] Visual status indicators
+- [ ] Visual status indicators (badges with colors)
 - [ ] Sort by date (default: newest first for past)
-- [ ] Pagination if many consultations
+- [ ] Pagination if many consultations (10 per page)
 - [ ] No edit/cancel capabilities (read-only)
 
+### Empty States
+- [ ] "No upcoming consultations" message with link to book
+- [ ] "No pending requests" message
+- [ ] "No past consultations" message
+
 ## Technical Notes
 
+### Files to Create/Modify
+- `resources/views/livewire/client/consultations.blade.php` - Main Volt component
+- `routes/web.php` - Add route within client middleware group
+
+### Route Definition
 ```php
+// In routes/web.php, within authenticated client routes
+Route::get('/client/consultations', function () {
+    return view('livewire.client.consultations');
+})->name('client.consultations');
+```
+
+### Volt Component Structure
+```php
+<?php
+
+use App\Models\Consultation;
+use Livewire\Volt\Component;
+use Livewire\WithPagination;
+
 new class extends Component {
     use WithPagination;
 
@@ -57,20 +86,96 @@ new class extends Component {
                 ->get(),
             'past' => $user->consultations()
                 ->whereIn('status', ['completed', 'cancelled', 'no_show'])
-                ->orWhere(fn($q) => $q->approved()->where('scheduled_date', '<', today()))
+                ->orWhere(fn($q) => $q
+                    ->where('user_id', $user->id)
+                    ->approved()
+                    ->where('scheduled_date', '<', today()))
                 ->latest('scheduled_date')
                 ->paginate(10),
         ];
     }
-};
+
+    public function downloadCalendar(Consultation $consultation): \Symfony\Component\HttpFoundation\StreamedResponse
+    {
+        // Reuse .ics generation from Story 3.6
+        return $consultation->generateIcsDownload();
+    }
+}; ?>
 ```
 
+### Model Scopes Required (from Epic 3)
+The Consultation model should have these scopes:
+- `scopeApproved($query)` - `where('status', 'approved')`
+- `scopePending($query)` - `where('status', 'pending')`
+
+### Flux UI Components to Use
+- `<flux:badge>` - Status indicators (approved=green, pending=yellow, completed=gray, cancelled=red)
+- `<flux:button>` - Download calendar button
+- `<flux:heading>` - Section headings
+- `<flux:text>` - Consultation details
+
+### Status Badge Colors
+| Status | Color | Variant |
+|--------|-------|---------|
+| approved | green | `variant="success"` |
+| pending | yellow | `variant="warning"` |
+| completed | gray | `variant="subtle"` |
+| cancelled | red | `variant="danger"` |
+| no_show | red | `variant="danger"` |
+
+### Payment Status Display
+- For paid consultations, show payment status:
+  - "Payment Pending" (yellow badge)
+  - "Payment Received" (green badge)
+- For free consultations, show "Free" (blue badge)
+
+## References
+- `docs/epics/epic-3-booking-consultation.md` - Consultation model, statuses, payment handling
+- `docs/epics/epic-3-booking-consultation.md#story-36` - .ics calendar file generation
+- `docs/stories/story-7.1-client-dashboard-overview.md` - Dashboard navigation context
+
+## Test Scenarios
+
+### Access Control
+- [ ] Unauthenticated users redirected to login
+- [ ] User sees only their own consultations (not other users')
+
+### Upcoming Section
+- [ ] Shows approved consultations with `scheduled_date >= today`
+- [ ] Sorted by date ascending (soonest first)
+- [ ] Displays type, status, payment status correctly
+- [ ] Calendar download button triggers .ics download
+
+### Pending Section
+- [ ] Shows consultations with status='pending'
+- [ ] Displays submission date and problem summary
+- [ ] Summary truncated if too long
+
+### Past Section
+- [ ] Shows completed, cancelled, no_show consultations
+- [ ] Shows approved consultations with `scheduled_date < today`
+- [ ] Sorted by date descending (newest first)
+- [ ] Pagination works correctly (10 per page)
+
+### Empty States
+- [ ] Empty upcoming shows appropriate message
+- [ ] Empty pending shows appropriate message
+- [ ] Empty past shows appropriate message
+
+### Calendar Download
+- [ ] Download generates valid .ics file
+- [ ] File contains correct consultation details
+- [ ] Only available for approved upcoming consultations
+
 ## Definition of Done
 - [ ] All sections display correctly
 - [ ] Calendar download works
-- [ ] Status indicators clear
-- [ ] Read-only (no actions)
-- [ ] Pagination works
+- [ ] Status indicators clear and color-coded
+- [ ] Read-only (no actions except download)
+- [ ] Pagination works for past consultations
+- [ ] Empty states display appropriately
+- [ ] Mobile responsive
+- [ ] Bilingual support
 - [ ] Tests pass
 
 ## Estimation