adserver-dashboard 1.0.0

package/docs/MWDesign-System.md

@@ -0,0 +1,344 @@
+# MWDesign System - Component Reference
+
+> **Package**: `@moving-walls/design-system` (npm)
+
+## Installation
+
+```bash
+npm install @moving-walls/design-system
+```
+
+## Import Pattern
+
+```tsx
+import { Button, Card, Dialog, Sheet } from '@moving-walls/design-system';
+```
+
+---
+
+## Component Categories
+
+| Category | Components |
+|----------|------------|
+| **Form Controls** | Button, Input, Textarea, Checkbox, RadioGroup, Switch, Select, Slider, Calendar |
+| **Display** | Card, Badge, Alert, Avatar, Progress, Skeleton, Separator, Table |
+| **Layout** | Tabs, Accordion, Collapsible, ScrollArea |
+| **Feedback** | Spinner, Toast |
+| **Navigation** | Breadcrumb |
+| **Overlay** | Dialog, Sheet, Popover, DropdownMenu, Tooltip |
+
+---
+
+## Form Controls
+
+### Button
+```tsx
+import { Button } from '@moving-walls/design-system';
+
+<Button variant="default">Primary</Button>
+<Button variant="secondary">Secondary</Button>
+<Button variant="outline">Outline</Button>
+<Button variant="ghost">Ghost</Button>
+<Button variant="destructive">Destructive</Button>
+
+<Button size="sm">Small</Button>
+<Button size="default">Default</Button>
+<Button size="lg">Large</Button>
+
+<Button disabled>Disabled</Button>
+```
+
+### Input
+```tsx
+import { Input } from '@moving-walls/design-system';
+
+<Input placeholder="Enter text" />
+<Input type="email" placeholder="Email" />
+<Input type="password" placeholder="Password" />
+<Input disabled />
+```
+
+### Select
+```tsx
+import { Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '@moving-walls/design-system';
+
+<Select value={value} onValueChange={setValue}>
+  <SelectTrigger>
+    <SelectValue placeholder="Select..." />
+  </SelectTrigger>
+  <SelectContent>
+    <SelectItem value="option1">Option 1</SelectItem>
+    <SelectItem value="option2">Option 2</SelectItem>
+  </SelectContent>
+</Select>
+```
+
+### Checkbox
+```tsx
+import { Checkbox } from '@moving-walls/design-system';
+
+<div className="flex items-center space-x-2">
+  <Checkbox id="terms" checked={checked} onCheckedChange={setChecked} />
+  <label htmlFor="terms">Accept terms</label>
+</div>
+```
+
+### Switch
+```tsx
+import { Switch } from '@moving-walls/design-system';
+
+<Switch checked={enabled} onCheckedChange={setEnabled} />
+```
+
+---
+
+## Display Components
+
+### Card
+```tsx
+import { Card, CardHeader, CardContent, CardFooter, CardTitle, CardDescription } from '@moving-walls/design-system';
+
+<Card>
+  <CardHeader>
+    <CardTitle>Title</CardTitle>
+    <CardDescription>Description</CardDescription>
+  </CardHeader>
+  <CardContent>Content here</CardContent>
+  <CardFooter><Button>Action</Button></CardFooter>
+</Card>
+```
+
+### Badge
+```tsx
+import { Badge } from '@moving-walls/design-system';
+
+<Badge>Default</Badge>
+<Badge variant="secondary">Secondary</Badge>
+<Badge variant="destructive">Error</Badge>
+<Badge variant="outline">Outline</Badge>
+```
+
+### Alert
+```tsx
+import { Alert, AlertTitle, AlertDescription } from '@moving-walls/design-system';
+
+<Alert>
+  <AlertTitle>Heads up!</AlertTitle>
+  <AlertDescription>This is an informational alert.</AlertDescription>
+</Alert>
+```
+
+### Avatar
+```tsx
+import { Avatar, AvatarImage, AvatarFallback } from '@moving-walls/design-system';
+
+<Avatar>
+  <AvatarImage src="/user.jpg" alt="User" />
+  <AvatarFallback>JD</AvatarFallback>
+</Avatar>
+```
+
+### Table
+```tsx
+import { Table, TableHeader, TableBody, TableRow, TableHead, TableCell } from '@moving-walls/design-system';
+
+<Table>
+  <TableHeader>
+    <TableRow>
+      <TableHead>Name</TableHead>
+      <TableHead>Email</TableHead>
+    </TableRow>
+  </TableHeader>
+  <TableBody>
+    <TableRow>
+      <TableCell>John Doe</TableCell>
+      <TableCell>john@example.com</TableCell>
+    </TableRow>
+  </TableBody>
+</Table>
+```
+
+---
+
+## Layout Components
+
+### Tabs
+```tsx
+import { Tabs, TabsList, TabsTrigger, TabsContent } from '@moving-walls/design-system';
+
+<Tabs defaultValue="tab1">
+  <TabsList>
+    <TabsTrigger value="tab1">Overview</TabsTrigger>
+    <TabsTrigger value="tab2">Details</TabsTrigger>
+  </TabsList>
+  <TabsContent value="tab1">Overview content</TabsContent>
+  <TabsContent value="tab2">Details content</TabsContent>
+</Tabs>
+```
+
+### Accordion
+```tsx
+import { Accordion, AccordionItem, AccordionTrigger, AccordionContent } from '@moving-walls/design-system';
+
+<Accordion type="single" collapsible>
+  <AccordionItem value="item-1">
+    <AccordionTrigger>Getting Started</AccordionTrigger>
+    <AccordionContent>Content here</AccordionContent>
+  </AccordionItem>
+</Accordion>
+```
+
+### ScrollArea
+```tsx
+import { ScrollArea } from '@moving-walls/design-system';
+
+<ScrollArea className="h-96 w-full">
+  Long content here...
+</ScrollArea>
+```
+
+---
+
+## Overlay Components
+
+### Dialog
+```tsx
+import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, DialogTrigger } from '@moving-walls/design-system';
+
+<Dialog>
+  <DialogTrigger asChild>
+    <Button>Open Dialog</Button>
+  </DialogTrigger>
+  <DialogContent>
+    <DialogHeader>
+      <DialogTitle>Title</DialogTitle>
+      <DialogDescription>Description</DialogDescription>
+    </DialogHeader>
+    <div className="py-4">Content</div>
+    <DialogFooter>
+      <Button variant="outline">Cancel</Button>
+      <Button>Confirm</Button>
+    </DialogFooter>
+  </DialogContent>
+</Dialog>
+```
+
+### Sheet
+```tsx
+import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetTrigger } from '@moving-walls/design-system';
+
+<Sheet>
+  <SheetTrigger asChild>
+    <Button>Open Sheet</Button>
+  </SheetTrigger>
+  <SheetContent side="right">
+    <SheetHeader>
+      <SheetTitle>Settings</SheetTitle>
+    </SheetHeader>
+    <div>Content</div>
+  </SheetContent>
+</Sheet>
+```
+
+### DropdownMenu
+```tsx
+import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator } from '@moving-walls/design-system';
+
+<DropdownMenu>
+  <DropdownMenuTrigger asChild>
+    <Button variant="outline">Options</Button>
+  </DropdownMenuTrigger>
+  <DropdownMenuContent>
+    <DropdownMenuItem>Edit</DropdownMenuItem>
+    <DropdownMenuSeparator />
+    <DropdownMenuItem className="text-red-600">Delete</DropdownMenuItem>
+  </DropdownMenuContent>
+</DropdownMenu>
+```
+
+### Popover
+```tsx
+import { Popover, PopoverTrigger, PopoverContent } from '@moving-walls/design-system';
+
+<Popover>
+  <PopoverTrigger asChild>
+    <Button>Open Popover</Button>
+  </PopoverTrigger>
+  <PopoverContent>Popover content</PopoverContent>
+</Popover>
+```
+
+### Tooltip
+```tsx
+import { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from '@moving-walls/design-system';
+
+<TooltipProvider>
+  <Tooltip>
+    <TooltipTrigger asChild>
+      <Button>Hover me</Button>
+    </TooltipTrigger>
+    <TooltipContent>Helpful tooltip</TooltipContent>
+  </Tooltip>
+</TooltipProvider>
+```
+
+---
+
+## Navigation
+
+### Breadcrumb
+```tsx
+import { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbSeparator, BreadcrumbPage } from '@moving-walls/design-system';
+
+<Breadcrumb>
+  <BreadcrumbList>
+    <BreadcrumbItem>
+      <BreadcrumbLink href="/">Home</BreadcrumbLink>
+    </BreadcrumbItem>
+    <BreadcrumbSeparator />
+    <BreadcrumbItem>
+      <BreadcrumbPage>Current Page</BreadcrumbPage>
+    </BreadcrumbItem>
+  </BreadcrumbList>
+</Breadcrumb>
+```
+
+---
+
+## Icons
+
+Use `lucide-react` for icons:
+
+```tsx
+import { Search, Plus, Check, ChevronDown, X, Edit, Trash2 } from 'lucide-react';
+
+<Button>
+  <Plus className="mr-2 h-4 w-4" /> Add Item
+</Button>
+
+<Button variant="ghost" size="icon">
+  <X className="h-4 w-4" />
+</Button>
+```
+
+---
+
+## Styling with Tailwind CSS
+
+```tsx
+// Combining components with Tailwind
+<Card className="border-2 border-blue-500">
+  <CardContent className="p-6">
+    <div className="flex items-center gap-4">
+      <Avatar className="h-12 w-12">
+        <AvatarFallback>JD</AvatarFallback>
+      </Avatar>
+      <div className="flex-1">
+        <h3 className="font-semibold">John Doe</h3>
+        <p className="text-sm text-gray-500">john@example.com</p>
+      </div>
+      <Badge variant="secondary">Active</Badge>
+    </div>
+  </CardContent>
+</Card>
+```

package/docs/test-plan.md

@@ -0,0 +1,277 @@
+# Influence DOOH AdServer — End-to-End Test Plan
+
+## 1. Authentication & Login
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 1.1 | SSO Login | Navigate to `/login` → Click login button | Redirects to SSO provider, returns with token, lands on Dashboard |
+| 1.2 | OAuth Callback | Complete SSO → return to `/auth/callback` | Access token stored, user profile loaded, redirect to Dashboard |
+| 1.3 | Session Persistence | Login → Close tab → Reopen app | User remains logged in (token in cookies) |
+| 1.4 | Logout | Click profile dropdown → Logout | Tokens cleared, redirected to login page |
+| 1.5 | Protected Routes | Try accessing `/deals` without login | Redirected to `/login` |
+
+---
+
+## 2. Dashboard
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 2.1 | Dashboard Load | Login → Land on `/` | Dashboard displays with key metric cards and charts |
+| 2.2 | Navigation | Click sidebar links | Each link navigates to the correct page |
+
+---
+
+## 3. Deals List Page
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 3.1 | Deals List Load | Navigate to `/deals` | Table loads with deals showing Name, Type (PD/PG/Traditional), Source (Influence/Activate/Planner), Status |
+| 3.2 | Search | Type deal name in search bar | Table filters to matching deals |
+| 3.3 | Type Badges | View deal rows | Correct amber/colored badges for deal type and source |
+| 3.4 | Click Deal Row | Click a deal in the table | Navigates to `/deals/:dealId/line-items` |
+| 3.5 | Create Deal Button | Click "Create Deal" | Navigates to `/deals/create` |
+
+---
+
+## 4. Deal Creation
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 4.1 | Create DIRECT Deal | Fill deal form with DIRECT mode → Submit | Deal created via API, redirected to deal page |
+| 4.2 | Create PROGRAMMATIC Deal | Fill deal form with PROGRAMMATIC mode → Submit | Deal created via API, redirected to deal page |
+| 4.3 | DSP Dropdown | Select DSP from dropdown | Dropdown loads from `getDspDropdownList()` API |
+| 4.4 | Buyer Selection | Select DSP → Select Buyer | Buyer list filters by DSP, seat ID auto-populates |
+| 4.5 | DSP Change Clears Buyer | Select DSP → Select Buyer → Change DSP | Buyer name, seat ID, and buyer ID cleared |
+| 4.6 | Edit Deal | Navigate to `/deals/edit/:dealId` | Form pre-fills with deal data, DSP/Buyer mapped correctly |
+| 4.7 | Edit Mode Buyer Resolution | Edit existing deal with buyer data | DSP name maps to ID, buyerId resolved by seatId or buyerName match |
+| 4.8 | Validation | Submit with required fields empty | Validation errors shown, form not submitted |
+
+---
+
+## 5. Deal Line Items Page
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 5.1 | Line Items List | Navigate to `/deals/:dealId/line-items` | Table shows line items with Name, Status, Budget, Dates |
+| 5.2 | History Button | Click clock icon next to Filter | Navigates to `/deals/:dealId/history` (icon-only button with tooltip) |
+| 5.3 | Click Line Item Row | Click a line item row | Navigates to `/deals/:dealId/line-items/:lineItemId` (detail page) |
+| 5.4 | Create Line Item | Click "New Line Item" | Navigates to line item form/wizard |
+| 5.5 | Filter & Search | Use search bar and filters | Line items filtered accordingly |
+
+---
+
+## 6. Line Item Detail Page
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 6.1 | Detail Page Load | Click line item row → detail page | Full DV360-style detail page loads with breadcrumbs |
+| 6.2 | Summary Cards | View top of page | 4 cards: Budget, Impressions, Revenue, Flight Dates with correct values |
+| 6.3 | Overview Section | View overview card | Shows Status, Priority, Creative Type, Media Type, Dates, Duration, Pacing |
+| 6.4 | Targeting Section | View targeting card | Shows Demographics (age/gender badges), Venue Types, Geography, Signals |
+| 6.5 | Inventory Table | View inventory section | Table with Name, Address, Venue Type, Publisher columns |
+| 6.6 | Creatives Panel | View right sidebar | Shows assigned creatives with thumbnails, or empty state with "Assign Creatives" |
+| 6.7 | Budget & Goals (DIRECT) | View DIRECT line item | Shows Budget Type, Budget Amount, Goal Type, Target Value, Pacing |
+| 6.8 | Programmatic Panel | View PROGRAMMATIC line item | Shows Bid Floor, Net Cost, Impressions, Imp Multiplier |
+| 6.9 | Edit Button | Click "Edit Line Item" | Navigates to `/deals/:dealId/line-items/:lineItemId/edit` |
+| 6.10 | Back Navigation | Click "Back" or breadcrumb | Returns to deals or line items list |
+
+---
+
+## 7. Line Item Form (Create / Edit)
+
+### 7A. Basic Info & Pricing
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 7A.1 | Form Load (Create) | Navigate to new line item form | Empty form with all sections, two-column layout (form + insights sidebar) |
+| 7A.2 | Form Load (Edit) | Navigate to edit existing line item | Form pre-filled with existing data |
+| 7A.3 | DIRECT Pricing | Set deal mode to DIRECT → Enter pricing | CPM, Total Budget, Daily Budget fields visible; `cpmBase` / `estimatedCostBase` stored |
+| 7A.4 | PROGRAMMATIC Pricing | Set deal mode to PROGRAMMATIC → Enter pricing | Bid Floor visible; `bidFloorBase` stored |
+| 7A.5 | Form Validation | Submit with required fields empty | Validation errors displayed per field |
+| 7A.6 | Date Selection | Set start/end dates | Dates properly formatted and validated (end > start) |
+
+### 7B. Targeting Section (Row-Based Design)
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 7B.1 | Media Type Row | View targeting section | Static row showing "DOOH" with checkmark |
+| 7B.2 | Geography Row (Collapsed) | View Geography row | Shows MapPin icon, "Geography" label, "X locations selected ✓" |
+| 7B.3 | Geography Row (Expanded) | Click Geography row | Expands to show "Enter locations" label, comma-separated input, "Advanced Map" button |
+| 7B.4 | Geography Input | Type "New York, London, Tokyo" | Locations parsed and stored as array |
+| 7B.5 | Advanced Map | Click "Advanced Map" button | Side Sheet opens with full GeofencingMap and location sidebar |
+| 7B.6 | Map - Add Location | Draw polygon/point on map | Location added to sidebar list |
+| 7B.7 | Map - Remove Location | Click delete on location card | Location removed from list |
+| 7B.8 | Map - Import CSV | Click "Import Locations" → Upload CSV | Locations parsed and added to map |
+| 7B.9 | Age Groups Row | Click Age Groups row | Expands to 3-column checkbox grid (18-24, 25-34, 35-44, etc.) |
+| 7B.10 | Gender Row | Click Gender row | Expands to checkbox grid (Male, Female, Other) |
+| 7B.11 | POI Targeting | Click POI Targeting row | Side drawer opens with POIs/Categories tabs, search, checkboxes |
+| 7B.12 | POI Drawer - Apply | Select POIs → Click "Apply" | Drawer closes, POI count updated in row |
+| 7B.13 | POI Drawer - Cancel | Select POIs → Click "Cancel" | Drawer closes, selections reverted |
+| 7B.14 | Venue Type | Click Venue Type row | Side drawer opens with search and checkboxes |
+| 7B.15 | Venue Drawer - Apply | Select venues → Click "Apply" | Drawer closes, venue count updated |
+
+### 7C. Signals (Auto-Activate)
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 7C.1 | Signal Toggle | Toggle "Auto-activate Signal" switch ON | Signal dropdown becomes enabled |
+| 7C.2 | Select Signal | Toggle ON → Select signal from dropdown | Signal selected and stored |
+| 7C.3 | Signal Toggle OFF | Toggle "Auto-activate Signal" switch OFF | Signal dropdown disabled, signalId cleared |
+| 7C.4 | Signal in DIRECT Mode | Create DIRECT line item with signal → Submit | `deliveryTargeting.signals` sent as object: `{ signalEnabled: true, signalId: "..." }` |
+| 7C.5 | Signal in PROGRAMMATIC Mode | Create PROGRAMMATIC line item with signal → Submit | `deliveryTargeting.signals` sent as object (same format) |
+| 7C.6 | Signal Edit Mode | Edit line item with existing signal | Signal toggle ON, correct signal pre-selected |
+| 7C.7 | API Validation | Submit line item with signal enabled | No `VALIDATION_ERROR` on `deliveryTargeting.signals` (must be object, not array) |
+
+### 7D. Inventory & Recommendations
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 7D.1 | Fetch Inventory | Click "Fetch Inventory" button | Recommendation API called, loading spinner shown |
+| 7D.2 | Polling Duration | Start recommendation → Wait | Polls every 2 seconds for up to 5 minutes (150 attempts max) |
+| 7D.3 | Polling Progress | Monitor console during polling | Progress logged every 30 seconds |
+| 7D.4 | Recommendation Complete | Wait for completion | Toast shows "Found X available screens", inventory grid populated |
+| 7D.5 | Recommendation Timeout | If API never completes | After 5 minutes, error message: "Recommendation timed out after 5 minutes" |
+| 7D.6 | Select Inventories | Check inventories in grid | Selected IDs stored in form |
+
+### 7E. Form Submission
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 7E.1 | Create Line Item (DIRECT) | Fill all sections → Submit | API called with correct payload including pricing, targeting, deliveryTargeting, inventories |
+| 7E.2 | Create Line Item (PROGRAMMATIC) | Fill all sections → Submit | API called with programmatic payload including bidFloor, deliveryTargeting |
+| 7E.3 | Edit Line Item | Edit existing → Save | API called with updated data, redirected to detail page |
+| 7E.4 | Cancel | Click "Cancel" | Navigates back without saving |
+
+---
+
+## 8. Line Item Creatives Page
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 8.1 | Creatives List Load | Navigate to `/deals/:dealId/line-items/:lineItemId/creatives` | Shows breadcrumbs, 4 metric cards, player status bar, table view |
+| 8.2 | Search & Filter | Use search bar and filter toolbar | Creatives filtered accordingly |
+| 8.3 | Assign Creative Button | Click "Assign Creative" | Full-width side Sheet popover opens (NOT page navigation) |
+
+---
+
+## 9. Creative Assignment (Side Sheet)
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 9.1 | Sheet Opens | Click "Assign Creative" from creatives page | Full-width Sheet overlay opens |
+| 9.2 | Left Panel | View left sidebar | Numbered creative requirements with resolution, duration, type, inventory count, drag-and-drop zones |
+| 9.3 | Right Panel | View right panel | Content Hub with search, filters, grid/list toggle, 4-column card grid |
+| 9.4 | Drag & Drop | Drag creative card from right → Drop on requirement slot | Creative assigned to requirement |
+| 9.5 | Search Content Hub | Type in search field | Creative cards filter by search text |
+| 9.6 | Save Assignment | Click "Save Assignment" | API called, Sheet closes, creatives list updated |
+| 9.7 | Cancel | Click "Cancel" | Sheet closes, no changes saved |
+| 9.8 | Sticky Footer | Scroll down in Sheet | Footer with Cancel / Save buttons remains visible |
+
+---
+
+## 10. Content Hub
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 10.1 | Page Load | Navigate to `/creatives` | Content Hub page loads with grid/list toggle, folder cards, creatives |
+| 10.2 | Grid/List View | Toggle between grid and list | View switches correctly |
+| 10.3 | Folder Navigation | Click folder card | Navigates to folder contents |
+| 10.4 | Creative Preview | Click creative card | Preview sheet opens with tags, status actions, download/transcode/delete |
+| 10.5 | Filter Drawer | Click filter button | Filter drawer opens with filter options |
+| 10.6 | Pagination | Navigate to next page | Next set of creatives loads |
+| 10.7 | Approve Creative | Click approve action on creative | API called, status updated |
+| 10.8 | Reject Creative | Click reject action | API called, status updated |
+| 10.9 | Delete Creative | Click delete action → Confirm | API called, creative removed from list |
+| 10.10 | Create Folder | Click create folder → Enter name | API called, folder created |
+
+---
+
+## 11. DSP & Buyer Management
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 11.1 | DSP List | Navigate to `/dsp` | Read-only list of DSPs from API |
+| 11.2 | Buyer List | Navigate to `/buyers` | List of buyers with CRUD actions |
+| 11.3 | Create Buyer | Click "New Buyer" → Fill form → Save | Buyer created via API |
+| 11.4 | Edit Buyer | Click edit on buyer → Modify → Save | Buyer updated via API |
+| 11.5 | Delete Buyer | Click delete → Confirm | Buyer removed via API |
+
+---
+
+## 12. Deal History
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 12.1 | History Button Location | View deal page | Clock icon button with tooltip next to Filter icon (not in dropdown) |
+| 12.2 | History Page | Click history icon | Navigates to `/deals/:dealId/history` with activity log |
+
+---
+
+## 13. Line Item Wizard (Targeting Step)
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 13.1 | Wizard Load | Create line item via wizard flow | Multi-step wizard loads with targeting step |
+| 13.2 | Flat Row Layout | View targeting step | No tabs — flat collapsible rows: Media Type, Geography, Age Groups, Gender, etc. |
+| 13.3 | Geography in Wizard | Expand Geography row | "Enter locations (comma separated)" input + "Advanced Map" button |
+| 13.4 | Advanced Map in Wizard | Click "Advanced Map" | Map Sheet opens with drawing tools and location sidebar |
+| 13.5 | Recommendation Polling | Complete targeting → Submit | Recommendation submits and polls for up to 5 minutes |
+| 13.6 | Signals in Wizard (DIRECT) | Deal mode = DIRECT → Configure signals | Signal types selectable with weather/traffic/AQI/time-of-day configs |
+
+---
+
+## 14. Navigation & Routing
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 14.1 | Sidebar Navigation | Click each sidebar item | Navigates to correct page: Dashboard, Deals, Content Hub, Inventory, etc. |
+| 14.2 | Deal → Line Items Flow | Deals → Click deal → Line Items list | Correct deal's line items shown |
+| 14.3 | Line Item Detail Flow | Line Items → Click row → Detail page | Full detail page at `/deals/:dealId/line-items/:lineItemId` |
+| 14.4 | Edit Flow | Detail page → Click "Edit" → Form | Line item form pre-filled with data |
+| 14.5 | Creatives Flow | Line Items → Creatives → Assign Creative | Sheet overlay opens (not page nav) |
+| 14.6 | Back Navigation | Use back buttons / breadcrumbs | Correct back navigation at each level |
+| 14.7 | Settings Page | Profile dropdown → Settings | Navigates to in-app `/settings` (not external URL) |
+| 14.8 | 404 Page | Navigate to `/nonexistent` | Not Found page displayed |
+
+---
+
+## 15. Reports, Signals, Integrations & Configuration
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 15.1 | Reports Page | Navigate to `/reports` | Reports page loads with charts and metrics |
+| 15.2 | Signals Page | Navigate to `/signals` | Signals management page loads |
+| 15.3 | Proof of Play | Navigate to `/proof-of-play` | Proof of play page loads |
+| 15.4 | Integrations | Navigate to `/integrations` | SSP/DSP integrations page loads |
+| 15.5 | Settings | Navigate to `/settings` | 11 configuration sections visible |
+| 15.6 | Tags | Navigate to `/tags` | Color-coded tag management page |
+| 15.7 | Custom POIs | Navigate to `/custom-pois` | Geolocation management with upload/create |
+
+---
+
+## 16. Cross-Cutting Concerns
+
+| # | Test Case | Steps | Expected Result |
+|---|-----------|-------|-----------------|
+| 16.1 | Internationalization | Switch language (English/Japanese/Chinese/Arabic) | UI text updates, RTL for Arabic |
+| 16.2 | Dark Mode | Toggle dark mode | All pages render correctly in dark theme |
+| 16.3 | Responsive Layout | Resize browser to mobile/tablet | Layout adapts, sidebar collapses, cards stack |
+| 16.4 | API Error Handling | Simulate API failure (network off) | Error toasts shown, no blank screens |
+| 16.5 | Loading States | Slow API response | Skeleton loaders or spinners shown during data fetch |
+| 16.6 | Form Unsaved Changes | Edit form → Navigate away | Confirm dialog if unsaved changes exist |
+
+---
+
+## Test Environment
+
+- **URL**: Staging deployment (Replit preview or deployed URL)
+- **Auth**: SSO login with test account (e.g., `jeki@jeki.com` / Administrator role)
+- **API**: Staging APIs at `*-stg.movingwalls.com`
+- **Browser**: Chrome latest (primary), Firefox, Safari (secondary)
+
+## Priority Levels
+
+- **P0 (Critical)**: Authentication, Deal CRUD, Line Item CRUD, Signal format (object not array), Recommendation polling (5 min)
+- **P1 (High)**: Targeting section UI, Creative Assignment Sheet, DSP/Buyer management, Navigation flows
+- **P2 (Medium)**: Content Hub operations, Reports, Detail page display, Inventory table
+- **P3 (Low)**: Dark mode, Internationalization, Settings/Tags/Custom POIs, Responsive layout