# Libra Law Firm - Project Epics

**Project:** Libra Law Firm Website
**Domain:** libra.ps
**Generated:** December 20, 2025
**Source PRD:** [docs/prd.md](../prd.md)

---

## Overview

This document provides an index of all epics for the Libra Law Firm platform development. The project is a bilingual (Arabic/English) web platform for managing client consultations, appointments, and case tracking.

---

## Epic Summary

| # | Epic | Stories | Priority | Dependencies |
|---|------|---------|----------|--------------|
| 1 | [Core Foundation & Infrastructure](./epic-1-core-foundation.md) | 4 | Critical | None |
| 2 | [User Management System](./epic-2-user-management.md) | 5 | Critical | Epic 1 |
| 3 | [Booking & Consultation System](./epic-3-booking-consultation.md) | 8 | Critical | Epic 1, 2 |
| 4 | [Case Timeline System](./epic-4-case-timeline.md) | 6 | High | Epic 1, 2 |
| 5 | [Posts/Blog System](./epic-5-posts-blog.md) | 5 | Medium | Epic 1 |
| 6 | [Admin Dashboard](./epic-6-admin-dashboard.md) | 10 | High | Epic 1-5 |
| 7 | [Client Dashboard](./epic-7-client-dashboard.md) | 6 | High | Epic 1-4 |
| 8 | [Email Notification System](./epic-8-email-notifications.md) | 10 | High | Epic 1-4 |
| 9 | [Design & Branding Implementation](./epic-9-design-branding.md) | 11 | High | Epic 1 |
| 10 | [Brand Color Refresh](./epic-10-brand-color-refresh.md) | 3 | High | Epic 9 |
| 11 | [Guest Booking](./epic-11-guest-booking.md) | 4 | High | Epic 3 |
| 12 | [Branding Refresh - Logo & Colors](./epic-12-branding-refresh.md) | 6 | High | Epic 9, 10 |
| 13 | [Auth Page Design Enhancement](./epic-13-auth-page-design.md) | 5 | Medium | Epic 12 |

**Total Stories:** 83

---

## Recommended Implementation Order

### Phase 1: Foundation (Weeks 1-2)
1. **Epic 1: Core Foundation** - Laravel setup, auth, bilingual infrastructure
2. **Epic 9: Design & Branding** - Can run in parallel, styling applied throughout

### Phase 2: Core Features (Weeks 2-4)
3. **Epic 2: User Management** - Admin-managed accounts
4. **Epic 3: Booking System** - Calendar and consultation booking
5. **Epic 8: Email Notifications** - Supports Epic 2 and 3

### Phase 3: Extended Features (Weeks 4-5)
6. **Epic 4: Case Timeline** - Client case tracking
7. **Epic 5: Posts/Blog** - Public content publishing

### Phase 4: Dashboards & Polish (Weeks 5-6)
8. **Epic 6: Admin Dashboard** - Management interface
9. **Epic 7: Client Dashboard** - Client portal

### Phase 5: Brand Refresh
10. **Epic 10: Brand Color Refresh** - Update to new LIBRA for Rights color palette
11. **Epic 11: Guest Booking** - Public booking form for unauthenticated visitors
12. **Epic 12: Branding Refresh** - Logo and color scheme updates
13. **Epic 13: Auth Page Design** - Enhanced authentication page layouts

---

## Dependency Graph

```
Epic 1 (Core Foundation)
    ├── Epic 2 (User Management)
    │       └── Epic 3 (Booking)
    │       │       └── Epic 11 (Guest Booking)
    │       └── Epic 4 (Timeline)
    │               └── Epic 6 (Admin Dashboard)
    │               └── Epic 7 (Client Dashboard)
    │               └── Epic 8 (Email)
    ├── Epic 5 (Posts)
    └── Epic 9 (Design)
            └── Epic 10 (Brand Color Refresh)
                    └── Epic 12 (Branding Refresh)
                            └── Epic 13 (Auth Page Design)
```

---

## Technology Stack Reference

| Component | Technology | Version |
|-----------|------------|---------|
| Backend | Laravel | 12 |
| PHP | PHP | 8.4 |
| Frontend | Livewire + Volt | 3 / 1 |
| UI Components | Flux UI Free | 2 |
| CSS | Tailwind CSS | 4 |
| Database | SQLite (dev) / MariaDB (prod) | - |
| Auth | Laravel Fortify | 1 |
| Testing | Pest | 4 |

---

## Key Design Specifications

| Element | Specification |
|---------|---------------|
| Primary Color | Charcoal (#4A4A42) |
| Secondary Color | Warm Gray (#C9C4BA) |
| Light Background | Off-White (#E8E4DC) |
| Text/Headlines | Deep Black (#1A1A1A) |
| Arabic Font | Cairo / Tajawal |
| English Font | Montserrat / Lato |
| Primary Language | Arabic (RTL) |
| Secondary Language | English (LTR) |

> **Note:** Colors updated in Epic 10 per new brand identity. See `docs/brand.md` for full guidelines.

---

## Quick Links

- [PRD Document](../prd.md)
- [Architecture Documentation](../architecture/) *(if available)*
- [Stories Location](../stories/)

---

## Notes

- All epics follow the existing codebase patterns (Volt class-based components)
- Each epic includes stories with detailed acceptance criteria
- Testing is required for all features (Pest framework)
- Code must be formatted with Pint before completion
- Bilingual support (Arabic/English) required for all user-facing features
